style-dictionary 4.1.2 → 4.1.4

package/examples/advanced/assets-base64-embed/package.json

@@ -12,6 +12,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   }
 }

package/examples/advanced/create-react-app/package.json

@@ -12,7 +12,7 @@
   },
   "devDependencies": {
     "eslint-config-react-app": "^7.0.1",
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   },
   "resolutions": {
     "immer": "8.0.1",

package/examples/advanced/create-react-native-app/package.json

@@ -29,7 +29,7 @@
     "eslint-config-react-app": "^7.0.1",
     "jest": "~25.2.6",
     "react-test-renderer": "~16.13.1",
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   },
   "jest": {
     "preset": "react-native"

package/examples/advanced/custom-parser/package.json

@@ -10,6 +10,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   }
 }

package/examples/advanced/custom-transforms/package.json

@@ -16,6 +16,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   }
 }

package/examples/advanced/font-face-rules/package.json

@@ -9,6 +9,6 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   }
 }

package/examples/advanced/format-helpers/package.json

@@ -10,6 +10,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   }
 }

package/examples/advanced/matching-build-files/package.json

@@ -17,6 +17,6 @@
   "author": "Kelly Harrop <kn.harrop@gmail.com>",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   }
 }

package/examples/advanced/multi-brand-multi-platform/package.json

@@ -16,6 +16,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   }
 }

package/examples/advanced/node-modules-as-config-and-properties/package.json

@@ -20,7 +20,7 @@
   },
   "homepage": "https://github.com/dbanksdesign/style-dictionary-node#readme",
   "devDependencies": {
-    "style-dictionary": "^4.1.2",
+    "style-dictionary": "^4.1.4",
     "tinycolor2": "^1.4.1"
   }
 }

package/examples/advanced/npm-module/package.json

@@ -17,6 +17,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   }
 }

package/examples/advanced/referencing_aliasing/package.json

@@ -16,6 +16,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   }
 }

package/examples/advanced/s3/package.json

@@ -16,6 +16,6 @@
   "devDependencies": {
     "aws-sdk": "^2.7.21",
     "fs-extra": "^1.0.0",
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   }
 }

package/examples/advanced/tokens-deprecation/package.json

@@ -16,6 +16,6 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   }
 }

package/examples/advanced/transitive-transforms/package.json

@@ -12,6 +12,6 @@
   "license": "ISC",
   "devDependencies": {
     "colorjs.io": "^0.5.2",
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   }
 }

package/examples/advanced/variables-in-outputs/package.json

@@ -11,6 +11,6 @@
   "author": "",
   "license": "MIT",
   "devDependencies": {
-    "style-dictionary": "^4.1.2"
+    "style-dictionary": "^4.1.4"
   }
 }

package/examples/advanced/yaml-tokens/package.json

@@ -10,7 +10,7 @@
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
-    "style-dictionary": "^4.1.2",
+    "style-dictionary": "^4.1.4",
     "yaml": "^1.10.0"
   }
 }

package/lib/StyleDictionary.js

@@ -39,6 +39,7 @@ import filterTokens from './filterTokens.js';
 import cleanFiles from './cleanFiles.js';
 import cleanDirs from './cleanDirs.js';
 import cleanActions from './cleanActions.js';
+import { isNode } from './utils/isNode.js';
 
 /**
  * @typedef {import('../types/Volume.ts').Volume} Volume
@@ -78,7 +79,7 @@ export default class StyleDictionary extends Register {
   // Placeholder is transformed on prepublish -> see scripts/inject-version.js
   // Another option might be import pkg from './package.json' with { "type": "json" } which would work in both browser and node, but support is not there yet.
   // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#browser_compatibility
-  static VERSION = '4.1.2';
+  static VERSION = '4.1.4';
 
   /** @returns {Config} */
   get options() {
@@ -227,7 +228,7 @@ export default class StyleDictionary extends Register {
         );
       } else {
         let _filePath = cfgFilePath;
-        if (typeof window !== 'object' && process?.platform === 'win32') {
+        if (isNode && process?.platform === 'win32') {
           // Windows FS compatibility. If in browser, we use an FS shim which doesn't require this Windows workaround
           _filePath = new URL(`file:///${_filePath}`).href;
         }
@@ -442,6 +443,7 @@ export default class StyleDictionary extends Register {
       platformProcessedTokens,
       platformConfig.preprocessors,
       this.hooks.preprocessors,
+      platformConfig,
     );
     if (this.shouldRunExpansion(platformConfig.expand)) {
       platformProcessedTokens = expandTokens(platformProcessedTokens, this.options, platformConfig);

package/lib/common/formatHelpers/fileHeader.js

@@ -67,7 +67,7 @@ export default async function fileHeader({ file, commentStyle, formatting = {},
   /**
    * @type {FileHeader}
    */
-  let fn = (arr) => arr;
+  let fn = (arr) => arr ?? [];
   if (file?.options?.fileHeader && typeof file?.options?.fileHeader !== 'string') {
     fn = file.options.fileHeader;
   }

package/lib/common/formatHelpers/formattedVariables.js

@@ -80,7 +80,7 @@ export default function formattedVariables({
     // note: using the spread operator here so we get a new array rather than
     // mutating the original
     allTokens = [...allTokens].sort(
-      sortByReference(tokens, { unfilteredTokens: dictionary.unfilteredTokens }),
+      sortByReference(tokens, { unfilteredTokens: dictionary.unfilteredTokens, usesDtcg }),
     );
   }
 

package/lib/common/formatHelpers/sortByReference.d.ts

@@ -1,7 +1,3 @@
-/**
- * @typedef {import('../../../types/DesignToken.ts').TransformedTokens} Tokens
- * @typedef {import('../../../types/DesignToken.ts').TransformedToken} Token
- */
 /**
  * A function that returns a sorting function to be used with Array.sort that
  * will sort the allTokens array based on references. This is to make sure
@@ -14,11 +10,12 @@
  * dictionary.allTokens.sort(sortByReference(dictionary))
  * ```
  * @param {Tokens} tokens
- * @param {{unfilteredTokens?: Tokens}} [opts]
+ * @param {{unfilteredTokens?: Tokens, usesDtcg?: boolean}} [opts]
  * @returns {(a: Token, b: Token) => number}
  */
-export default function sortByReference(tokens: Tokens, opts?: {
+export default function sortByReference(tokens: Tokens, { unfilteredTokens, usesDtcg }?: {
     unfilteredTokens?: Tokens;
+    usesDtcg?: boolean;
 } | undefined): (a: Token, b: Token) => number;
 export type Tokens = import("../../../types/DesignToken.ts").TransformedTokens;
 export type Token = import("../../../types/DesignToken.ts").TransformedToken;

package/lib/common/formatHelpers/sortByReference.js

@@ -19,6 +19,9 @@ import { getReferences } from '../../utils/references/getReferences.js';
  * @typedef {import('../../../types/DesignToken.ts').TransformedToken} Token
  */
 
+const A_COMES_FIRST = -1;
+const B_COMES_FIRST = 1;
+
 /**
  * A function that returns a sorting function to be used with Array.sort that
  * will sort the allTokens array based on references. This is to make sure
@@ -31,66 +34,67 @@ import { getReferences } from '../../utils/references/getReferences.js';
  * dictionary.allTokens.sort(sortByReference(dictionary))
  * ```
  * @param {Tokens} tokens
- * @param {{unfilteredTokens?: Tokens}} [opts]
+ * @param {{unfilteredTokens?: Tokens, usesDtcg?: boolean}} [opts]
  * @returns {(a: Token, b: Token) => number}
  */
-export default function sortByReference(tokens, opts) {
+export default function sortByReference(tokens, { unfilteredTokens, usesDtcg } = {}) {
+  const valueKey = usesDtcg ? '$value' : 'value';
+
   /**
    * The sorter function is recursive to account for multiple levels of nesting
    * @param {Token} a
    * @param {Token} b
-   * @returns
+   * @returns {number}
    */
   function sorter(a, b) {
-    const aComesFirst = -1;
-    const bComesFirst = 1;
-
-    // return early if a or b ar undefined
     if (typeof a === 'undefined') {
-      return aComesFirst;
-    } else if (typeof b === 'undefined') {
-      return bComesFirst;
+      return A_COMES_FIRST;
+    }
+    if (typeof b === 'undefined') {
+      return B_COMES_FIRST;
     }
 
-    // If token a uses a reference and token b doesn't, b might come before a
-    // read on..
-    if (a.original && usesReferences(a.original.value)) {
-      // Both a and b have references, we need to see if they reference each other
-      if (b.original && usesReferences(b.original.value)) {
-        const aRefs = getReferences(a.original.value, tokens, {
-          unfilteredTokens: opts?.unfilteredTokens,
-          warnImmediately: false,
-        });
-        const bRefs = getReferences(b.original.value, tokens, {
-          unfilteredTokens: opts?.unfilteredTokens,
-          warnImmediately: false,
-        });
-
-        aRefs.forEach((aRef) => {
-          // a references b, we want b to come first
-          if (aRef.name === b.name) {
-            return bComesFirst;
-          }
-        });
+    const aUsesRefs = a.original && usesReferences(a.original[valueKey]);
+    const bUsesRefs = b.original && usesReferences(b.original[valueKey]);
 
-        bRefs.forEach((bRef) => {
-          // ditto but opposite
-          if (bRef.name === a.name) {
-            return aComesFirst;
-          }
-        });
+    // -----BOTH REFERENCE-----
+    if (aUsesRefs && bUsesRefs) {
+      // Collect references for 'a' and 'b'
+      const aRefs = getReferences(a.original[valueKey], tokens, {
+        unfilteredTokens,
+        warnImmediately: false,
+      });
+      const bRefs = getReferences(b.original[valueKey], tokens, {
+        unfilteredTokens,
+        warnImmediately: false,
+      });
 
-        // both a and b have references and don't reference each other
-        // we go further down the rabbit hole (reference chain)
-        return sorter(aRefs[0], bRefs[0]);
-      } else {
-        // a has a reference and b does not:
-        return bComesFirst;
+      // 'a' references 'b' -> 'b' should come first
+      if (aRefs.some((aRef) => aRef.name === b.name)) {
+        return B_COMES_FIRST;
+      }
+      // 'b' references 'a' -> 'a' should come first
+      if (bRefs.some((bRef) => bRef.name === a.name)) {
+        return A_COMES_FIRST;
       }
-      // a does not have a reference it should come first regardless if b has one
-    } else {
-      return aComesFirst;
+
+      // 'a' and 'b' reference, but not each other. Recurse to next level
+      return sorter(aRefs[0], bRefs[0]);
+    }
+
+    // ----- ONLY ONE REFERENCES -----
+    // 'a' references, 'b' doesn't -> 'b' should come first
+    if (aUsesRefs) {
+      return B_COMES_FIRST;
     }
+
+    // 'b' references, 'a' doesn't -> 'a' should come first
+    if (bUsesRefs) {
+      return A_COMES_FIRST;
+    }
+
+    // no references, keep existing order
+    return 0;
   }
 
   return sorter;

package/lib/common/formats.js

@@ -1190,7 +1190,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
 
     let sortedTokens;
     if (outputReferences) {
-      sortedTokens = [...allTokens].sort(sortByReference(tokens, { unfilteredTokens }));
+      sortedTokens = [...allTokens].sort(sortByReference(tokens, { unfilteredTokens, usesDtcg }));
     } else {
       sortedTokens = [...allTokens].sort(sortByName);
     }
@@ -1238,7 +1238,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
 
     let sortedTokens;
     if (outputReferences) {
-      sortedTokens = [...allTokens].sort(sortByReference(tokens, { unfilteredTokens }));
+      sortedTokens = [...allTokens].sort(sortByReference(tokens, { unfilteredTokens, usesDtcg }));
     } else {
       sortedTokens = [...allTokens].sort(sortByName);
     }
@@ -1297,7 +1297,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
 
     let sortedTokens;
     if (outputReferences) {
-      sortedTokens = [...allTokens].sort(sortByReference(tokens, { unfilteredTokens }));
+      sortedTokens = [...allTokens].sort(sortByReference(tokens, { unfilteredTokens, usesDtcg }));
     } else {
       sortedTokens = [...allTokens].sort(sortByName);
     }
@@ -1520,7 +1520,7 @@ declare const ${moduleName}: ${JSON.stringify(treeWalker(dictionary.tokens), nul
 
     let sortedTokens;
     if (outputReferences) {
-      sortedTokens = [...allTokens].sort(sortByReference(tokens, { unfilteredTokens }));
+      sortedTokens = [...allTokens].sort(sortByReference(tokens, { unfilteredTokens, usesDtcg }));
     } else {
       sortedTokens = [...allTokens].sort(sortByName);
     }

package/lib/common/transformGroups.js

@@ -275,7 +275,7 @@ export default {
    * [attribute/cti](/reference/hooks/transforms/predefined#attributecti)
    * [name/camel](/reference/hooks/transforms/predefined#nameccamel)
    * [color/hex8flutter](/reference/hooks/transforms/predefined#colorhex8flutter)
-   * [size/flutter/remToDouble](/reference/hooks/transforms/predefined#sizeflutterremToDouble)
+   * [size/flutter/remToDouble](/reference/hooks/transforms/predefined#sizeflutterremtodouble)
    * [content/flutter/literal](/reference/hooks/transforms/predefined#contentflutterliteral)
    * [asset/flutter/literal](/reference/hooks/transforms/predefined#assetflutterliteral)
    *
@@ -295,7 +295,7 @@ export default {
    * [attribute/cti](/reference/hooks/transforms/predefined#attributecti)
    * [name/camel](/reference/hooks/transforms/predefined#namecamel)
    * [color/hex8flutter](/reference/hooks/transforms/predefined#colorhex8flutter)
-   * [size/flutter/remToDouble](/reference/hooks/transforms/predefined#sizeflutterremToDouble)
+   * [size/flutter/remToDouble](/reference/hooks/transforms/predefined#sizeflutterremtodouble)
    * [content/flutter/literal](/reference/hooks/transforms/predefined#contentflutterliteral)
    * [asset/flutter/literal](/reference/hooks/transforms/predefined#assetflutterliteral)
    *

package/lib/filterTokens.js

@@ -48,25 +48,27 @@ async function filterTokenObject(tokens, filter, options) {
   // out
   const result = await Object.entries(tokens ?? []).reduce(async (_acc, [key, token]) => {
     const acc = await _acc;
-    const tokenValue = options.usesDtcg ? token.$value : token.value;
     // If the token is not an object, we don't know what it is. We return it as-is.
     if (!isPlainObject(token)) {
       return acc;
-      // If the token has a `value` member we know it's a property, pass it to
-      // the filter function and either include it in the final `acc` object or
-      // exclude it (by returning the `acc` object without it added).
-    } else if (typeof tokenValue !== 'undefined') {
-      const filtered = await asyncFilter(/** @type {Token[]} */ ([token]), filter, options);
-      return filtered.length === 0 ? acc : { ...acc, [key]: token };
-      // If we got here we have an object that is not a property. We'll assume
-      // it's an object containing multiple tokens and recursively filter it
-      // using the `filterTokenObject` function.
     } else {
-      const filtered = await filterTokenObject(token, filter, options);
-      // If the filtered object is not empty then add it to the final `acc`
-      // object. If it is empty then every property inside of it was filtered
-      // out, then exclude it entirely from the final `acc` object.
-      return Object.entries(filtered || {}).length < 1 ? acc : { ...acc, [key]: filtered };
+      const tokenValue = options.usesDtcg ? token.$value : token.value;
+      if (typeof tokenValue === 'undefined') {
+        // If we got here we have an object that is not a token. We'll assume
+        // it's token group containing multiple tokens and recursively filter it
+        // using the `filterTokenObject` function.
+        const filtered = await filterTokenObject(token, filter, options);
+        // If the filtered object is not empty then add it to the final `acc`
+        // object. If it is empty then every token inside of it was filtered
+        // out, then exclude it entirely from the final `acc` object.
+        return Object.entries(filtered || {}).length < 1 ? acc : { ...acc, [key]: filtered };
+      } else {
+        // If the token has a `value` member we know it's a token, pass it to
+        // the filter function and either include it in the final `acc` object or
+        // exclude it (by returning the `acc` object without it added).
+        const filtered = await asyncFilter(/** @type {Token[]} */ ([token]), filter, options);
+        return filtered.length === 0 ? acc : { ...acc, [key]: token };
+      }
     }
   }, {});
   return result;

package/lib/resolve.js

@@ -1,4 +1,5 @@
 import { posix, win32 } from 'path-unified';
+import { isNode } from './utils/isNode.js';
 
 /**
  * If we're on Windows AND we're not in browser context, use win32 resolve (with \'s)
@@ -11,7 +12,7 @@ export const resolve = (path, customVolumeUsed = false) => {
   if (customVolumeUsed) {
     return path;
   }
-  if (process?.platform === 'win32' && typeof window !== 'object') {
+  if (isNode && process?.platform === 'win32') {
     return win32.resolve(path);
   }
   return posix.resolve(path);

package/lib/utils/combineJSON.js

@@ -18,6 +18,7 @@ import { fs } from 'style-dictionary/fs';
 import { resolve } from '../resolve.js';
 import deepExtend from './deepExtend.js';
 import { detectDtcgSyntax } from './detectDtcgSyntax.js';
+import { isNode } from './isNode.js';
 
 /**
  * @typedef {import('../../types/Volume.ts').Volume} Volume
@@ -76,7 +77,7 @@ export default async function combineJSON(
     files = files.concat(new_files);
   }
 
-  if (typeof window === 'object') {
+  if (!isNode) {
     // adjust for browser env glob results have leading slash
     // make sure we dont remove these in Node, that would break absolute paths!!
     files = files.map((f) => f.replace(/^\//, ''));
@@ -101,7 +102,7 @@ export default async function combineJSON(
         if (['.js', '.mjs'].includes(extname(filePath))) {
           let resolvedPath = resolve(filePath, vol?.__custom_fs__);
           // eslint-disable-next-line no-undef
-          if (typeof window !== 'object' && process?.platform === 'win32') {
+          if (isNode && process?.platform === 'win32') {
             // Windows FS compatibility. If in browser, we use an FS shim which doesn't require this Windows workaround
             resolvedPath = new URL(`file:///${resolvedPath}`).href;
           }

package/lib/utils/convertToBase64.d.ts

@@ -2,11 +2,11 @@
  * @typedef {import('../../types/Volume.ts').Volume} Volume
  * Takes a file and converts it to a base64 string.
  * @private
- * @param {String} filePath - Path to the file you want base64'd
+ * @param {string} filePath - Path to the file you want base64'd
  * @param {Volume} [vol]
- * @returns {String}
+ * @returns {Promise<string>}
  */
-export default function convertToBase64(filePath: string, vol?: import("../../types/Volume.ts").Volume | undefined): string;
+export default function convertToBase64(filePath: string, vol?: import("../../types/Volume.ts").Volume | undefined): Promise<string>;
 /**
  * Takes a file and converts it to a base64 string.
  */

package/lib/utils/convertToBase64.js

@@ -13,20 +13,43 @@
 
 import { fs } from 'style-dictionary/fs';
 import { resolve } from '../resolve.js';
+import { isNode } from './isNode.js';
+
+/**
+ * @param {Buffer} buffer
+ * @returns {string|Promise<string>}
+ */
+function toBase64(buffer) {
+  if (isNode) {
+    // Node.js environment
+    return buffer.toString('base64');
+  } else {
+    // Browser environment
+    return new Promise((resolve, reject) => {
+      const blob = new Blob([buffer], { type: 'application/octet-stream' });
+      const reader = new FileReader();
+      reader.onloadend = () => {
+        const base64String = /** @type {string } */ (reader.result).split(',')[1];
+        resolve(base64String);
+      };
+      reader.onerror = reject;
+      reader.readAsDataURL(blob);
+    });
+  }
+}
 
 /**
  * @typedef {import('../../types/Volume.ts').Volume} Volume
  * Takes a file and converts it to a base64 string.
  * @private
- * @param {String} filePath - Path to the file you want base64'd
+ * @param {string} filePath - Path to the file you want base64'd
  * @param {Volume} [vol]
- * @returns {String}
+ * @returns {Promise<string>}
  */
-export default function convertToBase64(filePath, vol = fs) {
+export default async function convertToBase64(filePath, vol = fs) {
   if (typeof filePath !== 'string') throw new Error('Token filePath name must be a string');
-
-  const body = /** @type {string} */ (
-    vol.readFileSync(resolve(filePath, vol.__custom_fs__), 'utf-8')
-  );
-  return btoa(body);
+  // typecast to Buffer because we know that without specifying encoding, this returns a Buffer
+  // @ts-expect-error requires encoding options, this is a mistake in memfs types definition
+  const body = /** @type {Buffer} */ (vol.readFileSync(resolve(filePath, vol.__custom_fs__)));
+  return toBase64(body);
 }

package/lib/utils/isNode.d.ts

@@ -0,0 +1 @@
+export const isNode: boolean;

package/lib/utils/isNode.js

@@ -0,0 +1 @@
+export const isNode = typeof window === 'undefined';

package/lib/utils/preprocess.d.ts

@@ -1,6 +1,7 @@
 /**
  * @typedef {import('../../types/DesignToken.ts').PreprocessedTokens} PreprocessedTokens
  * @typedef {import('../../types/Config.ts').Config} Config
+ * @typedef {import('../../types/Config.ts').PlatformConfig} PlatformConfig
  * @typedef {import('../../types/Preprocessor.ts').Preprocessor} Preprocessor
  */
 /**
@@ -10,10 +11,11 @@
  * @param {PreprocessedTokens} tokens
  * @param {string[]} [appliedPreprocessors]
  * @param {Record<string, Preprocessor['preprocessor']>} [preprocessorObj]
- * @param {Config} [options]
+ * @param {Config|PlatformConfig} [options]
  * @returns {Promise<PreprocessedTokens>}
  */
-export function preprocess(tokens: PreprocessedTokens, appliedPreprocessors?: string[] | undefined, preprocessorObj?: Record<string, (dictionary: import("../../types/DesignToken.ts").PreprocessedTokens, options: import("../../types/Config.ts").Config) => import("../../types/DesignToken.ts").PreprocessedTokens | Promise<import("../../types/DesignToken.ts").PreprocessedTokens>> | undefined, options?: import("../../types/Config.ts").Config | undefined): Promise<PreprocessedTokens>;
+export function preprocess(tokens: PreprocessedTokens, appliedPreprocessors?: string[] | undefined, preprocessorObj?: Record<string, (dictionary: import("../../types/DesignToken.ts").PreprocessedTokens, options: import("../../types/Config.ts").Config | import("../../types/Config.ts").PlatformConfig) => import("../../types/DesignToken.ts").PreprocessedTokens | Promise<import("../../types/DesignToken.ts").PreprocessedTokens>> | undefined, options?: import("../../types/Config.ts").Config | import("../../types/Config.ts").PlatformConfig | undefined): Promise<PreprocessedTokens>;
 export type PreprocessedTokens = import("../../types/DesignToken.ts").PreprocessedTokens;
 export type Config = import("../../types/Config.ts").Config;
+export type PlatformConfig = import("../../types/Config.ts").PlatformConfig;
 export type Preprocessor = import("../../types/Preprocessor.ts").Preprocessor;

package/lib/utils/preprocess.js

@@ -14,6 +14,7 @@
 /**
  * @typedef {import('../../types/DesignToken.ts').PreprocessedTokens} PreprocessedTokens
  * @typedef {import('../../types/Config.ts').Config} Config
+ * @typedef {import('../../types/Config.ts').PlatformConfig} PlatformConfig
  * @typedef {import('../../types/Preprocessor.ts').Preprocessor} Preprocessor
  */
 
@@ -24,7 +25,7 @@
  * @param {PreprocessedTokens} tokens
  * @param {string[]} [appliedPreprocessors]
  * @param {Record<string, Preprocessor['preprocessor']>} [preprocessorObj]
- * @param {Config} [options]
+ * @param {Config|PlatformConfig} [options]
  * @returns {Promise<PreprocessedTokens>}
  */
 export async function preprocess(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "style-dictionary",
-  "version": "4.1.2",
+  "version": "4.1.4",
   "description": "Style once, use everywhere. A build system for creating cross-platform styles.",
   "keywords": [
     "style dictionary",
@@ -156,6 +156,7 @@
     "prettier": "^3.0.3",
     "sass": "^1.69.5",
     "sharp": "^0.32.5",
+    "starlight-links-validator": "^0.12.1",
     "stylus": "^0.56.0",
     "typescript": "^5.3.3",
     "unist-util-visit": "^5.0.0",

package/types/File.d.ts

@@ -16,7 +16,7 @@ export interface FormattingOverrides {
     footer?: string;
     fileHeaderTimestamp?: boolean;
 }
-export type FileHeader = (defaultMessage: string[], options?: Config) => Promise<string[]> | string[];
+export type FileHeader = (defaultMessage?: string[], options?: Config) => Promise<string[]> | string[];
 export interface File {
     destination?: string;
     format?: string | FormatFn;

package/types/Preprocessor.d.ts

@@ -1,6 +1,6 @@
 import type { PreprocessedTokens } from './DesignToken.ts';
-import type { Config } from './Config.ts';
+import type { Config, PlatformConfig } from './Config.ts';
 export type Preprocessor = {
     name: string;
-    preprocessor: (dictionary: PreprocessedTokens, options: Config) => PreprocessedTokens | Promise<PreprocessedTokens>;
+    preprocessor: (dictionary: PreprocessedTokens, options: Config | PlatformConfig) => PreprocessedTokens | Promise<PreprocessedTokens>;
 };