@shohojdhara/atomix 0.5.2 → 0.5.4

package/dist/index.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
     value: !0
 });
 
-var jsxRuntime = require("react/jsx-runtime"), React = require("react"), PhosphorIcons = require("@phosphor-icons/react"), reactDom = require("react-dom");
+var jsxRuntime = require("react/jsx-runtime"), React = require("react"), PhosphorIcons = require("@phosphor-icons/react"), reactDom = require("react-dom"), fs = require("fs"), path$4 = require("path");
 
 function _interopDefaultCompat(e) {
     return e && "object" == typeof e && "default" in e ? e : {
@@ -3587,7 +3587,7 @@ function useResponsiveGlass({baseParams: baseParams, breakpoints: breakpoints =
  * @param config Monitor configuration
  * @returns Performance metrics and controls
  */
-function usePerformanceMonitor(config = {}) {
+function usePerformanceMonitor$1(config = {}) {
     const {enabled: enabled = !0, targetFps: targetFps = 60, minFps: minFps = 45, scaleUpThreshold: scaleUpThreshold = 58, lowFpsFrames: lowFpsFrames = 3, highFpsFrames: highFpsFrames = 10, debug: debug = !1, showOverlay: showOverlay = !1} = config, [metrics, setMetrics] = React.useState({
         fps: 0,
         frameTime: 0,
@@ -4143,7 +4143,7 @@ function getDevicePreset(presetName) {
         debug: !1
     });
     // Performance monitoring - tracks FPS, frame time, memory usage
-    const {metrics: performanceMetrics, toggleMonitoring: toggleMonitoring} = usePerformanceMonitor({
+    const {metrics: performanceMetrics, toggleMonitoring: toggleMonitoring} = usePerformanceMonitor$1({
         enabled: debugPerformance,
         // Enable when debugPerformance is true
         debug: !1,
@@ -5144,7 +5144,7 @@ const BreadcrumbItem =  React.forwardRef((({children: children, href: href, acti
 
 BreadcrumbItem.displayName = "BreadcrumbItem";
 
-const Breadcrumb =  React.memo((function({items: items, divider: divider, className: className = "", "aria-label": ariaLabel = "Breadcrumb", linkComponent: linkComponent, style: style, children: children}) {
+const BreadcrumbComponent =  React.memo((function({items: items, divider: divider, className: className = "", "aria-label": ariaLabel = "Breadcrumb", linkComponent: linkComponent, style: style, children: children}) {
     const breadcrumbClasses = [ BREADCRUMB.CLASSES.BASE, className ].filter(Boolean).join(" ");
     let content;
     if (items && items.length > 0) 
@@ -5184,7 +5184,7 @@ const Breadcrumb =  React.memo((function({items: items, divider: divider, classN
             children: content
         })
     });
-}));
+})), Breadcrumb = BreadcrumbComponent;
 
 /**
  * Spinner state and functionality
@@ -13506,21 +13506,21 @@ const DEFAULT_ATOMIX_FONTS = [ {
     const [interaction, setInteraction] = React.useState({
         hoveredIndex: null,
         selectedIndex: null
-    });
+    }), handlePointHover = React.useCallback((index => {
+        setInteraction((prev => ({
+            ...prev,
+            hoveredIndex: index
+        })));
+    }), []), handlePointClick = React.useCallback((index => {
+        setInteraction((prev => ({
+            ...prev,
+            selectedIndex: prev.selectedIndex === index ? null : index
+        })));
+    }), []);
     return {
         interaction: interaction,
-        handlePointHover: React.useCallback((index => {
-            setInteraction((prev => ({
-                ...prev,
-                hoveredIndex: index
-            })));
-        }), []),
-        handlePointClick: React.useCallback((index => {
-            setInteraction((prev => ({
-                ...prev,
-                selectedIndex: prev.selectedIndex === index ? null : index
-            })));
-        }), []),
+        handlePointHover: handlePointHover,
+        handlePointClick: handlePointClick,
         clearInteraction: React.useCallback((() => {
             setInteraction({
                 hoveredIndex: null,
@@ -13563,7 +13563,7 @@ var composablesImport =  Object.freeze({
     useNavDropdown: useNavDropdown,
     useNavItem: useNavItem,
     useNavbar: useNavbar,
-    usePerformanceMonitor: usePerformanceMonitor,
+    usePerformanceMonitor: usePerformanceMonitor$1,
     usePieChart: usePieChart,
     useRadio: useRadio,
     useResponsiveGlass: useResponsiveGlass,
@@ -20901,7 +20901,51 @@ const defaultTokens = {
     "breakpoint-md": "768px",
     "breakpoint-lg": "992px",
     "breakpoint-xl": "1200px",
-    "breakpoint-xxl": "1440px"
+    "breakpoint-xxl": "1440px",
+    // Advanced Features - Interactive Effects (Phase 2)
+    "interactive-vortex-enabled": "false",
+    "interactive-vortex-strength": "0.5",
+    "interactive-vortex-radius": "100",
+    "interactive-vortex-decay": "0.8",
+    "interactive-chromatic-enabled": "false",
+    "interactive-chromatic-mode": "lateral",
+    "interactive-chromatic-red-shift": "0.02",
+    "interactive-chromatic-green-shift": "0",
+    "interactive-chromatic-blue-shift": "-0.02",
+    "interactive-chromatic-edge-only": "false",
+    "interactive-chromatic-edge-threshold": "0.5",
+    "interactive-mouse-sensitivity": "1.0",
+    "interactive-mouse-trail-effect": "false",
+    "interactive-animation-speed-base": "1.0",
+    "interactive-animation-speed-multiplier": "1.0",
+    // Advanced Features - Optimization (Phase 3)
+    "optimization-breakpoint-mobile": "0px",
+    "optimization-breakpoint-tablet": "768px",
+    "optimization-breakpoint-desktop": "1024px",
+    "optimization-breakpoint-wide": "1440px",
+    "optimization-device-scaling-mobile": "0.5",
+    "optimization-device-scaling-tablet": "0.75",
+    "optimization-device-scaling-desktop": "1.0",
+    "optimization-performance-fps-target": "60",
+    "optimization-auto-scaling-enabled": "false",
+    "optimization-auto-scaling-low-end": "0.5",
+    "optimization-auto-scaling-mid-range": "0.75",
+    "optimization-auto-scaling-high-end": "1.0",
+    // Advanced Features - Visual Polish (Phase 4)
+    "visual-polish-border-iridescent-glow": "false",
+    "visual-polish-border-shimmer-effect": "false",
+    "visual-polish-border-beveled-edges": "false",
+    "visual-polish-border-pulsing-glow": "false",
+    "visual-polish-content-aware-blur-enabled": "false",
+    "visual-polish-content-aware-depth-detection": "false",
+    "visual-polish-content-aware-edge-preservation": "false",
+    "visual-polish-content-aware-variable-radius": "false",
+    "visual-polish-holographic-enabled": "false",
+    "visual-polish-holographic-rainbow-diffraction": "false",
+    "visual-polish-holographic-scanline-animation": "false",
+    "visual-polish-holographic-grid-overlay": "false",
+    "visual-polish-holographic-data-stream": "false",
+    "visual-polish-holographic-pulse-rings": "false"
 };
 
 /**
@@ -20981,158 +21025,479 @@ const defaultTokens = {
 }
 
 /**
- * Theme System Error Handling
+ * Theme Adapter
  *
- * Centralized error handling for the Atomix theme system.
- * Provides custom error classes and logging utilities.
+ * Converts between Theme objects and DesignTokens
  */
 /**
- * Theme error codes
- */ var ThemeErrorCode, LogLevel;
-
-!function(ThemeErrorCode) {
-    /** Theme not found in registry */
-    ThemeErrorCode.THEME_NOT_FOUND = "THEME_NOT_FOUND", 
-    /** Theme failed to load */
-    ThemeErrorCode.THEME_LOAD_FAILED = "THEME_LOAD_FAILED", 
-    /** Theme validation failed */
-    ThemeErrorCode.THEME_VALIDATION_FAILED = "THEME_VALIDATION_FAILED", 
-    /** Configuration loading failed */
-    ThemeErrorCode.CONFIG_LOAD_FAILED = "CONFIG_LOAD_FAILED", 
-    /** Configuration validation failed */
-    ThemeErrorCode.CONFIG_VALIDATION_FAILED = "CONFIG_VALIDATION_FAILED", 
-    /** Circular dependency detected */
-    ThemeErrorCode.CIRCULAR_DEPENDENCY = "CIRCULAR_DEPENDENCY", 
-    /** Missing dependency */
-    ThemeErrorCode.MISSING_DEPENDENCY = "MISSING_DEPENDENCY", 
-    /** Storage operation failed */
-    ThemeErrorCode.STORAGE_ERROR = "STORAGE_ERROR", 
-    /** Invalid theme name */
-    ThemeErrorCode.INVALID_THEME_NAME = "INVALID_THEME_NAME", 
-    /** CSS injection failed */
-    ThemeErrorCode.CSS_INJECTION_FAILED = "CSS_INJECTION_FAILED", 
-    /** Invalid color format */
-    ThemeErrorCode.INVALID_COLOR_FORMAT = "INVALID_COLOR_FORMAT", 
-    /** Missing required token */
-    ThemeErrorCode.MISSING_REQUIRED_TOKEN = "MISSING_REQUIRED_TOKEN", 
-    /** Accessibility contrast violation */
-    ThemeErrorCode.CONTRAST_VIOLATION = "CONTRAST_VIOLATION", 
-    /** Invalid token type */
-    ThemeErrorCode.INVALID_TOKEN_TYPE = "INVALID_TOKEN_TYPE", 
-    /** Unknown error */
-    ThemeErrorCode.UNKNOWN_ERROR = "UNKNOWN_ERROR";
-}(ThemeErrorCode || (ThemeErrorCode = {}));
+ * Convert a Theme object to DesignTokens
+ */ function themeToDesignTokens(theme) {
+    const tokens = {};
+    // Convert colors
+        if (theme.palette) {
+        // Primary color
+        if (theme.palette.primary) {
+            const primaryMain = theme.palette.primary.main;
+            tokens.primary = primaryMain;
+            const rgb = hexToRgb$2(primaryMain);
+            rgb && (tokens["primary-rgb"] = rgb);
+        }
+        // Secondary color
+                if (theme.palette.secondary) {
+            const secondaryMain = theme.palette.secondary.main;
+            tokens.secondary = secondaryMain;
+            const rgb = hexToRgb$2(secondaryMain);
+            rgb && (tokens["secondary-rgb"] = rgb);
+        }
+        // Other colors
+                const colorKeys = [ "error", "warning", "info", "success" ];
+        for (const key of colorKeys) if (theme.palette[key]) {
+            const colorMain = theme.palette[key].main;
+            tokens[key] = colorMain;
+            const rgb = hexToRgb$2(colorMain);
+            rgb && (tokens[`${key}-rgb`] = rgb);
+        }
+        // Background colors
+                theme.palette.background && (tokens["body-bg"] = theme.palette.background.default), 
+        // Text colors
+        theme.palette.text && (tokens["body-color"] = theme.palette.text.primary);
+    }
+    // Convert typography
+        // Convert border radius
+    if (theme.typography && (tokens["body-font-family"] = theme.typography.fontFamily, 
+    tokens["body-font-size"] = `${theme.typography.fontSize}px`, tokens["font-weight-normal"] = `${theme.typography.fontWeightRegular}`, 
+    tokens["font-weight-bold"] = `${theme.typography.fontWeightBold}`), 
+    // Convert spacing
+    "function" == typeof theme.spacing && (
+    // If spacing is a function, call it with some values to get results
+    tokens["spacing-1"] = theme.spacing(1), tokens["spacing-2"] = theme.spacing(2), 
+    tokens["spacing-4"] = theme.spacing(4)), 
+    // Convert breakpoints
+    theme.breakpoints?.values && (tokens["breakpoint-xs"] = `${theme.breakpoints.values.xs}px`, 
+    tokens["breakpoint-sm"] = `${theme.breakpoints.values.sm}px`, tokens["breakpoint-md"] = `${theme.breakpoints.values.md}px`, 
+    tokens["breakpoint-lg"] = `${theme.breakpoints.values.lg}px`, tokens["breakpoint-xl"] = `${theme.breakpoints.values.xl}px`), 
+    // Convert shadows
+    theme.shadows && (tokens["box-shadow"] = theme.shadows[2], // Use a moderate shadow
+    tokens["box-shadow-sm"] = theme.shadows[1], tokens["box-shadow-lg"] = theme.shadows[3]), 
+    // Convert transitions
+    theme.transitions && (tokens["transition-duration-base"] = `${theme.transitions.duration.standard}ms`), 
+    // Convert z-index
+    theme.zIndex && (tokens["z-modal"] = `${theme.zIndex.modal}`, tokens["z-popover"] = `${theme.zIndex.popover}`, 
+    tokens["z-tooltip"] = `${theme.zIndex.tooltip}`), theme.borderRadius) {
+        const baseRadius = theme.borderRadius.base;
+        tokens["border-radius"] = "number" == typeof baseRadius ? `${baseRadius}px` : baseRadius;
+    }
+    // Add advanced feature tokens if available in theme
+        if (theme.custom) {
+        // Interactive Effects (Phase 2)
+        if (theme.custom.interactiveEffects) {
+            const ie = theme.custom.interactiveEffects;
+            // Vortex effects
+                        ie.vortex && (tokens["interactive-vortex-enabled"] = String(ie.vortex.enabled ?? !1), 
+            tokens["interactive-vortex-strength"] = String(ie.vortex.strength ?? .5), tokens["interactive-vortex-radius"] = String(ie.vortex.radius ?? 100), 
+            tokens["interactive-vortex-decay"] = String(ie.vortex.decay ?? .8)), 
+            // Chromatic aberration
+            ie.chromaticAberration && (tokens["interactive-chromatic-enabled"] = String(ie.chromaticAberration.enabled ?? !1), 
+            tokens["interactive-chromatic-mode"] = ie.chromaticAberration.mode ?? "lateral", 
+            tokens["interactive-chromatic-red-shift"] = String(ie.chromaticAberration.redShift ?? .02), 
+            tokens["interactive-chromatic-green-shift"] = String(ie.chromaticAberration.greenShift ?? 0), 
+            tokens["interactive-chromatic-blue-shift"] = String(ie.chromaticAberration.blueShift ?? -.02), 
+            tokens["interactive-chromatic-edge-only"] = String(ie.chromaticAberration.edgeOnly ?? !1), 
+            tokens["interactive-chromatic-edge-threshold"] = String(ie.chromaticAberration.edgeThreshold ?? .5)), 
+            // Mouse interaction
+            ie.mouseInteraction && (tokens["interactive-mouse-sensitivity"] = String(ie.mouseInteraction.sensitivity ?? 1), 
+            tokens["interactive-mouse-trail-effect"] = String(ie.mouseInteraction.trailEffect ?? !1)), 
+            // Animation speed
+            ie.animationSpeed && (tokens["interactive-animation-speed-base"] = String(ie.animationSpeed.base ?? 1), 
+            tokens["interactive-animation-speed-multiplier"] = String(ie.animationSpeed.timeMultiplier ?? 1));
+        }
+        // Optimization (Phase 3)
+                if (theme.custom.optimization) {
+            const opt = theme.custom.optimization;
+            // Responsive breakpoints
+                        opt.responsive && (opt.responsive.breakpoints && (tokens["optimization-breakpoint-mobile"] = opt.responsive.breakpoints.mobile ?? "0px", 
+            tokens["optimization-breakpoint-tablet"] = opt.responsive.breakpoints.tablet ?? "768px", 
+            tokens["optimization-breakpoint-desktop"] = opt.responsive.breakpoints.desktop ?? "1024px", 
+            tokens["optimization-breakpoint-wide"] = opt.responsive.breakpoints.wide ?? "1440px"), 
+            opt.responsive.deviceScaling && (tokens["optimization-device-scaling-mobile"] = String(opt.responsive.deviceScaling.mobile ?? .5), 
+            tokens["optimization-device-scaling-tablet"] = String(opt.responsive.deviceScaling.tablet ?? .75), 
+            tokens["optimization-device-scaling-desktop"] = String(opt.responsive.deviceScaling.desktop ?? 1))), 
+            // Performance settings
+            opt.performance && (tokens["optimization-performance-fps-target"] = String(opt.performance.fpsTarget ?? 60), 
+            tokens["optimization-auto-scaling-enabled"] = String(opt.performance.autoScaling ?? !1)), 
+            // Auto-scaling settings
+            opt.autoScaling && (tokens["optimization-auto-scaling-enabled"] = String(opt.autoScaling.enabled ?? !1), 
+            tokens["optimization-auto-scaling-low-end"] = String(opt.autoScaling.qualityThresholds?.lowEnd ?? .5), 
+            tokens["optimization-auto-scaling-mid-range"] = String(opt.autoScaling.qualityThresholds?.midRange ?? .75), 
+            tokens["optimization-auto-scaling-high-end"] = String(opt.autoScaling.qualityThresholds?.highEnd ?? 1));
+        }
+        // Visual Polish (Phase 4)
+                if (theme.custom.visualPolish) {
+            const vp = theme.custom.visualPolish;
+            vp.borders && (tokens["visual-polish-border-iridescent-glow"] = String(vp.borders.iridescentGlow ?? !1), 
+            tokens["visual-polish-border-shimmer-effect"] = String(vp.borders.shimmerEffect ?? !1), 
+            tokens["visual-polish-border-beveled-edges"] = String(vp.borders.beveledEdges ?? !1), 
+            tokens["visual-polish-border-pulsing-glow"] = String(vp.borders.pulsingGlow ?? !1)), 
+            vp.contentAwareBlur && (tokens["visual-polish-content-aware-blur-enabled"] = String(vp.contentAwareBlur.enabled ?? !1), 
+            tokens["visual-polish-content-aware-depth-detection"] = String(vp.contentAwareBlur.depthDetection ?? !1), 
+            tokens["visual-polish-content-aware-edge-preservation"] = String(vp.contentAwareBlur.edgePreservation ?? !1), 
+            tokens["visual-polish-content-aware-variable-radius"] = String(vp.contentAwareBlur.variableRadius ?? !1)), 
+            vp.holographicEffects && (tokens["visual-polish-holographic-enabled"] = String(vp.holographicEffects.enabled ?? !1), 
+            tokens["visual-polish-holographic-rainbow-diffraction"] = String(vp.holographicEffects.rainbowDiffraction ?? !1), 
+            tokens["visual-polish-holographic-scanline-animation"] = String(vp.holographicEffects.scanlineAnimation ?? !1), 
+            tokens["visual-polish-holographic-grid-overlay"] = String(vp.holographicEffects.gridOverlay ?? !1), 
+            tokens["visual-polish-holographic-data-stream"] = String(vp.holographicEffects.dataStream ?? !1), 
+            tokens["visual-polish-holographic-pulse-rings"] = String(vp.holographicEffects.pulseRings ?? !1));
+        }
+    }
+    // Create full tokens object with defaults
+        return createTokens(tokens);
+}
 
 /**
- * Custom error class for theme-related errors
- */
-class ThemeError extends Error {
-    constructor(message, code = ThemeErrorCode.UNKNOWN_ERROR, context) {
-        super(message), this.name = "ThemeError", this.code = code, this.context = context, 
-        this.timestamp = Date.now(), 
-        // Maintains proper stack trace for where our error was thrown (only available on V8)
-        Error.captureStackTrace && Error.captureStackTrace(this, ThemeError);
-    }
-    /**
-   * Convert error to JSON for logging
-   */    toJSON() {
-        return {
-            name: this.name,
-            message: this.message,
-            code: this.code,
-            context: this.context,
-            timestamp: this.timestamp,
-            stack: this.stack
-        };
+ * Converts an AtomixConfig to DesignTokens
+ *
+ * This function maps the configuration from the user-facing format
+ * to the internal DesignTokens format used by the theme system.
+ *
+ * @param config - The configuration object to convert
+ * @returns DesignTokens object ready for theme generation
+ *
+ * @example
+ * ```typescript
+ * import { configToTokens } from '@shohojdhara/atomix/theme';
+ *
+ * const config = {
+ *   prefix: 'myapp',
+ *   theme: { extend: { colors: { primary: { main: '#7AFFD7' } } } }
+ * };
+ * const tokens = configToTokens(config);
+ * ```
+ */ function configToTokens(config) {
+    const prefix = config.prefix || "atomix", theme = config.theme || {};
+    // Start with default tokens
+    let tokens = {
+        ...defaultTokens
+    };
+    // Apply theme extensions
+        // Apply advanced features if available in config
+    if (theme.extend && 
+    // Apply extensions to tokens
+    Object.entries(theme.extend).forEach((([category, values]) => {
+        "object" == typeof values && null !== values && Object.entries(values).forEach((([key, value]) => {
+            // Map theme categories to token names
+            const tokenName = `${category}-${key}`;
+            "string" == typeof value || "number" == typeof value ? tokens[tokenName] = String(value) : "object" == typeof value && null !== value && 
+            // Handle nested objects like color scales
+            Object.entries(value).forEach((([nestedKey, nestedValue]) => {
+                "string" != typeof nestedValue && "number" != typeof nestedValue || (tokens[`${tokenName}-${nestedKey}`] = String(nestedValue));
+            }));
+        }));
+    })), 
+    // Apply theme tokens if provided (completely replacing defaults)
+    theme.tokens && (tokens = {
+        ...tokens,
+        ...theme.tokens
+    }), config) {
+        // Interactive Effects (Phase 2)
+        if (config.interactiveEffects) {
+            const ie = config.interactiveEffects;
+            // Vortex effects
+                        ie.vortex && (tokens["interactive-vortex-enabled"] = String(ie.vortex.enabled ?? !1), 
+            tokens["interactive-vortex-strength"] = String(ie.vortex.strength ?? .5), tokens["interactive-vortex-radius"] = String(ie.vortex.radius ?? 100), 
+            tokens["interactive-vortex-decay"] = String(ie.vortex.decay ?? .8), tokens["interactive-vortex-curl-noise"] = String(ie.vortex.curlNoise ?? !1), 
+            tokens["interactive-vortex-velocity-tracking"] = String(ie.vortex.velocityTracking ?? !1)), 
+            // Chromatic aberration
+            ie.chromaticAberration && (tokens["interactive-chromatic-enabled"] = String(ie.chromaticAberration.enabled ?? !1), 
+            tokens["interactive-chromatic-mode"] = ie.chromaticAberration.mode ?? "lateral", 
+            tokens["interactive-chromatic-red-shift"] = String(ie.chromaticAberration.redShift ?? .02), 
+            tokens["interactive-chromatic-green-shift"] = String(ie.chromaticAberration.greenShift ?? 0), 
+            tokens["interactive-chromatic-blue-shift"] = String(ie.chromaticAberration.blueShift ?? -.02), 
+            tokens["interactive-chromatic-edge-only"] = String(ie.chromaticAberration.edgeOnly ?? !1), 
+            tokens["interactive-chromatic-edge-threshold"] = String(ie.chromaticAberration.edgeThreshold ?? .5)), 
+            // Mouse interaction
+            ie.mouseInteraction && (tokens["interactive-mouse-sensitivity"] = String(ie.mouseInteraction.sensitivity ?? 1), 
+            tokens["interactive-mouse-trail-effect"] = String(ie.mouseInteraction.trailEffect ?? !1), 
+            tokens["interactive-mouse-pressure-sensitivity"] = String(ie.mouseInteraction.pressureSensitivity ?? !1)), 
+            // Animation speed
+            ie.animationSpeed && (tokens["interactive-animation-speed-base"] = String(ie.animationSpeed.base ?? 1), 
+            tokens["interactive-animation-speed-multiplier"] = String(ie.animationSpeed.timeMultiplier ?? 1));
+        }
+        // Optimization (Phase 3)
+                if (config.optimization) {
+            const opt = config.optimization;
+            // Responsive breakpoints
+                        opt.responsive && (opt.responsive.breakpoints && (tokens["optimization-breakpoint-mobile"] = opt.responsive.breakpoints.mobile ?? "0px", 
+            tokens["optimization-breakpoint-tablet"] = opt.responsive.breakpoints.tablet ?? "768px", 
+            tokens["optimization-breakpoint-desktop"] = opt.responsive.breakpoints.desktop ?? "1024px", 
+            tokens["optimization-breakpoint-wide"] = opt.responsive.breakpoints.wide ?? "1440px"), 
+            opt.responsive.deviceScaling && (tokens["optimization-device-scaling-mobile"] = String(opt.responsive.deviceScaling.mobile ?? .5), 
+            tokens["optimization-device-scaling-tablet"] = String(opt.responsive.deviceScaling.tablet ?? .75), 
+            tokens["optimization-device-scaling-desktop"] = String(opt.responsive.deviceScaling.desktop ?? 1))), 
+            // Performance settings
+            opt.performance && (tokens["optimization-performance-fps-target"] = String(opt.performance.fpsTarget ?? 60), 
+            tokens["optimization-auto-scaling-enabled"] = String(opt.performance.autoScaling ?? !1), 
+            tokens["optimization-monitor-dashboard-enabled"] = String(opt.performance.monitorDashboard ?? !1)), 
+            // Auto-scaling settings
+            opt.autoScaling && (tokens["optimization-auto-scaling-enabled"] = String(opt.autoScaling.enabled ?? !1), 
+            tokens["optimization-auto-scaling-low-end"] = String(opt.autoScaling.qualityThresholds?.lowEnd ?? .5), 
+            tokens["optimization-auto-scaling-mid-range"] = String(opt.autoScaling.qualityThresholds?.midRange ?? .75), 
+            tokens["optimization-auto-scaling-high-end"] = String(opt.autoScaling.qualityThresholds?.highEnd ?? 1));
+        }
+        // Visual Polish (Phase 4)
+                if (config.visualPolish) {
+            const vp = config.visualPolish;
+            vp.borders && (tokens["visual-polish-border-iridescent-glow"] = String(vp.borders.iridescentGlow ?? !1), 
+            tokens["visual-polish-border-shimmer-effect"] = String(vp.borders.shimmerEffect ?? !1), 
+            tokens["visual-polish-border-beveled-edges"] = String(vp.borders.beveledEdges ?? !1), 
+            tokens["visual-polish-border-pulsing-glow"] = String(vp.borders.pulsingGlow ?? !1)), 
+            vp.contentAwareBlur && (tokens["visual-polish-content-aware-blur-enabled"] = String(vp.contentAwareBlur.enabled ?? !1), 
+            tokens["visual-polish-content-aware-depth-detection"] = String(vp.contentAwareBlur.depthDetection ?? !1), 
+            tokens["visual-polish-content-aware-edge-preservation"] = String(vp.contentAwareBlur.edgePreservation ?? !1), 
+            tokens["visual-polish-content-aware-variable-radius"] = String(vp.contentAwareBlur.variableRadius ?? !1)), 
+            vp.holographicEffects && (tokens["visual-polish-holographic-enabled"] = String(vp.holographicEffects.enabled ?? !1), 
+            tokens["visual-polish-holographic-rainbow-diffraction"] = String(vp.holographicEffects.rainbowDiffraction ?? !1), 
+            tokens["visual-polish-holographic-scanline-animation"] = String(vp.holographicEffects.scanlineAnimation ?? !1), 
+            tokens["visual-polish-holographic-grid-overlay"] = String(vp.holographicEffects.gridOverlay ?? !1), 
+            tokens["visual-polish-holographic-data-stream"] = String(vp.holographicEffects.dataStream ?? !1), 
+            tokens["visual-polish-holographic-pulse-rings"] = String(vp.holographicEffects.pulseRings ?? !1));
+        }
     }
+    // Apply prefix to all tokens
+        const prefixedTokens = {};
+    return Object.entries(tokens).forEach((([key, value]) => {
+        // If the token key already starts with the prefix, use as-is
+        // Otherwise, add the prefix
+        const prefixedKey = key.startsWith(prefix) ? key : `${prefix}-${key}`;
+        prefixedTokens[prefixedKey] = value;
+    })), prefixedTokens;
 }
 
 /**
- * Log level
- */ !function(LogLevel) {
-    LogLevel[LogLevel.ERROR = 0] = "ERROR", LogLevel[LogLevel.WARN = 1] = "WARN", LogLevel[LogLevel.INFO = 2] = "INFO", 
-    LogLevel[LogLevel.DEBUG = 3] = "DEBUG";
-}(LogLevel || (LogLevel = {}));
+ * Convert hex color to RGB
+ */ function hexToRgb$2(hex) {
+    hex = hex.replace(/^#?([a-f\d])([a-f\d])([a-f\d])$/i, ((m, r, g, b) => r + r + g + g + b + b));
+    const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+    return result && result[1] && result[2] && result[3] ? `${parseInt(result[1], 16)}, ${parseInt(result[2], 16)}, ${parseInt(result[3], 16)}` : "0, 0, 0";
+}
 
 /**
- * Theme Logger
+ * Converts DesignTokens to CSS variables
  *
- * Centralized logging for the theme system.
- * Replaces console statements with structured logging.
+ * @param tokens - The tokens to convert
+ * @returns A record of CSS variable names and values
+ */ function designTokensToCSSVars(tokens) {
+    const cssVars = {};
+    return Object.entries(tokens).forEach((([key, value]) => {
+        void 0 !== value && (cssVars[`--atomix-${key}`] = String(value));
+    })), cssVars;
+}
+
+/**
+ * Load theme from config file (synchronous, Node.js only)
+ * @param configPath - Path to config file (default: atomix.config.ts)
+ * @returns DesignTokens from theme configuration
+ * @throws Error if config loading is not available in browser environment
  */
-class ThemeLogger {
-    constructor(config = {}) {
-        this.config = {
-            level: config.level ?? ("undefined" != typeof process && "production" === process.env?.NODE_ENV ? LogLevel.WARN : LogLevel.INFO),
-            enableConsole: config.enableConsole ?? !0,
-            onError: config.onError,
-            onWarn: config.onWarn,
-            onInfo: config.onInfo,
-            onDebug: config.onDebug
-        };
-    }
-    /**
-   * Log an error
-   */    error(message, error, context) {
-        if (this.config.level < LogLevel.ERROR) return;
-        const errorObj = error instanceof Error ? error : new Error(message), themeError = error instanceof ThemeError ? error : new ThemeError(message, ThemeErrorCode.UNKNOWN_ERROR, context);
-        this.config.enableConsole && console.error(`[ThemeError] ${message}`, {
-            error: errorObj,
-            context: {
-                ...context,
-                ...themeError.context
-            },
-            code: themeError.code
-        }), this.config.onError?.(themeError, context);
+/**
+ * Validate Atomix configuration structure
+ *
+ * Performs basic validation to catch common configuration errors early.
+ * Returns warnings for potential issues.
+ *
+ * @param config - Configuration object to validate
+ * @returns Array of validation warnings (empty if valid)
+ *
+ * @example
+ * ```typescript
+ * import { loadAtomixConfig, validateConfig } from '@shohojdhara/atomix/config';
+ *
+ * const config = loadAtomixConfig();
+ * const warnings = validateConfig(config);
+ * warnings.forEach(w => console.warn(w));
+ * ```
+ */
+function validateConfig$1(config) {
+    const warnings = [];
+    // Check prefix format
+        // Check theme structure
+    if (config.prefix && (/^[a-zA-Z][a-zA-Z0-9-]*$/.test(config.prefix) || warnings.push(`Invalid prefix "${config.prefix}". Prefix should start with a letter and contain only letters, numbers, and hyphens.\nExample: "myapp", "brand-ui", "enterprise"`), 
+    config.prefix.length < 2 && warnings.push(`Prefix "${config.prefix}" is too short. Use at least 2 characters for clarity.\nExample: "app" instead of "a"`)), 
+    config.theme && (
+    // Warn if both extend and tokens are provided
+    config.theme.extend && config.theme.tokens && warnings.push("Both theme.extend and theme.tokens are defined. theme.tokens will take precedence and completely replace the default token system.\nIf you want to extend defaults, remove theme.tokens and use only theme.extend."), 
+    config.theme.extend)) {
+        const extend = config.theme.extend, validThemeKeys = [ "colors", "typography", "spacing", "borderRadius", "shadows", "zIndex", "transitions", "breakpoints" ];
+        // Check for common typos in theme properties
+                Object.keys(extend).forEach((key => {
+            _includesInstanceProperty(validThemeKeys).call(validThemeKeys, key) || warnings.push(`Unknown theme property: "${key}"\nValid properties: ${validThemeKeys.join(", ")}\nDid you mean one of these? Check for typos.`);
+        }));
     }
-    /**
-   * Log a warning
-   */    warn(message, context) {
-        this.config.level < LogLevel.WARN || (this.config.enableConsole && console.warn(`[ThemeWarning] ${message}`, context || {}), 
-        this.config.onWarn?.(message, context));
+    // Validate advanced features
+        if (config.interactiveEffects) {
+        const ie = config.interactiveEffects;
+        // Validate vortex settings
+                ie.vortex && (ie.vortex.strength && (ie.vortex.strength < 0 || ie.vortex.strength > 10) && warnings.push("Vortex strength should be between 0 and 10 for optimal performance"), 
+        ie.vortex.radius && ie.vortex.radius < 0 && warnings.push("Vortex radius should be a positive number"), 
+        ie.vortex.decay && (ie.vortex.decay <= 0 || ie.vortex.decay > 1) && warnings.push("Vortex decay should be between 0 and 1")), 
+        // Validate chromatic aberration settings
+        ie.chromaticAberration && (ie.chromaticAberration.redShift && Math.abs(ie.chromaticAberration.redShift) > .1 && warnings.push("Chromatic red shift value seems unusually high (>0.1), verify this is intended"), 
+        ie.chromaticAberration.blueShift && Math.abs(ie.chromaticAberration.blueShift) > .1 && warnings.push("Chromatic blue shift value seems unusually high (>0.1), verify this is intended"), 
+        ie.chromaticAberration.edgeThreshold && (ie.chromaticAberration.edgeThreshold < 0 || ie.chromaticAberration.edgeThreshold > 1) && warnings.push("Chromatic edge threshold should be between 0 and 1")), 
+        // Validate mouse interaction settings
+        ie.mouseInteraction && ie.mouseInteraction.sensitivity && ie.mouseInteraction.sensitivity < 0 && warnings.push("Mouse sensitivity should be a positive number"), 
+        // Validate animation speed settings
+        ie.animationSpeed && (ie.animationSpeed.base && ie.animationSpeed.base <= 0 && warnings.push("Animation base speed should be greater than 0"), 
+        ie.animationSpeed.timeMultiplier && ie.animationSpeed.timeMultiplier <= 0 && warnings.push("Animation time multiplier should be greater than 0"));
     }
-    /**
-   * Log an info message
-   */    info(message, context) {
-        this.config.level < LogLevel.INFO || (this.config.enableConsole && console.info(`[ThemeInfo] ${message}`, context || {}), 
-        this.config.onInfo?.(message, context));
+    // Validate optimization settings
+        if (config.optimization) {
+        const opt = config.optimization;
+        // Validate responsive breakpoints
+                if (opt.responsive && opt.responsive.breakpoints) {
+            const breakpoints = opt.responsive.breakpoints;
+            breakpoints.mobile && !isValidCSSLength(breakpoints.mobile) && warnings.push("Mobile breakpoint value is not a valid CSS length"), 
+            breakpoints.tablet && !isValidCSSLength(breakpoints.tablet) && warnings.push("Tablet breakpoint value is not a valid CSS length"), 
+            breakpoints.desktop && !isValidCSSLength(breakpoints.desktop) && warnings.push("Desktop breakpoint value is not a valid CSS length"), 
+            breakpoints.wide && !isValidCSSLength(breakpoints.wide) && warnings.push("Wide breakpoint value is not a valid CSS length");
+        }
+        // Validate device scaling
+                if (opt.responsive && opt.responsive.deviceScaling) {
+            const scaling = opt.responsive.deviceScaling;
+            scaling.mobile && (scaling.mobile <= 0 || scaling.mobile > 1) && warnings.push("Mobile device scaling should be between 0 and 1"), 
+            scaling.tablet && (scaling.tablet <= 0 || scaling.tablet > 1) && warnings.push("Tablet device scaling should be between 0 and 1"), 
+            scaling.desktop && (scaling.desktop <= 0 || scaling.desktop > 1) && warnings.push("Desktop device scaling should be between 0 and 1");
+        }
+        // Validate performance settings
+                // Validate auto-scaling thresholds
+        if (opt.performance && opt.performance.fpsTarget && (opt.performance.fpsTarget <= 0 || opt.performance.fpsTarget > 240) && warnings.push("FPS target should be a reasonable value (typically 30-120)"), 
+        opt.autoScaling && opt.autoScaling.qualityThresholds) {
+            const thresholds = opt.autoScaling.qualityThresholds;
+            thresholds.lowEnd && (thresholds.lowEnd < 0 || thresholds.lowEnd > 1) && warnings.push("Auto-scaling low-end threshold should be between 0 and 1"), 
+            thresholds.midRange && (thresholds.midRange < 0 || thresholds.midRange > 1) && warnings.push("Auto-scaling mid-range threshold should be between 0 and 1"), 
+            thresholds.highEnd && (thresholds.highEnd < 0 || thresholds.highEnd > 1) && warnings.push("Auto-scaling high-end threshold should be between 0 and 1");
+        }
     }
-    /**
-   * Log a debug message
-   */    debug(message, context) {
-        this.config.level < LogLevel.DEBUG || (this.config.enableConsole, this.config.onDebug?.(message, context));
+    // Validate visual polish settings
+        if (config.visualPolish) {
+        const vp = config.visualPolish;
+        // Validate content aware blur settings
+                vp.contentAwareBlur && (void 0 !== vp.contentAwareBlur.edgePreservation && "boolean" != typeof vp.contentAwareBlur.edgePreservation && warnings.push("Content-aware blur edge preservation should be a boolean value"), 
+        void 0 !== vp.contentAwareBlur.depthDetection && "boolean" != typeof vp.contentAwareBlur.depthDetection && warnings.push("Content-aware blur depth detection should be a boolean value")), 
+        // Validate holographic effects settings
+        vp.holographicEffects && (void 0 !== vp.holographicEffects.enabled && "boolean" != typeof vp.holographicEffects.enabled && warnings.push("Holographic effects enabled should be a boolean value"), 
+        void 0 !== vp.holographicEffects.rainbowDiffraction && "boolean" != typeof vp.holographicEffects.rainbowDiffraction && warnings.push("Holographic rainbow diffraction should be a boolean value"));
     }
+    // Validate AI settings
+        var _context;
+    return config.ai && (config.ai.provider && !_includesInstanceProperty(_context = [ "openai", "anthropic" ]).call(_context, config.ai.provider) && warnings.push(`Unknown AI provider: "${config.ai.provider}". Supported: openai, anthropic`), 
+    config.ai.temperature && (config.ai.temperature < 0 || config.ai.temperature > 1) && warnings.push("AI temperature should be between 0 and 1"), 
+    config.ai.maxTokens && config.ai.maxTokens < 100 && warnings.push("AI maxTokens should typically be 100 or more"), 
+    config.ai.rateLimit && (config.ai.rateLimit.requests <= 0 && warnings.push("AI rate limit requests should be greater than 0"), 
+    config.ai.rateLimit.windowMs <= 0 && warnings.push("AI rate limit window should be greater than 0"))), 
+    // Validate telemetry settings
+    config.telemetry && config.telemetry.path && !config.telemetry.path.endsWith(".json") && warnings.push("Telemetry path should typically end with .json"), 
+    warnings;
 }
 
 /**
- * Default logger instance
- */ let defaultLogger = null;
+ * Helper function to validate CSS length values
+ */ function isValidCSSLength(value) {
+    return /^(\d+(\.\d+)?)(px|em|rem|%|vw|vh|vmin|vmax|cm|mm|in|pt|pc|ex|ch)?$/.test(value);
+}
 
 /**
- * Get or create default logger
- */ function getLogger() {
-    return defaultLogger || (defaultLogger = new ThemeLogger), defaultLogger;
+ * Load Atomix configuration from project root
+ *
+ * Attempts to load atomix.config.ts, atomix.config.js, or atomix.config.json from the current working directory.
+ * Falls back to default config if file doesn't exist.
+ *
+ * @param options - Loader options
+ * @returns Loaded configuration or default
+ *
+ * @example
+ * ```typescript
+ * import { loadAtomixConfig } from '@shohojdhara/atomix/config';
+ * import { createTheme } from '@shohojdhara/atomix/theme';
+ *
+ * const config = loadAtomixConfig();
+ * const theme = createTheme(config.theme?.tokens || {});
+ * ```
+ */ function loadAtomixConfig(options = {}) {
+    const {configPath: configPath, required: required = !1} = options, defaultConfig = {
+        prefix: "atomix",
+        theme: {
+            extend: {}
+        }
+    };
+    // Default config
+        // In browser environments, config loading is not supported
+    if ("undefined" != typeof window) {
+        if (required) throw new Error('Config loading requires Node.js file system access.\n\nSolutions:\n1. Provide tokens explicitly to createTheme():\n   const css = createTheme({ "--brand-primary": "#6366f1" });\n\n2. Use SSR framework (Next.js, Remix, Astro)\n\n3. Load config on server and pass to client\n\nSee examples/config-examples/browser-only.config.ts');
+        return defaultConfig;
+    }
+    // If a specific config path is provided, try to load it directly
+        if (configPath) return loadConfigAtPath(configPath, required, defaultConfig);
+    // Otherwise, try standard locations in order of preference
+        const possiblePaths = [ "atomix.config.ts", "atomix.config.js", "atomix.config.json" ];
+    for (const path of possiblePaths) {
+        const config = loadConfigAtPath(path, !1, defaultConfig);
+        // If we found a valid config, return it
+                if (JSON.stringify(config) !== JSON.stringify(defaultConfig)) return config;
+    }
+    // If no config file was found or all contained only defaults, return default config
+        if (required) throw new Error('No Atomix configuration file found in project root.\n\nExpected one of:\n  - atomix.config.ts (recommended)\n  - atomix.config.js\n  - atomix.config.json\n\nQuick Fix:\n1. Create a config file in your project root:\n   touch atomix.config.ts\n\n2. Add basic configuration:\n   import { defineConfig } from "@shohojdhara/atomix/config";\n   export default defineConfig({ prefix: "myapp" });\n\n3. Or copy an example:\n   cp node_modules/@shohojdhara/atomix/examples/config-examples/standard.config.ts ./atomix.config.ts');
+    return defaultConfig;
+}
+
+/**
+ * Helper function to load config from a specific path
+ */ function loadConfigAtPath(path, required, defaultConfig) {
+    try {
+        // Use dynamic import for ESM compatibility
+        const configModule = require(path), config = configModule.default || configModule;
+        // Validate it's an AtomixConfig
+        if (config && "object" == typeof config) return config;
+        throw new Error("Invalid config format");
+    } catch (error) {
+        if (required) throw new Error(`Failed to load config from ${path}: ${error.message}`);
+        // Return default config if not required
+                return defaultConfig;
+    }
 }
 
+/**
+ * Resolve config path
+ *
+ * Finds atomix.config.ts in the project, checking common locations.
+ * Returns null in browser environments where file system access is not available.
+ *
+ * This function is designed to help tools identify if a config exists without loading it.
+ *
+ * @param configPath - Optional custom path to check
+ * @returns Absolute path to config file or null if not found
+ */
 /**
  * Core Theme Functions
  *
- * Simplified theme system using DesignTokens only.
+ * Unified theme system that handles both DesignTokens and Theme objects.
  * Config-first approach: loads from atomix.config.ts when no input is provided.
+ * Config-first approach: loads advanced features from config when available.
  */
 /**
- * Create theme CSS from DesignTokens
+ * Create theme CSS from tokens or Theme object
  *
  * **Config-First Approach**: If no input is provided, loads from `atomix.config.ts`.
+ * Config file is required for automatic loading.
  *
- * @param input - DesignTokens (partial) or undefined (loads from config)
+ * @param input - DesignTokens (partial), Theme object, or undefined (loads from config)
  * @param options - CSS generation options (prefix is automatically read from config if not provided)
  * @returns CSS string with custom properties
  * @throws Error if config loading fails when no input is provided
  *
  * @example
  * ```typescript
- * // Loads from atomix.config.ts
+ * // Loads from atomix.config.ts (config file required)
  * const css = createTheme();
  *
  * // Using DesignTokens
@@ -21141,42 +21506,151 @@ class ThemeLogger {
  *   'spacing-4': '1rem',
  * });
  *
+ * // Using Theme object
+ * const theme = createThemeObject({ palette: { primary: { main: '#7c3aed' } } });
+ * const css = createTheme(theme);
+ *
  * // With custom options
  * const css = createTheme(undefined, { prefix: 'myapp', selector: ':root' });
  * ```
- */ function createTheme(input, options) {
-    // Validate options if provided
-    if (options?.prefix) {
-        const prefixPattern = /^[a-z][a-z0-9-]*$/;
-        if (!prefixPattern.test(options.prefix)) throw new ThemeError(`Invalid CSS variable prefix: "${options.prefix}". Prefix must start with a lowercase letter and contain only lowercase letters, numbers, and hyphens (e.g., "atomix", "my-app").`, ThemeErrorCode.THEME_VALIDATION_FAILED, {
-            prefix: options.prefix,
-            pattern: prefixPattern.toString()
-        });
-    }
-    // Validate selector if provided
-        if (options?.selector && ("string" != typeof options.selector || 0 === options.selector.trim().length)) throw new ThemeError(`Invalid CSS selector: "${options.selector}". Selector must be a non-empty string (e.g., ":root", ".my-theme").`, ThemeErrorCode.THEME_VALIDATION_FAILED, {
-        selector: options.selector
-    });
-    // Determine tokens based on input
-        let tokens;
-    if (input) {
-        // Validate input tokens structure
-        if ("object" != typeof input || null === input || Array.isArray(input)) throw new ThemeError(`Invalid tokens input. Expected an object with DesignTokens, but received: ${typeof input}.`, ThemeErrorCode.THEME_VALIDATION_FAILED, {
-            inputType: typeof input
-        });
-        // Use DesignTokens directly
-                tokens = input;
+ */
+function createTheme(input, options) {
+    let tokens, configPrefix;
+    // If no input provided, load from config (required)
+    if (input) 
+    // Convert Theme object to DesignTokens
+    tokens = !0 === input.__isJSTheme || input.palette && input.typography ? themeToDesignTokens(input) : input; else {
+        const configTokens = function() {
+            // Check if we're in a browser environment
+            if ("undefined" != typeof window) throw new Error("loadThemeFromConfigSync: Not available in browser environment. Config loading requires Node.js/SSR environment.");
+            // Use dynamic import to load the config loader
+            // This allows bundlers to handle external dependencies properly
+                        let loadAtomixConfig;
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const {loadAtomixConfig: loader} = require("../../config/loader");
+                loadAtomixConfig = loader;
+            } catch (error) {
+                throw new Error("Config loader module not available");
+            }
+            const config = loadAtomixConfig({
+                configPath: undefined,
+                required: !0
+            });
+            if (!config?.theme) return createTokens({});
+            if ((obj = config.theme) && "object" == typeof obj && (obj.palette || obj.typography || obj.spacing || obj.breakpoints || obj.colors)) return themeToDesignTokens(config.theme);
+            // Handle the config.theme object which has extend/tokens/themes properties
+            // Extract the actual tokens from the theme configuration
+                        // Helper type guard function
+            var obj;
+            const themeConfig = config.theme;
+            let tokensToApply = {};
+            return themeConfig.tokens ? 
+            // If tokens is provided, use it as the base
+            tokensToApply = themeConfig.tokens : themeConfig.extend && (
+            // If only extend is provided, use it as overrides
+            tokensToApply = themeConfig.extend), 
+            // Apply advanced feature configurations as tokens
+            config.interactiveEffects && (
+            // Vortex effects
+            config.interactiveEffects.vortex && (tokensToApply = {
+                ...tokensToApply,
+                "interactive-vortex-enabled": String(config.interactiveEffects.vortex.enabled ?? !1),
+                "interactive-vortex-strength": String(config.interactiveEffects.vortex.strength ?? .5),
+                "interactive-vortex-radius": String(config.interactiveEffects.vortex.radius ?? 100),
+                "interactive-vortex-decay": String(config.interactiveEffects.vortex.decay ?? .8)
+            }), 
+            // Chromatic aberration
+            config.interactiveEffects.chromaticAberration && (tokensToApply = {
+                ...tokensToApply,
+                "interactive-chromatic-enabled": String(config.interactiveEffects.chromaticAberration.enabled ?? !1),
+                "interactive-chromatic-mode": config.interactiveEffects.chromaticAberration.mode ?? "lateral",
+                "interactive-chromatic-red-shift": String(config.interactiveEffects.chromaticAberration.redShift ?? .02),
+                "interactive-chromatic-green-shift": String(config.interactiveEffects.chromaticAberration.greenShift ?? 0),
+                "interactive-chromatic-blue-shift": String(config.interactiveEffects.chromaticAberration.blueShift ?? -.02),
+                "interactive-chromatic-edge-only": String(config.interactiveEffects.chromaticAberration.edgeOnly ?? !1),
+                "interactive-chromatic-edge-threshold": String(config.interactiveEffects.chromaticAberration.edgeThreshold ?? .5)
+            }), 
+            // Mouse interaction
+            config.interactiveEffects.mouseInteraction && (tokensToApply = {
+                ...tokensToApply,
+                "interactive-mouse-sensitivity": String(config.interactiveEffects.mouseInteraction.sensitivity ?? 1),
+                "interactive-mouse-trail-effect": String(config.interactiveEffects.mouseInteraction.trailEffect ?? !1)
+            }), 
+            // Animation speed
+            config.interactiveEffects.animationSpeed && (tokensToApply = {
+                ...tokensToApply,
+                "interactive-animation-speed-base": String(config.interactiveEffects.animationSpeed.base ?? 1),
+                "interactive-animation-speed-multiplier": String(config.interactiveEffects.animationSpeed.timeMultiplier ?? 1)
+            })), 
+            // Apply optimization configurations as tokens
+            config.optimization && (
+            // Responsive breakpoints
+            config.optimization.responsive && (config.optimization.responsive.breakpoints && (tokensToApply = {
+                ...tokensToApply,
+                "optimization-breakpoint-mobile": config.optimization.responsive.breakpoints.mobile ?? "0px",
+                "optimization-breakpoint-tablet": config.optimization.responsive.breakpoints.tablet ?? "768px",
+                "optimization-breakpoint-desktop": config.optimization.responsive.breakpoints.desktop ?? "1024px",
+                "optimization-breakpoint-wide": config.optimization.responsive.breakpoints.wide ?? "1440px"
+            }), config.optimization.responsive.deviceScaling && (tokensToApply = {
+                ...tokensToApply,
+                "optimization-device-scaling-mobile": String(config.optimization.responsive.deviceScaling.mobile ?? .5),
+                "optimization-device-scaling-tablet": String(config.optimization.responsive.deviceScaling.tablet ?? .75),
+                "optimization-device-scaling-desktop": String(config.optimization.responsive.deviceScaling.desktop ?? 1)
+            })), 
+            // Performance settings
+            config.optimization.performance && (tokensToApply = {
+                ...tokensToApply,
+                "optimization-performance-fps-target": String(config.optimization.performance.fpsTarget ?? 60),
+                "optimization-auto-scaling-enabled": String(config.optimization.performance.autoScaling ?? !1)
+            }), 
+            // Auto-scaling settings
+            config.optimization.autoScaling && (tokensToApply = {
+                ...tokensToApply,
+                "optimization-auto-scaling-enabled": String(config.optimization.autoScaling.enabled ?? !1),
+                "optimization-auto-scaling-low-end": String(config.optimization.autoScaling.qualityThresholds?.lowEnd ?? .5),
+                "optimization-auto-scaling-mid-range": String(config.optimization.autoScaling.qualityThresholds?.midRange ?? .75),
+                "optimization-auto-scaling-high-end": String(config.optimization.autoScaling.qualityThresholds?.highEnd ?? 1)
+            })), 
+            // Apply visual polish configurations as tokens
+            config.visualPolish && (config.visualPolish.borders && (tokensToApply = {
+                ...tokensToApply,
+                "visual-polish-border-iridescent-glow": String(config.visualPolish.borders.iridescentGlow ?? !1),
+                "visual-polish-border-shimmer-effect": String(config.visualPolish.borders.shimmerEffect ?? !1),
+                "visual-polish-border-beveled-edges": String(config.visualPolish.borders.beveledEdges ?? !1),
+                "visual-polish-border-pulsing-glow": String(config.visualPolish.borders.pulsingGlow ?? !1)
+            }), config.visualPolish.contentAwareBlur && (tokensToApply = {
+                ...tokensToApply,
+                "visual-polish-content-aware-blur-enabled": String(config.visualPolish.contentAwareBlur.enabled ?? !1),
+                "visual-polish-content-aware-depth-detection": String(config.visualPolish.contentAwareBlur.depthDetection ?? !1),
+                "visual-polish-content-aware-edge-preservation": String(config.visualPolish.contentAwareBlur.edgePreservation ?? !1),
+                "visual-polish-content-aware-variable-radius": String(config.visualPolish.contentAwareBlur.variableRadius ?? !1)
+            }), config.visualPolish.holographicEffects && (tokensToApply = {
+                ...tokensToApply,
+                "visual-polish-holographic-enabled": String(config.visualPolish.holographicEffects.enabled ?? !1),
+                "visual-polish-holographic-rainbow-diffraction": String(config.visualPolish.holographicEffects.rainbowDiffraction ?? !1),
+                "visual-polish-holographic-scanline-animation": String(config.visualPolish.holographicEffects.scanlineAnimation ?? !1),
+                "visual-polish-holographic-grid-overlay": String(config.visualPolish.holographicEffects.gridOverlay ?? !1),
+                "visual-polish-holographic-data-stream": String(config.visualPolish.holographicEffects.dataStream ?? !1),
+                "visual-polish-holographic-pulse-rings": String(config.visualPolish.holographicEffects.pulseRings ?? !1)
+            })), createTokens(tokensToApply);
+        }();
+        // Get prefix from config
+                try {
+            // Use the imported function directly instead of require to avoid bundling issues
+            const config = loadAtomixConfig({
+                configPath: "atomix.config.ts",
+                required: !0
+            });
+            configPrefix = config?.prefix;
+        } catch (error) {
+            // Prefix loading failed, but tokens were loaded, so continue
+        }
+        tokens = configTokens;
     }
     // Merge with defaults and generate CSS
-     else 
-    // Auto-loading config from file system is removed for browser compatibility.
-    // If no input is provided, we return an empty theme (using defaults only) or user must provide tokens.
-    // This allows createTheme to be isomorphic.
-    // Warn in development if no input provided
-    "production" !== process.env.NODE_ENV && "undefined" != typeof window && console.warn("Atomix: createTheme() called without tokens. Using default tokens only."), 
-    tokens = {};
-    const allTokens = createTokens(tokens), prefix = options?.prefix ?? "atomix";
-    // Get prefix from options or use default
+        const allTokens = createTokens(tokens), prefix = options?.prefix ?? configPrefix ?? "atomix";
+    // Get prefix from options, config, or use default
         return generateCSSVariables$1(allTokens, {
         ...options,
         prefix: prefix
@@ -21390,46 +21864,179 @@ class ThemeLogger {
  */
 /**
  * Default storage key for theme persistence
- */ "undefined" != typeof process && process.env;
-
+ */
 /**
- * Check if code is running in a browser environment
+ * Theme System Error Handling
+ *
+ * Centralized error handling for the Atomix theme system.
+ * Provides custom error classes and logging utilities.
  */
-const isBrowser = () => "undefined" != typeof window && "undefined" != typeof document, isServer = () => !isBrowser(), sanitizePath = path => path.replace(/[<>"']/g, "").replace(/\.\./g, "").replace(/\/+/g, "/").replace(/^\/+|\/+$/g, "") // Trim leading/trailing slashes
-, buildThemePath = (themeName, basePath = "/themes", useMinified = !1, cdnPath = null) => {
-    // Validate theme name to prevent path injection
-    if (!isValidThemeName(themeName)) throw new ThemeError(`Invalid theme name: "${themeName}". Theme names must be lowercase alphanumeric with hyphens (e.g., "my-theme").`, ThemeErrorCode.INVALID_THEME_NAME, {
-        themeName: themeName,
-        pattern: /^[a-z0-9]+(-[a-z0-9]+)*$/
-    });
-    const fileName = `${themeName}${useMinified ? ".min.css" : ".css"}`;
-    return cdnPath ? `${sanitizePath(cdnPath)}/${fileName}` : `${sanitizePath(basePath)}/${fileName.replace(/^\//, "")}`;
-    // Sanitize basePath to prevent path injection
-}, applyThemeAttributes = (dataAttribute, themeName) => {
-    isServer() || (
-    // Set data attribute on body (with null check)
-    document.body && document.body.setAttribute(dataAttribute, themeName), 
-    // Also set on documentElement for broader compatibility
-    document.documentElement.setAttribute(dataAttribute, themeName));
-}, isValidThemeName = themeName => !(!themeName || "string" != typeof themeName) && /^[a-z0-9]+(-[a-z0-9]+)*$/.test(themeName), createLocalStorageAdapter = () => ({
-    getItem: key => {
-        if (isServer()) return null;
-        try {
-            return localStorage.getItem(key);
-        } catch {
-            return null;
-        }
-    },
-    setItem: (key, value) => {
-        if (!isServer()) try {
-            localStorage.setItem(key, value);
-        } catch {
-            // Silently fail if localStorage is not available
-        }
-    },
-    removeItem: key => {
-        if (!isServer()) try {
-            localStorage.removeItem(key);
+/**
+ * Theme error codes
+ */
+var ThemeErrorCode, LogLevel;
+
+"undefined" != typeof process && process.env, function(ThemeErrorCode) {
+    /** Theme not found in registry */
+    ThemeErrorCode.THEME_NOT_FOUND = "THEME_NOT_FOUND", 
+    /** Theme failed to load */
+    ThemeErrorCode.THEME_LOAD_FAILED = "THEME_LOAD_FAILED", 
+    /** Theme validation failed */
+    ThemeErrorCode.THEME_VALIDATION_FAILED = "THEME_VALIDATION_FAILED", 
+    /** Configuration loading failed */
+    ThemeErrorCode.CONFIG_LOAD_FAILED = "CONFIG_LOAD_FAILED", 
+    /** Configuration validation failed */
+    ThemeErrorCode.CONFIG_VALIDATION_FAILED = "CONFIG_VALIDATION_FAILED", 
+    /** Circular dependency detected */
+    ThemeErrorCode.CIRCULAR_DEPENDENCY = "CIRCULAR_DEPENDENCY", 
+    /** Missing dependency */
+    ThemeErrorCode.MISSING_DEPENDENCY = "MISSING_DEPENDENCY", 
+    /** Storage operation failed */
+    ThemeErrorCode.STORAGE_ERROR = "STORAGE_ERROR", 
+    /** Invalid theme name */
+    ThemeErrorCode.INVALID_THEME_NAME = "INVALID_THEME_NAME", 
+    /** CSS injection failed */
+    ThemeErrorCode.CSS_INJECTION_FAILED = "CSS_INJECTION_FAILED", 
+    /** Invalid color format */
+    ThemeErrorCode.INVALID_COLOR_FORMAT = "INVALID_COLOR_FORMAT", 
+    /** Missing required token */
+    ThemeErrorCode.MISSING_REQUIRED_TOKEN = "MISSING_REQUIRED_TOKEN", 
+    /** Accessibility contrast violation */
+    ThemeErrorCode.CONTRAST_VIOLATION = "CONTRAST_VIOLATION", 
+    /** Invalid token type */
+    ThemeErrorCode.INVALID_TOKEN_TYPE = "INVALID_TOKEN_TYPE", 
+    /** Unknown error */
+    ThemeErrorCode.UNKNOWN_ERROR = "UNKNOWN_ERROR";
+}(ThemeErrorCode || (ThemeErrorCode = {}));
+
+/**
+ * Custom error class for theme-related errors
+ */
+class ThemeError extends Error {
+    constructor(message, code = ThemeErrorCode.UNKNOWN_ERROR, context) {
+        super(message), this.name = "ThemeError", this.code = code, this.context = context, 
+        this.timestamp = Date.now(), 
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        Error.captureStackTrace && Error.captureStackTrace(this, ThemeError);
+    }
+    /**
+   * Convert error to JSON for logging
+   */    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            context: this.context,
+            timestamp: this.timestamp,
+            stack: this.stack
+        };
+    }
+}
+
+/**
+ * Log level
+ */ !function(LogLevel) {
+    LogLevel[LogLevel.ERROR = 0] = "ERROR", LogLevel[LogLevel.WARN = 1] = "WARN", LogLevel[LogLevel.INFO = 2] = "INFO", 
+    LogLevel[LogLevel.DEBUG = 3] = "DEBUG";
+}(LogLevel || (LogLevel = {}));
+
+/**
+ * Theme Logger
+ *
+ * Centralized logging for the theme system.
+ * Replaces console statements with structured logging.
+ */
+class ThemeLogger {
+    constructor(config = {}) {
+        this.config = {
+            level: config.level ?? ("undefined" != typeof process && "production" === process.env?.NODE_ENV ? LogLevel.WARN : LogLevel.INFO),
+            enableConsole: config.enableConsole ?? !0,
+            onError: config.onError,
+            onWarn: config.onWarn,
+            onInfo: config.onInfo,
+            onDebug: config.onDebug
+        };
+    }
+    /**
+   * Log an error
+   */    error(message, error, context) {
+        if (this.config.level < LogLevel.ERROR) return;
+        const errorObj = error instanceof Error ? error : new Error(message), themeError = error instanceof ThemeError ? error : new ThemeError(message, ThemeErrorCode.UNKNOWN_ERROR, context);
+        this.config.enableConsole && console.error(`[ThemeError] ${message}`, {
+            error: errorObj,
+            context: {
+                ...context,
+                ...themeError.context
+            },
+            code: themeError.code
+        }), this.config.onError?.(themeError, context);
+    }
+    /**
+   * Log a warning
+   */    warn(message, context) {
+        this.config.level < LogLevel.WARN || (this.config.enableConsole && console.warn(`[ThemeWarning] ${message}`, context || {}), 
+        this.config.onWarn?.(message, context));
+    }
+    /**
+   * Log an info message
+   */    info(message, context) {
+        this.config.level < LogLevel.INFO || (this.config.enableConsole && console.info(`[ThemeInfo] ${message}`, context || {}), 
+        this.config.onInfo?.(message, context));
+    }
+    /**
+   * Log a debug message
+   */    debug(message, context) {
+        this.config.level < LogLevel.DEBUG || (this.config.enableConsole, this.config.onDebug?.(message, context));
+    }
+}
+
+/**
+ * Default logger instance
+ */ let defaultLogger = null;
+
+/**
+ * Get or create default logger
+ */ function getLogger() {
+    return defaultLogger || (defaultLogger = new ThemeLogger), defaultLogger;
+}
+
+/**
+ * Check if code is running in a browser environment
+ */ const isBrowser = () => "undefined" != typeof window && "undefined" != typeof document, isServer = () => !isBrowser(), sanitizePath = path => path.replace(/[<>"']/g, "").replace(/\.\./g, "").replace(/\/+/g, "/").replace(/^\/+|\/+$/g, "") // Trim leading/trailing slashes
+, buildThemePath = (themeName, basePath = "/themes", useMinified = !1, cdnPath = null) => {
+    // Validate theme name to prevent path injection
+    if (!isValidThemeName(themeName)) throw new ThemeError(`Invalid theme name: "${themeName}". Theme names must be lowercase alphanumeric with hyphens (e.g., "my-theme").`, ThemeErrorCode.INVALID_THEME_NAME, {
+        themeName: themeName,
+        pattern: /^[a-z0-9]+(-[a-z0-9]+)*$/
+    });
+    const fileName = `${themeName}${useMinified ? ".min.css" : ".css"}`;
+    return cdnPath ? `${sanitizePath(cdnPath)}/${fileName}` : `${sanitizePath(basePath)}/${fileName.replace(/^\//, "")}`;
+    // Sanitize basePath to prevent path injection
+}, applyThemeAttributes = (dataAttribute, themeName) => {
+    isServer() || (
+    // Set data attribute on body (with null check)
+    document.body && document.body.setAttribute(dataAttribute, themeName), 
+    // Also set on documentElement for broader compatibility
+    document.documentElement.setAttribute(dataAttribute, themeName));
+}, isValidThemeName = themeName => !(!themeName || "string" != typeof themeName) && /^[a-z0-9]+(-[a-z0-9]+)*$/.test(themeName), createLocalStorageAdapter = () => ({
+    getItem: key => {
+        if (isServer()) return null;
+        try {
+            return localStorage.getItem(key);
+        } catch {
+            return null;
+        }
+    },
+    setItem: (key, value) => {
+        if (!isServer()) try {
+            localStorage.setItem(key, value);
+        } catch {
+            // Silently fail if localStorage is not available
+        }
+    },
+    removeItem: key => {
+        if (!isServer()) try {
+            localStorage.removeItem(key);
         } catch {
             // Silently fail
         }
@@ -21479,105 +22086,427 @@ const isBrowser = () => "undefined" != typeof window && "undefined" != typeof do
     }))
 });
 
+// ============================================================================
+// Theme Mode Switching
+// ============================================================================
 /**
- * Theme Utilities
+ * Switch between light and dark themes
  *
- * Helper utilities for working with themes, including color manipulation,
- * spacing helpers, and theme value accessors.
- */
+ * Automatically toggles a class on the root element and persists the choice.
+ *
+ * @param mode - Theme mode ('light', 'dark', or 'system')
+ * @param options - Configuration options
+ *
+ * @example
+ * ```typescript
+ * import { switchTheme } from '@shohojdhara/atomix/theme/utils';
+ *
+ * // Switch to dark mode
+ * switchTheme('dark');
+ *
+ * // Toggle between light/dark
+ * const current = getCurrentTheme();
+ * switchTheme(current === 'dark' ? 'light' : 'dark');
+ * ```
+ */ function switchTheme(mode, options = {}) {
+    const {selector: selector = ":root", storageKey: storageKey = "atomix-theme", enableTransition: enableTransition = !0, transitionDuration: transitionDuration = 300} = options, resolvedMode = "system" === mode ? getSystemTheme() : mode, root = ":root" === selector ? document.documentElement : document.querySelector(selector);
+    // Determine actual mode (resolve 'system')
+        if (root) {
+        // Add transition class if enabled
+        if (enableTransition) {
+            const htmlRoot = root;
+            htmlRoot.style.transition = `all ${transitionDuration}ms ease-in-out`, 
+            // Remove transition after it completes
+            setTimeout((() => {
+                htmlRoot.style.transition = "";
+            }), transitionDuration);
+        }
+        // Apply theme class
+                root.classList.remove("atomix-theme-light", "atomix-theme-dark"), root.classList.add(`atomix-theme-${resolvedMode}`), 
+        // Set data attribute for CSS selectors
+        root.setAttribute("data-theme", resolvedMode), 
+        // Persist choice
+        persistTheme(resolvedMode, {
+            storageKey: storageKey
+        }), 
+        // Dispatch custom event for listeners
+        window.dispatchEvent(new CustomEvent("atomix-theme-change", {
+            detail: {
+                mode: resolvedMode
+            }
+        }));
+    }
+}
+
+/**
+ * Toggle between light and dark themes
+ *
+ * @param options - Configuration options
+ * @returns The new theme mode
+ *
+ * @example
+ * ```typescript
+ * const newMode = toggleTheme();
+ * console.log('Switched to:', newMode);
+ * ```
+ */ function toggleTheme(options = {}) {
+    const next = "dark" === getCurrentTheme(options.storageKey) ? "light" : "dark";
+    return switchTheme(next, options), next;
+}
+
+/**
+ * Get current theme mode
+ *
+ * @param storageKey - Storage key (default: 'atomix-theme')
+ * @returns Current theme mode or 'light' if not set
+ */ function getCurrentTheme(storageKey = "atomix-theme") {
+    return "undefined" == typeof window ? "light" : localStorage.getItem(storageKey) || "light";
+}
+
+/**
+ * Get system theme preference
+ *
+ * @returns 'dark' if system prefers dark mode, 'light' otherwise
+ */ function getSystemTheme() {
+    return "undefined" == typeof window ? "light" : window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+}
+
+/**
+ * Initialize theme based on saved preference or system preference
+ *
+ * Call this once at app startup.
+ *
+ * @param options - Configuration options
+ * @returns The initialized theme mode
+ *
+ * @example
+ * ```typescript
+ * // In your app entry point
+ * import { initializeTheme } from '@shohojdhara/atomix/theme/utils';
+ *
+ * const theme = initializeTheme();
+ * console.log('Theme initialized:', theme);
+ * ```
+ */ function initializeTheme(options = {}) {
+    const saved = getCurrentTheme(options.storageKey);
+    // If no saved preference, use system preference
+        if (!saved || "system" === saved) {
+        const system = getSystemTheme();
+        return switchTheme(system, options), system;
+    }
+    // Use saved preference
+        return switchTheme(saved, options), saved;
+}
+
+/**
+ * Listen for system theme changes
+ *
+ * @param callback - Function to call when system theme changes
+ * @returns Cleanup function to stop listening
+ *
+ * @example
+ * ```typescript
+ * const cleanup = listenToSystemTheme((mode) => {
+ *   console.log('System theme changed to:', mode);
+ *   switchTheme(mode);
+ * });
+ *
+ * // Later, when component unmounts
+ * cleanup();
+ * ```
+ */ function listenToSystemTheme(callback) {
+    if ("undefined" == typeof window) return () => {};
+    const mediaQuery = window.matchMedia("(prefers-color-scheme: dark)"), handler = e => {
+        callback(e.matches ? "dark" : "light");
+    };
+    // Modern browsers
+    return mediaQuery.addEventListener ? (mediaQuery.addEventListener("change", handler), 
+    () => mediaQuery.removeEventListener("change", handler)) : (
+    // Fallback for older browsers
+    mediaQuery.addListener(handler), () => mediaQuery.removeListener(handler));
+}
+
+// ============================================================================
+// Theme Persistence
+// ============================================================================
+/**
+ * Save theme preference to storage
+ *
+ * @param mode - Theme mode to save
+ * @param options - Persistence options
+ */ function persistTheme(mode, options = {}) {
+    if ("undefined" == typeof window) return;
+    const {storageKey: storageKey = "atomix-theme", storageType: storageType = "localStorage"} = options;
+    ("localStorage" === storageType ? localStorage : sessionStorage).setItem(storageKey, mode);
+}
+
+/**
+ * Clear saved theme preference
+ *
+ * @param options - Persistence options
+ */ function clearThemePreference(options = {}) {
+    if ("undefined" == typeof window) return;
+    const {storageKey: storageKey = "atomix-theme", storageType: storageType = "localStorage"} = options;
+    ("localStorage" === storageType ? localStorage : sessionStorage).removeItem(storageKey);
+}
+
+// ============================================================================
+// Theme Tokens Manipulation
+// ============================================================================
+/**
+ * Merge multiple token sets
+ *
+ * Deep merges token objects, with later tokens overriding earlier ones.
+ *
+ * @param tokens - Token objects to merge
+ * @returns Merged tokens
+ *
+ * @example
+ * ```typescript
+ * const merged = mergeTokens(
+ *   baseTokens,
+ *   { colors: { primary: { main: '#custom' } } }
+ * );
+ * ```
+ */ function mergeTokens(...tokens) {
+    return _reduceInstanceProperty(tokens).call(tokens, ((acc, current) => deepMerge(acc, current)), {});
+}
+
+/**
+ * Override specific tokens
+ *
+ * Creates a new token object with specific overrides.
+ *
+ * @param base - Base tokens
+ * @param overrides - Tokens to override
+ * @returns New tokens with overrides applied
+ *
+ * @example
+ * ```typescript
+ * const customized = overrideTokens(defaultTokens, {
+ *   colors: {
+ *     primary: { main: '#ff0000' }
+ *   }
+ * });
+ * ```
+ */ function overrideTokens(base, overrides) {
+    return deepMerge({
+        ...base
+    }, overrides);
+}
+
+/**
+ * Pick specific token categories
+ *
+ * Extracts only the specified categories from tokens.
+ *
+ * @param tokens - Source tokens
+ * @param categories - Categories to pick
+ * @returns Tokens with only selected categories
+ *
+ * @example
+ * ```typescript
+ * const colorTokens = pickTokens(allTokens, ['colors']);
+ * ```
+ */ function pickTokens(tokens, categories) {
+    const result = {};
+    return categories.forEach((category => {
+        tokens[category] && (result[category] = tokens[category]);
+    })), result;
+}
+
+/**
+ * Omit specific token categories
+ *
+ * Removes specified categories from tokens.
+ *
+ * @param tokens - Source tokens
+ * @param categories - Categories to omit
+ * @returns Tokens without omitted categories
+ *
+ * @example
+ * ```typescript
+ * const withoutColors = omitTokens(allTokens, ['colors']);
+ * ```
+ */ function omitTokens(tokens, categories) {
+    const result = {
+        ...tokens
+    };
+    return categories.forEach((category => {
+        delete result[category];
+    })), result;
+}
+
 // ============================================================================
-// Color Manipulation Utilities
+// Color Utilities
 // ============================================================================
 /**
- * Convert hex color to RGB object
+ * Convert hex color to RGB
+ *
+ * @param hex - Hex color (with or without #)
+ * @returns RGB object { r, g, b }
  */ function hexToRgb$1(hex) {
-    const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
-    return result ? {
-        r: parseInt(result[1], 16),
-        g: parseInt(result[2], 16),
-        b: parseInt(result[3], 16)
-    } : null;
+    // Validate
+    if (
+    // Remove # if present
+    // Handle shorthand hex
+    3 === (hex = hex.replace(/^#/, "")).length && (hex = hex.split("").map((c => c + c)).join("")), 
+    6 !== hex.length) return null;
+    const num = parseInt(hex, 16);
+    return {
+        r: num >> 16 & 255,
+        g: num >> 8 & 255,
+        b: 255 & num
+    };
 }
 
 /**
- * Convert RGB to hex color
+ * Convert RGB to hex
+ *
+ * @param r - Red (0-255)
+ * @param g - Green (0-255)
+ * @param b - Blue (0-255)
+ * @returns Hex color with #
  */ function rgbToHex(r, g, b) {
-    const toHex = val => Math.round(Math.max(0, Math.min(255, val))).toString(16).padStart(2, "0");
-    return `#${toHex(r ?? 0)}${toHex(g ?? 0)}${toHex(b ?? 0)}`;
+    return "#" + [ r, g, b ].map((x => {
+        const hex = x.toString(16);
+        return 1 === hex.length ? "0" + hex : hex;
+    })).join("");
 }
 
 /**
- * Calculate relative luminance of a color
- * Used for determining contrast ratios
- */ function getLuminance(color) {
-    const rgb = hexToRgb$1(color);
+ * Calculate luminance of a color
+ *
+ * Used for determining contrast ratios.
+ *
+ * @param hex - Hex color
+ * @returns Luminance value (0-1)
+ */ function getLuminance(hex) {
+    const rgb = hexToRgb$1(hex);
     if (!rgb) return 0;
-    const {r: r, g: g, b: b} = rgb, [rs, gs, bs] = [ r ?? 0, g ?? 0, b ?? 0 ].map((c => {
-        const val = c / 255;
-        return val <= .03928 ? val / 12.92 : Math.pow((val + .055) / 1.055, 2.4);
-    }));
-    return .2126 * (rs ?? 0) + .7152 * (gs ?? 0) + .0722 * (bs ?? 0);
+    const [r, g, b] = [ rgb.r, rgb.g, rgb.b ].map((v => (v /= 255) <= .03928 ? v / 12.92 : Math.pow((v + .055) / 1.055, 2.4)));
+    return .2126 * (r ?? 0) + .7152 * (g ?? 0) + .0722 * (b ?? 0);
 }
 
 /**
  * Calculate contrast ratio between two colors
- */ function getContrastRatio(foreground, background) {
-    const lumA = getLuminance(foreground), lumB = getLuminance(background);
-    return (Math.max(lumA, lumB) + .05) / (Math.min(lumA, lumB) + .05);
+ *
+ * @param hex1 - First hex color
+ * @param hex2 - Second hex color
+ * @returns Contrast ratio (1-21)
+ */ function getContrastRatio(hex1, hex2) {
+    const lum1 = getLuminance(hex1), lum2 = getLuminance(hex2);
+    return (Math.max(lum1, lum2) + .05) / (Math.min(lum1, lum2) + .05);
 }
 
 /**
- * Get appropriate contrast text color (black or white) for a background color
- */ function getContrastText(background, threshold = 3) {
-    const contrastWithWhite = getContrastRatio("#FFFFFF", background), contrastWithBlack = getContrastRatio("#000000", background);
-    return contrastWithWhite >= threshold ? "#FFFFFF" : contrastWithBlack >= threshold ? "#000000" : contrastWithWhite > contrastWithBlack ? "#FFFFFF" : "#000000";
+ * Check if text color passes WCAG AA standard
+ *
+ * @param textColor - Text color hex
+ * @param backgroundColor - Background color hex
+ * @param size - Font size ('small' or 'large')
+ * @returns true if passes WCAG AA
+ */ function isAccessible(textColor, backgroundColor, size = "small") {
+    return getContrastRatio(textColor, backgroundColor) >= ("large" === size ? 3 : 4.5);
 }
 
 /**
- * Lighten a color by a given amount
+ * Get appropriate text color (black or white) for a background
  *
- * @param color - Hex color string
- * @param amount - Amount to lighten (0-1), default 0.2
+ * @param backgroundColor - Background hex color
+ * @param threshold - Contrast threshold (default: 3)
+ * @returns '#000000' or '#FFFFFF'
+ */ function getContrastText(backgroundColor, threshold = 3) {
+    return getContrastRatio(backgroundColor, "#FFFFFF") >= threshold ? "#FFFFFF" : "#000000";
+}
+
+/**
+ * Lighten a color
+ *
+ * @param hex - Base hex color
+ * @param amount - Amount to lighten (0-1)
  * @returns Lightened hex color
- */ function lighten(color, amount = .2) {
-    const rgb = hexToRgb$1(color);
-    if (!rgb) return color;
-    const {r: r, g: g, b: b} = rgb, lightenValue = val => Math.min(255, Math.round(val + (255 - val) * amount));
-    return rgbToHex(lightenValue(r), lightenValue(g), lightenValue(b));
+ */ function lighten(hex, amount = 0) {
+    const rgb = hexToRgb$1(hex);
+    if (!rgb) return hex;
+    // Use amount directly as factor (0-1)
+        const factor = Math.max(0, Math.min(1, amount)), r = Math.round(rgb.r + (255 - rgb.r) * factor), g = Math.round(rgb.g + (255 - rgb.g) * factor), b = Math.round(rgb.b + (255 - rgb.b) * factor);
+    return rgbToHex(Math.min(255, r), Math.min(255, g), Math.min(255, b));
 }
 
 /**
- * Darken a color by a given amount
+ * Darken a color
  *
- * @param color - Hex color string
- * @param amount - Amount to darken (0-1), default 0.2
+ * @param hex - Base hex color
+ * @param amount - Amount to darken (0-1)
  * @returns Darkened hex color
- */ function darken(color, amount = .2) {
-    const rgb = hexToRgb$1(color);
-    if (!rgb) return color;
-    const {r: r, g: g, b: b} = rgb, darkenValue = val => Math.max(0, Math.round(val * (1 - amount)));
-    return rgbToHex(darkenValue(r), darkenValue(g), darkenValue(b));
+ */ function darken(hex, amount = 0) {
+    const rgb = hexToRgb$1(hex);
+    if (!rgb) return hex;
+    // Use amount directly as factor (0-1)
+        const factor = Math.max(0, Math.min(1, amount)), r = Math.round(rgb.r * (1 - factor)), g = Math.round(rgb.g * (1 - factor)), b = Math.round(rgb.b * (1 - factor));
+    return rgbToHex(Math.max(0, r), Math.max(0, g), Math.max(0, b));
 }
 
 /**
- * Add alpha (opacity) to a color
+ * Add alpha to a color
  *
- * @param color - Hex color string
+ * @param hex - Hex color
  * @param opacity - Opacity value (0-1)
  * @returns RGBA color string
- */ function alpha(color, opacity) {
-    const rgb = hexToRgb$1(color);
-    if (!rgb) return color;
-    const {r: r, g: g, b: b} = rgb;
-    return `rgba(${r}, ${g}, ${b}, ${Math.max(0, Math.min(1, opacity))})`;
+ */ function alpha(hex, opacity) {
+    const rgb = hexToRgb$1(hex);
+    if (!rgb) return hex;
+    const validOpacity = Math.max(0, Math.min(1, opacity));
+    return `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${validOpacity})`;
 }
 
 /**
  * Emphasize a color (lighten if dark, darken if light)
  *
- * @param color - Hex color string
- * @param coefficient - Amount to emphasize (0-1), default 0.15
+ * @param hex - Hex color
+ * @param amount - Amount to emphasize (0-1)
  * @returns Emphasized hex color
+ */ function emphasize(hex, amount = .15) {
+    return getLuminance(hex) > .5 ? darken(hex, amount) : lighten(hex, amount);
+}
+
+/**
+ * Create a spacing utility
+ *
+ * @param spacingInput - Spacing configuration
+ * @returns Spacing function
+ */ function createSpacing(spacingInput = 4) {
+    return (...values) => 0 === values.length ? "0px" : "function" == typeof spacingInput ? spacingInput(...values) : values.map((value => {
+        if ("number" == typeof spacingInput) return value * spacingInput + "px";
+        if (Array.isArray(spacingInput)) {
+            const scaled = spacingInput[value];
+            return "number" == typeof scaled ? `${scaled}px` : `${value}px`;
+        }
+        return `${value}px`;
+    })).join(" ");
+}
+
+/**
+ * CSS Variable Generator
+ *
+ * Generates CSS custom properties from theme objects and injects them into the DOM.
+ *
+ * **Token Naming Alignment:**
+ * This generator produces CSS variables that match the SCSS token naming pattern exactly:
+ * - Colors: --atomix-primary, --atomix-primary-1 through --atomix-primary-10
+ * - Spacing: --atomix-spacing-1, --atomix-spacing-4, etc.
+ * - Typography: --atomix-font-size-base, --atomix-font-weight-normal, etc.
+ * - Shadows: --atomix-box-shadow, --atomix-box-shadow-sm, etc.
+ *
+ * All tokens follow the flat structure pattern used in SCSS (not nested like --atomix-palette-primary-main).
+ * This ensures compatibility between SCSS themes and JavaScript themes.
+ *
+ * @see src/styles/03-generic/_generic.root.scss for SCSS token definitions
+ */
+/**
+ * Convert a nested object to flat CSS variable declarations
+ * Uses iterative approach for better performance with large objects
  */
 /**
  * Generate a color scale from a base color (1-10 steps)
@@ -21645,18 +22574,7 @@ function generateCSSVariables(theme, options = {}) {
                                 color.dark && (vars[`${prefix}-${key}-hover`] = color.dark), 
                 // Generate semantic color variants (matches SCSS patterns)
                 // Text emphasis: emphasized version of the color for text (--atomix-primary-text-emphasis)
-                vars[`${prefix}-${key}-text-emphasis`] = function(color, coefficient = .15) {
-                    return getLuminance(color) > .5 ? darken(color, coefficient) : lighten(color, coefficient);
-                }
-                // ============================================================================
-                // Spacing Utilities
-                // ============================================================================
-                /**
- * Create a spacing function from various input types
- *
- * @param spacingInput - Spacing configuration (number, array, or function), default 4
- * @returns Spacing function
- */ (color.main, .15), 
+                vars[`${prefix}-${key}-text-emphasis`] = emphasize(color.main, .15), 
                 // Background subtle: very light version for backgrounds (--atomix-primary-bg-subtle)
                 vars[`${prefix}-${key}-bg-subtle`] = alpha(color.main, .1), 
                 // Border subtle: light version for borders (--atomix-primary-border-subtle)
@@ -22001,29 +22919,7 @@ function generateCSSVariables(theme, options = {}) {
                 return vars[`${prefix}-focus-ring-width`] = "3px", vars[`${prefix}-focus-ring-offset`] = "2px", 
         vars[`${prefix}-focus-ring-opacity`] = "0.25", vars;
     }(theme.palette, prefix)), theme.custom && Object.keys(theme.custom).length > 0) {
-        const customVars = 
-        /**
- * CSS Variable Generator
- *
- * Generates CSS custom properties from theme objects and injects them into the DOM.
- *
- * **Token Naming Alignment:**
- * This generator produces CSS variables that match the SCSS token naming pattern exactly:
- * - Colors: --atomix-primary, --atomix-primary-1 through --atomix-primary-10
- * - Spacing: --atomix-spacing-1, --atomix-spacing-4, etc.
- * - Typography: --atomix-font-size-base, --atomix-font-weight-normal, etc.
- * - Shadows: --atomix-box-shadow, --atomix-box-shadow-sm, etc.
- *
- * All tokens follow the flat structure pattern used in SCSS (not nested like --atomix-palette-primary-main).
- * This ensures compatibility between SCSS themes and JavaScript themes.
- *
- * @see src/styles/03-generic/_generic.root.scss for SCSS token definitions
- */
-        /**
- * Convert a nested object to flat CSS variable declarations
- * Uses iterative approach for better performance with large objects
- */
-        function(obj, prefix = "", result = {}) {
+        const customVars = function(obj, prefix = "", result = {}) {
             // Use iterative approach with stack to avoid deep recursion
             const stack = [ {
                 obj: obj,
@@ -22477,19 +23373,29 @@ const logger = getLogger(), ThemeProvider = ({children: children, defaultTheme:
         // Check storage first
         if (enablePersistence && storageAdapter.isAvailable()) {
             const stored = storageAdapter.getItem(storageKey);
-            if (stored) return stored;
+            if (stored) {
+                // If it looks like a JSON object, parse it
+                if (stored.trim().startsWith("{")) try {
+                    return JSON.parse(stored);
+                } catch (e) {
+                    return logger.error("Failed to parse stored theme tokens", e), stored;
+                }
+                return stored;
+            }
         }
         // If defaultTheme is provided, use it
                 return null != defaultTheme ? defaultTheme : "default";
         // Default fallback
         }), [ defaultTheme, enablePersistence, storageKey, storageAdapter ]), [currentTheme, setCurrentTheme] = React.useState((() => "string" == typeof initialDefaultTheme ? initialDefaultTheme : "tokens-theme")), [activeTokens, setActiveTokens] = React.useState((() => {
-        // If defaultTheme is DesignTokens, validate and store them
-        if (defaultTheme && "string" != typeof defaultTheme) {
+        // 1. Check if initialDefaultTheme (from storage) is an object
+        if (initialDefaultTheme && "string" != typeof initialDefaultTheme) {
+            const {tokens: tokens, validation: validation} = validateAndMergeTokens(initialDefaultTheme);
+            if (validation.valid) return tokens;
+        }
+        // 2. Check if defaultTheme prop is an object
+                if (defaultTheme && "string" != typeof defaultTheme) {
             const {tokens: tokens, validation: validation} = validateAndMergeTokens(defaultTheme);
-            return validation.valid ? tokens : (logger.warn("Invalid default theme tokens, using defaults", {
-                errors: validation.errors,
-                warnings: validation.warnings
-            }), createTokens({}));
+            if (validation.valid) return tokens;
         }
         return null;
     })), [isLoading, setIsLoading] = React.useState(!1), [error, setError] = React.useState(null), loadedThemesRef = React.useRef(new Set), themePromisesRef = React.useRef({}), abortControllerRef = React.useRef(null);
@@ -22501,10 +23407,14 @@ const logger = getLogger(), ThemeProvider = ({children: children, defaultTheme:
     React.useEffect((() => {
         isServer() || applyThemeAttributes(String(currentTheme), dataAttribute);
     }), [ currentTheme, dataAttribute ]), 
-    // Handle theme persistence
+    // Handle persistence
     React.useEffect((() => {
-        enablePersistence && storageAdapter.isAvailable() && storageAdapter.setItem(storageKey, String(currentTheme));
-    }), [ currentTheme, storageKey, enablePersistence, storageAdapter ]), 
+        enablePersistence && storageAdapter.isAvailable() && ("tokens-theme" === currentTheme ? 
+        // Only persist if we have actual tokens to store
+        activeTokens && storageAdapter.setItem(storageKey, JSON.stringify(activeTokens)) : 
+        // Persist named theme string
+        storageAdapter.setItem(storageKey, String(currentTheme)));
+    }), [ currentTheme, activeTokens, enablePersistence, storageKey, storageAdapter ]), 
     // Cleanup: Remove completed promises and abort controllers on unmount
     React.useEffect((() => () => {
         // Cancel any in-flight theme loads
@@ -22645,20 +23555,21 @@ const logger = getLogger(), ThemeProvider = ({children: children, defaultTheme:
                 setIsLoading(!1);
             }
         }
-    }), [ themes, isThemeLoaded, handleError, basePath, useMinified, cdnPath ]), themeManager = React.useMemo((() => ({})), []), availableThemes = React.useMemo((() => Object.entries(themes).map((([name, metadata]) => ({
+    }), [ themes, isThemeLoaded, handleError, basePath, useMinified, cdnPath ]), updateTheme = React.useCallback((async (sectionOrTokens, values) => setTheme("string" == typeof sectionOrTokens && values ? values : sectionOrTokens)), [ setTheme ]), themeManager = React.useMemo((() => ({})), []), availableThemes = React.useMemo((() => Object.entries(themes).map((([name, metadata]) => ({
         ...metadata,
         name: name
     })))), [ themes ]), contextValue = React.useMemo((() => ({
         theme: currentTheme,
         activeTokens: activeTokens,
         setTheme: setTheme,
+        updateTheme: updateTheme,
         availableThemes: availableThemes,
         isLoading: isLoading,
         error: error,
         isThemeLoaded: isThemeLoaded,
         preloadTheme: preloadTheme,
         themeManager: themeManager
-    })), [ currentTheme, activeTokens, setTheme, availableThemes, 
+    })), [ currentTheme, activeTokens, setTheme, updateTheme, availableThemes, 
     // Use memoized value
     isLoading, error, isThemeLoaded, preloadTheme, themeManager ]);
     // Check if theme is loaded
@@ -22712,6 +23623,7 @@ function useTheme() {
         theme: context.theme,
         activeTokens: context.activeTokens,
         setTheme: context.setTheme,
+        updateTheme: context.updateTheme,
         availableThemes: context.availableThemes,
         isLoading: context.isLoading,
         error: context.error,
@@ -22947,6 +23859,389 @@ function useThemeTokens() {
     }
 }
 
+/**
+ * useThemeSwitcher Hook
+ *
+ * React hook for managing theme switching with persistence and system preference detection.
+ * Provides an easy-to-use API for dark/light mode toggling.
+ *
+ * @example
+ * ```tsx
+ * import { useThemeSwitcher } from '@shohojdhara/atomix/theme';
+ *
+ * function ThemeToggle() {
+ *   const { mode, toggle, setMode, isDark } = useThemeSwitcher();
+ *
+ *   return (
+ *     <button onClick={toggle}>
+ *       {isDark ? '☀️ Light' : '🌙 Dark'}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+/**
+ * Hook for managing theme switching
+ *
+ * @param options - Configuration options
+ * @returns Theme switcher controls
+ */ function useThemeSwitcher(options = {}) {
+    const {initialMode: initialMode = "system", syncWithSystem: syncWithSystem = !1, storageKey: storageKey = "atomix-theme", enableTransition: enableTransition = !0, transitionDuration: transitionDuration = 300} = options, [mode, setModeState] = React.useState((() => {
+        if ("undefined" == typeof window) return initialMode;
+        // Check for saved preference first
+                const saved = getCurrentTheme(storageKey);
+        return saved && "system" !== saved ? saved : "system" === initialMode ? getSystemTheme() : initialMode;
+        // Fall back to initial mode or system
+        }));
+    // State for current mode
+        // Initialize theme on mount
+    return React.useEffect((() => {
+        "undefined" != typeof window && (
+        // Initialize with proper theme application
+        initializeTheme({
+            storageKey: storageKey,
+            enableTransition: enableTransition,
+            transitionDuration: transitionDuration
+        }), 
+        // Update state to match initialized theme
+        setModeState(getCurrentTheme(storageKey)));
+    }), [ storageKey, enableTransition, transitionDuration ]), 
+    // Listen for system theme changes if enabled
+    React.useEffect((() => {
+        if (syncWithSystem) return listenToSystemTheme((newMode => {
+            setModeState(newMode), switchTheme(newMode, {
+                storageKey: storageKey,
+                enableTransition: enableTransition,
+                transitionDuration: transitionDuration
+            });
+        }));
+    }), [ syncWithSystem, storageKey, enableTransition, transitionDuration ]), {
+        mode: mode,
+        isDark: "dark" === mode,
+        isLight: "light" === mode,
+        toggle: React.useCallback((() => {
+            const newMode = toggleTheme({
+                storageKey: storageKey,
+                enableTransition: enableTransition,
+                transitionDuration: transitionDuration
+            });
+            return setModeState(newMode), newMode;
+        }), [ storageKey, enableTransition, transitionDuration ]),
+        setMode: React.useCallback((newMode => {
+            switchTheme(newMode, {
+                storageKey: storageKey,
+                enableTransition: enableTransition,
+                transitionDuration: transitionDuration
+            }), setModeState(newMode);
+        }), [ storageKey, enableTransition, transitionDuration ]),
+        resetToSystem: React.useCallback((() => {
+            const systemMode = getSystemTheme();
+            switchTheme(systemMode, {
+                storageKey: storageKey,
+                enableTransition: enableTransition,
+                transitionDuration: transitionDuration
+            }), setModeState(systemMode);
+        }), [ storageKey, enableTransition, transitionDuration ]),
+        clearPreference: React.useCallback((() => {
+            "undefined" != typeof window && localStorage.removeItem(storageKey);
+        }), [ storageKey ])
+    };
+}
+
+/**
+ * ThemeToggle component with multiple variants
+ */ const ThemeToggle = ({className: className = "", showLabel: showLabel = !1, lightLabel: lightLabel = "Light", darkLabel: darkLabel = "Dark", iconSize: iconSize = 20, variant: variant = "icon", render: render, ariaLabel: ariaLabel = "Toggle theme", ...hookOptions}) => {
+    const {mode: mode, isDark: isDark, toggle: toggle} = useThemeSwitcher(hookOptions);
+    // Custom render
+        return render ? jsxRuntime.jsx(jsxRuntime.Fragment, {
+        children: render({
+            isDark: isDark,
+            toggle: toggle,
+            mode: mode
+        })
+    }) : 
+    // Icon-only variant (default)
+    "icon" === variant ? jsxRuntime.jsx("button", {
+        onClick: toggle,
+        className: `theme-toggle theme-toggle-icon ${className}`,
+        "aria-label": ariaLabel,
+        title: isDark ? darkLabel : lightLabel,
+        style: {
+            background: "none",
+            border: "none",
+            cursor: "pointer",
+            padding: "8px",
+            borderRadius: "50%",
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "center",
+            transition: "all 0.3s ease-in-out"
+        },
+        children: isDark ? jsxRuntime.jsxs("svg", {
+            width: iconSize,
+            height: iconSize,
+            viewBox: "0 0 24 24",
+            fill: "none",
+            stroke: "currentColor",
+            strokeWidth: "2",
+            strokeLinecap: "round",
+            strokeLinejoin: "round",
+            children: [ jsxRuntime.jsx("circle", {
+                cx: "12",
+                cy: "12",
+                r: "5"
+            }), jsxRuntime.jsx("line", {
+                x1: "12",
+                y1: "1",
+                x2: "12",
+                y2: "3"
+            }), jsxRuntime.jsx("line", {
+                x1: "12",
+                y1: "21",
+                x2: "12",
+                y2: "23"
+            }), jsxRuntime.jsx("line", {
+                x1: "4.22",
+                y1: "4.22",
+                x2: "5.64",
+                y2: "5.64"
+            }), jsxRuntime.jsx("line", {
+                x1: "18.36",
+                y1: "18.36",
+                x2: "19.78",
+                y2: "19.78"
+            }), jsxRuntime.jsx("line", {
+                x1: "1",
+                y1: "12",
+                x2: "3",
+                y2: "12"
+            }), jsxRuntime.jsx("line", {
+                x1: "21",
+                y1: "12",
+                x2: "23",
+                y2: "12"
+            }), jsxRuntime.jsx("line", {
+                x1: "4.22",
+                y1: "19.78",
+                x2: "5.64",
+                y2: "18.36"
+            }), jsxRuntime.jsx("line", {
+                x1: "18.36",
+                y1: "5.64",
+                x2: "19.78",
+                y2: "4.22"
+            }) ]
+        }) : jsxRuntime.jsx("svg", {
+            width: iconSize,
+            height: iconSize,
+            viewBox: "0 0 24 24",
+            fill: "none",
+            stroke: "currentColor",
+            strokeWidth: "2",
+            strokeLinecap: "round",
+            strokeLinejoin: "round",
+            children: jsxRuntime.jsx("path", {
+                d: "M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"
+            })
+        })
+    }) : 
+    // Button variant with text
+    "button" === variant ? jsxRuntime.jsxs("button", {
+        onClick: toggle,
+        className: `theme-toggle theme-toggle-button ${className}`,
+        "aria-label": ariaLabel,
+        style: {
+            display: "flex",
+            alignItems: "center",
+            gap: "8px",
+            padding: "8px 16px",
+            borderRadius: "8px",
+            border: "1px solid currentColor",
+            background: "transparent",
+            color: "inherit",
+            cursor: "pointer",
+            fontSize: "14px",
+            fontWeight: "500",
+            transition: "all 0.3s ease-in-out"
+        },
+        children: [ isDark ? jsxRuntime.jsxs("svg", {
+            width: iconSize,
+            height: iconSize,
+            viewBox: "0 0 24 24",
+            fill: "none",
+            stroke: "currentColor",
+            strokeWidth: "2",
+            strokeLinecap: "round",
+            strokeLinejoin: "round",
+            children: [ jsxRuntime.jsx("circle", {
+                cx: "12",
+                cy: "12",
+                r: "5"
+            }), jsxRuntime.jsx("line", {
+                x1: "12",
+                y1: "1",
+                x2: "12",
+                y2: "3"
+            }), jsxRuntime.jsx("line", {
+                x1: "12",
+                y1: "21",
+                x2: "12",
+                y2: "23"
+            }), jsxRuntime.jsx("line", {
+                x1: "4.22",
+                y1: "4.22",
+                x2: "5.64",
+                y2: "5.64"
+            }), jsxRuntime.jsx("line", {
+                x1: "18.36",
+                y1: "18.36",
+                x2: "19.78",
+                y2: "19.78"
+            }), jsxRuntime.jsx("line", {
+                x1: "1",
+                y1: "12",
+                x2: "3",
+                y2: "12"
+            }), jsxRuntime.jsx("line", {
+                x1: "21",
+                y1: "12",
+                x2: "23",
+                y2: "12"
+            }), jsxRuntime.jsx("line", {
+                x1: "4.22",
+                y1: "19.78",
+                x2: "5.64",
+                y2: "18.36"
+            }), jsxRuntime.jsx("line", {
+                x1: "18.36",
+                y1: "5.64",
+                x2: "19.78",
+                y2: "4.22"
+            }) ]
+        }) : jsxRuntime.jsx("svg", {
+            width: iconSize,
+            height: iconSize,
+            viewBox: "0 0 24 24",
+            fill: "none",
+            stroke: "currentColor",
+            strokeWidth: "2",
+            strokeLinecap: "round",
+            strokeLinejoin: "round",
+            children: jsxRuntime.jsx("path", {
+                d: "M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"
+            })
+        }), showLabel && jsxRuntime.jsx("span", {
+            children: isDark ? darkLabel : lightLabel
+        }) ]
+    }) : 
+    // Switch/toggle variant
+    "switch" === variant ? jsxRuntime.jsx("div", {
+        className: `theme-toggle theme-toggle-switch ${className}`,
+        role: "button",
+        tabIndex: 0,
+        onClick: toggle,
+        onKeyDown: e => "Enter" === e.key && toggle(),
+        "aria-label": ariaLabel,
+        style: {
+            position: "relative",
+            width: "56px",
+            height: "28px",
+            borderRadius: "14px",
+            background: isDark ? "#4b5563" : "#d1d5db",
+            cursor: "pointer",
+            transition: "background 0.3s ease-in-out",
+            display: "flex",
+            alignItems: "center",
+            padding: "2px"
+        },
+        children: jsxRuntime.jsx("div", {
+            style: {
+                position: "absolute",
+                left: isDark ? "auto" : "2px",
+                right: isDark ? "2px" : "auto",
+                width: "24px",
+                height: "24px",
+                borderRadius: "50%",
+                background: "white",
+                boxShadow: "0 2px 4px rgba(0, 0, 0, 0.2)",
+                transition: "all 0.3s ease-in-out",
+                display: "flex",
+                alignItems: "center",
+                justifyContent: "center"
+            },
+            children: isDark ? jsxRuntime.jsx("svg", {
+                width: "14",
+                height: "14",
+                viewBox: "0 0 24 24",
+                fill: "none",
+                stroke: "#4b5563",
+                strokeWidth: "2",
+                strokeLinecap: "round",
+                strokeLinejoin: "round",
+                children: jsxRuntime.jsx("path", {
+                    d: "M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"
+                })
+            }) : jsxRuntime.jsxs("svg", {
+                width: "14",
+                height: "14",
+                viewBox: "0 0 24 24",
+                fill: "none",
+                stroke: "#f59e0b",
+                strokeWidth: "2",
+                strokeLinecap: "round",
+                strokeLinejoin: "round",
+                children: [ jsxRuntime.jsx("circle", {
+                    cx: "12",
+                    cy: "12",
+                    r: "5"
+                }), jsxRuntime.jsx("line", {
+                    x1: "12",
+                    y1: "1",
+                    x2: "12",
+                    y2: "3"
+                }), jsxRuntime.jsx("line", {
+                    x1: "12",
+                    y1: "21",
+                    x2: "12",
+                    y2: "23"
+                }), jsxRuntime.jsx("line", {
+                    x1: "4.22",
+                    y1: "4.22",
+                    x2: "5.64",
+                    y2: "5.64"
+                }), jsxRuntime.jsx("line", {
+                    x1: "18.36",
+                    y1: "18.36",
+                    x2: "19.78",
+                    y2: "19.78"
+                }), jsxRuntime.jsx("line", {
+                    x1: "1",
+                    y1: "12",
+                    x2: "3",
+                    y2: "12"
+                }), jsxRuntime.jsx("line", {
+                    x1: "21",
+                    y1: "12",
+                    x2: "23",
+                    y2: "12"
+                }), jsxRuntime.jsx("line", {
+                    x1: "4.22",
+                    y1: "19.78",
+                    x2: "5.64",
+                    y2: "18.36"
+                }), jsxRuntime.jsx("line", {
+                    x1: "18.36",
+                    y1: "5.64",
+                    x2: "19.78",
+                    y2: "4.22"
+                }) ]
+            })
+        })
+    }) : null;
+};
+
+ThemeToggle.displayName = "ThemeToggle";
+
 /**
  * Theme Applicator
  *
@@ -22959,7 +24254,8 @@ function useThemeTokens() {
  * Theme applicator class for runtime theme application
  *
  * Uses the unified theme system for efficient CSS variable generation and injection.
- */ class ThemeApplicator {
+ */
+class ThemeApplicator {
     constructor(root = document.documentElement) {
         this.styleId = "atomix-theme-applicator", this.root = root;
     }
@@ -24698,13 +25994,13 @@ class ThemeValidator {
 function createPaletteColor(color) {
     return "string" == typeof color ? {
         main: color,
-        light: lighten(color),
-        dark: darken(color),
+        light: lighten(color, .15),
+        dark: darken(color, .15),
         contrastText: getContrastText(color)
     } : {
         main: color.main || "#000000",
-        light: color.light || lighten(color.main || "#000000"),
-        dark: color.dark || darken(color.main || "#000000"),
+        light: color.light || lighten(color.main || "#000000", .15),
+        dark: color.dark || darken(color.main || "#000000", .15),
         contrastText: color.contrastText || getContrastText(color.main || "#000000")
     };
 }
@@ -24739,23 +26035,19 @@ function createThemeObject(...options) {
         },
         background: {
             default: mergedOptions.palette?.background?.default || DEFAULT_PALETTE.background.default,
+            paper: mergedOptions.palette?.background?.paper || DEFAULT_PALETTE.background.paper,
             subtle: mergedOptions.palette?.background?.subtle || DEFAULT_PALETTE.background.subtle
         },
         text: {
             primary: mergedOptions.palette?.text?.primary || DEFAULT_PALETTE.text.primary,
             secondary: mergedOptions.palette?.text?.secondary || DEFAULT_PALETTE.text.secondary,
             disabled: mergedOptions.palette?.text?.disabled || DEFAULT_PALETTE.text.disabled
-        }
+        },
+        // Spread other palette properties
+        ...mergedOptions.palette
     }, typography = deepMerge({
         ...DEFAULT_TYPOGRAPHY
-    }, mergedOptions.typography || {}), spacing = function(spacingInput = 4) {
-        // If it's already a function, return it
-        return "function" == typeof spacingInput ? spacingInput : 
-        // If it's a number, create a function that multiplies by that number
-        "number" == typeof spacingInput ? (...values) => 0 === values.length ? "0px" : values.map((value => value * spacingInput + "px")).join(" ") : 
-        // If it's an array, use it as a scale
-        Array.isArray(spacingInput) ? (...values) => 0 === values.length ? "0px" : values.map((value => `${spacingInput[value] || value}px`)).join(" ") : (...values) => 0 === values.length ? "0px" : values.map((value => 4 * value + "px")).join(" ");
-    }(mergedOptions.spacing), breakpoints = function(breakpointsInput) {
+    }, mergedOptions.typography || {}), spacing = createSpacing(mergedOptions.spacing), breakpoints = function(breakpointsInput) {
         const values = {
             xs: 0,
             sm: 576,
@@ -25577,25 +26869,7 @@ const ThemeLiveEditor = ({initialTheme: initialTheme, onChange: onChange, classN
 
 /**
  * Design Tokens Customizer Component
- */
-/**
- * Theme Adapter
- *
- * Converts between Theme objects and DesignTokens.
- */
-/**
- * Convert DesignTokens to Theme-compatible CSS variables
- *
- * @param tokens - DesignTokens object
- * @returns CSS variables object compatible with Theme.cssVars
- */
-function designTokensToCSSVars(tokens) {
-    const cssVars = {};
-    return Object.entries(tokens).forEach((([key, value]) => {
-        void 0 !== value && (cssVars[`--atomix-${key}`] = String(value));
-    })), cssVars;
-}
-
+ */
 /**
  * Theme Helper Functions
  *
@@ -25608,7 +26882,8 @@ function designTokensToCSSVars(tokens) {
  *
  * @param value - Value to check
  * @returns True if value is DesignTokens
- */ function isDesignTokens(value) {
+ */
+function isDesignTokens(value) {
     if (!value || "object" != typeof value) return !1;
     // DesignTokens is a flat object with string keys, no nested structures
         const obj = value;
@@ -25620,6 +26895,335 @@ function designTokensToCSSVars(tokens) {
     // Check if keys look like DesignTokens (kebab-case, no nesting)
 }
 
+/**
+ * Performance monitor class
+ */ class PerformanceMonitor {
+    /**
+   * Create a new performance monitor
+   *
+   * @param config Configuration options
+   */
+    constructor(config) {
+        this.frameCount = 0, this.lastSampleTime = 0, this.lastFpsUpdate = 0, this.frameTimes = [], 
+        this.animationFrameId = null, this.isActive = !1, this.startTime = 0, this.config = {
+            fpsTarget: config?.fpsTarget ?? 60,
+            sampleInterval: config?.sampleInterval ?? 500,
+            onUpdate: config?.onUpdate ?? (() => {}),
+            onDegraded: config?.onDegraded ?? (() => {}),
+            enableMemoryMonitoring: config?.enableMemoryMonitoring ?? ("undefined" != typeof window && window.performance && window.performance.memory)
+        };
+    }
+    /**
+   * Start monitoring performance
+   */    start() {
+        this.isActive || (this.isActive = !0, this.frameCount = 0, this.lastSampleTime = performance.now(), 
+        this.lastFpsUpdate = this.lastSampleTime, this.frameTimes = [], this.startTime = this.lastSampleTime, 
+        this.animationFrameId = requestAnimationFrame(this.onFrame.bind(this)));
+    }
+    /**
+   * Stop monitoring performance
+   */    stop() {
+        this.animationFrameId && (cancelAnimationFrame(this.animationFrameId), this.animationFrameId = null), 
+        this.isActive = !1;
+    }
+    /**
+   * Get current performance metrics
+   */    getMetrics() {
+        var _context;
+        const now = performance.now(), elapsed = now - this.lastFpsUpdate, fps = elapsed > 0 ? Math.round(this.frameCount / elapsed * 1e3) : 0, avgFrameTime = this.frameTimes.length > 0 ? _reduceInstanceProperty(_context = this.frameTimes).call(_context, ((a, b) => a + b), 0) / this.frameTimes.length : 0, peakFrameTime = this.frameTimes.length > 0 ? Math.max(...this.frameTimes) : 0;
+        // Get memory stats if available
+        let memory;
+        if (this.config.enableMemoryMonitoring) {
+            const perf = window.performance;
+            perf && perf.memory && (memory = {
+                usedJSHeapSize: perf.memory.usedJSHeapSize,
+                totalJSHeapSize: perf.memory.totalJSHeapSize,
+                jsHeapSizeLimit: perf.memory.jsHeapSizeLimit
+            });
+        }
+        return {
+            fps: fps,
+            frameTime: avgFrameTime,
+            peakFrameTime: peakFrameTime,
+            memory: memory,
+            timestamp: now,
+            isDegraded: fps < .7 * this.config.fpsTarget
+        };
+    }
+    /**
+   * Get the current FPS
+   */    getFps() {
+        return this.getMetrics().fps;
+    }
+    /**
+   * Check if performance is degraded
+   */    isPerformanceDegraded() {
+        return this.getMetrics().isDegraded;
+    }
+    /**
+   * Private method called on each animation frame
+   */    onFrame(timestamp) {
+        if (!this.isActive) return;
+        // Calculate frame time
+                const frameTime = timestamp - this.lastSampleTime;
+        // Check if we need to update metrics
+        if (this.frameTimes.push(frameTime), 
+        // Keep only the last 60 frame times for averaging
+        this.frameTimes.length > 60 && this.frameTimes.shift(), this.frameCount++, this.lastSampleTime = timestamp, 
+        timestamp - this.lastFpsUpdate >= this.config.sampleInterval) {
+            const metrics = this.getMetrics();
+            // Call update callback
+                        this.config.onUpdate(metrics), 
+            // Check for degradation
+            metrics.isDegraded && this.config.onDegraded(metrics), 
+            // Reset counters
+            this.frameCount = 0, this.lastFpsUpdate = timestamp;
+        }
+        this.animationFrameId = requestAnimationFrame(this.onFrame.bind(this));
+    }
+    /**
+   * Run a performance test for a specific function
+   *
+   * @param fn Function to test
+   * @param iterations Number of iterations (default: 100)
+   * @returns Average execution time in ms
+   */    async testFunctionPerformance(fn, iterations = 100) {
+        const times = [];
+        for (let i = 0; i < iterations; i++) {
+            const start = performance.now();
+            fn();
+            const end = performance.now();
+            times.push(end - start);
+        }
+        return _reduceInstanceProperty(times).call(times, ((a, b) => a + b), 0) / times.length;
+    }
+}
+
+/**
+ * Create a performance monitor instance
+ *
+ * @param config Configuration options
+ * @returns PerformanceMonitor instance
+ *
+ * @example
+ * ```typescript
+ * import { createPerformanceMonitor } from '@shohojdhara/atomix/theme';
+ *
+ * const monitor = createPerformanceMonitor({
+ *   fpsTarget: 60,
+ *   onUpdate: (metrics) => console.log('FPS:', metrics.fps),
+ *   onDegraded: (metrics) => console.warn('Performance degraded!', metrics),
+ * });
+ *
+ * monitor.start();
+ *
+ * // Later...
+ * monitor.stop();
+ * ```
+ */ function createPerformanceMonitor(config) {
+    return new PerformanceMonitor(config);
+}
+
+/**
+ * Hook for React components to monitor performance
+ *
+ * @param config Configuration options
+ * @returns Performance metrics and monitor controls
+ *
+ * @example
+ * ```typescript
+ * import { usePerformanceMonitor } from '@shohojdhara/atomix/theme';
+ *
+ * function MyComponent() {
+ *   const { metrics, start, stop } = usePerformanceMonitor({ fpsTarget: 60 });
+ *
+ *   useEffect(() => {
+ *     start();
+ *     return () => stop();
+ *   }, []);
+ *
+ *   return <div>FPS: {metrics.fps}</div>;
+ * }
+ * ```
+ */ function usePerformanceMonitor(config) {
+    const [monitor] = React__default.default.useState((() => createPerformanceMonitor(config))), [metrics, setMetrics] = React__default.default.useState((() => "undefined" != typeof window ? monitor.getMetrics() : {
+        fps: 0,
+        frameTime: 0,
+        peakFrameTime: 0,
+        timestamp: 0,
+        isDegraded: !1
+    })), start = React__default.default.useCallback((() => {
+        "undefined" != typeof window && monitor.start();
+    }), [ monitor ]), stop = React__default.default.useCallback((() => {
+        "undefined" != typeof window && monitor.stop();
+    }), [ monitor ]);
+    return React__default.default.useEffect((() => {
+        if ("undefined" == typeof window) return;
+        // Update metrics when monitor callbacks fire
+                const originalOnUpdate = config?.onUpdate;
+        return monitor.config.onUpdate = newMetrics => {
+            setMetrics(newMetrics), originalOnUpdate?.(newMetrics);
+        }, () => {
+            monitor.stop();
+        };
+    }), [ monitor, config?.onUpdate ]), {
+        metrics: metrics,
+        start: start,
+        stop: stop
+    };
+}
+
+/**
+ * Responsive Utility for Atomix Theme System
+ *
+ * Provides responsive breakpoint detection and device-aware parameter scaling
+ * based on configuration from the advanced optimization features.
+ */
+/**
+ * Responsive utility class
+ */ class ResponsiveUtil {
+    constructor(config) {
+        this.currentDevice = "desktop", // Default
+        this.resizeHandler = null, this.observer = null, this.config = config, this.currentDevice = this.getCurrentDeviceType(), 
+        // Set up resize listener
+        this.setupResizeListener();
+    }
+    /**
+   * Get the current device type based on viewport width
+   */    getCurrentDeviceType() {
+        if ("undefined" == typeof window) return "desktop";
+ // SSR fallback
+                const width = window.innerWidth;
+        // Parse breakpoint values to numbers
+                this.parsePxValue(this.config.breakpoints.mobile);
+        const tabletWidth = this.parsePxValue(this.config.breakpoints.tablet), desktopWidth = this.parsePxValue(this.config.breakpoints.desktop), wideWidth = this.parsePxValue(this.config.breakpoints.wide);
+        return width < tabletWidth ? "mobile" : width < desktopWidth ? "tablet" : width < wideWidth ? "desktop" : "wide";
+    }
+    /**
+   * Get the scaling factor for the current device
+   */    getCurrentScalingFactor() {
+        // 'wide' devices use the same scaling as 'desktop'
+        const scalingKey = "wide" === this.currentDevice ? "desktop" : this.currentDevice;
+        return this.config.deviceScaling[scalingKey] || 1;
+    }
+    /**
+   * Scale a value based on the current device's scaling factor
+   */    scaleValue(value) {
+        return value * this.getCurrentScalingFactor();
+    }
+    /**
+   * Check if the current device matches a specific type
+   */    isDevice(device) {
+        return this.currentDevice === device;
+    }
+    /**
+   * Check if the current device is mobile or smaller
+   */    isMobileOrSmaller() {
+        return "mobile" === this.currentDevice;
+    }
+    /**
+   * Check if the current device is tablet or smaller
+   */    isTabletOrSmaller() {
+        return "mobile" === this.currentDevice || "tablet" === this.currentDevice;
+    }
+    /**
+   * Check if the current device is desktop or larger
+   */    isDesktopOrLarger() {
+        return "desktop" === this.currentDevice || "wide" === this.currentDevice;
+    }
+    /**
+   * Update the responsive configuration
+   */    updateConfig(config) {
+        this.config = config, this.currentDevice = this.getCurrentDeviceType();
+    }
+    /**
+   * Destroy the responsive utility and clean up listeners
+   */    destroy() {
+        this.resizeHandler && (window.removeEventListener("resize", this.resizeHandler), 
+        this.resizeHandler = null), this.observer && (this.observer.disconnect(), this.observer = null);
+    }
+    /**
+   * Parse a CSS value to pixels
+   */    parsePxValue(value) {
+        return value.endsWith("px") ? parseFloat(value.slice(0, -2)) : 
+        // For other units, we'll use a rough conversion assuming 16px base
+        value.endsWith("rem") ? 16 * parseFloat(value.slice(0, -3)) : value.endsWith("em") ? 16 * parseFloat(value.slice(0, -2)) : parseFloat(value) || 0;
+    }
+    /**
+   * Set up the resize listener
+   */    setupResizeListener() {
+        if ("undefined" == typeof window) return;
+        // Throttled resize handler
+                let resizeTimeout = null;
+        const handleResize = () => {
+            resizeTimeout && window.clearTimeout(resizeTimeout), resizeTimeout = window.setTimeout((() => {
+                const newDeviceType = this.getCurrentDeviceType();
+                newDeviceType !== this.currentDevice && (this.currentDevice = newDeviceType);
+            }), 150);
+        } // Throttle to 150ms
+        ;
+        this.resizeHandler = handleResize, window.addEventListener("resize", handleResize), 
+        // Also observe the document body for size changes
+        "undefined" != typeof ResizeObserver && (this.observer = new ResizeObserver(handleResize), 
+        this.observer.observe(document.body));
+    }
+}
+
+/**
+ * Create a responsive utility instance
+ *
+ * @param config Responsive configuration
+ * @returns ResponsiveUtil instance
+ */ function createResponsiveUtil(config) {
+    return new ResponsiveUtil(config);
+}
+
+/**
+ * Hook for React components to use responsive features
+ *
+ * @param config Responsive configuration
+ * @returns Current device type and utility functions
+ */ function useResponsive(config) {
+    const [util] = React__default.default.useState((() => createResponsiveUtil(config))), [deviceType, setDeviceType] = React__default.default.useState((() => "undefined" != typeof window ? util.getCurrentDeviceType() : "desktop"));
+    return React__default.default.useEffect((() => {
+        if ("undefined" == typeof window) return;
+        const handleResize = () => {
+            const newDeviceType = util.getCurrentDeviceType();
+            newDeviceType !== deviceType && setDeviceType(newDeviceType);
+        };
+        // Update device type on mount
+                return setDeviceType(util.getCurrentDeviceType()), 
+        // Listen for resize events
+        window.addEventListener("resize", handleResize), () => {
+            window.removeEventListener("resize", handleResize), util.destroy();
+        };
+    }), [ util, deviceType ]), "undefined" == typeof window ? {
+        deviceType: "desktop",
+        isMobile: !1,
+        isTablet: !1,
+        isDesktop: !0,
+        isWide: !1,
+        scaleValue: value => value,
+        getCurrentDeviceType: () => "desktop",
+        getCurrentScalingFactor: () => 1,
+        isMobileOrSmaller: () => !1,
+        isTabletOrSmaller: () => !0,
+        isDesktopOrLarger: () => !0
+    } : {
+        deviceType: deviceType,
+        isMobile: "mobile" === deviceType,
+        isTablet: "tablet" === deviceType,
+        isDesktop: "desktop" === deviceType,
+        isWide: "wide" === deviceType,
+        scaleValue: value => util.scaleValue(value),
+        getCurrentDeviceType: () => util.getCurrentDeviceType(),
+        getCurrentScalingFactor: () => util.getCurrentScalingFactor(),
+        isMobileOrSmaller: () => util.isMobileOrSmaller(),
+        isTabletOrSmaller: () => util.isTabletOrSmaller(),
+        isDesktopOrLarger: () => util.isDesktopOrLarger()
+    };
+}
+
 /**
  * RTL (Right-to-Left) Support Utilities
  *
@@ -25805,6 +27409,32 @@ class RTLManager {
     }
 }
 
+/**
+ * Create RTL manager instance
+ */ function createRTLManager(config) {
+    return new RTLManager(config);
+}
+
+/**
+ * Check if locale is RTL
+ */ function isRTLLocale(locale) {
+    return RTL_LOCALES.has(locale.toLowerCase());
+}
+
+/**
+ * Get direction from locale
+ */ function getDirectionFromLocale(locale) {
+    return isRTLLocale(locale) ? "rtl" : "ltr";
+}
+
+/**
+ * RTL-aware CSS helper
+ *
+ * Returns appropriate CSS based on direction
+ */ function rtlCSS(ltrCSS, rtlCSS, direction = "ltr") {
+    return "rtl" === direction ? rtlCSS : ltrCSS;
+}
+
 /**
  * Theme System Exports
  *
@@ -25827,8 +27457,6 @@ class RTLManager {
 // ============================================================================
 // Core Theme Functions
 // ============================================================================
-// Create theme CSS from DesignTokens
-// File saving utilities removed to prevent bundling Node.js modules in browser
 /**
  * Inject theme CSS into DOM
  */ function injectTheme(css, id = "atomix-theme") {
@@ -25841,6 +27469,115 @@ class RTLManager {
     removeCSS(id);
 }
 
+/**
+ * Main theme module interface
+ */ var index = {
+    // Core
+    createTheme: createTheme,
+    injectTheme: injectTheme,
+    removeTheme: removeTheme,
+    // Context and Provider
+    ThemeProvider: ThemeProvider,
+    useTheme: useTheme,
+    useThemeTokens: useThemeTokens,
+    ThemeContext: ThemeContext,
+    ThemeErrorBoundary: ThemeErrorBoundary,
+    // Adapters
+    configToTokens: configToTokens,
+    designTokensToCSSVars: designTokensToCSSVars,
+    // Theme Utils
+    switchTheme: switchTheme,
+    toggleTheme: toggleTheme,
+    getCurrentTheme: getCurrentTheme,
+    getSystemTheme: getSystemTheme,
+    initializeTheme: initializeTheme,
+    listenToSystemTheme: listenToSystemTheme,
+    persistTheme: persistTheme,
+    clearThemePreference: clearThemePreference,
+    // Token Manipulation
+    mergeTokens: mergeTokens,
+    overrideTokens: overrideTokens,
+    pickTokens: pickTokens,
+    omitTokens: omitTokens,
+    // Color Utilities
+    hexToRgb: hexToRgb$1,
+    rgbToHex: rgbToHex,
+    getLuminance: getLuminance,
+    getContrastRatio: getContrastRatio,
+    isAccessible: isAccessible,
+    getContrastText: getContrastText,
+    lighten: lighten,
+    darken: darken,
+    alpha: alpha,
+    emphasize: emphasize,
+    createSpacing: createSpacing,
+    // Performance utilities
+    createPerformanceMonitor: createPerformanceMonitor,
+    usePerformanceMonitor: usePerformanceMonitor,
+    // Responsive utilities
+    createResponsiveUtil: createResponsiveUtil,
+    useResponsive: useResponsive,
+    // Components
+    ThemeToggle: ThemeToggle,
+    ThemeApplicator: ThemeApplicator,
+    applyTheme: applyTheme,
+    getThemeApplicator: getThemeApplicator,
+    // Registry
+    createThemeRegistry: createThemeRegistry,
+    registerTheme: registerTheme,
+    unregisterTheme: unregisterTheme,
+    hasTheme: hasTheme,
+    getTheme: getTheme,
+    getAllThemes: getAllThemes,
+    getThemeIds: getThemeIds,
+    clearThemes: clearThemes,
+    getThemeCount: getThemeCount,
+    // Composition
+    deepMerge: deepMerge,
+    mergeTheme: mergeTheme,
+    extendTheme: extendTheme,
+    // Tokens
+    createTokens: createTokens,
+    defaultTokens: defaultTokens,
+    // Generators
+    generateCSSVariables: generateCSSVariables$1,
+    generateCSSVariablesForSelector: generateCSSVariablesForSelector,
+    // Naming
+    generateClassName: generateClassName,
+    generateCSSVariableName: generateCSSVariableName,
+    normalizeThemeTokens: normalizeThemeTokens,
+    camelToKebab: camelToKebab,
+    themePropertyToCSSVar: themePropertyToCSSVar,
+    // Component Theming
+    getComponentThemeValue: getComponentThemeValue,
+    generateComponentCSSVars: generateComponentCSSVars,
+    applyComponentTheme: applyComponentTheme,
+    useComponentTheme: useComponentTheme,
+    // Hooks
+    useThemeSwitcher: useThemeSwitcher,
+    // Helpers
+    isDesignTokens: isDesignTokens,
+    // CSS Variable Mapper
+    mapSCSSTokensToCSSVars: mapSCSSTokensToCSSVars,
+    applyCSSVariables: applyCSSVariables,
+    removeCSSVariables: removeCSSVariables,
+    getCSSVariable: getCSSVariable,
+    cssVarsToStyle: cssVarsToStyle,
+    mergeCSSVars: mergeCSSVars,
+    isValidCSSVariableName: isValidCSSVariableName,
+    extractComponentName: extractComponentName,
+    // Injection Utils
+    injectCSS: injectCSS$1,
+    removeCSS: removeCSS,
+    isCSSInjected: isCSSInjected,
+    // I18n
+    RTLManager: RTLManager,
+    createRTLManager: createRTLManager,
+    isRTLLocale: isRTLLocale,
+    getDirectionFromLocale: getDirectionFromLocale,
+    rtlCSS: rtlCSS
+};
+
 /**
  * CSS Variables Constants
  *
@@ -26147,6 +27884,122 @@ function mergePartStyles(base, override) {
  *   );
  * }
  */
+/**
+ * Configuration Validator
+ *
+ * Provides detailed validation and feedback for Atomix configurations,
+ * especially for advanced features (Phases 2, 3, and 4).
+ */
+/**
+ * Validate an Atomix configuration with detailed feedback
+ *
+ * @param config - The configuration to validate
+ * @param options - Validation options
+ * @returns Detailed validation result
+ *
+ * @example
+ * ```typescript
+ * import { validateConfiguration } from '@shohojdhara/atomix/config';
+ *
+ * const config = { /* your config *\/ };
+ * const result = validateConfiguration(config);
+ *
+ * if (!result.isValid) {
+ *   console.warn('Warnings:', result.warnings);
+ *   console.info('Suggestions:', result.suggestions);
+ * }
+ * ```
+ */
+function validateConfiguration(config, options) {
+    const {performanceAnalysis: performanceAnalysis = !0, compatibilityReport: compatibilityReport = !0} = options || {}, warnings = [], suggestions = [];
+    let performanceImpact = "low";
+    // Use the existing validation
+        const baseWarnings = validateConfig$1(config);
+    warnings.push(...baseWarnings), 
+    // Analyze advanced features for performance impact
+    performanceAnalysis && (performanceImpact = 
+    /**
+ * Analyze the performance impact of a configuration
+ */
+    function(config) {
+        let impactScore = 0;
+        // Analyze interactive effects
+                if (config.interactiveEffects) {
+            const ie = config.interactiveEffects;
+            ie.vortex?.enabled && (impactScore += 2), ie.chromaticAberration?.enabled && (impactScore += 1), 
+            ie.mouseInteraction?.trailEffect && (impactScore += 1), ie.mouseInteraction?.pressureSensitivity && (impactScore += 1);
+        }
+        // Analyze visual polish effects
+                if (config.visualPolish) {
+            const vp = config.visualPolish;
+            vp.borders?.iridescentGlow && (impactScore += 1), vp.borders?.shimmerEffect && (impactScore += 1), 
+            vp.contentAwareBlur?.enabled && (impactScore += 2), vp.holographicEffects?.enabled && (impactScore += 2), 
+            vp.holographicEffects?.scanlineAnimation && (impactScore += 1), vp.holographicEffects?.dataStream && (impactScore += 1), 
+            vp.holographicEffects?.pulseRings && (impactScore += 1);
+        }
+        // Analyze optimization settings
+                return config.optimization?.autoScaling?.enabled && (impactScore -= 1), 
+        impactScore >= 6 ? "high" : impactScore >= 3 ? "medium" : "low";
+    }
+    /**
+ * Generate suggestions based on the configuration
+ */ (config)), 
+    // Generate suggestions based on configuration
+    function(config, suggestions) {
+        // Suggest enabling performance optimizations if heavy effects are used
+        (config.interactiveEffects || config.visualPolish?.holographicEffects?.enabled) && (config.optimization?.autoScaling?.enabled || suggestions.push("Consider enabling auto-scaling in optimization settings to adjust effects based on device performance: optimization.autoScaling.enabled = true"), 
+        config.optimization?.performance?.fpsTarget || suggestions.push("Set a target FPS in optimization.performance.fpsTarget to ensure smooth performance when using interactive effects")), 
+        // Suggest responsive breakpoints if optimization is partially configured
+        config.optimization && !config.optimization.responsive && suggestions.push("Consider adding responsive breakpoints in optimization.responsive.breakpoints to adapt advanced effects based on device type"), 
+        // Suggest disabling heavy effects on lower-end devices
+        config.visualPolish?.holographicEffects?.enabled && suggestions.push("For better performance on lower-end devices, consider conditionally disabling holographic effects based on device capabilities"), 
+        // Suggest using content-aware blur with performance considerations
+        config.visualPolish?.contentAwareBlur?.enabled && suggestions.push("Content-aware blur can be expensive; consider setting a maximum blur radius or using simpler blur techniques for mobile devices"), 
+        // Suggest using chromatic aberration适度
+        config.interactiveEffects?.chromaticAberration?.enabled && (config.interactiveEffects.chromaticAberration.redShift && Math.abs(config.interactiveEffects.chromaticAberration.redShift) > .05 && suggestions.push("High chromatic aberration red shift values (>0.05) may cause discomfort for some users; consider reducing to improve accessibility"), 
+        config.interactiveEffects.chromaticAberration.blueShift && Math.abs(config.interactiveEffects.chromaticAberration.blueShift) > .05 && suggestions.push("High chromatic aberration blue shift values (>0.05) may cause discomfort for some users; consider reducing to improve accessibility"));
+    }
+    /**
+ * Generate a compatibility report for the configuration
+ */ (config, suggestions);
+    // Determine overall validity
+    const isValid = 0 === warnings.length, compatibility = compatibilityReport ? function(config) {
+        return {
+            browsers: !(config.visualPolish?.holographicEffects?.enabled || config.visualPolish?.contentAwareBlur?.enabled || config.interactiveEffects?.vortex?.enabled || config.interactiveEffects?.chromaticAberration?.enabled),
+            // May have issues on older browsers
+            ssr: !0,
+            // Works fine with SSR
+            frameworks: [ "react", "vue", "angular", "svelte", "vanillajs" ]
+        };
+    }
+    /**
+ * Print a detailed configuration report to the console
+ *
+ * @param config - The configuration to analyze
+ * @param title - Optional title for the report
+ *
+ * @example
+ * ```typescript
+ * import { printConfigReport } from '@shohojdhara/atomix/config';
+ *
+ * const config = { /* your config *\/ };
+ * printConfigReport(config, 'My Application Config');
+ * ```
+ */ (config) : {
+        browsers: !0,
+        ssr: !0,
+        frameworks: [ "react", "vue", "angular", "svelte", "vanillajs" ]
+    };
+    // Generate compatibility report
+        return {
+        isValid: isValid,
+        warnings: warnings,
+        suggestions: suggestions,
+        performanceImpact: performanceImpact,
+        compatibility: compatibility
+    };
+}
+
 // Import and re-export as namespaces with proper typing
 // Export as namespaces with explicit typing
 const composables = composablesImport, utils = utilsImport, types = typesImport, constants = constantsImport, theme =  Object.freeze({
@@ -26161,19 +28014,30 @@ const composables = composablesImport, utils = utilsImport, types = typesImport,
     ThemeLiveEditor: ThemeLiveEditor,
     ThemePreview: ThemePreview,
     ThemeProvider: ThemeProvider,
+    ThemeToggle: ThemeToggle,
     ThemeValidator: ThemeValidator,
+    alpha: alpha,
     applyCSSVariables: applyCSSVariables,
     applyComponentTheme: applyComponentTheme,
     applyTheme: applyTheme,
     camelToKebab: camelToKebab,
+    clearThemePreference: clearThemePreference,
     clearThemes: clearThemes,
+    configToTokens: configToTokens,
+    createPerformanceMonitor: createPerformanceMonitor,
+    createRTLManager: createRTLManager,
+    createResponsiveUtil: createResponsiveUtil,
+    createSpacing: createSpacing,
     createTheme: createTheme,
     createThemeRegistry: createThemeRegistry,
     createTokens: createTokens,
     cssVarsToStyle: cssVarsToStyle,
+    darken: darken,
     deepMerge: deepMerge,
+    default: index,
     defaultTokens: defaultTokens,
     designTokensToCSSVars: designTokensToCSSVars,
+    emphasize: emphasize,
     extendTheme: extendTheme,
     extractComponentName: extractComponentName,
     generateCSSVariableName: generateCSSVariableName,
@@ -26184,29 +28048,53 @@ const composables = composablesImport, utils = utilsImport, types = typesImport,
     getAllThemes: getAllThemes,
     getCSSVariable: getCSSVariable,
     getComponentThemeValue: getComponentThemeValue,
+    getContrastRatio: getContrastRatio,
+    getContrastText: getContrastText,
+    getCurrentTheme: getCurrentTheme,
+    getDirectionFromLocale: getDirectionFromLocale,
+    getLuminance: getLuminance,
+    getSystemTheme: getSystemTheme,
     getTheme: getTheme,
     getThemeApplicator: getThemeApplicator,
     getThemeCount: getThemeCount,
     getThemeIds: getThemeIds,
     hasTheme: hasTheme,
+    hexToRgb: hexToRgb$1,
+    initializeTheme: initializeTheme,
     injectCSS: injectCSS$1,
     injectTheme: injectTheme,
+    isAccessible: isAccessible,
     isCSSInjected: isCSSInjected,
     isDesignTokens: isDesignTokens,
+    isRTLLocale: isRTLLocale,
     isValidCSSVariableName: isValidCSSVariableName,
+    lighten: lighten,
+    listenToSystemTheme: listenToSystemTheme,
     mapSCSSTokensToCSSVars: mapSCSSTokensToCSSVars,
     mergeCSSVars: mergeCSSVars,
     mergeTheme: mergeTheme,
+    mergeTokens: mergeTokens,
     normalizeThemeTokens: normalizeThemeTokens,
+    omitTokens: omitTokens,
+    overrideTokens: overrideTokens,
+    persistTheme: persistTheme,
+    pickTokens: pickTokens,
     registerTheme: registerTheme,
     removeCSS: removeCSS,
     removeCSSVariables: removeCSSVariables,
     removeTheme: removeTheme,
+    rgbToHex: rgbToHex,
+    rtlCSS: rtlCSS,
+    switchTheme: switchTheme,
     themePropertyToCSSVar: themePropertyToCSSVar,
+    toggleTheme: toggleTheme,
     unregisterTheme: unregisterTheme,
     useComponentTheme: useComponentTheme,
     useHistory: useHistory,
+    usePerformanceMonitor: usePerformanceMonitor,
+    useResponsive: useResponsive,
     useTheme: useTheme,
+    useThemeSwitcher: useThemeSwitcher,
     useThemeTokens: useThemeTokens
 }), atomix = {
     // Re-export all components and utilities
@@ -26274,10 +28162,11 @@ exports.TYPEDBUTTON = TYPEDBUTTON, exports.Tabs = Tabs, exports.Testimonial = Te
 exports.Textarea = Textarea, exports.ThemeApplicator = ThemeApplicator, exports.ThemeComparator = ThemeComparator, 
 exports.ThemeContext = ThemeContext, exports.ThemeErrorBoundary = ThemeErrorBoundary, 
 exports.ThemeInspector = ThemeInspector, exports.ThemeLiveEditor = ThemeLiveEditor, 
-exports.ThemePreview = ThemePreview, exports.ThemeProvider = ThemeProvider, exports.ThemeValidator = ThemeValidator, 
-exports.Todo = Todo, exports.Toggle = Toggle, exports.Tooltip = Tooltip, exports.TreemapChart = TreemapChart, 
-exports.UPLOAD = UPLOAD, exports.Upload = Upload, exports.VIDEO_PLAYER = VIDEO_PLAYER, 
-exports.VideoPlayer = VideoPlayer, exports.WaterfallChart = WaterfallChart, exports.applyCSSVariables = applyCSSVariables, 
+exports.ThemePreview = ThemePreview, exports.ThemeProvider = ThemeProvider, exports.ThemeToggle = ThemeToggle, 
+exports.ThemeValidator = ThemeValidator, exports.Todo = Todo, exports.Toggle = Toggle, 
+exports.Tooltip = Tooltip, exports.TreemapChart = TreemapChart, exports.UPLOAD = UPLOAD, 
+exports.Upload = Upload, exports.VIDEO_PLAYER = VIDEO_PLAYER, exports.VideoPlayer = VideoPlayer, 
+exports.WaterfallChart = WaterfallChart, exports.alpha = alpha, exports.applyCSSVariables = applyCSSVariables, 
 exports.applyCSSVarsToStyle = 
 /**
  * Utility to apply CSS variables to style object
@@ -26291,60 +28180,16 @@ function(cssVars, baseStyle) {
     };
 }
 /**
- * Atomix Configuration System
- *
- * Tailwind-like configuration for customizing the Atomix Design System.
- *
- * External developers can create `atomix.config.ts` in their project root
- * to customize design tokens, similar to Tailwind's tailwind.config.js
- *
- * @example
- * ```typescript
- * // atomix.config.ts (in your project)
- * import { defineConfig } from '@shohojdhara/atomix/config';
- *
- * export default defineConfig({
- *   theme: {
- *     extend: {
- *       colors: {
- *         primary: { main: '#7AFFD7' },
- *       },
- *     },
- *   },
- * });
- * ```
- */
-/**
- * Helper function to define Atomix configuration with type safety
+ * Configuration Types
  *
- * @param config - Atomix configuration object
- * @returns The configuration object
+ * Type definitions for the Atomix configuration system.
  */
 /**
  * Helper function to define Atomix configuration with type safety
- *
- * Similar to Tailwind's defineConfig, provides autocomplete and type checking.
- *
- * @param config - Atomix configuration object
- * @returns The configuration object
- *
- * @example
- * ```typescript
- * import { defineConfig } from '@shohojdhara/atomix/config';
- *
- * export default defineConfig({
- *   theme: {
- *     extend: {
- *       colors: {
- *         primary: { main: '#7AFFD7' },
- *       },
- *     },
- *   },
- * });
- * ```
  */ , exports.applyComponentTheme = applyComponentTheme, exports.applyPartStyles = applyPartStyles, 
-exports.applyTheme = applyTheme, exports.camelToKebab = camelToKebab, exports.clearThemes = clearThemes, 
-exports.composables = composables, exports.constants = constants, exports.createBreakpoints = createBreakpoints$1, 
+exports.applyTheme = applyTheme, exports.camelToKebab = camelToKebab, exports.clearThemePreference = clearThemePreference, 
+exports.clearThemes = clearThemes, exports.composables = composables, exports.configToTokens = configToTokens, 
+exports.constants = constants, exports.createBreakpoints = createBreakpoints$1, 
 exports.createCSSVarStyle = createCSSVarStyle, exports.createDarkVariant = 
 /**
  * Create a dark theme variant from a light theme
@@ -26401,7 +28246,9 @@ function(lightTheme) {
 /**
  * Validate theme structure
  */ , exports.createDebugAttrs = createDebugAttrs, exports.createFontPreloadLink = createFontPreloadLink, 
-exports.createPartProps = createPartProps, exports.createSlotComponent = 
+exports.createPartProps = createPartProps, exports.createPerformanceMonitor = createPerformanceMonitor, 
+exports.createRTLManager = createRTLManager, exports.createResponsiveUtil = createResponsiveUtil, 
+exports.createSlotComponent = 
 /**
  * Create a slot wrapper component
  *
@@ -26439,11 +28286,13 @@ function(defaultElement = "div") {
 }
 /**
  * Hook to manage slot rendering
- */ , exports.createTheme = createTheme, exports.createThemeRegistry = createThemeRegistry, 
-exports.createTokens = createTokens, exports.cssVarsToStyle = cssVarsToStyle, exports.deepMerge = deepMerge, 
+ */ , exports.createSpacing = createSpacing, exports.createTheme = createTheme, 
+exports.createThemeRegistry = createThemeRegistry, exports.createTokens = createTokens, 
+exports.cssVarsToStyle = cssVarsToStyle, exports.darken = darken, exports.deepMerge = deepMerge, 
 exports.default = atomix, exports.defaultTokens = defaultTokens, exports.defineConfig = function(config) {
     return config;
-}, exports.designTokensToCSSVars = designTokensToCSSVars, exports.exportTheme = 
+}, exports.designTokensToCSSVars = designTokensToCSSVars, exports.emphasize = emphasize, 
+exports.exportTheme = 
 /**
  * Export theme as JSON
  */
@@ -26463,9 +28312,12 @@ exports.getAllThemes = getAllThemes, exports.getCSSVariable = getCSSVariable, ex
  */
 function(component) {
     return COMPONENT_CSS_VARS[component];
-}, exports.getComponentThemeValue = getComponentThemeValue, exports.getDefaultBreakpoints = getDefaultBreakpoints, 
-exports.getDevicePreset = getDevicePreset, exports.getMobileOptimizedParams = getMobileOptimizedParams, 
-exports.getPartStyles = getPartStyles, exports.getQualityMultipliers = getQualityMultipliers, 
+}, exports.getComponentThemeValue = getComponentThemeValue, exports.getContrastRatio = getContrastRatio, 
+exports.getContrastText = getContrastText, exports.getCurrentTheme = getCurrentTheme, 
+exports.getDefaultBreakpoints = getDefaultBreakpoints, exports.getDevicePreset = getDevicePreset, 
+exports.getDirectionFromLocale = getDirectionFromLocale, exports.getLuminance = getLuminance, 
+exports.getMobileOptimizedParams = getMobileOptimizedParams, exports.getPartStyles = getPartStyles, 
+exports.getQualityMultipliers = getQualityMultipliers, exports.getSystemTheme = getSystemTheme, 
 exports.getTheme = getTheme, exports.getThemeApplicator = getThemeApplicator, exports.getThemeCount = getThemeCount, 
 exports.getThemeIds = getThemeIds, exports.getThemeMetadata = 
 /**
@@ -26486,7 +28338,7 @@ function(theme) {
 /**
  * Check if theme supports dark mode
  */ , exports.hasCustomization = hasCustomization, exports.hasTheme = hasTheme, 
-exports.importTheme = function(json) {
+exports.hexToRgb = hexToRgb$1, exports.importTheme = function(json) {
     try {
         return JSON.parse(json);
     } catch (error) {
@@ -26497,15 +28349,49 @@ exports.importTheme = function(json) {
 // are already exported from './theme' module. Import them directly from there.
 // This file only exports theme-tools specific utilities.
 // Export all components individually for better tree-shaking
-, exports.injectCSS = injectCSS$1, exports.injectTheme = injectTheme, exports.isCSSInjected = isCSSInjected, 
-exports.isDesignTokens = isDesignTokens, exports.isSlot = function(value) {
+, exports.initializeTheme = initializeTheme, exports.injectCSS = injectCSS$1, exports.injectTheme = injectTheme, 
+exports.isAccessible = isAccessible, exports.isCSSInjected = isCSSInjected, exports.isDesignTokens = isDesignTokens, 
+exports.isRTLLocale = isRTLLocale, exports.isSlot = function(value) {
     return "object" == typeof value && null !== value && ("render" in value || "component" in value || "children" in value);
 }
 /**
  * Merge multiple slot configurations
  * Later slots override earlier ones
  */ , exports.isValidCSSVariableName = isValidCSSVariableName, exports.isYouTubeUrl = isYouTubeUrl, 
-exports.mapSCSSTokensToCSSVars = mapSCSSTokensToCSSVars, exports.mergeCSSVars = mergeCSSVars, 
+exports.lighten = lighten, exports.listenToSystemTheme = listenToSystemTheme, exports.loadAtomixConfig = loadAtomixConfig, 
+exports.loadConfig = 
+/**
+ * Public API for loading and managing Atomix configuration
+ *
+ * This module provides the public-facing API for configuration loading
+ * in external projects.
+ */
+/**
+ * Load Atomix configuration from an external project.
+ *
+ * @param options - Loading options
+ * @returns The loaded configuration
+ *
+ * @example
+ * ```typescript
+ * import { loadConfig } from '@shohojdhara/atomix/config';
+ *
+ * const config = loadConfig();
+ * console.log(config.prefix); // 'atomix' or user's custom prefix
+ * ```
+ */
+function(options) {
+    return loadAtomixConfig({
+        configPath: options?.configPath,
+        required: options?.required ?? !1
+    });
+}
+/**
+ * Validate Atomix configuration structure.
+ *
+ * @param config - Configuration object to validate
+ * @returns Array of validation warnings (empty if valid)
+ */ , exports.mapSCSSTokensToCSSVars = mapSCSSTokensToCSSVars, exports.mergeCSSVars = mergeCSSVars, 
 exports.mergeClassNames = mergeClassNames, exports.mergeComponentProps = mergeComponentProps, 
 exports.mergePartStyles = mergePartStyles, exports.mergeSlots = function(...slots) {
     const filtered = slots.filter((s => void 0 !== s));
@@ -26513,8 +28399,17 @@ exports.mergePartStyles = mergePartStyles, exports.mergeSlots = function(...slot
         ...acc,
         ...slot
     })));
-}, exports.mergeTheme = mergeTheme, exports.normalizeThemeTokens = normalizeThemeTokens, 
-exports.preloadFonts = preloadFonts, exports.quickTheme = 
+}, exports.mergeTheme = mergeTheme, exports.mergeTokens = mergeTokens, exports.normalizeThemeTokens = normalizeThemeTokens, 
+exports.omitTokens = omitTokens, exports.overrideTokens = overrideTokens, exports.persistTheme = persistTheme, 
+exports.pickTokens = pickTokens, exports.preloadFonts = preloadFonts, exports.printConfigReport = function(config, title) {
+    const result = validateConfiguration(config);
+    result.warnings.length > 0 && result.warnings.forEach((warning => {})), result.suggestions.length > 0 && result.suggestions.forEach((suggestion => {}));
+    const featuresDetected = [];
+    config.interactiveEffects && featuresDetected.push("Interactive Effects"), config.optimization && featuresDetected.push("Optimization"), 
+    config.visualPolish && featuresDetected.push("Visual Polish"), config.ai && featuresDetected.push("AI Integration"), 
+    config.tokenEngine && featuresDetected.push("Token Engine"), config.generator && featuresDetected.push("Component Generator"), 
+    featuresDetected.length > 0 && featuresDetected.forEach((feature => {}));
+}, exports.quickTheme = 
 /**
  * Quick theme creator with sensible defaults
  */
@@ -26531,11 +28426,23 @@ function(name, primaryColor, secondaryColor) {
         }
     });
 }, exports.registerTheme = registerTheme, exports.removeCSS = removeCSS, exports.removeCSSVariables = removeCSSVariables, 
-exports.removeTheme = removeTheme, exports.renderSlot = renderSlot, exports.sliderConstants = sliderConstants, 
+exports.removeTheme = removeTheme, exports.renderSlot = renderSlot, exports.resolveConfigPath = function(configPath) {
+    // In browser environments, config resolution is not possible
+    if ("undefined" != typeof window) return null;
+    // If a specific config path is provided, check if it exists
+        if (configPath) {
+        const absPath = path$4.join(process.cwd(), configPath);
+        return fs.existsSync(absPath) ? absPath : null;
+    }
+    // Otherwise, check standard locations
+        const possiblePaths = [ path$4.join(process.cwd(), "atomix.config.ts"), path$4.join(process.cwd(), "atomix.config.js"), path$4.join(process.cwd(), "atomix.config.json") ];
+    for (const path of possiblePaths) if (fs.existsSync(path)) return path;
+    return null;
+}, exports.rgbToHex = rgbToHex, exports.rtlCSS = rtlCSS, exports.sliderConstants = sliderConstants, 
 exports.supportsDarkMode = function(theme) {
     var _context;
     return "dark" === theme.palette?.mode || !0 === theme.supportsDarkMode || Boolean((null == (_context = theme.a11y?.modes) ? void 0 : Function.call.bind(_includesInstanceProperty(_context), _context))?.("dark"));
-}, exports.theme = theme, exports.themePropertyToCSSVar = themePropertyToCSSVar, 
+}, exports.switchTheme = switchTheme, exports.theme = theme, exports.themePropertyToCSSVar = themePropertyToCSSVar, 
 exports.themeToCSS = 
 /**
  * Generate CSS string from theme
@@ -26545,10 +28452,11 @@ function(theme, selector = ":root") {
         selector: selector,
         prefix: "atomix"
     });
-}, exports.types = types, exports.unregisterTheme = unregisterTheme, exports.useAccordion = useAccordion, 
-exports.useAtomixGlass = useAtomixGlass, exports.useBadge = useBadge, exports.useBarChart = useBarChart, 
-exports.useBlock = useBlock, exports.useChartData = useChartData, exports.useChartInteraction = useChartInteraction, 
-exports.useChartScale = useChartScale, exports.useComponentCustomization = function(component, props) {
+}, exports.toggleTheme = toggleTheme, exports.types = types, exports.unregisterTheme = unregisterTheme, 
+exports.useAccordion = useAccordion, exports.useAtomixGlass = useAtomixGlass, exports.useBadge = useBadge, 
+exports.useBarChart = useBarChart, exports.useBlock = useBlock, exports.useChartData = useChartData, 
+exports.useChartInteraction = useChartInteraction, exports.useChartScale = useChartScale, 
+exports.useComponentCustomization = function(component, props) {
     const {theme: theme} = useTheme(), cssVars = React.useMemo((() => mergeCSSVars(theme?.components?.[component]?.cssVars || {}, props.cssVars || {})), [ theme, component, props.cssVars ]), parts = React.useMemo((() => {
         const themeParts = theme?.components?.[component]?.parts || {}, propParts = props.parts || {}, merged = {};
         return new Set([ ...Object.keys(themeParts), ...Object.keys(propParts) ]).forEach((partName => {
@@ -26587,14 +28495,16 @@ exports.useMergedProps = function(defaultProps, props) {
         ...props
     })), [ defaultProps, props ]);
 }, exports.useNav = useNav, exports.useNavDropdown = useNavDropdown, exports.useNavItem = useNavItem, 
-exports.useNavbar = useNavbar, exports.usePerformanceMonitor = usePerformanceMonitor, 
-exports.usePieChart = usePieChart, exports.useRadio = useRadio, exports.useResponsiveGlass = useResponsiveGlass, 
+exports.useNavbar = useNavbar, exports.usePieChart = usePieChart, exports.useRadio = useRadio, 
+exports.useResponsive = useResponsive, exports.useResponsiveGlass = useResponsiveGlass, 
 exports.useRiver = useRiver, exports.useSelect = useSelect, exports.useSideMenu = useSideMenu, 
 exports.useSideMenuItem = useSideMenuItem, exports.useSlot = function(slot, props, fallback) {
     return React__default.default.useMemo((() => renderSlot(slot, props, fallback)), [ slot, props, fallback ]);
 }, exports.useSpinner = useSpinner, exports.useTextarea = useTextarea, exports.useTheme = useTheme, 
-exports.useThemeTokens = useThemeTokens, exports.useTodo = useTodo, exports.utils = utils, 
-exports.validateTheme = function(theme) {
+exports.useThemeSwitcher = useThemeSwitcher, exports.useThemeTokens = useThemeTokens, 
+exports.useTodo = useTodo, exports.utils = utils, exports.validateConfig = function(config) {
+    return validateConfig$1(config);
+}, exports.validateConfiguration = validateConfiguration, exports.validateTheme = function(theme) {
     const errors = [];
     return theme.name || errors.push("Theme must have a name"), theme.palette || errors.push("Theme must have a palette"), 
     theme.palette && !theme.palette.primary && errors.push("Theme palette must have a primary color"),