@shohojdhara/atomix 0.5.1 → 0.5.4

package/dist/config.d.ts

@@ -0,0 +1,699 @@
+/**
+ * Theme Manager Type Definitions
+ *
+ * TypeScript types and interfaces for the Atomix Design System theme management system.
+ */
+/**
+ * Theme metadata interface matching themes.config.js structure
+ */
+interface ThemeMetadata {
+    /** Display name of the theme */
+    name: string;
+    /** Unique identifier/class name for the theme */
+    class?: string;
+    /** Theme description */
+    description?: string;
+    /** Theme author */
+    author?: string;
+    /** Theme version (semver) */
+    version?: string;
+    /** Theme tags for categorization */
+    tags?: string[];
+    /** Whether the theme supports dark mode */
+    supportsDarkMode?: boolean;
+    /** Theme status: stable, beta, experimental, deprecated */
+    status?: 'stable' | 'beta' | 'experimental' | 'deprecated';
+    /** Accessibility information */
+    a11y?: {
+        /** Target contrast ratio */
+        contrastTarget?: number;
+        /** Supported color modes */
+        modes?: string[];
+    };
+    /** Primary theme color (for UI display) */
+    color?: string;
+    /** Theme features list */
+    features?: string[];
+    /** Theme dependencies (other themes required) */
+    dependencies?: string[];
+}
+/**
+ * Color palette configuration for a single color
+ */
+interface PaletteColor {
+    /** Main color value */
+    main: string;
+    /** Light variant (auto-generated if not provided) */
+    light?: string;
+    /** Dark variant (auto-generated if not provided) */
+    dark?: string;
+    /** Contrast text color (auto-generated if not provided) */
+    contrastText?: string;
+}
+/**
+ * Typography configuration options for createTheme
+ */
+interface TypographyOptions {
+    /** Font family */
+    fontFamily?: string;
+    /** Base font size in pixels */
+    fontSize?: number;
+    /** Font weight scale */
+    fontWeightLight?: number;
+    fontWeightRegular?: number;
+    fontWeightMedium?: number;
+    fontWeightSemiBold?: number;
+    fontWeightBold?: number;
+    /** Heading configurations */
+    h1?: {
+        fontSize?: string | number;
+        fontWeight?: number;
+        lineHeight?: number | string;
+        letterSpacing?: string;
+    };
+    h2?: {
+        fontSize?: string | number;
+        fontWeight?: number;
+        lineHeight?: number | string;
+        letterSpacing?: string;
+    };
+    h3?: {
+        fontSize?: string | number;
+        fontWeight?: number;
+        lineHeight?: number | string;
+        letterSpacing?: string;
+    };
+    h4?: {
+        fontSize?: string | number;
+        fontWeight?: number;
+        lineHeight?: number | string;
+        letterSpacing?: string;
+    };
+    h5?: {
+        fontSize?: string | number;
+        fontWeight?: number;
+        lineHeight?: number | string;
+        letterSpacing?: string;
+    };
+    h6?: {
+        fontSize?: string | number;
+        fontWeight?: number;
+        lineHeight?: number | string;
+        letterSpacing?: string;
+    };
+    /** Body text configurations */
+    body1?: {
+        fontSize?: string | number;
+        fontWeight?: number;
+        lineHeight?: number | string;
+    };
+    body2?: {
+        fontSize?: string | number;
+        fontWeight?: number;
+        lineHeight?: number | string;
+    };
+    /** Additional custom typography */
+    [key: string]: any;
+}
+/**
+ * Spacing function type
+ */
+type SpacingFunction = (...values: number[]) => string;
+/**
+ * Breakpoint values configuration
+ */
+interface BreakpointValues {
+    xs?: number;
+    sm?: number;
+    md?: number;
+    lg?: number;
+    xl?: number;
+    [key: string]: number | undefined;
+}
+/**
+ * Shadow configuration
+ */
+interface ShadowOptions {
+    xs?: string;
+    sm?: string;
+    md?: string;
+    lg?: string;
+    xl?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Transition configuration
+ */
+interface TransitionOptions {
+    /** Transition duration values */
+    duration?: {
+        shortest?: number;
+        shorter?: number;
+        short?: number;
+        standard?: number;
+        complex?: number;
+        enteringScreen?: number;
+        leavingScreen?: number;
+    };
+    /** Easing functions */
+    easing?: {
+        easeInOut?: string;
+        easeOut?: string;
+        easeIn?: string;
+        sharp?: string;
+    };
+}
+/**
+ * Z-index configuration
+ */
+interface ZIndexOptions {
+    mobileStepper?: number;
+    speedDial?: number;
+    appBar?: number;
+    drawer?: number;
+    modal?: number;
+    snackbar?: number;
+    tooltip?: number;
+    [key: string]: number | undefined;
+}
+/**
+ * Border radius configuration
+ */
+interface BorderRadiusOptions {
+    /** Base border radius */
+    base?: string | number;
+    /** Small border radius */
+    sm?: string | number;
+    /** Medium border radius */
+    md?: string | number;
+    /** Large border radius */
+    lg?: string | number;
+    /** Extra large border radius */
+    xl?: string | number;
+    /** 2X large border radius */
+    xxl?: string | number;
+    /** 3X large border radius */
+    '3xl'?: string | number;
+    /** 4X large border radius */
+    '4xl'?: string | number;
+    /** Pill shape (fully rounded) */
+    pill?: string | number;
+    [key: string]: string | number | undefined;
+}
+/**
+ * Custom theme properties for extension
+ * Users can augment this interface via module augmentation
+ */
+interface ThemeCustomProperties {
+    interactiveEffects?: {
+        vortex?: {
+            enabled?: boolean;
+            strength?: number;
+            radius?: number;
+            decay?: number;
+        };
+        chromaticAberration?: {
+            enabled?: boolean;
+            mode?: 'longitudinal' | 'lateral' | 'hybrid';
+            redShift?: number;
+            greenShift?: number;
+            blueShift?: number;
+            edgeOnly?: boolean;
+            edgeThreshold?: number;
+        };
+        mouseInteraction?: {
+            sensitivity?: number;
+            trailEffect?: boolean;
+        };
+        animationSpeed?: {
+            base?: number;
+            timeMultiplier?: number;
+        };
+    };
+    optimization?: {
+        responsive?: {
+            breakpoints?: {
+                mobile?: string;
+                tablet?: string;
+                desktop?: string;
+                wide?: string;
+            };
+            deviceScaling?: {
+                mobile?: number;
+                tablet?: number;
+                desktop?: number;
+            };
+        };
+        performance?: {
+            fpsTarget?: number;
+            autoScaling?: boolean;
+        };
+        autoScaling?: {
+            enabled?: boolean;
+            qualityThresholds?: {
+                lowEnd?: number;
+                midRange?: number;
+                highEnd?: number;
+            };
+        };
+    };
+    visualPolish?: {
+        borders?: {
+            iridescentGlow?: boolean;
+            shimmerEffect?: boolean;
+            beveledEdges?: boolean;
+            pulsingGlow?: boolean;
+        };
+        contentAwareBlur?: {
+            enabled?: boolean;
+            depthDetection?: boolean;
+            edgePreservation?: boolean;
+            variableRadius?: boolean;
+        };
+        holographicEffects?: {
+            enabled?: boolean;
+            rainbowDiffraction?: boolean;
+            scanlineAnimation?: boolean;
+            gridOverlay?: boolean;
+            dataStream?: boolean;
+            pulseRings?: boolean;
+        };
+    };
+    [key: string]: any;
+}
+/**
+ * Complete theme object with computed values
+ * Generated by createTheme function
+ */
+interface Theme extends ThemeMetadata {
+    /** Color palette with computed values */
+    palette: {
+        primary: PaletteColor;
+        secondary: PaletteColor;
+        error: PaletteColor;
+        warning: PaletteColor;
+        info: PaletteColor;
+        success: PaletteColor;
+        background: {
+            default: string;
+            paper: string;
+            subtle: string;
+        };
+        text: {
+            primary: string;
+            secondary: string;
+            disabled: string;
+        };
+        [key: string]: any;
+    };
+    /** Typography with computed values */
+    typography: {
+        fontFamily: string;
+        fontSize: number;
+        fontWeightLight: number;
+        fontWeightRegular: number;
+        fontWeightMedium: number;
+        fontWeightSemiBold: number;
+        fontWeightBold: number;
+        h1: Required<NonNullable<TypographyOptions['h1']>>;
+        h2: Required<NonNullable<TypographyOptions['h2']>>;
+        h3: Required<NonNullable<TypographyOptions['h3']>>;
+        h4: Required<NonNullable<TypographyOptions['h4']>>;
+        h5: Required<NonNullable<TypographyOptions['h5']>>;
+        h6: Required<NonNullable<TypographyOptions['h6']>>;
+        body1: Required<NonNullable<TypographyOptions['body1']>>;
+        body2: Required<NonNullable<TypographyOptions['body2']>>;
+        [key: string]: any;
+    };
+    /** Spacing function */
+    spacing: SpacingFunction;
+    /** Breakpoints with computed values */
+    breakpoints: {
+        values: Required<BreakpointValues>;
+        unit: string;
+        up: (key: keyof BreakpointValues | number) => string;
+        down: (key: keyof BreakpointValues | number) => string;
+        between: (start: keyof BreakpointValues | number, end: keyof BreakpointValues | number) => string;
+    };
+    /** Shadows */
+    shadows: Required<ShadowOptions>;
+    /** Transitions */
+    transitions: Required<TransitionOptions>;
+    /** Z-index values */
+    zIndex: Required<ZIndexOptions>;
+    /** Border radius values */
+    borderRadius: Required<BorderRadiusOptions>;
+    /** Custom properties */
+    custom: ThemeCustomProperties;
+    /** Global CSS variables to apply */
+    cssVars?: Record<string, string | number>;
+    /** Indicates this is a JS theme (not CSS-only) */
+    __isJSTheme: true;
+}
+
+/**
+ * Configuration Types
+ *
+ * Type definitions for the Atomix configuration system.
+ */
+
+/**
+ * Color Scale (1-10)
+ */
+interface ColorScale {
+    1?: string;
+    2?: string;
+    3?: string;
+    4?: string;
+    5?: string;
+    6?: string;
+    7?: string;
+    8?: string;
+    9?: string;
+    10?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Palette Color Options
+ */
+interface PaletteColorOptions {
+    main: string;
+    light?: string;
+    dark?: string;
+    contrastText?: string;
+}
+/**
+ * Interactive Effect Configuration
+ */
+interface InteractiveEffectsConfig {
+    /** Vortex & flow field effects */
+    vortex?: {
+        enabled?: boolean;
+        strength?: number;
+        radius?: number;
+        decay?: number;
+        curlNoise?: boolean;
+        velocityTracking?: boolean;
+    };
+    /** Chromatic aberration effects */
+    chromaticAberration?: {
+        enabled?: boolean;
+        mode?: 'longitudinal' | 'lateral' | 'hybrid';
+        redShift?: number;
+        greenShift?: number;
+        blueShift?: number;
+        edgeOnly?: boolean;
+        edgeThreshold?: number;
+    };
+    /** Mouse interaction settings */
+    mouseInteraction?: {
+        sensitivity?: number;
+        trailEffect?: boolean;
+        pressureSensitivity?: boolean;
+    };
+    /** Animation speed controls */
+    animationSpeed?: {
+        base?: number;
+        timeMultiplier?: number;
+    };
+}
+/**
+ * Optimization Configuration
+ */
+interface OptimizationConfig {
+    /** Responsive breakpoint system */
+    responsive?: {
+        breakpoints?: {
+            mobile?: string;
+            tablet?: string;
+            desktop?: string;
+            wide?: string;
+        };
+        /** Device-aware parameter scaling */
+        deviceScaling?: {
+            mobile?: number;
+            tablet?: number;
+            desktop?: number;
+        };
+    };
+    /** Performance monitoring */
+    performance?: {
+        enabled?: boolean;
+        fpsTarget?: number;
+        autoScaling?: boolean;
+        monitorDashboard?: boolean;
+    };
+    /** Auto-scaling logic based on device capabilities */
+    autoScaling?: {
+        enabled?: boolean;
+        qualityThresholds?: {
+            lowEnd?: number;
+            midRange?: number;
+            highEnd?: number;
+        };
+    };
+}
+/**
+ * Visual Polish Configuration
+ */
+interface VisualPolishConfig {
+    /** Advanced border effects */
+    borders?: {
+        iridescentGlow?: boolean;
+        shimmerEffect?: boolean;
+        beveledEdges?: boolean;
+        pulsingGlow?: boolean;
+    };
+    /** Content-aware blur */
+    contentAwareBlur?: {
+        enabled?: boolean;
+        depthDetection?: boolean;
+        edgePreservation?: boolean;
+        variableRadius?: boolean;
+    };
+    /** Holographic effect modes */
+    holographicEffects?: {
+        enabled?: boolean;
+        rainbowDiffraction?: boolean;
+        scanlineAnimation?: boolean;
+        gridOverlay?: boolean;
+        dataStream?: boolean;
+        pulseRings?: boolean;
+    };
+}
+/**
+ * Design Tokens Schema (Tailwind-like)
+ */
+interface ThemeTokens {
+    /** Color palette */
+    colors?: Record<string, string | PaletteColorOptions | ColorScale | Record<string, string>>;
+    /** Spacing scale */
+    spacing?: Record<string, string>;
+    /** Border radius scale */
+    borderRadius?: Record<string, string>;
+    /** Typography scale and settings */
+    typography?: {
+        fontFamilies?: Record<string, string>;
+        fontSizes?: Record<string, string>;
+        fontWeights?: Record<string, string | number>;
+        lineHeights?: Record<string, string | number>;
+        letterSpacings?: Record<string, string>;
+    };
+    /** Shadow scale */
+    shadows?: Record<string, string>;
+    /** Z-index scale */
+    zIndex?: Record<string, string | number>;
+    /** Breakpoints scale */
+    breakpoints?: Record<string, string | number>;
+    /** Transitions settings */
+    transitions?: {
+        durations?: Record<string, string>;
+        easings?: Record<string, string>;
+    };
+}
+/**
+ * CSS Theme Definition
+ */
+interface CSSThemeDefinition {
+    type: 'css';
+    name: string;
+    class?: string;
+    description?: string;
+    author?: string;
+    version?: string;
+    tags?: string[];
+    supportsDarkMode?: boolean;
+    status?: 'stable' | 'beta' | 'experimental' | 'deprecated';
+    a11y?: {
+        contrastTarget?: number;
+        modes?: string[];
+    };
+    color?: string;
+    features?: string[];
+    dependencies?: string[];
+    cssPath?: string;
+}
+/**
+ * JavaScript Theme Definition
+ */
+interface JSThemeDefinition {
+    type: 'js';
+    name: string;
+    class?: string;
+    description?: string;
+    author?: string;
+    version?: string;
+    tags?: string[];
+    supportsDarkMode?: boolean;
+    status?: 'stable' | 'beta' | 'experimental' | 'deprecated';
+    a11y?: {
+        contrastTarget?: number;
+        modes?: string[];
+    };
+    color?: string;
+    features?: string[];
+    dependencies?: string[];
+    createTheme: () => Theme;
+}
+/**
+ * Theme Definition (CSS or JS)
+ */
+type ThemeDefinition = CSSThemeDefinition | JSThemeDefinition;
+/**
+ * Build configuration
+ */
+interface BuildConfig {
+    output?: {
+        directory?: string;
+        formats?: {
+            expanded?: string;
+            compressed?: string;
+        };
+    };
+    sass?: {
+        style?: 'expanded' | 'compressed';
+        sourceMap?: boolean;
+        loadPaths?: string[];
+    };
+}
+/**
+ * Runtime configuration
+ */
+interface RuntimeConfig {
+    basePath?: string;
+    cdnPath?: string | null;
+    preload?: string[];
+    lazy?: boolean;
+    defaultTheme?: string;
+    storageKey?: string;
+    dataAttribute?: string;
+    enablePersistence?: boolean;
+    useMinified?: boolean;
+}
+/**
+ * Integration settings
+ */
+interface IntegrationConfig {
+    cssVariables?: Record<string, string>;
+    classNames?: {
+        theme?: string;
+        colorMode?: string;
+    };
+}
+/**
+ * Plugin Configuration
+ */
+interface PluginConfig {
+    name: string;
+    options?: Record<string, any>;
+}
+/**
+ * Token Provider Configuration
+ */
+interface TokenProviderConfig {
+    type: 'figma' | 'style-dictionary' | 'w3c' | string;
+    options?: Record<string, any>;
+}
+/**
+ * Token Engine Configuration
+ */
+interface TokenEngineConfig {
+    providers?: Record<string, TokenProviderConfig>;
+    sync?: {
+        pull?: boolean;
+        push?: boolean;
+        onBuild?: boolean;
+    };
+}
+/**
+ * CLI component generator defaults
+ */
+interface GeneratorConfig {
+    /** Default output directory for generated components */
+    outputPath?: string;
+    /** Override detected framework */
+    framework?: 'react' | 'next' | 'vanilla';
+    /** Per-feature defaults */
+    features?: {
+        storybook?: boolean;
+        hook?: boolean;
+        styles?: boolean;
+        tests?: boolean;
+    };
+    /** Composable hooks directory relative to project root */
+    hookOutputDir?: string;
+    /** Story file: side-effect import for global Atomix styles */
+    storybookCssImport?: string;
+    /** Barrel file strategy for new components */
+    barrel?: 'index' | 'none';
+}
+/**
+ * Atomix Configuration Interface
+ *
+ * Tailwind-like configuration for external developers.
+ */
+interface AtomixConfig {
+    prefix?: string;
+    plugins?: (string | PluginConfig)[];
+    tokenEngine?: TokenEngineConfig;
+    ai?: {
+        provider?: 'openai' | 'anthropic';
+        model?: string;
+        apiKey?: string;
+        temperature?: number;
+        maxTokens?: number;
+        rateLimit?: {
+            requests: number;
+            windowMs: number;
+        };
+    };
+    telemetry?: {
+        enabled?: boolean;
+        path?: string;
+        anonymize?: boolean;
+    };
+    generator?: GeneratorConfig;
+    interactiveEffects?: InteractiveEffectsConfig;
+    optimization?: OptimizationConfig;
+    visualPolish?: VisualPolishConfig;
+    theme?: {
+        extend?: ThemeTokens;
+        tokens?: ThemeTokens;
+        themes?: Record<string, ThemeDefinition>;
+    };
+    /** @internal Build configuration */
+    build?: BuildConfig;
+    /** @internal Runtime configuration */
+    runtime?: RuntimeConfig;
+    /** @internal Integration settings */
+    integration?: IntegrationConfig;
+    /** @internal Theme dependencies mapping */
+    dependencies?: Record<string, string[]>;
+}
+/**
+ * Helper function to define Atomix configuration with type safety
+ */
+declare function defineConfig(config: AtomixConfig): AtomixConfig;
+
+export { defineConfig };
+export type { AtomixConfig, BuildConfig, CSSThemeDefinition, ColorScale, GeneratorConfig, IntegrationConfig, JSThemeDefinition, PaletteColorOptions, PluginConfig, RuntimeConfig, ThemeDefinition, ThemeTokens, TokenEngineConfig, TokenProviderConfig };

package/dist/config.js

@@ -0,0 +1,17 @@
+import "fs";
+
+import "path";
+
+/**
+ * Configuration Types
+ *
+ * Type definitions for the Atomix configuration system.
+ */
+/**
+ * Helper function to define Atomix configuration with type safety
+ */ function defineConfig(config) {
+    return config;
+}
+
+export { defineConfig };
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sources":["../src/lib/config/types.ts"],"sourcesContent":[null],"names":["defineConfig","config"],"mappings":";;;;;;;;;;;GAkYM,UAAUA,aAAaC;IAC3B,OAAOA;AACT;;"}