@nice2dev/ui 1.0.10 → 1.0.12

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;
@@ -3068,6 +3086,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 +3697,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 +3745,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 +4334,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 +4669,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 +5670,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;
@@ -7051,6 +7162,8 @@ export declare interface NiceAppManifest {
     tenantId?: string;
 }
 
+export { NiceAriaProps }
+
 export { NiceArrayDataSourceConfig }
 
 export declare type NiceAuditAction = 'create' | 'update' | 'delete' | 'view' | 'export' | 'import' | 'login' | 'logout' | 'custom';
@@ -7853,6 +7966,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 +8289,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 +8415,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 +9283,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 +9296,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 +9590,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 +9621,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 +9939,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 +10310,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 +11156,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. */
@@ -12127,6 +12300,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>>;
@@ -12605,6 +12803,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 +13300,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;
@@ -13176,7 +13420,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 */
@@ -14296,6 +14540,12 @@ export declare interface NiceOnboardingWizardProps extends NiceBaseProps {
     logo?: React.ReactNode;
 }
 
+export { NiceOnChange }
+
+export { NiceOnOpenChange }
+
+export { NiceOnSelect }
+
 export { NiceOptimisticConfig }
 
 export { NiceOption }
@@ -14679,10 +14929,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 */
@@ -16759,7 +17025,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 +17285,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 +17457,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 +18004,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 +18047,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 +18188,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 +18412,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}. */
@@ -18074,7 +18470,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 +18888,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 +19101,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 +19198,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). */
@@ -22904,6 +23302,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 +23756,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 +24162,8 @@ export { UseContainerSizeResult }
 
 export { useControlId }
 
+export { useControllableState }
+
 export { useControlPreferences }
 
 /**
@@ -23826,7 +24254,7 @@ export declare function useGridStatePersistence({ storageKey, initialState, onSt
     setState: Dispatch<SetStateAction<GridPersistentState>>;
     clearState: () => void;
     degraded: boolean;
-    effectiveStorageType: "local" | "memory" | "session";
+    effectiveStorageType: "local" | "session" | "memory";
     policy: ITracelessPolicy;
 };
 
@@ -23874,7 +24302,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;