@omnitron-dev/prism 0.3.0 → 0.3.2

package/dist/chunk-LH4ZZZYB.js

@@ -0,0 +1,37 @@
+// src/utils/create-classes.ts
+var DEFAULT_CLASS_PREFIX = "prism";
+var classPrefix = DEFAULT_CLASS_PREFIX;
+function setClassPrefix(prefix) {
+  classPrefix = prefix;
+}
+function getClassPrefix() {
+  return classPrefix;
+}
+function createClasses(className) {
+  return `${classPrefix}__${className}`;
+}
+function createClassesObject(classNames) {
+  return classNames.reduce(
+    (acc, name) => {
+      acc[name] = createClasses(name);
+      return acc;
+    },
+    {}
+  );
+}
+function createComponentClasses(componentName, suffixes) {
+  if (suffixes) {
+    return suffixes.reduce(
+      (acc, suffix) => {
+        acc[suffix] = createClasses(`${componentName}__${suffix}`);
+        return acc;
+      },
+      {}
+    );
+  }
+  return (suffix) => createClasses(`${componentName}__${suffix}`);
+}
+
+export { DEFAULT_CLASS_PREFIX, createClasses, createClassesObject, createComponentClasses, getClassPrefix, setClassPrefix };
+//# sourceMappingURL=chunk-LH4ZZZYB.js.map
+//# sourceMappingURL=chunk-LH4ZZZYB.js.map

package/dist/chunk-LH4ZZZYB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/create-classes.ts"],"names":[],"mappings":";AAiBO,IAAM,oBAAA,GAAuB;AAEpC,IAAI,WAAA,GAAc,oBAAA;AAaX,SAAS,eAAe,MAAA,EAAsB;AACnD,EAAA,WAAA,GAAc,MAAA;AAChB;AAOO,SAAS,cAAA,GAAyB;AACvC,EAAA,OAAO,WAAA;AACT;AAqBO,SAAS,cAAc,SAAA,EAA2B;AACvD,EAAA,OAAO,CAAA,EAAG,WAAW,CAAA,EAAA,EAAK,SAAS,CAAA,CAAA;AACrC;AAcO,SAAS,oBAAsC,UAAA,EAA6C;AACjG,EAAA,OAAO,UAAA,CAAW,MAAA;AAAA,IAChB,CAAC,KAAK,IAAA,KAAS;AACb,MAAA,GAAA,CAAI,IAAI,CAAA,GAAI,aAAA,CAAc,IAAI,CAAA;AAC9B,MAAA,OAAO,GAAA;AAAA,IACT,CAAA;AAAA,IACA;AAAC,GACH;AACF;AAoCO,SAAS,sBAAA,CACd,eACA,QAAA,EACkD;AAClD,EAAA,IAAI,QAAA,EAAU;AACZ,IAAA,OAAO,QAAA,CAAS,MAAA;AAAA,MACd,CAAC,KAAK,MAAA,KAAW;AACf,QAAA,GAAA,CAAI,MAAM,CAAA,GAAI,aAAA,CAAc,GAAG,aAAa,CAAA,EAAA,EAAK,MAAM,CAAA,CAAE,CAAA;AACzD,QAAA,OAAO,GAAA;AAAA,MACT,CAAA;AAAA,MACA;AAAC,KACH;AAAA,EACF;AACA,EAAA,OAAO,CAAC,MAAA,KAAmB,aAAA,CAAc,GAAG,aAAa,CAAA,EAAA,EAAK,MAAM,CAAA,CAAE,CAAA;AACxE","file":"chunk-LH4ZZZYB.js","sourcesContent":["/**\n * Class Name Factory\n *\n * Creates prefixed CSS class names for consistent component styling.\n * Uses a configurable prefix to avoid collisions with other libraries.\n *\n * @module utils/create-classes\n */\n\n// =============================================================================\n// CONFIGURATION\n// =============================================================================\n\n/**\n * Default class prefix for Prism components.\n * Can be overridden via PRISM_CLASS_PREFIX environment variable.\n */\nexport const DEFAULT_CLASS_PREFIX = 'prism';\n\nlet classPrefix = DEFAULT_CLASS_PREFIX;\n\n/**\n * Set the global class prefix for all Prism components.\n *\n * @param prefix - New class prefix to use\n *\n * @example\n * ```ts\n * setClassPrefix('my-app');\n * createClasses('button__root'); // => \"my-app__button__root\"\n * ```\n */\nexport function setClassPrefix(prefix: string): void {\n  classPrefix = prefix;\n}\n\n/**\n * Get the current class prefix.\n *\n * @returns Current class prefix\n */\nexport function getClassPrefix(): string {\n  return classPrefix;\n}\n\n// =============================================================================\n// CLASS FACTORY\n// =============================================================================\n\n/**\n * Create a prefixed CSS class name.\n *\n * @param className - Class name suffix (e.g., \"button__root\")\n * @returns Prefixed class name (e.g., \"prism__button__root\")\n *\n * @example\n * ```ts\n * createClasses('chart__root')\n * // => \"prism__chart__root\"\n *\n * createClasses('chart__loading')\n * // => \"prism__chart__loading\"\n * ```\n */\nexport function createClasses(className: string): string {\n  return `${classPrefix}__${className}`;\n}\n\n/**\n * Create multiple prefixed CSS class names.\n *\n * @param classNames - Array of class name suffixes\n * @returns Object mapping original names to prefixed names\n *\n * @example\n * ```ts\n * const classes = createClassesObject(['root', 'loading', 'label']);\n * // => { root: \"prism__root\", loading: \"prism__loading\", label: \"prism__label\" }\n * ```\n */\nexport function createClassesObject<T extends string>(classNames: readonly T[]): Record<T, string> {\n  return classNames.reduce(\n    (acc, name) => {\n      acc[name] = createClasses(name);\n      return acc;\n    },\n    {} as Record<T, string>\n  );\n}\n\n/**\n * Create a class name factory for a specific component.\n *\n * @param componentName - Component name (e.g., \"chart\", \"button\")\n * @returns Function that creates prefixed class names for that component\n *\n * @example\n * ```ts\n * const chartClass = createComponentClasses('chart');\n * chartClass('root');    // => \"prism__chart__root\"\n * chartClass('loading'); // => \"prism__chart__loading\"\n * ```\n */\nexport function createComponentClasses(componentName: string): (suffix: string) => string;\n\n/**\n * Create a class name object for a specific component with predefined suffixes.\n *\n * @param componentName - Component name (e.g., \"chart\", \"button\")\n * @param suffixes - Array of class name suffixes\n * @returns Object mapping suffix names to prefixed class names\n *\n * @example\n * ```ts\n * const chartClasses = createComponentClasses('chart', ['root', 'loading', 'label'] as const);\n * chartClasses.root;    // => \"prism__chart__root\"\n * chartClasses.loading; // => \"prism__chart__loading\"\n * ```\n */\nexport function createComponentClasses<T extends string>(\n  componentName: string,\n  suffixes: readonly T[]\n): Record<T, string>;\n\nexport function createComponentClasses<T extends string>(\n  componentName: string,\n  suffixes?: readonly T[]\n): ((suffix: string) => string) | Record<T, string> {\n  if (suffixes) {\n    return suffixes.reduce(\n      (acc, suffix) => {\n        acc[suffix] = createClasses(`${componentName}__${suffix}`);\n        return acc;\n      },\n      {} as Record<T, string>\n    );\n  }\n  return (suffix: string) => createClasses(`${componentName}__${suffix}`);\n}\n"]}

package/dist/chunk-NFJ7CPG3.js

@@ -0,0 +1,13 @@
+import { useEffect } from 'react';
+
+// src/components/scroll-to-top/scroll-to-top.tsx
+function ScrollToTop({ pathname }) {
+  useEffect(() => {
+    window.scrollTo(0, 0);
+  }, [pathname]);
+  return null;
+}
+
+export { ScrollToTop };
+//# sourceMappingURL=chunk-NFJ7CPG3.js.map
+//# sourceMappingURL=chunk-NFJ7CPG3.js.map

package/dist/chunk-NFJ7CPG3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/scroll-to-top/scroll-to-top.tsx"],"names":[],"mappings":";;;AAqCO,SAAS,WAAA,CAAY,EAAE,QAAA,EAAS,EAAqB;AAC1D,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAA,CAAO,QAAA,CAAS,GAAG,CAAC,CAAA;AAAA,EACtB,CAAA,EAAG,CAAC,QAAQ,CAAC,CAAA;AAEb,EAAA,OAAO,IAAA;AACT","file":"chunk-NFJ7CPG3.js","sourcesContent":["'use client';\n\n/**\n * ScrollToTop\n *\n * Scrolls the window to the top on pathname change.\n * Framework-agnostic: accepts `pathname` as a prop.\n *\n * @module components/scroll-to-top\n */\n\nimport { useEffect } from 'react';\n\nexport interface ScrollToTopProps {\n  /** Current route pathname. Scrolls to top on change. */\n  pathname: string;\n}\n\n/**\n * ScrollToTop - Restores scroll position to top on route change.\n *\n * @example\n * ```tsx\n * import { useLocation } from 'react-router-dom';\n * import { ScrollToTop } from '@omnitron-dev/prism';\n *\n * function App() {\n *   const { pathname } = useLocation();\n *   return (\n *     <>\n *       <ScrollToTop pathname={pathname} />\n *       <Routes>...</Routes>\n *     </>\n *   );\n * }\n * ```\n */\nexport function ScrollToTop({ pathname }: ScrollToTopProps) {\n  useEffect(() => {\n    window.scrollTo(0, 0);\n  }, [pathname]);\n\n  return null;\n}\n"]}

package/dist/chunk-NFPOIHD4.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-NFPOIHD4.js.map
+//# sourceMappingURL=chunk-NFPOIHD4.js.map

package/dist/{chunk-AYYFMTMI.js.map → chunk-NFPOIHD4.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-AYYFMTMI.js","sourcesContent":[]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-NFPOIHD4.js"}

package/dist/{chunk-XIXSSI3B.js → chunk-NJM5AVBM.js}

@@ -2,6 +2,7 @@ import { create } from 'zustand';
 import { devtools, persist } from 'zustand/middleware';
 import { immer } from 'zustand/middleware/immer';
 
+// src/state/create-store.ts
 function createPrismStore(initializer, options) {
   const { name, persist: persistOption, devtools: devtoolsOption = true } = options;
   const enableDevtools = devtoolsOption && typeof window !== "undefined";
@@ -161,5 +162,5 @@ function getDefaultSettings() {
 }
 
 export { createPersistedStore, createPrismStore, createSelectors, createUIStore, getDefaultSettings, settingsStore, useSettingsStore };
-//# sourceMappingURL=chunk-XIXSSI3B.js.map
-//# sourceMappingURL=chunk-XIXSSI3B.js.map
+//# sourceMappingURL=chunk-NJM5AVBM.js.map
+//# sourceMappingURL=chunk-NJM5AVBM.js.map

package/dist/chunk-NJM5AVBM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/state/create-store.ts","../src/state/stores/settings.ts"],"names":[],"mappings":"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","file":"chunk-NJM5AVBM.js","sourcesContent":["/**\n * Prism Store Factory\n *\n * Creates Zustand stores with sensible defaults:\n * - Immer middleware for immutable updates\n * - DevTools integration\n * - Optional persistence\n *\n * @module @omnitron-dev/prism/state\n */\n\nimport { create, type StateCreator, type StoreApi, type UseBoundStore } from 'zustand';\nimport { devtools, persist, type PersistOptions, type DevtoolsOptions } from 'zustand/middleware';\nimport { immer } from 'zustand/middleware/immer';\n\n/**\n * Options for creating a Prism store.\n */\nexport interface CreateStoreOptions<T> {\n  /** Store name for DevTools and persistence */\n  name: string;\n  /** Enable persistence to localStorage */\n  persist?: boolean | Partial<PersistOptions<T>>;\n  /** Enable Redux DevTools (default: true in development) */\n  devtools?: boolean;\n}\n\n/**\n * Middleware type helpers for proper typing.\n */\ntype ImmerMiddleware = ['zustand/immer', never];\n\n/**\n * Creates a Zustand store with Prism defaults.\n *\n * @example\n * ```typescript\n * interface CounterState {\n *   count: number;\n *   increment: () => void;\n *   decrement: () => void;\n * }\n *\n * export const useCounterStore = createPrismStore<CounterState>(\n *   (set) => ({\n *     count: 0,\n *     increment: () => set((state) => { state.count += 1; }),\n *     decrement: () => set((state) => { state.count -= 1; }),\n *   }),\n *   { name: 'counter', persist: true }\n * );\n * ```\n */\n/**\n * A store that persists — the return type of `createPersistedStore`.\n *\n * Narrower than `createPrismStore`'s union: the `persist` API is guaranteed,\n * because this factory always installs the middleware.\n */\nexport type PersistedStore<T extends object> = UseBoundStore<StoreApi<T>> & {\n  persist: {\n    hasHydrated: () => boolean;\n    rehydrate: () => Promise<void> | void;\n    clearStorage: () => void;\n    setOptions: (options: Partial<PersistOptions<T>>) => void;\n    onHydrate: (fn: (state: T) => void) => () => void;\n    onFinishHydration: (fn: (state: T) => void) => () => void;\n    getOptions: () => Partial<PersistOptions<T>>;\n  };\n};\n\nexport function createPrismStore<T extends object>(\n  initializer: StateCreator<T, [ImmerMiddleware], []>,\n  options: CreateStoreOptions<T>\n) {\n  const { name, persist: persistOption, devtools: devtoolsOption = true } = options;\n  const enableDevtools = devtoolsOption && typeof window !== 'undefined';\n\n  // Prepare persist config\n  const persistConfig: PersistOptions<T> | null = persistOption\n    ? {\n        name: `prism-${name}`,\n        ...(typeof persistOption === 'object' ? persistOption : {}),\n      }\n    : null;\n\n  // Prepare devtools config\n  const devtoolsConfig: DevtoolsOptions = { name: `Prism:${name}` };\n\n  // Create store based on which middleware are enabled\n  // Using explicit middleware chains for proper type inference\n  if (persistConfig && enableDevtools) {\n    return create<T>()(devtools(persist(immer(initializer), persistConfig), devtoolsConfig));\n  }\n\n  if (persistConfig) {\n    return create<T>()(persist(immer(initializer), persistConfig));\n  }\n\n  if (enableDevtools) {\n    return create<T>()(devtools(immer(initializer), devtoolsConfig));\n  }\n\n  // No middleware except immer\n  return create<T>()(immer(initializer));\n}\n\n/**\n * Creates a simple store without persistence (for UI-only state).\n */\nexport function createUIStore<T extends object>(initializer: StateCreator<T, [ImmerMiddleware], []>, name: string) {\n  return createPrismStore(initializer, { name, persist: false });\n}\n\n/**\n * Merge a persisted state written under an older version into the current one.\n *\n * zustand's default when a version differs and no `migrate` is supplied is to\n * discard the stored state entirely and fall back to defaults — it logs\n * \"State loaded from storage couldn't be migrated since no migrate function\n * was provided\" to the console and moves on. In a browser that message is\n * seen by nobody, and what the user sees is their theme, layout, density and\n * language silently back at factory settings after an update that had nothing\n * to do with any of them.\n *\n * Discarding is the safe default for a library that cannot know what changed.\n * It is the wrong default here, because these stores hold preferences: the\n * cost of keeping a value that no longer means anything is one wrong setting,\n * and the cost of dropping everything is every setting.\n *\n * So: keep each stored key whose name still exists in the current defaults\n * AND whose type still matches. A field that was removed is dropped, a field\n * that changed shape is replaced by the new default, everything else\n * survives. A store needing more than that passes its own `migrate` — this\n * only fills in where none was given.\n */\nfunction mergeCompatibleFields<T extends object>(persisted: unknown, current: T): T {\n  if (!persisted || typeof persisted !== 'object') return current;\n\n  const stored = persisted as Record<string, unknown>;\n  const merged = { ...current } as Record<string, unknown>;\n\n  for (const [key, value] of Object.entries(stored)) {\n    if (!(key in merged)) continue;                       // field is gone\n    const currentValue = merged[key];\n    if (typeof currentValue === 'function') continue;     // actions are not state\n    if (currentValue === undefined || currentValue === null) {\n      merged[key] = value;\n      continue;\n    }\n    if (value === null || value === undefined) continue;  // keep the default\n    // Same primitive type, or both plain objects / both arrays.\n    const sameShape =\n      typeof value === typeof currentValue &&\n      Array.isArray(value) === Array.isArray(currentValue);\n    if (sameShape) merged[key] = value;\n  }\n\n  return merged as T;\n}\n\n/**\n * Creates a persisted store (for settings, preferences).\n *\n * Includes a storage wrapper that catches errors from localStorage\n * (e.g., private browsing, quota exceeded) and falls back gracefully, and a\n * default `migrate` that preserves settings across a version bump — see\n * `mergeCompatibleFields`.\n */\nexport function createPersistedStore<T extends object>(\n  initializer: StateCreator<T, [ImmerMiddleware], []>,\n  name: string,\n  persistOptions?: Partial<PersistOptions<T>>\n): PersistedStore<T> {\n  // `createPrismStore` decides its middleware chain at runtime (devtools are\n  // enabled only in a browser), so its return type is a union in which one\n  // branch carries no `persist` API. This function always persists — the\n  // whole of its contract — and callers need `persist.hasHydrated()` and\n  // `persist.rehydrate()`. Stating the narrower type here is what makes\n  // those reachable; without it a caller has to cast, which is how a store\n  // that does not persist would look identical to one that does.\n  return createPrismStore(initializer, {\n    name,\n    persist: {\n      version: 1,\n      // Two hooks, and both are needed. `migrate` runs only on a version\n      // mismatch and decides whether the stored state survives at all —\n      // returning it unchanged is what stops zustand discarding it. `merge`\n      // runs every load and decides how it combines with the current\n      // defaults; zustand's own is a shallow spread, which would let a\n      // stored field of the wrong shape overwrite a good default.\n      migrate: (persisted: unknown) => persisted as T,\n      merge: (persisted: unknown, current: T) => mergeCompatibleFields(persisted, current),\n      storage: {\n        getItem: (key) => {\n          try {\n            const value = localStorage.getItem(key);\n            return value ? JSON.parse(value) : null;\n          } catch {\n            return null;\n          }\n        },\n        setItem: (key, value) => {\n          try {\n            localStorage.setItem(key, JSON.stringify(value));\n          } catch {\n            // Silently fail (private browsing, quota exceeded)\n          }\n        },\n        removeItem: (key) => {\n          try {\n            localStorage.removeItem(key);\n          } catch {\n            // Silently fail\n          }\n        },\n      },\n      ...persistOptions,\n    },\n  }) as PersistedStore<T>;\n}\n\n/**\n * Selector type for store state.\n */\nexport type StoreSelector<T, U> = (state: T) => U;\n\n/**\n * Helper to create typed selectors for a store.\n *\n * @example\n * ```typescript\n * const selectors = createSelectors(useUserStore);\n * const userName = selectors.use.name();\n * ```\n */\nexport function createSelectors<T extends object>(store: UseBoundStore<StoreApi<T>>) {\n  const storeIn = store as UseBoundStore<StoreApi<T>> & {\n    use: { [K in keyof T]: () => T[K] };\n  };\n\n  // Use Proxy so selectors work for dynamically added state keys,\n  // not just keys present at creation time\n  storeIn.use = new Proxy({} as { [K in keyof T]: () => T[K] }, {\n    get: (_target, prop: string | symbol) => {\n      if (typeof prop !== 'string') return undefined;\n      return () => store((state: T) => state[prop as keyof T]);\n    },\n  });\n\n  return storeIn;\n}\n","/**\n * Settings Store\n *\n * Comprehensive settings management with persistence.\n * Combines theme preferences with layout and navigation settings.\n *\n * @module state/stores/settings\n */\n\nimport { createPersistedStore, createSelectors } from '../create-store.js';\nimport type { ThemePreset, ThemeMode, ThemeDirection, ComponentDensity } from '../../types/theme.js';\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\n/**\n * Navigation layout options for dashboard.\n */\nexport type NavLayout = 'vertical' | 'horizontal' | 'mini';\n\n/**\n * Navigation color scheme.\n */\nexport type NavColor = 'integrate' | 'apparent';\n\n/**\n * Settings state and actions.\n */\nexport interface SettingsState {\n  // Theme\n  /** Current theme mode */\n  mode: ThemeMode;\n  /** Current theme preset */\n  preset: ThemePreset;\n  /** Primary color override (hex) */\n  primaryColor: string | null;\n  /** High contrast mode */\n  contrast: 'default' | 'high';\n  /** Text direction */\n  direction: ThemeDirection;\n\n  // Typography\n  /** Base font size (12-20) */\n  fontSize: number;\n  /** Font family override */\n  fontFamily: string | null;\n\n  // Layout\n  /** Component density */\n  density: ComponentDensity;\n  /** Compact sidebar (deprecated — use sidebarCollapsed) */\n  compactSidebar: boolean;\n  /** Per-layout sidebar collapsed state (keyed by persistKey) */\n  sidebarCollapsed: Record<string, boolean>;\n  /** Dashboard navigation layout */\n  navLayout: NavLayout;\n  /** Navigation color scheme */\n  navColor: NavColor;\n  /** Stretch content to full width */\n  stretch: boolean;\n\n  /** Per-table rows-per-page preference (keyed by table ID) */\n  tableRowsPerPage: Record<string, number>;\n\n  // Actions\n  setMode: (mode: ThemeMode) => void;\n  toggleMode: () => void;\n  setPreset: (preset: ThemePreset) => void;\n  setPrimaryColor: (color: string | null) => void;\n  setContrast: (contrast: 'default' | 'high') => void;\n  setDirection: (direction: ThemeDirection) => void;\n  setFontSize: (size: number) => void;\n  setFontFamily: (family: string | null) => void;\n  setDensity: (density: ComponentDensity) => void;\n  setCompactSidebar: (compact: boolean) => void;\n  setSidebarCollapsed: (key: string, collapsed: boolean) => void;\n  getSidebarCollapsed: (key: string) => boolean;\n  setNavLayout: (layout: NavLayout) => void;\n  setNavColor: (color: NavColor) => void;\n  setStretch: (stretch: boolean) => void;\n  setTableRowsPerPage: (tableId: string, rows: number) => void;\n  getTableRowsPerPage: (tableId: string, fallback?: number) => number;\n  updateSettings: (updates: Partial<SettingsValues>) => void;\n  reset: () => void;\n  canReset: () => boolean;\n}\n\n/**\n * Settings values (state without actions).\n */\nexport type SettingsValues = Omit<\n  SettingsState,\n  | 'setMode'\n  | 'toggleMode'\n  | 'setPreset'\n  | 'setPrimaryColor'\n  | 'setContrast'\n  | 'setDirection'\n  | 'setFontSize'\n  | 'setFontFamily'\n  | 'setDensity'\n  | 'setCompactSidebar'\n  | 'setSidebarCollapsed'\n  | 'getSidebarCollapsed'\n  | 'setNavLayout'\n  | 'setNavColor'\n  | 'setStretch'\n  | 'setTableRowsPerPage'\n  | 'getTableRowsPerPage'\n  | 'updateSettings'\n  | 'reset'\n  | 'canReset'\n>;\n\n// =============================================================================\n// DEFAULT STATE\n// =============================================================================\n\nconst defaultSettings: SettingsValues = {\n  // Theme\n  mode: 'light',\n  preset: 'default-light',\n  primaryColor: null,\n  contrast: 'default',\n  direction: 'ltr',\n\n  // Typography\n  fontSize: 16,\n  fontFamily: null, // null = use Prism default (Nunito Sans Variable)\n\n  // Layout\n  density: 'standard',\n  compactSidebar: false,\n  sidebarCollapsed: {},\n  navLayout: 'vertical',\n  navColor: 'integrate',\n  stretch: true,\n  tableRowsPerPage: {},\n};\n\n// =============================================================================\n// STORE\n// =============================================================================\n\n/**\n * Settings store with persistence.\n *\n * @example\n * ```tsx\n * function SettingsPanel() {\n *   const { mode, setMode, preset, setPreset, canReset, reset } = useSettingsStore();\n *\n *   return (\n *     <div>\n *       <Switch checked={mode === 'dark'} onChange={() => setMode(mode === 'dark' ? 'light' : 'dark')} />\n *       <Select value={preset} onChange={(e) => setPreset(e.target.value as ThemePreset)}>\n *         <MenuItem value=\"default-light\">Light</MenuItem>\n *         <MenuItem value=\"luxury\">Luxury</MenuItem>\n *       </Select>\n *       {canReset() && <Button onClick={reset}>Reset</Button>}\n *     </div>\n *   );\n * }\n * ```\n */\nexport const useSettingsStore = createPersistedStore<SettingsState>(\n  (set, get) => ({\n    ...defaultSettings,\n\n    // Theme actions\n    setMode: (mode) => set({ mode }),\n    toggleMode: () =>\n      set((state) => {\n        state.mode = state.mode === 'light' ? 'dark' : 'light';\n      }),\n    setPreset: (preset) => set({ preset }),\n    setPrimaryColor: (primaryColor) => set({ primaryColor }),\n    setContrast: (contrast) => set({ contrast }),\n    setDirection: (direction) => set({ direction }),\n\n    // Typography actions\n    setFontSize: (fontSize) => set({ fontSize: Math.min(20, Math.max(12, fontSize)) }),\n    setFontFamily: (fontFamily) => set({ fontFamily }),\n\n    // Layout actions\n    setDensity: (density) => set({ density }),\n    setCompactSidebar: (compactSidebar) => set({ compactSidebar }),\n    setSidebarCollapsed: (key, collapsed) =>\n      set((state) => {\n        state.sidebarCollapsed = { ...state.sidebarCollapsed, [key]: collapsed };\n      }),\n    getSidebarCollapsed: (key) => get().sidebarCollapsed[key] ?? false,\n    setNavLayout: (navLayout) => set({ navLayout }),\n    setNavColor: (navColor) => set({ navColor }),\n    setStretch: (stretch) => set({ stretch }),\n    setTableRowsPerPage: (tableId, rows) =>\n      set((state) => {\n        state.tableRowsPerPage = { ...state.tableRowsPerPage, [tableId]: rows };\n      }),\n    getTableRowsPerPage: (tableId, fallback = 25) => get().tableRowsPerPage[tableId] ?? fallback,\n\n    // Batch update\n    updateSettings: (updates) => set(updates),\n\n    // Reset\n    reset: () => set(defaultSettings),\n    canReset: () => {\n      const state = get();\n      return Object.keys(defaultSettings).some(\n        (key) => state[key as keyof SettingsValues] !== defaultSettings[key as keyof SettingsValues]\n      );\n    },\n  }),\n  'settings'\n);\n\n/**\n * Settings store with auto-generated selectors.\n *\n * @example\n * ```tsx\n * const mode = settingsStore.use.mode();\n * const preset = settingsStore.use.preset();\n * ```\n */\nexport const settingsStore = createSelectors(useSettingsStore);\n\n/**\n * Get default settings values.\n */\nexport function getDefaultSettings(): SettingsValues {\n  return { ...defaultSettings };\n}\n"]}