tokens-bruecke 3.14.1 → 3.14.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,3 +1,9 @@
1
+ ## [3.14.1](https://github.com/tokens-bruecke/figma-plugin/compare/v3.14.0...v3.14.1) (2026-10-02)
2
+
3
+ ### Bug Fixes
4
+
5
+ - **import:** scale RGBA object colors from 0-255 to 0-1 ([1592922](https://github.com/tokens-bruecke/figma-plugin/commit/1592922779b6456996aa8b98b3488b2eb41bbe45))
6
+
1
7
  ## [3.14.0](https://github.com/tokens-bruecke/figma-plugin/compare/v3.13.1...v3.14.0) (2026-10-02)
2
8
 
3
9
  ### Features
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # TokensBruecke — Figma plugin
1
+ # TokensBruecke — Figma plugin and CLI
2
2
 
3
3
  <a href="https://www.figma.com/community/plugin/1254538877056388290" target="_blank">
4
4
  <img src="./readme-assets/preview.webp" alt="preview" width="100%">
@@ -6,7 +6,7 @@
6
6
 
7
7
  ## What is this plugin for?
8
8
 
9
- The plugin converts Figma variables into design-tokens JSON that are compatible with the [DTCG 2025.10 specification](https://www.designtokens.org/tr/2025.10/format/).
9
+ TokensBruecke exports Figma variables and styles as design tokens JSON compatible with the [DTCG 2025.10 specification](https://www.designtokens.org/tr/2025.10/format/), and imports tokens back into Figma variables. Use it as a Figma plugin, or as a [CLI](#use-as-cli-tool) in CI and agent workflows.
10
10
 
11
11
  ---
12
12
 
@@ -525,23 +525,21 @@ The export never picks up `tokens-bruecke.config.json` on its own: pass it with
525
525
 
526
526
  ### Options
527
527
 
528
- | Option | Alias | Description | Required |
529
- | ------------------------- | ----- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
530
- | `--api-key` | `-a` | Figma personal access token (PAT) | One of `--api-key` or `--oauth-token`, unless `--input` |
531
- | `--oauth-token` | `-t` | Figma OAuth token | One of `--api-key` or `--oauth-token`, unless `--input` |
532
- | `--file-key` | `-f` | Figma file key | Yes, unless `--input` is used |
533
- | `--input` | `-i` | Read a local tokens snapshot instead of calling the REST API (`-` reads stdin) | No |
534
- | `--output` | `-o` | Path to output file, or output directory when `--split-by-collection` or `--split-by-mode` | Yes, unless `--stdout` is used |
535
- | `--stdout` | | Print tokens JSON to stdout instead of writing a file (mutually exclusive with `--output` and split flags) \* | No |
536
- | `--config` | `-c` | Path to configuration file | No |
537
- | `--split-by-collection` | `-s` | Write each collection as a separate `.tokens.json` file in `--output` | No |
538
- | `--split-by-mode` | `-m` | Write each mode as a separate `.tokens.json` file under its collection directory in `--output` | No |
539
- | `--omit-collection-names` | | Drop top-level collection names and merge all variables into one flat namespace | No |
540
- | `--quiet` | `-q` | Suppress progress logs (errors are still printed) | No |
541
- | `--help` | `-h` | Show usage help | No |
542
- | `--version` | | Show the CLI version | No |
543
-
544
- \* Only the `--split-*` flags are checked. Keep `splitByCollection` and `splitByMode` off in a config file you use with `--stdout`, otherwise the CLI prints an internal map of files instead of the tokens.
528
+ | Option | Alias | Description | Required |
529
+ | ------------------------- | ----- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------- |
530
+ | `--api-key` | `-a` | Figma personal access token (PAT) | One of `--api-key` or `--oauth-token`, unless `--input` |
531
+ | `--oauth-token` | `-t` | Figma OAuth token | One of `--api-key` or `--oauth-token`, unless `--input` |
532
+ | `--file-key` | `-f` | Figma file key | Yes, unless `--input` is used |
533
+ | `--input` | `-i` | Read a local tokens snapshot instead of calling the REST API (`-` reads stdin) | No |
534
+ | `--output` | `-o` | Path to output file, or output directory when `--split-by-collection` or `--split-by-mode` | Yes, unless `--stdout` is used |
535
+ | `--stdout` | | Print tokens JSON to stdout instead of writing a file (mutually exclusive with `--output` and split options) | No |
536
+ | `--config` | `-c` | Path to configuration file | No |
537
+ | `--split-by-collection` | `-s` | Write each collection as a separate `.tokens.json` file in `--output` | No |
538
+ | `--split-by-mode` | `-m` | Write each mode as a separate `.tokens.json` file under its collection directory in `--output` | No |
539
+ | `--omit-collection-names` | | Drop top-level collection names and merge all variables into one flat namespace | No |
540
+ | `--quiet` | `-q` | Suppress progress logs (errors are still printed) | No |
541
+ | `--help` | `-h` | Show usage help | No |
542
+ | `--version` | | Show the CLI version | No |
545
543
 
546
544
  Progress logs are printed to **stderr**, so stdout stays clean for piping:
547
545
 
@@ -638,8 +636,7 @@ Save this JSON file and pass it to the CLI using the `--config` option. A JSON s
638
636
  > [!NOTE]
639
637
  > Explicit CLI flags (e.g. `--split-by-collection`) override values from the config file, which override the defaults.
640
638
 
641
- > [!WARNING]
642
- > Top-level keys are merged one level deep. If you set `includedStyles`, it replaces the whole default object, so give every included style type a `customName`, or its group is exported under the key `"undefined"`.
639
+ Each style type in `includedStyles` is merged with its default, so `"text": { "isIncluded": true }` is enough: the group keeps its default name (`Typography-styles`) and the other style types stay excluded.
643
640
 
644
641
  ### For AI agents
645
642