tenara-ui-components 0.2.9 → 0.3.0

package/dist/themes/core/new-typography-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-typography-system.d.ts","sourceRoot":"","sources":["../../../src/themes/core/new-typography-system.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EAChB,MAAM,+BAA+B,CAAC;AAMvC,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAsDxE,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC,CA+FjF,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC,CA2BjF,CAAC;AAMF,eAAO,MAAM,mBAAmB;;;;CAI/B,CAAC"}

package/dist/themes/core/style-variable-schema.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Component Library Style Variable Schema
+ *
+ * This schema defines the structure for style variables used across the design system.
+ * It supports three-tier naming conventions for colors and typography.
+ */
+type Tier = 'tier1' | 'tier2' | 'tier3';
+type BackgroundColor = 'theme' | 'white' | 'grey' | 'idigo' | 'cobalt';
+type ColorCategory = 'color';
+type ColorName = 'coral' | 'purple' | 'blue' | 'neutral' | 'alert' | 'warning' | 'success';
+type ColorShade = '50' | '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900' | '950';
+type ColorProperty = 'background' | 'content' | 'border';
+type ColorIntention = 'default' | 'disabled' | 'utility' | 'focus' | 'dataviz' | 'accent' | 'transparent' | 'title' | 'subtitle' | 'body' | 'label' | 'meta' | 'data' | 'text' | 'icon';
+type ColorVariant = 'default' | 'subtle' | 'strong' | 'error' | 'success' | 'warning' | 'info' | 'knockout' | 'primary' | 'secondary' | 'tertiary' | 'link';
+type ColorState = 'default' | 'hover' | 'active' | 'focus' | 'pressed' | 'disabled';
+type Component = 'link' | 'table' | 'header' | 'form' | 'button' | 'focus_ring';
+type ComponentVariant = 'primary' | 'secondary' | 'tertiary' | 'link' | 'knockout';
+type TypographyCategory = 'typography';
+type TypographyProperty = 'font_family' | 'font_weight' | 'font_style' | 'font_size' | 'line_height' | 'letter_spacing' | 'text_transform';
+type TypographyIntention = 'headline' | 'title' | 'subtitle' | 'body' | 'label' | 'meta' | 'data';
+type TypographyVariant = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'b1' | 'b2' | 'b3';
+type Breakpoint = 'desktop' | 'tablet' | 'mobile';
+/**
+ * Tier 1 Naming: Simple property values
+ * Format: {category}-{color|property}-{shade|value}
+ * Example: color-blue-100, typography-font_size-1
+ */
+type Tier1ColorName = `${ColorCategory}-${ColorName}-${ColorShade}`;
+type Tier1TypographyName = `${TypographyCategory}-${TypographyProperty}-${string}`;
+/**
+ * Tier 2 Naming: Theme-level semantic tokens
+ *
+ * Color Format: tier1-{bg_color}-{category}-{property}-{intention}-{variant}-{state}
+ * Example: tier1-theme-color-content-default-subtle-hover
+ *
+ * Typography Format: tier1-{bg_color}-{category}-{intention}-{variant}-{breakpoint}-{property}
+ * Example: tier1-theme-typography-headline-h1-mobile-font_family
+ */
+type Tier2ColorName = `${Extract<Tier, 'tier1'>}-${BackgroundColor}-${ColorCategory}-${ColorProperty}-${ColorIntention}-${ColorVariant}-${ColorState}`;
+type Tier2TypographyName = `${Extract<Tier, 'tier1'>}-${BackgroundColor}-${TypographyCategory}-${TypographyIntention}-${TypographyVariant}-${Breakpoint}-${TypographyProperty}`;
+/**
+ * Tier 3 Naming: Component-specific tokens
+ *
+ * Color Format: tier3-{bg_color}-{component}-{variant}-{property}-{state}
+ * Example: tier3-theme-button-primary-content-state
+ *
+ * Typography Format: tier2-{bg_color}-{component}-{variant}-{property}
+ * Example: tier2-theme-button-primary-font_family
+ */
+type Tier3ColorName = `tier3-${BackgroundColor}-${Component}-${ComponentVariant}-${ColorProperty}-${ColorState}`;
+type Tier3TypographyName = `tier2-${BackgroundColor}-${Component}-${ComponentVariant}-${TypographyProperty}`;
+type ColorVariable = Tier1ColorName | Tier2ColorName | Tier3ColorName;
+type TypographyVariable = Tier1TypographyName | Tier2TypographyName | Tier3TypographyName;
+type StyleVariable = ColorVariable | TypographyVariable;
+interface ColorValue {
+    value: string;
+    type: 'color';
+}
+interface TypographyValue {
+    value: string | number;
+    type: 'typography';
+    unit?: 'px' | 'rem' | 'em' | '%' | 'none';
+}
+interface StyleToken<T extends StyleVariable = StyleVariable> {
+    name: T;
+    value: T extends ColorVariable ? ColorValue : TypographyValue;
+    description?: string;
+    deprecated?: boolean;
+}
+interface DesignTokens {
+    colors: {
+        tier1: Partial<Record<Tier1ColorName, ColorValue>>;
+        tier2: Partial<Record<Tier2ColorName, ColorValue>>;
+        tier3: Partial<Record<Tier3ColorName, ColorValue>>;
+    };
+    typography: {
+        tier1: Partial<Record<Tier1TypographyName, TypographyValue>>;
+        tier2: Partial<Record<Tier2TypographyName, TypographyValue>>;
+        tier3: Partial<Record<Tier3TypographyName, TypographyValue>>;
+    };
+}
+/**
+ * Parses a style variable name into its constituent parts
+ */
+declare function parseStyleVariable(variable: string): {
+    tier?: Tier;
+    backgroundColo?: BackgroundColor;
+    category: string;
+    property?: string;
+    intention?: string;
+    variant?: string;
+    state?: string;
+    breakpoint?: string;
+    value?: string;
+};
+/**
+ * Type guard to check if a variable is a color variable
+ */
+declare function isColorVariable(variable: StyleVariable): variable is ColorVariable;
+/**
+ * Type guard to check if a variable is a typography variable
+ */
+declare function isTypographyVariable(variable: StyleVariable): variable is TypographyVariable;
+declare const exampleTokens: Partial<DesignTokens>;
+export type { Tier, BackgroundColor, ColorCategory, ColorName, ColorShade, ColorProperty, ColorIntention, ColorVariant, ColorState, Component, ComponentVariant, TypographyCategory, TypographyProperty, TypographyIntention, TypographyVariant, Breakpoint, Tier1ColorName, Tier1TypographyName, Tier2ColorName, Tier2TypographyName, Tier3ColorName, Tier3TypographyName, ColorVariable, TypographyVariable, StyleVariable, ColorValue, TypographyValue, StyleToken, DesignTokens, };
+export { parseStyleVariable, isColorVariable, isTypographyVariable, exampleTokens, };
+//# sourceMappingURL=style-variable-schema.d.ts.map

package/dist/themes/core/style-variable-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-variable-schema.d.ts","sourceRoot":"","sources":["../../../src/themes/core/style-variable-schema.ts"],"names":[],"mappings":"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"}

package/dist/themes/core/types.d.ts

@@ -1,14 +1,16 @@
 /**
  * Core TypeScript interfaces for theme configuration schema
  * Defines the structure and types for all theme properties
+ * Updated for three-tier naming convention
  */
 import { ColorPrimitives, SemanticColorTokens } from './color-system';
 /**
- * Two-level color system integrated into theme
- * Level 1: Primitives (raw colors - the palette)
- * Level 2: Semantic tokens (purpose-based colors)
+ * Three-tier color system integrated into theme
+ * Tier 1: Base Colors (raw colors - the palette) with structured naming
+ * Tier 2: Semantic tokens (purpose-based colors) with tier1-theme prefix
+ * Tier 3: Component tokens (component-specific colors) with tier3-theme prefix
  *
- * Components use semantic tokens directly in their CSS
+ * Components use semantic and component tokens directly in their CSS
  */
 export interface ThemeColors {
     primitives: ColorPrimitives;
@@ -58,50 +60,37 @@ export interface TypographyVariant extends TypographyVariantDefault {
 export interface ThemeTypography {
     fontFamily: string;
     fontFamilyHeading: string;
+    fontFamilyMono?: string;
     fontSizeXs: string;
     fontSizeSm: string;
     fontSizeMd: string;
     fontSizeLg: string;
     fontSizeXl: string;
-    fontWeightNormal: string;
-    fontWeightMedium: string;
+    fontSize2xl?: string;
+    fontWeightLight?: string;
+    fontWeightRegular: string;
+    fontWeightSemibold?: string;
     fontWeightBold: string;
+    fontWeightBlack?: string;
     lineHeightTight: string;
+    lineHeightSnug?: string;
     lineHeightNormal: string;
     lineHeightRelaxed: string;
+    lineHeightLoose?: string;
+    letterSpacingTighter?: string;
+    letterSpacingTight?: string;
+    letterSpacingNormal?: string;
+    letterSpacingWide?: string;
+    letterSpacingWider?: string;
+    letterSpacingWidest?: string;
     variants?: Record<string, TypographyVariant>;
 }
-export interface ButtonVariant {
-    background: string;
-    backgroundHover?: string;
-    backgroundActive?: string;
-    color: string;
-    colorHover?: string;
-    colorActive?: string;
-    border?: string;
-    borderHover?: string;
-    borderActive?: string;
-    focusOutline?: string;
-    shadow?: string;
-}
-export interface ThemeButtons {
-    borderRadius: string;
-    padding: string;
-    fontSize: string;
-    fontWeight: string;
-    lineHeight: string;
-    general: ButtonVariant;
-    cta: ButtonVariant;
-    secondary: ButtonVariant;
-    outline: ButtonVariant;
-    ghost: ButtonVariant;
-    video?: ButtonVariant;
-    subscribe?: ButtonVariant;
-    twitter?: ButtonVariant;
-    linkedIn?: ButtonVariant;
-    facebook?: ButtonVariant;
-    secondaryDarkMode?: ButtonVariant;
-}
+/**
+ * Dynamically extract button variant types from componentTokens.button
+ * Supports both nested variants structure and legacy flat structure
+ * This ensures ButtonVariantType is always in sync with defined variants
+ */
+export type ButtonVariantType = string;
 export interface ThemeComponents {
     card: {
         background: string;
@@ -135,6 +124,53 @@ export interface ColorPalette {
     bg: string;
     text: string;
 }
+/**
+ * Component token definition - flexible structure for any component
+ * Each component can define any properties it needs
+ * The generator will automatically create CSS variables for all properties
+ *
+ * Supports four patterns:
+ * 1. Flat structure with breakpoint-scoped properties via desktop/tablet/mobile keys
+ * 2. Nested variants structure: { borderRadius: "0px", variants: { general: {...}, secondary: {...} } }
+ * 3. Dark mode overrides: { bg: "white", dark: { bg: "black" } } or variants: { general: { bg: "white", dark: { bg: "black" } } }
+ * 4. Size variants: { sizes: { sm: { padding: "8px" }, md: { padding: "12px" }, lg: { padding: "16px" } } }
+ * 5. Animation tokens: { hoverAnimationEnabled: "true", hoverAnimationDuration: "0.3s", hoverAnimationTiming: "ease" }
+ */
+export type ComponentTokenDefinition = {
+    [key: string]: string | undefined | Record<string, any>;
+    desktop?: Record<string, string | undefined>;
+    tablet?: Record<string, string | undefined>;
+    mobile?: Record<string, string | undefined>;
+    sm?: Record<string, string | undefined>;
+    md?: Record<string, string | undefined>;
+    lg?: Record<string, string | undefined>;
+    xl?: Record<string, string | undefined>;
+    dark?: Record<string, string | undefined>;
+    sizes?: Record<string, Record<string, string | undefined>>;
+    variants?: Record<string, Record<string, any>>;
+};
+/**
+ * Component tokens interface - extensible for any component
+ * Add new components by simply adding a new key with ComponentTokenDefinition
+ * No need to modify generator.ts - it automatically handles all components
+ *
+ * Breakpoint-scoped structure:
+ * component: {
+ *   property: 'value',           // Base (applies to all unless overridden)
+ *   tablet: { property: 'value' },  // Tablet overrides
+ *   mobile: { property: 'value' },  // Mobile overrides
+ * }
+ */
+export interface ComponentTokens {
+    button?: ComponentTokenDefinition;
+    card?: ComponentTokenDefinition;
+    header?: ComponentTokenDefinition;
+    cta?: ComponentTokenDefinition;
+    input?: ComponentTokenDefinition;
+    modal?: ComponentTokenDefinition;
+    dropdown?: ComponentTokenDefinition;
+    [componentName: string]: ComponentTokenDefinition | undefined;
+}
 export interface ThemeConfig {
     name: string;
     fontImportUrl?: string | string[];
@@ -145,8 +181,8 @@ export interface ThemeConfig {
     shadows: ThemeShadows;
     breakpoints: ThemeBreakpoints;
     typography: ThemeTypography;
-    buttons: ThemeButtons;
     components: ThemeComponents;
+    componentTokens?: ComponentTokens;
 }
 export type ThemeVariant = 'default' | 'advisors-plus' | 'primax' | string;
 //# sourceMappingURL=types.d.ts.map

package/dist/themes/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/themes/core/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/themes/core/types.ts"],"names":[],"mappings":"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"}

package/dist/themes/index.d.ts

@@ -2,7 +2,7 @@
  * Main theme system exports
  * Central entry point for all theming functionality
  */
-export type { ThemeConfig, ThemeColors, ThemeSpacing, ThemeBorderRadius, ThemeShadows, ThemeBreakpoints, ThemeTypography, ThemeButtons, ThemeComponents, ThemeVariant, ButtonVariant } from './core/types';
+export type { ThemeConfig, ThemeColors, ThemeSpacing, ThemeBorderRadius, ThemeShadows, ThemeBreakpoints, ThemeTypography, ThemeComponents, ThemeVariant, ButtonVariantType, ComponentTokens } from './core/types';
 export type { ColorPrimitives, SemanticColorTokens, } from './core/color-system';
 export { defaultTheme } from './presets/default';
 export { advisorsPlusTheme } from './presets/advisors-plus';

package/dist/themes/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/themes/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,aAAa,EACd,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,eAAe,EACf,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAG1E,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGpF,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/themes/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,eAAe,EAChB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,eAAe,EACf,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAG1E,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGpF,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/themes/presets/advisors-plus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"advisors-plus.d.ts","sourceRoot":"","sources":["../../../src/themes/presets/advisors-plus.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C,eAAO,MAAM,iBAAiB,EAAE,WAgD/B,CAAC"}
+{"version":3,"file":"advisors-plus.d.ts","sourceRoot":"","sources":["../../../src/themes/presets/advisors-plus.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C,eAAO,MAAM,iBAAiB,EAAE,WA4D/B,CAAC"}

package/dist/themes/presets/builders/color-builder.d.ts

@@ -0,0 +1,109 @@
+/**
+ * ColorTokenBuilder - Fluent API for building color token configurations
+ *
+ * This class provides a builder pattern interface for creating color token
+ * configurations with type safety and method chaining support. It supports
+ * all color categories defined in the design system.
+ */
+import type { DynamicColorTokens, ColorTokenParams } from '../../core/dynamic-types';
+import type { ColorPropertySurface, Intention, ColorVariant, State, ColorTokenKey } from '../../core/design-system-types';
+/**
+ * Builder class for creating color token configurations using a fluent API
+ * Supports method chaining and provides type-safe token construction
+ */
+export declare class ColorTokenBuilder {
+    private tokens;
+    /**
+     * Content color tokens (text colors)
+     * Replaces old text-* tokens with tier1-theme-color-content-* pattern
+     */
+    content(variant: ColorVariant, state?: State): {
+        set: (value: string) => ColorTokenBuilder;
+    };
+    /**
+     * Surface color tokens (background colors)
+     * Replaces old bg-* tokens with tier1-theme-color-background-* pattern
+     */
+    surface(variant: ColorVariant, state?: State): {
+        set: (value: string) => ColorTokenBuilder;
+    };
+    /**
+     * Border color tokens
+     * Creates tier1-theme-color-border-* tokens
+     */
+    border(variant: ColorVariant, state?: State): {
+        set: (value: string) => ColorTokenBuilder;
+    };
+    /**
+     * Brand color tokens
+     * Creates tier1-theme-color-background-brand-* tokens for brand colors
+     */
+    brand(variant: ColorVariant, state?: State): {
+        set: (value: string) => ColorTokenBuilder;
+    };
+    /**
+     * State color tokens (error, success, warning, info)
+     * Creates tier1-theme-color-background-utility-* tokens for state colors
+     */
+    state(variant: ColorVariant, state?: State): {
+        set: (value: string) => ColorTokenBuilder;
+    };
+    /**
+     * Interactive color tokens (for interactive elements)
+     * Creates tier1-theme-color-background-default-* tokens for interactive elements
+     */
+    interactive(variant: ColorVariant, state?: State): {
+        set: (value: string) => ColorTokenBuilder;
+    };
+    /**
+     * Custom color token with full parameter control
+     * Allows building any color token with complete flexibility
+     */
+    custom(params: ColorTokenParams): {
+        set: (value: string) => ColorTokenBuilder;
+    };
+    /**
+     * Set multiple tokens at once from an object
+     * Useful for bulk token assignment
+     */
+    setTokens(tokens: Partial<DynamicColorTokens>): this;
+    /**
+     * Clear all tokens from the builder
+     * Useful for resetting the builder state
+     */
+    clear(): this;
+    /**
+     * Get the current token count
+     * Useful for validation and debugging
+     */
+    getTokenCount(): number;
+    /**
+     * Check if a specific token exists
+     * Useful for conditional token building
+     */
+    hasToken(key: ColorTokenKey): boolean;
+    /**
+     * Get a specific token value
+     * Useful for referencing existing tokens
+     */
+    getToken(key: ColorTokenKey): string | undefined;
+    /**
+     * Build and return the completed color token configuration
+     * Returns a partial DynamicColorTokens object with all defined tokens
+     */
+    build(): Partial<DynamicColorTokens>;
+}
+/**
+ * Factory function for creating a new ColorTokenBuilder instance
+ * Provides a convenient way to start building color tokens
+ */
+export declare function createColorTokenBuilder(): ColorTokenBuilder;
+/**
+ * Helper function for creating color tokens with validation
+ * Validates parameters before creating the token
+ */
+export declare function createColorToken(surface: ColorPropertySurface, intention: Intention, variant: ColorVariant, state: State | undefined, value: string): {
+    key: ColorTokenKey;
+    value: string;
+};
+//# sourceMappingURL=color-builder.d.ts.map

package/dist/themes/presets/builders/color-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-builder.d.ts","sourceRoot":"","sources":["../../../../src/themes/presets/builders/color-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAEV,oBAAoB,EACpB,SAAS,EACT,YAAY,EACZ,KAAK,EACL,aAAa,EACd,MAAM,gCAAgC,CAAC;AAGxC;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAmC;IAEjD;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,GAAE,KAAiB,GAAG;QAAE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,iBAAiB,CAAA;KAAE;IAUvG;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,GAAE,KAAiB,GAAG;QAAE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,iBAAiB,CAAA;KAAE;IAUvG;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,GAAE,KAAiB,GAAG;QAAE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,iBAAiB,CAAA;KAAE;IAUtG;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,GAAE,KAAiB,GAAG;QAAE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,iBAAiB,CAAA;KAAE;IAUrG;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,GAAE,KAAiB,GAAG;QAAE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,iBAAiB,CAAA;KAAE;IAUrG;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,GAAE,KAAiB,GAAG;QAAE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,iBAAiB,CAAA;KAAE;IAU3G;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG;QAAE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,iBAAiB,CAAA;KAAE;IAgB/E;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC;IAK7C;;;OAGG;IACH,KAAK;IAKL;;;OAGG;IACH,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;IAIrC;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS;IAIhD;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAGrC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,KAAK,YAAY,EACxB,KAAK,EAAE,MAAM,GACZ;IAAE,GAAG,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAGvC"}

package/dist/themes/presets/builders/component-builder.d.ts

@@ -0,0 +1,154 @@
+/**
+ * ComponentTokenBuilder - Fluent API for building component-specific token configurations
+ *
+ * This class provides a builder pattern interface for creating component-specific token
+ * configurations with type safety and method chaining support. It supports flexible
+ * component names and property combinations with validation.
+ */
+import type { DynamicComponentTokens, ComponentTokenParams } from '../../core/dynamic-types';
+import type { ComponentVariant, State } from '../../core/design-system-types';
+/**
+ * Interface for component token definition
+ */
+export interface ComponentTokenDefinition {
+    component: string;
+    variant?: string;
+    property: string;
+    state?: State;
+    value: string | number;
+}
+/**
+ * Interface for component style definition
+ * Allows defining multiple properties for a component variant
+ */
+export interface ComponentStyleDefinition {
+    [property: string]: string | number | {
+        [state: string]: string | number;
+    };
+}
+/**
+ * Builder class for creating component token configurations using a fluent API
+ * Supports method chaining, flexible component definitions, and validation
+ */
+export declare class ComponentTokenBuilder {
+    private tokens;
+    /**
+     * Define tokens for a specific component
+     * Creates a scoped builder for the component
+     */
+    component(componentName: string): {
+        /**
+         * Set a property value for the component
+         */
+        property: (propertyName: string, value: string | number) => /*elided*/ any;
+        /**
+         * Set multiple properties for the component
+         */
+        properties: (properties: ComponentStyleDefinition) => /*elided*/ any;
+        /**
+         * Set a property with state variations
+         */
+        statefulProperty: (propertyName: string, states: {
+            [state: string]: string | number;
+        }) => /*elided*/ any;
+    };
+    /**
+     * Define tokens for a button component with variant support
+     * Provides specialized methods for button token creation
+     */
+    button(variant: ComponentVariant): {
+        /**
+         * Set background color with state support
+         */
+        background: (states: {
+            [state: string]: string;
+        } | string) => /*elided*/ any;
+        /**
+         * Set text color with state support
+         */
+        color: (states: {
+            [state: string]: string;
+        } | string) => /*elided*/ any;
+        /**
+         * Set border with state support
+         */
+        border: (states: {
+            [state: string]: string;
+        } | string) => /*elided*/ any;
+        /**
+         * Set multiple button properties at once
+         */
+        properties: (properties: ComponentStyleDefinition) => /*elided*/ any;
+    };
+    /**
+     * Define tokens using the structured component token format
+     * Uses the design system component token builder
+     */
+    structuredToken(params: ComponentTokenParams, value: string | number): this;
+    /**
+     * Set multiple component tokens from definitions
+     * Useful for bulk token assignment
+     */
+    setTokenDefinitions(definitions: ComponentTokenDefinition[]): this;
+    /**
+     * Set multiple tokens at once from an object
+     * Useful for bulk token assignment
+     */
+    setTokens(tokens: DynamicComponentTokens): this;
+    /**
+     * Clear all tokens from the builder
+     * Useful for resetting the builder state
+     */
+    clear(): this;
+    /**
+     * Remove a specific component
+     * Useful for selective token removal
+     */
+    removeComponent(componentName: string): this;
+    /**
+     * Get the current component count
+     * Useful for validation and debugging
+     */
+    getComponentCount(): number;
+    /**
+     * Get the total token count across all components
+     * Useful for validation and debugging
+     */
+    getTotalTokenCount(): number;
+    /**
+     * Check if a specific component exists
+     * Useful for conditional token building
+     */
+    hasComponent(componentName: string): boolean;
+    /**
+     * Get tokens for a specific component
+     * Useful for component-specific validation
+     */
+    getComponentTokens(componentName: string): {
+        [property: string]: string | number;
+    } | undefined;
+    /**
+     * Validate component token structure
+     * Ensures all tokens follow expected patterns
+     */
+    validate(): {
+        isValid: boolean;
+        errors: string[];
+    };
+    /**
+     * Build and return the completed component token configuration
+     * Returns a DynamicComponentTokens object with all defined tokens
+     */
+    build(): DynamicComponentTokens;
+}
+/**
+ * Factory function for creating a new ComponentTokenBuilder instance
+ * Provides a convenient way to start building component tokens
+ */
+export declare function createComponentTokenBuilder(): ComponentTokenBuilder;
+/**
+ * Helper function for creating component tokens with validation
+ * Validates parameters before creating the token
+ */
+export declare function createComponentToken(component: string, property: string, value: string | number, variant?: string, state?: State): ComponentTokenDefinition;
+//# sourceMappingURL=component-builder.d.ts.map

package/dist/themes/presets/builders/component-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-builder.d.ts","sourceRoot":"","sources":["../../../../src/themes/presets/builders/component-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAGV,gBAAgB,EAEhB,KAAK,EACN,MAAM,gCAAgC,CAAC;AAGxC;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG;QACpC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;KAClC,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAA8B;IAE5C;;;OAGG;IACH,SAAS,CAAC,aAAa,EAAE,MAAM;QAG3B;;WAEG;iCACsB,MAAM,SAAS,MAAM,GAAG,MAAM;QAQvD;;WAEG;iCACsB,wBAAwB;QAqBjD;;WAEG;yCAC8B,MAAM,UAAU;YAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;SAAE;;IAiBzF;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,gBAAgB;QAK5B;;WAEG;6BACkB;YAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,GAAG,MAAM;QAiBzD;;WAEG;wBACa;YAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,GAAG,MAAM;QAiBpD;;WAEG;yBACc;YAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,GAAG,MAAM;QAiBrD;;WAEG;iCACsB,wBAAwB;;IAuBrD;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAsBpE;;;OAGG;IACH,mBAAmB,CAAC,WAAW,EAAE,wBAAwB,EAAE;IAiB3D;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,sBAAsB;IAUxC;;;OAGG;IACH,KAAK;IAKL;;;OAGG;IACH,eAAe,CAAC,aAAa,EAAE,MAAM;IAKrC;;;OAGG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;;OAGG;IACH,kBAAkB,IAAI,MAAM;IAO5B;;;OAGG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;IAI5C;;;OAGG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,SAAS;IAI9F;;;OAGG;IACH,QAAQ,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAsClD;;;OAGG;IACH,KAAK,IAAI,sBAAsB;CAShC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAEnE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,KAAK,GACZ,wBAAwB,CAQ1B"}

package/dist/themes/presets/builders/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Theme Preset Builders - Fluent API for building theme configurations
+ *
+ * This module exports all theme preset builder classes and their factory functions.
+ * These builders provide a fluent API for creating theme configurations with
+ * type safety and method chaining support.
+ */
+export { ColorTokenBuilder, createColorTokenBuilder, createColorToken } from './color-builder';
+export { TypographyTokenBuilder, createTypographyTokenBuilder, createTypographyToken, createResponsiveTypographyTokens, type ResponsiveTypographyValue } from './typography-builder';
+export { ComponentTokenBuilder, createComponentTokenBuilder, createComponentToken, type ComponentTokenDefinition, type ComponentStyleDefinition } from './component-builder';
+export type { DynamicColorTokens, DynamicTypographyTokens, DynamicComponentTokens, ColorTokenParams, TypographyTokenParams, ComponentTokenParams } from '../../core/dynamic-types';
+export type { ColorTokenKey, TypographyTokenKey, Tier, ColorPropertySurface, Intention, ColorVariant, State, TypographyIntention, TypographyDesignVariant, Breakpoint, TypographyProperty, Component, ComponentVariant, ComponentProperty } from '../../core/design-system-types';
+//# sourceMappingURL=index.d.ts.map

package/dist/themes/presets/builders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/themes/presets/builders/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,qBAAqB,EACrB,gCAAgC,EAChC,KAAK,yBAAyB,EAC/B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,oBAAoB,EACpB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,IAAI,EACJ,oBAAoB,EACpB,SAAS,EACT,YAAY,EACZ,KAAK,EACL,mBAAmB,EACnB,uBAAuB,EACvB,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,gCAAgC,CAAC"}