feat(scripts): allow import script to pull using Figma API

- handle both downloaded file version and API version
- handle input and edge cases (e.g., missing config)
- separate and handle parsing of token contents into theme file
- guard against committing local edsrc config

.gitignore

@@ -27,6 +27,7 @@ storybook-components
 .env.production.local
 .cache
 .idea
+.edsrc.json
 
 npm-debug.log*
 yarn-debug.log*

bin/_util.js

@@ -148,6 +148,8 @@ module.exports = {
    * the existing local theme. If there's a path in the local theme file, we can write there (using lodash/set
    * or similar).
    *
+   * TODO(next-major): remove this function
+   *
    * @param {object} localTheme JSON file loaded, representing the data for the local theme
    * @param {string} collectionName Name of the exported collection
    * @param {string} variableName current variable name from figma (e.g., color/text/neutral/default)
@@ -160,6 +162,8 @@ module.exports = {
       module.exports.getTokenPrefix(collectionName) +
       module.exports.tokenNameToPath(variableName);
 
+    console.log(workingPath);
+
     const found = at(localTheme, workingPath).filter(
       (entries) => typeof entries !== 'undefined',
     );
@@ -197,6 +201,8 @@ module.exports = {
    * Data Types:
    * - Type COLOR: https://www.figma.com/plugin-docs/api/RGB/
    *
+   * TODO(next-major): remove this function
+   *
    * @param {string} type Figma type for the token value (Set:)
    * @param {object} figmaResolvedValue
    * @returns {string} value using the type
@@ -232,6 +238,8 @@ module.exports = {
    * a prefix to the token name that corresponds to the prefix used for those
    * tokens.
    *
+   * TODO(next-major): remove this function
+   *
    * @param {string} collectionName The key to write to
    * @returns {string|null} a text prefix for where to write the token value or null when no prefix is found
    */
@@ -247,6 +255,9 @@ module.exports = {
   },
   /**
    * Conversion of the figma token name (e.g., some/path/to/token) to the equivalent path in a JSON object
+   *
+   * TODO(next-major): remove this function
+   *
    * @param {string} figmaTokenName The name from the figma variables panel (slash separated)
    * @returns {string} a lodash-compatible string representing the path to the token value in JSON
    */