@nice2dev/ui-core 1.0.10

package/CHANGELOG.md

@@ -0,0 +1,63 @@
+# @nice2dev/ui-core — Changelog
+
+All notable changes to the cross-framework core package.
+
+## [0.2.0] — 2026-03-25
+
+### Added — Component Core Abstractions (FAZA 8.1)
+
+Framework-agnostic TypeScript contracts, state machines, validation utilities, and behavior logic for all major UI component categories. These are consumed by Angular/Vue/Web Component/Blazor adapters.
+
+#### Shared
+- `ComponentBaseProps`, `ComponentEvent`, `createComponentEvent`
+- Types: `ComponentSize`, `ComponentVariant`, `ComponentDensity`, `Orientation`, `Placement`, `Alignment`
+
+#### Buttons
+- Contracts: `ButtonProps`, `ButtonGroupProps`, `DropDownButtonProps`, `IconButtonProps`, `SpeedDialProps`
+- Types: `ButtonType`, `ButtonStyle`, `DropDownItem`, `SpeedDialAction`
+
+#### Form Controls
+- `FormFieldProps`, `ValidationRule`, `ValidationResult` + `validateField()` (pure validation, no framework deps)
+- `TextInputProps` (type, mask, prefix/suffix, maxLength)
+- `NumberInputProps` + `clampNumber()` (min/max/precision clamping)
+- `SelectProps` + `filterOptions()`, `groupOptions()` (search/group utilities)
+- `CheckboxProps`, `ToggleProps`, `SliderProps`
+- `DatePickerProps` (date/datetime/time/month/year/range modes)
+- `TextAreaProps`, `AutocompleteProps`, `ColorPickerProps`, `FileUploadProps`
+
+#### Data Display
+- `DataGridProps`, `ColumnDef`, `SortState`, `FilterState` + `multiSort()`, `applyFilters()`, `paginate()`
+- `BadgeProps`, `ProgressProps`, `AvatarProps` + `getInitials()`
+
+#### Navigation
+- `TabsProps`, `TabItem` + `createTabsState()` (state machine with getActive/setActive/getNext/getPrev)
+- `BreadcrumbProps`, `BreadcrumbItem` + `collapseBreadcrumb()` (keeps first + last N items)
+- `AccordionProps`, `AccordionItem` + `toggleAccordion()` (single/multiple mode logic)
+- `MenuProps`, `MenuItem`, `DrawerProps`
+
+#### Overlays & Feedback
+- `ModalProps`, `AlertProps`, `ToastConfig` + `ToastManager` class (queue, subscribe, dismiss, auto-expire)
+- `PopoverProps`, `TooltipProps`
+
+#### Charts
+- `ChartProps`, `ChartSeries`, `ChartAxis`, `ChartLegend` (17 chart types)
+
+#### Planning
+- `SchedulerProps`, `SchedulerEvent`, `SchedulerResource` (day/week/month/timeline/agenda views)
+- `GanttProps`, `GanttTask` (with dependencies, milestones, progress)
+
+#### Tree View
+- `TreeViewProps`, `TreeNode` + `flattenTree()` (for virtual scrolling), `searchTree()` (match with paths)
+
+#### Layout
+- `SplitterProps`, `SplitterPane` + `calculatePaneSizes()` (constrained resize logic)
+
+---
+
+## [0.1.0] — 2025-06-01
+
+Initial release — facade package re-exporting core utilities from @nice2dev/ui.
+
+- Types, Hooks, i18n, Icons, Accessibility, RTL, Animations, Responsive, Testing
+- Access Control, Touch, Theme, DataSource (core + advanced + offline + aggregation)
+- Display Style system

package/README.md

@@ -0,0 +1,62 @@
+# @nice2dev/ui-core
+
+> Framework-agnostic component contracts — pure TypeScript types, validation logic, and state utilities powering cross-framework adapters (Angular, Vue, Web Components, Blazor).
+
+## Features
+
+- **Component Contracts** — TypeScript interfaces for 30+ component types (buttons, forms, data display, navigation, overlays, charts, planning, layout)
+- **Validation Engine** — `validateField()` with 10 rule types: required, minLength, maxLength, min, max, pattern, email, url, custom
+- **State Utilities** — `createTabsState()`, `ToastManager`, `toggleAccordion()`, `calculatePaneSizes()`
+- **Data Helpers** — `multiSort()`, `applyFilters()`, `paginate()`, `filterOptions()`, `groupOptions()`, `flattenTree()`, `searchTree()`
+- **Display Styles** — animation tokens, responsive breakpoints, theme contracts, i18n types, DataSource abstraction
+- **Zero Dependencies** — pure TypeScript, no runtime framework dependency
+
+## Installation
+
+```bash
+npm install @nice2dev/ui-core
+```
+
+## Usage
+
+```typescript
+import {
+  type ButtonProps,
+  type TextInputProps,
+  type DataGridProps,
+  validateField,
+  multiSort,
+  applyFilters,
+  paginate,
+  ToastManager,
+  createTabsState,
+} from '@nice2dev/ui-core';
+
+// Validate a form field
+const errors = validateField('email', 'user@example.com', [
+  { type: 'required' },
+  { type: 'email' },
+]);
+
+// Manage toast notifications
+const toasts = new ToastManager();
+toasts.subscribe((list) => console.log('Toasts:', list));
+toasts.add({ message: 'Saved!', severity: 'success' });
+```
+
+## Component Categories
+
+| Category | Types |
+|----------|-------|
+| **Buttons** | Button, ButtonGroup, DropDownButton, IconButton, SpeedDial |
+| **Form Controls** | TextInput, NumberInput, Select, Checkbox, Toggle, Slider, DatePicker, TextArea, Autocomplete, ColorPicker, FileUpload |
+| **Data Display** | DataGrid (sort, filter, paginate), Badge, Progress, Avatar |
+| **Navigation** | Tabs, Breadcrumb, Accordion, Menu, Drawer |
+| **Overlays** | Modal, Alert, Toast, Popover, Tooltip |
+| **Charts** | 17 chart types with series, axis, legend contracts |
+| **Planning** | Scheduler, Gantt |
+| **Tree & Layout** | TreeView, Splitter |
+
+## License
+
+MIT © NiceToDev

package/dist/core/NiceInlineHelp.d.ts

@@ -0,0 +1,69 @@
+/**
+ * NiceInlineHelp — Inline help panel for components
+ *
+ * Shows contextual help, tips, and documentation directly within the component.
+ * Supports multiple display modes: tooltip, collapsible panel, sidebar.
+ *
+ * @since 2.6.0
+ */
+import React, { type ReactNode } from 'react';
+import { type HelpContent } from './helpContext';
+export interface NiceInlineHelpProps {
+    /** Component name for help lookup */
+    componentName: string;
+    /** Override help content (instead of loading from .doc.json) */
+    content?: HelpContent;
+    /** Custom children to render inside help panel */
+    children?: ReactNode;
+    /** Position override */
+    position?: 'top' | 'bottom' | 'tooltip' | 'inline';
+    /** Initial expanded state */
+    defaultExpanded?: boolean;
+    /** Disable help for this instance */
+    disabled?: boolean;
+    /** Additional className */
+    className?: string;
+    /** Custom trigger icon */
+    icon?: ReactNode;
+    /** Title override */
+    title?: string;
+    /** Show props table */
+    showProps?: boolean;
+    /** Show examples */
+    showExamples?: boolean;
+    /** Show tips */
+    showTips?: boolean;
+    /** Compact mode */
+    compact?: boolean;
+}
+export declare const NiceInlineHelp: React.FC<NiceInlineHelpProps>;
+export interface NiceQuickHelpProps {
+    /** Help text to display */
+    text: string;
+    /** Help position */
+    position?: 'top' | 'right' | 'bottom' | 'left';
+    /** Custom className */
+    className?: string;
+    /** Trigger element */
+    children: ReactNode;
+}
+/**
+ * Lightweight inline help that shows on hover/focus
+ */
+export declare const NiceQuickHelp: React.FC<NiceQuickHelpProps>;
+export interface NiceHelpIconProps {
+    /** Help content to show */
+    content: string | HelpContent;
+    /** Button size */
+    size?: 'sm' | 'md' | 'lg';
+    /** Custom className */
+    className?: string;
+    /** Callback when help is opened */
+    onOpen?: () => void;
+}
+/**
+ * Help icon that shows help content on click
+ */
+export declare const NiceHelpIcon: React.FC<NiceHelpIconProps>;
+export default NiceInlineHelp;
+//# sourceMappingURL=NiceInlineHelp.d.ts.map

package/dist/core/NiceInlineHelp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NiceInlineHelp.d.ts","sourceRoot":"","sources":["../../src/core/NiceInlineHelp.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,EAAoC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEhF,OAAO,EAAoB,KAAK,WAAW,EAAiB,MAAM,eAAe,CAAC;AAKlF,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACnD,6BAA6B;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oBAAoB;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mBAAmB;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAuID,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAqHxD,CAAC;AA8EF,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAwBtD,CAAC;AAMF,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,kBAAkB;IAClB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA0CpD,CAAC;AAIF,eAAe,cAAc,CAAC"}

package/dist/core/NiceThemeProvider.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import type { NiceDisplayStyle } from '../core/displayStyle';
+import type { NiceTheme, NiceThemeDarkMode } from '../core/theme';
+import type { ThemeVariantConfig } from '../core/themeVariants';
+export interface NiceThemeProviderProps {
+    /** Current theme */
+    theme: NiceTheme;
+    /** Optional dark companion theme (used when darkMode='auto' and system prefers dark) */
+    darkTheme?: NiceTheme;
+    /** Variant configuration for component styles */
+    variantConfig?: Partial<ThemeVariantConfig>;
+    /** Override dark mode preference ('light' | 'dark' | 'auto'); defaults to theme.darkMode */
+    darkMode?: NiceThemeDarkMode;
+    /**
+     * Global display style applied to all child Nice* components.
+     * Each component can override via its own `displayStyle` prop.
+     *
+     * Resolution order:
+     *   1. This prop (if set)
+     *   2. theme.recommendedDisplayStyle (if the theme pack carries one)
+     *   3. 'default'
+     *
+     * @see NiceDisplayStyle
+     */
+    displayStyle?: NiceDisplayStyle;
+    /** Animate theme transitions (default: true) */
+    animateTransitions?: boolean;
+    children: React.ReactNode;
+}
+export declare const NiceThemeProvider: React.FC<NiceThemeProviderProps>;
+//# sourceMappingURL=NiceThemeProvider.d.ts.map

package/dist/core/NiceThemeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NiceThemeProvider.d.ts","sourceRoot":"","sources":["../../src/core/NiceThemeProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAExF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAM7D,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAOhE,MAAM,WAAW,sBAAsB;IACrC,oBAAoB;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,wFAAwF;IACxF,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,iDAAiD;IACjD,aAAa,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC5C,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAUD,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAgN9D,CAAC"}

package/dist/core/NiceThemeVariants.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @file NiceThemeVariants.tsx
+ * @description React components for theme variant configuration and preview
+ *
+ * @version 1.0.0
+ * @since 2026-03
+ * @license MIT
+ */
+import React from 'react';
+import { ThemeVariantConfig } from './themeVariants';
+interface ThemeVariantContextValue {
+    config: ThemeVariantConfig;
+    setConfig: (config: Partial<ThemeVariantConfig>) => void;
+    applyPreset: (presetName: string) => void;
+    reset: () => void;
+}
+/**
+ * Hook to access theme variant context
+ */
+export declare function useThemeVariants(): ThemeVariantContextValue;
+export interface NiceThemeVariantProviderProps {
+    /** Initial variant config */
+    initialConfig?: Partial<ThemeVariantConfig>;
+    /** Storage key for persistence */
+    storageKey?: string;
+    /** Auto-apply to DOM */
+    autoApply?: boolean;
+    /** Children */
+    children: React.ReactNode;
+}
+/**
+ * Provider for theme variant configuration
+ */
+export declare function NiceThemeVariantProvider({ initialConfig, storageKey, autoApply, children, }: NiceThemeVariantProviderProps): JSX.Element;
+export interface NiceThemeVariantConfiguratorProps {
+    /** Show preset selector */
+    showPresets?: boolean;
+    /** Show live preview */
+    showPreview?: boolean;
+    /** Show CSS output */
+    showCSS?: boolean;
+    /** Collapsible sections */
+    collapsible?: boolean;
+    /** Custom class */
+    className?: string;
+    /** Style */
+    style?: React.CSSProperties;
+}
+/**
+ * UI for configuring theme variants
+ */
+export declare function NiceThemeVariantConfigurator({ showPresets, showPreview, showCSS, collapsible, className, style, }: NiceThemeVariantConfiguratorProps): JSX.Element;
+export type { ThemeVariantConfig, RadiusVariant, ShadowVariant, FillVariant, ButtonStyleVariant, InputStyleVariant, CardStyleVariant, AnimationIntensity, DensityVariant, } from './themeVariants';
+export { DEFAULT_VARIANT_CONFIG, VARIANT_PRESETS, applyVariantConfig, generateVariantCSS, } from './themeVariants';
+//# sourceMappingURL=NiceThemeVariants.d.ts.map

package/dist/core/NiceThemeVariants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NiceThemeVariants.d.ts","sourceRoot":"","sources":["../../src/core/NiceThemeVariants.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAsE,MAAM,OAAO,CAAC;AAE3F,OAAO,EACL,kBAAkB,EAoBnB,MAAM,iBAAiB,CAAC;AAMzB,UAAU,wBAAwB;IAChC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC;IACzD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAID;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,wBAAwB,CAM3D;AAMD,MAAM,WAAW,6BAA6B;IAC5C,6BAA6B;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC5C,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,aAAa,EACb,UAAiC,EACjC,SAAgB,EAChB,QAAQ,GACT,EAAE,6BAA6B,GAAG,GAAG,CAAC,OAAO,CAkD7C;AAMD,MAAM,WAAW,iCAAiC;IAChD,2BAA2B;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wBAAwB;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,WAAkB,EAClB,WAAkB,EAClB,OAAe,EACf,WAAkB,EAClB,SAAS,EACT,KAAK,GACN,EAAE,iCAAiC,GAAG,GAAG,CAAC,OAAO,CAyPjD;AAyLD,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/core/NiceUserPreferences.d.ts

@@ -0,0 +1,304 @@
+/**
+ * @file NiceUserPreferences.tsx
+ * @description User preferences system for storing and managing per-control customizations
+ *
+ * Features:
+ * - Per-control preferences storage
+ * - Grid column customization
+ * - Custom colors and styles
+ * - Layout preferences
+ * - Import/Export
+ * - Backend sync support
+ *
+ * @version 1.0.0
+ * @since 2026-03
+ * @license MIT
+ */
+import React from 'react';
+/**
+ * Grid column preferences
+ */
+export interface GridColumnPreference {
+    /** Column ID */
+    id: string;
+    /** Visible */
+    visible?: boolean;
+    /** Width */
+    width?: number;
+    /** Order/index */
+    order?: number;
+    /** Pinned position */
+    pinned?: 'left' | 'right' | null;
+    /** Sort direction */
+    sort?: 'asc' | 'desc' | null;
+    /** Sort order for multi-sort */
+    sortIndex?: number;
+    /** Custom header */
+    customHeader?: string;
+    /** Custom cell background */
+    cellBackground?: string;
+    /** Custom cell text color */
+    cellColor?: string;
+}
+/**
+ * Grid preferences
+ */
+export interface GridPreferences {
+    /** Column configs */
+    columns?: GridColumnPreference[];
+    /** Page size */
+    pageSize?: number;
+    /** Row height */
+    rowHeight?: number;
+    /** Filter state */
+    filters?: Record<string, any>;
+    /** Grouping columns */
+    groupBy?: string[];
+    /** Expanded groups */
+    expandedGroups?: string[];
+    /** Selected rows */
+    selectedRows?: (string | number)[];
+    /** Custom row colors */
+    rowColors?: Record<string | number, string>;
+}
+/**
+ * Chart preferences
+ */
+export interface ChartPreferences {
+    /** Chart type override */
+    chartType?: string;
+    /** Custom colors */
+    colors?: string[];
+    /** Show/hide legend */
+    showLegend?: boolean;
+    /** Legend position */
+    legendPosition?: 'top' | 'bottom' | 'left' | 'right';
+    /** Show data labels */
+    showDataLabels?: boolean;
+    /** Custom title */
+    customTitle?: string;
+    /** Zoom state */
+    zoomState?: {
+        min: number;
+        max: number;
+    };
+}
+/**
+ * Form preferences
+ */
+export interface FormPreferences {
+    /** Field order */
+    fieldOrder?: string[];
+    /** Hidden fields */
+    hiddenFields?: string[];
+    /** Column layout */
+    columns?: number;
+    /** Collapsed sections */
+    collapsedSections?: string[];
+    /** Default values */
+    defaultValues?: Record<string, any>;
+}
+/**
+ * Layout preferences
+ */
+export interface LayoutPreferences {
+    /** Sidebar collapsed */
+    sidebarCollapsed?: boolean;
+    /** Sidebar width */
+    sidebarWidth?: number;
+    /** Panel sizes */
+    panelSizes?: Record<string, number>;
+    /** Tab order */
+    tabOrder?: string[];
+    /** Active tab */
+    activeTab?: string;
+    /** Splitter positions */
+    splitterPositions?: Record<string, number>;
+}
+/**
+ * Display preferences
+ */
+export interface DisplayPreferences {
+    /** Date format */
+    dateFormat?: string;
+    /** Time format */
+    timeFormat?: string;
+    /** Number format */
+    numberFormat?: string;
+    /** Currency */
+    currency?: string;
+    /** Locale */
+    locale?: string;
+    /** Font size scale */
+    fontScale?: number;
+    /** High contrast mode */
+    highContrast?: boolean;
+    /** Reduced motion */
+    reducedMotion?: boolean;
+}
+/**
+ * Control-specific preferences
+ */
+export interface ControlPreferences {
+    /** Grid preferences */
+    grid?: GridPreferences;
+    /** Chart preferences */
+    chart?: ChartPreferences;
+    /** Form preferences */
+    form?: FormPreferences;
+    /** Layout preferences */
+    layout?: LayoutPreferences;
+    /** Display preferences */
+    display?: DisplayPreferences;
+    /** Custom data */
+    custom?: Record<string, any>;
+    /** Last modified timestamp */
+    lastModified?: number;
+}
+/**
+ * User preferences store
+ */
+export interface UserPreferencesStore {
+    /** Version for migrations */
+    version: number;
+    /** Global preferences */
+    global: {
+        display?: DisplayPreferences;
+        layout?: LayoutPreferences;
+        custom?: Record<string, any>;
+    };
+    /** Per-control preferences keyed by control ID */
+    controls: Record<string, ControlPreferences>;
+    /** Last sync timestamp */
+    lastSync?: number;
+}
+/**
+ * Storage adapter interface
+ */
+export interface PreferencesStorageAdapter {
+    /** Load preferences */
+    load(): Promise<UserPreferencesStore | null>;
+    /** Save preferences */
+    save(preferences: UserPreferencesStore): Promise<void>;
+    /** Clear preferences */
+    clear(): Promise<void>;
+}
+/**
+ * Sync adapter interface for backend sync
+ */
+export interface PreferencesSyncAdapter {
+    /** Fetch preferences from backend */
+    fetch(): Promise<UserPreferencesStore | null>;
+    /** Push preferences to backend */
+    push(preferences: UserPreferencesStore): Promise<void>;
+    /** Get last server timestamp */
+    getServerTimestamp(): Promise<number>;
+}
+/**
+ * LocalStorage adapter
+ */
+export declare class LocalStorageAdapter implements PreferencesStorageAdapter {
+    private key;
+    constructor(key?: string);
+    load(): Promise<UserPreferencesStore | null>;
+    save(preferences: UserPreferencesStore): Promise<void>;
+    clear(): Promise<void>;
+}
+/**
+ * IndexedDB adapter for larger datasets
+ */
+export declare class IndexedDBAdapter implements PreferencesStorageAdapter {
+    private dbName;
+    private storeName;
+    private db;
+    constructor(dbName?: string, storeName?: string);
+    private getDB;
+    load(): Promise<UserPreferencesStore | null>;
+    save(preferences: UserPreferencesStore): Promise<void>;
+    clear(): Promise<void>;
+}
+/**
+ * REST API sync adapter
+ */
+export declare class RestAPISyncAdapter implements PreferencesSyncAdapter {
+    private baseUrl;
+    private getAuthHeaders?;
+    constructor(baseUrl: string, getAuthHeaders?: (() => Record<string, string>) | undefined);
+    private getHeaders;
+    fetch(): Promise<UserPreferencesStore | null>;
+    push(preferences: UserPreferencesStore): Promise<void>;
+    getServerTimestamp(): Promise<number>;
+}
+interface UserPreferencesContextValue {
+    /** Current preferences store */
+    preferences: UserPreferencesStore;
+    /** Is loading */
+    isLoading: boolean;
+    /** Is syncing */
+    isSyncing: boolean;
+    /** Last error */
+    error: Error | null;
+    getControlPreferences<T extends keyof ControlPreferences>(controlId: string, type: T): ControlPreferences[T] | undefined;
+    setControlPreferences<T extends keyof ControlPreferences>(controlId: string, type: T, prefs: ControlPreferences[T]): void;
+    updateControlPreferences<T extends keyof ControlPreferences>(controlId: string, type: T, updates: Partial<NonNullable<ControlPreferences[T]>>): void;
+    clearControlPreferences(controlId: string, type?: keyof ControlPreferences): void;
+    getGlobalPreferences<T extends 'display' | 'layout' | 'custom'>(type: T): UserPreferencesStore['global'][T];
+    setGlobalPreferences<T extends 'display' | 'layout' | 'custom'>(type: T, prefs: UserPreferencesStore['global'][T]): void;
+    sync(): Promise<void>;
+    exportPreferences(): string;
+    importPreferences(json: string): void;
+    resetAllPreferences(): void;
+}
+/**
+ * Hook to access user preferences
+ */
+export declare function useUserPreferences(): UserPreferencesContextValue;
+/**
+ * Hook for specific control preferences
+ */
+export declare function useControlPreferences<T extends keyof ControlPreferences>(controlId: string, type: T): [
+    ControlPreferences[T] | undefined,
+    (prefs: ControlPreferences[T]) => void,
+    (updates: Partial<NonNullable<ControlPreferences[T]>>) => void
+];
+/**
+ * Hook for grid-specific preferences (convenience)
+ */
+export declare function useGridPreferences(gridId: string): [GridPreferences | undefined, (prefs: GridPreferences | undefined) => void, (updates: Partial<GridPreferences>) => void];
+/**
+ * Hook for chart-specific preferences (convenience)
+ */
+export declare function useChartPreferences(chartId: string): [ChartPreferences | undefined, (prefs: ChartPreferences | undefined) => void, (updates: Partial<ChartPreferences>) => void];
+export interface NiceUserPreferencesProviderProps {
+    /** Storage adapter */
+    storage?: PreferencesStorageAdapter;
+    /** Sync adapter for backend sync */
+    syncAdapter?: PreferencesSyncAdapter;
+    /** Auto-sync interval in ms (0 = disabled) */
+    autoSyncInterval?: number;
+    /** Debounce save delay in ms */
+    saveDebounce?: number;
+    /** Children */
+    children: React.ReactNode;
+}
+export declare function NiceUserPreferencesProvider({ storage, syncAdapter, autoSyncInterval, saveDebounce, children, }: NiceUserPreferencesProviderProps): JSX.Element;
+export interface NicePreferencesPanelProps {
+    /** Show global preferences section */
+    showGlobal?: boolean;
+    /** Show control preferences section */
+    showControls?: boolean;
+    /** Show export/import buttons */
+    showExportImport?: boolean;
+    /** Show sync button */
+    showSync?: boolean;
+    /** Custom class */
+    className?: string;
+    /** Style */
+    style?: React.CSSProperties;
+}
+/**
+ * UI panel for managing user preferences
+ */
+export declare function NicePreferencesPanel({ showGlobal, showControls, showExportImport, showSync, className, style, }: NicePreferencesPanelProps): JSX.Element;
+export {};
+//# sourceMappingURL=NiceUserPreferences.d.ts.map

package/dist/core/NiceUserPreferences.d.ts.map

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