@nice2dev/ui-core 1.0.10

package/dist/core/hooks.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Returns `true` when the primary pointer is coarse (touch device).
+ * Listens for media-query changes so it reacts to device switching.
+ */
+export declare function useIsTouchDevice(): boolean;
+/**
+ * Tracks the current input mode by watching `touchstart` and `pointerdown` events.
+ * @returns `'touch'` after a touch event, `'mouse'` after a mouse/trackpad event.
+ */
+export declare function useInputMode(): 'touch' | 'mouse';
+/**
+ * Returns pointer event handlers that trigger `callback` after a sustained touch of `holdMs` milliseconds.
+ * Mouse/pen interactions are ignored — this is touch-only.
+ * @param callback - Function invoked after the hold duration.
+ * @param holdMs - Hold duration in milliseconds (default `500`).
+ */
+export declare function useLongPress(callback: () => void, holdMs?: number): {
+    onPointerDown: (e: React.PointerEvent) => void;
+    onPointerUp: () => void;
+    onPointerCancel: () => void;
+};
+/**
+ * Returns a stable unique HTML id. Passes through `externalId` when provided,
+ * otherwise generates one via React's `useId()`.
+ * @param externalId - Optional id explicitly set by the consumer.
+ */
+export declare function useControlId(externalId?: string): string;
+/**
+ * Debounces a rapidly-changing value. The returned value only updates
+ * after the source has been stable for `delayMs` milliseconds.
+ * @param value - Source value to debounce.
+ * @param delayMs - Debounce delay in milliseconds.
+ */
+export declare function useDebouncedValue<T>(value: T, delayMs: number): T;
+/**
+ * Calls `handler` whenever a `mousedown` or `touchstart` event occurs outside the referenced element.
+ * @param ref - React ref to the element whose outside clicks should be detected.
+ * @param handler - Callback invoked on outside click.
+ */
+export declare function useClickOutside(ref: React.RefObject<HTMLElement | null>, handler: () => void): void;
+/**
+ * Traps keyboard focus within the referenced container while `active` is `true`.
+ * On activation the first focusable element receives focus.
+ * `Tab` / `Shift+Tab` cycle through focusable children without leaving the container.
+ * @param ref - Container element ref.
+ * @param active - Enable/disable the trap.
+ */
+export declare function useFocusTrap(ref: React.RefObject<HTMLElement | null>, active: boolean): void;
+export interface UseDarkModeOptions {
+    /** Default mode if no preference stored */
+    defaultMode?: 'light' | 'dark' | 'system';
+    /** localStorage key for persisting preference */
+    storageKey?: string;
+    /** CSS class applied to documentElement for dark mode */
+    darkClass?: string;
+    /** CSS class applied to documentElement for light mode */
+    lightClass?: string;
+}
+export interface UseDarkModeReturn {
+    /** Current resolved mode ('light' or 'dark') */
+    isDark: boolean;
+    /** User preference ('light', 'dark', or 'system') */
+    mode: 'light' | 'dark' | 'system';
+    /** System preference detected via prefers-color-scheme */
+    systemPreference: 'light' | 'dark';
+    /** Set mode to light */
+    setLight: () => void;
+    /** Set mode to dark */
+    setDark: () => void;
+    /** Set mode to follow system preference */
+    setSystem: () => void;
+    /** Toggle between light and dark (ignores system) */
+    toggle: () => void;
+}
+/**
+ * Hook for managing dark mode with system preference detection and persistence.
+ * Automatically applies CSS classes to documentElement.
+ *
+ * @example
+ * ```tsx
+ * const { isDark, toggle, mode, setSystem } = useDarkMode();
+ * return (
+ *   <button onClick={toggle}>
+ *     {isDark ? '☀️ Light' : '🌙 Dark'}
+ *   </button>
+ * );
+ * ```
+ */
+export declare function useDarkMode(options?: UseDarkModeOptions): UseDarkModeReturn;
+export interface BrandColors {
+    /** Primary brand color (most dominant) */
+    primary: string;
+    /** Secondary brand color */
+    secondary: string;
+    /** Accent color (most vibrant) */
+    accent: string;
+    /** All extracted colors sorted by dominance */
+    palette: string[];
+    /** Suggested text color for primary background */
+    primaryText: string;
+    /** Suggested text color for secondary background */
+    secondaryText: string;
+}
+export interface UseBrandColorsOptions {
+    /** Number of colors to extract (default: 5) */
+    colorCount?: number;
+    /** Quality of color extraction 1-10 (default: 5) */
+    quality?: number;
+}
+/**
+ * Extracts dominant colors from an image to generate brand colors.
+ * Uses canvas for color sampling and k-means clustering for color extraction.
+ *
+ * @example
+ * ```tsx
+ * const { colors, loading, error } = useBrandColors('/logo.png');
+ * if (colors) {
+ *   console.log('Primary:', colors.primary);
+ *   console.log('Palette:', colors.palette);
+ * }
+ * ```
+ */
+export declare function useBrandColors(imageSource: string | HTMLImageElement | null, options?: UseBrandColorsOptions): {
+    colors: BrandColors | null;
+    loading: boolean;
+    error: string | null;
+};
+/**
+ * Generate a cohesive color palette from a single brand color.
+ * Creates variations for backgrounds, text, and accents.
+ *
+ * @example
+ * ```tsx
+ * const palette = generatePaletteFromColor('#3b82f6');
+ * // { light: '#dbeafe', base: '#3b82f6', dark: '#1e40af', ... }
+ * ```
+ */
+export declare function generatePaletteFromColor(baseColor: string): {
+    lightest: string;
+    lighter: string;
+    light: string;
+    base: string;
+    dark: string;
+    darker: string;
+    darkest: string;
+    text: string;
+    textInverse: string;
+};
+//# sourceMappingURL=hooks.d.ts.map

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

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

package/dist/core/i18n.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Re-export i18n from @nice2dev/i18n
+ * This module is kept for backward compatibility with existing imports.
+ *
+ * @see {@link @nice2dev/i18n} for the canonical implementation
+ */
+export { NiceI18nProvider, useNiceTranslation } from '@nice2dev/i18n';
+export type { NiceTranslateFn, NiceSupportedLang, NiceI18nProviderProps } from '@nice2dev/i18n';
+export { NICE_SUPPORTED_LANGS, NICE_I18N_DICTIONARIES } from '@nice2dev/i18n';
+//# sourceMappingURL=i18n.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/core/i18n.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/core/i18nDictionaries.d.ts

@@ -0,0 +1,4 @@
+export declare const NICE_SUPPORTED_LANGS: readonly ["en", "pl", "de", "fr", "es", "it", "pt", "nl", "sv", "no", "da", "fi", "cs", "sk", "hu", "ro", "bg", "uk", "ja", "ko", "zh", "ar"];
+export type NiceSupportedLang = (typeof NICE_SUPPORTED_LANGS)[number];
+export declare const NICE_I18N_DICTIONARIES: Record<NiceSupportedLang, Record<string, string>>;
+//# sourceMappingURL=i18nDictionaries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18nDictionaries.d.ts","sourceRoot":"","sources":["../../src/core/i18nDictionaries.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,+IAuBvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAi6KtE,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBpF,CAAC"}

package/dist/core/icons.d.ts

@@ -0,0 +1,45 @@
+import React from 'react';
+/** T-shirt size for icons mapped to pixel values (xs=12, sm=16, md=20, lg=24, xl=32). */
+export type NiceIconSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/** Props for the {@link NiceIcon} component. */
+export interface NiceIconProps {
+    /** Icon name (resolved via provider) or React node */
+    name: string;
+    size?: NiceIconSize | number;
+    className?: string;
+    style?: React.CSSProperties;
+    color?: string;
+    title?: string;
+    onClick?: (e: React.MouseEvent) => void;
+}
+/**
+ * Resolver function used by {@link NiceIconProvider} to map icon names to React nodes.
+ * Return `undefined` to fall back to built-in SVG icons.
+ */
+export type NiceIconResolver = (name: string, size: number) => React.ReactNode | undefined;
+/** Props for the {@link NiceIconProvider}. */
+export interface NiceIconProviderProps {
+    /** Custom icon resolver (e.g. FontAwesome, Material Icons) */
+    resolver: NiceIconResolver;
+    children: React.ReactNode;
+}
+/**
+ * Provides a custom icon resolver to all nested NiceToDev components.
+ * Use this to plug in icon libraries like FontAwesome or Material Icons.
+ */
+export declare const NiceIconProvider: React.FC<NiceIconProviderProps>;
+/**
+ * Renders an icon — tries the provider's custom resolver first, then falls back to built-in SVG icons.
+ * If the name is unresolvable, renders nothing.
+ */
+export declare const NiceIcon: React.FC<NiceIconProps>;
+/**
+ * Hook that provides a `renderIcon` helper for resolving icon names or React nodes.
+ * Used internally by components that accept `icon: string | ReactNode` props.
+ */
+export declare function useNiceIcon(): {
+    renderIcon: (icon: React.ReactNode | string | undefined, size?: NiceIconSize | number) => React.ReactNode;
+};
+/** Array of all 78 built-in icon names available without a custom resolver. */
+export declare const NICE_BUILTIN_ICONS: string[];
+//# sourceMappingURL=icons.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/core/icons.tsx"],"names":[],"mappings":"AACA,OAAO,KAAiD,MAAM,OAAO,CAAC;AA2FtE,yFAAyF;AACzF,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAU5D,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;AAW3F,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAE5D,CAAC;AAiDF;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA0C5C,CAAC;AAKF;;;GAGG;AACH,wBAAgB,WAAW;uBAKf,KAAK,CAAC,SAAS,GAAG,MAAM,GAAG,SAAS,SACpC,YAAY,GAAG,MAAM,KAC1B,KAAK,CAAC,SAAS;EAarB;AAED,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,UAA6B,CAAC"}

package/dist/core/icuMessageFormat.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Re-export ICU MessageFormat from @nice2dev/i18n
+ * This module is kept for backward compatibility with existing imports.
+ *
+ * @see {@link @nice2dev/i18n} for the canonical implementation
+ */
+export { formatICU, createICUTranslator } from '@nice2dev/i18n';
+export type { ICUFormatOptions } from '@nice2dev/i18n';
+export type ICUValues = Record<string, string | number | Date>;
+//# sourceMappingURL=icuMessageFormat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"icuMessageFormat.d.ts","sourceRoot":"","sources":["../../src/core/icuMessageFormat.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC"}

package/dist/core/leak-detector.d.ts

@@ -0,0 +1,263 @@
+/**
+ * @file leak-detector.tsx
+ * @description Memory leak detection utilities for development
+ *
+ * Detects common React memory leaks:
+ * - Unmounted component setState calls
+ * - Orphaned event listeners
+ * - Uncleared timers/intervals
+ * - WebSocket connections not closed
+ * - AbortController not aborted
+ * - Large retained closures
+ *
+ * @version 1.0.0
+ * @since 2026-03
+ * @license MIT
+ */
+/**
+ * Memory leak warning severity
+ */
+export type LeakSeverity = 'info' | 'warning' | 'critical';
+/**
+ * Type of memory leak detected
+ */
+export type LeakType = 'setState-after-unmount' | 'timer-not-cleared' | 'listener-not-removed' | 'subscription-not-unsubscribed' | 'websocket-not-closed' | 'abort-controller-not-aborted' | 'large-closure' | 'component-retained' | 'detached-dom-node';
+/**
+ * Memory leak report entry
+ */
+export interface LeakReport {
+    /** Unique ID */
+    id: string;
+    /** Type of leak */
+    type: LeakType;
+    /** Severity level */
+    severity: LeakSeverity;
+    /** Component name (if available) */
+    componentName?: string;
+    /** Description of the leak */
+    message: string;
+    /** Stack trace (if available) */
+    stack?: string;
+    /** Timestamp */
+    timestamp: number;
+    /** Additional data */
+    data?: Record<string, unknown>;
+}
+/**
+ * Leak detector configuration
+ */
+export interface LeakDetectorConfig {
+    /** Enable detection (default: true in dev) */
+    enabled?: boolean;
+    /** Log to console */
+    logToConsole?: boolean;
+    /** Custom reporter */
+    onLeak?: (report: LeakReport) => void;
+    /** Component names to ignore */
+    ignoreComponents?: string[];
+    /** Sampling rate (0-1, default: 1) */
+    samplingRate?: number;
+    /** Track detached DOM nodes */
+    trackDetachedNodes?: boolean;
+    /** Closure size threshold (bytes) */
+    closureSizeThreshold?: number;
+}
+/**
+ * Configure the leak detector globally
+ *
+ * @example
+ * ```tsx
+ * configureLeakDetector({
+ *   enabled: process.env.NODE_ENV === 'development',
+ *   logToConsole: true,
+ *   onLeak: (report) => sendToAnalytics(report),
+ *   ignoreComponents: ['ThirdPartyComponent'],
+ * });
+ * ```
+ */
+export declare function configureLeakDetector(config: Partial<LeakDetectorConfig>): void;
+/**
+ * Get all leaked reports
+ */
+export declare function getLeakReports(): LeakReport[];
+/**
+ * Clear all leak reports
+ */
+export declare function clearLeakReports(): void;
+/**
+ * Get summary of leaks by type
+ */
+export declare function getLeakSummary(): Record<LeakType, number>;
+/**
+ * useState that prevents setState calls after unmount
+ * Logs a warning if setState is called after unmount
+ *
+ * @example
+ * ```tsx
+ * const [data, setData] = useSafeState<Data | null>(null);
+ *
+ * useEffect(() => {
+ *   fetchData().then(setData); // Safe even if component unmounts
+ * }, []);
+ * ```
+ */
+export declare function useSafeState<T>(initialState: T | (() => T), componentName?: string): [T, React.Dispatch<React.SetStateAction<T>>];
+/**
+ * setTimeout that auto-clears on unmount
+ *
+ * @example
+ * ```tsx
+ * const [startTimeout, clearTimeout] = useSafeTimeout();
+ *
+ * startTimeout(() => {
+ *   console.log('Delayed action');
+ * }, 1000);
+ * ```
+ */
+export declare function useSafeTimeout(componentName?: string): [(callback: () => void, delay: number) => void, () => void];
+/**
+ * setInterval that auto-clears on unmount
+ *
+ * @example
+ * ```tsx
+ * const [startInterval, clearInterval] = useSafeInterval();
+ *
+ * useEffect(() => {
+ *   startInterval(() => {
+ *     console.log('Tick');
+ *   }, 1000);
+ * }, [startInterval]);
+ * ```
+ */
+export declare function useSafeInterval(componentName?: string): [(callback: () => void, delay: number) => void, () => void];
+/**
+ * addEventListener with auto-cleanup on unmount
+ *
+ * @example
+ * ```tsx
+ * const addListener = useSafeEventListener();
+ *
+ * useEffect(() => {
+ *   const cleanup = addListener(window, 'resize', handleResize);
+ *   return cleanup;
+ * }, [addListener, handleResize]);
+ * ```
+ */
+export declare function useSafeEventListener(componentName?: string): <K extends keyof WindowEventMap>(target: EventTarget, type: K | string, listener: EventListener, options?: AddEventListenerOptions) => () => void;
+/**
+ * AbortController that auto-aborts on unmount
+ *
+ * @example
+ * ```tsx
+ * const getAbortSignal = useSafeAbortController();
+ *
+ * useEffect(() => {
+ *   const signal = getAbortSignal();
+ *   fetch('/api/data', { signal }).then(handleData).catch(handleError);
+ * }, [getAbortSignal]);
+ * ```
+ */
+export declare function useSafeAbortController(componentName?: string): () => AbortSignal;
+/**
+ * Fetch with auto-abort on unmount
+ *
+ * @example
+ * ```tsx
+ * const safeFetch = useSafeFetch();
+ *
+ * useEffect(() => {
+ *   safeFetch('/api/data')
+ *     .then(res => res.json())
+ *     .then(setData)
+ *     .catch(err => {
+ *       if (err.name !== 'AbortError') {
+ *         setError(err);
+ *       }
+ *     });
+ * }, [safeFetch]);
+ * ```
+ */
+export declare function useSafeFetch(componentName?: string): (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+/**
+ * Subscription manager with auto-cleanup
+ *
+ * @example
+ * ```tsx
+ * const subscribe = useSafeSubscription();
+ *
+ * useEffect(() => {
+ *   subscribe(eventEmitter.on('event', handleEvent));
+ *   // or with custom cleanup
+ *   subscribe(() => cleanup());
+ * }, [subscribe]);
+ * ```
+ */
+export declare function useSafeSubscription(componentName?: string): (cleanup: (() => void) | {
+    unsubscribe: () => void;
+}) => void;
+/**
+ * WebSocket with auto-close on unmount
+ *
+ * @example
+ * ```tsx
+ * const { socket, send, close } = useSafeWebSocket('wss://api.example.com');
+ *
+ * useEffect(() => {
+ *   if (socket) {
+ *     socket.onmessage = (e) => handleMessage(e.data);
+ *   }
+ * }, [socket]);
+ * ```
+ */
+export declare function useSafeWebSocket(url: string | null, protocols?: string | string[], componentName?: string): {
+    socket: WebSocket | null;
+    readyState: number;
+    send: (data: string | ArrayBufferLike | Blob | ArrayBufferView) => void;
+    close: (code?: number, reason?: string) => void;
+};
+/**
+ * HOC to track component mount/unmount for leak detection
+ * Use in development to identify retained components
+ *
+ * @example
+ * ```tsx
+ * const TrackedMyComponent = withLeakTracking(MyComponent, 'MyComponent');
+ * ```
+ */
+export declare function withLeakTracking<P extends object>(Component: React.ComponentType<P>, displayName?: string): React.FC<P>;
+/**
+ * Hook to log when component unmounts
+ * Useful for debugging component lifecycle
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   useUnmountLog('MyComponent');
+ *   // ...
+ * }
+ * ```
+ */
+export declare function useUnmountLog(componentName: string): void;
+/**
+ * Take a memory snapshot (Chrome DevTools only)
+ * Use in development for debugging memory issues
+ */
+export declare function takeMemorySnapshot(label?: string): Promise<void>;
+/**
+ * Force garbage collection (Chrome with --expose-gc flag only)
+ */
+export declare function forceGC(): void;
+/**
+ * Hook to monitor memory usage
+ */
+export declare function useMemoryMonitor(intervalMs?: number, warnThresholdMB?: number): {
+    usedMB: number;
+    totalMB: number;
+    limitMB: number;
+    isWarning: boolean;
+};
+/**
+ * Display leak detector status in React DevTools (via component props)
+ */
+export declare const LeakDetectorStatus: React.FC;
+//# sourceMappingURL=leak-detector.d.ts.map

package/dist/core/leak-detector.d.ts.map

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

package/dist/core/omniverkTypes.d.ts

@@ -0,0 +1,164 @@
+/** A work mode supported by the OmniVerk platform (test, demo, dev, prod, etc.). */
+export interface NiceModeInfo {
+    key: string;
+    displayName: string;
+    icon?: string;
+    color?: string;
+    sourcePackage?: string;
+    description?: string;
+}
+/** A top-level module in the navigation sidebar. */
+export interface NiceModuleMenuDto {
+    id: string;
+    name: string;
+    label: string;
+    icon?: string;
+    order: number;
+    isAvailable: boolean;
+    entities: NiceEntityMenuDto[];
+    children?: NiceModuleMenuDto[];
+}
+/** A single entity (list view / form view) inside a module. */
+export interface NiceEntityMenuDto {
+    id: string;
+    name: string;
+    label: string;
+    icon?: string;
+    listViewId?: string;
+    formViewId?: string;
+    route: string;
+}
+/** Full API response for user-scoped navigation menu. */
+export interface NiceUserMenuResponse {
+    modules: NiceModuleMenuDto[];
+    quickActions: NiceQuickAction[];
+    favorites: NiceFavoriteItem[];
+}
+export interface NiceQuickAction {
+    id: string;
+    label: string;
+    icon?: string;
+    route: string;
+    shortcut?: string;
+}
+export interface NiceFavoriteItem {
+    id: string;
+    label: string;
+    icon?: string;
+    route: string;
+    entityId?: string;
+    moduleId?: string;
+}
+/** Descriptor for a single MDI tab. */
+export interface NiceTabDescriptor {
+    id: string;
+    route: string;
+    title: string;
+    icon?: string;
+    entityId?: string;
+    isDirty?: boolean;
+    isPinned?: boolean;
+    closable?: boolean;
+}
+/** Request payload for persisting workspace state. */
+export interface NiceSaveWorkspaceStateRequest {
+    openTabsJson: string;
+    activeTabIndex: number;
+    layoutPreferencesJson?: string;
+}
+/** Response from workspace state API. */
+export interface NiceWorkspaceState {
+    tabs: NiceTabDescriptor[];
+    activeTabIndex: number;
+    layoutPreferences?: Record<string, unknown>;
+}
+/** A single question in the onboarding wizard. */
+export interface NiceOnboardingQuestion {
+    id: string;
+    question: string;
+    questionType: 'text' | 'select' | 'multiSelect' | 'boolean' | 'number' | 'date';
+    category: string;
+    orderIndex: number;
+    isRequired: boolean;
+    options?: string[];
+    helpText?: string;
+    defaultValue?: string;
+}
+/** Answer submitted for an onboarding question. */
+export interface NiceOnboardingAnswer {
+    questionId: string;
+    answer: string;
+}
+/** Full organization profile DTO (30+ fields across 8 sections). */
+export interface NiceOrganizationProfile {
+    id?: string;
+    name: string;
+    legalName?: string;
+    taxId?: string;
+    registrationNumber?: string;
+    industry?: string;
+    employeeCount?: number;
+    email?: string;
+    phone?: string;
+    website?: string;
+    fax?: string;
+    street?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    country?: string;
+    logoUrl?: string;
+    primaryColor?: string;
+    secondaryColor?: string;
+    defaultLanguage?: string;
+    defaultCurrency?: string;
+    defaultTimezone?: string;
+    dateFormat?: string;
+    fiscalYearStart?: string;
+    vatEnabled?: boolean;
+    defaultVatRate?: number;
+    workingDays?: string[];
+    workingHoursStart?: string;
+    workingHoursEnd?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export type NiceModuleStatus = 'available' | 'installed' | 'active' | 'disabled' | 'error' | 'updating';
+/** A module entry in the lifecycle management panel. */
+export interface NiceModuleInfo {
+    id: string;
+    name: string;
+    label: string;
+    description: string;
+    version: string;
+    icon?: string;
+    status: NiceModuleStatus;
+    author?: string;
+    dependencies?: string[];
+    isCore?: boolean;
+}
+/** Supported application display modes / shell types. */
+export type NiceDisplayMode = 'classic' | 'console' | 'desktop' | 'dashboard' | 'compact' | 'kiosk';
+/**
+ * Information about the current tenant displayed in shells.
+ * Used by NiceModernShell, NiceMinimalShell, NiceHybridShell, NicePwaShell.
+ */
+export interface NiceTenantInfo {
+    /** Stable tenant identifier (UUID, slug). */
+    id: string;
+    /** Human-readable tenant name. */
+    name: string;
+    /** Optional short display name / acronym. */
+    shortName?: string;
+    /** Optional logo URL. */
+    logoUrl?: string;
+    /** Optional brand primary color (hex / css). */
+    primaryColor?: string;
+    /** Plan / subscription tier label (e.g. 'Free', 'Pro', 'Enterprise'). */
+    plan?: string;
+    /** Region / data residency region (e.g. 'eu-central-1'). */
+    region?: string;
+    /** Tenant locale (BCP 47, e.g. 'pl-PL'). */
+    locale?: string;
+}
+//# sourceMappingURL=omniverkTypes.d.ts.map