Changelog 
Below you can find a full list of changes for the current and previous versions.
@sit-onyx/figma-utils 
1.0.0 
Major Changes 
7fde5eb: We proudly announce:
🎉 Major release of version 1.0.0 🎉 
There are no changes to the latest
betaversion.Thanks for all your help, bug reports and feature requests that made this possible. Our work still continues, we are actively working on new and more features and bug-fixes.
Meet us at the SITCON.perform in our UXDS Design room.
With the 1.0.0 release the package API is stable and there won't be any breaking changes until the next major release. We don't expect more then one major release per year.
1.0.0-beta.10 
Patch Changes 
b412f02: fix(import-variables): correctly get theme name when combinesDarkLight is enabled
Previously the mode name was determined by using the part before the first "-" character which does not work correctly if the theme/mode name itself contains dashes.
1.0.0-beta.9 
Major Changes 
- 1911f6c: feat(dist)!: Removed commonjs builds 
- BREAKING CHANGE: We dropped commonjs (cjs) builds and packages are now shipped as a pure esm package. Node >= 18 is required.
 
 
1.0.0-beta.8 
Patch Changes 
- 2617d53: fix: use the correct mode name for selector and comment when combine-light-dark is enabled
 
1.0.0-beta.7 
Minor Changes 
df86e6d: feat: Implemented Light-Dark mode using native CSS API. Users no longer need to import separate light and dark mode files; now, all styles are combined into a single file with the light-dark function. E.g.: @import lidl-light.css; @import lidl-dark.css -> @import lidl.css
Renamed CSS Variables 
Old New --onyx-color-steel --onyx-color-neutral-steel --onyx-color-stone --onyx-color-neutral-stone --onyx-color-steel --onyx-color-digits-mint --onyx-color-gray --onyx-color-kl-gray --onyx-color-lidl --onyx-color-lidl-blue --onyx-color-prezero --onyx-color-prezero-green --onyx-color-petrol --onyx-color-prezero-petrol --onyx-color-scos --onyx-color-scos-blue --onyx-color-lemon --onyx-color-scos-lemon --onyx-color-lime --onyx-color-scos-lime --onyx-color-green --onyx-color-system-green --onyx-color-orange --onyx-color-system-orange --onyx-color-purple --onyx-color-system-purple --onyx-color-red --onyx-color-system-red 
1.0.0-beta.6 
Minor Changes 
- 0142958: feat: imported font-variables from figma
 
1.0.0-beta.5 
Major Changes 
- dfe66db: bump minimum required Node version to 20
 
1.0.0-beta.4 
Major Changes 
33700f9: refactor(icon-import): change alias separator to comma
To use the previous behavior, change the alias separator to
|:- if using CLI: add flag 
-s "|" - if using function: 
parseComponentsToIcons({ aliasSeparator: "|" }) 
- if using CLI: add flag 
 
1.0.0-beta.3 
Patch Changes 
- 188c94d: fix(icons): prevent empty string aliases
 
1.0.0-beta.2 
Minor Changes 
b525ca5: feat: add
import-iconsCLI commandAdd new command to import SVG icons from Figma. For further information, see our docs
1.0.0-beta.1 
Patch Changes 
258c3ec: fix: parse 0 as 0rem
Usually in CSS, zero can be used without a unit. However, this breaks styles when using together with
calc(), e.g.calc(var(--my-zero-variable) + 1rem). Therefore, zero will now also be parsed as0rem.
1.0.0-beta.0 
Major Changes 
bf3ea0a: release beta version
🎉 onyx is now beta! There are no breaking changes to the last
1.0.0.-alpha.*version
1.0.0-alpha.5 
Major Changes 
48b24d2: refactor(CLI): remove default value for
--filename/-nCLI flagIf you want to keep the previous behavior, add a
--filename variables-flag
1.0.0-alpha.4 
Patch Changes 
- a190f80: fix: prevent type error when importing as library
 
1.0.0-alpha.3 
Major Changes 
d1fe8e3: feat: support {mode} placeholder for CSS selector
Previously the mode name was automatically appended to the selector if the selector was something other than
:root. This is no longer the case. Instead use the more explicit/flexible placeholder{mode}for this.Old
shnpx @sit-onyx/figma-utils import-variables -k "your-file-key" -t "your-token" -m dark -s html # resulted in selector "html.dark"New
shnpx @sit-onyx/figma-utils import-variables -k "your-file-key" -t "your-token" -m dark -s html.{mode} # results in selector "html.dark"
1.0.0-alpha.2 
Minor Changes 
a63446f: feat: sort variables when parsing
old:
json{ "variable-200": "42rem", "variable-1000": "42rem", "variable-100": "42rem" }new:
json{ "variable-100": "42rem", "variable-200": "42rem", "variable-1000": "42rem" }
1.0.0-alpha.1 
Minor Changes 
- abaefa6: feat: support JSON format
 - abaefa6: feat: support multiple formats
 
1.0.0-alpha.0 
Major Changes 
0211e6e: fix(scss): remove
:rootselectorWhen importing Figma variables with format
SCSS, the resulting.scssfile will put the variables directly in the root of the file instead of nesting them inside a:rootselector.The reason for this is that the variables must be importable / usable into other
.scssfiles but nesting them inside a selector will make them unusable.old:
scss// variables.scss :root { $some-variable: 42; }new:
scss// variables.scss $some-variable: 42;
Minor Changes 
- 0211e6e: feat(css): add CLI option 
selector 
Patch Changes 
- eebf509: fix(parse): remove mode name if its the default Figma mode name "Mode 1"