- e0aab62: Fix
ts/size/pxtransform to handle multi-value token values such as'button.padding': { value: '4 8' }.
- 5de4025: Addressed issue #316 about letterSpacing. LetterSpacing is no longer a dimension token. Also, the expand composition test token has been modify to test if the letterSpacing still works properly.
- fb3c7d3: Export TransformOption type to be publicly available (#319)
- 26cf7f9: -Made the font weight case insensitive; Extra checks for style and weight values, confusions cleared up in the code; Font style and value are not both mandatory, it is fine if only one is specified; If font style is not provided, the style field will take the weight value; The bug from issue #267 is fixed.
- b4461f4: Ensure that shadow value is still of type object (either Object or Array) before attempting to resolve math for each property/item.
- 61af02f: Check for color transforms that the value is of type string, since other color object types could occur from previously ran transforms.
- b9aee1e: Fix lineHeight transform to keep numbers as numbers, and not stringify them.
- 1085fe8: Improve math compute utility to better deal with mixed units computations. Expand on tests.
- 0dea2af: fix: evaluate math expressions with units
- 4fe336f: Override lineHeight expandTypesMap from SD. Add letterSpacing override. This is needed for our lineHeight and letterSpacing transforms to apply.
- c6c9223: Add composition to expandTypesMap.
- 19f4530: Fix alwaysAddFontStyle option to not apply to tokens of type fontWeight(s), only meant for typography tokens.
- 32c2d13: textCase and textDecoration types should be kept, instead of changing to "other". This should help with transforms targeting those tokens, whereas "other" is not a useful type conversion whatsoever.
- 3a044ed: Remove the boxShadow expandTypesMap, this is no longer needed since SD 4.0.1 as it runs user defined preprocessors before expanding tokens.
- ff31df8: Add lineHeight and fontWeight types to the expandTypesMap. Even though DTCG spec does not yet recognize them, they really are special types and marking them as such enables transforms to target them specifically.
- ff31df8: Properly split fontWeight tokens that contain fontStyle into the parent group. For typography tokens this was correct but for fontWeight tokens, collision could occur between the token and its sibling tokens.
- c687817: Add the
originalTypeproperty to$extensions.['studio.tokens']to store the original Tokens Studio token type, when the type is aligned to DTCG types. LetterSpacing transform is the transform in this package that actually needs to use this, because it doesn't want to match all dimension tokens, but it does want to match letterSpacing tokens. - ed10715: Allow changing the resolve math transform amount of decimals to round for using platform options
mathFractionDigits, change default value from 3 to 4.
- c687817: Fix alignTypes to also include
borderWidth,letterSpacing,paragraphSpacingandparagraphIndentand align them todimension. - 9c02741: Fix bug where usesDtcg flag was not passed to resolveReference utility.
- 6c7b2ff: Fix tsconfig to exclude test files and ensure dist folder structure is correct.
-
67edf4b: BREAKING:
descriptionToCommenttransform no longer removes newlines, just turns carriage returns into newlines. Style Dictionary now handles comments with newlines properly in its createPropertyFormatter utility. -
67edf4b: BREAKING: Remove
expandoption, composite/object-value tokens must be expanded by using Style Dictionary Expand. -
67edf4b: BREAKING: remove CommonJS entrypoint and tools/scripts required to dual publish. Now that Style Dictionary v4 is ESM-only, this library will follow suit.
-
67edf4b: BREAKING:
transformFontWeightshas been renamed totransformFontWeightfor consistency.Apply transforms to object-value (composite) token types:
- HEXRGBa transform applies to border and shadow colors
- Px dimension transform applies to border, typography and shadow dimensions
- Letterspacing, lineheights and fontweights transforms apply to these respective typography properties
- Resolve math transform applies to all properties of border, typography and shadow tokens
This also means that all transforms except for description to comment mapping are now transitive transforms, since the math resolve transform must be transitive and all other transforms must apply after the math one.
-
67edf4b: BREAKING: remove CSS shorthand transforms for border, typography and shadow. Use the Style Dictionary transforms instead: https://styledictionary.com/reference/hooks/transforms/predefined/#bordercssshorthand.
Note that if you're not disabling the
withSDBuiltinsoption, thetokens-studiotransformGroup will include the ones in thecssbuilt-in transformGroup, so you might not notice the fact that they are moved. -
67edf4b: - BREAKING: Compatible with Style Dictionary >= v4.0.0. Not compatible with anything below that SD version.
- BREAKING:
registerTransformsfunction has been renamed toregister. - BREAKING:
transformsarray has been refactored togetTransforms(), which is a function you should call. Optionally pass in the new platform option as parameter{ platform: 'css' /* or 'compose' */} - BREAKING: By default, registered
tokens-studiotransformGroup will include the platform's Style Dictionary built-in transforms. E.g. if you're registering for platformcssit will include thecsstransformGroup transforms from Style Dictionary, appended to the Tokens Studio specific transforms. This behavior can be disabled by passing{ withSDBuiltins: false }. - Allow passing platform to the
register()call:register(SD, { platform: 'compose' }). Default value is'css'. This means yourtokens-studiogroup will be registered for that specific platform. - Allow passing
nameto theregister()call to configure the transformGroup name:register(SD, { name: 'tokens-studio-css' }). Default value istokens-studio.
- BREAKING:
- 67edf4b: Adjust add-font-styles parser to also run on tokens of type fontWeight, to create a sibling token for the fontStyle if it is included in the fontWeight token.
- 67edf4b: Add an adjust-types preprocessor utility that aligns the Tokens Studio types / object-value props with the DTCG ones.
- 3ab8d64: Restructure evaluate math util to support expr eval expressions in combination with regular math.
- 3ab8d64: Allow math expressions where multiple components contain units, as long as they are still computable.
- 5856621: BREAKING: update to Style Dictionary
v4.0.0-prerelease.27, set preprocessor name to'tokens-studio', which now has to be applied if you want to exclude parent keys, expand composite types or add font style properties to typography values.
- 7617f9d: Pass colorspace to mix modifier, to use the correct color space to mix in.
- 000b202: Update to latest style-dictionary pre.22
-
09b1fc0: BREAKING: remove options
addAttributeCTI&casing. SincetransformGroupcan now be combined withtransforms, this is now much easier to accomplish in Style-Dictionary without additional sd-transforms options.Before:
registerTransforms(StyleDictionary, { addAttributeCTI: true, casing: 'kebab' });
After:
{ "platforms": { "css": { "transformGroup": "tokens-studio", "transforms": ["attribute/cti", "name/kebab"] } } }From this version onwards, Style-Dictionary v4.0.0-prerelease.19 minimum is required.
- 41d83fa: Add "book" to named font weights, converted to 400
- 9351782: Fix expand utility with latest style-dictionary prerelease.16, values would end up undefined due to bad reference resolve.
- d2c1ff6: Revert back change that throws fatal error for broken references when expanding tokens or adding fontStyle. To keep compatibility with Style-Dictionary v3. See the issue describing the problem and necessary workaround for v3.
- d2c1ff6: Fix fontWeights transformer to allow spaces within fontWeights.
- f5a8b12: Copy metadata from composite type tokens when expanding.
- 03e3819: Add W3C Design Token Community Group draft spec forward compatibility.
- 8bde22d: Support references in color modifiers now that style-dictionary transformers can defer themselves.
- 771428a: Fix expanding composition tokens flattening to not occur for certain object values and resulting in [object Object].
- cfc0c3d: Fix rgba(hex, alpha) regex to allow percentages, add more tests for different types of alpha values.
- 3f97dc2: Remove trailing console logs from previous update.
- 7409419: Use expr-eval-fork to work around a prototype pollution vulnerability in the original package.
- 6c95fe4: BREAKING: remove code that allowed user to not pass StyleDictionary instance to registerTransforms, and grabbed the locally installed StyleDictionary automatically. This seemed like a cool feature at first, but can cause hard to trace bugs if there are multiple installations of style-dictionary (due to incompatible semver).
- 6c95fe4: Will now use preprocessors instead of parsers when user Style-Dictionary is v4.0.0-prerelease.2 or higher. Fixes an issue with multi-file references not being resolvable when running composite token expansion or add font style utilities.
- 7dad579: Workaround fix in color modifiers transform to allow UIColor format. This workaround should be removed (in a breaking change) if amzn/style-dictionary#1063 gets resolved and post-transitive transforms become a thing.
- e7ecf43: Fixes transform HEXRGBa format when this format is contained within a value, e.g. linear-gradient() or multi-value.
- 6f4b5ed: BREAKING: swap expandComposites 2nd argument and 3rd argument. 2nd argument is now TransformOptions and 3rd argument the filePath (string). This used to be vice versa and was inconsistent with the other parser functions.
- 6f4b5ed: Add and expose a parseTokens function to make it more developer friendly to add the sd-transforms parsing step to your own custom parser.
- f7e88b6: BREAKNG: Use structuredClone instead of shallow Object.assign copy in parsers. Must use NodeJS v17 at minimum now, as opposed to v15.14.0 before this update.
- 6f4b5ed: Add the addAttributeCTI option to registerTransforms function, to automatically add
attribute/ctipredefined transform to thetokens-studiotransformGroup.
- 2307b9d: Refined CSS font name processing: Enhanced escapeApostrophes for accurate apostrophe handling in font names. Updated quoteWrapWhitespacedFont for smart quoting and escaping in multi-word fonts. Ensures better CSS font family compatibility.
- 8c2e03f: Fix types for expandComposites functions, no longer trips up on key value pairs with primitive values during parsing process.
- a3ad58b: Fix the webpackIgnore statement to use single *. For NextJS integration (webpack).
- dd58528: Remove reliance on browser-style-dictionary. This created problems with CJS style-dictionary config files (default export).
- 72b828d: Fix permutateThemes to order "enabled" sets below "source" sets so enabled sets overrides are prioritized in Style-Dictionary.
- 2e8576e: resolveMath no longer unnecessarily changes the token type to number if the token value is a string without any expressions to resolve.
- Fix resolve reference for multi-value shadow tokens when expanding shadow tokens.
- 77b4f04: Add a webpack ignore statement to dynamic import of node builtin in node env. Should be ignored at compile-time, done at run-time.
- 333355b: Specify import to "module" as "node:module" for build tools to better understand it as a built-in.
- 3f37446: Fix for add-font-styles parser to deal with value props not being objects (e.g. null).
- 597ddcd: Slightly adjust how math evaluation is done on non-numeric string and boolean values, so as to not remove quotes inside strings.
- e486d94: Handle fonts that put only fontStyle inside fontWeight properly e.g. "Italic", which should resolve to weight "Regular" and style "Italic".
- 40e1b27: Add alwaysAddFontStyle to recursive function parameters.
-
96a66a9: checkAndEvaluateMath to not stringify if not needed:
- for single math expressions resolving to a floating number without unit, we can keep it as a
Number - for expressions such as
falseortrue(Boolean), keep asBooleantype
- for single math expressions resolving to a floating number without unit, we can keep it as a
- 0032d8d: Hotfix for evaluate math of values that have non-numericals wrapped in spaces.
- 894efe4: Add option to always add font style when expanding typography objects.
- d76b5cc: Add export for addFontStyles parser.
- eff2f93: Fix resolve math transform multi-value splitter function to properly split more than 2 values where each value does itself not contain any spaces.
- 1327559: Add 'ts/color/modifiers' option:
format, to globally set the output format for color modifiers. - 29ac771: Add hairline and ultra to fontWeightsMap, reflect to 1 and 1000 respectively.
- c59df89: Add option to easily change the casing of the output token names, without requiring to create a custom transform group.
- 6a6a5d2: ts/color/css/hexrgba to correctly apply on all color typed tokens, including those containing references.
- 3425572: BREAKING: permutateThemes to return the same format regardless of whether multi-dimensional themes are used or not. Format:
{ themeName: [sets] }. - 2731a5e: BREAKING: change name of ts/type/fontWeight transform to -> ts/typography/fontWeight, for consistency's sake.
- 0363efc: BREAKING: add parser that extracts fontStyle from fontWeight and adds it as a separate property on Typography tokens object values.
- 2731a5e: Add value transform
ts/typography/css/fontFamilyto font-families which adds quotes if it has white space. The source value will then match with how it's rendered in the composite typography token value.outputReferences: truewill now replace the quoted value with the reference. Previously, the reference was wrapped in quotes. - acb344c: Properly take into account fontStyle inside fontWeights values, in both the fontWeights and CSS typography shorthand transforms.
- c4bb776: Allow color modifications to format to hex when the color space is not sRGB. It will do a conversion step to sRGB space before formatting to hex.
- 4a8a44f: Fix path to the typescript types
- d8eabab: Fix font-families with spaces in between them for multiple comma separated font fallbacks.
- a18c91f: Export permutateThemes utility function, allowing you to input your multi-dimensional $themes.json data, and receive the permutations (single dimensional outputs) as a result. See docs.
- 21608ff: Patches the transformHEXRGBa function to allow for whitespaces surrounding the HEX code. The Tokens Studio plugin automatically adds these whitespaces when working with aliases so this patch removes the need for manually having to remove those whitespaces.
- 0e493a1: Fixes comment transformer for descriptions with line breaks
- de971fe: Fixed the return types of lineHeight, opacity and fontWeight to be number instead of string
- bd7fe6e: Handle references and deep references for tokens that can be expanded, like typography, border, shadow and composition.
- b69b05b: set font family name in quotes if its name has whitespaces
- 4a3d5f9: Error handle if SD cannot resolve reference.
- 01d45fd: Fix hex rgba regex matcher to be lazier about some character matching, warn for errors from colorjs.io hex parsing.
- ce69ada: Consider that properties can also be empty string, which is especially common if the typography/border/shadow tokens are coming from Tokens Studio.
- 24a20df: BREAKING: when missing properties inside typography, border or shadow objects, we prefill them with empty string, 0, or some default value.
- 3f12797: Exclude parent keys can lead to duplicate property keys. Ensure they are deepmerged instead of overwritten.
- 345e03e: Expose transforms names, so it's easy to create a custom transformGroup and adjust, add or remove transforms in it.
- d637cec: Use Rollup output.interop for CJS output, to properly handle default exports in our CJS external dependencies.
- d37eebc: Support values of type number for checkAndEvaluateMath utility.
- acd3ddb: Evaluate math expressions within complex value types like border, typography, shadow.
- a25a1ff: Add excludeParentKeys option to the transform options, in order to exclude parent keys from your token files. This is useful if you use a single-file export from Tokens Studio Figma Plugin.
- 4d3b98b: Fix package exports paths.
- 3728d90: BREAKING: remove modifier type files, use @tokens-studio/types instead for it.
- 2f2cd8c: BREAKING: Register parser that expands composition tokens by default, and optionally typography, border and shadow tokens as well.
- e23ec38: BREAKING: Register ts/opacity transform, to transform opacity to number between 0 and 1, which is more multi-platform than percentages%. Breaking because people might not expect to have their opacity tokens suddenly as decimal numbers.
-
cc7d86b: BREAKING: move the following transforms to CSS namespace, since they are CSS-specific transforms:
ts/size/letterspacing->ts/size/css/letterspacingts/color/hexrgba->ts/color/css/hexrgbats/shadow/shorthand->ts/shadow/css/shorthand
-
cc7d86b: New transform:
ts/border/css/shorthand-> transform border objects to CSS shorthand. -
cc7d86b: BREAKING: turn a few of our transforms from transitive to default transforms, if transitive was not necessary:
ts/descriptionToCommentts/size/pxts/size/css/letterspacingts/size/lineheightts/type/fontWeight
- f320d4a: Keep shadow shorthands as is instead of attempting to transform them again.
- 3d73476: Add
insetto shadow CSS shorthand if the type is innerShadow.
- a824884: Do not use original value for transforms, use transformed value instead.
- df20034: Allow letter spacing to be a number value, since 0 is a legitimate value for letter spacing.
- 2869382: Use expr-eval to evaluate math functions like roundTo().
- a75c420: Add engines property to pkg.json, NodeJS 15.14.0 and higher supported.
- a94d137: Transform typography to make use of transform fontweights map for the fontWeight property.
- 81362be: Account for token values being of type number in certain transformers.
- 48846b3: Fix checkAndEvaluateMath to deal with regular values with spaces in them like linear-gradient(a, b1 b2, c1 c2).
- 4f6da6c: Return original value if mapped fontweight is undefined.
- 2ad1630: BREAKING: remove attribute/cti transform from tokens-studio transform group, this is redundant. However, users might rely on it, therefore it is a breaking change.
- 71d12d2: Improve checkAndEvaluateMath for expressions with more than one unit.
- a2b2a22: Account for undefined as a token value in transformers. This may happen if a token value is a reference, but the reference is broken. A fatal error in the transform makes it more difficult for the user to find out that they have broken references and to debug it, therefore we guard against it in our transformers.
- e366ac0: Export transformColorModifiers function inside the main entrypoint.
- b9f179a: Allow passing an output format to the color modify props of Tokens Studio.
- 31c81b4: Fix property name modifier -> modify.
- 2cff78f: Fix check and evaluate math, don't run it on non-string token values, no longer fails on simple expressions.
- 5718a7b: Fix small bug in transform typography for compose, passes token value instead of full token.
- 2d4ce90: Change regex for HEXRGBa detection space character from lazy to greedy, to more tightly match the "alpha" number without leading spaces.
- 22f9859: Add color modifiers transform, see more info.
- 2d4ce90: Add multi-value support for evaluating math expressions in token values.
- d4d2bc2: BREAKING: Renames typography transform to clarify it's transformed to CSS-based format.
Previously
transformTypography, nowtransformTypographyForCSS.
- d4d2bc2: Adds a transformer for typography tokens on Jetpack Compose
- 0288c1f: Include missing token types (sizing, borderWidth) in ts/size/px transform matcher.
- 5826117: Add lineheight tranform for aligning Figma and CSS behaviour. Add transform to assign Tokens Studio description to Style Dictionary comment.
- 631424d: No longer need to commit to using @rollup/plugin-commonjs. We prebundle the dependency that is CJS-only so users don't need to worry about it.
- 6c35e0e: Add 4 more transforms necessary for dealing with Tokens Studio syntax.
- cfa044f: Take into account that env might be browser. Only attempt to import module and use createRequire in NodeJS env.
- 6e3bd89: Initial release of sd-transforms, a library to easily register transforms related to Tokens Studio