@omnitron-dev/prism 0.2.0 → 0.3.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAEL,aAAa,EACb,UAAU,EACV,KAAK,UAAU,EAEf,YAAY,EACZ,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,UAAU,EAEf,UAAU,EACV,OAAO,EACP,KAAK,OAAO,EAEZ,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,QAAQ,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAEL,aAAa,EACb,sBAAsB,EACtB,6BAA6B,EAE7B,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,cAAc,EAEd,uBAAuB,EAEvB,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EAExB,kBAAkB,EAClB,gBAAgB,EAEhB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAC"}

package/dist/state/index.js

@@ -1,5 +1,4 @@
-export { authStore, checkSettingsVersion, clearSettings, createAddFieldMigration, createMigration, createRemoveFieldMigration, createRenameMigration, createSettingsValidator, createTransformMigration, createVersionedPersistOptions, createVersionedStorage, exportSettings, getMigrationInfo, importSettings, runMigrations, themeStore, uiStore, useAuthStore, useThemeStore, useUIStore, validateMigrations } from '../chunk-SNKGGHBT.js';
-export { createPersistedStore, createPrismStore, createSelectors, createUIStore, getDefaultSettings, settingsStore, useSettingsStore } from '../chunk-DDY7TLUI.js';
-import '../chunk-77KIJLPP.js';
+export { authStore, checkSettingsVersion, clearSettings, createAddFieldMigration, createMigration, createRemoveFieldMigration, createRenameMigration, createSettingsValidator, createTransformMigration, createVersionedPersistOptions, createVersionedStorage, exportSettings, getMigrationInfo, importSettings, runMigrations, themeStore, uiStore, useAuthStore, useThemeStore, useUIStore, validateMigrations } from '../chunk-ADG4HZEP.js';
+export { createPersistedStore, createPrismStore, createSelectors, createUIStore, getDefaultSettings, settingsStore, useSettingsStore } from '../chunk-XIXSSI3B.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/state/settings-version.d.ts

@@ -0,0 +1,255 @@
+/**
+ * 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
+ */
+import { type PersistOptions, type StateStorage } from 'zustand/middleware';
+/**
+ * Migration function signature.
+ * Transforms settings from one version to the next.
+ */
+export type MigrationFn<TPrev = unknown, TNext = unknown> = (prevState: TPrev) => TNext;
+/**
+ * Version-specific migration configuration.
+ */
+export interface VersionMigration<TPrev = unknown, TNext = unknown> {
+    /** Target version number */
+    version: number;
+    /** Migration function */
+    migrate: MigrationFn<TPrev, TNext>;
+}
+/**
+ * Versioned settings configuration.
+ */
+export 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.
+ */
+export 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
+ */
+export 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,
+ *     },
+ *   }
+ * );
+ * ```
+ */
+export 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,
+ * });
+ * ```
+ */
+export 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
+ */
+export declare function checkSettingsVersion(name: string, currentVersion: number): {
+    needsMigration: boolean;
+    storedVersion: number | null;
+    currentVersion: number;
+};
+/**
+ * Clear stored settings (useful for testing or reset).
+ */
+export declare function clearSettings(name: string): void;
+/**
+ * Export settings to JSON.
+ */
+export declare function exportSettings<TState>(name: string, currentVersion: number): VersionedPersistedState<TState> | null;
+/**
+ * Import settings from JSON.
+ * Will trigger migration if version differs.
+ */
+export 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',
+ *   },
+ * });
+ * ```
+ */
+export 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',
+ * }));
+ * ```
+ */
+export 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');
+ * ```
+ */
+export 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);
+ * ```
+ */
+export 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');
+ * ```
+ */
+export 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
+ * );
+ * ```
+ */
+export 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
+ */
+export declare function validateMigrations(migrations: VersionMigration[]): void;
+/**
+ * Gets migration info for debugging.
+ */
+export declare function getMigrationInfo(migrations: VersionMigration[]): Array<{
+    version: number;
+}>;
+//# sourceMappingURL=settings-version.d.ts.map

package/dist/state/settings-version.d.ts.map

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

package/dist/state/stores/auth.d.ts

@@ -0,0 +1,155 @@
+/**
+ * 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 state/stores
+ */
+/**
+ * Authentication status.
+ */
+export type AuthStatus = 'loading' | 'authenticated' | 'unauthenticated';
+/**
+ * Auth store state (persisted - only status).
+ */
+export 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;
+}
+/**
+ * Token store state (non-persisted - memory only).
+ * Tokens should NEVER be persisted to localStorage.
+ */
+interface TokenStoreState {
+    /** Access token (memory-only, cleared on page refresh) */
+    token: string | null;
+    setToken: (token: string | null) => void;
+}
+/**
+ * Token store - memory-only, NOT persisted.
+ * For XSS security, tokens should not be in localStorage.
+ */
+export declare const useTokenStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<TokenStoreState>, "setState"> & {
+    setState(nextStateOrUpdater: Partial<TokenStoreState> | TokenStoreState | ((state: {
+        token: string | null;
+        setToken: (token: string | null) => void;
+    }) => void), shouldReplace?: false): void;
+    setState(nextStateOrUpdater: TokenStoreState | ((state: {
+        token: string | null;
+        setToken: (token: string | null) => void;
+    }) => void), shouldReplace: true): void;
+}> | import("zustand").UseBoundStore<Omit<Omit<import("zustand").StoreApi<TokenStoreState>, "devtools" | "setState"> & {
+    setState(partial: Partial<TokenStoreState> | TokenStoreState | ((state: TokenStoreState) => Partial<TokenStoreState> | TokenStoreState), replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: TokenStoreState | ((state: TokenStoreState) => TokenStoreState), replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}, "setState"> & {
+    setState(nextStateOrUpdater: Partial<TokenStoreState> | TokenStoreState | ((state: {
+        token: string | null;
+        setToken: (token: string | null) => void;
+    }) => void), shouldReplace?: false, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(nextStateOrUpdater: TokenStoreState | ((state: {
+        token: string | null;
+        setToken: (token: string | null) => void;
+    }) => void), shouldReplace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): 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;
+ * }
+ * ```
+ */
+export declare const useAuthStore: import("../create-store.js").PersistedStore<AuthStoreState>;
+/**
+ * Select whether auth is loading.
+ */
+export declare function selectIsLoading(state: AuthStoreState): boolean;
+/**
+ * Select whether user is authenticated.
+ */
+export declare function selectIsAuthenticated(state: AuthStoreState): boolean;
+/**
+ * Select whether user is unauthenticated.
+ */
+export declare function selectIsUnauthenticated(state: AuthStoreState): boolean;
+/**
+ * Auth store with auto-generated selectors.
+ */
+export declare const authStore: {
+    (): AuthStoreState;
+    <U>(selector: (state: AuthStoreState) => U): U;
+} & import("zustand").StoreApi<AuthStoreState> & {
+    use: {
+        status: () => AuthStatus;
+        sessionId: () => string | null;
+        setStatus: () => (status: AuthStatus) => void;
+        setAuthenticated: () => (sessionId?: string) => void;
+        setUnauthenticated: () => () => void;
+        clearSession: () => () => void;
+    };
+};
+/**
+ * Hook to set both token and auth status atomically.
+ *
+ * @example
+ * ```tsx
+ * const { login, logout } = useAuth();
+ *
+ * // On successful login
+ * login(accessToken, sessionId);
+ *
+ * // On logout
+ * logout();
+ * ```
+ */
+export declare function useAuth(): {
+    login: (token: string, sessionId?: string) => void;
+    logout: () => void;
+    clearSession: () => void;
+    getToken: () => string | null;
+};
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/state/stores/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/state/stores/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,iCAAiC;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAGzB,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IACxC,gBAAgB,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;GAGG;AACH,UAAU,eAAe;IACvB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC1C;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa;;eARjB,MAAM,GAAG,IAAI;kBACV,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;;;eADjC,MAAM,GAAG,IAAI;kBACV,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;eADjC,MAAM,GAAG,IAAI;kBACV,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;;;;;;;;eADjC,MAAM,GAAG,IAAI;kBACV,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;;;;;;;EAazC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,6DA8CxB,CAAC;AAMF;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAEpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAEtE;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;kCAzHA,UAAU,KAAK,IAAI;6CACR,MAAM,KAAK,IAAI;wCACpB,IAAI;kCACV,IAAI;;CAsH4B,CAAC;AAMvD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO;mBAKJ,MAAM,cAAc,MAAM;;wBA/IvB,IAAI;;EAyJzB"}

package/dist/state/stores/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Prism Stores
+ *
+ * @module state/stores
+ */
+export { useThemeStore, themeStore, type ThemeState } from './theme.js';
+export { useAuthStore, authStore, type AuthStoreState, type AuthStatus } from './auth.js';
+export { useUIStore, uiStore, type UIState } from './ui.js';
+export { useSettingsStore, settingsStore, getDefaultSettings, type SettingsState, type SettingsValues, type NavLayout, type NavColor, } from './settings.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/state/stores/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state/stores/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAExE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAE1F,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAE5D,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,QAAQ,GACd,MAAM,eAAe,CAAC"}

package/dist/state/stores/settings.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Settings Store
+ *
+ * Comprehensive settings management with persistence.
+ * Combines theme preferences with layout and navigation settings.
+ *
+ * @module state/stores/settings
+ */
+import type { ThemePreset, ThemeMode, ThemeDirection, ComponentDensity } from '../../types/theme.js';
+/**
+ * Navigation layout options for dashboard.
+ */
+export type NavLayout = 'vertical' | 'horizontal' | 'mini';
+/**
+ * Navigation color scheme.
+ */
+export type NavColor = 'integrate' | 'apparent';
+/**
+ * Settings state and actions.
+ */
+export interface SettingsState {
+    /** Current theme mode */
+    mode: ThemeMode;
+    /** Current theme preset */
+    preset: ThemePreset;
+    /** Primary color override (hex) */
+    primaryColor: string | null;
+    /** High contrast mode */
+    contrast: 'default' | 'high';
+    /** Text direction */
+    direction: ThemeDirection;
+    /** Base font size (12-20) */
+    fontSize: number;
+    /** Font family override */
+    fontFamily: string | null;
+    /** Component density */
+    density: ComponentDensity;
+    /** Compact sidebar (deprecated — use sidebarCollapsed) */
+    compactSidebar: boolean;
+    /** Per-layout sidebar collapsed state (keyed by persistKey) */
+    sidebarCollapsed: Record<string, boolean>;
+    /** Dashboard navigation layout */
+    navLayout: NavLayout;
+    /** Navigation color scheme */
+    navColor: NavColor;
+    /** Stretch content to full width */
+    stretch: boolean;
+    /** Per-table rows-per-page preference (keyed by table ID) */
+    tableRowsPerPage: Record<string, number>;
+    setMode: (mode: ThemeMode) => void;
+    toggleMode: () => void;
+    setPreset: (preset: ThemePreset) => void;
+    setPrimaryColor: (color: string | null) => void;
+    setContrast: (contrast: 'default' | 'high') => void;
+    setDirection: (direction: ThemeDirection) => void;
+    setFontSize: (size: number) => void;
+    setFontFamily: (family: string | null) => void;
+    setDensity: (density: ComponentDensity) => void;
+    setCompactSidebar: (compact: boolean) => void;
+    setSidebarCollapsed: (key: string, collapsed: boolean) => void;
+    getSidebarCollapsed: (key: string) => boolean;
+    setNavLayout: (layout: NavLayout) => void;
+    setNavColor: (color: NavColor) => void;
+    setStretch: (stretch: boolean) => void;
+    setTableRowsPerPage: (tableId: string, rows: number) => void;
+    getTableRowsPerPage: (tableId: string, fallback?: number) => number;
+    updateSettings: (updates: Partial<SettingsValues>) => void;
+    reset: () => void;
+    canReset: () => boolean;
+}
+/**
+ * Settings values (state without actions).
+ */
+export type SettingsValues = Omit<SettingsState, 'setMode' | 'toggleMode' | 'setPreset' | 'setPrimaryColor' | 'setContrast' | 'setDirection' | 'setFontSize' | 'setFontFamily' | 'setDensity' | 'setCompactSidebar' | 'setSidebarCollapsed' | 'getSidebarCollapsed' | 'setNavLayout' | 'setNavColor' | 'setStretch' | 'setTableRowsPerPage' | 'getTableRowsPerPage' | 'updateSettings' | 'reset' | 'canReset'>;
+/**
+ * Settings store with persistence.
+ *
+ * @example
+ * ```tsx
+ * function SettingsPanel() {
+ *   const { mode, setMode, preset, setPreset, canReset, reset } = useSettingsStore();
+ *
+ *   return (
+ *     <div>
+ *       <Switch checked={mode === 'dark'} onChange={() => setMode(mode === 'dark' ? 'light' : 'dark')} />
+ *       <Select value={preset} onChange={(e) => setPreset(e.target.value as ThemePreset)}>
+ *         <MenuItem value="default-light">Light</MenuItem>
+ *         <MenuItem value="luxury">Luxury</MenuItem>
+ *       </Select>
+ *       {canReset() && <Button onClick={reset}>Reset</Button>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare const useSettingsStore: import("../create-store.js").PersistedStore<SettingsState>;
+/**
+ * Settings store with auto-generated selectors.
+ *
+ * @example
+ * ```tsx
+ * const mode = settingsStore.use.mode();
+ * const preset = settingsStore.use.preset();
+ * ```
+ */
+export declare const settingsStore: {
+    (): SettingsState;
+    <U>(selector: (state: SettingsState) => U): U;
+} & import("zustand").StoreApi<SettingsState> & {
+    use: {
+        mode: () => ThemeMode;
+        preset: () => ThemePreset;
+        primaryColor: () => string | null;
+        contrast: () => "default" | "high";
+        direction: () => ThemeDirection;
+        fontSize: () => number;
+        fontFamily: () => string | null;
+        density: () => ComponentDensity;
+        compactSidebar: () => boolean;
+        sidebarCollapsed: () => Record<string, boolean>;
+        navLayout: () => NavLayout;
+        navColor: () => NavColor;
+        stretch: () => boolean;
+        tableRowsPerPage: () => Record<string, number>;
+        setMode: () => (mode: ThemeMode) => void;
+        toggleMode: () => () => void;
+        setPreset: () => (preset: ThemePreset) => void;
+        setPrimaryColor: () => (color: string | null) => void;
+        setContrast: () => (contrast: 'default' | 'high') => void;
+        setDirection: () => (direction: ThemeDirection) => void;
+        setFontSize: () => (size: number) => void;
+        setFontFamily: () => (family: string | null) => void;
+        setDensity: () => (density: ComponentDensity) => void;
+        setCompactSidebar: () => (compact: boolean) => void;
+        setSidebarCollapsed: () => (key: string, collapsed: boolean) => void;
+        getSidebarCollapsed: () => (key: string) => boolean;
+        setNavLayout: () => (layout: NavLayout) => void;
+        setNavColor: () => (color: NavColor) => void;
+        setStretch: () => (stretch: boolean) => void;
+        setTableRowsPerPage: () => (tableId: string, rows: number) => void;
+        getTableRowsPerPage: () => (tableId: string, fallback?: number) => number;
+        updateSettings: () => (updates: Partial<SettingsValues>) => void;
+        reset: () => () => void;
+        canReset: () => () => boolean;
+    };
+};
+/**
+ * Get default settings values.
+ */
+export declare function getDefaultSettings(): SettingsValues;
+//# sourceMappingURL=settings.d.ts.map

package/dist/state/stores/settings.d.ts.map

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