tokens-bruecke 3.17.1 → 3.19.0
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 +6 -0
- package/README.md +6 -1
- package/bin/api.js +1 -1
- package/bin/api.mjs +1 -1
- package/bin/cli.js +1 -1
- package/package.json +1 -1
- package/schemas/tokens-snapshot.schema.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,9 @@
|
|
|
1
|
+
## [3.18.0](https://github.com/tokens-bruecke/figma-plugin/compare/v3.17.1...v3.18.0) (2026-10-09)
|
|
2
|
+
|
|
3
|
+
### Bug Fixes
|
|
4
|
+
|
|
5
|
+
- **cli:** export the file's own styles, published or not, the same set the plugin exports. This also works for branches. Files with unpublished styles now export more styles than before ([#117](https://github.com/tokens-bruecke/figma-plugin/issues/117), [#121](https://github.com/tokens-bruecke/figma-plugin/issues/121)) ([6e1be9c](https://github.com/tokens-bruecke/figma-plugin/commit/6e1be9cb7912e5bc20f7f7e1a42fb5a10428679b))
|
|
6
|
+
|
|
1
7
|
## [3.17.1](https://github.com/tokens-bruecke/figma-plugin/compare/v3.17.0...v3.17.1) (2026-10-09)
|
|
2
8
|
|
|
3
9
|
### Bug Fixes
|
package/README.md
CHANGED
|
@@ -111,6 +111,7 @@ The plugin supports both **exporting** and **importing** design tokens:
|
|
|
111
111
|
- ✅ Supports these color formats: HEX, RGBA CSS, RGBA Object, DTCG color objects (`srgb-dtcg`, `hsl-dtcg`, `oklch-dtcg`, through their `hex` fallback) and [color aliases with opacity](#color-aliases-with-opacity). HSLA CSS and HSLA Object can't be imported yet
|
|
112
112
|
- ✅ Imports variable descriptions and `scopes`. Invalid scopes are reported, and scopes are skipped on `duration` and `cubicBezier` tokens. `$extensions.figma` (code syntax, variable IDs) is ignored
|
|
113
113
|
- ✅ Imports `duration` and `cubicBezier` tokens as Figma motion variables (see [Motion variables](#motion-variables))
|
|
114
|
+
- ✅ Imports `fontFamily` and `fontWeight` tokens without `scopes` as new variables scoped to "Font family" and "Font weight", so they keep their type on the next export. Existing variables keep their scopes. A `fontFamily` list keeps only its first family, since a string variable holds one
|
|
114
115
|
|
|
115
116
|
**What to know before importing:**
|
|
116
117
|
|
|
@@ -563,6 +564,8 @@ Other export settings are available through a JSON configuration file (see [CLI
|
|
|
563
564
|
|
|
564
565
|
The REST API returns variables, collections and styles in no fixed order, so the CLI sorts them by name in REST mode. Exporting an unchanged file then gives the same output every time, as long as you also pass `--omit-created-at`. This order is alphabetical rather than the order of Figma's Variables panel, which the plugin and snapshot mode keep.
|
|
565
566
|
|
|
567
|
+
In REST mode the CLI exports the file's own styles, published or not, the same set the plugin exports. This also works for a branch, which can't publish styles. Styles that come from a library are left out, as in the plugin.
|
|
568
|
+
|
|
566
569
|
### Snapshot input
|
|
567
570
|
|
|
568
571
|
`--input <path>` transforms a local JSON snapshot of a Figma file's variables and styles instead of calling the REST API. `--input -` reads stdin, so it composes with anything that can dump the data:
|
|
@@ -1259,6 +1262,7 @@ Unlike design tokens, Figma variables [support only 6 types](https://www.figma.c
|
|
|
1259
1262
|
| FLOAT | opacity scopes (with %) | _string_ (e.g. `"10%"`) \* |
|
|
1260
1263
|
| FLOAT | all other scopes | [dimension](https://www.designtokens.org/tr/2025.10/format/#dimension) \*\* |
|
|
1261
1264
|
| STRING | only `FONT_WEIGHT` | [fontWeight](https://www.designtokens.org/tr/2025.10/format/#font-weight) |
|
|
1265
|
+
| STRING | only `FONT_FAMILY` | [fontFamily](https://www.designtokens.org/tr/2025.10/format/#font-family) |
|
|
1262
1266
|
| STRING | all other scopes | _string_ \* |
|
|
1263
1267
|
| TIMING | — | [duration](https://www.designtokens.org/tr/2025.10/format/#duration) \*\*\* |
|
|
1264
1268
|
| EASING | — | [cubicBezier](https://www.designtokens.org/tr/2025.10/format/#cubic-bezier) or _string_ \*\*\*\* |
|
|
@@ -1303,9 +1307,10 @@ In order to validate types, the plugin uses the [Design Tokens types](https://gi
|
|
|
1303
1307
|
|
|
1304
1308
|
## Scopes limitations
|
|
1305
1309
|
|
|
1306
|
-
Figma variables have no font weight or opacity type, so the plugin reads the variable's scopes to pick the token type:
|
|
1310
|
+
Figma variables have no font weight, font family or opacity type, so the plugin reads the variable's scopes to pick the token type:
|
|
1307
1311
|
|
|
1308
1312
|
- A number or string variable whose only scope is `FONT_WEIGHT` becomes a `fontWeight` token. With any other scope next to it, it stays a `dimension` or `string`.
|
|
1313
|
+
- A string variable whose only scope is `FONT_FAMILY` becomes a `fontFamily` token. With any other scope next to it, it stays a `string`.
|
|
1309
1314
|
- A number variable whose scopes are all `OPACITY` or `COLOR_OPACITY` (the opacity of a color variable) becomes a `number` token, or a `string` with `%` if [Use percentage for opacity](#use-percentage-for-opacity) is enabled. With any other scope next to them, it is exported as a `dimension`.
|
|
1310
1315
|
|
|
1311
1316
|
---
|