@nice2dev/ui 1.0.11 → 1.0.14

package/dist/index.d.ts

@@ -67,6 +67,8 @@ import { default as default_2 } from 'react';
 import { DEFAULT_VARIANT_CONFIG } from '@nice2dev/ui-core';
 import { DENSITY_VALUES } from '@nice2dev/ui-core';
 import { DensityVariant } from '@nice2dev/ui-core';
+import { deprecateProp } from '@nice2dev/ui-core';
+import { deprecateSymbol } from '@nice2dev/ui-core';
 import { deserializeTheme } from '@nice2dev/ui-core';
 import { Dispatch } from 'react';
 import { DisplayPreferences } from '@nice2dev/ui-core';
@@ -167,11 +169,14 @@ import { NiceAIProvider } from '@nice2dev/ui-core';
 import { NiceAnimationConfig } from '@nice2dev/ui-core';
 import { NiceAnimationPreset } from '@nice2dev/ui-core';
 import { NiceAnimationTiming } from '@nice2dev/ui-core';
+import { NiceAriaProps } from '@nice2dev/ui-core';
 import { NiceArrayDataSourceConfig } from '@nice2dev/ui-core';
 import { NiceBaseProps } from '@nice2dev/ui-core';
 import { NiceBreakpoint } from '@nice2dev/ui-core';
 import { NiceBreakpoints } from '@nice2dev/ui-core';
 import { NiceCacheConfig } from '@nice2dev/ui-core';
+import { NiceChangeMeta } from '@nice2dev/ui-core';
+import { NiceChangeReason } from '@nice2dev/ui-core';
 import { NiceComponentType } from '@nice2dev/ui-core';
 import { NiceCrossTabSyncConfig } from '@nice2dev/ui-core';
 import { NiceCursorLoadOptions } from '@nice2dev/ui-core';
@@ -195,6 +200,8 @@ import { NiceEditorSize } from '@nice2dev/ui-core';
 import { NiceEntityMenuDto } from '@nice2dev/ui-core';
 import { NiceFavoriteItem } from '@nice2dev/ui-core';
 import { NiceFieldState } from '@nice2dev/ui-core';
+import { NiceFieldStatus } from '@nice2dev/ui-core';
+import { NiceFieldStatusProps } from '@nice2dev/ui-core';
 import { NiceFilterCondition } from '@nice2dev/ui-core';
 import { NiceFilterGroup } from '@nice2dev/ui-core';
 import { NiceFilterOperator } from '@nice2dev/ui-core';
@@ -229,6 +236,9 @@ import { NiceODataConfig } from '@nice2dev/ui-core';
 import { NiceOfflineFirstConfig } from '@nice2dev/ui-core';
 import { NiceOnboardingAnswer } from '@nice2dev/ui-core';
 import { NiceOnboardingQuestion } from '@nice2dev/ui-core';
+import { NiceOnChange } from '@nice2dev/ui-core';
+import { NiceOnOpenChange } from '@nice2dev/ui-core';
+import { NiceOnSelect } from '@nice2dev/ui-core';
 import { NiceOptimisticConfig } from '@nice2dev/ui-core';
 import { NiceOption } from '@nice2dev/ui-core';
 import { NiceOrganizationProfile } from '@nice2dev/ui-core';
@@ -265,6 +275,8 @@ import { NiceSSEDataSource } from '@nice2dev/ui-core';
 import { NiceSSEMessage } from '@nice2dev/ui-core';
 import { NiceSSEMessageType } from '@nice2dev/ui-core';
 import { niceStaggerDelay } from '@nice2dev/ui-core';
+import { NiceStandardFieldProps } from '@nice2dev/ui-core';
+import { NiceStandardProps } from '@nice2dev/ui-core';
 import { NiceStateIO } from '@nice2dev/ui-core';
 import { NiceStateSnapshot } from '@nice2dev/ui-core';
 import { NiceSwipeableListItem } from '@nice2dev/ui-core';
@@ -300,6 +312,7 @@ import { NiceThemeVariantConfigurator } from '@nice2dev/ui-core';
 import { NiceThemeVariantConfiguratorProps } from '@nice2dev/ui-core';
 import { NiceThemeVariantProvider } from '@nice2dev/ui-core';
 import { NiceThemeVariantProviderProps } from '@nice2dev/ui-core';
+import { NiceTone } from '@nice2dev/ui-core';
 import { NiceTouchTarget } from '@nice2dev/ui-core';
 import { NiceTransitionState } from '@nice2dev/ui-core';
 import { NiceTranslateFn } from '@nice2dev/ui-core';
@@ -309,6 +322,7 @@ import { NiceUserMenuResponse } from '@nice2dev/ui-core';
 import { NiceUserPreferences } from '@nice2dev/ui-core';
 import { NiceUserPreferencesProvider } from '@nice2dev/ui-core';
 import { NiceUserPreferencesProviderProps } from '@nice2dev/ui-core';
+import { NiceValidationStatus } from '@nice2dev/ui-core';
 import { NiceVariant } from '@nice2dev/ui-core';
 import { NiceVisuallyHidden } from '@nice2dev/ui-core';
 import { NiceWebSocketConfig } from '@nice2dev/ui-core';
@@ -501,6 +515,7 @@ import { useComponentHelp } from '@nice2dev/ui-core';
 import { useContainerSize } from '@nice2dev/ui-core';
 import { UseContainerSizeResult } from '@nice2dev/ui-core';
 import { useControlId } from '@nice2dev/ui-core';
+import { useControllableState } from '@nice2dev/ui-core';
 import { useControlPreferences } from '@nice2dev/ui-core';
 import { useDarkMode } from '@nice2dev/ui-core';
 import { UseDarkModeOptions } from '@nice2dev/ui-core';
@@ -1748,6 +1763,9 @@ export { buildAriaDescribedBy }
 
 export { buildFormFieldAria }
 
+/** Build the iCalendar text body for the given events. */
+export declare function buildIcs(events: NiceIcsEvent[], options?: ExportIcsOptions): string;
+
 /** Bulk operation */
 export declare interface BulkOperation {
     id: string;
@@ -2716,6 +2734,9 @@ export { createCustomDataSource }
  */
 export declare function createDocIndex(docs: ComponentDoc[], packageName: string): DocIndex;
 
+/** Build an empty recipe scaffold (used by NiceRecipeEditor "new" mode). */
+export declare function createEmptyRecipe(partial?: Partial<NiceRecipeModel>): NiceRecipeModel;
+
 export { createGraphQLDataSource }
 
 export { createGraphQLSubscriptionSource }
@@ -3068,6 +3089,10 @@ export { DENSITY_VALUES }
 
 export { DensityVariant }
 
+export { deprecateProp }
+
+export { deprecateSymbol }
+
 /** Deserialize and validate a module manifest from JSON. */
 export declare function deserializeManifest(json: string): NiceModuleManifest;
 
@@ -3675,6 +3700,12 @@ export declare function downloadCSV<T extends Record<string, unknown>>(data: T[]
  */
 export declare function downloadHTML<T extends Record<string, unknown>>(data: T[], columns: NiceExportColumn[], options?: NiceHTMLOptions): void;
 
+/**
+ * Trigger a browser download of the events as an `.ics` file.
+ * No-op outside the browser.
+ */
+export declare function downloadIcs(events: NiceIcsEvent[], filename?: string, options?: ExportIcsOptions): void;
+
 /**
  * Downloads data as a JSON file.
  */
@@ -3717,6 +3748,24 @@ export declare interface DRMSettings {
 /** DRM system */
 export declare type DRMSystem = 'widevine' | 'fairplay' | 'playready' | 'clearkey';
 
+/** Dropdown horizontal alignment relative to the trigger. */
+export declare type DropdownAlign = 'auto' | 'left' | 'right';
+
+/**
+ * Dual-visibility props shared by NiceCountryPicker & NiceLanguagePicker.
+ * "InValue" controls trigger rendering, "InMenu" controls dropdown options.
+ */
+export declare interface DualVisibilityProps {
+    /** Show flag inside the trigger (selected value). Default: true */
+    showFlagInValue?: boolean;
+    /** Show flag inside dropdown options. Default: true */
+    showFlagInMenu?: boolean;
+    /** Show display text (country name / language name) inside the trigger. Default: false (compact) */
+    showTextInValue?: boolean;
+    /** Show display text inside dropdown options. Default: true */
+    showTextInMenu?: boolean;
+}
+
 export declare const Dynamics365Connector: ConnectorDefinition;
 
 export declare interface Dynamics365ConnectorConfig extends ConnectorConfig {
@@ -4288,6 +4337,20 @@ declare type ExportFormat_2 = 'zustand' | 'redux-toolkit' | 'jotai' | 'recoil' |
 
 declare type ExportFormat_3 = 'sql' | 'json' | 'csv' | 'parquet';
 
+/**
+ * Produce an RFC 5545 `text/calendar` Blob ready for download or attachment.
+ */
+export declare function exportIcs(events: NiceIcsEvent[], options?: ExportIcsOptions): Blob;
+
+export declare interface ExportIcsOptions {
+    /** Calendar PRODID. Default: `-//nice2dev//NiceToDev.UI//EN`. */
+    prodId?: string;
+    /** X-WR-CALNAME (calendar display name). */
+    calendarName?: string;
+    /** Method (PUBLISH, REQUEST, CANCEL). Default omitted. */
+    method?: 'PUBLISH' | 'REQUEST' | 'CANCEL' | 'REPLY';
+}
+
 export declare interface ExportProgress {
     status: 'idle' | 'preparing' | 'encoding' | 'completed' | 'error';
     progress: number;
@@ -4609,6 +4672,33 @@ export { filterNiceThemePacksByTag }
 
 export declare type FilterType = 'brightness' | 'contrast' | 'saturation' | 'hue' | 'blur' | 'sharpen' | 'grayscale' | 'sepia' | 'invert' | 'vignette' | 'chromaKey' | 'colorCorrection';
 
+/**
+ * Heraldically-correct flag icon rendered from `country-flag-icons` SVGs
+ * (3:2 aspect ratio). Falls back to a coloured stripe swatch when the
+ * ISO code is not recognised. Width is parameterised; height is always
+ * `Math.round(size * 2 / 3)` to keep a true 3:2 ratio regardless of
+ * caller. The SVG is inlined via `dangerouslySetInnerHTML` — content is
+ * a static, audited string from the `country-flag-icons` package.
+ */
+export declare const FlagIcon: default_2.FC<{
+    code: string;
+    size?: number;
+    className?: string;
+}>;
+
+/**
+ * Legacy coloured-stripe swatch using the {@link getFlagColors} commons
+ * palette. Kept as a fallback for unknown ISO codes and for environments
+ * that cannot ship the SVG bundle. New code should prefer {@link FlagIcon}.
+ *
+ * @deprecated Prefer {@link FlagIcon} for accurate, heraldically-correct flags.
+ */
+export declare const FlagSwatch: default_2.FC<{
+    code: string;
+    size?: number;
+    className?: string;
+}>;
+
 /**
  * Flat token map
  */
@@ -5583,6 +5673,30 @@ declare interface KnowledgeBaseArticle {
     lastUpdated: string;
 }
 
+export declare interface Language {
+    /** BCP-47 language tag, e.g. 'en', 'en-US', 'pt-BR'. */
+    code: string;
+    /** Native language name (auto-glyph), e.g. 'Polski'. */
+    nativeName: string;
+    /** English language name, e.g. 'Polish'. */
+    englishName: string;
+    /**
+     * ISO 3166-1 alpha-2 country code whose flag visually represents this
+     * language entry (best-effort — language≠country, but flags are useful
+     * affordances). Override per-row via `languages` prop.
+     */
+    flagCountryCode: string;
+}
+
+export declare type LanguageDisplayName = 'native' | 'english';
+
+/**
+ * Curated list of common languages. Region-specific entries (en-US, en-GB,
+ * pt-BR, pt-PT) included where they meaningfully differ in usage. Add more
+ * via the `languages` prop or PR.
+ */
+export declare const LANGUAGES: Language[];
+
 declare interface LayoutColumn {
     id: string;
     width: number;
@@ -6589,6 +6703,9 @@ export declare type NetworkNodeCategory = 'router' | 'switch' | 'access-point' |
 
 export declare type NetworkNodeStatus = 'online' | 'offline' | 'warning';
 
+/** Tiny non-cryptographic id generator suitable for UI-only records. */
+export declare function newRecipeId(prefix?: string): string;
+
 export { NICE_BREAKPOINTS }
 
 export { NICE_BUILTIN_ICONS }
@@ -7051,6 +7168,8 @@ export declare interface NiceAppManifest {
     tenantId?: string;
 }
 
+export { NiceAriaProps }
+
 export { NiceArrayDataSourceConfig }
 
 export declare type NiceAuditAction = 'create' | 'update' | 'delete' | 'view' | 'export' | 'import' | 'login' | 'logout' | 'custom';
@@ -7154,6 +7273,42 @@ export declare interface NiceAuditLogProps {
     'data-testid'?: string;
 }
 
+export declare const NiceAuthButtons: default_2.ForwardRefExoticComponent<NiceAuthButtonsProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceAuthButtonsProps {
+    /**
+     * Authenticated user — when set, renders the user-menu instead of
+     * login/register buttons.
+     */
+    user?: NiceAuthUser;
+    /** Items shown in the user-menu dropdown (only when `user` is set). */
+    userMenuItems?: UserMenuItem[];
+    /** Convenience handler appended as a "Profile" item if no items are given. */
+    onProfile?: () => void;
+    /** Convenience handler appended as a "Logout" item if no items are given. */
+    onLogout?: () => void;
+    /** Show the "Sign in" button when no `user`. Default: `true`. */
+    showLogin?: boolean;
+    /** Login button label. */
+    loginLabel?: string;
+    /** Login click handler. */
+    onLoginClick?: () => void;
+    /** Show the "Register" button when no `user`. Default: auto-true if `onRegisterClick` provided. */
+    showRegister?: boolean;
+    /** Register button label. */
+    registerLabel?: string;
+    /** Register click handler. */
+    onRegisterClick?: () => void;
+    /** Button size. */
+    size?: NiceSize;
+    /** Compact mode — hides login button text on narrow viewports (CSS-driven). */
+    compact?: boolean;
+    className?: string;
+    style?: default_2.CSSProperties;
+    id?: string;
+    'data-testid'?: string;
+}
+
 /**
  * {@link NiceAuthGuard} — Protected route/section wrapper.
  * Checks authentication and permission/role requirements before rendering children.
@@ -7184,6 +7339,21 @@ export declare interface NiceAuthGuardProps {
     children: default_2.ReactNode;
 }
 
+export declare interface NiceAuthUser {
+    /** Display name. */
+    name: string;
+    /** Avatar image URL. */
+    avatarUrl?: string;
+    /** Initials fallback (auto-derived from `name` when omitted). */
+    initials?: string;
+    /** Optional email address shown in the user-menu header. */
+    email?: string;
+    /** Optional role/title shown in the user-menu header. */
+    role?: string;
+    /** Online status indicator. */
+    status?: 'online' | 'away' | 'busy' | 'offline';
+}
+
 export declare const NiceAutocomplete: default_2.FC<NiceAutocompleteProps>;
 
 /** Props for the {@link NiceAutocomplete} component — a text input with filtered suggestion dropdown and optional multi-select. */
@@ -7853,6 +8023,10 @@ export declare interface NiceChangelogEntry {
     changes: string[];
 }
 
+export { NiceChangeMeta }
+
+export { NiceChangeReason }
+
 export declare const NiceChart: default_2.FC<NiceChartProps>;
 
 export declare const NiceChartAI: default_2.ForwardRefExoticComponent<NiceChartAIProps & default_2.RefAttributes<NiceChartAIRef>>;
@@ -8172,6 +8346,18 @@ declare interface NiceCodeEditorAIRef extends NiceCodeEditorRef {
     dismissCompletion: () => void;
 }
 
+declare interface NiceCodeEditorLspConfig {
+    /**
+     * Language Server Protocol bridge configuration.
+     * url: WebSocket endpoint of the LSP server
+     * language: Monaco language id
+     * initOptions: Optional initialization options for the LSP
+     */
+    url: string;
+    language: string;
+    initOptions?: any;
+}
+
 export declare interface NiceCodeEditorOptions {
     /** Read only mode */
     readOnly?: boolean;
@@ -8286,6 +8472,10 @@ export declare interface NiceCodeEditorProps {
     showToolbar?: boolean;
     /** Show status bar at bottom */
     showStatusBar?: boolean;
+    /**
+     * LSP bridge configuration. If provided, connects Monaco to the LSP server for enhanced language features.
+     */
+    lsp?: NiceCodeEditorLspConfig;
     /** Additional CSS class */
     className?: string;
     /** Test ID */
@@ -9150,7 +9340,7 @@ declare type NiceCountdownFormat =
 
 export declare const NiceCountryPicker: default_2.FC<NiceCountryPickerProps>;
 
-export declare interface NiceCountryPickerProps extends NiceFormFieldProps {
+export declare interface NiceCountryPickerProps extends NiceFormFieldProps, DualVisibilityProps {
     /** Selected country code */
     value?: string;
     /** Default country code (uncontrolled) */
@@ -9163,10 +9353,36 @@ export declare interface NiceCountryPickerProps extends NiceFormFieldProps {
     showSearch?: boolean;
     /** Search placeholder */
     searchPlaceholder?: string;
-    /** Show dial code */
+    /**
+     * @deprecated Use `showDialCodeInValue` and `showDialCodeInMenu` for fine-grained control.
+     * When set, applies to both trigger and menu (legacy behaviour).
+     */
     showDialCode?: boolean;
-    /** Show flag */
+    /**
+     * @deprecated Use `showFlagInValue` and `showFlagInMenu` for fine-grained control.
+     * When set, applies to both trigger and menu (legacy behaviour).
+     */
     showFlag?: boolean;
+    /** Show dial code in trigger (selected value). Default: false (compact) */
+    showDialCodeInValue?: boolean;
+    /** Show dial code in dropdown options. Default: true */
+    showDialCodeInMenu?: boolean;
+    /** Show ISO 3166-1 alpha-2 code (e.g. "PL") in trigger. Default: false. */
+    showCodeInValue?: boolean;
+    /** Show ISO 3166-1 alpha-2 code (e.g. "PL") in dropdown options. Default: false. */
+    showCodeInMenu?: boolean;
+    /**
+     * Compact mode: minimal trigger width (flag + chevron only) and smart
+     * dropdown alignment. Equivalent to setting all `*InValue` props to
+     * false (except flag) and ignoring `controlWidth`. Default: false.
+     */
+    compact?: boolean;
+    /**
+     * Dropdown horizontal alignment relative to the trigger. `'auto'` picks
+     * the side with more available viewport space (right-edge preferred).
+     * Default: `'auto'` in compact mode, `'left'` otherwise.
+     */
+    dropdownAlign?: DropdownAlign;
     /** Filter to only show certain countries */
     countries?: string[];
     /** Priority countries shown at top */
@@ -9431,7 +9647,7 @@ export declare interface NiceDataDiffViewerProps extends NiceBaseProps {
     onSelectRecord?: (table: string, recordId: string) => void;
 }
 
-export declare function NiceDataGrid<T extends Record<string, any>>({ columns, data: dataProp, keyField, dataSource, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, pagination, pageSize: initPageSize, page: controlledPage, onPageChange, totalRows, searchable, searchPlaceholder, virtualScroll, rowHeight, groupBy, groupRender, onCellEdit, editMode, formItems, formColumns, editFormTitle, formProps, onRowEdit, onRowAdd, onRowDelete, bulkActions, onBulkDelete, exportCsv, exportFilename, detailRow, expandedRowKeys: controlledExpandedRows, onExpandedRowChange, columnReorder, onColumnReorder, columnResize, rowDraggable, onRowReorder, striped, compact, loading: loadingProp, emptyText, toolbar, onRowClick, pinnedTopKeys, pinnedBottomKeys, colSpan: colSpanFn, showStatusBar, contextMenuItems, onContextMenuAction, printFriendly, keyboardNavigation, focusedCell: controlledFocusedCell, onFocusedCellChange, cellRangeSelection, selectedCellRange: controlledCellRange, onCellRangeChange, clipboard, clipboardFormat, onBeforeCopy, onCopy, onPaste, quickFilters, activeQuickFilters: controlledQuickFilters, onQuickFilterChange, columnGroups, stateStorageKey, initialState, onStateChange, flashRowKeys, flashDuration, autoFitColumns, showColumnStats, rowIndicator, frozenRows, className, style, accessMode, id, displayStyle, }: NiceDataGridProps<T>): JSX_2.Element | null;
+export declare function NiceDataGrid<T extends Record<string, any>>({ columns, data: dataProp, keyField, dataSource, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, pagination, pageSize: initPageSize, page: controlledPage, onPageChange, totalRows, searchable, searchPlaceholder, virtualScroll, rowHeight, groupBy, groupRender, onCellEdit, editMode, formItems, formColumns, editFormTitle, formProps, onRowEdit, onRowAdd, onRowDelete: _onRowDelete, bulkActions, onBulkDelete, exportCsv, exportFilename, detailRow, expandedRowKeys: controlledExpandedRows, onExpandedRowChange, columnReorder: _columnReorder, onColumnReorder: _onColumnReorder, columnResize, rowDraggable, onRowReorder, striped, compact, loading: loadingProp, emptyText, toolbar, onRowClick, pinnedTopKeys, pinnedBottomKeys, colSpan: colSpanFn, showStatusBar, contextMenuItems, onContextMenuAction, printFriendly, keyboardNavigation, focusedCell: controlledFocusedCell, onFocusedCellChange, cellRangeSelection, selectedCellRange: controlledCellRange, onCellRangeChange, clipboard, clipboardFormat, onBeforeCopy, onCopy, onPaste, quickFilters, activeQuickFilters: controlledQuickFilters, onQuickFilterChange, columnGroups: _columnGroups, stateStorageKey, initialState, onStateChange, flashRowKeys, flashDuration, autoFitColumns: _autoFitColumns, showColumnStats: _showColumnStats, rowIndicator, frozenRows: _frozenRows, className, style, accessMode, id, displayStyle, }: NiceDataGridProps<T>): JSX_2.Element | null;
 
 export declare namespace NiceDataGrid {
     var displayName: string;
@@ -9462,7 +9678,7 @@ export declare interface NiceDataGridAIProps<T extends Record<string, unknown>>
     exampleQueries?: string[];
 }
 
-declare interface NiceDataGridAIRef<T> {
+declare interface NiceDataGridAIRef<_T> {
     /** Apply natural language filter */
     applyNLFilter: (query: string) => Promise<void>;
     /** Clear AI filters */
@@ -9780,6 +9996,16 @@ export declare interface NiceDatePickerProps extends NiceFormFieldProps {
      * to the browser locale (`navigator.language`).
      */
     displayLocale?: string;
+    /**
+     * Enable date-shortcut keys (default: `true`):
+     *  - `T` — set to today
+     *  - `+`/`=` then `1` (or any digit) — today + N days
+     *  - `-` then `1` — today - N days
+     *  - `+`/`-` then `M` — ± 1 month
+     *  - `+`/`-` then `Y` — ± 1 year
+     * Only fires for date / datetime / month presets.
+     */
+    keyboardShortcuts?: boolean;
 }
 
 export declare const NiceDateRangeBox: default_2.FC<NiceDateRangeBoxProps>;
@@ -10141,7 +10367,7 @@ export declare interface NiceDocumentApprovalFlowProps extends NiceFormFieldProp
     locale?: string;
 }
 
-export declare function NiceDocumentationViewer({ doc, component, renderPreview, defaultTab, sections, compact, enableCodeEdit, className, style, }: NiceDocumentationViewerProps): JSX_2.Element;
+export declare function NiceDocumentationViewer({ doc, component: _component, renderPreview: _renderPreview, defaultTab, sections, compact, enableCodeEdit, className, style, }: NiceDocumentationViewerProps): JSX_2.Element;
 
 export declare interface NiceDocumentationViewerProps {
     /** Component documentation data */
@@ -10987,6 +11213,10 @@ export declare interface NiceFieldExpectation {
 
 export { NiceFieldState }
 
+export { NiceFieldStatus }
+
+export { NiceFieldStatusProps }
+
 /** A custom column in the {@link NiceFileManager} detail view. */
 export declare interface NiceFileColumnDef {
     /** Column key. */
@@ -11048,6 +11278,8 @@ export declare interface NiceFileManagerProps extends NiceBaseProps {
     viewMode?: 'list' | 'detail' | 'thumbnails';
     selectable?: boolean;
     showBreadcrumb?: boolean;
+    /** Show top toolbar with single/dual-pane switch + view mode toggles + search */
+    showTopToolbar?: boolean;
     /** Show function-key toolbar at bottom (dual-pane style) */
     showFnToolbar?: boolean;
     /** Show status bar with selection summary */
@@ -11084,6 +11316,10 @@ export declare interface NiceFileManagerProps extends NiceBaseProps {
     onRefresh?: (panel?: NiceFilePanel) => void;
     /** Sort change */
     onSortChange?: (sort: NiceFileSort, panel?: NiceFilePanel) => void;
+    /** Top toolbar — toggle dual-pane mode (called when user clicks Single/Dual buttons) */
+    onDualPaneChange?: (dual: boolean) => void;
+    /** Top toolbar — change view mode */
+    onViewModeChange?: (mode: 'list' | 'detail' | 'thumbnails') => void;
 }
 
 /** Active panel identifier for dual-pane {@link NiceFileManager}. */
@@ -12127,6 +12363,31 @@ export { NiceIconResolver }
 
 export { NiceIconSize }
 
+/**
+ * exportIcs — produce an RFC 5545 (`text/calendar`) Blob from a generic
+ * event list. Useful for "Add to calendar" exports from any view that has
+ * date+time data (NiceCalendar, NiceGantt, etc.).
+ *
+ * @example
+ * const blob = exportIcs([{ uid: '1', summary: 'Meeting', start: new Date(), end: new Date(Date.now()+3600e3) }]);
+ */
+export declare interface NiceIcsEvent {
+    uid: string;
+    summary: string;
+    start: Date;
+    end?: Date;
+    description?: string;
+    location?: string;
+    url?: string;
+    /** RFC 5545 STATUS. */
+    status?: 'TENTATIVE' | 'CONFIRMED' | 'CANCELLED';
+    /** RRULE (e.g. `FREQ=WEEKLY;BYDAY=MO,WE`). */
+    rrule?: string;
+    /** All-day event — emits VALUE=DATE properties. */
+    allDay?: boolean;
+    categories?: string[];
+}
+
 declare type NiceImageAnnotationType = 'text' | 'rect' | 'circle' | 'line' | 'arrow';
 
 export declare const NiceImageAnnotator: default_2.ForwardRefExoticComponent<NiceImageAnnotatorProps & default_2.RefAttributes<NiceImageAnnotatorRef>>;
@@ -12300,6 +12561,31 @@ export { NiceInfiniteScrollConfig }
 
 export { NiceInfiniteScrollState }
 
+/**
+ * Shared meal/recipe/ingredient models.
+ *
+ * Used by:
+ *  - NiceRecipe (planning) — display
+ *  - NiceRecipeEditor (tools) — editing
+ *  - NiceScheduler (planning) — when an event has `eventType: 'recipe'`
+ */
+/** A single measurable component of a recipe (e.g. "200 g flour"). */
+export declare interface NiceIngredient {
+    id: string;
+    /** Display name, e.g. "All-purpose flour". */
+    name: string;
+    /** Numeric amount (parsed). Use `unit` for the measurement. */
+    quantity?: number;
+    /** Free-form unit string: "g", "ml", "tbsp", "cup", "pcs". */
+    unit?: string;
+    /** Free-form notes shown next to the ingredient ("sifted", "room temp"). */
+    notes?: string;
+    /** Optional grouping ("Dough", "Filling", "Topping"). */
+    group?: string;
+    /** Marks the ingredient as completed in interactive shopping/cook mode. */
+    checked?: boolean;
+}
+
 export { NiceInlineHelp }
 
 export { NiceInlineHelpProps }
@@ -12496,6 +12782,8 @@ export declare interface NiceKanbanBoardProps extends NiceBaseProps, TracelessSt
     size?: NiceSize;
     /** Allow columns to be collapsed */
     collapsible?: boolean;
+    /** Layout mode — `scroll` (default, horizontal scroll when overflowing) or `responsive` (columns wrap to fit container width). */
+    layoutMode?: NiceKanbanLayoutMode;
     /** View mode (default, compact, detailed) */
     viewMode?: NiceKanbanViewMode;
     /** Callback when view mode changes */
@@ -12550,6 +12838,11 @@ export declare interface NiceKanbanColumn {
     limit?: number;
 }
 
+/** Layout mode for the kanban board container.
+ * - `scroll`: Columns keep their min/max width and the board scrolls horizontally when they don't fit (default).
+ * - `responsive`: Columns wrap onto multiple rows and flex-grow to fill the available width — no horizontal overflow. */
+declare type NiceKanbanLayoutMode = 'scroll' | 'responsive';
+
 /** Persisted state for NiceKanbanBoard */
 export declare interface NiceKanbanPersistedState {
     /** Collapsed column keys */
@@ -12605,6 +12898,52 @@ export declare interface NiceKnobProps extends Omit<NiceFormFieldProps, 'size' |
     isLabelCentered?: boolean;
 }
 
+export declare const NiceLanguagePicker: default_2.FC<NiceLanguagePickerProps>;
+
+export declare interface NiceLanguagePickerProps extends NiceFormFieldProps, DualVisibilityProps {
+    /** Selected language code (BCP-47) */
+    value?: string;
+    /** Default selected code (uncontrolled) */
+    defaultValue?: string;
+    /** Callback when selection changes */
+    onChange?: (language: Language | null) => void;
+    /** Placeholder text shown when nothing selected (ignored in compact mode) */
+    placeholder?: string;
+    /** Enable search */
+    showSearch?: boolean;
+    /** Search placeholder */
+    searchPlaceholder?: string;
+    /** Show BCP-47 code in trigger. Default: false (compact) */
+    showCodeInValue?: boolean;
+    /** Show BCP-47 code in dropdown options. Default: true */
+    showCodeInMenu?: boolean;
+    /** Which name to render. Default: 'native' (best-practice for language switchers). */
+    displayName?: LanguageDisplayName;
+    /**
+     * Compact mode: minimal trigger width (flag + chevron only) and smart
+     * dropdown alignment. Default: false.
+     */
+    compact?: boolean;
+    /**
+     * Dropdown horizontal alignment relative to trigger. `'auto'` picks the
+     * side with more available viewport space. Default: `'auto'` in compact
+     * mode, `'left'` otherwise.
+     */
+    dropdownAlign?: DropdownAlign;
+    /** Custom language list (overrides `LANGUAGES`). */
+    languages?: Language[];
+    /** Filter the default list to only show certain codes. */
+    allowedCodes?: string[];
+    /** Priority codes shown at the top. */
+    priorityCodes?: string[];
+    /** Allow clearing selection */
+    allowClear?: boolean;
+    /** Size variant */
+    size?: NiceSize;
+    /** Test ID */
+    'data-testid'?: string;
+}
+
 /**
  * {@link NiceLeaderboard} — Ranked list of players/entities with scores, deltas, avatars, and stat columns.
  */
@@ -13056,7 +13395,7 @@ export declare const NiceLockButton: default_2.FC<NiceLockButtonProps>;
 
 export declare interface NiceLockButtonProps extends NiceBaseProps {
     isLocked: boolean;
-    onToggle: (locked: boolean) => void;
+    onLockChange: (locked: boolean) => void;
     requireConfirm?: boolean;
     confirmCode?: string;
     size?: NiceSize;
@@ -13107,6 +13446,57 @@ export declare interface NiceLoginFormProps extends NiceBaseProps {
     passwordPlaceholder?: string;
 }
 
+export declare const NiceLogo: default_2.ForwardRefExoticComponent<NiceLogoProps & default_2.RefAttributes<HTMLElement>>;
+
+export declare interface NiceLogoProps {
+    /** Image URL to render as `<img>`. Has priority over `icon` and `variant`. */
+    src?: string;
+    /** Custom icon node (SVG / NiceIcon / emoji). Has priority over `variant`. */
+    icon?: default_2.ReactNode;
+    /**
+     * Pre-built brand mark variant from the OmniVerk family.
+     * Used when neither `src` nor `icon` is provided.
+     * Default: `'mark'`.
+     */
+    variant?: NiceLogoVariant;
+    /** Brand name rendered next to the icon. Hidden if `iconOnly` is true. */
+    text?: string;
+    /** Render only the icon (no text). */
+    iconOnly?: boolean;
+    /** Render only the text (no icon). */
+    textOnly?: boolean;
+    /**
+     * Logo height in pixels — width is derived to preserve aspect ratio.
+     * Accepts presets (`xs`/`sm`/`md`/`lg`/`xl`) or a raw number.
+     * Default: `'md'` (32 px).
+     */
+    size?: NiceLogoSize;
+    /**
+     * Render as `<a href>` link.
+     * If neither `href` nor `onClick` is set, the logo is a static `<span>`.
+     */
+    href?: string;
+    /** Click handler — renders as `<button>`. */
+    onClick?: () => void;
+    /** Accessible label (default: `text` or "Brand"). */
+    ariaLabel?: string;
+    className?: string;
+    style?: default_2.CSSProperties;
+    id?: string;
+    'data-testid'?: string;
+}
+
+export declare type NiceLogoSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | number;
+
+/**
+ * Brand mark variant.
+ * - `mark` (default): symbol only — diamond + triangle (NtdOmniVerk).
+ * - `badge`: rounded-square enclosed mark (NtdOmniVerkBadge), good for favicons / chips.
+ * - `spinner`: animated rotating mark (NtdOmniVerkSpinner) — use for loading states.
+ * - `logo`: full mark + wordmark side-by-side (NtdOmniVerkLogo).
+ */
+export declare type NiceLogoVariant = 'mark' | 'badge' | 'spinner' | 'logo';
+
 export declare const NiceLookup: default_2.FC<NiceLookupProps>;
 
 /** Column definition for the mini-grid lookup mode. */
@@ -13176,7 +13566,7 @@ export declare interface NiceLowCodeStudioProps {
     className?: string;
 }
 
-export declare function NiceMAM({ assets: initialAssets, folders: initialFolders, collections: initialCollections, people: initialPeople, currentUser, uploadEndpoint, enableAITagging, enableFaceRecognition, maxUploadSize, allowedTypes, onUpload, onDelete, onAnalyze, onDetectFaces, onSelectionChange, onPreview, renderAssetCard, className, style, children, ...baseProps }: NiceMAMProps): JSX_2.Element;
+export declare function NiceMAM({ assets: initialAssets, folders: initialFolders, collections: initialCollections, people: initialPeople, currentUser, uploadEndpoint: _uploadEndpoint, enableAITagging, enableFaceRecognition, maxUploadSize: _maxUploadSize, allowedTypes: _allowedTypes, onUpload: _onUpload, onDelete, onAnalyze, onDetectFaces, onSelectionChange: _onSelectionChange, onPreview, renderAssetCard, className, style, children, ...baseProps }: NiceMAMProps): JSX_2.Element;
 
 export declare interface NiceMAMProps extends NiceBaseProps {
     /** Initial assets */
@@ -13413,50 +13803,50 @@ export declare interface NiceMdiWorkspaceProps extends NiceBaseProps {
     unsavedWarningMessage?: string;
 }
 
-export declare const NiceMegaMenu: default_2.ForwardRefExoticComponent<NiceMegaMenuProps & default_2.RefAttributes<HTMLDivElement>>;
-
-/** A column within a {@link NiceMegaMenuPanel}. */
-export declare interface NiceMegaMenuColumn {
-    /** Optional column header text. */
-    header?: string;
-    /** Menu items in this column. */
-    items: NiceMegaMenuItem[];
-}
-
-/** A clickable item inside a {@link NiceMegaMenuColumn}. */
-export declare interface NiceMegaMenuItem {
-    /** Unique key. */
-    key: string;
-    /** Display label. */
-    label: string;
-    /** Optional icon. */
-    icon?: default_2.ReactNode;
-    /** If set, renders the item as a link. */
-    href?: string;
-    /** Click handler. */
-    onClick?: () => void;
-    /** Disable the item. */
-    disabled?: boolean;
+/** A planned meal — references one or more recipes. */
+export declare interface NiceMeal {
+    id: string;
+    /** Display name, e.g. "Sunday Brunch". */
+    name: string;
+    /** Date/time the meal is served. */
+    servedAt?: Date;
+    kind?: NiceMealKind;
+    /** Recipes that compose this meal. */
+    recipeIds: string[];
+    /** Optional override of total servings for this meal. */
+    servings?: number;
+    notes?: string;
 }
 
-/** A top-level panel (mega dropdown) in the {@link NiceMegaMenu}. */
-export declare interface NiceMegaMenuPanel {
-    /** Unique key. */
-    key: string;
-    /** Panel trigger label. */
-    label: string;
-    /** Multi-column layout. */
-    columns: NiceMegaMenuColumn[];
-    /** Fully custom panel renderer (overrides columns). */
-    renderPanel?: () => default_2.ReactNode;
-}
+/** Meal kind used by meal planners. */
+export declare type NiceMealKind = 'breakfast' | 'lunch' | 'dinner' | 'snack' | 'other';
 
-/** Props for the {@link NiceMegaMenu} component — a desktop mega-dropdown navigation bar. */
-export declare interface NiceMegaMenuProps extends NiceBaseProps {
-    /** Panel definitions. */
-    items: NiceMegaMenuPanel[];
-    /** Size preset. */
-    size?: NiceSize;
+/**
+ * Weekly meal planner — rows are meal kinds (breakfast/lunch/dinner by
+ * default), columns are the seven days starting at {@link weekStart}.
+ * Each cell shows the meals served at that day+kind; users can add a
+ * recipe from the pool via the cell's `+` picker, or remove individual
+ * meal cards. Pure-client state (raises {@link onChange} with the new
+ * meals array).
+ *
+ * Pairs naturally with `NiceScheduler` — meal `servedAt` dates can be
+ * surfaced as scheduler events upstream.
+ */
+export declare const NiceMealPlan: default_2.FC<NiceMealPlanProps>;
+
+export declare interface NiceMealPlanProps extends NiceBaseProps {
+    /** Pool of recipes the user can pick from. */
+    recipes: NiceRecipeModel[];
+    /** Planned meals. */
+    meals: NiceMeal[];
+    /** Called whenever the meal list changes. */
+    onChange?: (meals: NiceMeal[]) => void;
+    /** First day of the week to render (defaults to today's Monday). */
+    weekStart?: Date;
+    /** Which meal-kind rows to show (default: breakfast/lunch/dinner). */
+    rows?: NiceMealKind[];
+    /** Read-only mode (no add/remove/move). */
+    readOnly?: boolean;
 }
 
 export declare const NiceMention: default_2.ForwardRefExoticComponent<NiceMentionProps & default_2.RefAttributes<HTMLTextAreaElement>>;
@@ -13487,34 +13877,146 @@ export declare interface NiceMentionSuggestion {
 
 export declare const NiceMenu: default_2.FC<NiceMenuProps>;
 
-/** A single item (or sub-menu) in the {@link NiceMenu}. */
+export declare type NiceMenuAlign = 'start' | 'center' | 'end';
+
+export declare type NiceMenuDensity = 'compact' | 'normal' | 'comfortable';
+
+/**
+ * A single entry in {@link NiceMenu}. Both legacy (`key` + `text` + `items`)
+ * and new (`id` + `label` + `children`) shapes are accepted; new fields
+ * take precedence when both are supplied.
+ */
 export declare interface NiceMenuItem {
-    /** Unique key. */
-    key: string;
-    /** Display text. */
-    text: string;
-    /** Icon element. */
+    /** New canonical identifier. */
+    id?: string;
+    /** Legacy alias for `id`. */
+    key?: string;
+    /** New canonical label (string or arbitrary node). */
+    label?: default_2.ReactNode;
+    /** Legacy alias for `label`. */
+    text?: string;
+    /** Optional small description shown under the label inside dropdown panels. */
+    description?: default_2.ReactNode;
+    /** Leading icon. */
     icon?: default_2.ReactNode;
-    /** Disable this item. */
+    /** Optional badge (string / number) shown to the right of the label. */
+    badge?: default_2.ReactNode;
+    /** When set, renders the entry as an `<a>`. */
+    href?: string;
+    /** Anchor target. */
+    target?: string;
+    /** Anchor rel. */
+    rel?: string;
+    /** Click handler. */
+    onClick?: (event: default_2.MouseEvent) => void;
+    /** Disable the entry. */
     disabled?: boolean;
-    /** Nested sub-menu items. */
+    /** Render the entry as a danger / destructive action. */
+    danger?: boolean;
+    /** When `true`, render a horizontal divider instead of an entry (panel-only). */
+    divider?: boolean;
+    /** New canonical children list (only the first level of nesting opens a flyout). */
+    children?: NiceMenuItem[];
+    /** Legacy alias for `children`. */
     items?: NiceMenuItem[];
-    /** Click handler. */
-    onClick?: () => void;
+    /** Tooltip / `aria-label` override. */
+    ariaLabel?: string;
 }
 
-/** Props for the {@link NiceMenu} component — a horizontal or vertical navigation menu with nested sub-menus. */
+export declare type NiceMenuOrientation = 'horizontal' | 'vertical';
+
 export declare interface NiceMenuProps extends NiceBaseProps {
-    /** Size variant. */
-    size?: NiceSize;
     /** Menu items. */
     items: NiceMenuItem[];
     /** Layout direction. */
-    orientation?: 'horizontal' | 'vertical';
-    /** Called when any item is clicked. */
-    onItemClick?: (item: NiceMenuItem) => void;
+    orientation?: NiceMenuOrientation;
+    /** Visual style. */
+    variant?: NiceMenuVariant;
+    /** Density preset (paddings + font size). */
+    density?: NiceMenuDensity;
+    /** Size preset. */
+    size?: NiceSize;
+    /** Stretch top-level items to fill the container. */
+    fullWidth?: boolean;
+    /** Show vertical separators between top items. */
+    showDividers?: boolean;
+    /** Top-item alignment for dropdown panels. */
+    panelAlign?: NiceMenuAlign;
+    /** Min width for dropdown / sub-panel (px). */
+    panelMinWidth?: number;
+    /** Max width for dropdown / sub-panel (px). */
+    panelMaxWidth?: number;
+    /**
+     * Gap (in px or any CSS length) between top-level items. Use `0` for
+     * a fully flush bar (e.g. tab-bar look). Default: density-driven (`4px`).
+     */
+    itemGap?: number | string;
+    /**
+     * Horizontal padding inside each top-level button. Overrides density.
+     * Accepts a number (treated as `px`) or any CSS length.
+     */
+    paddingX?: number | string;
+    /**
+     * Vertical padding inside each top-level button. Overrides density.
+     * Accepts a number (treated as `px`) or any CSS length.
+     */
+    paddingY?: number | string;
+    /**
+     * Render dropdown / sub-panels in a `document.body` portal so the menu
+     * never gets clipped by `overflow: hidden` ancestors. Default: `true`.
+     * Set `false` to fall back to the legacy absolute-positioned panel.
+     */
+    portal?: boolean;
+    /**
+     * z-index applied to the portalled dropdown panel. Default: `1100`.
+     */
+    panelZIndex?: number;
+    /** Custom arrow node for items with children. Default: `▾`. */
+    arrowIcon?: default_2.ReactNode;
+    /** Custom flyout arrow shown next to nested items. Default: `▸`. */
+    flyoutArrowIcon?: default_2.ReactNode;
+    /** Close the panel after selecting any leaf entry. Default: `true`. */
+    closeOnSelect?: boolean;
+    /**
+     * How to open dropdown panels:
+     * - `click` (default) — toggle on trigger click only.
+     * - `hover`           — open on pointer-enter, close on pointer-leave (after `closeDelay`).
+     * - `both`            — opens on hover *and* click (best-of-both for mega-menus).
+     */
+    openTrigger?: 'click' | 'hover' | 'both';
+    /** Delay (ms) before opening on hover. Default: `120`. */
+    openDelay?: number;
+    /** Delay (ms) before closing after pointer leaves the menu+panel. Default: `180`. */
+    closeDelay?: number;
+    /** Notified whenever the open trigger id changes (null = closed). */
+    onOpenChange?: (id: string | null) => void;
+    /** Highlight the matching id (or any of its ancestors). */
+    activeId?: string;
+    /** Legacy alias for `activeId`. */
+    activeKey?: string;
+    /** Called when any leaf is clicked. */
+    onItemClick?: (item: NiceMenuItem, event: default_2.MouseEvent) => void;
+    /** Accessible name for the wrapper `<nav>`. */
+    ariaLabel?: string;
+    /** Optional renderer for top-level trigger label (allows wrapping with i18n components). */
+    renderTriggerLabel?: (item: NiceMenuItem) => default_2.ReactNode;
+    /** Optional renderer for panel-entry label. */
+    renderEntryLabel?: (item: NiceMenuItem) => default_2.ReactNode;
 }
 
+/**
+ * Visual style for top-level triggers.
+ * - `separated` — soft buttons with gap (default-ish)
+ * - `group`     — flush button-group with shared border
+ * - `pills`     — rounded pills, primary fill on active
+ * - `ghost`     — chrome-less, hover only (used by NiceTopNav)
+ * - `solid`     — opaque buttons on `--bg-elevated`
+ * - `underline` — flat with animated underline on hover/active
+ * - `tabs`      — tab-bar look (top-rounded, bottom border)
+ * - `glass`     — translucent blurred background
+ */
+export declare type NiceMenuVariant = 'separated' | 'group' | 'pills' | 'ghost' | 'solid' | 'underline' | 'tabs' | 'glass' | 'bordered' | 'borderless';
+
 export declare const NiceMergeRequestBuilder: default_2.FC<NiceMergeRequestBuilderProps>;
 
 export declare interface NiceMergeRequestBuilderProps extends NiceBaseProps {
@@ -14075,29 +14577,220 @@ export declare interface NiceNavbarProps extends NiceFormFieldProps {
     onBrandClick?: () => void;
 }
 
-export declare const NiceNetworkDiscoveryPanel: default_2.FC<NiceNetworkDiscoveryPanelProps>;
+export declare const NiceNavMenu: default_2.ForwardRefExoticComponent<NiceNavMenuProps & default_2.RefAttributes<HTMLElement>>;
 
-export declare interface NiceNetworkDiscoveryPanelProps extends NiceBaseProps {
-    nodes: NiceNetworkNode[];
-    topology?: NiceTopologyData;
-    onScan: (subnet?: string) => Promise<void>;
-    onNodeClick: (nodeId: string) => void;
-    onNodeAction: (nodeId: string, action: string) => void;
-    showTopologyView?: boolean;
-    showMapView?: boolean;
-    showListView?: boolean;
-    autoRefreshMs?: number;
-}
+export declare type NiceNavMenuAlign = 'start' | 'end' | 'auto';
 
-export declare interface NiceNetworkNode {
+export declare interface NiceNavMenuItem {
+    /** Stable id used for active-marking and keyboard focus. */
     id: string;
-    hostname?: string;
-    ipAddress: string;
-    macAddress?: string;
-    vendor?: string;
-    category: NetworkNodeCategory;
-    status: NetworkNodeStatus;
-    firstSeen: string;
+    /** Displayed label. */
+    label: default_2.ReactNode;
+    /** Optional icon (emoji, SVG node, NiceIcon). */
+    icon?: default_2.ReactNode;
+    /** Navigation href (rendered as `<a>` when no children). */
+    href?: string;
+    /** Anchor `target` attribute (only when `href` is set). */
+    target?: '_self' | '_blank' | '_parent' | '_top';
+    /** Anchor `rel` attribute (only when `href` is set). */
+    rel?: string;
+    /** Click handler (rendered as `<button>` when no `href`). */
+    onClick?: (e: default_2.MouseEvent) => void;
+    /** Disable the item. */
+    disabled?: boolean;
+    /** Render as a danger action (red text). */
+    danger?: boolean;
+    /** Render as a divider (label/icon ignored). */
+    divider?: boolean;
+    /** Optional badge node rendered to the right of the label. */
+    badge?: default_2.ReactNode;
+    /** Optional secondary text shown under the label inside dropdowns. */
+    description?: string;
+    /** Sub-items (only honored at level-1 to produce a level-2 flyout). */
+    children?: NiceNavMenuItem[];
+    /**
+     * **Mega menu** — when set on a top-level item, opens a FULL-WIDTH panel
+     * anchored to the bar's bottom edge instead of a floating dropdown. Use for
+     * marketing/SaaS navs where you want rich multi-column content.
+     *
+     * Either pass a ready `megaPanel` JSX node, or use the structured
+     * `megaColumns` shorthand which renders a clean column-based layout for you.
+     * Both can be set; `megaPanel` wins.
+     */
+    megaPanel?: default_2.ReactNode | (() => default_2.ReactNode);
+    /** Structured mega-menu data — rendered as columns of items. */
+    megaColumns?: NiceNavMenuMegaColumn[];
+    /** Optional footer node rendered at the bottom of the mega panel (CTA strip). */
+    megaFooter?: default_2.ReactNode;
+}
+
+/** A single column of items inside a mega-menu panel. */
+export declare interface NiceNavMenuMegaColumn {
+    /** Optional column heading. */
+    title?: default_2.ReactNode;
+    /** Items rendered in the column (no nested mega; each is a simple item). */
+    items: NiceNavMenuItem[];
+    /** Optional footer node under this column (e.g. "View all" link). */
+    footer?: default_2.ReactNode;
+}
+
+export declare interface NiceNavMenuProps {
+    /** Top-level items. */
+    items: NiceNavMenuItem[];
+    /** Currently active item id (matched against any nested item id). */
+    activeId?: string;
+    /** Size scale. Default `'md'`. */
+    size?: NiceNavMenuSize;
+    /** Dropdown panel alignment. Default `'start'`. */
+    align?: NiceNavMenuAlign;
+    /** Accessible label for the surrounding `<nav>`. */
+    ariaLabel?: string;
+    /** Render full-width (top-level items stretch to fill). Default `false`. */
+    stretch?: boolean;
+    /**
+     * How top-level dropdowns / mega-panels open. Default `'click'` for backward
+     * compatibility. Set to `'hover'` to get the classical desktop mega-menu
+     * pattern (Apple / Microsoft / Stripe) — opens on mouse-enter, closes after
+     * a short grace delay so the cursor can travel into the panel.
+     */
+    trigger?: 'click' | 'hover';
+    /** Hover-close grace delay in ms. Default 150. Only used when `trigger='hover'`. */
+    hoverCloseDelay?: number;
+    /** Pass-through className. */
+    className?: string;
+    /** Pass-through style. */
+    style?: default_2.CSSProperties;
+    /** Pass-through id. */
+    id?: string;
+    /** Test id. */
+    'data-testid'?: string;
+}
+
+export declare type NiceNavMenuSize = 'sm' | 'md' | 'lg';
+
+export declare const NiceNavShell: ForwardRefExoticComponent<NiceNavShellProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceNavShellApi {
+    activeRoute: string | undefined;
+    tabs: NiceNavShellTab[];
+    openRoute: (route: string, opts?: Partial<NiceNavShellTab>) => void;
+    closeTab: (id: string) => void;
+    closeOthers: (id: string) => void;
+    closeAll: () => void;
+    pinTab: (id: string, pinned?: boolean) => void;
+    setDirty: (id: string, dirty?: boolean) => void;
+}
+
+export declare type NiceNavShellPersistence = 'memory' | 'localStorage' | 'session';
+
+export declare interface NiceNavShellProps {
+    /** Top navigation slot — pass a ReactNode or render-prop. */
+    topNav?: Slot;
+    /**
+     * Convenience pass-through: when set (and `topNav` is not), the shell
+     * renders an internal `<NiceTopNav>` with these props. Lets consumers get
+     * a fully-featured top bar (logo / nav menu / search / pickers /
+     * notifications / user menu / collapsible right cluster) without having
+     * to import and instantiate NiceTopNav themselves.
+     */
+    topNavProps?: NiceTopNavProps;
+    /** Sidebar navigation slot. */
+    sidebar?: Slot;
+    /** Map of route → content (ReactNode or factory). */
+    routes: Record<string, ReactNode | (() => ReactNode)>;
+    /** Initial / default route (used when uncontrolled). */
+    defaultRoute?: string;
+    /** Controlled active route. */
+    activeRoute?: string;
+    /** Called whenever the active route changes. */
+    onRouteChange?: (route: string) => void;
+    /** Optional per-route labels (used for tab titles). */
+    routeLabels?: Record<string, ReactNode>;
+    /** Optional per-route icons. */
+    routeIcons?: Record<string, ReactNode>;
+    /** Fallback rendered when active route has no entry in `routes`. */
+    fallback?: ReactNode;
+    /**
+     * Rendered in the content area when no route is active (uncontrolled mode
+     * with no `defaultRoute`). Defaults to a blank panel painted with the
+     * theme background — intentionally empty so the shell never auto-jumps to
+     * the first route. Pass any node to customise (welcome screen, hero,
+     * shortcuts grid, etc.).
+     */
+    emptyState?: ReactNode;
+    /** `'enabled'` shows the tab strip; `'disabled'` (default) just routes content. */
+    tabsMode?: 'enabled' | 'disabled';
+    /** When `false` (default) navigating to an already-open route focuses it instead of duplicating. */
+    allowDuplicateTabs?: boolean;
+    /** Maximum number of tabs (oldest non-pinned auto-closes when exceeded). */
+    maxTabs?: number;
+    /** Show close X. Default `true`. */
+    closableTabs?: boolean;
+    /** Allow pin/unpin via context menu. Default `true`. */
+    pinnableTabs?: boolean;
+    /** Reorder via drag (shipped as basic HTML5 drag — opt-in). Default `false`. */
+    reorderableTabs?: boolean;
+    /** Persistence backend for tab list. Default `'memory'`. */
+    persistTabs?: NiceNavShellPersistence;
+    /** Storage key for persistence. Default `'nice-nav-shell:tabs'`. */
+    persistKey?: string;
+    /** Tab strip is wheel-scrollable + shows ◀▶ arrows on overflow. Default `true`. */
+    tabsScrollable?: boolean;
+    /** Right-click tab → menu (close / close others / close all / pin). Default `true`. */
+    tabsContextMenu?: boolean;
+    /** Content swap animation. Default `'fade'`. */
+    tabsAnimation?: NiceNavShellTabsAnimation;
+    /** Initial tab list (used only on first mount when storage is empty). */
+    initialTabs?: NiceNavShellTab[];
+    /** Routes auto-opened as pinned on first mount. */
+    pinnedRoutes?: string[];
+    className?: string;
+    contentClassName?: string;
+    'data-testid'?: string;
+}
+
+export declare interface NiceNavShellTab {
+    /** Unique stable id. Defaults to `route` if omitted at openRoute call. */
+    id: string;
+    /** Route key the tab represents. */
+    route: string;
+    /** Tab label (string or arbitrary node). */
+    label: ReactNode;
+    /** Optional leading icon. */
+    icon?: ReactNode;
+    /** Pinned tabs render first and have no close button by default. */
+    pinned?: boolean;
+    /** When true, shows a `•` dot indicating unsaved work. */
+    dirty?: boolean;
+    /** Per-tab override of `closableTabs`. */
+    closable?: boolean;
+}
+
+export declare type NiceNavShellTabsAnimation = 'none' | 'fade' | 'slide';
+
+export declare const NiceNetworkDiscoveryPanel: default_2.FC<NiceNetworkDiscoveryPanelProps>;
+
+export declare interface NiceNetworkDiscoveryPanelProps extends NiceBaseProps {
+    nodes: NiceNetworkNode[];
+    topology?: NiceTopologyData;
+    onScan: (subnet?: string) => Promise<void>;
+    onNodeClick: (nodeId: string) => void;
+    onNodeAction: (nodeId: string, action: string) => void;
+    showTopologyView?: boolean;
+    showMapView?: boolean;
+    showListView?: boolean;
+    autoRefreshMs?: number;
+}
+
+export declare interface NiceNetworkNode {
+    id: string;
+    hostname?: string;
+    ipAddress: string;
+    macAddress?: string;
+    vendor?: string;
+    category: NetworkNodeCategory;
+    status: NetworkNodeStatus;
+    firstSeen: string;
     lastSeen: string;
     isApproved: boolean;
     isRogue: boolean;
@@ -14168,6 +14861,24 @@ export declare interface NiceNotificationChannel {
     configUrl?: string;
 }
 
+export declare interface NiceNotificationItem {
+    id: string;
+    title: string;
+    body?: string;
+    /** Visual level (controls color of marker dot). Default `'info'`. */
+    level?: NiceNotificationLevel;
+    /** Optional ISO date string or Date instance. */
+    timestamp?: string | Date;
+    /** Whether this notification has already been seen. */
+    read?: boolean;
+    /** Optional icon/avatar node. */
+    icon?: default_2.ReactNode;
+    /** Click handler — fires when the row is activated. */
+    onClick?: () => void;
+}
+
+export declare type NiceNotificationLevel = 'info' | 'success' | 'warning' | 'error';
+
 export declare const NiceNotificationPreferences: default_2.FC<NiceNotificationPreferencesProps>;
 
 export declare interface NiceNotificationPreferencesProps extends NiceBaseProps {
@@ -14200,6 +14911,49 @@ export declare interface NiceNotificationPrefs {
     };
 }
 
+export declare const NiceNotifications: default_2.ForwardRefExoticComponent<NiceNotificationsProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceNotificationsProps {
+    /** List of notifications. */
+    items?: NiceNotificationItem[];
+    /**
+     * Optional explicit unread count. When omitted, it is computed from
+     * `items.filter(i => !i.read).length`.
+     */
+    unreadCount?: number;
+    /** Title rendered at the top of the dropdown panel. */
+    panelTitle?: string;
+    /** Empty-state text. */
+    emptyText?: string;
+    /** Width (px) of the dropdown panel. Default: 340. */
+    panelWidth?: number;
+    /** Maximum dropdown height (px). Default: 420. */
+    maxHeight?: number;
+    /** Show "Mark all as read" link in panel header. Default: true. */
+    showMarkAllRead?: boolean;
+    /** Show "View all" link at panel footer. Default: false. */
+    showViewAll?: boolean;
+    /** Mark-all-as-read handler. */
+    onMarkAllRead?: () => void;
+    /** View-all handler. */
+    onViewAll?: () => void;
+    /** Per-item read-toggle handler (called when user marks an item read). */
+    onItemRead?: (id: string) => void;
+    /** Custom bell icon. */
+    icon?: default_2.ReactNode;
+    /** Controlled open flag. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Cap the badge display (default 99 → shows "99+"). */
+    badgeMax?: number;
+    /** Size variant of the trigger. */
+    size?: 'sm' | 'md' | 'lg';
+    className?: string;
+    style?: default_2.CSSProperties;
+    id?: string;
+    'data-testid'?: string;
+}
+
 export declare const NiceNumberInput: default_2.ForwardRefExoticComponent<NiceNumberInputProps & default_2.RefAttributes<HTMLInputElement>>;
 
 /** Props for the {@link NiceNumberInput} component — a numeric field with stepper and precision control. */
@@ -14296,6 +15050,12 @@ export declare interface NiceOnboardingWizardProps extends NiceBaseProps {
     logo?: React.ReactNode;
 }
 
+export { NiceOnChange }
+
+export { NiceOnOpenChange }
+
+export { NiceOnSelect }
+
 export { NiceOptimisticConfig }
 
 export { NiceOption }
@@ -14679,10 +15439,26 @@ export declare interface NicePickListProps<T = unknown> extends NiceBaseProps {
     keyField?: string;
     /** Label extractor */
     labelField?: string;
-    /** Custom item renderer */
-    renderItem?: (item: T) => default_2.ReactNode;
-    /** Enable filtering/search */
+    /** Custom item renderer (receives item + side hint). */
+    renderItem?: (item: T, side?: 'left' | 'right') => default_2.ReactNode;
+    /** Enable filtering/search (legacy, equivalent to `searchable: 'both'`). */
     filterable?: boolean;
+    /**
+     * Enable a search input on either or both columns.
+     * `true` is equivalent to `'both'`. Default: `false`.
+     */
+    searchable?: boolean | 'left' | 'right' | 'both';
+    /** Optional grouping function. When provided, items are grouped under non-interactive headers. */
+    groupBy?: (item: T) => string;
+    /** Allow drag-and-drop reordering inside the right column. */
+    sortable?: boolean;
+    /** Show “move all” shortcut buttons (default: true). */
+    bulkActions?: boolean | {
+        moveAll?: boolean;
+        removeAll?: boolean;
+    };
+    /** Maximum number of items allowed on the right side. Extra moves are blocked. */
+    maxRight?: number;
     /** Source list header */
     sourceHeader?: default_2.ReactNode;
     /** Target list header */
@@ -15614,6 +16390,165 @@ export declare interface NiceRealtimeChartRef {
     getData: () => RealtimeDataPoint[];
 }
 
+/**
+ * Recipe display component — shows photos, metadata (servings/time/difficulty),
+ * ingredient list and step-by-step instructions. Read-mostly; pair with
+ * {@link NiceRecipeEditor} (from `@nice2dev/ui-tools`) for editing.
+ */
+export declare const NiceRecipe: default_2.FC<NiceRecipeProps>;
+
+/** A named group of recipe ids. */
+export declare interface NiceRecipeCollection {
+    id: string;
+    name: string;
+    description?: string;
+    recipeIds: string[];
+}
+
+/**
+ * Sidebar of named collections (cookbooks, weekly menus, themes…) plus a
+ * `NiceRecipeList` filtered to the active collection's recipe ids.
+ * Includes inline create / rename / delete and an "Add recipe" picker.
+ */
+export declare const NiceRecipeCollections: default_2.FC<NiceRecipeCollectionsProps>;
+
+export declare interface NiceRecipeCollectionsProps extends NiceBaseProps {
+    /** Pool of recipes the collections reference. */
+    recipes: NiceRecipeModel[];
+    /** Collections to display. */
+    collections: NiceRecipeCollection[];
+    /** Fired when collections change (rename, add, remove, add/remove recipe). */
+    onChange?: (collections: NiceRecipeCollection[]) => void;
+    /** Hide create / rename / delete controls. */
+    readOnly?: boolean;
+    /** Fired when a recipe card inside the active collection is clicked. */
+    onSelectRecipe?: (recipe: NiceRecipeModel) => void;
+}
+
+/** Difficulty enum used by recipe + scheduler-recipe variant. */
+export declare type NiceRecipeDifficulty = 'easy' | 'medium' | 'hard';
+
+/**
+ * Recipe editor — full CRUD over a {@link NiceRecipe}: metadata,
+ * ingredients (add/remove/reorder), steps (add/remove/reorder), photos
+ * (URL-based). Pair with {@link NiceRecipe} (from `@nice2dev/ui-planning`)
+ * for read-only display.
+ */
+export declare const NiceRecipeEditor: default_2.FC<NiceRecipeEditorProps>;
+
+export declare interface NiceRecipeEditorProps extends NiceBaseProps {
+    /** Recipe to edit. Pass `undefined` for "new". */
+    recipe?: NiceRecipeModel;
+    /** Called on every change (live binding). */
+    onChange?: (recipe: NiceRecipeModel) => void;
+    /** Called when the user clicks Save (`showActions`). */
+    onSave?: (recipe: NiceRecipeModel) => void;
+    /** Called when the user clicks Cancel. */
+    onCancel?: () => void;
+    /** Render Save/Cancel buttons. */
+    showActions?: boolean;
+    /** Custom Save button label. */
+    saveLabel?: string;
+    /** Custom Cancel button label. */
+    cancelLabel?: string;
+}
+
+/**
+ * Browsable, searchable, filterable grid of {@link NiceRecipe} cards.
+ * Pure-client filtering: title/description/tags substring + difficulty + tag.
+ */
+export declare const NiceRecipeList: default_2.FC<NiceRecipeListProps>;
+
+export declare interface NiceRecipeListProps extends NiceBaseProps {
+    /** Recipes to browse. */
+    recipes: NiceRecipeModel[];
+    /** Fired when the user activates a card. */
+    onSelect?: (recipe: NiceRecipeModel) => void;
+    /** Initial search query. */
+    initialQuery?: string;
+    /** Hide the difficulty / tag filters. */
+    hideFilters?: boolean;
+    /** Empty-state hint when no recipes match. */
+    emptyMessage?: string;
+}
+
+/** A full recipe record. */
+export declare interface NiceRecipeModel {
+    id: string;
+    title: string;
+    description?: string;
+    /** Number of servings the recipe yields. */
+    servings?: number;
+    prepMinutes?: number;
+    cookMinutes?: number;
+    difficulty?: NiceRecipeDifficulty;
+    cuisine?: string;
+    tags?: string[];
+    ingredients: NiceIngredient[];
+    steps: NiceRecipeStep[];
+    photos?: NiceRecipePhoto[];
+    nutrition?: NiceRecipeNutrition;
+    /** External source (URL or attribution). */
+    sourceUrl?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+
+/** Optional nutrition summary per serving. */
+export declare interface NiceRecipeNutrition {
+    calories?: number;
+    protein?: number;
+    fat?: number;
+    carbs?: number;
+    fiber?: number;
+    sugar?: number;
+    sodium?: number;
+}
+
+/** A photo attached to a recipe. */
+export declare interface NiceRecipePhoto {
+    id: string;
+    /** Image URL (data:, blob:, http(s):). */
+    url: string;
+    /** Alt text / caption. */
+    caption?: string;
+    /** When true, this photo is used as the cover image. */
+    primary?: boolean;
+}
+
+/** Props for {@link NiceRecipe}. */
+export declare interface NiceRecipeProps extends NiceBaseProps {
+    /** Recipe to display. */
+    recipe: NiceRecipeModel;
+    /** Compact card layout (smaller paddings, hides description / nutrition). */
+    compact?: boolean;
+    /** Hide the photo gallery. */
+    hidePhotos?: boolean;
+    /** Hide the ingredients column. */
+    hideIngredients?: boolean;
+    /** Hide the steps list. */
+    hideSteps?: boolean;
+    /** Toggle an ingredient's `checked` state (interactive shopping mode). */
+    onIngredientToggle?: (ingredient: NiceIngredient) => void;
+    /** Toggle a step's `done` state (interactive cook mode). */
+    onStepToggle?: (step: NiceRecipeStep) => void;
+}
+
+/** A single step / instruction in a recipe. */
+export declare interface NiceRecipeStep {
+    id: string;
+    /** Render order (1-based). */
+    order: number;
+    /** Human instruction text. Markdown-friendly but rendered as plain text by default. */
+    instruction: string;
+    /** Optional duration in minutes for timers. */
+    durationMinutes?: number;
+    /** Optional URL of an image illustrating the step. */
+    image?: string;
+    /** Marks the step as completed in interactive cook mode. */
+    done?: boolean;
+}
+
 /**
  * NiceReconciliationView — Bank reconciliation split-view with drag-drop matching.
  *
@@ -16186,6 +17121,40 @@ export declare interface NiceSchedulerEvent {
     description?: string;
     /** Event visual style */
     eventStyle?: 'solid' | 'striped' | 'outlined' | 'dashed';
+    /**
+     * Discriminator selecting which form variant to use in the built-in editor.
+     * Defaults to `'task'`. Use `'recipe'` to attach a {@link NiceRecipe} via
+     * `recipe`, or `'service'` to attach service data via `service`.
+     */
+    eventType?: NiceSchedulerEventType;
+    /** Recipe payload — present when `eventType === 'recipe'`. */
+    recipe?: NiceRecipeModel;
+    /** Service payload — present when `eventType === 'service'`. */
+    service?: NiceSchedulerServiceData;
+}
+
+/**
+ * Discriminator for the kind of thing scheduled. Built-ins:
+ *   - `'task'`  — generic event (default, back-compat).
+ *   - `'recipe'` — meal-prep / cooking session backed by a {@link NiceRecipe}.
+ *   - `'service'` — a service appointment (provider, customer, location, price).
+ *
+ * Consumers can extend with custom string literals — the scheduler will treat
+ * unknown types like `'task'` unless a matching {@link NiceSchedulerEventTypeDef}
+ * is provided in `eventTypes`.
+ */
+export declare type NiceSchedulerEventType = 'task' | 'recipe' | 'service' | (string & {});
+
+/** Definition of a custom event-type option exposed in the editor's type picker. */
+export declare interface NiceSchedulerEventTypeDef {
+    /** Discriminator value matching {@link NiceSchedulerEvent.eventType}. */
+    type: NiceSchedulerEventType;
+    /** Display label in the editor select. */
+    label: string;
+    /** Optional emoji/icon glyph. */
+    icon?: string;
+    /** Optional accent color for the chip in the calendar grid. */
+    color?: string;
 }
 
 /** Props for the {@link NiceScheduler} component — a full-featured calendar / scheduler with drag, recurring events, resources, and inline editing. */
@@ -16233,6 +17202,19 @@ export declare interface NiceSchedulerProps extends NiceBaseProps {
     editable?: boolean;
     /** Custom field set for the built-in editor — when provided, replaces the auto-generated default fields. NiceForm-compatible. */
     formFields?: NiceFormItem[];
+    /**
+     * Per-event-type form field overrides. When a key matches the active
+     * `eventType` in the editor, those NiceForm items REPLACE the type-specific
+     * section (recipe/service body). Use `'task'` to override the default form.
+     */
+    formFieldsByType?: Partial<Record<NiceSchedulerEventType, NiceFormItem[]>>;
+    /**
+     * Available event-type options in the editor's type picker. When omitted,
+     * defaults to a single `'task'` entry (back-compat — no picker shown).
+     * Pass `[{type:'task'},{type:'recipe'},{type:'service'}]` to enable all three
+     * built-ins.
+     */
+    eventTypes?: NiceSchedulerEventTypeDef[];
     /** Custom full editor render — when provided, takes over the entire editor body. */
     renderEventEditor?: (ctx: {
         event?: NiceSchedulerEvent | null;
@@ -16263,6 +17245,26 @@ export declare interface NiceSchedulerResource {
     color?: string;
 }
 
+/** Service-specific data attached to a `service` event. */
+export declare interface NiceSchedulerServiceData {
+    /** Service name (e.g. "Haircut", "Oil change"). */
+    serviceName: string;
+    /** Person providing the service. */
+    providerName?: string;
+    /** Customer name. */
+    customerName?: string;
+    /** Customer phone / email. */
+    customerContact?: string;
+    /** Location / address. */
+    location?: string;
+    /** Price (numeric). */
+    price?: number;
+    /** Currency code (ISO 4217), defaults to display-only "PLN". */
+    currency?: string;
+    /** Free-form notes. */
+    notes?: string;
+}
+
 /** Available calendar views for the {@link NiceScheduler}. */
 export declare type NiceSchedulerView = 'day' | 'week' | 'workWeek' | 'month' | 'dayRange' | 'monthRange' | 'agenda' | 'timeline';
 
@@ -16284,6 +17286,77 @@ export declare interface NiceScrollViewProps extends NiceBaseProps {
     children?: default_2.ReactNode;
 }
 
+export declare const NiceSearchBar: default_2.ForwardRefExoticComponent<NiceSearchBarProps & default_2.RefAttributes<NiceSearchBarHandle>>;
+
+export declare type NiceSearchBarExpandDirection = 'left' | 'right' | 'down';
+
+export declare interface NiceSearchBarHandle {
+    focus: () => void;
+    expand: () => void;
+    collapse: () => void;
+    clear: () => void;
+}
+
+export declare interface NiceSearchBarProps {
+    /** Controlled value. */
+    value?: string;
+    /** Default value (uncontrolled). */
+    defaultValue?: string;
+    /** Change handler. */
+    onChange?: (value: string) => void;
+    /** Submit handler — fires on Enter. */
+    onSubmit?: (value: string) => void;
+    /** Clear handler — fires when ✕ is clicked or Escape pressed with non-empty value. */
+    onClear?: () => void;
+    /** Placeholder text (defaults to translated "Search…"). */
+    placeholder?: string;
+    /**
+     * If true, the bar starts already expanded and stays so unless `collapsible`
+     * is also true. Default: `false`.
+     */
+    defaultExpanded?: boolean;
+    /**
+     * Controlled expanded flag. When provided, takes priority over the
+     * internal state.
+     */
+    expanded?: boolean;
+    /** Notified whenever the expanded state changes. */
+    onExpandedChange?: (expanded: boolean) => void;
+    /**
+     * Allow the bar to collapse. Default: `true` when no `expanded` is given.
+     * Set to `false` to render an always-expanded plain search input.
+     */
+    collapsible?: boolean;
+    /**
+     * Direction the input grows when expanding from the icon-button.
+     * Default: `'left'` (suitable for top-nav right cluster).
+     */
+    expandDirection?: NiceSearchBarExpandDirection;
+    /**
+     * Maximum width of the expanded input (px). Default: `260`.
+     * On narrow screens caps automatically at `100vw - 32px`.
+     */
+    expandWidth?: number;
+    /**
+     * Auto-collapse when the input loses focus AND is empty. Default: `true`.
+     */
+    autoCollapseOnBlur?: boolean;
+    /** Size variant. */
+    size?: NiceSearchBarSize;
+    /** Custom search icon. Default: 🔍 (will use NiceIcon when wired by host). */
+    icon?: default_2.ReactNode;
+    /** Disable the control. */
+    disabled?: boolean;
+    /** Accessible label. */
+    ariaLabel?: string;
+    className?: string;
+    style?: default_2.CSSProperties;
+    id?: string;
+    'data-testid'?: string;
+}
+
+export declare type NiceSearchBarSize = 'sm' | 'md' | 'lg';
+
 /**
  * `NiceSegmentedControl` — single-selection toggle group with an animated
  * sliding "thumb" highlight, iOS-style. The control owns a single value
@@ -16540,10 +17613,36 @@ export declare interface NiceSidebarNavProps {
     onPreferencesChange?: (prefs: SidebarNavUserPrefs) => void;
     /** Sidebar width in px (default: 264) */
     width?: number;
+    /** Sidebar width in px when collapsed/icon-only (default: 56). */
+    collapsedWidth?: number;
+    /**
+     * Which side of the screen the sidebar is anchored to. Default `'left'`.
+     * `'right'` flips the chevron direction and pushes the footer-toggle to the
+     * left edge — useful for RTL or right-side admin shells.
+     */
+    position?: 'left' | 'right';
+    /**
+     * **Minimal mode** — hides the mode strip, sources, favorites and footer
+     * preferences, leaving only the navigation tree. Use for stripped-down
+     * shells (auth flows, embedded views) where the full taxonomy is overkill.
+     * Default `false`.
+     */
+    minimal?: boolean;
+    /** Optional header slot rendered above the mode strip / tree (e.g. workspace switcher). */
+    header?: ReactNode;
+    /** Optional footer slot rendered below the standard footer-toggle row. */
+    footerExtra?: ReactNode;
     /** Collapsed (icon-only) mode */
     collapsed?: boolean;
     /** Called when collapsed state changes (for toggle button) */
     onCollapsedChange?: (collapsed: boolean) => void;
+    /**
+     * When `true` (default), users can still expand/collapse module branches
+     * even while the sidebar itself is in icon-only collapsed mode (chevrons
+     * stay visible). When `false`, all branches are forced flat / always-open
+     * in collapsed mode (legacy behaviour).
+     */
+    expandableWhenCollapsed?: boolean;
     /** Extra CSS class on the root element */
     className?: string;
     /** Size variant */
@@ -16759,7 +17858,7 @@ export declare interface NiceSliderProps extends Omit<NiceFormFieldProps, 'label
     showTickLabels?: boolean;
 }
 
-export declare function NiceSortable<T extends Record<string, unknown>>({ items, keyField, onReorder, renderItem, direction, handle, group, disabled, className, style, }: NiceSortableProps<T>): JSX_2.Element;
+export declare function NiceSortable<T extends Record<string, unknown>>({ items, keyField, onReorder, renderItem, direction, handle, group: _group, disabled, className, style, }: NiceSortableProps<T>): JSX_2.Element;
 
 export declare namespace NiceSortable {
     var displayName: string;
@@ -17019,6 +18118,10 @@ export { NiceSSEMessageType }
 
 export { niceStaggerDelay }
 
+export { NiceStandardFieldProps }
+
+export { NiceStandardProps }
+
 /** A menu entry in the {@link NiceDesktop} start menu. */
 export declare interface NiceStartMenuItem {
     /** Unique key. */
@@ -17187,7 +18290,7 @@ export declare interface NiceStoryMeta {
     parameters?: Record<string, unknown>;
 }
 
-export declare function NiceStreamDashboard({ platforms: initialPlatforms, scenes: initialScenes, config: initialConfig, enableWebRTC, rtmpServerUrl, maxChatMessages, autoRecord, recordingPath, onStreamStart, onStreamStop, onChatMessage, onAlert, onAnalyticsUpdate, onVODCreated, renderPreview, renderChatMessage, className, style, children, ...baseProps }: NiceStreamDashboardProps): JSX_2.Element;
+export declare function NiceStreamDashboard({ platforms: initialPlatforms, scenes: initialScenes, config: initialConfig, enableWebRTC: _enableWebRTC, rtmpServerUrl: _rtmpServerUrl, maxChatMessages: _maxChatMessages, autoRecord, recordingPath: _recordingPath, onStreamStart, onStreamStop, onChatMessage: _onChatMessage, onAlert, onAnalyticsUpdate: _onAnalyticsUpdate, onVODCreated, renderPreview, renderChatMessage, className, style, children, ...baseProps }: NiceStreamDashboardProps): JSX_2.Element;
 
 export declare interface NiceStreamDashboardProps extends NiceBaseProps {
     /** Initial platform connections */
@@ -17734,6 +18837,29 @@ export { niceThemeDark }
 
 export { NiceThemeDarkMode }
 
+/**
+ * Descriptor of a single theme available in the switcher. The `preview`
+ * colours are used to render the mini page-thumbnail in the trigger and
+ * dropdown options.
+ */
+export declare interface NiceThemeDescriptor {
+    /** Stable theme id, e.g. `'omniverk-light'`, `'cyberpunk-neon'`. */
+    id: string;
+    /** Display name (English / fallback), e.g. `'Omniverk Light'`. */
+    name: string;
+    /** Native or translated name (optional). When present, takes precedence over `name`. */
+    nativeName?: string;
+    /** Colour swatches used to draw the preview thumbnail. */
+    preview: ThemePreviewColors;
+    /**
+     * Whether the theme is built-in / read-only. Edit affordances are hidden
+     * for read-only themes unless `edit.allowEditBuiltIn === true`.
+     */
+    readOnly?: boolean;
+    /** Free-form metadata (author, tags, etc.). Not interpreted by the picker. */
+    meta?: Record<string, unknown>;
+}
+
 export declare const NiceThemeDesigner: ForwardRefExoticComponent<NiceThemeBuilderProps & RefAttributes<HTMLDivElement>>;
 
 export declare type NiceThemeDesignerProps = NiceThemeBuilderProps;
@@ -17754,6 +18880,107 @@ export { NiceThemePackId }
 
 export { NiceThemePackMeta }
 
+export declare const NiceThemePicker: default_2.FC<NiceThemePickerProps>;
+
+/**
+ * Configuration for the optional add/edit-theme affordances. When `enabled`
+ * is true the dropdown gains:
+ *  - a sticky `[+] Add theme` button at the bottom,
+ *  - a pencil icon next to each editable theme option.
+ *
+ * Both actions navigate to a configured editor route and pass back a
+ * `returnUrl` so the editor can return the user to where they came from.
+ */
+export declare interface NiceThemePickerEditConfig {
+    enabled: boolean;
+    /** Base editor route, e.g. `'/settings/themes'`. */
+    editorRoute: string;
+    /**
+     * Builds the full URL to navigate to. Defaults to a query-string scheme:
+     *   edit:  `${editorRoute}?themeId=${id}&returnUrl=${encoded}`
+     *   add:   `${editorRoute}/new?returnUrl=${encoded}`
+     */
+    buildUrl?: (params: {
+        themeId?: string;
+        returnUrl: string;
+    }) => string;
+    /**
+     * Performs the navigation. Defaults to `window.location.href = url`.
+     * Consumers using React Router / Next.js can pass `router.push` etc.
+     */
+    navigate?: (url: string) => void;
+    /** Override for the return URL. Default: `window.location.href`. */
+    returnUrl?: string;
+    /** Label for the add button. Default i18n key: `themePicker.addTheme`. */
+    addLabel?: string;
+    /** ARIA label for the per-row pencil icon. Default i18n key: `themePicker.editTheme`. */
+    editLabel?: string;
+    /** Allow the pencil icon to appear on read-only / built-in themes. Default: false. */
+    allowEditBuiltIn?: boolean;
+    /**
+     * "Add new theme" button rendered at the TOP of the dropdown.
+     * When omitted the add button falls back to the legacy bottom position
+     * (driven by `enabled`) for backward compatibility.
+     */
+    addNew?: {
+        /** Whether to show the add-new button. Default: false. */
+        enabled?: boolean;
+        /** Button label. Overrides `addLabel`. */
+        label?: string;
+    };
+}
+
+export declare interface NiceThemePickerProps extends NiceFormFieldProps, DualVisibilityProps {
+    /** Selected theme id */
+    value?: string;
+    /** Default theme id (uncontrolled) */
+    defaultValue?: string;
+    /** Callback when selection changes */
+    onChange?: (theme: NiceThemeDescriptor | null) => void;
+    /** Available themes (required — picker is dumb on its own). */
+    themes: NiceThemeDescriptor[];
+    /** Placeholder shown when nothing is selected (ignored in compact mode). */
+    placeholder?: string;
+    /** Enable search */
+    showSearch?: boolean;
+    /** Search placeholder */
+    searchPlaceholder?: string;
+    /** Show preview thumbnail in trigger. Default: true */
+    showPreviewInValue?: boolean;
+    /** Show preview thumbnail in dropdown options. Default: true */
+    showPreviewInMenu?: boolean;
+    /** Show theme id in trigger. Default: false */
+    showIdInValue?: boolean;
+    /** Show theme id in dropdown options. Default: false */
+    showIdInMenu?: boolean;
+    /**
+     * Compact mode: minimal trigger width (preview + chevron only) with smart
+     * dropdown alignment. Default: false.
+     */
+    compact?: boolean;
+    /** Dropdown horizontal alignment. Default: `'auto'` in compact, `'left'` otherwise. */
+    dropdownAlign?: DropdownAlign;
+    /**
+     * Preview thumbnail size (px) — width. Height is derived (~75% of width).
+     * Defaults: 24 in compact, 32 in full mode.
+     */
+    previewSize?: number;
+    /**
+     * Preview rendering style:
+     *  - `'page'` (default): a small "page" thumbnail with header/text/sidebar.
+     *  - `'swatch'`: a flag-like vertical colour stripe (cheaper, less informative).
+     */
+    previewShape?: 'page' | 'swatch';
+    /** Add/edit affordances. Hidden when `enabled` is false (default). */
+    edit?: NiceThemePickerEditConfig;
+    /** Allow clearing selection. Default: false (a theme is usually mandatory). */
+    allowClear?: boolean;
+    /** Size variant */
+    size?: NiceSize;
+    /** Test ID */
+    'data-testid'?: string;
+}
+
 export declare const NiceThemePreview: default_2.ForwardRefExoticComponent<NiceThemePreviewProps & default_2.RefAttributes<HTMLDivElement>>;
 
 export declare interface NiceThemePreviewProps extends NiceBaseProps {
@@ -17794,7 +19021,7 @@ export { NiceThemeSpacing }
  * <NiceThemeSwitcher themes={myThemes} storageMode="traceless" />
  * ```
  */
-export declare function NiceThemeSwitcher({ variant, themes, size, showLabels, onThemeChange, defaultTheme, showSystemOption, className, style, disabled, label, hideLabel, cookies, localStorage, sessionStorage, storageMode, storageKey, }: NiceThemeSwitcherProps): default_2.ReactElement;
+export declare function NiceThemeSwitcher({ variant, themes, size, showLabels, onThemeChange, defaultTheme, showSystemOption, className, style, disabled, label, hideLabel, cookies: _cookies, localStorage: _localStorage, sessionStorage, storageMode: _storageMode, storageKey, }: NiceThemeSwitcherProps): default_2.ReactElement;
 
 /**
  * Props for NiceThemeSwitcher.
@@ -18018,6 +19245,8 @@ export declare interface NiceToggleProps extends NiceBaseProps {
     controlWidth?: string | number;
 }
 
+export { NiceTone }
+
 export declare const NiceToolbar: default_2.FC<NiceToolbarProps>;
 
 /** A toolbar entry in the {@link NiceToolbar}. */
@@ -18064,6 +19293,245 @@ export declare interface NiceTooltipProps {
     children: default_2.ReactElement;
 }
 
+export declare const NiceTopNav: default_2.ForwardRefExoticComponent<NiceTopNavProps & default_2.RefAttributes<HTMLElement>>;
+
+export declare type NiceTopNavDensity = 'compact' | 'normal' | 'comfortable';
+
+/**
+ * Optional extra round icon-button shown in the right cluster
+ * (e.g. settings gear). When `menuItems` is provided, clicking the
+ * button opens a small dropdown menu; otherwise `onClick` fires.
+ *
+ * Added in v1.0.10 to satisfy customizable user-button cluster
+ * feedback for {@link NiceTopNav}.
+ */
+declare interface NiceTopNavExtraAction {
+    id: string;
+    label: string;
+    icon: default_2.ReactNode;
+    onClick?: () => void;
+    menuItems?: UserMenuItem[];
+    /** Optional badge / dot. */
+    badge?: number | string;
+}
+
+/** @deprecated v2 nav-item type. Prefer {@link NiceNavMenuItem} via `navMenuItems`. */
+export declare interface NiceTopNavItem {
+    id: string;
+    label: string;
+    icon?: default_2.ReactNode;
+    href?: string;
+    onClick?: () => void;
+}
+
+/** @deprecated v2 language type. Prefer `<NiceLanguagePicker>` props. */
+export declare interface NiceTopNavLanguageOption {
+    code: string;
+    label: string;
+    flag?: default_2.ReactNode;
+}
+
+/** @deprecated v2 user-menu item. Prefer {@link UserMenuItem}. */
+export declare interface NiceTopNavMenuItem {
+    id: string;
+    label: string;
+    icon?: default_2.ReactNode;
+    onClick?: () => void;
+    divider?: boolean;
+    href?: string;
+}
+
+export declare interface NiceTopNavProps {
+    height?: number | string;
+    density?: NiceTopNavDensity;
+    maxWidth?: number | string;
+    paddingX?: number | string;
+    gap?: number | string;
+    borderBottom?: boolean;
+    elevated?: boolean;
+    sticky?: boolean;
+    variant?: NiceTopNavVariant;
+    accentBar?: boolean;
+    accentBarColor?: string;
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /**
+     * Visual state — mirrors the standard control state contract used across
+     * basic Nice2Dev controls (input, button). Defaults to `'normal'`.
+     * - `loading`  — renders a subtle shimmer overlay; bar remains interactive.
+     * - `error`    — accents the bottom border with `--color-danger`.
+     * - `disabled` — dims the bar and disables pointer events.
+     */
+    state?: 'normal' | 'loading' | 'error' | 'disabled';
+    /**
+     * Compact mode — collapses brand name, hides labels on icon-only actions,
+     * tightens paddings. Combine with `size='sm'` for an ultra-dense bar.
+     */
+    compact?: boolean;
+    collapsible?: boolean;
+    collapsed?: boolean;
+    onCollapsedChange?: (collapsed: boolean) => void;
+    /**
+     * Bar height when collapsed. Defaults to `32` so the entire bar content
+     * (brand, nav menu, search, pickers, notifications, user menu) stays
+     * visible — proportionally scaled down via {@link collapsedContentScale}.
+     * Lower values produce an almost-hidden strip; raise for more breathing
+     * room around shrunk controls.
+     */
+    collapsedHeight?: number | string;
+    /**
+     * Scale factor (0–1) applied to the logo / brand name while collapsed.
+     * Default `0.5`. Affects only the brand block; use
+     * {@link collapsedContentScale} to scale the rest of the bar.
+     */
+    collapsedLogoScale?: number;
+    /**
+     * Scale factor (0–1) applied to the whole inner row (nav menu, search,
+     * pickers, notifications, user menu, collapse button) while collapsed.
+     * The bar shows ALL of its content — just very small — so users keep
+     * full functionality on a slim strip. Default `0.55`.
+     */
+    collapsedContentScale?: number;
+    hideOnScroll?: boolean;
+    scrollThreshold?: number;
+    logo?: default_2.ReactNode;
+    brandName?: string;
+    brandHref?: string;
+    onBrandClick?: () => void;
+    logoVariant?: NiceLogoVariant;
+    logoSize?: NiceLogoSize;
+    /**
+     * Brand block alignment within the bar. Combined with {@link navAlignment}
+     * gives 9 possible layouts. Default `'left'`.
+     *
+     * - `'left'`   — brand sits at the very start of the bar (classic).
+     * - `'center'` — brand is centered (use with `navAlignment='start'` for
+     *                a Bootstrap-style centered logo).
+     * - `'right'`  — brand sits at the end (rare, useful for RTL or unusual layouts).
+     */
+    brandAlign?: 'left' | 'center' | 'right';
+    /**
+     * Pre-baked configuration profile. Sets sensible defaults for several props
+     * at once so a one-line `<NiceTopNav preset="marketing" />` ships a polished
+     * bar. Any explicit prop overrides the preset's default.
+     *
+     * - `'marketing'` — landing-page bar: brand left, nav center, login/register
+     *                   right, no search, no pickers, accent bar on, sticky.
+     * - `'saas'`      — admin/SaaS bar: brand left, nav left, full toolbar
+     *                   (search + lang + theme + notifications + user menu),
+     *                   collapsible right cluster opens by default, settings
+     *                   gear after the avatar.
+     * - `'docs'`      — documentation bar: brand left, nav left, prominent
+     *                   always-expanded search (max 500px), theme picker only.
+     * - `'minimal'`   — bare brand bar: brand only, no nav, no right cluster.
+     */
+    preset?: 'marketing' | 'saas' | 'docs' | 'minimal';
+    navItems?: NiceTopNavItem[];
+    navMenuItems?: NiceNavMenuItem[];
+    activeNavId?: string;
+    navAlignment?: 'start' | 'center' | 'end';
+    /**
+     * How mega-menu items in `navMenuItems` open. Default `'hover'` (classical
+     * desktop pattern). Switch to `'click'` for touch-first sites. Only applies
+     * when at least one nav item carries `megaPanel` or `megaColumns`.
+     */
+    megaTrigger?: 'hover' | 'click';
+    mobileBreakpoint?: number;
+    /**
+     * How navigation behaves below `mobileBreakpoint`:
+     * - `hamburger` (default) — collapse to hamburger button + drawer.
+     * - `wrap`               — let nav items wrap onto a second row.
+     * - `scroll`             — keep nav inline; horizontally scroll-snap overflowed items.
+     */
+    mobileVariant?: 'hamburger' | 'wrap' | 'scroll';
+    searchPlaceholder?: string;
+    searchValue?: string;
+    onSearchChange?: (value: string) => void;
+    onSearchSubmit?: (value: string) => void;
+    collapsibleSearch?: boolean;
+    searchCollapsible?: boolean;
+    searchExpandDirection?: NiceSearchBarExpandDirection;
+    searchExpandWidth?: number;
+    searchBarProps?: Partial<NiceSearchBarProps>;
+    centerContent?: default_2.ReactNode;
+    /** Toggle search visibility independently of search props presence. Default: derived from search props. */
+    showSearch?: boolean;
+    languages?: NiceTopNavLanguageOption[];
+    currentLanguage?: string;
+    onLanguageChange?: (code: string) => void;
+    showLanguagePicker?: boolean;
+    languagePickerProps?: Partial<NiceLanguagePickerProps>;
+    themes?: NiceTopNavThemeOption[];
+    currentTheme?: string;
+    onThemeChange?: (id: string) => void;
+    showThemePicker?: boolean;
+    themePickerProps?: Partial<NiceThemePickerProps>;
+    notificationsCount?: number;
+    onNotificationsClick?: () => void;
+    notifications?: NiceNotificationItem[];
+    onMarkAllNotificationsRead?: () => void;
+    /** Toggle notifications visibility independently of notification props presence. */
+    showNotifications?: boolean;
+    user?: NiceTopNavUser | NiceAuthUser;
+    userMenuItems?: UserMenuItem[];
+    /** @deprecated Use `userMenuItems`. */
+    userMenu?: NiceTopNavMenuItem[];
+    onProfile?: () => void;
+    onLogout?: () => void;
+    showLogin?: boolean;
+    loginLabel?: string;
+    onLoginClick?: () => void;
+    showRegister?: boolean;
+    registerLabel?: string;
+    onRegisterClick?: () => void;
+    /**
+     * Extra round icon-buttons rendered right before the auth/user-menu cluster.
+     * Each entry can either fire `onClick` directly or open a small dropdown
+     * (`menuItems`). Use this to add a customizable settings gear / quick actions
+     * without forking {@link NiceAuthButtons}.
+     */
+    extraActions?: NiceTopNavExtraAction[];
+    /** Show a built-in settings gear (uses inline Ntd-style cog SVG). */
+    showSettings?: boolean;
+    /** Settings click handler — used when `settingsMenuItems` is empty. */
+    onSettingsClick?: () => void;
+    /** Optional dropdown items shown when the settings gear is clicked. */
+    settingsMenuItems?: UserMenuItem[];
+    /** Settings button aria-label / tooltip. */
+    settingsLabel?: string;
+    /**
+     * Wrap search + language + theme pickers in a collapsible cluster with a
+     * chevron toggle. When `true` (default), the cluster starts collapsed and
+     * expands to the LEFT on click — saves horizontal space and prevents the
+     * navigation menu from overlapping the right toolbar. Set to `false` to
+     * always render the pickers inline.
+     */
+    collapsibleRightCluster?: boolean;
+    /** Initial open state of the collapsible cluster. Default `false`. */
+    rightClusterDefaultOpen?: boolean;
+    leftContent?: default_2.ReactNode;
+    rightContent?: default_2.ReactNode;
+    className?: string;
+    style?: default_2.CSSProperties;
+    id?: string;
+    'data-testid'?: string;
+}
+
+/** @deprecated v2 theme type. Prefer `<NiceThemePicker>` props. */
+export declare interface NiceTopNavThemeOption {
+    id: string;
+    label: string;
+    icon?: default_2.ReactNode;
+}
+
+/** @deprecated v2 user type. Prefer {@link NiceAuthUser}. */
+export declare interface NiceTopNavUser {
+    name: string;
+    avatarUrl?: string;
+    initials?: string;
+}
+
+export declare type NiceTopNavVariant = 'default' | 'primary' | 'accent' | 'transparent' | 'glass' | 'dark';
+
 export declare interface NiceTopologyData {
     links: Array<{
         sourceId: string;
@@ -18074,7 +19542,7 @@ export declare interface NiceTopologyData {
 
 export { NiceTouchTarget }
 
-export declare function NiceTranscoder({ jobs: initialJobs, profiles: initialProfiles, presets: customPresets, maxConcurrent, autoStart, defaultOutputDir, showThumbnails, enableDragDrop, onJobStatusChange, onJobComplete, onJobError, onProgress, renderJobItem, className, style, children, ...baseProps }: NiceTranscoderProps): JSX_2.Element;
+export declare function NiceTranscoder({ jobs: initialJobs, profiles: initialProfiles, presets: customPresets, maxConcurrent, autoStart, defaultOutputDir, showThumbnails, enableDragDrop, onJobStatusChange, onJobComplete: _onJobComplete, onJobError: _onJobError, onProgress: _onProgress, renderJobItem, className, style, children, ...baseProps }: NiceTranscoderProps): JSX_2.Element;
 
 export declare interface NiceTranscoderProps extends NiceBaseProps {
     /** Initial jobs */
@@ -18492,7 +19960,7 @@ export declare class NiceUndoManager<T = unknown> {
     /** Total entries count */
     get size(): number;
     /** Start a batch group — all pushes until endBatch share a groupId */
-    startBatch(label?: string): string;
+    startBatch(_label?: string): string;
     /** End the current batch group */
     endBatch(): void;
     /** Execute a function within a batch */
@@ -18705,6 +20173,8 @@ export declare type NiceValidationRule = {
     validationFunction?: (value: unknown) => boolean | string;
 };
 
+export { NiceValidationStatus }
+
 export declare const NiceValidationSummary: default_2.FC<NiceValidationSummaryProps>;
 
 /** Props for the {@link NiceValidationSummary} component — displays a list of validation errors from the parent {@link NiceValidationGroup}. */
@@ -18800,7 +20270,7 @@ export declare interface NiceVectorMapProps extends NiceBaseProps {
     showTooltip?: boolean;
 }
 
-export declare function NiceVideoAnnotator({ video: initialVideo, annotations: initialAnnotations, markers: initialMarkers, transcription: initialTranscription, speakers: initialSpeakers, currentUser, enableSpatialAnnotations, enableTranscription, enableComments, enableReview, autoSaveInterval, onAnnotationsChange, onMarkersChange, onTranscriptionChange, onAutoSave, onFrameExtracted, renderAnnotation, editorSize, className, style, children, ...baseProps }: NiceVideoAnnotatorProps): JSX_2.Element;
+export declare function NiceVideoAnnotator({ video: initialVideo, annotations: initialAnnotations, markers: initialMarkers, transcription: initialTranscription, speakers: initialSpeakers, currentUser, enableSpatialAnnotations, enableTranscription, enableComments, enableReview: _enableReview, autoSaveInterval: _autoSaveInterval, onAnnotationsChange, onMarkersChange, onTranscriptionChange: _onTranscriptionChange, onAutoSave: _onAutoSave, onFrameExtracted, renderAnnotation, editorSize, className, style, children, ...baseProps }: NiceVideoAnnotatorProps): JSX_2.Element;
 
 export declare interface NiceVideoAnnotatorProps extends NiceBaseProps {
     /** Editor layout size (minimal / compact / standard / fullscreen). */
@@ -20828,6 +22298,9 @@ export declare interface RealtimeDataPoint {
     label?: string;
 }
 
+/** Total time = prep + cook (minutes), or undefined if neither provided. */
+export declare function recipeTotalMinutes(recipe: NiceRecipeModel): number | undefined;
+
 /**
  * Reconciliation view configuration.
  */
@@ -21868,7 +23341,7 @@ export declare interface SidebarNavDataNode {
 export declare interface SidebarNavDataSource {
     id: string;
     label: string;
-    icon?: string;
+    icon?: ReactNode;
     color?: string;
     /** Server URL or connection string hint */
     url?: string;
@@ -21879,7 +23352,7 @@ export declare interface SidebarNavDataSource {
 export declare interface SidebarNavFavorite {
     id: string;
     label: string;
-    icon?: string;
+    icon?: ReactNode;
     route?: string;
     sourceId?: string;
     moduleId?: string;
@@ -21902,7 +23375,7 @@ export declare type SidebarNavMode = 'all' | 'by-role' | 'by-unit' | 'favorites'
 export declare interface SidebarNavModule {
     id: string;
     label: string;
-    icon?: string;
+    icon?: ReactNode;
     views: SidebarNavView[];
     /** Source this module belongs to */
     sourceId?: string;
@@ -21912,7 +23385,7 @@ export declare interface SidebarNavModule {
 export declare interface SidebarNavRole {
     id: string;
     label: string;
-    icon?: string;
+    icon?: ReactNode;
     modules: SidebarNavModule[];
     /** Source this role belongs to */
     sourceId?: string;
@@ -21922,7 +23395,7 @@ export declare interface SidebarNavRole {
 export declare interface SidebarNavUnit {
     id: string;
     label: string;
-    icon?: string;
+    icon?: ReactNode;
     modules: SidebarNavModule[];
     /** Source this unit belongs to */
     sourceId?: string;
@@ -21959,7 +23432,7 @@ export declare interface SidebarNavUserPrefs {
 export declare interface SidebarNavView {
     id: string;
     label: string;
-    icon?: string;
+    icon?: ReactNode;
     /** Route path for navigation */
     route?: string;
     /** Badge counter (unread notifications, pending tasks, …) */
@@ -22029,6 +23502,8 @@ declare interface SliderConfig {
     format?: (value: number) => string;
 }
 
+declare type Slot = ReactNode | ((api: NiceNavShellApi) => ReactNode);
+
 export declare interface SmartDeviceDto {
     id: string;
     name: string;
@@ -22904,6 +24379,34 @@ export { themePink }
  */
 export declare type ThemePreset = 'light' | 'dark' | 'system' | 'custom';
 
+/** Colours used to render a theme preview thumbnail. All optional except `background`. */
+export declare interface ThemePreviewColors {
+    /** Main page background. */
+    background: string;
+    /** Sidebar / secondary surface (left bar in 'page' shape). */
+    backgroundSecondary?: string;
+    /** Accent / header bar colour. */
+    primary: string;
+    /** Body text colour (rendered as a thin line). */
+    textColor: string;
+    /** Optional border (defaults to a translucent overlay). */
+    border?: string;
+}
+
+/**
+ * Renders a tiny "page" or "swatch" thumbnail of a theme.
+ *
+ * Pure CSS — a few absolutely-positioned `<span>`s — so it is cheap to
+ * render in long lists. Width is parameterised; height is ~75% of width
+ * so the thumbnail keeps a page-like aspect ratio.
+ */
+export declare const ThemePreviewSwatch: default_2.FC<{
+    colors: ThemePreviewColors;
+    size?: number;
+    shape?: 'page' | 'swatch';
+    className?: string;
+}>;
+
 export { themeRealEstate }
 
 export { themeRetrowave }
@@ -23330,7 +24833,7 @@ export declare interface TracelessStorageProps {
 /**
  * Shows warning when functionality is degraded due to privacy settings.
  */
-export declare function TracelessWarning({ useCase, className, message: customMessage, variant, dismissible, onDismiss, }: TracelessWarningProps): default_2.ReactElement | null;
+export declare function TracelessWarning({ useCase: _useCase, className, message: customMessage, variant, dismissible, onDismiss, }: TracelessWarningProps): default_2.ReactElement | null;
 
 /**
  * Props for TracelessWarning.
@@ -23736,6 +25239,8 @@ export { UseContainerSizeResult }
 
 export { useControlId }
 
+export { useControllableState }
+
 export { useControlPreferences }
 
 /**
@@ -23874,7 +25379,7 @@ export { useNiceDataSource }
 
 export { UseNiceDataSourceOptions }
 
-export declare function useNiceDataSourceTimeout<T = unknown>({ url, timeout, slowThreshold, onTimeout, retryOnTimeout, toastOnTimeout, fetcher, }: UseNiceDataSourceTimeoutOptions): UseNiceDataSourceTimeoutResult<T>;
+export declare function useNiceDataSourceTimeout<T = unknown>({ url, timeout, slowThreshold, onTimeout, retryOnTimeout: _retryOnTimeout, toastOnTimeout, fetcher, }: UseNiceDataSourceTimeoutOptions): UseNiceDataSourceTimeoutResult<T>;
 
 export declare interface UseNiceDataSourceTimeoutOptions {
     url: string;