tokens-bruecke 2.8.1 → 2.11.1

package/.github/workflows/release.yml

@@ -19,29 +19,48 @@ jobs:
         id: release
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
-          release-type: node
+      
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
+        if: ${{ steps.release.outputs.release_created }}
 
       - name: Install pnpm
         uses: pnpm/action-setup@v4
+        if: ${{ steps.release.outputs.release_created }}
+
+      - name: Get pnpm store directory
+        if: ${{ steps.release.outputs.release_created }}
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+
+      - name: Setup pnpm cache
+        uses: actions/cache@v4
+        if: ${{ steps.release.outputs.release_created }}
         with:
-          run_install: false
+          path: ${{ env.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
 
       - name: Install Node.js
         uses: actions/setup-node@v4
+        if: ${{ steps.release.outputs.release_created }}
         with:
           node-version: 'lts/*'
-          cache: 'pnpm'
           registry-url: 'https://npm.pkg.github.com'
 
       - name: Build package
         run: pnpm install && pnpm run build
         if: ${{ steps.release.outputs.release_created }}
 
+      - name: Check if zip exists
+        if: ${{ steps.release.outputs.release_created }}
+        run: ls -la ./dist/
+
       - name: Upload Release Artifact
         if: ${{ steps.release.outputs.release_created }}
-        run: gh release upload ${{ steps.release.outputs.tag_name }} ./dist/figma-plugin.zip
+        run: gh release upload ${{ steps.release.outputs.tag_name }} ./dist/figma-plugin.zip --clobber
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 

package/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "2.9.4"
+}

package/CHANGELOG.md

@@ -1,25 +1,58 @@
 # Changelog
 
-## [2.7.0](https://github.com/tokens-bruecke/figma-plugin/compare/v2.6.2...v2.7.0) (2025-09-21)
+## [2.11.1](https://github.com/tokens-bruecke/figma-plugin/compare/v2.11.0...v2.11.1) (2026-03-28)
+
+### Bug Fixes
+
+- **normilizeType:** return `string` instead of `dimension` for percentage opacity
 
+## [2.11.0](https://github.com/tokens-bruecke/figma-plugin/compare/v2.10.0...v2.11.0) (2026-03-28)
 
 ### Features
 
-* Add direct new GitHub token URL with "repo" scope ([f2f68f9](https://github.com/tokens-bruecke/figma-plugin/commit/f2f68f91bb20ded52cb193391bf4eeaca0e6d303))
-* Add direct new GitHub token URL with "repo" scope ([aea4d98](https://github.com/tokens-bruecke/figma-plugin/commit/aea4d983b99892f28040b919bc79b161fe4e4aa2))
+- **cli:** add `--oauth-token` flag to support OAuth authentication ([#65](https://github.com/tokens-bruecke/figma-plugin/issues/65))
 
+## [2.9.4](https://github.com/tokens-bruecke/figma-plugin/compare/v2.9.3...v2.9.4) (2026-01-13)
 
 ### Bug Fixes
 
-* file path must be URL-encoded for Gitlab API ([369d43f](https://github.com/tokens-bruecke/figma-plugin/commit/369d43fd01d04ea44a810ebcada07a97c5924072))
-* URL encode file path for Gitlab API ([6a590b1](https://github.com/tokens-bruecke/figma-plugin/commit/6a590b15966d4b4188d210d6d8a7dcd4ab07884f))
+- hardcoded style colors into variables ([403c4a5](https://github.com/tokens-bruecke/figma-plugin/commit/403c4a582da3cd7f1d3a4af3654660b84275c9dc))
 
-## [2.6.2](https://github.com/tokens-bruecke/figma-plugin/compare/v2.6.1...v2.6.2) (2025-06-01)
+## [2.9.3](https://github.com/tokens-bruecke/figma-plugin/compare/v2.9.2...v2.9.3) (2025-12-06)
+
+### Bug Fixes
+
+- Remove pnpm version and install options in release workflow ([62ea535](https://github.com/tokens-bruecke/figma-plugin/commit/62ea535c12639ab21b056eb08209fa1115d33920))
+
+## [2.9.2](https://github.com/tokens-bruecke/figma-plugin/compare/v2.9.1...v2.9.2) (2025-12-06)
+
+### Bug Fixes
+
+- Add zip existence check and force artifact upload ([f9d9b4b](https://github.com/tokens-bruecke/figma-plugin/commit/f9d9b4b8aa7b79cb858140fc0fed2e24eca1faca))
+
+## [2.9.1](https://github.com/tokens-bruecke/figma-plugin/compare/v2.9.0...v2.9.1) (2025-12-06)
 
+### Bug Fixes
+
+- Add Release Please configuration files ([dcedd19](https://github.com/tokens-bruecke/figma-plugin/commit/dcedd19dc186bb97bb770af7701be5c8f821f861))
+
+## [2.7.0](https://github.com/tokens-bruecke/figma-plugin/compare/v2.6.2...v2.7.0) (2025-09-21)
+
+### Features
+
+- Add direct new GitHub token URL with "repo" scope ([f2f68f9](https://github.com/tokens-bruecke/figma-plugin/commit/f2f68f91bb20ded52cb193391bf4eeaca0e6d303))
+- Add direct new GitHub token URL with "repo" scope ([aea4d98](https://github.com/tokens-bruecke/figma-plugin/commit/aea4d983b99892f28040b919bc79b161fe4e4aa2))
+
+### Bug Fixes
+
+- file path must be URL-encoded for Gitlab API ([369d43f](https://github.com/tokens-bruecke/figma-plugin/commit/369d43fd01d04ea44a810ebcada07a97c5924072))
+- URL encode file path for Gitlab API ([6a590b1](https://github.com/tokens-bruecke/figma-plugin/commit/6a590b15966d4b4188d210d6d8a7dcd4ab07884f))
+
+## [2.6.2](https://github.com/tokens-bruecke/figma-plugin/compare/v2.6.1...v2.6.2) (2025-06-01)
 
 ### Bug Fixes
 
-* prettier and file formatting ([43bbca5](https://github.com/tokens-bruecke/figma-plugin/commit/43bbca5a922a2d5653704c56b0c2d6e1060855d2))
+- prettier and file formatting ([43bbca5](https://github.com/tokens-bruecke/figma-plugin/commit/43bbca5a922a2d5653704c56b0c2d6e1060855d2))
 
 ## [2.6.1](https://github.com/tokens-bruecke/figma-plugin/compare/v2.6.0...v2.6.1) (2025-04-17)
 

package/README.md

@@ -17,11 +17,15 @@ The plugin converts Figma variables into design-tokens JSON that are compatible
   - [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)
+      - [Import (JSON → Variables)](#import-json--variables)
   - [General settings](#general-settings)
     - [Color mode](#color-mode)
     - [Include styles](#include-styles)
     - [Add styles to](#add-styles-to)
     - [Include variable scopes](#include-variable-scopes)
+    - [Use percentage for opacity](#use-percentage-for-opacity)
     - [Use DTCG keys format](#use-dtcg-keys-format)
     - [Include `.value` string for aliases](#include-value-string-for-aliases)
     - [Include Figma metadata](#include-figma-metadata)
@@ -74,6 +78,36 @@ You can download and install previos version `1.6.1` here — [github.com/tokens
 4. Adjust the settings.
 5. Then you can download the JSON file or push it to on of the [supported services](#link).
 
+### Export and Import
+
+The plugin supports both **exporting** and **importing** design tokens:
+
+#### Export (Variables → JSON)
+
+- 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.)
+
+#### Import (JSON → Variables)
+
+- Click **"Import JSON"** to import design tokens from a JSON file back into Figma
+- The plugin will create variable collections, modes, and variables based on the JSON structure
+- Supports both DTCG format (`$value`, `$type`) and standard format (`value`, `type`)
+- Handles alias references between variables
+- Creates new collections and variables as needed, or updates existing ones
+
+**Import Features:**
+
+- ✅ Creates variable collections from top-level objects
+- ✅ Supports multiple modes (from `$extensions.mode` or `extensions.mode`)
+- ✅ Handles all variable types (color, number, string, boolean)
+- ✅ Resolves alias references between variables
+- ✅ Supports various color formats (HEX, RGBA CSS, RGBA Object)
+- ✅ Preserves variable descriptions and metadata
+
+> [!WARNING]  
+> **Styles Export Limitation**: If you exported tokens with styles included (typography, grids, shadows, or blur), these cannot be imported back as Figma styles or variables. Figma's variable API currently only supports basic types: `color`, `number`, `string`, `boolean`, and `dimension`. Complex style types will be imported as `STRING` variables without proper value conversion. This is a temporary limitation until Figma supports these types natively in their API.
+
 ---
 
 ## General settings
@@ -118,6 +152,28 @@ Each Figma variable has a [scope property](https://www.figma.com/plugin-docs/api
 }
 ```
 
+### Use percentage for opacity
+
+Is `off` by default. When enabled, opacity values will be exported as percentages instead of normalized decimal values. This affects variables with the `OPACITY` scope.
+
+```json
+// Without percentage format (default)
+{
+  "opacity": {
+    "type": "number",
+    "value": 0.1
+  }
+}
+
+// With percentage format
+{
+  "opacity": {
+    "type": "string",
+    "value": "10%"
+  }
+}
+```
+
 ### Use DTCG keys format
 
 Is `off` by default. Currently many design tokens tools doesn't support [DTCG keys format](https://design-tokens.github.io/community-group/format/#character-restrictions). All DTCG keys are prefixed with `$` symbol.
@@ -219,14 +275,29 @@ tokens-bruecke [options]
 For example:
 
 ```bash
+# Using a Personal Access Token (PAT)
 tokens-bruecke --api-key $FIGMA_TOKEN --file-key $FIGMA_FILE --config config.json --output out/tokens.json
+
+# Using an OAuth token
+tokens-bruecke --oauth-token $FIGMA_OAUTH_TOKEN --file-key $FIGMA_FILE --config config.json --output out/tokens.json
 ```
 
 This will fetch figma variables and export them in `out/tokens.json`
 
 ### Options
 
-Same options than the plugin are available throught the usage of a json file.
+| 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               | Yes                                               |
+| `--config`      | `-c`  | Path to configuration file        | 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.
+
+Other export settings are available through a JSON configuration file (see [CLI Configuration File](#cli-configuration-file) below).
 
 ### CLI Configuration File
 
@@ -244,6 +315,7 @@ You can use a JSON configuration file to specify the export options for the CLI.
   "useDTCGKeys": false,
   "includeValueStringKeyToAlias": true,
   "includeFigmaMetaData": false, // Include Figma metadata like styleId, variableId, etc.
+  "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
 }
@@ -634,7 +706,7 @@ In order to validate types, the plugin uses the [Design Tokens types](https://gi
 In order to convert `FONT-WEIGHT` and `OPACITY` types into valid values you should specify thme as scopes in the Figma variables. The plugin will read the first scope and convert it into the valid value. If there are multiple scopes, the plugin will take the first one.
 
 - `FONT_WEIGHT` scope will be converted into `string` type.
-- `OPACITY` scope will be converted into `number` type.
+- `OPACITY` scope will be converted into `number` type (or `string` with `%` if "Use percentage for opacity" is enabled).
 
 ---