@digdir/designsystemet 0.1.0-alpha.14 → 0.1.0-alpha.15

package/dist/src/tokens/formats/js-tokens.js

@@ -1,44 +1,30 @@
-// src/tokens/formats/js-tokens.ts
-import * as R2 from "ramda";
-import { fileHeader, createPropertyFormatter } from "style-dictionary/utils";
-
-// src/tokens/utils/utils.ts
 import * as R from "ramda";
-var getType = (token) => (token.$type ?? token.type) || "";
-var typeEquals = R.curry((types, token) => {
-  if (R.isNil(token)) {
-    return false;
-  }
-  return R.includes(R.toLower(getType(token)), R.map(R.toLower, Array.isArray(types) ? types : [types]));
-});
-
-// src/tokens/formats/js-tokens.ts
-var groupByType = R2.groupBy((token) => getType(token));
-var removeUnwatedTokens = R2.filter(
-  (token) => !["fds-base_spacing", "fds-base_sizing"].includes(token.name)
-);
-var toCssVarName = R2.pipe(R2.split(":"), R2.head, R2.trim);
-var jsTokens = {
-  name: "ds/js-tokens",
-  format: async function({ dictionary, file }) {
-    const format = createPropertyFormatter({
-      dictionary,
-      format: "css"
-    });
-    const formatTokens = R2.map((token) => ({
-      ...token,
-      name: toCssVarName(format(token))
-    }));
-    const processTokens = R2.pipe(removeUnwatedTokens, formatTokens, groupByType);
-    const tokens = processTokens(dictionary.allTokens);
-    const content = Object.entries(tokens).map(
-      ([name, token]) => `export const  ${name} = ${JSON.stringify(token, null, 2).replace(/"([^"]+)":/g, "$1:")} 
-`
-    ).join("\n");
-    return fileHeader({ file }).then((fileHeaderText) => fileHeaderText + content);
-  }
-};
-export {
-  jsTokens
+import { fileHeader, createPropertyFormatter } from "style-dictionary/utils";
+import { getType } from "../utils/utils.js";
+const groupByType = R.groupBy((token)=>getType(token));
+/** Add token name with prefix to list for removal */ const removeUnwatedTokens = R.filter((token)=>![
+        'fds-base_spacing',
+        'fds-base_sizing'
+    ].includes(token.name));
+const toCssVarName = R.pipe(R.split(':'), R.head, R.trim);
+/**
+ * Format for displaying tokens in storefront
+ */ export const jsTokens = {
+    name: 'ds/js-tokens',
+    format: async function({ dictionary, file }) {
+        const format = createPropertyFormatter({
+            dictionary,
+            format: 'css'
+        });
+        const formatTokens = R.map((token)=>({
+                ...token,
+                name: toCssVarName(format(token))
+            }));
+        const processTokens = R.pipe(removeUnwatedTokens, formatTokens, groupByType);
+        const tokens = processTokens(dictionary.allTokens);
+        const content = Object.entries(tokens).map(([name, token])=>`export const  ${name} = ${JSON.stringify(token, null, 2).replace(/"([^"]+)":/g, '$1:')} \n`).join('\n');
+        return fileHeader({
+            file
+        }).then((fileHeaderText)=>fileHeaderText + content);
+    }
 };
-//# sourceMappingURL=js-tokens.js.map

package/dist/src/tokens/transformers.js

@@ -1,87 +1,49 @@
-// src/tokens/transformers.ts
-import * as R2 from "ramda";
-
-// src/tokens/utils/noCase.ts
-var lowerCase = (text = "") => text.toLowerCase();
-var DEFAULT_SPLIT_REGEXP = [/([a-z0-9])([A-Z])/g, /([A-Z])([A-Z][a-z])/g];
-var DEFAULT_STRIP_REGEXP = /[^A-Z0-9]+/gi;
-function noCase(input, options = {}) {
-  const {
-    splitRegexp = DEFAULT_SPLIT_REGEXP,
-    stripRegexp = DEFAULT_STRIP_REGEXP,
-    transform = lowerCase,
-    delimiter = " "
-  } = options;
-  const result = replace(
-    replace(input, splitRegexp, "$1\0$2"),
-    stripRegexp,
-    "\0"
-  );
-  let start = 0;
-  let end = result.length;
-  while (result.charAt(start) === "\0") start++;
-  while (result.charAt(end - 1) === "\0") end--;
-  return result.slice(start, end).split("\0").map(transform).join(delimiter);
-}
-function replace(input, re, value) {
-  if (re instanceof RegExp) return input.replace(re, value);
-  return re.reduce((input2, re2) => input2.replace(re2, value), input);
-}
-
-// src/tokens/utils/utils.ts
 import * as R from "ramda";
-var getType = (token) => (token.$type ?? token.type) || "";
-var getValue = (token) => token.$value ?? token.value;
-var typeEquals = R.curry((types, token) => {
-  if (R.isNil(token)) {
-    return false;
-  }
-  return R.includes(R.toLower(getType(token)), R.map(R.toLower, Array.isArray(types) ? types : [types]));
-});
-
-// src/tokens/transformers.ts
-var isPx = R2.test(/\b\d+px\b/g);
-var sizeRem = {
-  name: "ds/size/toRem",
-  type: "value",
-  transitive: true,
-  filter: (token) => typeEquals(["sizing", "spacing", "borderRadius", "fontsizes"], token),
-  transform: (token, config) => {
-    const value = getValue(token);
-    if (isPx(value)) {
-      const baseFont = config.basePxFontSize || 16;
-      const size = parseInt(value);
-      if (size === 0) {
-        return "0";
-      }
-      return `${size / baseFont}rem`;
+import { noCase } from "./utils/noCase.js";
+import { getValue, typeEquals } from "./utils/utils.js";
+const isPx = R.test(/\b\d+px\b/g);
+export const sizeRem = {
+    name: 'ds/size/toRem',
+    type: 'value',
+    transitive: true,
+    filter: (token)=>typeEquals([
+            'sizing',
+            'spacing',
+            'borderRadius',
+            'fontsizes'
+        ], token),
+    transform: (token, config)=>{
+        const value = getValue(token);
+        if (isPx(value)) {
+            const baseFont = config.basePxFontSize || 16;
+            const size = parseInt(value);
+            if (size === 0) {
+                return '0';
+            }
+            return `${size / baseFont}rem`;
+        }
+        return value;
     }
-    return value;
-  }
 };
-var nameKebab = {
-  name: "name/cti/hierarchical-kebab",
-  type: "name",
-  transform: (token, options) => {
-    return noCase([options?.prefix].concat(token.path).join("-"), {
-      delimiter: "-",
-      stripRegexp: /[^A-Z0-9_]+/gi
-    });
-  }
-};
-var typographyShorthand = {
-  name: "typography/shorthand",
-  type: "value",
-  transitive: true,
-  filter: (token) => token.type === "typography",
-  transform: (token) => {
-    const typography = getValue(token);
-    return `${typography.fontWeight} ${typography.fontSize}/${typography.lineHeight} '${typography.fontFamily}'`;
-  }
+export const nameKebab = {
+    name: 'name/cti/hierarchical-kebab',
+    type: 'name',
+    transform: (token, options)=>{
+        return noCase([
+            options?.prefix
+        ].concat(token.path).join('-'), {
+            delimiter: '-',
+            stripRegexp: /[^A-Z0-9_]+/gi
+        });
+    }
 };
-export {
-  nameKebab,
-  sizeRem,
-  typographyShorthand
+export const typographyShorthand = {
+    name: 'typography/shorthand',
+    type: 'value',
+    transitive: true,
+    filter: (token)=>token.type === 'typography',
+    transform: (token)=>{
+        const typography = getValue(token);
+        return `${typography.fontWeight} ${typography.fontSize}/${typography.lineHeight} '${typography.fontFamily}'`;
+    }
 };
-//# sourceMappingURL=transformers.js.map

package/dist/src/tokens/utils/noCase.js

@@ -1,30 +1,28 @@
-// src/tokens/utils/noCase.ts
-var lowerCase = (text = "") => text.toLowerCase();
-var DEFAULT_SPLIT_REGEXP = [/([a-z0-9])([A-Z])/g, /([A-Z])([A-Z][a-z])/g];
-var DEFAULT_STRIP_REGEXP = /[^A-Z0-9]+/gi;
-function noCase(input, options = {}) {
-  const {
-    splitRegexp = DEFAULT_SPLIT_REGEXP,
-    stripRegexp = DEFAULT_STRIP_REGEXP,
-    transform = lowerCase,
-    delimiter = " "
-  } = options;
-  const result = replace(
-    replace(input, splitRegexp, "$1\0$2"),
-    stripRegexp,
-    "\0"
-  );
-  let start = 0;
-  let end = result.length;
-  while (result.charAt(start) === "\0") start++;
-  while (result.charAt(end - 1) === "\0") end--;
-  return result.slice(start, end).split("\0").map(transform).join(delimiter);
+// Copied from https://github.com/blakeembrey/change-case/blob/change-case%404.1.2/packages/no-case/src/index.ts
+const lowerCase = (text = '')=>text.toLowerCase();
+// Support camel case ("camelCase" -> "camel Case" and "CAMELCase" -> "CAMEL Case").
+const DEFAULT_SPLIT_REGEXP = [
+    /([a-z0-9])([A-Z])/g,
+    /([A-Z])([A-Z][a-z])/g
+];
+// Remove all non-word characters.
+const DEFAULT_STRIP_REGEXP = /[^A-Z0-9]+/gi;
+/**
+ * Normalize the string into something other libraries can manipulate easier.
+ */ export function noCase(input, options = {}) {
+    const { splitRegexp = DEFAULT_SPLIT_REGEXP, stripRegexp = DEFAULT_STRIP_REGEXP, transform = lowerCase, delimiter = ' ' } = options;
+    const result = replace(replace(input, splitRegexp, '$1\0$2'), stripRegexp, '\0');
+    let start = 0;
+    let end = result.length;
+    // Trim the delimiter from around the output string.
+    while(result.charAt(start) === '\0')start++;
+    while(result.charAt(end - 1) === '\0')end--;
+    // Transform each token independently.
+    return result.slice(start, end).split('\0').map(transform).join(delimiter);
 }
-function replace(input, re, value) {
-  if (re instanceof RegExp) return input.replace(re, value);
-  return re.reduce((input2, re2) => input2.replace(re2, value), input);
+/**
+ * Replace `re` in the input string with the replacement value.
+ */ function replace(input, re, value) {
+    if (re instanceof RegExp) return input.replace(re, value);
+    return re.reduce((input, re)=>input.replace(re, value), input);
 }
-export {
-  noCase
-};
-//# sourceMappingURL=noCase.js.map

package/dist/src/tokens/utils/permutateThemes.js

@@ -1,229 +1,77 @@
-// src/tokens/utils/permutateThemes.ts
 import * as R from "ramda";
-
-// ../../node_modules/@tokens-studio/types/dist/constants/BoxShadowTypes.js
-var BoxShadowTypes;
-(function(BoxShadowTypes2) {
-  BoxShadowTypes2["DROP_SHADOW"] = "dropShadow";
-  BoxShadowTypes2["INNER_SHADOW"] = "innerShadow";
-})(BoxShadowTypes || (BoxShadowTypes = {}));
-
-// ../../node_modules/@tokens-studio/types/dist/constants/ColorModifierTypes.js
-var ColorModifierTypes;
-(function(ColorModifierTypes2) {
-  ColorModifierTypes2["LIGHTEN"] = "lighten";
-  ColorModifierTypes2["DARKEN"] = "darken";
-  ColorModifierTypes2["MIX"] = "mix";
-  ColorModifierTypes2["ALPHA"] = "alpha";
-})(ColorModifierTypes || (ColorModifierTypes = {}));
-
-// ../../node_modules/@tokens-studio/types/dist/constants/ColorSpaceTypes.js
-var ColorSpaceTypes;
-(function(ColorSpaceTypes2) {
-  ColorSpaceTypes2["LCH"] = "lch";
-  ColorSpaceTypes2["SRGB"] = "srgb";
-  ColorSpaceTypes2["P3"] = "p3";
-  ColorSpaceTypes2["HSL"] = "hsl";
-})(ColorSpaceTypes || (ColorSpaceTypes = {}));
-
-// ../../node_modules/@tokens-studio/types/dist/constants/Properties.js
-var Properties;
-(function(Properties2) {
-  Properties2["sizing"] = "sizing";
-  Properties2["height"] = "height";
-  Properties2["width"] = "width";
-  Properties2["spacing"] = "spacing";
-  Properties2["verticalPadding"] = "verticalPadding";
-  Properties2["horizontalPadding"] = "horizontalPadding";
-  Properties2["paddingTop"] = "paddingTop";
-  Properties2["paddingRight"] = "paddingRight";
-  Properties2["paddingBottom"] = "paddingBottom";
-  Properties2["paddingLeft"] = "paddingLeft";
-  Properties2["itemSpacing"] = "itemSpacing";
-  Properties2["fill"] = "fill";
-  Properties2["backgroundBlur"] = "backgroundBlur";
-  Properties2["border"] = "border";
-  Properties2["borderTop"] = "borderTop";
-  Properties2["borderRight"] = "borderRight";
-  Properties2["borderBottom"] = "borderBottom";
-  Properties2["borderLeft"] = "borderLeft";
-  Properties2["borderColor"] = "borderColor";
-  Properties2["borderRadius"] = "borderRadius";
-  Properties2["borderRadiusTopLeft"] = "borderRadiusTopLeft";
-  Properties2["borderRadiusTopRight"] = "borderRadiusTopRight";
-  Properties2["borderRadiusBottomRight"] = "borderRadiusBottomRight";
-  Properties2["borderRadiusBottomLeft"] = "borderRadiusBottomLeft";
-  Properties2["borderWidth"] = "borderWidth";
-  Properties2["borderWidthTop"] = "borderWidthTop";
-  Properties2["borderWidthRight"] = "borderWidthRight";
-  Properties2["borderWidthBottom"] = "borderWidthBottom";
-  Properties2["borderWidthLeft"] = "borderWidthLeft";
-  Properties2["boxShadow"] = "boxShadow";
-  Properties2["opacity"] = "opacity";
-  Properties2["fontFamilies"] = "fontFamilies";
-  Properties2["fontWeights"] = "fontWeights";
-  Properties2["fontSizes"] = "fontSizes";
-  Properties2["lineHeights"] = "lineHeights";
-  Properties2["typography"] = "typography";
-  Properties2["composition"] = "composition";
-  Properties2["letterSpacing"] = "letterSpacing";
-  Properties2["paragraphSpacing"] = "paragraphSpacing";
-  Properties2["textCase"] = "textCase";
-  Properties2["dimension"] = "dimension";
-  Properties2["textDecoration"] = "textDecoration";
-  Properties2["asset"] = "asset";
-  Properties2["tokenValue"] = "tokenValue";
-  Properties2["value"] = "value";
-  Properties2["tokenName"] = "tokenName";
-  Properties2["description"] = "description";
-})(Properties || (Properties = {}));
-
-// ../../node_modules/@tokens-studio/types/dist/constants/TokenSetStatus.js
-var TokenSetStatus;
-(function(TokenSetStatus2) {
-  TokenSetStatus2["DISABLED"] = "disabled";
-  TokenSetStatus2["SOURCE"] = "source";
-  TokenSetStatus2["ENABLED"] = "enabled";
-})(TokenSetStatus || (TokenSetStatus = {}));
-
-// ../../node_modules/@tokens-studio/types/dist/constants/TokenTypes.js
-var TokenTypes;
-(function(TokenTypes2) {
-  TokenTypes2["OTHER"] = "other";
-  TokenTypes2["COLOR"] = "color";
-  TokenTypes2["BORDER_RADIUS"] = "borderRadius";
-  TokenTypes2["SIZING"] = "sizing";
-  TokenTypes2["SPACING"] = "spacing";
-  TokenTypes2["TEXT"] = "text";
-  TokenTypes2["TYPOGRAPHY"] = "typography";
-  TokenTypes2["OPACITY"] = "opacity";
-  TokenTypes2["BORDER_WIDTH"] = "borderWidth";
-  TokenTypes2["STROKE_STYLE"] = "strokeStyle";
-  TokenTypes2["BOX_SHADOW"] = "boxShadow";
-  TokenTypes2["FONT_FAMILIES"] = "fontFamilies";
-  TokenTypes2["FONT_WEIGHTS"] = "fontWeights";
-  TokenTypes2["LINE_HEIGHTS"] = "lineHeights";
-  TokenTypes2["FONT_SIZES"] = "fontSizes";
-  TokenTypes2["LETTER_SPACING"] = "letterSpacing";
-  TokenTypes2["PARAGRAPH_SPACING"] = "paragraphSpacing";
-  TokenTypes2["PARAGRAPH_INDENT"] = "paragraphIndent";
-  TokenTypes2["TEXT_DECORATION"] = "textDecoration";
-  TokenTypes2["TEXT_CASE"] = "textCase";
-  TokenTypes2["COMPOSITION"] = "composition";
-  TokenTypes2["DIMENSION"] = "dimension";
-  TokenTypes2["BORDER"] = "border";
-  TokenTypes2["ASSET"] = "asset";
-  TokenTypes2["BOOLEAN"] = "boolean";
-  TokenTypes2["NUMBER"] = "number";
-})(TokenTypes || (TokenTypes = {}));
-
-// ../../node_modules/@tokens-studio/types/dist/constants/BorderValues.js
-var BorderValues;
-(function(BorderValues2) {
-  BorderValues2["BORDER_COLOR"] = "color";
-  BorderValues2["BORDER_WIDTH"] = "width";
-  BorderValues2["BORDER_STYLE"] = "style";
-})(BorderValues || (BorderValues = {}));
-
-// ../../node_modules/@tokens-studio/types/dist/constants/StrokeStyleValues.js
-var StrokeStyleValues;
-(function(StrokeStyleValues2) {
-  StrokeStyleValues2["SOLID"] = "solid";
-  StrokeStyleValues2["DASHED"] = "dashed";
-  StrokeStyleValues2["DOTTED"] = "dotted";
-  StrokeStyleValues2["DOUBLE"] = "double";
-  StrokeStyleValues2["GROOVE"] = "groove";
-  StrokeStyleValues2["RIDGE"] = "ridge";
-  StrokeStyleValues2["OUTSET"] = "outset";
-  StrokeStyleValues2["INSET"] = "inset";
-})(StrokeStyleValues || (StrokeStyleValues = {}));
-
-// ../../node_modules/@tokens-studio/types/dist/constants/BoxShadowValues.js
-var BoxShadowValues;
-(function(BoxShadowValues2) {
-  BoxShadowValues2["TYPE"] = "type";
-  BoxShadowValues2["COLOR"] = "color";
-  BoxShadowValues2["X"] = "x";
-  BoxShadowValues2["Y"] = "y";
-  BoxShadowValues2["BLUR"] = "blur";
-  BoxShadowValues2["SPREAD"] = "spread";
-  BoxShadowValues2["BLEND_MODE"] = "blendMode";
-})(BoxShadowValues || (BoxShadowValues = {}));
-
-// ../../node_modules/@tokens-studio/types/dist/constants/TypographyValues.js
-var TypographyValues;
-(function(TypographyValues2) {
-  TypographyValues2["FONT_FAMILY"] = "fontFamily";
-  TypographyValues2["FONT_WEIGHT"] = "fontWeight";
-  TypographyValues2["LINE_HEIGHT"] = "lineHeight";
-  TypographyValues2["FONT_SIZE"] = "fontSize";
-  TypographyValues2["LETTER_SPACING"] = "letterSpacing";
-  TypographyValues2["PARAGRAPH_SPACING"] = "paragraphSpacing";
-  TypographyValues2["PARAGRAPH_INDENT"] = "paragraphIndent";
-  TypographyValues2["TEXT_DECORATION"] = "textDecoration";
-  TypographyValues2["TEXT_CASE"] = "textCase";
-})(TypographyValues || (TypographyValues = {}));
-
-// src/tokens/utils/permutateThemes.ts
+import { TokenSetStatus } from "@tokens-studio/types";
 function mapThemesToSetsObject(themes) {
-  return themes.map((theme) => ({ name: theme.name, selectedTokenSets: filterTokenSets(theme.selectedTokenSets) }));
+    return themes.map((theme)=>({
+            name: theme.name,
+            selectedTokenSets: filterTokenSets(theme.selectedTokenSets)
+        }));
 }
-function permutateThemes(themes, { separator = "-" } = {}) {
-  if (!themes.some((theme) => theme.group)) {
-    return mapThemesToSetsObject(themes);
-  }
-  const groups = {};
-  themes.forEach((theme) => {
-    if (theme.group) {
-      groups[theme.group] = [...groups[theme.group] ?? [], theme];
-    } else {
-      throw new Error(
-        `Theme ${theme.name} does not have a group property, which is required for multi-dimensional theming.`
-      );
+export function permutateThemes(themes, { separator = '-' } = {}) {
+    if (!themes.some((theme)=>theme.group)) {
+        return mapThemesToSetsObject(themes);
     }
-  });
-  if (Object.keys(groups).length <= 1) {
-    return mapThemesToSetsObject(themes);
-  }
-  const permutations = cartesian(Object.values(groups));
-  const permutatedThemes = permutations.map((perm) => {
-    const permutatedTheme = perm.reduce(
-      (acc, theme) => {
-        const { group, name, selectedTokenSets } = theme;
-        let updatedPermutatedTheme = acc;
-        if (group) {
-          const groupProp = R.lensProp(group.toLowerCase());
-          updatedPermutatedTheme = R.set(groupProp, name.toLowerCase(), updatedPermutatedTheme);
+    // Sort themes by groups
+    const groups = {};
+    themes.forEach((theme)=>{
+        if (theme.group) {
+            groups[theme.group] = [
+                ...groups[theme.group] ?? [],
+                theme
+            ];
+        } else {
+            throw new Error(`Theme ${theme.name} does not have a group property, which is required for multi-dimensional theming.`);
         }
-        const updatedName = `${String(acc.name)}${acc ? separator : ""}${name}`;
-        const sets = [...updatedPermutatedTheme.selectedTokenSets, ...filterTokenSets(selectedTokenSets)];
+    });
+    if (Object.keys(groups).length <= 1) {
+        return mapThemesToSetsObject(themes);
+    }
+    // Create theme permutations
+    const permutations = cartesian(Object.values(groups));
+    const permutatedThemes = permutations.map((perm)=>{
+        const permutatedTheme = perm.reduce((acc, theme)=>{
+            const { group, name, selectedTokenSets } = theme;
+            let updatedPermutatedTheme = acc;
+            if (group) {
+                const groupProp = R.lensProp(group.toLowerCase());
+                updatedPermutatedTheme = R.set(groupProp, name.toLowerCase(), updatedPermutatedTheme);
+            }
+            const updatedName = `${String(acc.name)}${acc ? separator : ''}${name}`;
+            const sets = [
+                ...updatedPermutatedTheme.selectedTokenSets,
+                ...filterTokenSets(selectedTokenSets)
+            ];
+            return {
+                ...updatedPermutatedTheme,
+                name: updatedName,
+                selectedTokenSets: sets
+            };
+        }, {
+            name: '',
+            selectedTokenSets: []
+        });
+        const uniqueTokenSets = new Set(permutatedTheme.selectedTokenSets);
         return {
-          ...updatedPermutatedTheme,
-          name: updatedName,
-          selectedTokenSets: sets
+            ...permutatedTheme,
+            selectedTokenSets: Array.from(uniqueTokenSets)
         };
-      },
-      { name: "", selectedTokenSets: [] }
-    );
-    const uniqueTokenSets = new Set(permutatedTheme.selectedTokenSets);
-    return { ...permutatedTheme, selectedTokenSets: Array.from(uniqueTokenSets) };
-  });
-  return permutatedThemes;
+    });
+    return permutatedThemes;
 }
 function filterTokenSets(tokensets) {
-  return Object.entries(tokensets).filter(([, val]) => val !== TokenSetStatus.DISABLED).sort((a, b) => {
-    if (a[1] === TokenSetStatus.SOURCE && b[1] === TokenSetStatus.ENABLED) {
-      return -1;
-    } else if (a[1] === TokenSetStatus.ENABLED && b[1] === TokenSetStatus.SOURCE) {
-      return 1;
-    }
-    return 0;
-  }).map((entry) => entry[0]);
+    return Object.entries(tokensets).filter(([, val])=>val !== TokenSetStatus.DISABLED)// ensure source type sets are always ordered before enabled type sets
+    .sort((a, b)=>{
+        if (a[1] === TokenSetStatus.SOURCE && b[1] === TokenSetStatus.ENABLED) {
+            return -1;
+        } else if (a[1] === TokenSetStatus.ENABLED && b[1] === TokenSetStatus.SOURCE) {
+            return 1;
+        }
+        return 0;
+    }).map((entry)=>entry[0]);
 }
+// cartesian permutations: [[1,2], [3,4]] -> [[1,3], [1,4], [2,3], [2,4]]
 function cartesian(a) {
-  return a.reduce((a2, b) => a2.flatMap((d) => b.map((e) => [d, e].flat())));
+    return a.reduce((a, b)=>a.flatMap((d)=>b.map((e)=>[
+                    d,
+                    e
+                ].flat())));
 }
-export {
-  permutateThemes
-};
-//# sourceMappingURL=permutateThemes.js.map

package/dist/src/tokens/utils/utils.js

@@ -1,16 +1,27 @@
-// src/tokens/utils/utils.ts
 import * as R from "ramda";
-var getType = (token) => (token.$type ?? token.type) || "";
-var getValue = (token) => token.$value ?? token.value;
-var typeEquals = R.curry((types, token) => {
-  if (R.isNil(token)) {
-    return false;
-  }
-  return R.includes(R.toLower(getType(token)), R.map(R.toLower, Array.isArray(types) ? types : [types]));
+/**
+ * Returns type based on design token format used. Read more:https://v4.styledictionary.com/info/dtcg/
+ * @param token Transformed token
+ * @returns type
+ */ export const getType = (token)=>(token.$type ?? token.type) || '';
+/**
+ * Returns value based on design token format used. Read more:https://v4.styledictionary.com/info/dtcg/
+ *
+ * Use generic (`<T>`) to define return value type
+ * @param token Transformed or Design token
+ * @returns value
+ */ export const getValue = (token)=>token.$value ?? token.value;
+/**
+ * Check if token type matches provided type
+ * This function is curried
+ * @param types Type or array of types to check against
+ * @param token Transformed token
+ * @returns boolean
+ */ export const typeEquals = R.curry((types, token)=>{
+    if (R.isNil(token)) {
+        return false;
+    }
+    return R.includes(R.toLower(getType(token)), R.map(R.toLower, Array.isArray(types) ? types : [
+        types
+    ]));
 });
-export {
-  getType,
-  getValue,
-  typeEquals
-};
-//# sourceMappingURL=utils.js.map