@breadstone-infrastructure/style-dictionary 0.0.174 → 0.0.175

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## 0.0.174 (2025-11-28)
+
+### 🚀 Features
+
+- Add utility classes and methods for number, string, time, version, and process handling ([941d93259a](https://github.com/RueDeRennes/mosaik/commit/941d93259a))
+- **tailwind:** add Joy Tailwind plugin with configuration options and token exposure ([72bbf954a8](https://github.com/RueDeRennes/mosaik/commit/72bbf954a8))
+- **svg:** add SVG to path conversion utility ([f2f74da782](https://github.com/RueDeRennes/mosaik/commit/f2f74da782))
+
+### 🩹 Fixes
+
+- remove unused elevation2 light token and update release version in package.json ([9a63ade438](https://github.com/RueDeRennes/mosaik/commit/9a63ade438))
+- remove unused dependency 'element-to-path' from yarn.lock ([df86dc94de](https://github.com/RueDeRennes/mosaik/commit/df86dc94de))
+- add newline at end of package.json ([73db364d3c](https://github.com/RueDeRennes/mosaik/commit/73db364d3c))
+
 ## 0.0.173 (2025-11-26)
 
 ### 🚀 Features

package/formats/tailwind/DesignTokenType.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Supported logical token types as returned by `getType`.
+ *
+ * This mirrors your original formatter’s behavior and is used for
+ * type-based fallback mapping if no valid category is present.
+ *
+ * @public
+ */
+export type DesignTokenType = 'borderRadius' | 'borderWidth' | 'color' | 'duration' | 'font' | 'fontFamily' | 'fontSize' | 'fontWeight' | 'height' | 'letterSpacing' | 'lineHeight' | 'maxHeight' | 'maxWidth' | 'minHeight' | 'minWidth' | 'opacity' | 'shadow' | 'size' | 'spacing' | 'width' | 'zIndex';
+//# sourceMappingURL=DesignTokenType.d.ts.map

package/formats/tailwind/DesignTokenType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesignTokenType.d.ts","sourceRoot":"","sources":["../../../src/formats/tailwind/DesignTokenType.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAK,cAAc,GAAG,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,GAAG,eAAe,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC"}

package/formats/tailwind/DesignTokenType.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=DesignTokenType.js.map

package/formats/tailwind/DesignTokenType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesignTokenType.js","sourceRoot":"","sources":["../../../src/formats/tailwind/DesignTokenType.ts"],"names":[],"mappings":""}

package/formats/tailwind/TailwindPropertyMapping.d.ts

@@ -0,0 +1,66 @@
+import type { Config as TailwindConfig } from 'tailwindcss';
+import type { DesignTokenType } from './DesignTokenType';
+/**
+ * A valid key for the `theme` section of Tailwind config.
+ *
+ * @public
+ */
+export type TailwindThemeKey = keyof NonNullable<TailwindConfig['theme']>;
+/**
+ * Strategy describing how to map a token value under a given theme key.
+ *
+ * - "flat":       Direct mapping, e.g. spacing, fontSize.
+ *                 Example:
+ *                   path: ['layout-header-height'] -> spacing['layout-header-height']
+ * - "nested":     Nested mapping based on token path segments.
+ *                 Example:
+ *                   path: ['layout', 'header', 'height'] -> spacing.layout.header.height
+ * - "shadeMap":   Mapping for color shades.
+ *                 Example:
+ *                   path: ['brand', '500'] -> colors.brand['500']
+ * - "shadow":     Mapping for shadow tokens.
+ *                 Example:
+ *                   path: ['card-shadow'] -> boxShadow['card-shadow']
+ *
+ * @private
+ */
+type MappingStrategy = 'flat' | 'nested' | 'shadeMap' | 'shadow';
+/**
+ * Internal mapping definition: for a given Tailwind theme key,
+ * which mapping strategy to apply when inserting tokens.
+ *
+ * @public
+ */
+export interface IKeyMapping {
+    readonly themeKey: TailwindThemeKey;
+    readonly strategy: MappingStrategy;
+}
+/**
+ * Set of supported design token types for validation.
+ * Used only for logging; unsupported types are skipped.
+ *
+ * @public
+ */
+export declare const SUPPORTED_TOKEN_TYPES: ReadonlyArray<DesignTokenType>;
+/**
+ * Maps token-level `category` values (which MUST match Tailwind theme keys)
+ * to Tailwind theme keys and the corresponding mapping strategy.
+ *
+ * This is the primary mapping: if a token specifies a `category` and it is
+ * found here, it is used directly.
+ *
+ * @public
+ */
+export declare const CATEGORY_TO_KEY_MAPPING: Partial<Record<TailwindThemeKey, IKeyMapping>>;
+/**
+ * Fallback mapping from logical token type → Tailwind theme key + strategy.
+ *
+ * This is used when there is no valid `category` on the token.
+ * It keeps the behavior close to the original formatter where routing
+ * was based on `type`.
+ *
+ * @public
+ */
+export declare const TOKEN_TYPE_TO_KEY_MAPPING: Partial<Record<DesignTokenType, IKeyMapping>>;
+export {};
+//# sourceMappingURL=TailwindPropertyMapping.d.ts.map

package/formats/tailwind/TailwindPropertyMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TailwindPropertyMapping.d.ts","sourceRoot":"","sources":["../../../src/formats/tailwind/TailwindPropertyMapping.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;;;GAiBG;AACH,KAAK,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACtC;AA+BD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,eAAe,CAsBhE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAiDlF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC,CAqFnF,CAAC"}

package/formats/tailwind/TailwindPropertyMapping.js

@@ -0,0 +1,188 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOKEN_TYPE_TO_KEY_MAPPING = exports.CATEGORY_TO_KEY_MAPPING = exports.SUPPORTED_TOKEN_TYPES = void 0;
+/**
+ * Set of supported design token types for validation.
+ * Used only for logging; unsupported types are skipped.
+ *
+ * @public
+ */
+exports.SUPPORTED_TOKEN_TYPES = [
+    'borderRadius',
+    'borderWidth',
+    'color',
+    'duration',
+    'font',
+    'fontFamily',
+    'fontSize',
+    'fontWeight',
+    'height',
+    'letterSpacing',
+    'lineHeight',
+    'maxHeight',
+    'maxWidth',
+    'minHeight',
+    'minWidth',
+    'opacity',
+    'shadow',
+    'size',
+    'spacing',
+    'width',
+    'zIndex'
+];
+/**
+ * Maps token-level `category` values (which MUST match Tailwind theme keys)
+ * to Tailwind theme keys and the corresponding mapping strategy.
+ *
+ * This is the primary mapping: if a token specifies a `category` and it is
+ * found here, it is used directly.
+ *
+ * @public
+ */
+exports.CATEGORY_TO_KEY_MAPPING = {
+    colors: {
+        themeKey: 'colors',
+        strategy: 'nested'
+    },
+    spacing: {
+        themeKey: 'spacing',
+        strategy: 'flat'
+    },
+    width: {
+        themeKey: 'width',
+        strategy: 'flat'
+    },
+    height: {
+        themeKey: 'height',
+        strategy: 'flat'
+    },
+    fontFamily: {
+        themeKey: 'fontFamily',
+        strategy: 'flat'
+    },
+    fontSize: {
+        themeKey: 'fontSize',
+        strategy: 'flat'
+    },
+    boxShadow: {
+        themeKey: 'boxShadow',
+        strategy: 'shadow'
+    },
+    opacity: {
+        themeKey: 'opacity',
+        strategy: 'flat'
+    },
+    borderRadius: {
+        themeKey: 'borderRadius',
+        strategy: 'flat'
+    },
+    borderWidth: {
+        themeKey: 'borderWidth',
+        strategy: 'flat'
+    },
+    zIndex: {
+        themeKey: 'zIndex',
+        strategy: 'flat'
+    },
+    transitionDuration: {
+        themeKey: 'transitionDuration',
+        strategy: 'flat'
+    }
+};
+/**
+ * Fallback mapping from logical token type → Tailwind theme key + strategy.
+ *
+ * This is used when there is no valid `category` on the token.
+ * It keeps the behavior close to the original formatter where routing
+ * was based on `type`.
+ *
+ * @public
+ */
+exports.TOKEN_TYPE_TO_KEY_MAPPING = {
+    color: {
+        themeKey: 'colors',
+        strategy: 'nested'
+    },
+    spacing: {
+        themeKey: 'spacing',
+        strategy: 'flat'
+    },
+    size: {
+        themeKey: 'spacing',
+        strategy: 'flat'
+    },
+    width: {
+        themeKey: 'width',
+        strategy: 'flat'
+    },
+    height: {
+        themeKey: 'height',
+        strategy: 'flat'
+    },
+    maxWidth: {
+        themeKey: 'maxWidth',
+        strategy: 'flat'
+    },
+    maxHeight: {
+        themeKey: 'maxHeight',
+        strategy: 'flat'
+    },
+    minWidth: {
+        themeKey: 'minWidth',
+        strategy: 'flat'
+    },
+    minHeight: {
+        themeKey: 'minHeight',
+        strategy: 'flat'
+    },
+    borderRadius: {
+        themeKey: 'borderRadius',
+        strategy: 'flat'
+    },
+    borderWidth: {
+        themeKey: 'borderWidth',
+        strategy: 'flat'
+    },
+    font: {
+        themeKey: 'fontFamily',
+        strategy: 'flat'
+    },
+    fontFamily: {
+        themeKey: 'fontFamily',
+        strategy: 'flat'
+    },
+    fontSize: {
+        themeKey: 'fontSize',
+        strategy: 'flat'
+    },
+    fontWeight: {
+        themeKey: 'fontWeight',
+        strategy: 'flat'
+    },
+    lineHeight: {
+        themeKey: 'lineHeight',
+        strategy: 'flat'
+    },
+    letterSpacing: {
+        themeKey: 'letterSpacing',
+        strategy: 'flat'
+    },
+    shadow: {
+        themeKey: 'boxShadow',
+        strategy: 'shadow'
+    },
+    opacity: {
+        themeKey: 'opacity',
+        strategy: 'flat'
+    },
+    zIndex: {
+        themeKey: 'zIndex',
+        strategy: 'flat'
+    },
+    duration: {
+        themeKey: 'transitionDuration',
+        strategy: 'flat'
+    }
+};
+//# sourceMappingURL=TailwindPropertyMapping.js.map

package/formats/tailwind/TailwindPropertyMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TailwindPropertyMapping.js","sourceRoot":"","sources":["../../../src/formats/tailwind/TailwindPropertyMapping.ts"],"names":[],"mappings":"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"}

package/formats/tailwind/buildTailwindConfig.d.ts

@@ -0,0 +1,23 @@
+import type { Config as TailwindConfig } from 'tailwindcss';
+import type { TransformedToken } from 'style-dictionary/types';
+/**
+ * Builds a TailwindConfig object (with `theme.extend`) from a list of Style-Dictionary tokens.
+ *
+ * Resolution priority per token:
+ *
+ * 1. If `token.category` is present and matches a known Tailwind theme key
+ *    (configured in CATEGORY_TO_KEY_MAPPING), that mapping is used.
+ * 2. Otherwise, the token's logical type (`getType(token)`) is used with
+ *    TOKEN_TYPE_TO_KEY_MAPPING as a fallback routing.
+ * 3. If neither category nor type yields a mapping, the token is skipped
+ *    and a warning is logged.
+ *
+ * Additionally, this function validates token types up-front and logs warnings
+ * for unsupported types (non-blocking).
+ *
+ * @param allTokens All transformed tokens from Style-Dictionary.
+ * @param ignoredTokenNameSubstrings Optional substrings; tokens whose name contains any of them are ignored entirely.
+ * @returns A TailwindConfig where `theme.extend` contains the mapped tokens.
+ */
+export declare function buildTailwindConfig(allTokens: ReadonlyArray<TransformedToken>, ignoredTokenNameSubstrings?: Array<string>): TailwindConfig;
+//# sourceMappingURL=buildTailwindConfig.d.ts.map

package/formats/tailwind/buildTailwindConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTailwindConfig.d.ts","sourceRoot":"","sources":["../../../src/formats/tailwind/buildTailwindConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAyH/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAC/B,SAAS,EAAE,aAAa,CAAC,gBAAgB,CAAC,EAC1C,0BAA0B,GAAE,KAAK,CAAC,MAAM,CAAM,GAC/C,cAAc,CAqEhB"}

package/formats/tailwind/buildTailwindConfig.js

@@ -0,0 +1,191 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTailwindConfig = buildTailwindConfig;
+const utilities_1 = require("@breadstone-infrastructure/utilities");
+const getType_js_1 = require("../../utilities/getType.js");
+const getValue_js_1 = require("../../utilities/getValue.js");
+const TailwindPropertyMapping_js_1 = require("./TailwindPropertyMapping.js");
+// #endregion
+/**
+ * Normalizes a raw token value into a JS value suitable for a Tailwind config.
+ *
+ * @param value Raw token value.
+ * @returns Normalized value (string, number, or array) that can be used in Tailwind config.
+ * @private
+ */
+function normalizeValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((v) => String(v));
+    }
+    if (typeof value === 'string' || typeof value === 'number') {
+        return value;
+    }
+    return String(value);
+}
+/**
+ * Deeply sets a value on an object via a path array. Similar to lodash.set.
+ *
+ * @param obj Target object.
+ * @param path Array of keys.
+ * @param value Value to set.
+ * @private
+ */
+function deepSet(obj, path, value) {
+    let current = obj;
+    for (let i = 0; i < path.length; i++) {
+        const key = path[i];
+        if (i === path.length - 1) {
+            current[key] = value;
+        }
+        else {
+            if (!current[key] || typeof current[key] !== 'object') {
+                current[key] = {};
+            }
+            current = current[key];
+        }
+    }
+}
+/**
+ * Validates that tokens use supported logical types and logs warnings
+ * for those that cannot be mapped to Tailwind.
+ *
+ * This does not throw, it only logs — matching the original behavior.
+ *
+ * @param tokens All transformed tokens.
+ * @param ignoredNames Optional substrings; tokens whose name contains any of them are ignored.
+ * @private
+ */
+function validateTokenTypes(tokens, ignoredNames = []) {
+    const supported = new Set(TailwindPropertyMapping_js_1.SUPPORTED_TOKEN_TYPES);
+    tokens
+        .filter((token) => {
+        const lower = token.name.toLowerCase();
+        return !ignoredNames.some((substr) => lower.includes(substr.toLowerCase()));
+    })
+        .forEach((token) => {
+        const type = (0, getType_js_1.getType)(token);
+        if (!type) {
+            return;
+        }
+        if (!supported.has(type)) {
+            console.warn(`${(0, utilities_1.symbol)('warning')} ${(0, utilities_1.yellow)(`Type "${type}" is not supported in Tailwind builder for token "${token.path.join('.')}:${token.name}".`)}`);
+        }
+    });
+}
+/**
+ * Resolves the mapping for a token in three steps:
+ *
+ * 1. If a `category` is present and mapped, use that mapping.
+ * 2. Otherwise, fall back to token type via `getType` and `TOKEN_TYPE_TO_KEY_MAPPING`.
+ * 3. If neither yields a mapping, return undefined (caller will log and skip).
+ *
+ * @param token The token to resolve mapping for.
+ * @returns An IKeyMapping when resolvable, otherwise undefined.
+ * @private
+ */
+function resolveMappingForToken(token) {
+    const rawCategory = token.category;
+    // 1. Category-based mapping (if present)
+    if (rawCategory) {
+        const categoryKey = rawCategory;
+        const byCategory = TailwindPropertyMapping_js_1.CATEGORY_TO_KEY_MAPPING[categoryKey];
+        if (byCategory) {
+            return byCategory;
+        }
+        // Category was provided but not recognized; we fall back to type-based logic.
+        console.warn(`${(0, utilities_1.symbol)('warning')} ${(0, utilities_1.yellow)(`Token "${token.name}" specifies category "${rawCategory}", which is not mapped. Falling back to token type.`)}`);
+    }
+    // 2. Type-based mapping
+    const type = (0, getType_js_1.getType)(token);
+    if (type) {
+        const byType = TailwindPropertyMapping_js_1.TOKEN_TYPE_TO_KEY_MAPPING[type];
+        if (byType) {
+            return byType;
+        }
+    }
+    // 3. Nothing found: no mapping available
+    return undefined;
+}
+/**
+ * Builds a TailwindConfig object (with `theme.extend`) from a list of Style-Dictionary tokens.
+ *
+ * Resolution priority per token:
+ *
+ * 1. If `token.category` is present and matches a known Tailwind theme key
+ *    (configured in CATEGORY_TO_KEY_MAPPING), that mapping is used.
+ * 2. Otherwise, the token's logical type (`getType(token)`) is used with
+ *    TOKEN_TYPE_TO_KEY_MAPPING as a fallback routing.
+ * 3. If neither category nor type yields a mapping, the token is skipped
+ *    and a warning is logged.
+ *
+ * Additionally, this function validates token types up-front and logs warnings
+ * for unsupported types (non-blocking).
+ *
+ * @param allTokens All transformed tokens from Style-Dictionary.
+ * @param ignoredTokenNameSubstrings Optional substrings; tokens whose name contains any of them are ignored entirely.
+ * @returns A TailwindConfig where `theme.extend` contains the mapped tokens.
+ */
+function buildTailwindConfig(allTokens, ignoredTokenNameSubstrings = []) {
+    // Pre-validation of token types (non-blocking, only logs)
+    validateTokenTypes(allTokens, ignoredTokenNameSubstrings);
+    const config = { theme: { extend: {} } };
+    for (const token of allTokens) {
+        const lowerName = token.name.toLowerCase();
+        if (ignoredTokenNameSubstrings.some((substr) => lowerName.includes(substr.toLowerCase()))) {
+            continue;
+        }
+        const mapping = resolveMappingForToken(token);
+        if (!mapping) {
+            console.warn(`${(0, utilities_1.symbol)('warning')} ${(0, utilities_1.yellow)(`Token "${token.path.join('.')}:${token.name}" cannot be mapped to Tailwind (no valid category or type mapping). Skipping.`)}`);
+            continue;
+        }
+        const { themeKey, strategy } = mapping;
+        if (!config.theme?.extend) {
+            if (!config.theme) {
+                config.theme = {};
+                config.theme.extend = {};
+            }
+            else {
+                config.theme.extend = {};
+            }
+        }
+        const extend = config.theme.extend;
+        // eslint-disable-next-line no-multi-assign
+        const section = extend[themeKey] ??= {};
+        const rawValue = (0, getValue_js_1.getValue)(token);
+        const normalized = normalizeValue(rawValue);
+        const path = token.path.length > 0 ? token.path : [token.name];
+        switch (strategy) {
+            case 'flat': {
+                const key = path.join('.');
+                section[key] = normalized;
+                break;
+            }
+            case 'nested': {
+                deepSet(section, path, normalized);
+                break;
+            }
+            case 'shadeMap': {
+                // Example:
+                // path: ['brand', '500'] -> colors.brand['500']
+                const [group, ...rest] = path;
+                const shadeKey = rest.join('.') || 'DEFAULT';
+                section[group] ??= {};
+                section[group][shadeKey] = normalized;
+                break;
+            }
+            case 'shadow': {
+                const key = path.join('-');
+                section[key] = Array.isArray(normalized) ? normalized.map((v) => String(v)).join(', ') : String(normalized);
+                break;
+            }
+            default: {
+                console.warn(`${(0, utilities_1.symbol)('warning')} ${(0, utilities_1.yellow)(`Unsupported mapping strategy "${String(strategy)}" for token "${token.name}".`)}`);
+                break;
+            }
+        }
+    }
+    return config;
+}
+//# sourceMappingURL=buildTailwindConfig.js.map

package/formats/tailwind/buildTailwindConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTailwindConfig.js","sourceRoot":"","sources":["../../../src/formats/tailwind/buildTailwindConfig.ts"],"names":[],"mappings":"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"}

package/formats/tailwind/index.d.ts

@@ -0,0 +1,2 @@
+export * from './tailwindFormat';
+//# sourceMappingURL=index.d.ts.map

package/formats/tailwind/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/formats/tailwind/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/formats/tailwind/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./tailwindFormat"), exports);
+//# sourceMappingURL=index.js.map

package/formats/tailwind/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/formats/tailwind/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC"}

package/formats/tailwind/tailwindFormat.d.ts

@@ -0,0 +1,17 @@
+import type { Format } from 'style-dictionary/types';
+/**
+ * Style-Dictionary format that outputs a CommonJS `tailwind.config.js`,
+ * exporting the theme configuration as `module.exports = …`.
+ */
+export declare const tailwindConfigCjsFormat: Format;
+/**
+ * Style-Dictionary format that outputs an ESM `tailwind.config.mjs`,
+ * exporting the theme configuration as `export default { … }`.
+ */
+export declare const tailwindConfigEsmFormat: Format;
+/**
+ * Style-Dictionary format that generates a full Tailwind plugin JS module.
+ * The output exports a config + plugin registration — no manual imports needed.
+ */
+export declare const tailwindPluginJsFormat: Format;
+//# sourceMappingURL=tailwindFormat.d.ts.map

package/formats/tailwind/tailwindFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwindFormat.d.ts","sourceRoot":"","sources":["../../../src/formats/tailwind/tailwindFormat.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAsB,MAAM,EAAgB,MAAM,wBAAwB,CAAC;AAKvF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MASrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MASrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MA4BpC,CAAC"}

package/formats/tailwind/tailwindFormat.js

@@ -0,0 +1,58 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tailwindPluginJsFormat = exports.tailwindConfigEsmFormat = exports.tailwindConfigCjsFormat = void 0;
+const buildTailwindConfig_js_1 = require("./buildTailwindConfig.js");
+// #endregion
+/**
+ * Style-Dictionary format that outputs a CommonJS `tailwind.config.js`,
+ * exporting the theme configuration as `module.exports = …`.
+ */
+exports.tailwindConfigCjsFormat = {
+    name: 'tailwind/config/cjs',
+    format({ dictionary, options }) {
+        const config = (0, buildTailwindConfig_js_1.buildTailwindConfig)(dictionary.allTokens, options.ignoredTokenNames ?? []);
+        return `module.exports = ${JSON.stringify(config, null, 2)};\n`;
+    }
+};
+/**
+ * Style-Dictionary format that outputs an ESM `tailwind.config.mjs`,
+ * exporting the theme configuration as `export default { … }`.
+ */
+exports.tailwindConfigEsmFormat = {
+    name: 'tailwind/config/esm',
+    format({ dictionary, options }) {
+        const config = (0, buildTailwindConfig_js_1.buildTailwindConfig)(dictionary.allTokens, options.ignoredTokenNames ?? []);
+        return `export default ${JSON.stringify(config, null, 2)};\n`;
+    }
+};
+/**
+ * Style-Dictionary format that generates a full Tailwind plugin JS module.
+ * The output exports a config + plugin registration — no manual imports needed.
+ */
+exports.tailwindPluginJsFormat = {
+    name: 'tailwind/plugin',
+    format({ dictionary, options }) {
+        const config = (0, buildTailwindConfig_js_1.buildTailwindConfig)(dictionary.allTokens, options.ignoredTokenNames ?? []);
+        const themeSection = JSON.stringify(config.theme, null, 2);
+        return `${`
+const plugin = require('tailwindcss/plugin');
+
+module.exports = {
+  theme: ${themeSection},
+  plugins: [
+    plugin(function({ addUtilities, theme, e }) {
+      const shadows = theme('boxShadow') || {};
+      const utils = Object.entries(shadows).reduce((acc, [key, value]) => {
+        acc['.' + e('shadow-' + key)] = { boxShadow: value };
+        return acc;
+      }, {});
+      addUtilities(utils, ['responsive', 'hover', 'focus']);
+      // You can extend with more utilities here (spacing, radii, etc.)
+    })
+  ]
+};
+`.trim()}\n`;
+    }
+};
+//# sourceMappingURL=tailwindFormat.js.map

package/formats/tailwind/tailwindFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwindFormat.js","sourceRoot":"","sources":["../../../src/formats/tailwind/tailwindFormat.ts"],"names":[],"mappings":";AAAA,kBAAkB;;;AAGlB,qEAA+D;AAE/D,aAAa;AAEb;;;GAGG;AACU,QAAA,uBAAuB,GAAW;IAC3C,IAAI,EAAE,qBAAqB;IAC3B,MAAM,CAAC,EAAE,UAAU,EAAE,OAAO,EAG3B;QACG,MAAM,MAAM,GAAG,IAAA,4CAAmB,EAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC1F,OAAO,oBAAoB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC;IACpE,CAAC;CACJ,CAAC;AAEF;;;GAGG;AACU,QAAA,uBAAuB,GAAW;IAC3C,IAAI,EAAE,qBAAqB;IAC3B,MAAM,CAAC,EAAE,UAAU,EAAE,OAAO,EAG3B;QACG,MAAM,MAAM,GAAG,IAAA,4CAAmB,EAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC1F,OAAO,kBAAkB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC;IAClE,CAAC;CACJ,CAAC;AAEF;;;GAGG;AACU,QAAA,sBAAsB,GAAW;IAC1C,IAAI,EAAE,iBAAiB;IACvB,MAAM,CAAC,EAAE,UAAU,EAAE,OAAO,EAG3B;QACG,MAAM,MAAM,GAAG,IAAA,4CAAmB,EAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC1F,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAE3D,OAAO,GAAG;;;;WAIP,YAAY;;;;;;;;;;;;;CAatB,CAAC,IAAI,EAAE,IAAI,CAAC;IACT,CAAC;CACJ,CAAC"}