@dsai-io/tools 0.0.1 → 1.0.7

package/dist/{types-Idj08nad.d.cts → types-DabOzcsj.d.cts}

@@ -130,6 +130,10 @@ interface TokensConfig {
      * @example '_variables.scss' or 'path/to/custom-base.scss'
      */
     scssImportHeader?: string;
+    /**
+     * SCSS/CSS output style options
+     */
+    scss?: ScssOutputConfig;
     /** Theme mode settings */
     themes?: ThemesConfig;
     /** Custom Style Dictionary transforms */
@@ -194,11 +198,33 @@ interface TokensConfig {
      * Controls which steps run and their paths
      */
     pipeline?: TokensBuildPipeline;
+    /**
+     * Postprocess configuration for CSS file transformations
+     * Applied after SASS compilation
+     */
+    postprocess?: PostprocessConfig;
+}
+/**
+ * Postprocess configuration for CSS file transformations
+ */
+interface PostprocessConfig {
+    /** Whether postprocessing is enabled */
+    enabled?: boolean;
+    /** Directory containing CSS files to process */
+    cssDir?: string;
+    /** File names to process */
+    files?: string[];
+    /** Replacement rules to apply */
+    replacements?: Array<{
+        description?: string;
+        from: string | RegExp;
+        to: string;
+    }>;
 }
 /**
  * Build pipeline step names
  */
-type BuildPipelineStep = 'validate' | 'transform' | 'style-dictionary' | 'sync' | 'sass-theme' | 'sass-theme-minified' | 'postprocess' | 'sass-utilities' | 'sass-utilities-minified' | 'bundle';
+type BuildPipelineStep = 'validate' | 'snapshot' | 'preprocess' | 'transform' | 'style-dictionary' | 'multi-theme' | 'sync' | 'sass-theme' | 'sass-theme-minified' | 'postprocess' | 'sass-utilities' | 'sass-utilities-minified' | 'bundle';
 /**
  * Build pipeline paths configuration
  */
@@ -263,18 +289,181 @@ interface BuildSummary {
         themes: string[];
     };
 }
+/**
+ * CSS/SCSS output style options
+ * Controls whether to generate expanded, compressed, or both formats
+ */
+interface ScssOutputConfig {
+    /**
+     * Output format styles to generate
+     * - 'expanded': Human-readable, formatted CSS
+     * - 'compressed': Minified CSS for production
+     * @default ['expanded']
+     */
+    outputStyles?: ('expanded' | 'compressed')[];
+    /**
+     * Generate source maps for debugging
+     * @default false
+     */
+    generateSourceMaps?: boolean;
+    /**
+     * Suffix for minified/compressed output files
+     * @default '.min'
+     * @example '.min' produces 'theme.min.css' alongside 'theme.css'
+     */
+    minifiedSuffix?: string;
+    /**
+     * Entry SCSS file for theme compilation
+     * Relative to config file location
+     * @example 'src/scss/dsai-theme-bs.scss'
+     */
+    themeEntry?: string;
+    /**
+     * Entry SCSS file for utilities compilation
+     * Relative to config file location
+     * @example 'src/scss/dsai-utilities.scss'
+     */
+    utilitiesEntry?: string;
+    /**
+     * Output directory for compiled CSS files
+     * Relative to config file location
+     * @default 'src/generated'
+     */
+    cssOutputDir?: string;
+    /**
+     * Additional Sass load paths for @use and @import resolution
+     * @default ['node_modules']
+     */
+    loadPaths?: string[];
+    /**
+     * Target CSS framework for variable naming conventions
+     * Controls how token names are mapped to framework-specific names
+     * @default 'bootstrap'
+     */
+    framework?: FrameworkTarget;
+    /**
+     * Custom name mappings for token → framework variable names
+     * Merged with framework defaults (custom mappings take precedence)
+     * @example { 'typography-text-base': 'font-size-base', 'typography-heading-h1': 'h1-font-size' }
+     */
+    nameMapping?: Record<string, string>;
+    /**
+     * Output path for generated SCSS variables file
+     * Relative to config file location
+     * @default 'src/scss/_variables.scss'
+     */
+    variablesOutput?: string;
+}
+/**
+ * Supported CSS framework targets
+ * Each framework has its own naming conventions for variables
+ */
+type FrameworkTarget = 'bootstrap' | 'shadcn' | 'tailwind' | 'mui' | 'custom';
+/**
+ * Framework mapping configuration
+ * Defines how Figma token names map to framework-specific variable names
+ */
+interface FrameworkMappingConfig {
+    /**
+     * Framework identifier
+     */
+    framework: FrameworkTarget;
+    /**
+     * Token name → framework variable name mappings
+     * Keys are Figma/DTCG token names, values are framework variable names
+     */
+    mappings: Record<string, string>;
+    /**
+     * Pattern-based mappings using regex
+     * Applied after explicit mappings
+     * @example [{ pattern: /^typography-heading-(.+)$/, replacement: 'h$1-font-size' }]
+     */
+    patterns?: FrameworkMappingPattern[];
+    /**
+     * Variable prefix for this framework
+     * @example '$' for SCSS, '--' for CSS custom properties
+     */
+    variablePrefix?: string;
+    /**
+     * File header comment
+     */
+    header?: string;
+}
+/**
+ * Pattern-based name mapping rule
+ */
+interface FrameworkMappingPattern {
+    /**
+     * Regex pattern to match token names
+     */
+    pattern: RegExp | string;
+    /**
+     * Replacement string (supports $1, $2, etc. for capture groups)
+     */
+    replacement: string;
+    /**
+     * Optional description for documentation
+     */
+    description?: string;
+}
+/**
+ * Individual theme definition
+ * Specifies how a theme is discovered and built
+ */
+interface ThemeDefinition {
+    /**
+     * Whether this is the default theme (uses :root selector)
+     * Only one theme can be default
+     * @default false
+     */
+    isDefault?: boolean;
+    /**
+     * File suffix pattern for this theme
+     * null means files without any theme suffix (default theme)
+     * e.g., '-dark' matches files like 'foundation-dark.json'
+     * @default null for default theme, '-{themeName}' for others
+     */
+    suffix?: string | null;
+    /**
+     * CSS selector for this theme
+     * @example ':root' for default, '[data-dsai-theme="dark"]' for dark
+     */
+    selector: string;
+    /**
+     * Optional media query for automatic switching
+     * @example '(prefers-color-scheme: dark)'
+     */
+    mediaQuery?: string;
+    /**
+     * Optional data attribute (derived from selector if not specified)
+     */
+    dataAttribute?: string;
+    /**
+     * Custom output file names per format
+     * If not specified, uses default naming pattern with theme suffix
+     */
+    outputFiles?: Partial<Record<OutputFormat, string>>;
+}
 /**
  * Theme configuration
  */
 interface ThemesConfig {
+    /**
+     * Enable/disable theme processing
+     * @default true
+     */
+    enabled?: boolean;
     /**
      * Auto-detect available modes from Figma export
+     * When true, scans for files with theme suffixes
+     * When false, only builds themes explicitly defined in definitions
      * @default true
      */
     autoDetect?: boolean;
     /**
      * Default theme mode (uses :root selector)
-     * @default 'Light'
+     * @default 'light'
+     * @deprecated Use definitions with isDefault: true instead
      */
     default?: string;
     /**
@@ -286,6 +475,12 @@ interface ThemesConfig {
      * CSS selector patterns for themes
      */
     selectorPattern?: ThemeSelectorPattern;
+    /**
+     * Explicit theme definitions
+     * Key is theme name, value is theme configuration
+     * When specified, provides explicit control over theme builds
+     */
+    definitions?: Record<string, ThemeDefinition>;
 }
 /**
  * Theme selector pattern configuration
@@ -443,14 +638,39 @@ interface IconsConfig {
      */
     prefix?: string;
 }
+/**
+ * Resolved theme definition with all required fields
+ */
+interface ResolvedThemeDefinition {
+    /** Whether this is the default theme */
+    isDefault: boolean;
+    /** File suffix pattern (null for default theme) */
+    suffix: string | null;
+    /** CSS selector */
+    selector: string;
+    /** Optional media query */
+    mediaQuery?: string;
+    /** Optional data attribute */
+    dataAttribute?: string;
+    /** Output file names per format */
+    outputFiles: Record<OutputFormat, string>;
+}
 /**
  * Resolved themes config with all defaults applied
  */
 interface ResolvedThemesConfig {
+    /** Whether themes are enabled */
+    enabled: boolean;
+    /** Auto-detect themes from files */
     autoDetect: boolean;
+    /** Default theme name (for backward compat) */
     default: string;
+    /** Modes to ignore */
     ignoreModes: string[];
+    /** Selector patterns */
     selectorPattern: Required<ThemeSelectorPattern>;
+    /** Resolved theme definitions */
+    definitions: Record<string, ResolvedThemeDefinition>;
 }
 /**
  * Resolved tokens config with all defaults applied
@@ -486,6 +706,19 @@ interface ResolvedTokensConfig {
     watch: boolean;
     watchDirectories: string[];
     pipeline?: TokensBuildPipeline;
+    scss?: {
+        cssOutputDir?: string;
+    };
+    postprocess?: {
+        enabled?: boolean;
+        cssDir?: string;
+        files?: string[];
+        replacements?: Array<{
+            description?: string;
+            from: string | RegExp;
+            to: string;
+        }>;
+    };
 }
 /**
  * Resolved icons config with all defaults applied
@@ -543,4 +776,4 @@ interface LoadConfigResult {
     warnings: string[];
 }
 
-export type { BuildSummary as B, CustomTransform as C, DsaiConfig as D, FormatArgs as F, GlobalConfig as G, IconsConfig as I, LoadConfigOptions as L, OutputFormat as O, Platform as P, ResolvedConfig as R, TokensConfig as T, ThemesConfig as a, ThemeSelectorPattern as b, ResolvedGlobalConfig as c, ResolvedTokensConfig as d, ResolvedIconsConfig as e, ResolvedThemesConfig as f, CustomFormat as g, CustomPreprocessor as h, CustomFilter as i, TokenData as j, TransformOptions as k, Dictionary as l, FileConfig as m, LoadConfigResult as n, LogLevel as o, IconFramework as p };
+export type { BuildSummary as B, CustomTransform as C, DsaiConfig as D, FrameworkTarget as F, GlobalConfig as G, IconsConfig as I, LoadConfigOptions as L, OutputFormat as O, Platform as P, ResolvedConfig as R, ScssOutputConfig as S, TokensConfig as T, ThemesConfig as a, ThemeDefinition as b, ThemeSelectorPattern as c, FrameworkMappingConfig as d, FrameworkMappingPattern as e, ResolvedGlobalConfig as f, ResolvedTokensConfig as g, ResolvedIconsConfig as h, ResolvedThemesConfig as i, ResolvedThemeDefinition as j, CustomFormat as k, CustomPreprocessor as l, CustomFilter as m, TokenData as n, TransformOptions as o, FormatArgs as p, Dictionary as q, FileConfig as r, LoadConfigResult as s, LogLevel as t, IconFramework as u };

package/dist/{types-Idj08nad.d.ts → types-DabOzcsj.d.ts}

@@ -130,6 +130,10 @@ interface TokensConfig {
      * @example '_variables.scss' or 'path/to/custom-base.scss'
      */
     scssImportHeader?: string;
+    /**
+     * SCSS/CSS output style options
+     */
+    scss?: ScssOutputConfig;
     /** Theme mode settings */
     themes?: ThemesConfig;
     /** Custom Style Dictionary transforms */
@@ -194,11 +198,33 @@ interface TokensConfig {
      * Controls which steps run and their paths
      */
     pipeline?: TokensBuildPipeline;
+    /**
+     * Postprocess configuration for CSS file transformations
+     * Applied after SASS compilation
+     */
+    postprocess?: PostprocessConfig;
+}
+/**
+ * Postprocess configuration for CSS file transformations
+ */
+interface PostprocessConfig {
+    /** Whether postprocessing is enabled */
+    enabled?: boolean;
+    /** Directory containing CSS files to process */
+    cssDir?: string;
+    /** File names to process */
+    files?: string[];
+    /** Replacement rules to apply */
+    replacements?: Array<{
+        description?: string;
+        from: string | RegExp;
+        to: string;
+    }>;
 }
 /**
  * Build pipeline step names
  */
-type BuildPipelineStep = 'validate' | 'transform' | 'style-dictionary' | 'sync' | 'sass-theme' | 'sass-theme-minified' | 'postprocess' | 'sass-utilities' | 'sass-utilities-minified' | 'bundle';
+type BuildPipelineStep = 'validate' | 'snapshot' | 'preprocess' | 'transform' | 'style-dictionary' | 'multi-theme' | 'sync' | 'sass-theme' | 'sass-theme-minified' | 'postprocess' | 'sass-utilities' | 'sass-utilities-minified' | 'bundle';
 /**
  * Build pipeline paths configuration
  */
@@ -263,18 +289,181 @@ interface BuildSummary {
         themes: string[];
     };
 }
+/**
+ * CSS/SCSS output style options
+ * Controls whether to generate expanded, compressed, or both formats
+ */
+interface ScssOutputConfig {
+    /**
+     * Output format styles to generate
+     * - 'expanded': Human-readable, formatted CSS
+     * - 'compressed': Minified CSS for production
+     * @default ['expanded']
+     */
+    outputStyles?: ('expanded' | 'compressed')[];
+    /**
+     * Generate source maps for debugging
+     * @default false
+     */
+    generateSourceMaps?: boolean;
+    /**
+     * Suffix for minified/compressed output files
+     * @default '.min'
+     * @example '.min' produces 'theme.min.css' alongside 'theme.css'
+     */
+    minifiedSuffix?: string;
+    /**
+     * Entry SCSS file for theme compilation
+     * Relative to config file location
+     * @example 'src/scss/dsai-theme-bs.scss'
+     */
+    themeEntry?: string;
+    /**
+     * Entry SCSS file for utilities compilation
+     * Relative to config file location
+     * @example 'src/scss/dsai-utilities.scss'
+     */
+    utilitiesEntry?: string;
+    /**
+     * Output directory for compiled CSS files
+     * Relative to config file location
+     * @default 'src/generated'
+     */
+    cssOutputDir?: string;
+    /**
+     * Additional Sass load paths for @use and @import resolution
+     * @default ['node_modules']
+     */
+    loadPaths?: string[];
+    /**
+     * Target CSS framework for variable naming conventions
+     * Controls how token names are mapped to framework-specific names
+     * @default 'bootstrap'
+     */
+    framework?: FrameworkTarget;
+    /**
+     * Custom name mappings for token → framework variable names
+     * Merged with framework defaults (custom mappings take precedence)
+     * @example { 'typography-text-base': 'font-size-base', 'typography-heading-h1': 'h1-font-size' }
+     */
+    nameMapping?: Record<string, string>;
+    /**
+     * Output path for generated SCSS variables file
+     * Relative to config file location
+     * @default 'src/scss/_variables.scss'
+     */
+    variablesOutput?: string;
+}
+/**
+ * Supported CSS framework targets
+ * Each framework has its own naming conventions for variables
+ */
+type FrameworkTarget = 'bootstrap' | 'shadcn' | 'tailwind' | 'mui' | 'custom';
+/**
+ * Framework mapping configuration
+ * Defines how Figma token names map to framework-specific variable names
+ */
+interface FrameworkMappingConfig {
+    /**
+     * Framework identifier
+     */
+    framework: FrameworkTarget;
+    /**
+     * Token name → framework variable name mappings
+     * Keys are Figma/DTCG token names, values are framework variable names
+     */
+    mappings: Record<string, string>;
+    /**
+     * Pattern-based mappings using regex
+     * Applied after explicit mappings
+     * @example [{ pattern: /^typography-heading-(.+)$/, replacement: 'h$1-font-size' }]
+     */
+    patterns?: FrameworkMappingPattern[];
+    /**
+     * Variable prefix for this framework
+     * @example '$' for SCSS, '--' for CSS custom properties
+     */
+    variablePrefix?: string;
+    /**
+     * File header comment
+     */
+    header?: string;
+}
+/**
+ * Pattern-based name mapping rule
+ */
+interface FrameworkMappingPattern {
+    /**
+     * Regex pattern to match token names
+     */
+    pattern: RegExp | string;
+    /**
+     * Replacement string (supports $1, $2, etc. for capture groups)
+     */
+    replacement: string;
+    /**
+     * Optional description for documentation
+     */
+    description?: string;
+}
+/**
+ * Individual theme definition
+ * Specifies how a theme is discovered and built
+ */
+interface ThemeDefinition {
+    /**
+     * Whether this is the default theme (uses :root selector)
+     * Only one theme can be default
+     * @default false
+     */
+    isDefault?: boolean;
+    /**
+     * File suffix pattern for this theme
+     * null means files without any theme suffix (default theme)
+     * e.g., '-dark' matches files like 'foundation-dark.json'
+     * @default null for default theme, '-{themeName}' for others
+     */
+    suffix?: string | null;
+    /**
+     * CSS selector for this theme
+     * @example ':root' for default, '[data-dsai-theme="dark"]' for dark
+     */
+    selector: string;
+    /**
+     * Optional media query for automatic switching
+     * @example '(prefers-color-scheme: dark)'
+     */
+    mediaQuery?: string;
+    /**
+     * Optional data attribute (derived from selector if not specified)
+     */
+    dataAttribute?: string;
+    /**
+     * Custom output file names per format
+     * If not specified, uses default naming pattern with theme suffix
+     */
+    outputFiles?: Partial<Record<OutputFormat, string>>;
+}
 /**
  * Theme configuration
  */
 interface ThemesConfig {
+    /**
+     * Enable/disable theme processing
+     * @default true
+     */
+    enabled?: boolean;
     /**
      * Auto-detect available modes from Figma export
+     * When true, scans for files with theme suffixes
+     * When false, only builds themes explicitly defined in definitions
      * @default true
      */
     autoDetect?: boolean;
     /**
      * Default theme mode (uses :root selector)
-     * @default 'Light'
+     * @default 'light'
+     * @deprecated Use definitions with isDefault: true instead
      */
     default?: string;
     /**
@@ -286,6 +475,12 @@ interface ThemesConfig {
      * CSS selector patterns for themes
      */
     selectorPattern?: ThemeSelectorPattern;
+    /**
+     * Explicit theme definitions
+     * Key is theme name, value is theme configuration
+     * When specified, provides explicit control over theme builds
+     */
+    definitions?: Record<string, ThemeDefinition>;
 }
 /**
  * Theme selector pattern configuration
@@ -443,14 +638,39 @@ interface IconsConfig {
      */
     prefix?: string;
 }
+/**
+ * Resolved theme definition with all required fields
+ */
+interface ResolvedThemeDefinition {
+    /** Whether this is the default theme */
+    isDefault: boolean;
+    /** File suffix pattern (null for default theme) */
+    suffix: string | null;
+    /** CSS selector */
+    selector: string;
+    /** Optional media query */
+    mediaQuery?: string;
+    /** Optional data attribute */
+    dataAttribute?: string;
+    /** Output file names per format */
+    outputFiles: Record<OutputFormat, string>;
+}
 /**
  * Resolved themes config with all defaults applied
  */
 interface ResolvedThemesConfig {
+    /** Whether themes are enabled */
+    enabled: boolean;
+    /** Auto-detect themes from files */
     autoDetect: boolean;
+    /** Default theme name (for backward compat) */
     default: string;
+    /** Modes to ignore */
     ignoreModes: string[];
+    /** Selector patterns */
     selectorPattern: Required<ThemeSelectorPattern>;
+    /** Resolved theme definitions */
+    definitions: Record<string, ResolvedThemeDefinition>;
 }
 /**
  * Resolved tokens config with all defaults applied
@@ -486,6 +706,19 @@ interface ResolvedTokensConfig {
     watch: boolean;
     watchDirectories: string[];
     pipeline?: TokensBuildPipeline;
+    scss?: {
+        cssOutputDir?: string;
+    };
+    postprocess?: {
+        enabled?: boolean;
+        cssDir?: string;
+        files?: string[];
+        replacements?: Array<{
+            description?: string;
+            from: string | RegExp;
+            to: string;
+        }>;
+    };
 }
 /**
  * Resolved icons config with all defaults applied
@@ -543,4 +776,4 @@ interface LoadConfigResult {
     warnings: string[];
 }
 
-export type { BuildSummary as B, CustomTransform as C, DsaiConfig as D, FormatArgs as F, GlobalConfig as G, IconsConfig as I, LoadConfigOptions as L, OutputFormat as O, Platform as P, ResolvedConfig as R, TokensConfig as T, ThemesConfig as a, ThemeSelectorPattern as b, ResolvedGlobalConfig as c, ResolvedTokensConfig as d, ResolvedIconsConfig as e, ResolvedThemesConfig as f, CustomFormat as g, CustomPreprocessor as h, CustomFilter as i, TokenData as j, TransformOptions as k, Dictionary as l, FileConfig as m, LoadConfigResult as n, LogLevel as o, IconFramework as p };
+export type { BuildSummary as B, CustomTransform as C, DsaiConfig as D, FrameworkTarget as F, GlobalConfig as G, IconsConfig as I, LoadConfigOptions as L, OutputFormat as O, Platform as P, ResolvedConfig as R, ScssOutputConfig as S, TokensConfig as T, ThemesConfig as a, ThemeDefinition as b, ThemeSelectorPattern as c, FrameworkMappingConfig as d, FrameworkMappingPattern as e, ResolvedGlobalConfig as f, ResolvedTokensConfig as g, ResolvedIconsConfig as h, ResolvedThemesConfig as i, ResolvedThemeDefinition as j, CustomFormat as k, CustomPreprocessor as l, CustomFilter as m, TokenData as n, TransformOptions as o, FormatArgs as p, Dictionary as q, FileConfig as r, LoadConfigResult as s, LogLevel as t, IconFramework as u };