@omnitron-dev/prism 0.1.1

package/dist/state/index.d.ts

@@ -0,0 +1,981 @@
+import * as immer from 'immer';
+import * as zustand from 'zustand';
+import { StateCreator, UseBoundStore, StoreApi } from 'zustand';
+import { PersistOptions, StateStorage } from 'zustand/middleware';
+import { a as ThemeMode, c as ThemeDirection } from '../theme-CrXLfP1c.js';
+export { N as NavColor, b as NavLayout, a as SettingsState, S as SettingsValues, g as getDefaultSettings, s as settingsStore, u as useSettingsStore } from '../settings-plpR26Xk.js';
+import '@mui/material/styles';
+
+/**
+ * Options for creating a Prism store.
+ */
+interface CreateStoreOptions<T> {
+    /** Store name for DevTools and persistence */
+    name: string;
+    /** Enable persistence to localStorage */
+    persist?: boolean | Partial<PersistOptions<T>>;
+    /** Enable Redux DevTools (default: true in development) */
+    devtools?: boolean;
+}
+/**
+ * Middleware type helpers for proper typing.
+ */
+type ImmerMiddleware = ['zustand/immer', never];
+/**
+ * Creates a Zustand store with Prism defaults.
+ *
+ * @example
+ * ```typescript
+ * interface CounterState {
+ *   count: number;
+ *   increment: () => void;
+ *   decrement: () => void;
+ * }
+ *
+ * export const useCounterStore = createPrismStore<CounterState>(
+ *   (set) => ({
+ *     count: 0,
+ *     increment: () => set((state) => { state.count += 1; }),
+ *     decrement: () => set((state) => { state.count -= 1; }),
+ *   }),
+ *   { name: 'counter', persist: true }
+ * );
+ * ```
+ */
+declare function createPrismStore<T extends object>(initializer: StateCreator<T, [ImmerMiddleware], []>, options: CreateStoreOptions<T>): UseBoundStore<Omit<Omit<StoreApi<T>, "devtools" | "setState"> & {
+    setState(partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: T | ((state: T) => T), replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}, "setState"> & {
+    setState(nextStateOrUpdater: Exclude<T, (...args: any[]) => any> | Partial<Exclude<T, (...args: any[]) => any>> | ((state: immer.Draft<Exclude<T, (...args: any[]) => any>>) => void), shouldReplace?: false, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(nextStateOrUpdater: Exclude<T, (...args: any[]) => any> | ((state: immer.Draft<Exclude<T, (...args: any[]) => any>>) => void), shouldReplace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+}> | UseBoundStore<Omit<StoreApi<T>, "setState"> & {
+    setState(nextStateOrUpdater: Exclude<T, (...args: any[]) => any> | Partial<Exclude<T, (...args: any[]) => any>> | ((state: immer.Draft<Exclude<T, (...args: any[]) => any>>) => void), shouldReplace?: false): void;
+    setState(nextStateOrUpdater: Exclude<T, (...args: any[]) => any> | ((state: immer.Draft<Exclude<T, (...args: any[]) => any>>) => void), shouldReplace: true): void;
+}>;
+/**
+ * Creates a simple store without persistence (for UI-only state).
+ */
+declare function createUIStore<T extends object>(initializer: StateCreator<T, [ImmerMiddleware], []>, name: string): UseBoundStore<Omit<Omit<StoreApi<T>, "devtools" | "setState"> & {
+    setState(partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: T | ((state: T) => T), replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}, "setState"> & {
+    setState(nextStateOrUpdater: Exclude<T, (...args: any[]) => any> | Partial<Exclude<T, (...args: any[]) => any>> | ((state: immer.Draft<Exclude<T, (...args: any[]) => any>>) => void), shouldReplace?: false, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(nextStateOrUpdater: Exclude<T, (...args: any[]) => any> | ((state: immer.Draft<Exclude<T, (...args: any[]) => any>>) => void), shouldReplace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+}> | UseBoundStore<Omit<StoreApi<T>, "setState"> & {
+    setState(nextStateOrUpdater: Exclude<T, (...args: any[]) => any> | Partial<Exclude<T, (...args: any[]) => any>> | ((state: immer.Draft<Exclude<T, (...args: any[]) => any>>) => void), shouldReplace?: false): void;
+    setState(nextStateOrUpdater: Exclude<T, (...args: any[]) => any> | ((state: immer.Draft<Exclude<T, (...args: any[]) => any>>) => void), shouldReplace: true): void;
+}>;
+/**
+ * Creates a persisted store (for settings, preferences).
+ *
+ * Includes a storage wrapper that catches errors from localStorage
+ * (e.g., private browsing, quota exceeded) and falls back gracefully.
+ */
+declare function createPersistedStore<T extends object>(initializer: StateCreator<T, [ImmerMiddleware], []>, name: string, persistOptions?: Partial<PersistOptions<T>>): UseBoundStore<Omit<Omit<StoreApi<T>, "devtools" | "setState"> & {
+    setState(partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: T | ((state: T) => T), replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}, "setState"> & {
+    setState(nextStateOrUpdater: Exclude<T, (...args: any[]) => any> | Partial<Exclude<T, (...args: any[]) => any>> | ((state: immer.Draft<Exclude<T, (...args: any[]) => any>>) => void), shouldReplace?: false, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(nextStateOrUpdater: Exclude<T, (...args: any[]) => any> | ((state: immer.Draft<Exclude<T, (...args: any[]) => any>>) => void), shouldReplace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+}> | UseBoundStore<Omit<StoreApi<T>, "setState"> & {
+    setState(nextStateOrUpdater: Exclude<T, (...args: any[]) => any> | Partial<Exclude<T, (...args: any[]) => any>> | ((state: immer.Draft<Exclude<T, (...args: any[]) => any>>) => void), shouldReplace?: false): void;
+    setState(nextStateOrUpdater: Exclude<T, (...args: any[]) => any> | ((state: immer.Draft<Exclude<T, (...args: any[]) => any>>) => void), shouldReplace: true): void;
+}>;
+/**
+ * Selector type for store state.
+ */
+type StoreSelector<T, U> = (state: T) => U;
+/**
+ * Helper to create typed selectors for a store.
+ *
+ * @example
+ * ```typescript
+ * const selectors = createSelectors(useUserStore);
+ * const userName = selectors.use.name();
+ * ```
+ */
+declare function createSelectors<T extends object>(store: UseBoundStore<StoreApi<T>>): {
+    (): T;
+    <U>(selector: (state: T) => U): U;
+} & StoreApi<T> & {
+    use: { [K in keyof T]: () => T[K]; };
+};
+
+/**
+ * Theme store state and actions.
+ */
+interface ThemeState {
+    /** Current theme mode */
+    mode: ThemeMode;
+    /** Text direction */
+    direction: ThemeDirection;
+    /** Current preset name */
+    preset: string;
+    /** Compact layout mode */
+    compactLayout: boolean;
+    /** High contrast mode */
+    contrast: 'default' | 'high';
+    /** Primary color override */
+    primaryColor: string | null;
+    setMode: (mode: ThemeMode) => void;
+    toggleMode: () => void;
+    setDirection: (direction: ThemeDirection) => void;
+    setPreset: (preset: string) => void;
+    setCompactLayout: (compact: boolean) => void;
+    setContrast: (contrast: 'default' | 'high') => void;
+    setPrimaryColor: (color: string | null) => void;
+    reset: () => void;
+}
+/**
+ * Theme store with persistence.
+ *
+ * @example
+ * ```tsx
+ * function ThemeToggle() {
+ *   const { mode, toggleMode } = useThemeStore();
+ *   return <button onClick={toggleMode}>{mode}</button>;
+ * }
+ * ```
+ */
+declare const useThemeStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<ThemeState>, "devtools" | "setState"> & {
+    setState(partial: ThemeState | Partial<ThemeState> | ((state: ThemeState) => ThemeState | Partial<ThemeState>), replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: ThemeState | ((state: ThemeState) => ThemeState), replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}, "setState"> & {
+    setState(nextStateOrUpdater: ThemeState | Partial<ThemeState> | ((state: {
+        mode: ThemeMode;
+        direction: ThemeDirection;
+        preset: string;
+        compactLayout: boolean;
+        contrast: "default" | "high";
+        primaryColor: string | null;
+        setMode: (mode: ThemeMode) => void;
+        toggleMode: () => void;
+        setDirection: (direction: ThemeDirection) => void;
+        setPreset: (preset: string) => void;
+        setCompactLayout: (compact: boolean) => void;
+        setContrast: (contrast: "default" | "high") => void;
+        setPrimaryColor: (color: string | null) => void;
+        reset: () => void;
+    }) => void), shouldReplace?: false, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(nextStateOrUpdater: ThemeState | ((state: {
+        mode: ThemeMode;
+        direction: ThemeDirection;
+        preset: string;
+        compactLayout: boolean;
+        contrast: "default" | "high";
+        primaryColor: string | null;
+        setMode: (mode: ThemeMode) => void;
+        toggleMode: () => void;
+        setDirection: (direction: ThemeDirection) => void;
+        setPreset: (preset: string) => void;
+        setCompactLayout: (compact: boolean) => void;
+        setContrast: (contrast: "default" | "high") => void;
+        setPrimaryColor: (color: string | null) => void;
+        reset: () => void;
+    }) => void), shouldReplace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+}> | zustand.UseBoundStore<Omit<zustand.StoreApi<ThemeState>, "setState"> & {
+    setState(nextStateOrUpdater: ThemeState | Partial<ThemeState> | ((state: {
+        mode: ThemeMode;
+        direction: ThemeDirection;
+        preset: string;
+        compactLayout: boolean;
+        contrast: "default" | "high";
+        primaryColor: string | null;
+        setMode: (mode: ThemeMode) => void;
+        toggleMode: () => void;
+        setDirection: (direction: ThemeDirection) => void;
+        setPreset: (preset: string) => void;
+        setCompactLayout: (compact: boolean) => void;
+        setContrast: (contrast: "default" | "high") => void;
+        setPrimaryColor: (color: string | null) => void;
+        reset: () => void;
+    }) => void), shouldReplace?: false): void;
+    setState(nextStateOrUpdater: ThemeState | ((state: {
+        mode: ThemeMode;
+        direction: ThemeDirection;
+        preset: string;
+        compactLayout: boolean;
+        contrast: "default" | "high";
+        primaryColor: string | null;
+        setMode: (mode: ThemeMode) => void;
+        toggleMode: () => void;
+        setDirection: (direction: ThemeDirection) => void;
+        setPreset: (preset: string) => void;
+        setCompactLayout: (compact: boolean) => void;
+        setContrast: (contrast: "default" | "high") => void;
+        setPrimaryColor: (color: string | null) => void;
+        reset: () => void;
+    }) => void), shouldReplace: true): void;
+}>;
+/**
+ * Theme store with auto-generated selectors.
+ *
+ * @example
+ * ```tsx
+ * const mode = themeStore.use.mode();
+ * ```
+ */
+declare const themeStore: {
+    (): {
+        mode: ThemeMode;
+        direction: ThemeDirection;
+        preset: string;
+        compactLayout: boolean;
+        contrast: "default" | "high";
+        primaryColor: string | null;
+        setMode: (mode: ThemeMode) => void;
+        toggleMode: () => void;
+        setDirection: (direction: ThemeDirection) => void;
+        setPreset: (preset: string) => void;
+        setCompactLayout: (compact: boolean) => void;
+        setContrast: (contrast: "default" | "high") => void;
+        setPrimaryColor: (color: string | null) => void;
+        reset: () => void;
+    };
+    <U>(selector: (state: {
+        mode: ThemeMode;
+        direction: ThemeDirection;
+        preset: string;
+        compactLayout: boolean;
+        contrast: "default" | "high";
+        primaryColor: string | null;
+        setMode: (mode: ThemeMode) => void;
+        toggleMode: () => void;
+        setDirection: (direction: ThemeDirection) => void;
+        setPreset: (preset: string) => void;
+        setCompactLayout: (compact: boolean) => void;
+        setContrast: (contrast: "default" | "high") => void;
+        setPrimaryColor: (color: string | null) => void;
+        reset: () => void;
+    }) => U): U;
+} & zustand.StoreApi<{
+    mode: ThemeMode;
+    direction: ThemeDirection;
+    preset: string;
+    compactLayout: boolean;
+    contrast: "default" | "high";
+    primaryColor: string | null;
+    setMode: (mode: ThemeMode) => void;
+    toggleMode: () => void;
+    setDirection: (direction: ThemeDirection) => void;
+    setPreset: (preset: string) => void;
+    setCompactLayout: (compact: boolean) => void;
+    setContrast: (contrast: "default" | "high") => void;
+    setPrimaryColor: (color: string | null) => void;
+    reset: () => void;
+}> & {
+    use: {
+        mode: () => ThemeMode;
+        direction: () => ThemeDirection;
+        preset: () => string;
+        compactLayout: () => boolean;
+        contrast: () => "default" | "high";
+        primaryColor: () => string | null;
+        setMode: () => (mode: ThemeMode) => void;
+        toggleMode: () => () => void;
+        setDirection: () => (direction: ThemeDirection) => void;
+        setPreset: () => (preset: string) => void;
+        setCompactLayout: () => (compact: boolean) => void;
+        setContrast: () => (contrast: "default" | "high") => void;
+        setPrimaryColor: () => (color: string | null) => void;
+        reset: () => () => void;
+    };
+};
+
+/**
+ * Auth Store
+ *
+ * Manages authentication state (UI-side).
+ * Server-side token validation should use Netron auth.
+ *
+ * SECURITY NOTE: Tokens are stored in session storage (not localStorage)
+ * and are NOT persisted across browser sessions. Only the auth status
+ * is persisted to allow checking login state on page load.
+ *
+ * @module @omnitron-dev/prism/state/stores
+ */
+/**
+ * Authentication status.
+ */
+type AuthStatus = 'loading' | 'authenticated' | 'unauthenticated';
+/**
+ * Auth store state (persisted - only status).
+ */
+interface AuthStoreState {
+    /** Current auth status */
+    status: AuthStatus;
+    /** Session ID (non-sensitive) */
+    sessionId: string | null;
+    setStatus: (status: AuthStatus) => void;
+    setAuthenticated: (sessionId?: string) => void;
+    setUnauthenticated: () => void;
+    clearSession: () => void;
+}
+/**
+ * Auth store with partial persistence.
+ * Only status and sessionId are persisted, NOT the token.
+ *
+ * @example
+ * ```tsx
+ * function AuthGuard({ children }) {
+ *   const status = useAuthStore((s) => s.status);
+ *   const isAuthenticated = selectIsAuthenticated(useAuthStore.getState());
+ *
+ *   if (status === 'loading') return <Spinner />;
+ *   if (!isAuthenticated) return <Navigate to="/login" />;
+ *
+ *   return children;
+ * }
+ * ```
+ */
+declare const useAuthStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<AuthStoreState>, "devtools" | "setState"> & {
+    setState(partial: AuthStoreState | Partial<AuthStoreState> | ((state: AuthStoreState) => AuthStoreState | Partial<AuthStoreState>), replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: AuthStoreState | ((state: AuthStoreState) => AuthStoreState), replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}, "setState"> & {
+    setState(nextStateOrUpdater: AuthStoreState | Partial<AuthStoreState> | ((state: {
+        status: AuthStatus;
+        sessionId: string | null;
+        setStatus: (status: AuthStatus) => void;
+        setAuthenticated: (sessionId?: string) => void;
+        setUnauthenticated: () => void;
+        clearSession: () => void;
+    }) => void), shouldReplace?: false, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(nextStateOrUpdater: AuthStoreState | ((state: {
+        status: AuthStatus;
+        sessionId: string | null;
+        setStatus: (status: AuthStatus) => void;
+        setAuthenticated: (sessionId?: string) => void;
+        setUnauthenticated: () => void;
+        clearSession: () => void;
+    }) => void), shouldReplace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+}> | zustand.UseBoundStore<Omit<zustand.StoreApi<AuthStoreState>, "setState"> & {
+    setState(nextStateOrUpdater: AuthStoreState | Partial<AuthStoreState> | ((state: {
+        status: AuthStatus;
+        sessionId: string | null;
+        setStatus: (status: AuthStatus) => void;
+        setAuthenticated: (sessionId?: string) => void;
+        setUnauthenticated: () => void;
+        clearSession: () => void;
+    }) => void), shouldReplace?: false): void;
+    setState(nextStateOrUpdater: AuthStoreState | ((state: {
+        status: AuthStatus;
+        sessionId: string | null;
+        setStatus: (status: AuthStatus) => void;
+        setAuthenticated: (sessionId?: string) => void;
+        setUnauthenticated: () => void;
+        clearSession: () => void;
+    }) => void), shouldReplace: true): void;
+}>;
+/**
+ * Auth store with auto-generated selectors.
+ */
+declare const authStore: {
+    (): {
+        status: AuthStatus;
+        sessionId: string | null;
+        setStatus: (status: AuthStatus) => void;
+        setAuthenticated: (sessionId?: string) => void;
+        setUnauthenticated: () => void;
+        clearSession: () => void;
+    };
+    <U>(selector: (state: {
+        status: AuthStatus;
+        sessionId: string | null;
+        setStatus: (status: AuthStatus) => void;
+        setAuthenticated: (sessionId?: string) => void;
+        setUnauthenticated: () => void;
+        clearSession: () => void;
+    }) => U): U;
+} & zustand.StoreApi<{
+    status: AuthStatus;
+    sessionId: string | null;
+    setStatus: (status: AuthStatus) => void;
+    setAuthenticated: (sessionId?: string) => void;
+    setUnauthenticated: () => void;
+    clearSession: () => void;
+}> & {
+    use: {
+        status: () => AuthStatus;
+        sessionId: () => string | null;
+        setStatus: () => (status: AuthStatus) => void;
+        setAuthenticated: () => (sessionId?: string) => void;
+        setUnauthenticated: () => () => void;
+        clearSession: () => () => void;
+    };
+};
+
+/**
+ * UI Store
+ *
+ * Manages transient UI state (not persisted).
+ *
+ * @module @omnitron-dev/prism/state/stores
+ */
+/**
+ * UI store state and actions.
+ */
+interface UIState {
+    /** Sidebar open state */
+    sidebarOpen: boolean;
+    /** Sidebar collapsed state (mini mode) */
+    sidebarCollapsed: boolean;
+    /** Active dialog ID */
+    activeDialog: string | null;
+    /** Global loading overlay */
+    globalLoading: boolean;
+    /** Search modal open */
+    searchOpen: boolean;
+    toggleSidebar: () => void;
+    setSidebarOpen: (open: boolean) => void;
+    setSidebarCollapsed: (collapsed: boolean) => void;
+    openDialog: (dialogId: string) => void;
+    closeDialog: () => void;
+    setGlobalLoading: (loading: boolean) => void;
+    toggleSearch: () => void;
+    setSearchOpen: (open: boolean) => void;
+}
+/**
+ * UI store for transient state.
+ *
+ * @example
+ * ```tsx
+ * function Sidebar() {
+ *   const { sidebarOpen, sidebarCollapsed, toggleSidebar } = useUIStore();
+ *
+ *   return (
+ *     <Drawer
+ *       open={sidebarOpen}
+ *       variant={sidebarCollapsed ? 'mini' : 'permanent'}
+ *     >
+ *       <SidebarContent />
+ *     </Drawer>
+ *   );
+ * }
+ * ```
+ */
+declare const useUIStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<UIState>, "devtools" | "setState"> & {
+    setState(partial: UIState | Partial<UIState> | ((state: UIState) => UIState | Partial<UIState>), replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: UIState | ((state: UIState) => UIState), replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}, "setState"> & {
+    setState(nextStateOrUpdater: UIState | Partial<UIState> | ((state: {
+        sidebarOpen: boolean;
+        sidebarCollapsed: boolean;
+        activeDialog: string | null;
+        globalLoading: boolean;
+        searchOpen: boolean;
+        toggleSidebar: () => void;
+        setSidebarOpen: (open: boolean) => void;
+        setSidebarCollapsed: (collapsed: boolean) => void;
+        openDialog: (dialogId: string) => void;
+        closeDialog: () => void;
+        setGlobalLoading: (loading: boolean) => void;
+        toggleSearch: () => void;
+        setSearchOpen: (open: boolean) => void;
+    }) => void), shouldReplace?: false, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(nextStateOrUpdater: UIState | ((state: {
+        sidebarOpen: boolean;
+        sidebarCollapsed: boolean;
+        activeDialog: string | null;
+        globalLoading: boolean;
+        searchOpen: boolean;
+        toggleSidebar: () => void;
+        setSidebarOpen: (open: boolean) => void;
+        setSidebarCollapsed: (collapsed: boolean) => void;
+        openDialog: (dialogId: string) => void;
+        closeDialog: () => void;
+        setGlobalLoading: (loading: boolean) => void;
+        toggleSearch: () => void;
+        setSearchOpen: (open: boolean) => void;
+    }) => void), shouldReplace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+}> | zustand.UseBoundStore<Omit<zustand.StoreApi<UIState>, "setState"> & {
+    setState(nextStateOrUpdater: UIState | Partial<UIState> | ((state: {
+        sidebarOpen: boolean;
+        sidebarCollapsed: boolean;
+        activeDialog: string | null;
+        globalLoading: boolean;
+        searchOpen: boolean;
+        toggleSidebar: () => void;
+        setSidebarOpen: (open: boolean) => void;
+        setSidebarCollapsed: (collapsed: boolean) => void;
+        openDialog: (dialogId: string) => void;
+        closeDialog: () => void;
+        setGlobalLoading: (loading: boolean) => void;
+        toggleSearch: () => void;
+        setSearchOpen: (open: boolean) => void;
+    }) => void), shouldReplace?: false): void;
+    setState(nextStateOrUpdater: UIState | ((state: {
+        sidebarOpen: boolean;
+        sidebarCollapsed: boolean;
+        activeDialog: string | null;
+        globalLoading: boolean;
+        searchOpen: boolean;
+        toggleSidebar: () => void;
+        setSidebarOpen: (open: boolean) => void;
+        setSidebarCollapsed: (collapsed: boolean) => void;
+        openDialog: (dialogId: string) => void;
+        closeDialog: () => void;
+        setGlobalLoading: (loading: boolean) => void;
+        toggleSearch: () => void;
+        setSearchOpen: (open: boolean) => void;
+    }) => void), shouldReplace: true): void;
+}>;
+/**
+ * UI store with auto-generated selectors.
+ */
+declare const uiStore: {
+    (): {
+        sidebarOpen: boolean;
+        sidebarCollapsed: boolean;
+        activeDialog: string | null;
+        globalLoading: boolean;
+        searchOpen: boolean;
+        toggleSidebar: () => void;
+        setSidebarOpen: (open: boolean) => void;
+        setSidebarCollapsed: (collapsed: boolean) => void;
+        openDialog: (dialogId: string) => void;
+        closeDialog: () => void;
+        setGlobalLoading: (loading: boolean) => void;
+        toggleSearch: () => void;
+        setSearchOpen: (open: boolean) => void;
+    };
+    <U>(selector: (state: {
+        sidebarOpen: boolean;
+        sidebarCollapsed: boolean;
+        activeDialog: string | null;
+        globalLoading: boolean;
+        searchOpen: boolean;
+        toggleSidebar: () => void;
+        setSidebarOpen: (open: boolean) => void;
+        setSidebarCollapsed: (collapsed: boolean) => void;
+        openDialog: (dialogId: string) => void;
+        closeDialog: () => void;
+        setGlobalLoading: (loading: boolean) => void;
+        toggleSearch: () => void;
+        setSearchOpen: (open: boolean) => void;
+    }) => U): U;
+} & zustand.StoreApi<{
+    sidebarOpen: boolean;
+    sidebarCollapsed: boolean;
+    activeDialog: string | null;
+    globalLoading: boolean;
+    searchOpen: boolean;
+    toggleSidebar: () => void;
+    setSidebarOpen: (open: boolean) => void;
+    setSidebarCollapsed: (collapsed: boolean) => void;
+    openDialog: (dialogId: string) => void;
+    closeDialog: () => void;
+    setGlobalLoading: (loading: boolean) => void;
+    toggleSearch: () => void;
+    setSearchOpen: (open: boolean) => void;
+}> & {
+    use: {
+        sidebarOpen: () => boolean;
+        sidebarCollapsed: () => boolean;
+        activeDialog: () => string | null;
+        globalLoading: () => boolean;
+        searchOpen: () => boolean;
+        toggleSidebar: () => () => void;
+        setSidebarOpen: () => (open: boolean) => void;
+        setSidebarCollapsed: () => (collapsed: boolean) => void;
+        openDialog: () => (dialogId: string) => void;
+        closeDialog: () => () => void;
+        setGlobalLoading: () => (loading: boolean) => void;
+        toggleSearch: () => () => void;
+        setSearchOpen: () => (open: boolean) => void;
+    };
+};
+
+/**
+ * Settings Version Management
+ *
+ * Utilities for managing versioned settings with safe migrations.
+ * Enables breaking changes to settings structure while preserving user data.
+ *
+ * @module @omnitron-dev/prism/state
+ */
+
+/**
+ * Migration function signature.
+ * Transforms settings from one version to the next.
+ */
+type MigrationFn<TPrev = unknown, TNext = unknown> = (prevState: TPrev) => TNext;
+/**
+ * Version-specific migration configuration.
+ */
+interface VersionMigration<TPrev = unknown, TNext = unknown> {
+    /** Target version number */
+    version: number;
+    /** Migration function */
+    migrate: MigrationFn<TPrev, TNext>;
+}
+/**
+ * Versioned settings configuration.
+ */
+interface VersionedSettingsConfig<TState> {
+    /** Current version number (increment when structure changes) */
+    version: number;
+    /** Storage key prefix */
+    name: string;
+    /** Ordered list of migrations (version -> next version) */
+    migrations: VersionMigration[];
+    /** Validation function (optional) */
+    validate?: (state: unknown) => state is TState;
+    /** Called when migration fails */
+    onMigrationError?: (error: unknown, fromVersion: number, toVersion: number) => void;
+    /** Called when stored data is corrupt/invalid */
+    onCorruptData?: (error: unknown, rawData: unknown) => void;
+    /** Default state (used when migration fails or data is corrupt) */
+    defaultState: TState;
+}
+/**
+ * Persisted settings with version metadata.
+ */
+interface VersionedPersistedState<TState> {
+    state: TState;
+    version: number;
+}
+/**
+ * Run migrations from one version to another.
+ *
+ * @param state - Current state
+ * @param fromVersion - Starting version
+ * @param toVersion - Target version
+ * @param migrations - Available migrations
+ * @returns Migrated state or null if migration failed
+ */
+declare function runMigrations<TState>(state: unknown, fromVersion: number, toVersion: number, migrations: VersionMigration[]): TState | null;
+/**
+ * Create a versioned storage adapter for Zustand persist.
+ *
+ * This adapter handles:
+ * - Version tracking in stored data
+ * - Automatic migrations when version changes
+ * - Safe fallback to defaults on corrupt data
+ *
+ * @example
+ * ```tsx
+ * interface AppSettings {
+ *   theme: 'light' | 'dark';
+ *   language: string;
+ *   notifications: { email: boolean; push: boolean };
+ * }
+ *
+ * const versionedStorage = createVersionedStorage<AppSettings>({
+ *   version: 3,
+ *   name: 'app-settings',
+ *   defaultState: {
+ *     theme: 'light',
+ *     language: 'en',
+ *     notifications: { email: true, push: true },
+ *   },
+ *   migrations: [
+ *     {
+ *       version: 2,
+ *       migrate: (prev: { theme: string }) => ({
+ *         ...prev,
+ *         language: 'en', // Added in v2
+ *       }),
+ *     },
+ *     {
+ *       version: 3,
+ *       migrate: (prev: { theme: string; language: string }) => ({
+ *         ...prev,
+ *         notifications: { email: true, push: true }, // Added in v3
+ *       }),
+ *     },
+ *   ],
+ * });
+ *
+ * // Use with createPrismStore
+ * const useSettings = createPrismStore<AppSettings>(
+ *   (set) => ({
+ *     ...versionedStorage.defaultState,
+ *     setTheme: (theme) => set({ theme }),
+ *   }),
+ *   {
+ *     name: 'settings',
+ *     persist: {
+ *       storage: versionedStorage.storage,
+ *       version: versionedStorage.version,
+ *       migrate: versionedStorage.migrate,
+ *     },
+ *   }
+ * );
+ * ```
+ */
+declare function createVersionedStorage<TState>(config: VersionedSettingsConfig<TState>): {
+    storage: StateStorage;
+    version: number;
+    migrate: (persistedState: unknown, version: number) => TState;
+    defaultState: TState;
+};
+/**
+ * Create persist options for versioned settings.
+ * Convenience function that returns properly typed PersistOptions.
+ *
+ * @example
+ * ```tsx
+ * const persistOptions = createVersionedPersistOptions<MySettings>({
+ *   version: 2,
+ *   name: 'my-settings',
+ *   defaultState: { /* ... *\/ },
+ *   migrations: [{ version: 2, migrate: (prev) => ({ ...prev, newField: 'default' }) }],
+ * });
+ *
+ * const useStore = createPrismStore(initializer, {
+ *   name: 'my-settings',
+ *   persist: persistOptions,
+ * });
+ * ```
+ */
+declare function createVersionedPersistOptions<TState>(config: VersionedSettingsConfig<TState>): Partial<PersistOptions<TState>>;
+/**
+ * Check if settings need migration.
+ *
+ * @param name - Settings name
+ * @param currentVersion - Current app settings version
+ * @returns Object with migration status
+ */
+declare function checkSettingsVersion(name: string, currentVersion: number): {
+    needsMigration: boolean;
+    storedVersion: number | null;
+    currentVersion: number;
+};
+/**
+ * Clear stored settings (useful for testing or reset).
+ */
+declare function clearSettings(name: string): void;
+/**
+ * Export settings to JSON.
+ */
+declare function exportSettings<TState>(name: string, currentVersion: number): VersionedPersistedState<TState> | null;
+/**
+ * Import settings from JSON.
+ * Will trigger migration if version differs.
+ */
+declare function importSettings<TState>(name: string, data: VersionedPersistedState<TState>): void;
+/**
+ * Create a type guard for settings validation.
+ *
+ * @example
+ * ```tsx
+ * const isValidSettings = createSettingsValidator<MySettings>({
+ *   requiredKeys: ['theme', 'language'],
+ *   typeChecks: {
+ *     theme: (v) => v === 'light' || v === 'dark',
+ *     language: (v) => typeof v === 'string',
+ *   },
+ * });
+ * ```
+ */
+declare function createSettingsValidator<TState extends Record<string, unknown>>(config: {
+    requiredKeys?: (keyof TState)[];
+    typeChecks?: Partial<{
+        [K in keyof TState]: (value: unknown) => boolean;
+    }>;
+}): (state: unknown) => state is TState;
+/**
+ * Creates a simple migration from one version to the next.
+ *
+ * @example
+ * ```typescript
+ * const v2Migration = createMigration(2, (state) => ({
+ *   ...state,
+ *   navLayout: 'vertical',
+ * }));
+ * ```
+ */
+declare function createMigration<TPrev = unknown, TNext = unknown>(version: number, migrate: MigrationFn<TPrev, TNext>): VersionMigration<TPrev, TNext>;
+/**
+ * Creates a migration that renames a field.
+ *
+ * @example
+ * ```typescript
+ * const renameMigration = createRenameMigration(3, 'theme', 'mode', 'light');
+ * ```
+ */
+declare function createRenameMigration<TNext>(version: number, oldKey: string, newKey: string, defaultValue: unknown): VersionMigration;
+/**
+ * Creates a migration that adds a new field with a default value.
+ *
+ * @example
+ * ```typescript
+ * const addFieldMigration = createAddFieldMigration(4, 'stretch', false);
+ * ```
+ */
+declare function createAddFieldMigration<TNext>(version: number, key: string, defaultValue: unknown): VersionMigration;
+/**
+ * Creates a migration that removes a field.
+ *
+ * @example
+ * ```typescript
+ * const removeFieldMigration = createRemoveFieldMigration(5, 'legacyOption');
+ * ```
+ */
+declare function createRemoveFieldMigration<TNext>(version: number, key: string): VersionMigration;
+/**
+ * Creates a migration that transforms a field's value.
+ *
+ * @example
+ * ```typescript
+ * const transformMigration = createTransformMigration(
+ *   6,
+ *   'fontSize',
+ *   (value) => typeof value === 'string' ? parseInt(value, 10) : value,
+ *   16
+ * );
+ * ```
+ */
+declare function createTransformMigration<TNext>(version: number, key: string, transform: (value: unknown) => unknown, defaultValue: unknown): VersionMigration;
+/**
+ * Validates that migrations are in correct sequential order.
+ *
+ * @throws If migrations have duplicate versions
+ */
+declare function validateMigrations(migrations: VersionMigration[]): void;
+/**
+ * Gets migration info for debugging.
+ */
+declare function getMigrationInfo(migrations: VersionMigration[]): Array<{
+    version: number;
+}>;
+
+export { type AuthStatus, type AuthStoreState, type CreateStoreOptions, type MigrationFn, type StoreSelector, type ThemeState, type UIState, type VersionMigration, type VersionedPersistedState, type VersionedSettingsConfig, authStore, checkSettingsVersion, clearSettings, createAddFieldMigration, createMigration, createPersistedStore, createPrismStore, createRemoveFieldMigration, createRenameMigration, createSelectors, createSettingsValidator, createTransformMigration, createUIStore, createVersionedPersistOptions, createVersionedStorage, exportSettings, getMigrationInfo, importSettings, runMigrations, themeStore, uiStore, useAuthStore, useThemeStore, useUIStore, validateMigrations };