@omnitron-dev/prism 0.1.3 → 0.3.0

package/dist/chunk-DDY7TLUI.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/state/create-store.ts","../src/state/stores/settings.ts"],"names":[],"mappings":";;;;AAuDO,SAAS,gBAAA,CACd,aACA,OAAA,EACA;AACA,EAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAS,eAAe,QAAA,EAAU,cAAA,GAAiB,MAAK,GAAI,OAAA;AAC1E,EAAA,MAAM,cAAA,GAAiB,cAAA,IAAkB,OAAO,MAAA,KAAW,WAAA;AAG3D,EAAA,MAAM,gBAA0C,aAAA,GAC5C;AAAA,IACE,IAAA,EAAM,SAAS,IAAI,CAAA,CAAA;AAAA,IACnB,GAAI,OAAO,aAAA,KAAkB,QAAA,GAAW,gBAAgB;AAAC,GAC3D,GACA,IAAA;AAGJ,EAAA,MAAM,cAAA,GAAkC,EAAE,IAAA,EAAM,CAAA,MAAA,EAAS,IAAI,CAAA,CAAA,EAAG;AAIhE,EAAA,IAAI,iBAAiB,cAAA,EAAgB;AACnC,IAAA,OAAO,MAAA,EAAU,CAAE,QAAA,CAAS,OAAA,CAAQ,KAAA,CAAM,WAAW,CAAA,EAAG,aAAa,CAAA,EAAG,cAAc,CAAC,CAAA;AAAA,EACzF;AAEA,EAAA,IAAI,aAAA,EAAe;AACjB,IAAA,OAAO,QAAU,CAAE,OAAA,CAAQ,MAAM,WAAW,CAAA,EAAG,aAAa,CAAC,CAAA;AAAA,EAC/D;AAEA,EAAA,IAAI,cAAA,EAAgB;AAClB,IAAA,OAAO,QAAU,CAAE,QAAA,CAAS,MAAM,WAAW,CAAA,EAAG,cAAc,CAAC,CAAA;AAAA,EACjE;AAGA,EAAA,OAAO,MAAA,EAAU,CAAE,KAAA,CAAM,WAAW,CAAC,CAAA;AACvC;AAKO,SAAS,aAAA,CAAgC,aAAqD,IAAA,EAAc;AACjH,EAAA,OAAO,iBAAiB,WAAA,EAAa,EAAE,IAAA,EAAM,OAAA,EAAS,OAAO,CAAA;AAC/D;AAQO,SAAS,oBAAA,CACd,WAAA,EACA,IAAA,EACA,cAAA,EACA;AACA,EAAA,OAAO,iBAAiB,WAAA,EAAa;AAAA,IACnC,IAAA;AAAA,IACA,OAAA,EAAS;AAAA,MACP,OAAA,EAAS,CAAA;AAAA,MACT,OAAA,EAAS;AAAA,QACP,OAAA,EAAS,CAAC,GAAA,KAAQ;AAChB,UAAA,IAAI;AACF,YAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,OAAA,CAAQ,GAAG,CAAA;AACtC,YAAA,OAAO,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,KAAK,CAAA,GAAI,IAAA;AAAA,UACrC,CAAA,CAAA,MAAQ;AACN,YAAA,OAAO,IAAA;AAAA,UACT;AAAA,QACF,CAAA;AAAA,QACA,OAAA,EAAS,CAAC,GAAA,EAAK,KAAA,KAAU;AACvB,UAAA,IAAI;AACF,YAAA,YAAA,CAAa,OAAA,CAAQ,GAAA,EAAK,IAAA,CAAK,SAAA,CAAU,KAAK,CAAC,CAAA;AAAA,UACjD,CAAA,CAAA,MAAQ;AAAA,UAER;AAAA,QACF,CAAA;AAAA,QACA,UAAA,EAAY,CAAC,GAAA,KAAQ;AACnB,UAAA,IAAI;AACF,YAAA,YAAA,CAAa,WAAW,GAAG,CAAA;AAAA,UAC7B,CAAA,CAAA,MAAQ;AAAA,UAER;AAAA,QACF;AAAA,OACF;AAAA,MACA,GAAG;AAAA;AACL,GACD,CAAA;AACH;AAgBO,SAAS,gBAAkC,KAAA,EAAmC;AACnF,EAAA,MAAM,OAAA,GAAU,KAAA;AAMhB,EAAA,OAAA,CAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,EAAC,EAAqC;AAAA,IAC5D,GAAA,EAAK,CAAC,OAAA,EAAS,IAAA,KAA0B;AACvC,MAAA,IAAI,OAAO,IAAA,KAAS,QAAA,EAAU,OAAO,MAAA;AACrC,MAAA,OAAO,MAAM,KAAA,CAAM,CAAC,KAAA,KAAa,KAAA,CAAM,IAAe,CAAC,CAAA;AAAA,IACzD;AAAA,GACD,CAAA;AAED,EAAA,OAAO,OAAA;AACT;;;ACpDA,IAAM,eAAA,GAAkC;AAAA;AAAA,EAEtC,IAAA,EAAM,OAAA;AAAA,EACN,MAAA,EAAQ,eAAA;AAAA,EACR,YAAA,EAAc,IAAA;AAAA,EACd,QAAA,EAAU,SAAA;AAAA,EACV,SAAA,EAAW,KAAA;AAAA;AAAA,EAGX,QAAA,EAAU,EAAA;AAAA,EACV,UAAA,EAAY,IAAA;AAAA;AAAA;AAAA,EAGZ,OAAA,EAAS,UAAA;AAAA,EACT,cAAA,EAAgB,KAAA;AAAA,EAChB,kBAAkB,EAAC;AAAA,EACnB,SAAA,EAAW,UAAA;AAAA,EACX,QAAA,EAAU,WAAA;AAAA,EACV,OAAA,EAAS,IAAA;AAAA,EACT,kBAAkB;AACpB,CAAA;AA2BO,IAAM,gBAAA,GAAmB,oBAAA;AAAA,EAC9B,CAAC,KAAK,GAAA,MAAS;AAAA,IACb,GAAG,eAAA;AAAA;AAAA,IAGH,SAAS,CAAC,IAAA,KAAS,GAAA,CAAI,EAAE,MAAM,CAAA;AAAA,IAC/B,UAAA,EAAY,MACV,GAAA,CAAI,CAAC,KAAA,KAAU;AACb,MAAA,KAAA,CAAM,IAAA,GAAO,KAAA,CAAM,IAAA,KAAS,OAAA,GAAU,MAAA,GAAS,OAAA;AAAA,IACjD,CAAC,CAAA;AAAA,IACH,WAAW,CAAC,MAAA,KAAW,GAAA,CAAI,EAAE,QAAQ,CAAA;AAAA,IACrC,iBAAiB,CAAC,YAAA,KAAiB,GAAA,CAAI,EAAE,cAAc,CAAA;AAAA,IACvD,aAAa,CAAC,QAAA,KAAa,GAAA,CAAI,EAAE,UAAU,CAAA;AAAA,IAC3C,cAAc,CAAC,SAAA,KAAc,GAAA,CAAI,EAAE,WAAW,CAAA;AAAA;AAAA,IAG9C,WAAA,EAAa,CAAC,QAAA,KAAa,GAAA,CAAI,EAAE,QAAA,EAAU,IAAA,CAAK,GAAA,CAAI,EAAA,EAAI,KAAK,GAAA,CAAI,EAAA,EAAI,QAAQ,CAAC,GAAG,CAAA;AAAA,IACjF,eAAe,CAAC,UAAA,KAAe,GAAA,CAAI,EAAE,YAAY,CAAA;AAAA;AAAA,IAGjD,YAAY,CAAC,OAAA,KAAY,GAAA,CAAI,EAAE,SAAS,CAAA;AAAA,IACxC,mBAAmB,CAAC,cAAA,KAAmB,GAAA,CAAI,EAAE,gBAAgB,CAAA;AAAA,IAC7D,qBAAqB,CAAC,GAAA,EAAK,SAAA,KACzB,GAAA,CAAI,CAAC,KAAA,KAAU;AACb,MAAA,KAAA,CAAM,gBAAA,GAAmB,EAAE,GAAG,KAAA,CAAM,kBAAkB,CAAC,GAAG,GAAG,SAAA,EAAU;AAAA,IACzE,CAAC,CAAA;AAAA,IACH,qBAAqB,CAAC,GAAA,KAAQ,KAAI,CAAE,gBAAA,CAAiB,GAAG,CAAA,IAAK,KAAA;AAAA,IAC7D,cAAc,CAAC,SAAA,KAAc,GAAA,CAAI,EAAE,WAAW,CAAA;AAAA,IAC9C,aAAa,CAAC,QAAA,KAAa,GAAA,CAAI,EAAE,UAAU,CAAA;AAAA,IAC3C,YAAY,CAAC,OAAA,KAAY,GAAA,CAAI,EAAE,SAAS,CAAA;AAAA,IACxC,qBAAqB,CAAC,OAAA,EAAS,IAAA,KAC7B,GAAA,CAAI,CAAC,KAAA,KAAU;AACb,MAAA,KAAA,CAAM,gBAAA,GAAmB,EAAE,GAAG,KAAA,CAAM,kBAAkB,CAAC,OAAO,GAAG,IAAA,EAAK;AAAA,IACxE,CAAC,CAAA;AAAA,IACH,mBAAA,EAAqB,CAAC,OAAA,EAAS,QAAA,GAAW,OAAO,GAAA,EAAI,CAAE,gBAAA,CAAiB,OAAO,CAAA,IAAK,QAAA;AAAA;AAAA,IAGpF,cAAA,EAAgB,CAAC,OAAA,KAAY,GAAA,CAAI,OAAO,CAAA;AAAA;AAAA,IAGxC,KAAA,EAAO,MAAM,GAAA,CAAI,eAAe,CAAA;AAAA,IAChC,UAAU,MAAM;AACd,MAAA,MAAM,QAAQ,GAAA,EAAI;AAClB,MAAA,OAAO,MAAA,CAAO,IAAA,CAAK,eAAe,CAAA,CAAE,IAAA;AAAA,QAClC,CAAC,GAAA,KAAQ,KAAA,CAAM,GAA2B,CAAA,KAAM,gBAAgB,GAA2B;AAAA,OAC7F;AAAA,IACF;AAAA,GACF,CAAA;AAAA,EACA;AACF;AAWO,IAAM,aAAA,GAAgB,gBAAgB,gBAAgB;AAKtD,SAAS,kBAAA,GAAqC;AACnD,EAAA,OAAO,EAAE,GAAG,eAAA,EAAgB;AAC9B","file":"chunk-DDY7TLUI.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];\ntype DevtoolsMiddleware = ['zustand/devtools', never];\ntype PersistMiddleware<T> = ['zustand/persist', T];\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 */\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 * 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.\n */\nexport function createPersistedStore<T extends object>(\n  initializer: StateCreator<T, [ImmerMiddleware], []>,\n  name: string,\n  persistOptions?: Partial<PersistOptions<T>>\n) {\n  return createPrismStore(initializer, {\n    name,\n    persist: {\n      version: 1,\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  });\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 @omnitron-dev/prism/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"]}