V4 preprocessors

.changeset/fluffy-files-call.md

@@ -0,0 +1,5 @@
+---
+'@tokens-studio/sd-transforms': minor
+---
+
+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).

.changeset/six-kiwis-drive.md

@@ -0,0 +1,5 @@
+---
+'@tokens-studio/sd-transforms': minor
+---
+
+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.

README.md

@@ -173,10 +173,12 @@ StyleDictionary.registerTransformGroup({
 You can pass options to the `registerTransforms` function.
 
 ```js
-registerTransforms({
+registerTransforms(StyleDictionary, {
   expand: {
     composition: false,
     typography: true,
+    // Note: when using Style-Dictionary v4.0.0-prerelease.2 or higher, filePath no longer gets passed
+    // as an argument, because preprocessors work on the full dictionary rather than per file (parsers)
     border: (token, filePath) =>
       token.value.width !== 0 && filePath.startsWith(path.resolve('tokens/core')),
     shadow: false,