@breadstone-infrastructure/style-dictionary 0.0.205 → 0.0.209

package/formats/tailwind/v4/buildTailwindV4Config.js

@@ -0,0 +1,338 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTailwindV4Config = buildTailwindV4Config;
+exports.formatTailwindV4ConfigAsJs = formatTailwindV4ConfigAsJs;
+exports.formatTailwindV4ConfigAsTs = formatTailwindV4ConfigAsTs;
+exports.buildTailwindV4ConfigJs = buildTailwindV4ConfigJs;
+exports.buildTailwindV4ConfigTs = buildTailwindV4ConfigTs;
+const utilities_1 = require("@breadstone-infrastructure/utilities");
+const getType_js_1 = require("../../../utilities/getType.js");
+const getValue_js_1 = require("../../../utilities/getValue.js");
+const TailwindV4PropertyMapping_js_1 = require("./TailwindV4PropertyMapping.js");
+// #endregion
+// #region Fields
+/**
+ * Auto-generated file header comment for JS files.
+ *
+ * @private
+ */
+const JS_FILE_HEADER = `/* ------------------------------------------------------------------------------
+ * <auto-generated>
+ *     This code was generated by a tool.
+ *     Changes to this file may cause incorrect behavior and will be lost if
+ *     the code is regenerated.
+ * </auto-generated>
+ * ------------------------------------------------------------------------------ */`;
+/**
+ * Auto-generated file header comment for TS files.
+ *
+ * @private
+ */
+const TS_FILE_HEADER = `/* ------------------------------------------------------------------------------
+ * <auto-generated>
+ *     This code was generated by a tool.
+ *     Changes to this file may cause incorrect behavior and will be lost if
+ *     the code is regenerated.
+ * </auto-generated>
+ * ------------------------------------------------------------------------------ */`;
+// #endregion
+// #region Methods
+/**
+ * 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 v4.
+ *
+ * @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(TailwindV4PropertyMapping_js_1.SUPPORTED_TOKEN_TYPES);
+    tokens
+        .filter((token) => {
+        const lower = token.name.toLowerCase();
+        return !ignoredNames.some((substr) => lower.includes(substr.toLowerCase()));
+    })
+        .forEach((token) => {
+        // If token has a valid category mapping, skip type validation
+        const rawCategory = token.category;
+        if (rawCategory && rawCategory in TailwindV4PropertyMapping_js_1.CATEGORY_TO_V4_MAPPING) {
+            return;
+        }
+        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 v4 config builder for token "${token.path.join('.')}:${token.name}".`)}`);
+        }
+    });
+}
+/**
+ * Resolves the mapping for a token in Tailwind v4 format.
+ *
+ * @param token The token to resolve mapping for.
+ * @returns An IV4KeyMapping when resolvable, otherwise undefined.
+ * @private
+ */
+function resolveMappingForToken(token) {
+    const rawCategory = token.category;
+    // 1. Category-based mapping (if present)
+    if (rawCategory) {
+        if (rawCategory in TailwindV4PropertyMapping_js_1.CATEGORY_TO_V4_MAPPING) {
+            return TailwindV4PropertyMapping_js_1.CATEGORY_TO_V4_MAPPING[rawCategory];
+        }
+        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 = (token.type ?? token.$type ?? token.original.type ?? token.original.$type);
+    if (type) {
+        const byType = TailwindV4PropertyMapping_js_1.TOKEN_TYPE_TO_V4_MAPPING[type];
+        if (byType) {
+            return byType;
+        }
+    }
+    return undefined;
+}
+/**
+ * Maps v4 CSS variable namespace to Tailwind v4 theme key.
+ * In v4, the theme keys are more directly mapped to CSS variable namespaces.
+ *
+ * @param namespace The CSS variable namespace.
+ * @returns The corresponding theme key for v4 config.
+ * @private
+ */
+function namespaceToThemeKey(namespace) {
+    // Remove leading '--' and convert to camelCase-ish theme key
+    // --color -> colors
+    // --font-family -> fontFamily
+    // --font-size -> fontSize
+    // --spacing -> spacing
+    // --radius -> borderRadius
+    // --shadow -> boxShadow
+    const mapping = {
+        '--color': 'colors',
+        '--font-family': 'fontFamily',
+        '--font-size': 'fontSize',
+        '--font-weight': 'fontWeight',
+        '--letter-spacing': 'letterSpacing',
+        '--line-height': 'lineHeight',
+        '--radius': 'borderRadius',
+        '--shadow': 'boxShadow',
+        '--spacing': 'spacing',
+        '--width': 'width',
+        '--height': 'height',
+        '--z': 'zIndex',
+        '--opacity': 'opacity',
+        '--transition-duration': 'transitionDuration',
+        '--border-width': 'borderWidth'
+    };
+    return mapping[namespace] ?? namespace.slice(2);
+}
+/**
+ * Builds a Tailwind v4 config object from Style-Dictionary tokens.
+ *
+ * In Tailwind v4, the configuration structure is flatter and works
+ * in conjunction with the CSS-first approach. This generates a config
+ * that can be used with the @config directive.
+ *
+ * @param allTokens All transformed tokens from Style-Dictionary.
+ * @param options Build options.
+ * @returns A Tailwind v4 config object.
+ * @public
+ */
+function buildTailwindV4Config(allTokens, options = {}) {
+    const { ignoredTokenNameSubstrings = [], useExtend = false } = options;
+    validateTokenTypes(allTokens, ignoredTokenNameSubstrings);
+    const theme = {};
+    for (const token of allTokens) {
+        const lowerName = token.name.toLowerCase();
+        const tokenPath = token.path.join('.');
+        // Check if any ignored substring appears in the token name OR path
+        const isIgnored = ignoredTokenNameSubstrings.some((substr) => lowerName.includes(substr.toLowerCase()) || tokenPath.toLowerCase().includes(substr.toLowerCase()));
+        if (isIgnored) {
+            continue;
+        }
+        // Skip expanded shadow parts
+        const shadowPartPattern = /\.(offsetX|offsetY|blur|spread|color)\.\d+$/i;
+        if (shadowPartPattern.test(tokenPath)) {
+            continue;
+        }
+        // Skip duration tokens without values
+        if (token.path[0] === 'duration' && !token.value) {
+            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 v4 config (no valid category or type mapping). Skipping.`)}`);
+            continue;
+        }
+        const rawValue = (0, getValue_js_1.getValue)(token);
+        const normalizedValue = normalizeValue(rawValue);
+        const rawPath = token.path.length > 0 ? token.path : [token.name];
+        // Get the theme key from namespace
+        const themeKey = namespaceToThemeKey(mapping.namespace);
+        // Apply pathTransform if defined
+        const transformedName = mapping.pathTransform
+            ? mapping.pathTransform(rawPath)
+            : rawPath.join('-').toLowerCase();
+        // Initialize theme section if needed
+        if (!theme[themeKey]) {
+            theme[themeKey] = {};
+        }
+        // Handle nested paths for colors (e.g., primary.500)
+        if (themeKey === 'colors' && transformedName.includes('-')) {
+            const parts = transformedName.split('-');
+            // Check if it looks like a color scale (name-shade pattern)
+            const lastPart = parts[parts.length - 1];
+            const isShade = (/^(\d+|dark|light|DEFAULT)$/i).test(lastPart);
+            if (isShade && parts.length >= 2) {
+                const colorGroup = parts.slice(0, -1).join('-');
+                const shade = parts[parts.length - 1];
+                if (!theme[themeKey][colorGroup]) {
+                    theme[themeKey][colorGroup] = {};
+                }
+                const group = theme[themeKey][colorGroup];
+                if (typeof group === 'object' && group !== null) {
+                    group[shade] = normalizedValue;
+                }
+            }
+            else {
+                theme[themeKey][transformedName] = normalizedValue;
+            }
+        }
+        else if (themeKey === 'boxShadow' && Array.isArray(normalizedValue)) {
+            // Shadows need to be joined as strings
+            theme[themeKey][transformedName] = normalizedValue.map((v) => String(v)).join(', ');
+        }
+        else {
+            theme[themeKey][transformedName] = normalizedValue;
+        }
+    }
+    // Post-process: normalize single-entry objects
+    for (const [categoryKey, categoryValue] of Object.entries(theme)) {
+        if (typeof categoryValue === 'object' && categoryValue !== null) {
+            const keys = Object.keys(categoryValue);
+            if (keys.length === 1 && keys[0] !== 'DEFAULT') {
+                const value = categoryValue[keys[0]];
+                theme[categoryKey] = { DEFAULT: value };
+            }
+            else if (categoryKey === 'colors') {
+                // For colors, normalize nested single-entry objects
+                for (const [colorKey, colorValue] of Object.entries(categoryValue)) {
+                    if (typeof colorValue === 'object' && colorValue !== null && !Array.isArray(colorValue)) {
+                        const colorObj = colorValue;
+                        const colorKeys = Object.keys(colorObj);
+                        if (colorKeys.length === 1 && colorKeys[0] !== 'DEFAULT') {
+                            categoryValue[colorKey] = { DEFAULT: colorObj[colorKeys[0]] };
+                        }
+                    }
+                }
+            }
+        }
+    }
+    if (useExtend) {
+        return {
+            theme: {
+                extend: theme
+            }
+        };
+    }
+    return { theme };
+}
+/**
+ * Formats a Tailwind v4 config object as a JavaScript module string.
+ *
+ * @param config The config object.
+ * @returns Formatted JavaScript string.
+ * @public
+ */
+function formatTailwindV4ConfigAsJs(config) {
+    const parts = [JS_FILE_HEADER, ''];
+    parts.push('/** @type {import(\'tailwindcss\').Config} */');
+    parts.push(`export default ${JSON.stringify(config, null, 2).replace(/"([^"]+)":/g, '$1:')};`);
+    parts.push('');
+    return parts.join('\n');
+}
+/**
+ * Formats a Tailwind v4 config object as a TypeScript module string.
+ *
+ * @param config The config object.
+ * @returns Formatted TypeScript string.
+ * @public
+ */
+function formatTailwindV4ConfigAsTs(config) {
+    const parts = [TS_FILE_HEADER, ''];
+    parts.push('import type { Config } from \'tailwindcss\';');
+    parts.push('');
+    parts.push(`const config: Config = ${JSON.stringify(config, null, 2).replace(/"([^"]+)":/g, '$1:')};`);
+    parts.push('');
+    parts.push('export default config;');
+    parts.push('');
+    return parts.join('\n');
+}
+/**
+ * Builds and formats a Tailwind v4 JavaScript config file from tokens.
+ *
+ * @param allTokens All transformed tokens from Style-Dictionary.
+ * @param options Build options.
+ * @returns Formatted JavaScript config file content.
+ * @public
+ */
+function buildTailwindV4ConfigJs(allTokens, options = {}) {
+    const config = buildTailwindV4Config(allTokens, options);
+    return formatTailwindV4ConfigAsJs(config);
+}
+/**
+ * Builds and formats a Tailwind v4 TypeScript config file from tokens.
+ *
+ * @param allTokens All transformed tokens from Style-Dictionary.
+ * @param options Build options.
+ * @returns Formatted TypeScript config file content.
+ * @public
+ */
+function buildTailwindV4ConfigTs(allTokens, options = {}) {
+    const config = buildTailwindV4Config(allTokens, options);
+    return formatTailwindV4ConfigAsTs(config);
+}
+// #endregion
+//# sourceMappingURL=buildTailwindV4Config.js.map

package/formats/tailwind/v4/buildTailwindV4Config.js.map

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

package/formats/tailwind/v4/buildTailwindV4Theme.d.ts

@@ -0,0 +1,71 @@
+import type { TransformedToken } from 'style-dictionary/types';
+import { type TailwindV4Namespace } from './TailwindV4PropertyMapping.js';
+/**
+ * Represents a CSS custom property with namespace and value.
+ *
+ * @public
+ */
+export interface ICssVariable {
+    readonly namespace: TailwindV4Namespace;
+    readonly name: string;
+    readonly value: string;
+}
+/**
+ * Options for building the Tailwind v4 theme.
+ *
+ * @public
+ */
+export interface IBuildTailwindV4ThemeOptions {
+    /**
+     * Token name substrings to ignore.
+     */
+    readonly ignoredTokenNameSubstrings?: ReadonlyArray<string>;
+    /**
+     * Whether to include a reference to tailwindcss in the output.
+     *
+     * @default true
+     */
+    readonly includeTailwindImport?: boolean;
+    /**
+     * Whether to wrap variables in @theme directive.
+     *
+     * @default true
+     */
+    readonly wrapInTheme?: boolean;
+    /**
+     * Custom layer name for the @theme directive.
+     *
+     * @default undefined (uses default @theme without layer)
+     */
+    readonly themeLayer?: string;
+}
+/**
+ * Builds an array of CSS custom properties from Style-Dictionary tokens
+ * for use in Tailwind v4's @theme directive.
+ *
+ * @param allTokens All transformed tokens from Style-Dictionary.
+ * @param ignoredTokenNameSubstrings Optional substrings; tokens whose name contains any are ignored.
+ * @returns Array of CSS variable definitions.
+ * @public
+ */
+export declare function buildCssVariables(allTokens: ReadonlyArray<TransformedToken>, ignoredTokenNameSubstrings?: ReadonlyArray<string>): ReadonlyArray<ICssVariable>;
+/**
+ * Builds a complete Tailwind v4 CSS theme file from Style-Dictionary tokens.
+ *
+ * @param allTokens All transformed tokens from Style-Dictionary.
+ * @param options Build options.
+ * @returns Complete CSS file content with @theme directive.
+ * @public
+ */
+export declare function buildTailwindV4Theme(allTokens: ReadonlyArray<TransformedToken>, options?: IBuildTailwindV4ThemeOptions): string;
+/**
+ * Builds a Tailwind v4 CSS theme as CSS custom properties only (no @import).
+ * Useful for creating theme presets that can be imported separately.
+ *
+ * @param allTokens All transformed tokens from Style-Dictionary.
+ * @param options Build options.
+ * @returns CSS file content with theme variables.
+ * @public
+ */
+export declare function buildTailwindV4Preset(allTokens: ReadonlyArray<TransformedToken>, options?: IBuildTailwindV4ThemeOptions): string;
+//# sourceMappingURL=buildTailwindV4Theme.d.ts.map

package/formats/tailwind/v4/buildTailwindV4Theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTailwindV4Theme.d.ts","sourceRoot":"","sources":["../../../../src/formats/tailwind/v4/buildTailwindV4Theme.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAK/D,OAAO,EAIH,KAAK,mBAAmB,EAE3B,MAAM,gCAAgC,CAAC;AAMxC;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAEzC;;OAEG;IACH,QAAQ,CAAC,0BAA0B,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAE5D;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEzC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAChC;AA2GD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC7B,SAAS,EAAE,aAAa,CAAC,gBAAgB,CAAC,EAC1C,0BAA0B,GAAE,aAAa,CAAC,MAAM,CAAM,GACvD,aAAa,CAAC,YAAY,CAAC,CAkD7B;AAuED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAChC,SAAS,EAAE,aAAa,CAAC,gBAAgB,CAAC,EAC1C,OAAO,GAAE,4BAAiC,GAC3C,MAAM,CA+BR;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACjC,SAAS,EAAE,aAAa,CAAC,gBAAgB,CAAC,EAC1C,OAAO,GAAE,4BAAiC,GAC3C,MAAM,CAKR"}

package/formats/tailwind/v4/buildTailwindV4Theme.js

@@ -0,0 +1,247 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCssVariables = buildCssVariables;
+exports.buildTailwindV4Theme = buildTailwindV4Theme;
+exports.buildTailwindV4Preset = buildTailwindV4Preset;
+const utilities_1 = require("@breadstone-infrastructure/utilities");
+const getType_js_1 = require("../../../utilities/getType.js");
+const getValue_js_1 = require("../../../utilities/getValue.js");
+const TailwindV4PropertyMapping_js_1 = require("./TailwindV4PropertyMapping.js");
+// #endregion
+// #region Fields
+/**
+ * Auto-generated file header comment.
+ *
+ * @private
+ */
+const FILE_HEADER = `/* ------------------------------------------------------------------------------
+ * <auto-generated>
+ *     This code was generated by a tool.
+ *     Changes to this file may cause incorrect behavior and will be lost if
+ *     the code is regenerated.
+ * </auto-generated>
+ * ------------------------------------------------------------------------------ */`;
+// #endregion
+// #region Methods
+/**
+ * Normalizes a raw token value into a string suitable for CSS.
+ *
+ * @param value Raw token value.
+ * @returns Normalized string value for CSS.
+ * @private
+ */
+function normalizeValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((v) => String(v)).join(', ');
+    }
+    if (typeof value === 'string' || typeof value === 'number') {
+        return String(value);
+    }
+    return String(value);
+}
+/**
+ * Validates that tokens use supported logical types and logs warnings
+ * for those that cannot be mapped to Tailwind v4.
+ *
+ * @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(TailwindV4PropertyMapping_js_1.SUPPORTED_TOKEN_TYPES);
+    tokens
+        .filter((token) => {
+        const lower = token.name.toLowerCase();
+        return !ignoredNames.some((substr) => lower.includes(substr.toLowerCase()));
+    })
+        .forEach((token) => {
+        // If token has a valid category mapping, skip type validation
+        const rawCategory = token.category;
+        if (rawCategory && rawCategory in TailwindV4PropertyMapping_js_1.CATEGORY_TO_V4_MAPPING) {
+            return;
+        }
+        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 v4 builder for token "${token.path.join('.')}:${token.name}".`)}`);
+        }
+    });
+}
+/**
+ * Resolves the mapping for a token in Tailwind v4 format.
+ *
+ * @param token The token to resolve mapping for.
+ * @returns An IV4KeyMapping when resolvable, otherwise undefined.
+ * @private
+ */
+function resolveMappingForToken(token) {
+    const rawCategory = token.category;
+    // 1. Category-based mapping (if present)
+    if (rawCategory) {
+        if (rawCategory in TailwindV4PropertyMapping_js_1.CATEGORY_TO_V4_MAPPING) {
+            return TailwindV4PropertyMapping_js_1.CATEGORY_TO_V4_MAPPING[rawCategory];
+        }
+        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 = (token.type ?? token.$type ?? token.original.type ?? token.original.$type);
+    if (type) {
+        const byType = TailwindV4PropertyMapping_js_1.TOKEN_TYPE_TO_V4_MAPPING[type];
+        if (byType) {
+            return byType;
+        }
+    }
+    return undefined;
+}
+/**
+ * Builds an array of CSS custom properties from Style-Dictionary tokens
+ * for use in Tailwind v4's @theme directive.
+ *
+ * @param allTokens All transformed tokens from Style-Dictionary.
+ * @param ignoredTokenNameSubstrings Optional substrings; tokens whose name contains any are ignored.
+ * @returns Array of CSS variable definitions.
+ * @public
+ */
+function buildCssVariables(allTokens, ignoredTokenNameSubstrings = []) {
+    validateTokenTypes(allTokens, ignoredTokenNameSubstrings);
+    const variables = [];
+    for (const token of allTokens) {
+        const lowerName = token.name.toLowerCase();
+        const tokenPath = token.path.join('.');
+        // Check if any ignored substring appears in the token name OR path
+        const isIgnored = ignoredTokenNameSubstrings.some((substr) => lowerName.includes(substr.toLowerCase()) || tokenPath.toLowerCase().includes(substr.toLowerCase()));
+        if (isIgnored) {
+            continue;
+        }
+        // Skip expanded shadow parts
+        const shadowPartPattern = /\.(offsetX|offsetY|blur|spread|color)\.\d+$/i;
+        if (shadowPartPattern.test(tokenPath)) {
+            continue;
+        }
+        // Skip duration tokens without values
+        if (token.path[0] === 'duration' && !token.value) {
+            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 v4 (no valid category or type mapping). Skipping.`)}`);
+            continue;
+        }
+        const rawValue = (0, getValue_js_1.getValue)(token);
+        const normalizedValue = normalizeValue(rawValue);
+        const rawPath = token.path.length > 0 ? token.path : [token.name];
+        // Apply pathTransform if defined
+        const transformedName = mapping.pathTransform
+            ? mapping.pathTransform(rawPath)
+            : rawPath.join('-').toLowerCase();
+        variables.push({
+            namespace: mapping.namespace,
+            name: transformedName,
+            value: normalizedValue
+        });
+    }
+    return variables;
+}
+/**
+ * Groups CSS variables by their namespace for organized output.
+ *
+ * @param variables Array of CSS variables.
+ * @returns Map of namespace to variables.
+ * @private
+ */
+function groupVariablesByNamespace(variables) {
+    const grouped = new Map();
+    for (const variable of variables) {
+        const existing = grouped.get(variable.namespace);
+        if (existing) {
+            existing.push(variable);
+        }
+        else {
+            grouped.set(variable.namespace, [variable]);
+        }
+    }
+    return grouped;
+}
+/**
+ * Formats CSS variables into a CSS string for the @theme directive.
+ *
+ * @param variables Array of CSS variables.
+ * @param indent Indentation string.
+ * @returns Formatted CSS string.
+ * @private
+ */
+function formatCssVariables(variables, indent = '  ') {
+    const grouped = groupVariablesByNamespace(variables);
+    const lines = [];
+    // Sort namespaces for consistent output
+    const sortedNamespaces = Array.from(grouped.keys()).sort();
+    for (const namespace of sortedNamespaces) {
+        const vars = grouped.get(namespace);
+        if (!vars?.length) {
+            continue;
+        }
+        lines.push(`${indent}/* ${namespace.slice(2)} */`);
+        // Sort variables within each namespace
+        const sortedVars = [...vars].sort((a, b) => a.name.localeCompare(b.name));
+        for (const variable of sortedVars) {
+            const fullName = `${namespace}-${variable.name}`;
+            lines.push(`${indent}${fullName}: ${variable.value};`);
+        }
+        lines.push('');
+    }
+    // Remove trailing empty line
+    if (lines.length > 0 && lines[lines.length - 1] === '') {
+        lines.pop();
+    }
+    return lines.join('\n');
+}
+/**
+ * Builds a complete Tailwind v4 CSS theme file from Style-Dictionary tokens.
+ *
+ * @param allTokens All transformed tokens from Style-Dictionary.
+ * @param options Build options.
+ * @returns Complete CSS file content with @theme directive.
+ * @public
+ */
+function buildTailwindV4Theme(allTokens, options = {}) {
+    const { ignoredTokenNameSubstrings = [], includeTailwindImport = true, wrapInTheme = true, themeLayer } = options;
+    const variables = buildCssVariables(allTokens, ignoredTokenNameSubstrings);
+    const formattedVariables = formatCssVariables(variables);
+    const parts = [FILE_HEADER, ''];
+    if (includeTailwindImport) {
+        parts.push('@import "tailwindcss";', '');
+    }
+    if (wrapInTheme) {
+        const themeDirective = themeLayer ? `@theme ${themeLayer}` : '@theme';
+        parts.push(`${themeDirective} {`);
+        parts.push(formattedVariables);
+        parts.push('}');
+    }
+    else {
+        parts.push(':root {');
+        parts.push(formattedVariables);
+        parts.push('}');
+    }
+    parts.push('');
+    return parts.join('\n');
+}
+/**
+ * Builds a Tailwind v4 CSS theme as CSS custom properties only (no @import).
+ * Useful for creating theme presets that can be imported separately.
+ *
+ * @param allTokens All transformed tokens from Style-Dictionary.
+ * @param options Build options.
+ * @returns CSS file content with theme variables.
+ * @public
+ */
+function buildTailwindV4Preset(allTokens, options = {}) {
+    return buildTailwindV4Theme(allTokens, {
+        ...options,
+        includeTailwindImport: false
+    });
+}
+// #endregion
+//# sourceMappingURL=buildTailwindV4Theme.js.map