@nextsparkjs/core 0.1.0-beta.74 → 0.1.0-beta.76

package/dist/lib/test/utils.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Testing Utilities
+ * Helper functions for consistent testing attribute generation
+ *
+ * NOTE: For data-cy selectors, use sel() from '@nextsparkjs/core/selectors'
+ * This file contains runtime utilities for accessibility and keyboard handling.
+ */
+/**
+ * Create state-based data attributes for conditional testing
+ *
+ * @param state - Current state value
+ * @returns State attribute value
+ */
+export declare function createStateAttr(state: 'active' | 'completed' | 'pending' | 'loading' | 'error'): string;
+/**
+ * Create priority-based data attributes
+ *
+ * @param priority - Priority level
+ * @returns Priority attribute value
+ */
+export declare function createPriorityAttr(priority: 'low' | 'medium' | 'high'): string;
+/**
+ * Generate testing props object for components
+ *
+ * @param config - Testing configuration
+ * @returns Testing props object
+ */
+export declare function createTestingProps(config: {
+    testId?: string;
+    cyId?: string;
+    state?: 'active' | 'completed' | 'pending' | 'loading' | 'error';
+    priority?: 'low' | 'medium' | 'high';
+    taskId?: string;
+    userId?: string;
+}): {
+    [k: string]: string;
+};
+/**
+ * Accessibility helper for dynamic aria-label generation
+ *
+ * @param template - Label template with placeholders
+ * @param values - Values to replace placeholders
+ * @returns Formatted aria-label
+ */
+export declare function createAriaLabel(template: string, values: Record<string, string | number | boolean>): string;
+/**
+ * Keyboard navigation helpers
+ */
+export declare const keyboardHelpers: {
+    /**
+     * Handle Enter and Space key activation
+     */
+    createActivationHandler: (onActivate: () => void) => (e: React.KeyboardEvent) => void;
+    /**
+     * Handle Escape key for closing
+     */
+    createEscapeHandler: (onClose: () => void) => (e: React.KeyboardEvent) => void;
+    /**
+     * Handle arrow navigation in lists
+     */
+    createArrowNavigationHandler: (currentIndex: number, maxIndex: number, onIndexChange: (index: number) => void) => (e: React.KeyboardEvent) => void;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/test/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/test/utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAC9D,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;IAChE,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;;EA+BA;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAChD,MAAM,CAIR;AAMD;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;0CACmC,MAAM,IAAI,MACtC,GAAG,KAAK,CAAC,aAAa;IAQhC;;OAEG;mCAC4B,MAAM,IAAI,MAC/B,GAAG,KAAK,CAAC,aAAa;IAQhC;;OAEG;iDAEa,MAAM,YACV,MAAM,iBACD,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,MAE9B,GAAG,KAAK,CAAC,aAAa;CAajC,CAAA"}

package/dist/lib/theme/ThemeProvider.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Enhanced Theme Provider for WordPress-like Theme System
+ *
+ * Manages theme loading, component overrides, hot swapping, and integrates with import resolver
+ */
+import React from 'react';
+import type { ThemeConfig } from '../../types/theme';
+interface ThemeContextType {
+    currentTheme: ThemeConfig | null;
+    availableThemes: ThemeConfig[];
+    loading: boolean;
+    error?: string;
+    switchTheme: (themeName: string) => Promise<boolean>;
+    reloadTheme: () => Promise<void>;
+    refreshThemes: () => Promise<void>;
+}
+interface ThemeProviderProps {
+    children: React.ReactNode;
+    defaultTheme?: string;
+}
+export declare function ThemeProvider({ children, defaultTheme }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to use theme context
+ */
+export declare function useTheme(): ThemeContextType;
+/**
+ * Hook to check if component has an override
+ */
+export declare function useComponentOverride(componentPath: string): {
+    hasOverride: boolean;
+    Override: any;
+    originalPath: string;
+    themeName: string;
+};
+/**
+ * Hook to get custom theme components
+ */
+export declare function useCustomComponent(componentName: string): {
+    hasCustom: boolean;
+    CustomComponent: any;
+    themeName: string;
+};
+/**
+ * Hook to get theme configuration values
+ */
+export declare function useThemeConfig(): {
+    colors: any;
+    fonts: any;
+    spacing: any;
+    breakpoints: any;
+    themeName: string;
+};
+export {};
+//# sourceMappingURL=ThemeProvider.d.ts.map

package/dist/lib/theme/ThemeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../../src/lib/theme/ThemeProvider.tsx"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAyD,MAAM,OAAO,CAAA;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAKpD,UAAU,gBAAgB;IACxB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAA;IAChC,eAAe,EAAE,WAAW,EAAE,CAAA;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACpD,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACnC;AAID,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,YAAwB,EAAE,EAAE,kBAAkB,2CAwJvF;AAED;;GAEG;AACH,wBAAgB,QAAQ,qBAQvB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM;;;;;EAWzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM;;;;EAUvD;AAED;;GAEG;AACH,wBAAgB,cAAc;;;;;;EAU7B"}

package/dist/lib/theme/get-default-theme-mode.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Get Default Theme Mode (Server-Side)
+ *
+ * Priority:
+ * 1. User logged in → use uiPreferences.theme from user meta
+ * 2. User not logged in → use defaultMode from theme.config
+ */
+type ThemeMode = 'light' | 'dark' | 'system';
+/**
+ * Get the default theme mode for the current user
+ * Server-side only function
+ */
+export declare function getDefaultThemeMode(): Promise<ThemeMode>;
+export {};
+//# sourceMappingURL=get-default-theme-mode.d.ts.map

package/dist/lib/theme/get-default-theme-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-default-theme-mode.d.ts","sourceRoot":"","sources":["../../../src/lib/theme/get-default-theme-mode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,KAAK,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE5C;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,SAAS,CAAC,CA+C9D"}

package/dist/lib/theme/import-resolver.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Theme Import Resolver
+ *
+ * Resolves imports to prioritize theme overrides over core components
+ * Provides seamless component replacement with hot reload support
+ */
+import React from 'react';
+import type { ThemeConfig } from '../../types/theme';
+/**
+ * Theme context for accessing current theme
+ */
+interface ImportResolverContextType {
+    currentTheme: ThemeConfig | null;
+    resolveComponent: <T>(path: string, fallback: T) => Promise<T | React.ComponentType<unknown>>;
+    clearComponentCache: () => void;
+}
+/**
+ * Provider that manages component resolution
+ */
+export declare function ImportResolverProvider({ children, theme }: {
+    children: React.ReactNode;
+    theme: ThemeConfig | null;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to use the import resolver
+ */
+export declare function useImportResolver(): ImportResolverContextType;
+/**
+ * HOC to automatically resolve component overrides
+ */
+export declare function withThemeOverride<T extends React.ComponentType<unknown>>(componentPath: string, OriginalComponent: T): T;
+/**
+ * Utility to create a themed component that automatically resolves overrides
+ */
+export declare function createThemedComponent<T extends React.ComponentType<unknown>>(componentPath: string, OriginalComponent: T, options?: {
+    displayName?: string;
+    fallback?: React.ComponentType<unknown>;
+}): T;
+/**
+ * Utility to get custom theme components
+ */
+export declare function getCustomComponent(theme: ThemeConfig, componentName: string): Promise<React.ComponentType<unknown> | null>;
+/**
+ * Development helper to refresh component cache (for hot reload)
+ */
+export declare function refreshThemeComponents(): void;
+/**
+ * Get component cache statistics
+ */
+export declare function getImportResolverStats(): {
+    cachedComponents: number;
+    cacheKeys: string[];
+};
+export {};
+//# sourceMappingURL=import-resolver.d.ts.map

package/dist/lib/theme/import-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-resolver.d.ts","sourceRoot":"","sources":["../../../src/lib/theme/import-resolver.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAOpD;;GAEG;AACH,UAAU,yBAAyB;IACjC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAA;IAChC,gBAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA;IAC7F,mBAAmB,EAAE,MAAM,IAAI,CAAA;CAChC;AAID;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,QAAQ,EACR,KAAK,EACN,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;CAC1B,2CAuEA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,8BAQhC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,EACtE,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,CAAC,GACnB,CAAC,CAkBH;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,EAC1E,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,CAAC,EACpB,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;CACxC,GACA,CAAC,CAqCH;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,WAAW,EAClB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAkB9C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,SAKrC;AAED;;GAEG;AACH,wBAAgB,sBAAsB;;;EAKrC"}

package/dist/lib/theme/override-resolver.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Component Override Resolver
+ *
+ * Handles resolution of component overrides with caching for performance
+ */
+import type React from 'react';
+import type { ThemeConfig } from '../../types/theme';
+/**
+ * Resolve component override for a specific path
+ */
+export declare function resolveComponentOverride(componentPath: string, theme: ThemeConfig): Promise<React.ComponentType<unknown> | null>;
+/**
+ * Resolve component with fallback to original
+ */
+export declare function resolveComponent<T>(componentPath: string, originalComponent: T, theme: ThemeConfig): Promise<T | React.ComponentType<unknown>>;
+/**
+ * Create a component wrapper that automatically resolves overrides
+ */
+export declare function createOverridableComponent<T = React.ComponentType<unknown>>(componentPath: string, originalComponent: T): T;
+/**
+ * Clear override cache (useful for development and testing)
+ */
+export declare function clearOverrideCache(componentPath?: string, themeName?: string): void;
+/**
+ * Get cache statistics (for monitoring)
+ */
+export declare function getOverrideCacheStats(): {
+    size: number;
+    entries: string[];
+    hitRate?: number;
+};
+/**
+ * Preload overrides for better performance
+ */
+export declare function preloadThemeOverrides(theme: ThemeConfig): Promise<void>;
+//# sourceMappingURL=override-resolver.d.ts.map

package/dist/lib/theme/override-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"override-resolver.d.ts","sourceRoot":"","sources":["../../../src/lib/theme/override-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAgCpD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CA8C9C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,CAAC,EACpB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAU3C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,EACzE,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,CAAC,GACnB,CAAC,CAIH;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAkBnF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAKA;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB7E"}

package/dist/lib/theme/theme-loader.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Theme Loader with Build-Time Registry
+ *
+ * Loads themes from build-time registry for ultra-fast performance (zero I/O)
+ */
+import type { ThemeConfig } from '../../types/theme';
+/**
+ * No caching needed - registry provides instant access
+ * Build-time registry eliminates all runtime I/O operations
+ */
+/**
+ * Get all available themes from build-time registry (ultra-fast, zero I/O)
+ */
+export declare function getThemes(): ThemeConfig[];
+/**
+ * Load a specific theme configuration from registry (ultra-fast, zero I/O)
+ */
+export declare function loadThemeConfig(themeName: string): ThemeConfig | null;
+/**
+ * Load theme with all its dependencies and overrides (synchronous, zero I/O)
+ */
+export declare function loadThemeWithDependencies(themeName: string): ThemeConfig | null;
+/**
+ * Apply a theme with preloading and caching (synchronous, zero I/O)
+ */
+export declare function applyThemeWithOptimizations(themeName: string): boolean;
+/**
+ * Apply theme styles to the document (exported for ThemeProvider)
+ *
+ * This applies the base shadcn CSS variables directly to :root
+ * to ensure theme colors work even if CSS file bundling fails.
+ * Also sets up observer for dark mode changes.
+ */
+export declare function applyThemeStyles(theme: ThemeConfig): void;
+/**
+ * Cleanup dark mode observer (call when unmounting)
+ */
+export declare function cleanupThemeObserver(): void;
+/**
+ * Get theme loading statistics (registry-based, zero overhead)
+ */
+export declare function getThemeLoadingStats(): {
+    totalThemes: number;
+    loadMethod: string;
+    performanceNotes: string;
+};
+/**
+ * Clear theme override cache (useful for development)
+ * Note: Main theme registry is immutable and requires no cache clearing
+ */
+export declare function clearThemeCache(): void;
+/**
+ * Validate theme configuration
+ */
+export declare function validateThemeConfig(theme: ThemeConfig): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=theme-loader.d.ts.map

package/dist/lib/theme/theme-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/theme/theme-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAIpD;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,SAAS,IAAI,WAAW,EAAE,CAEzC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAUrE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAqC/E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CA8BtE;AAwED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CA2CzD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAOA;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuB5F"}

package/dist/lib/theme/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Theme System Types
+ *
+ * Type definitions for the WordPress-like theme system
+ */
+import type React from 'react';
+import type { ThemeConfig, ComponentOverride } from '../../types/theme';
+export type { ThemeConfig, ComponentOverride };
+/**
+ * Theme loading state
+ */
+export interface ThemeLoadingState {
+    loading: boolean;
+    error?: string;
+    theme?: string;
+}
+/**
+ * Theme context type for React context
+ */
+export interface ThemeContextType {
+    currentTheme: ThemeConfig | null;
+    loading: boolean;
+    error?: string;
+    switchTheme: (themeName: string) => Promise<boolean>;
+    reloadTheme: () => Promise<void>;
+    availableThemes: ThemeConfig[];
+}
+/**
+ * Theme override resolution result
+ */
+export interface OverrideResolution {
+    hasOverride: boolean;
+    component: React.ComponentType<unknown> | null;
+    originalPath: string;
+    themeName?: string;
+    cached: boolean;
+}
+/**
+ * Theme application options
+ */
+export interface ThemeApplicationOptions {
+    preloadOverrides?: boolean;
+    clearCache?: boolean;
+    validateConfig?: boolean;
+    hotReload?: boolean;
+}
+/**
+ * Theme validation result
+ */
+export interface ThemeValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    theme: string;
+}
+/**
+ * Theme performance metrics
+ */
+export interface ThemeMetrics {
+    loadTime: number;
+    overrideCount: number;
+    cacheHitRate: number;
+    memoryUsage: number;
+    lastApplied: number;
+}
+/**
+ * Theme event types
+ */
+export type ThemeEvent = 'theme-loaded' | 'theme-applied' | 'theme-error' | 'theme-switched' | 'override-resolved' | 'cache-cleared';
+/**
+ * Theme event handler
+ */
+export type ThemeEventHandler<T = Record<string, unknown>> = (event: ThemeEvent, data: T) => void;
+/**
+ * Theme configuration builder
+ */
+export interface ThemeConfigBuilder {
+    name: (name: string) => ThemeConfigBuilder;
+    displayName: (displayName: string) => ThemeConfigBuilder;
+    version: (version: string) => ThemeConfigBuilder;
+    parent: (parent: string) => ThemeConfigBuilder;
+    addOverride: (path: string, component: React.ComponentType<unknown>) => ThemeConfigBuilder;
+    addStyle: (key: string, value: string) => ThemeConfigBuilder;
+    addColor: (key: string, color: string) => ThemeConfigBuilder;
+    addFont: (key: string, font: string) => ThemeConfigBuilder;
+    build: () => ThemeConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/theme/types.d.ts.map

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

package/dist/lib/translations/i18n-integration.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Next-intl Integration for Dynamic Translations
+ *
+ * Integrates with next-intl using TranslationService for dynamic entity translations
+ */
+import type { SupportedLocale } from '../entities/types';
+/**
+ * Load all translations for next-intl configuration
+ * Uses loadMergedTranslations which handles core + theme + entity merge
+ */
+export declare function loadAllI18nTranslations(locale: SupportedLocale): Promise<Record<string, unknown>>;
+/**
+ * Get core namespaces (excluding entity namespaces)
+ */
+export declare function getCoreNamespaces(): string[];
+/**
+ * Get optimized namespaces based on route
+ */
+export declare function getOptimizedNamespaces(pathname: string): {
+    core: string[];
+    entities: string[];
+    strategy: string;
+};
+/**
+ * Load optimized translations based on route
+ * Uses TranslationService for registry-based loading
+ */
+export declare function loadOptimizedTranslations(locale: SupportedLocale, pathname?: string): Promise<Record<string, unknown>>;
+//# sourceMappingURL=i18n-integration.d.ts.map

package/dist/lib/translations/i18n-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-integration.d.ts","sourceRoot":"","sources":["../../../src/lib/translations/i18n-integration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkBvG;AAaD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAS5C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACxD,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAsEA;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,eAAe,EACvB,QAAQ,GAAE,MAAW,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuClC"}

package/dist/lib/translations/registry.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Translation Registry System
+ *
+ * Manages dynamic loading of translations from entities, plugins, and themes.
+ * Integrates with next-intl and entity system for seamless i18n.
+ */
+import type { SupportedLocale } from '../entities/types';
+/**
+ * Register theme messages for a locale
+ * Call this from your project's initialization to provide theme-specific translations
+ *
+ * @example
+ * // In your app's initialization
+ * import { registerThemeMessages } from '@nextsparkjs/core/lib/translations/registry'
+ * import enMessages from './contents/themes/my-theme/messages/en'
+ * registerThemeMessages('en', enMessages)
+ */
+export declare function registerThemeMessages(locale: string, messages: Record<string, unknown>): void;
+/**
+ * Carga y mergea mensajes de todas las fuentes
+ * Orden: Core (base) -> Theme -> Entity (later wins)
+ *
+ * Merge priority ensures:
+ * 1. Core translations provide the base
+ * 2. Theme translations can override/extend core
+ * 3. Entity translations can override/extend both (highest priority)
+ *
+ * Uses globalThis cache to prevent re-loading on each request
+ */
+export declare function loadMergedTranslations(locale: SupportedLocale): Promise<Record<string, unknown>>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/lib/translations/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/lib/translations/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AA+FxD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE7F;AAmDD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4DlC"}

package/dist/lib/user-data-client.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Client-side User Data Utilities
+ *
+ * Client-side utilities for managing user plan and flags data.
+ * Works with the server-side user-data.ts module.
+ */
+import type { PlanType, UserFlag } from './entities/types';
+import type { SessionUser } from './auth';
+/**
+ * Client-side interface for user plan data
+ */
+export interface ClientUserPlanData {
+    plan: PlanType;
+    flags: UserFlag[];
+    fromStorage: boolean;
+}
+/**
+ * Get user plan and flags from localStorage (client-side cache)
+ */
+export declare function getCachedUserPlanData(userId: string): ClientUserPlanData | null;
+/**
+ * Cache user plan data to localStorage
+ */
+export declare function cacheUserPlanData(userId: string, plan: PlanType, flags: UserFlag[]): void;
+/**
+ * Fetch user plan and flags from API
+ */
+export declare function fetchUserPlanData(userId: string): Promise<ClientUserPlanData>;
+/**
+ * Get user plan and flags with caching strategy
+ */
+export declare function getUserPlanDataWithCache(userId: string): Promise<ClientUserPlanData>;
+/**
+ * Update user plan via API
+ */
+export declare function updateUserPlanClient(userId: string, plan: PlanType): Promise<boolean>;
+/**
+ * Update user flags via API
+ */
+export declare function updateUserFlagsClient(userId: string, flags: UserFlag[]): Promise<boolean>;
+/**
+ * Extract plan data from session user (enhanced version)
+ */
+export declare function extractUserPlanDataWithCache(user: SessionUser | null): ClientUserPlanData;
+/**
+ * Clear cached user data (useful for logout or data refresh)
+ */
+export declare function clearCachedUserPlanData(userId?: string): void;
+/**
+ * React hook for user plan data
+ */
+export declare function useUserPlanData(user: SessionUser | null): {
+    loading: boolean;
+    error: string;
+    updatePlan: (plan: PlanType) => Promise<boolean>;
+    updateFlags: (flags: UserFlag[]) => Promise<boolean>;
+    refetch: () => void;
+    plan: PlanType;
+    flags: UserFlag[];
+    fromStorage: boolean;
+};
+//# sourceMappingURL=user-data-client.d.ts.map

package/dist/lib/user-data-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-data-client.d.ts","sourceRoot":"","sources":["../../src/lib/user-data-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAMzC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAuB/E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAYzF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAqCnF;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAS1F;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CA4B3F;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA4B/F;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,kBAAkB,CAqBzF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;;;uBAyCJ,QAAQ;yBAUN,QAAQ,EAAE;;UAzQxD,QAAQ;WACP,QAAQ,EAAE;iBACJ,OAAO;EA+RrB"}

package/dist/lib/user-data-utils.d.ts

@@ -0,0 +1,33 @@
+/**
+ * User Data Utilities (Client-Safe)
+ *
+ * Client-side utilities for handling user plan and flag data.
+ * These functions don't require database access and are safe for client-side usage.
+ */
+import type { PlanType, UserFlag } from './entities/types';
+import type { SessionUser } from './auth';
+/**
+ * Get user plan and flags from session user (for client-side usage)
+ * This is a convenience function that extracts plan data from user session
+ *
+ * Note: This returns defaults for client-side usage. For actual data,
+ * use getUserPlanAndFlags() on the server side.
+ */
+export declare function extractUserPlanData(user: SessionUser | null): {
+    plan: PlanType;
+    flags: UserFlag[];
+};
+/**
+ * Clear user data cache (useful for testing or forced refresh)
+ */
+export declare function clearUserDataCache(userId?: string): void;
+/**
+ * Get cache statistics (for monitoring)
+ */
+export declare function getUserDataCacheStats(): {
+    size: number;
+    keys: string[];
+    oldestEntry: number | null;
+    newestEntry: number | null;
+};
+//# sourceMappingURL=user-data-utils.d.ts.map

package/dist/lib/user-data-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-data-utils.d.ts","sourceRoot":"","sources":["../../src/lib/user-data-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAazC;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG;IAC7D,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB,CAcA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAMxD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,CASA"}

package/dist/lib/user-data.d.ts

@@ -0,0 +1,55 @@
+/**
+ * User Plan & Flag Data Integration
+ *
+ * Provides dynamic retrieval of user plan and flags from the database
+ * via users_metas table. Replaces hardcoded values throughout the system.
+ */
+import type { PlanType, UserFlag } from './entities/types';
+import type { SessionUser } from './auth';
+/**
+ * Interface for user plan and flag data
+ * @property plan - User's subscription plan type (free, starter, premium)
+ * @property flags - Array of feature flags assigned to the user
+ * @property cached - Whether this data was retrieved from cache vs database
+ */
+export interface UserPlanData {
+    plan: PlanType;
+    flags: UserFlag[];
+    cached: boolean;
+}
+/**
+ * Custom error class for user data operations
+ */
+export declare class UserDataError extends Error {
+    readonly userId: string;
+    readonly operation: string;
+    readonly originalError?: unknown;
+    constructor(message: string, userId: string, operation: string, originalError?: unknown);
+}
+/**
+ * Get user plan and flags from database
+ * Uses user_metas table to store plan and flags data
+ *
+ * @throws UserDataError in production when database operations fail
+ */
+export declare function getUserPlanAndFlags(userId: string): Promise<UserPlanData>;
+/**
+ * Update user plan in database
+ *
+ * @throws UserDataError in production when database operations fail
+ */
+export declare function updateUserPlan(userId: string, plan: PlanType): Promise<boolean>;
+/**
+ * Update user flags in database
+ *
+ * @throws UserDataError in production when database operations fail
+ */
+export declare function updateUserFlags(userId: string, flags: UserFlag[]): Promise<boolean>;
+/**
+ * Add user plan and flags to user object (server-side helper)
+ */
+export declare function enrichUserWithPlanData(user: SessionUser): Promise<SessionUser & {
+    plan: PlanType;
+    flags: UserFlag[];
+}>;
+//# sourceMappingURL=user-data.d.ts.map

package/dist/lib/user-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-data.d.ts","sourceRoot":"","sources":["../../src/lib/user-data.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AA6CzC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;CAChB;AAGD;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,MAAM,EAAE,MAAM;aACd,SAAS,EAAE,MAAM;aACjB,aAAa,CAAC,EAAE,OAAO;gBAHvC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,OAAO;CAK1C;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAmH/E;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CA+DrF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA+DzF;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,GAAG;IACrF,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB,CAAC,CAQD"}