tokens-bruecke 2.11.4 → 2.14.3

package/.github/workflows/release.yml

@@ -13,6 +13,8 @@ jobs:
       FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
       - name: Install pnpm
         uses: pnpm/action-setup@v4
@@ -46,3 +48,12 @@ 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: Update CHANGELOG.md
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          npx --yes conventional-changelog-cli -p conventionalcommits -i CHANGELOG.md -s -r 1
+          git add CHANGELOG.md
+          git diff --staged --quiet || git commit -m "docs: update CHANGELOG for ${{ github.ref_name }}"
+          git push origin HEAD:main

package/CONTRIBUTING.md

@@ -0,0 +1,75 @@
+# Contributing to TokensBrücke
+
+Thanks for taking the time to contribute! Here's everything you need to get started.
+
+---
+
+## Getting started
+
+**Prerequisites:** Node.js, pnpm
+
+```bash
+git clone https://github.com/tokens-bruecke/figma-plugin.git
+cd figma-plugin
+pnpm install
+```
+
+**Development build (watch mode):**
+
+```bash
+pnpm dev
+```
+
+Load the plugin in Figma: **Plugins → Development → Import plugin from manifest** and point it to `manifest.json`.
+
+**Run tests:**
+
+```bash
+pnpm test
+```
+
+---
+
+## Project structure
+
+| Path          | Purpose                                              |
+| ------------- | ---------------------------------------------------- |
+| `src/app/`    | Figma plugin UI (React)                              |
+| `src/cli/`    | CLI entry point                                      |
+| `src/common/` | Shared transform logic (used by both plugin and CLI) |
+
+---
+
+## Making changes
+
+1. Fork the repo and create a branch from `main`.
+2. Write code — keep changes focused and minimal.
+3. Add or update tests for any logic in `src/common/`.
+4. Open a pull request against `main`.
+
+### Commit style
+
+This project uses [Conventional Commits](https://www.conventionalcommits.org/):
+
+| Prefix                         | Effect             |
+| ------------------------------ | ------------------ |
+| `feat:`                        | Minor version bump |
+| `fix:`                         | Patch version bump |
+| `feat!:` / `BREAKING CHANGE:`  | Major version bump |
+| `chore:`, `docs:`, `refactor:` | No release         |
+
+---
+
+## Reporting bugs
+
+Open a [GitHub issue](https://github.com/tokens-bruecke/figma-plugin/issues) with:
+
+- Steps to reproduce
+- Expected vs. actual behavior
+- Plugin version and Figma version
+
+---
+
+## License
+
+By contributing, you agree your changes will be licensed under the project's [MIT License](./LICENSE).

package/README.md

@@ -15,7 +15,6 @@ The plugin converts Figma variables into design-tokens JSON that are compatible
 - [TokensBrücke — Figma plugin](#tokensbrücke--figma-plugin)
   - [What is this plugin for?](#what-is-this-plugin-for)
   - [Table of contents](#table-of-contents)
-  - [New version 2.0.0](#new-version-200)
   - [How to use](#how-to-use)
     - [Export and Import](#export-and-import)
       - [Export (Variables → JSON)](#export-variables--json)
@@ -30,6 +29,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 +42,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)
@@ -58,19 +59,10 @@ The plugin converts Figma variables into design-tokens JSON that are compatible
   - [Variables types conversion](#variables-types-conversion)
   - [Design tokens types](#design-tokens-types)
   - [Scopes lemitations](#scopes-lemitations)
-  - [Style Dictionary support](#style-dictionary-support)
-  - [Contribution 🚧](#contribution-)
   - [Feedback](#feedback)
 
 ---
 
-## New version 2.0.0
-
-In the new version of the plugin all mode variables moved into the `$extensions` / `modes` object.
-This is how Terrazzo (formerly “Cobalt UI”) works with multiple modes. Check it here — [https://terrazzo.app/docs/](https://terrazzo.app/docs/)
-
-You can download and install previos version `1.6.1` here — [github.com/tokens-bruecke/figma-plugin/files/13536853/build.zip](https://github.com/tokens-bruecke/figma-plugin/files/13536853/build.zip)
-
 ## How to use
 
 1. Install the plugin from the [Figma Community](https://www.figma.com/community/plugin/1254538877056388290).
@@ -88,6 +80,7 @@ The plugin supports both **exporting** and **importing** design tokens:
 - Click **"Download JSON"** to export your Figma variables as a design tokens JSON file
 - The exported file is compatible with the [Design Tokens specification](https://design-tokens.github.io/community-group/format/)
 - You can also push directly to supported services (JSONBin, GitHub, GitLab, etc.)
+- The exported tokens can be converted into CSS, JS, and other platform formats using tools like [Terrazzo](https://terrazzo.app/docs/) or [Style Dictionary](https://amzn.github.io/style-dictionary/)
 
 #### Import (JSON → Variables)
 
@@ -256,6 +249,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 +324,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 +358,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 +431,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 +749,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).
 
 ---
 
@@ -722,18 +762,6 @@ In order to convert `FONT-WEIGHT` and `OPACITY` types into valid values you shou
 
 ---
 
-## Style Dictionary support
-
-There is a set of utils for [Style Dictionary](https://github.com/tokens-bruecke/sd-utils).
-
----
-
-## Contribution 🚧
-
-Comming soon.
-
----
-
 ## Feedback
 
 If you have any questions or suggestions, feel free to [create an issue](https://github.com/tokens-bruecke/figma-plugin/issues)