tokens-bruecke 2.11.3 → 2.14.1

package/.github/workflows/release.yml

@@ -46,8 +46,3 @@ jobs:
         run: gh release create ${{ github.ref_name }} ./dist/figma-plugin.zip --title "${{ github.ref_name }}" --generate-notes
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Publish to npm
-        run: pnpm publish --no-git-checks --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/README.md

@@ -30,6 +30,7 @@ The plugin converts Figma variables into design-tokens JSON that are compatible
     - [Include `.value` string for aliases](#include-value-string-for-aliases)
     - [Include Figma metadata](#include-figma-metadata)
     - [Split collections into separate files](#split-collections-into-separate-files)
+    - [Omit collection names](#omit-collection-names)
   - [Use as cli tool](#use-as-cli-tool)
     - [Installation](#installation)
     - [Usage](#usage)
@@ -42,6 +43,7 @@ The plugin converts Figma variables into design-tokens JSON that are compatible
     - [GitLab](#gitlab)
     - [Custom server](#custom-server)
   - [Show output](#show-output)
+  - [Plugin window height](#plugin-window-height)
   - [Config autosaving](#config-autosaving)
   - [Styles support](#styles-support)
     - [Typography](#typography)
@@ -256,6 +258,41 @@ Is `off` by default. When enabled, each Figma variable collection is exported as
 
 This is useful when you want to keep component-level token files separate (e.g. `button.tokens.json`, `card.tokens.json`).
 
+### Omit collection names
+
+Is `off` by default. When enabled, the plugin drops the top-level collection name from the output and merges all variables into a single flat namespace (variables are still grouped by the `/` separator in their names).
+
+```json
+// Without "Omit collection names" (default)
+{
+  "Primitives": {
+    "color": {
+      "primary": { "type": "color", "value": "#000000" }
+    }
+  },
+  "Semantic": {
+    "button": {
+      "background": { "type": "color", "value": "{color.primary}" }
+    }
+  }
+}
+
+// With "Omit collection names"
+{
+  "color": {
+    "primary": { "type": "color", "value": "#000000" }
+  },
+  "button": {
+    "background": { "type": "color", "value": "{color.primary}" }
+  }
+}
+```
+
+Alias references are also rewritten so they point to the flat path (the collection prefix is removed).
+
+> [!WARNING]  
+> If two variables in different collections share the same name, the last one wins and a collision warning is logged to the console. Rename conflicting variables (or keep this option off) to avoid losing values.
+
 ---
 
 ## Use as cli tool
@@ -296,14 +333,15 @@ This will fetch figma variables and export them in `out/tokens.json`
 
 ### Options
 
-| Option                  | Alias | Description                                                           | Required                                          |
-| ----------------------- | ----- | --------------------------------------------------------------------- | ------------------------------------------------- |
-| `--api-key`             | `-a`  | Figma personal access token (PAT)                                     | One of `--api-key` or `--oauth-token` is required |
-| `--oauth-token`         | `-t`  | Figma OAuth token                                                     | One of `--api-key` or `--oauth-token` is required |
-| `--file-key`            | `-f`  | Figma file key                                                        | Yes                                               |
-| `--output`              | `-o`  | Path to output file, or output directory when `--split-by-collection` | Yes                                               |
-| `--config`              | `-c`  | Path to configuration file                                            | No                                                |
-| `--split-by-collection` | `-s`  | Write each collection as a separate `.tokens.json` file in `--output` | No                                                |
+| Option                    | Alias | Description                                                                     | Required                                          |
+| ------------------------- | ----- | ------------------------------------------------------------------------------- | ------------------------------------------------- |
+| `--api-key`               | `-a`  | Figma personal access token (PAT)                                               | One of `--api-key` or `--oauth-token` is required |
+| `--oauth-token`           | `-t`  | Figma OAuth token                                                               | One of `--api-key` or `--oauth-token` is required |
+| `--file-key`              | `-f`  | Figma file key                                                                  | Yes                                               |
+| `--output`                | `-o`  | Path to output file, or output directory when `--split-by-collection`           | Yes                                               |
+| `--config`                | `-c`  | Path to configuration file                                                      | No                                                |
+| `--split-by-collection`   | `-s`  | Write each collection as a separate `.tokens.json` file in `--output`           | No                                                |
+| `--omit-collection-names` |       | Drop top-level collection names and merge all variables into one flat namespace | No                                                |
 
 > [!TIP]
 > For automated pipelines, `--oauth-token` is preferred over `--api-key`. Personal Access Tokens expire every 90 days and require manual renewal, while OAuth tokens support programmatic refresh for indefinite access.
@@ -329,7 +367,8 @@ You can use a JSON configuration file to specify the export options for the CLI.
   "usePercentageOpacity": false, // Export opacity as percentage (10%) instead of decimal (0.1)
   "colorMode": "hex", // "hex"  | "rgba-object"  | "rgba-css"  | "hsla-object"  | "hsla-css";
   "storeStyleInCollection": "none", // Name of one of your collection or "none" to keep them separated
-  "splitByCollection": false // Write each collection as a separate .tokens.json file
+  "splitByCollection": false, // Write each collection as a separate .tokens.json file
+  "omitCollectionNames": false // Drop top-level collection names and merge all variables into one flat namespace
 }
 ```
 
@@ -401,6 +440,16 @@ If you want to see the generated JSON, you can enable the `Show output` option.
 
 ---
 
+## Plugin window height
+
+The plugin window auto-fits the height of its content, but you can adjust it manually using the resizer handle at the bottom of the settings view.
+
+- **Drag** the handle up or down to set a custom height. The minimum is `360px` and the maximum is the current content height — you can't grow the window beyond what's actually there.
+- **Double-click** the handle to reset back to auto-fit. The window snaps to match the content height again.
+- Your manual height is preserved while the output preview is open, so you can resize both with and without the preview showing.
+
+---
+
 ## Config autosaving
 
 The plugin saves the config automatically. So, you don't need to set it up every time you run the plugin.
@@ -709,7 +758,7 @@ Unlike design tokens, Figma variables now [support only 4 types](https://www.fig
 
 ## Design tokens types
 
-In order to validate types, the plugin uses the [Design Tokens types](https://github.com/PavelLaptev/tokens-bruecke/blob/main/token-types.d.ts).
+In order to validate types, the plugin uses the [Design Tokens types](https://github.com/tokens-bruecke/figma-plugin/blob/main/plugin-types.d.ts).
 
 ---