@nice2dev/ui 1.0.8 → 1.0.10

package/dist/editors.d.ts

@@ -1,6 +1,13 @@
 import { default as default_2 } from 'react';
 import { ForwardRefExoticComponent } from 'react';
+import { NiceBaseProps } from '@nice2dev/ui-core';
+import { NiceDataSource } from '@nice2dev/ui-core';
+import { NiceEditorSize } from '@nice2dev/ui-core';
+import { NiceFormFieldProps } from '@nice2dev/ui-core';
+import { NiceOption } from '@nice2dev/ui-core';
+import { NiceSize } from '@nice2dev/ui-core';
 import { RefAttributes } from 'react';
+import { TracelessMode } from '@nice2dev/ui-core';
 
 /** An accounting account entry. */
 declare interface AccountEntry {
@@ -209,16 +216,10 @@ declare interface LineAnnotation extends AnnotationBase {
     endY: number;
 }
 
-declare type Listener<Args extends unknown[]> = (...args: Args) => void;
+export declare const MASK_PRESETS: Record<NiceMaskPreset, string>;
 
-/**
- * Per-component visibility & interaction level used by the access control system.
- * - `'full'` — fully interactive (default)
- * - `'readOnly'` — renders but cannot be edited
- * - `'disabled'` — renders greyed-out
- * - `'hidden'` — not rendered at all
- */
-declare type NiceAccessMode = 'full' | 'readOnly' | 'disabled' | 'hidden';
+/** All built-in style preset keys (export for convenience when populating the `presets` prop). */
+export declare const NICE_COLOR_PRESET_KEYS: NiceColorPreset[];
 
 /**
  * {@link NiceAccountPicker} — Accounting account selector with search,
@@ -298,28 +299,6 @@ export declare interface NiceAutocompleteProps extends NiceFormFieldProps {
     suggestions?: (string | NiceOption)[];
 }
 
-/** Base props inherited by every NiceToDev component. */
-declare interface NiceBaseProps {
-    /** Additional CSS class name(s). */
-    className?: string;
-    /** Inline style object. */
-    style?: React.CSSProperties;
-    /** HTML `id` attribute. When omitted a stable auto-generated id is used. */
-    id?: string;
-    /** Tooltip text shown on hover. */
-    title?: string;
-    /** Test identifier for integration / e2e test selectors. */
-    'data-testid'?: string;
-    /** Controls component visibility and interaction — see {@link NiceAccessMode}. */
-    accessMode?: NiceAccessMode;
-    /**
-     * Visual presentation style override.
-     * When set, overrides the global `displayStyle` from `NiceThemeProvider`.
-     * @see NiceDisplayStyle
-     */
-    displayStyle?: NiceDisplayStyle;
-}
-
 export declare const NiceCalendar: default_2.FC<NiceCalendarProps>;
 
 /** Props for the {@link NiceCalendar} component — an inline month calendar with day/month/year views and multi-select support. */
@@ -345,31 +324,12 @@ export declare interface NiceCalendarProps extends NiceBaseProps, TracelessStora
     showKeyboardHints?: boolean;
     /** Persist view preferences (requires Traceless storage props) */
     persistPreferences?: boolean;
+    /** When true, the calendar fills the available horizontal space of its container. Default false (sized to content). */
+    fullWidth?: boolean;
 }
 
 export declare type NiceCalendarView = 'days' | 'months' | 'years' | 'decade';
 
-/** A cascading option node with optional children for {@link NiceCascadeSelect}. */
-export declare interface NiceCascadeOption {
-    label: string;
-    value: string;
-    children?: NiceCascadeOption[];
-}
-
-export declare const NiceCascadeSelect: default_2.ForwardRefExoticComponent<NiceCascadeSelectProps & default_2.RefAttributes<HTMLDivElement>>;
-
-/** Props for the {@link NiceCascadeSelect} component — a hierarchical dropdown (province → city → district). */
-export declare interface NiceCascadeSelectProps extends NiceBaseProps {
-    options: NiceCascadeOption[];
-    value?: string[];
-    onChange?: (path: string[]) => void;
-    placeholder?: string;
-    disabled?: boolean;
-    size?: NiceSize;
-    optionLabel?: string;
-    optionValue?: string;
-}
-
 export declare const NiceCheckbox: default_2.ForwardRefExoticComponent<NiceCheckboxProps & default_2.RefAttributes<HTMLInputElement>>;
 
 /** Props for the {@link NiceCheckbox} component. */
@@ -390,8 +350,24 @@ export declare interface NiceCheckboxProps extends NiceBaseProps {
     name?: string;
     /** Validation error message. */
     error?: string;
+    /** Assistive text shown below the field. */
+    helperText?: string;
+    /** Marks the field as required. */
+    required?: boolean;
+    /** Read-only mode. */
+    readOnly?: boolean;
+    /** Shows a loading spinner inside the control and disables interaction. */
+    loading?: boolean;
     /** Show keyboard shortcuts hint. */
     showKeyboardHints?: boolean;
+    /** Label position: 'right' (default — to the right of the box) or 'left'. */
+    labelPlacement?: 'right' | 'left';
+    /** Error/validation position: 'bottom' (default) or 'right'. */
+    errorPlacement?: 'bottom' | 'right';
+    /** Explicit width for the label column when labelPlacement is 'left'. */
+    labelWidth?: string | number;
+    /** Explicit width for the control column. */
+    controlWidth?: string | number;
 }
 
 declare interface NiceCodeCompletionItem {
@@ -644,7 +620,7 @@ declare interface NiceCodeMarker {
     severity: 1 | 2 | 4 | 8;
 }
 
-declare type NiceCodeTheme = 'vs' | 'vs-dark' | 'hc-black' | 'hc-light';
+declare type NiceCodeTheme = 'vs' | 'vs-dark' | 'hc-black' | 'hc-light' | 'auto';
 
 export declare const NiceColorPalette: default_2.ForwardRefExoticComponent<NiceColorPaletteProps & default_2.RefAttributes<HTMLDivElement>>;
 
@@ -677,6 +653,8 @@ export declare interface NiceColorPaletteProps extends NiceBaseProps {
     showInfo?: boolean;
     /** Show preset gallery */
     showPresets?: boolean;
+    /** List of preset keys to display in the gallery. Defaults to an empty array (no preset cards shown). */
+    presets?: NiceColorPreset[];
     /** Show variations (tints/shades) */
     showVariations?: boolean;
     /** Show random palette button */
@@ -697,6 +675,9 @@ export declare interface NiceColorPickerProps extends NiceFormFieldProps {
     presets?: string[];
     showInput?: boolean;
     showRandom?: boolean;
+    /** When true, the popup includes an alpha (transparency) slider and the
+     * emitted value uses 8-character hex `#RRGGBBAA`. Default: `false`. */
+    withAlpha?: boolean;
 }
 
 declare type NiceColorPreset = 'lightest-pastel' | 'bright-pastel' | 'shiny' | 'pastel' | 'full' | 'dark' | 'deep' | 'muted' | 'earth';
@@ -729,9 +710,22 @@ export declare interface NiceContactPickerProps extends NiceFormFieldProps {
     maxSelections?: number;
 }
 
+/** Built-in countdown format presets. */
+declare type NiceCountdownFormat = 
+/** `1d 02:34:15` / `02:34:15` — leading day count + clock */
+'verbose'
+/** `1d 2h 34m 15s` — abbreviated units */
+| 'compact'
+/** `2:34:15` / `34:15` — pure clock */
+| 'short'
+/** `in 2h` / `in 5m` / `in 30s` — single coarsest unit */
+| 'minimal'
+/** `1 day, 2 hours, 34 minutes` — verbose words */
+| 'words';
+
 export declare const NiceCountryPicker: default_2.FC<NiceCountryPickerProps>;
 
-export declare interface NiceCountryPickerProps {
+export declare interface NiceCountryPickerProps extends NiceFormFieldProps {
     /** Selected country code */
     value?: string;
     /** Default country code (uncontrolled) */
@@ -748,8 +742,6 @@ export declare interface NiceCountryPickerProps {
     showDialCode?: boolean;
     /** Show flag */
     showFlag?: boolean;
-    /** Disabled state */
-    disabled?: boolean;
     /** Filter to only show certain countries */
     countries?: string[];
     /** Priority countries shown at top */
@@ -758,10 +750,6 @@ export declare interface NiceCountryPickerProps {
     allowClear?: boolean;
     /** Size variant */
     size?: NiceSize;
-    /** Extra class name */
-    className?: string;
-    /** Inline styles */
-    style?: default_2.CSSProperties;
     /** Test ID */
     'data-testid'?: string;
 }
@@ -799,6 +787,12 @@ export declare interface NiceCropEditorProps {
     showGrid?: boolean;
     /** Crop overlay color */
     overlayColor?: string;
+    /** Position of the controls toolbar relative to the image. Default: 'bottom'. */
+    toolbarPosition?: 'top' | 'bottom' | 'left' | 'right';
+    /** When true, the toolbar can be collapsed via a toggle button. Default: false. */
+    toolbarCollapsible?: boolean;
+    /** Initial collapsed state when `toolbarCollapsible` is true. Default: false. */
+    defaultToolbarCollapsed?: boolean;
     /** Callback when crop changes */
     onChange?: (result: CropResult) => void;
     /** Extra class name */
@@ -842,53 +836,46 @@ export declare interface NiceCurrencyInputProps extends NiceFormFieldProps {
     onBlur?: (e: default_2.FocusEvent<HTMLInputElement>) => void;
 }
 
-/**
- * Universal data source interface for Nice2Dev UI data components.
- * All data-bound components (NiceDataGrid, NiceList, NiceForm, etc.) accept a `NiceDataSource`.
- * Create one via `createArrayDataSource`, `createRestDataSource`, `createODataDataSource`,
- * `createGraphQLDataSource`, or `createCustomDataSource`.
- */
-declare interface NiceDataSource<T = any> {
-    /** Field name used as unique row key. */
-    readonly keyField: string;
-    /** True when insert/update/remove are available. */
-    readonly writable: boolean;
-    load(options?: NiceLoadOptions): Promise<NiceLoadResult<T>>;
-    byKey(key: unknown): Promise<T | undefined>;
-    insert?(item: Partial<T>): Promise<T>;
-    update?(key: unknown, changes: Partial<T>): Promise<T>;
-    remove?(key: unknown): Promise<void>;
-    on<K extends keyof NiceDataSourceEventMap>(event: K, handler: Listener<NiceDataSourceEventMap[K]>): () => void;
-}
-
-/** Events emitted by all NiceDataSource implementations. */
-declare type NiceDataSourceEventMap = {
-    changed: [];
-    loading: [boolean];
-    error: [Error | null];
-    loaded: [NiceLoadResult<unknown>];
-};
+/** Predefined date-format presets. */
+export declare type NiceDateFormatPreset = 'date-local' | 'date-utc' | 'datetime-local' | 'datetime-utc' | 'month-local' | 'month-utc' | 'week' | 'time';
 
 export declare const NiceDatePicker: default_2.ForwardRefExoticComponent<NiceDatePickerProps & default_2.RefAttributes<HTMLInputElement>>;
 
-/** Props for the {@link NiceDatePicker} component — a native date/time input wrapper. */
+/** Props for the {@link NiceDatePicker} component — a masked, locale-aware date/time input. */
 export declare interface NiceDatePickerProps extends NiceFormFieldProps {
-    /** ISO date string value (e.g. `'2024-06-15'`). */
+    /** ISO value (e.g. `'2024-06-15'`). Always ISO regardless of display locale. */
     value?: string;
-    /** Fires with the new ISO date string. */
+    /** Fires with the new ISO value. Empty string while the input is incomplete. */
     onChange?: (value: string) => void;
     /** Native blur handler. */
     onBlur?: (e: default_2.FocusEvent<HTMLInputElement>) => void;
     /** Native keydown handler. */
     onKeyDown?: (e: default_2.KeyboardEvent<HTMLInputElement>) => void;
-    /** Minimum selectable date. */
+    /** Minimum selectable date (passed to the hidden native picker). */
     min?: string;
-    /** Maximum selectable date. */
+    /** Maximum selectable date (passed to the hidden native picker). */
     max?: string;
-    /** Input type — `'date'`, `'datetime-local'`, `'time'`, `'month'`, or `'week'`. */
+    /**
+     * @deprecated Use `dateFormatPreset` instead.
+     * Input type — `'date'`, `'datetime-local'`, `'time'`, `'month'`, or `'week'`.
+     */
     type?: 'date' | 'datetime-local' | 'time' | 'month' | 'week';
-    /** Placeholder text. */
+    /** Date format preset. Takes precedence over `type`. */
+    dateFormatPreset?: NiceDateFormatPreset;
+    /** Placeholder text. Defaults to a derived placeholder (e.g. `dd.MM.yyyy`). */
     placeholder?: string;
+    /** Show clear `×` button (default: `false`). Opt-in for nullable values. */
+    clearable?: boolean;
+    /**
+     * Show a calendar / clock icon button that opens the browser's native
+     * picker dialog (uses `HTMLInputElement.showPicker`). Default: `true`.
+     */
+    showPickerButton?: boolean;
+    /**
+     * BCP 47 locale used for the displayed mask of `*-local` presets. Defaults
+     * to the browser locale (`navigator.language`).
+     */
+    displayLocale?: string;
 }
 
 export declare const NiceDateRangeBox: default_2.FC<NiceDateRangeBoxProps>;
@@ -909,12 +896,22 @@ export declare interface NiceDateRangeBoxProps extends NiceFormFieldProps {
     max?: string;
     /** Show a clear button. */
     clearable?: boolean;
-    /** Placeholder text (when both fields are empty). */
-    placeholder?: string;
     /** Placeholder for the start input. */
     startPlaceholder?: string;
     /** Placeholder for the end input. */
     endPlaceholder?: string;
+    /** Label shown above (or before) the start picker. */
+    startLabel?: string;
+    /** Label shown above (or before) the end picker. */
+    endLabel?: string;
+    /** Layout direction for the two pickers (default `horizontal`). */
+    layout?: 'horizontal' | 'vertical';
+    /** Custom separator rendered between pickers in horizontal layout (default `–`). Pass `''` to hide. */
+    separator?: default_2.ReactNode;
+    /** Gap in pixels between the two pickers (default 12). */
+    gap?: number;
+    /** Stretch each picker to fill available width. */
+    fullWidth?: boolean;
 }
 
 export declare const NiceDateTimePicker: default_2.ForwardRefExoticComponent<NiceDateTimePickerProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -941,13 +938,6 @@ export declare interface NiceDateTimePickerProps extends NiceFormFieldProps {
     clearable?: boolean;
 }
 
-/**
- * Cross-component visual presentation style.
- * Each style maps 1:1 to a ThemeVariantConfig preset controlling
- * buttons, inputs, cards, badges, tabs, toggles, tooltips, tables, etc.
- */
-declare type NiceDisplayStyle = 'default' | 'minimal' | 'rounded' | 'sharp' | 'glass' | 'neumorphic' | 'playful' | 'enterprise' | 'modern3d' | 'brutalist' | 'luxe' | 'pill' | 'flat' | 'editorial' | 'dashboard' | 'softCloud' | 'cosmic' | 'corporate' | 'bank' | 'government' | 'military' | 'legal' | 'medical' | 'swiss' | 'scandinavian' | 'bauhaus' | 'notebook' | 'origami' | 'watercolor' | 'monochrome' | 'paper' | 'zen' | 'terminal' | 'hacker' | 'retro8bit' | 'synthwave' | 'cyberpunk' | 'steampunk' | 'vapor' | 'neon' | 'windows95' | 'material' | 'fluent' | 'cupertino' | 'ant' | 'bootstrap' | 'chakra' | 'notion' | 'linear' | 'vercel' | 'candy' | 'bubblegum' | 'cartoon' | 'kawaii' | 'circus' | 'gaming' | 'kiddo' | 'disco' | 'clown';
-
 /** A content block in the {@link NiceDocumentEditor}. */
 declare interface NiceDocumentBlock {
     id: string;
@@ -975,7 +965,7 @@ declare interface NiceDocumentBlock {
     open?: boolean;
     /** Checklist items checked status for list blocks with listType='checklist'. */
     checked?: boolean[];
-    /** Indentation level (0–4). */
+    /** Indentation level (0�4). */
     indent?: number;
     /** Lock block from editing. */
     locked?: boolean;
@@ -986,7 +976,7 @@ declare type NiceDocumentBlockType = 'paragraph' | 'heading' | 'list' | 'image'
 
 export declare const NiceDocumentEditor: ForwardRefExoticComponent<NiceDocumentEditorProps & RefAttributes<HTMLDivElement>>;
 
-/** Props for the {@link NiceDocumentEditor} component — a block-based document editor (Notion-like). */
+/** Props for the {@link NiceDocumentEditor} component � a block-based document editor (Notion-like). */
 export declare interface NiceDocumentEditorProps extends NiceBaseProps {
     blocks?: NiceDocumentBlock[];
     onChange?: (blocks: NiceDocumentBlock[]) => void;
@@ -1033,15 +1023,6 @@ export declare interface NiceDropDownBoxProps extends NiceFormFieldProps {
     dropdownWidth?: number | string;
 }
 
-/**
- * Layout sizing for editors, viewers and players.
- * - `'minimal'` — smallest usable chrome, toolbar hidden or icon-only
- * - `'compact'` — reduced padding, single-row toolbar
- * - `'standard'` — default layout with full toolbar
- * - `'fullscreen'` — expands to fill the viewport
- */
-declare type NiceEditorSize = 'minimal' | 'compact' | 'standard' | 'fullscreen';
-
 export declare const NiceEmojiPicker: default_2.FC<NiceEmojiPickerProps>;
 
 export declare interface NiceEmojiPickerProps {
@@ -1163,98 +1144,27 @@ declare interface NiceFileUploadRef {
     openFileBrowser: () => void;
 }
 
-/** A single filter condition in the {@link NiceFilterBuilder} tree. */
-declare type NiceFilterCondition = {
-    type: 'condition';
-    field: string;
-    operator: NiceFilterOperator;
-    value: unknown;
-};
-
-/** A group of conditions joined by AND/OR logic in the {@link NiceFilterBuilder}. */
-declare type NiceFilterGroup = {
-    type: 'group';
-    logic: 'and' | 'or';
-    items: (NiceFilterCondition | NiceFilterGroup)[];
-};
-
-/** Comparison operators available in the {@link NiceFilterBuilder}. */
-declare type NiceFilterOperator = '=' | '<>' | '<' | '<=' | '>' | '>=' | 'contains' | 'notcontains' | 'startswith' | 'endswith' | 'between' | 'isblank' | 'isnotblank' | (string & {});
-
-export declare const NiceFloatingLabelInput: default_2.ForwardRefExoticComponent<NiceFloatingLabelInputProps & default_2.RefAttributes<HTMLInputElement>>;
-
-export declare interface NiceFloatingLabelInputProps extends Omit<default_2.InputHTMLAttributes<HTMLInputElement>, 'size'> {
-    /** Label text (floats up when focused or has value) */
-    label: string;
-    /** Helper text shown below input */
-    helperText?: string;
-    /** Error message (shows instead of helper text when present) */
-    error?: string;
-    /** Success state */
-    success?: boolean;
-    /** Left icon */
-    startIcon?: default_2.ReactNode;
-    /** Right icon */
-    endIcon?: default_2.ReactNode;
-    /** Show character counter */
-    showCounter?: boolean;
-    /** Input variant */
-    variant?: 'outlined' | 'filled' | 'standard';
-    /** Size variant */
-    size?: NiceSize;
-    /** Full width */
-    fullWidth?: boolean;
-    /** Extra class name */
-    className?: string;
-    /** Test ID */
-    'data-testid'?: string;
-}
-
 export declare const NiceForm: default_2.FC<NiceFormProps>;
 
-/** Extended base props for form-field components (inputs, selects, etc.). */
-declare interface NiceFormFieldProps extends NiceBaseProps {
-    /** Field label displayed above or beside the control. */
-    label?: string;
-    /** Assistive text shown below the field. */
-    helperText?: string;
-    /** Validation error message — when set the field is styled as invalid. */
-    error?: string;
-    /** Marks the field as required (adds visual indicator). */
-    required?: boolean;
-    /** Disables the field. */
-    disabled?: boolean;
-    /** Makes the field read-only. */
-    readOnly?: boolean;
-    /** Visual size of the field. */
-    size?: NiceSize;
-    /** HTML `name` attribute used in form serialization. */
-    name?: string;
-    /** When true, pressing Enter will trigger the onSubmit callback (if provided). */
-    submitOnEnter?: boolean;
-    /** Callback triggered when Enter is pressed (if submitOnEnter is true). */
-    onSubmit?: () => void;
-    /** Show a keyboard shortcuts hint icon (?) next to the label. */
-    showKeyboardHints?: boolean;
-}
-
 /** Describes a single field in a {@link NiceForm} layout. */
 declare interface NiceFormItem {
     field: string;
     label?: string;
     colSpan?: number;
     required?: boolean;
-    /** Static visibility flag — set to false to always hide. */
+    /** Static visibility flag � set to false to always hide. */
     visible?: boolean;
     /**
      * Dynamic visibility: evaluated against current form data.
      * Example: `(data) => data.country === 'PL'`
      */
     visibleWhen?: (data: Record<string, any>) => boolean;
-    render?: (value: any, onChange: (v: any) => void) => default_2.ReactNode;
+    render?: (value: unknown, onChange: (v: unknown) => void) => default_2.ReactNode;
     hint?: string;
-    /** Group name — fields with the same group are rendered together under a section header. */
+    /** Group name � fields with the same group are rendered together under a section header. */
     group?: string;
+    /** Tab name � fields with the same tab are rendered together under a tab. Tabs take precedence over groups for top-level structure. */
+    tab?: string;
     /** Field type for auto-rendering (text, number, select, etc.). */
     type?: string;
     /** Options for select/radio type fields. */
@@ -1262,15 +1172,39 @@ declare interface NiceFormItem {
         label: string;
         value: string | number;
     } | string>;
+    /** Mask pattern for `type: 'masked'`. */
+    mask?: string;
+    /** Placeholder text shown when no value is selected/entered. */
+    placeholder?: string;
+    /** Default value applied when no value exists in `data`. */
+    defaultValue?: unknown;
+    /** Disable this field individually. */
+    disabled?: boolean;
+    /** Render this field in read-only mode individually. */
+    readOnly?: boolean;
+    /** Hide this field (alias of `visible: false`). */
+    hidden?: boolean;
+    /**
+     * Optional unit / currency code rendered as a suffix for `type: 'currency'`
+     * or `type: 'number'` (e.g. `'PLN'`, `'$'`, `'kg'`). Defaults to `'PLN'`
+     * for currency.
+     */
+    unit?: string;
+    /** Decimal precision for `type: 'number'` / `type: 'currency'`. Default 2 for currency, 0 for number. */
+    precision?: number;
+    /** Stepper increment for `type: 'number'` / `type: 'currency'`. Default 100 for currency, 1 for number. */
+    step?: number;
+    /** For `type: 'address'` � render sub-fields in 1 or 2 columns. Default 2. */
+    columns?: 1 | 2;
 }
 
-/** Props for the {@link NiceForm} component — a declarative, data-driven form layout. */
+/** Props for the {@link NiceForm} component � a declarative, data-driven form layout. */
 export declare interface NiceFormProps extends NiceBaseProps {
     items: NiceFormItem[];
     /** Inline form data. Ignored when `dataSource` + `recordKey` are provided. */
     data?: Record<string, any>;
     /** Field change callback. Ignored when `dataSource` is provided. */
-    onFieldChange?: (field: string, value: any) => void;
+    onFieldChange?: (field: string, value: unknown) => void;
     onSubmit?: (data: Record<string, any>) => void;
     /**
      * Two-way data source binding.
@@ -1282,8 +1216,8 @@ export declare interface NiceFormProps extends NiceBaseProps {
     recordKey?: unknown;
     columns?: number;
     /**
-     * Responsive columns: map of min-width breakpoint (px) → column count.
-     * Example: `{ 0: 1, 600: 2, 1024: 3 }` → 1 col on small, 2 on medium, 3 on large.
+     * Responsive columns: map of min-width breakpoint (px) ? column count.
+     * Example: `{ 0: 1, 600: 2, 1024: 3 }` ? 1 col on small, 2 on medium, 3 on large.
      */
     responsiveColumns?: Record<number, number>;
     gap?: number | string;
@@ -1295,6 +1229,20 @@ export declare interface NiceFormProps extends NiceBaseProps {
     autoSaveDelay?: number;
     /** Callback when dirty state changes. */
     onDirtyChange?: (isDirty: boolean) => void;
+    /** When true, render Submit/Reset buttons at the bottom. */
+    showActions?: boolean;
+    /** Custom Submit button label. */
+    submitLabel?: string;
+    /** Custom Reset button label. */
+    resetLabel?: string;
+    /**
+     * When provided, a Cancel button is rendered on the LEFT side of the
+     * actions row. Used by popup hosts (NiceDataGrid edit popup, NiceKanban
+     * edit popup, etc.) to dismiss the modal without submitting.
+     */
+    onCancel?: () => void;
+    /** Custom Cancel button label. */
+    cancelLabel?: string;
 }
 
 export declare const NiceGradientPicker: default_2.ForwardRefExoticComponent<NiceGradientPickerProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -1306,12 +1254,16 @@ export declare interface NiceGradientPickerProps extends NiceBaseProps {
     showCssOutput?: boolean;
     /** Show preset gallery */
     showPresets?: boolean;
+    /** Show the inline editor (type/angle/stops controls). When false, only preview/presets/random remain. */
+    showEditor?: boolean;
     /** Show random button */
     showRandom?: boolean;
     /** Maximum number of gradient stops */
     maxStops?: number;
     label?: string;
     disabled?: boolean;
+    /** Fixed width of the whole control. Defaults to 320px so the layout stays stable when stops are added. */
+    width?: string | number;
 }
 
 declare type NiceGradientShape = 'circle' | 'ellipse';
@@ -1336,7 +1288,7 @@ declare interface NiceGradientValue {
     stops: NiceGradientStop[];
 }
 
-declare type NiceHarmonyMode = 'monochromatic' | 'complementary' | 'split-complementary' | 'analogous' | 'triadic' | 'tetradic' | 'square';
+declare type NiceHarmonyMode = 'monochromatic' | 'complementary' | 'split-complementary' | 'analogous' | 'triadic' | 'tetradic' | 'square' | 'custom';
 
 export declare const NiceHtmlEditor: default_2.FC<NiceHtmlEditorProps>;
 
@@ -1399,7 +1351,7 @@ declare interface NiceHtmlEditorAIRef {
 /** Available toolbar commands for the {@link NiceHtmlEditor}. */
 declare type NiceHtmlEditorCommand = 'bold' | 'italic' | 'underline' | 'strikethrough' | 'h1' | 'h2' | 'h3' | 'ul' | 'ol' | 'link' | 'unlink' | 'undo' | 'redo' | 'clear' | 'table' | 'image' | 'code' | 'markdown' | 'blockquote' | 'hr' | 'fontSize' | 'fontColor' | 'bgColor' | 'subscript' | 'superscript' | 'indent' | 'outdent' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'fullscreen' | 'removeFormat' | 'print' | 'source' | 'emoji' | 'findReplace';
 
-/** Props for the {@link NiceHtmlEditor} component — a WYSIWYG rich-text editor with toolbar, mentions, and image upload. */
+/** Props for the {@link NiceHtmlEditor} component � a WYSIWYG rich-text editor with toolbar, mentions, and image upload. */
 export declare interface NiceHtmlEditorProps extends NiceFormFieldProps {
     value: string;
     onChange: (html: string) => void;
@@ -1532,28 +1484,6 @@ declare interface NiceImageEditorState {
 /** Available tools in the {@link NiceImageEditor} toolbar. */
 declare type NiceImageEditorTool = 'crop' | 'rotate' | 'flip' | 'brightness' | 'contrast' | 'saturate' | 'blur' | 'annotate';
 
-export declare const NiceInPlaceEditor: default_2.ForwardRefExoticComponent<NiceInPlaceEditorProps & default_2.RefAttributes<HTMLDivElement>>;
-
-declare interface NiceInPlaceEditorOption {
-    label: string;
-    value: string;
-}
-
-/** Props for the {@link NiceInPlaceEditor} component — click-to-edit inline text that toggles between display and editor mode. */
-export declare interface NiceInPlaceEditorProps extends NiceBaseProps {
-    value: string;
-    onChange: (value: string) => void;
-    type?: NiceInPlaceEditorType;
-    options?: NiceInPlaceEditorOption[];
-    submitOnBlur?: boolean;
-    placeholder?: string;
-    disabled?: boolean;
-    size?: NiceSize;
-}
-
-/** Supported editor types for the {@link NiceInPlaceEditor}. */
-declare type NiceInPlaceEditorType = 'text' | 'textarea' | 'select' | 'date' | 'number';
-
 export declare const NiceInputOtp: default_2.ForwardRefExoticComponent<NiceInputOtpProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Props for the {@link NiceInputOtp} component — a one-time-password input with separate digit boxes. */
@@ -1568,6 +1498,8 @@ export declare interface NiceInputOtpProps extends NiceFormFieldProps {
     /** Called when all digits are filled */
     onComplete?: (value: string) => void;
     autoFocus?: boolean;
+    /** Width of a single digit cell (number = px). Defaults per `size`. */
+    cellWidth?: number | string;
 }
 
 /**
@@ -1607,7 +1539,7 @@ export declare interface NiceInvoiceLineEditorProps extends NiceFormFieldProps {
 export declare const NiceKnob: default_2.ForwardRefExoticComponent<NiceKnobProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Props for the {@link NiceKnob} component — a rotary knob for numeric input (SVG-based). */
-export declare interface NiceKnobProps extends Omit<NiceFormFieldProps, 'size'> {
+export declare interface NiceKnobProps extends Omit<NiceFormFieldProps, 'size' | 'labelPlacement'> {
     value?: number;
     onChange?: (value: number) => void;
     min?: number;
@@ -1619,39 +1551,32 @@ export declare interface NiceKnobProps extends Omit<NiceFormFieldProps, 'size'>
     valueTemplate?: string;
     /** Knob diameter in pixels or NiceSize preset. */
     size?: number | NiceSize;
+    /** Where to place the label relative to the knob. Defaults to 'top'. */
+    labelPlacement?: 'top' | 'bottom' | 'left' | 'right';
+    /**
+     * When true (default), centers the label horizontally over/under the knob in
+     * top/bottom placements, or vertically next to the knob in left/right
+     * placements. Set to false to keep the label at the start of its axis.
+     */
+    isLabelCentered?: boolean;
 }
 
-/** Parameters sent to `load()`. All optional — adapters use what they support. */
-declare interface NiceLoadOptions {
-    filter?: NiceFilterGroup;
-    sort?: NiceSortExpression[];
-    skip?: number;
-    take?: number;
-    search?: string;
-    searchFields?: string[];
-    select?: string[];
-    expand?: string[];
-    group?: {
-        field: string;
-        direction?: NiceSortDirection;
-    }[];
-    /** Arbitrary parameters forwarded to the adapter (e.g. custom query strings). */
-    customParams?: Record<string, unknown>;
-}
+export declare const NiceLookup: default_2.FC<NiceLookupProps>;
 
-/** Result returned by {@link NiceDataSource.load}. */
-declare interface NiceLoadResult<T> {
-    data: T[];
-    totalCount: number;
-    summary?: Record<string, unknown>;
+/** Column definition for the mini-grid lookup mode. */
+declare interface NiceLookupColumn {
+    /** Field key in the row record. */
+    key: string;
+    /** Header label for the column. */
+    header: string;
+    /** Column width (CSS, e.g. '60px' or '20%'). */
+    width?: string | number;
 }
 
-export declare const NiceLookup: default_2.FC<NiceLookupProps>;
-
-/** Props for the {@link NiceLookup} component — a simple select-like lookup with optional search. */
+/** Props for the {@link NiceLookup} component — a select-like lookup with optional search or a mini data grid. */
 export declare interface NiceLookupProps extends NiceFormFieldProps {
-    /** Available options. */
-    options: NiceOption[];
+    /** Available options. Used when `data`/`columns` aren't provided. */
+    options?: NiceOption[];
     /** Selected value. */
     value: string;
     /** Called when the selection changes. */
@@ -1664,6 +1589,16 @@ export declare interface NiceLookupProps extends NiceFormFieldProps {
     loading?: boolean;
     /** Input placeholder text. */
     placeholder?: string;
+    /** Tabular data rows for the mini-grid mode. */
+    data?: Record<string, unknown>[];
+    /** Column definitions for the mini-grid mode. Required when `data` is provided. */
+    columns?: NiceLookupColumn[];
+    /** Field key in each row used as the selected value. Defaults to `'id'`. */
+    valueField?: string;
+    /** Field key in each row used for the displayed text. Defaults to the first column's key. */
+    displayField?: string;
+    /** Width of the dropdown when in mini-grid mode (CSS). */
+    dropdownWidth?: string | number;
 }
 
 export declare const NiceMarkdownEditor: default_2.ForwardRefExoticComponent<NiceMarkdownEditorProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -1706,7 +1641,9 @@ export declare interface NiceMaskedInputProps extends NiceFormFieldProps {
      *
      * Examples: `(999) 999-9999`, `9999 9999 9999 9999`, `99/99/9999`
      */
-    mask: string;
+    mask?: string;
+    /** Predefined mask preset — sets the mask pattern automatically. `mask` takes precedence. */
+    maskPreset?: NiceMaskPreset;
     /** Character shown for unfilled positions (default: '_') */
     maskChar?: string;
     placeholder?: string;
@@ -1716,6 +1653,9 @@ export declare interface NiceMaskedInputProps extends NiceFormFieldProps {
     autoFocus?: boolean;
 }
 
+/** Predefined mask presets. */
+export declare type NiceMaskPreset = 'phone' | 'credit-card' | 'date' | 'ssn' | 'zip' | 'time' | 'iban';
+
 export declare const NiceMention: default_2.ForwardRefExoticComponent<NiceMentionProps & default_2.RefAttributes<HTMLTextAreaElement>>;
 
 /** Props for the {@link NiceMention} component — a textarea with @mention triggers and suggestion popup. */
@@ -1742,29 +1682,6 @@ export declare interface NiceMentionSuggestion {
     [k: string]: unknown;
 }
 
-export declare const NiceMultiColumnComboBox: default_2.ForwardRefExoticComponent<NiceMultiColumnComboBoxProps & default_2.RefAttributes<HTMLDivElement>>;
-
-/** A column definition for the {@link NiceMultiColumnComboBox} dropdown grid. */
-declare interface NiceMultiColumnComboBoxColumn {
-    field: string;
-    header: string;
-    width?: number | string;
-}
-
-/** Props for the {@link NiceMultiColumnComboBox} component — a combo box whose dropdown shows data in columns (like a mini-grid). */
-export declare interface NiceMultiColumnComboBoxProps extends NiceBaseProps {
-    columns: NiceMultiColumnComboBoxColumn[];
-    data: Record<string, any>[];
-    value?: string;
-    onChange?: (value: string) => void;
-    displayExpr?: string;
-    valueExpr?: string;
-    placeholder?: string;
-    disabled?: boolean;
-    size?: NiceSize;
-    filterable?: boolean;
-}
-
 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. */
@@ -1789,28 +1706,32 @@ export declare interface NiceNumberInputProps extends NiceFormFieldProps {
     precision?: number;
     /** Prefix content (e.g. currency symbol). */
     prefix?: default_2.ReactNode;
-    /** Suffix content (e.g. unit). */
+    /** Prefix mode: 'label' (static, default) or 'select' (dropdown). */
+    prefixType?: 'label' | 'select';
+    /** Options for the prefix select dropdown. */
+    prefixOptions?: NiceSuffixOption[];
+    /** Currently selected prefix value (controlled). */
+    prefixValue?: string;
+    /** Called when the prefix select changes. */
+    onPrefixChange?: (value: string, prevWeight: number | undefined, newWeight: number | undefined) => void;
+    /** Suffix content (e.g. unit label or ReactNode). */
     suffix?: default_2.ReactNode;
     /** Show ▲/▼ stepper buttons (default `true`). */
     showStepper?: boolean;
+    /** Display format preset applied on blur: 'integer', 'decimal', 'money', 'percent'. */
+    formatPreset?: 'integer' | 'decimal' | 'money' | 'percent';
+    /** Custom display formatter applied on blur. Takes precedence over formatPreset. */
+    format?: (value: number) => string;
+    /** Suffix mode: 'label' (static, default) or 'select' (dropdown). */
+    suffixType?: 'label' | 'select';
+    /** Options for the suffix select dropdown. */
+    suffixOptions?: NiceSuffixOption[];
+    /** Currently selected suffix value (controlled). */
+    suffixValue?: string;
+    /** Called when the suffix select changes. */
+    onSuffixChange?: (value: string, prevWeight: number | undefined, newWeight: number | undefined) => void;
 }
 
-/** A single option displayed in selects, radio-groups, autocompletes and similar list-based editors. */
-declare type NiceOption<T = string> = {
-    /** The option's backing value. */
-    value: T;
-    /** Display text shown to the user. */
-    label: string;
-    /** When `true` the option cannot be selected. */
-    disabled?: boolean;
-    /** Optional icon rendered before the label. */
-    icon?: React.ReactNode;
-    /** Secondary description text. */
-    description?: string;
-    /** Grouping key for grouped dropdowns. */
-    group?: string;
-};
-
 export declare const NicePasswordInput: default_2.ForwardRefExoticComponent<NicePasswordInputProps & default_2.RefAttributes<HTMLInputElement>>;
 
 /** Props for the {@link NicePasswordInput} component — a password field with visibility toggle and strength meter. */
@@ -1827,6 +1748,8 @@ export declare interface NicePasswordInputProps extends NiceFormFieldProps {
     showStrength?: boolean;
     /** Custom strength rules — overrides default rules */
     strengthRules?: NicePasswordRule[];
+    /** Where to display the strength/validation section: 'bottom' (default, below control) or 'right' (beside control). */
+    validationPlacement?: 'bottom' | 'right';
     autoFocus?: boolean;
     autoComplete?: string;
 }
@@ -1907,10 +1830,10 @@ export declare interface NicePhoneInputProps extends NiceFormFieldProps {
     onBlur?: (e: default_2.FocusEvent<HTMLInputElement>) => void;
 }
 
-export declare const NicePickList: <T = any>(props: NicePickListProps<T> & default_2.RefAttributes<HTMLDivElement>) => default_2.ReactElement | null;
+export declare const NicePickList: <T = unknown>(props: NicePickListProps<T> & default_2.RefAttributes<HTMLDivElement>) => default_2.ReactElement | null;
 
 /** Props for the {@link NicePickList} component — a dual-list control for moving items between source and target. */
-export declare interface NicePickListProps<T = any> extends NiceBaseProps {
+export declare interface NicePickListProps<T = unknown> extends NiceBaseProps {
     /** Items in the source list */
     source: T[];
     /** Items in the target list */
@@ -1995,6 +1918,8 @@ export declare interface NiceRangeSliderProps extends NiceFormFieldProps {
     showLabels?: boolean;
     /** Custom label formatter. */
     formatLabel?: (value: number) => string;
+    /** Where to show the range value text. */
+    valuePlacement?: 'right' | 'bottom' | 'none';
 }
 
 export declare const NiceRating: default_2.ForwardRefExoticComponent<NiceRatingProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -2018,6 +1943,24 @@ export declare interface NiceRatingProps extends NiceBaseProps {
     /** Name for form submission */
     name?: string;
     error?: string;
+    /** Assistive text shown below the field. */
+    helperText?: string;
+    /** Marks the field as required. */
+    required?: boolean;
+    /** Shows a loading spinner inside the control and disables interaction. */
+    loading?: boolean;
+    /** Label placement: top (default) or left. */
+    labelPlacement?: 'top' | 'left';
+    /** Error placement: bottom (default) or right. */
+    errorPlacement?: 'bottom' | 'right';
+    /** Explicit width for the label column when labelPlacement is 'left'. */
+    labelWidth?: string | number;
+    /** Explicit width for the control column. */
+    controlWidth?: string | number;
+    /** Value display placement. */
+    valuePlacement?: 'right' | 'bottom' | 'none';
+    /** Custom value format, e.g. "{value}/5" */
+    valueTemplate?: string;
 }
 
 /**
@@ -2060,8 +2003,8 @@ export declare const NiceSelect: default_2.ForwardRefExoticComponent<NiceSelectP
 
 /** Props for the {@link NiceSelect} component. */
 export declare interface NiceSelectProps extends NiceFormFieldProps {
-    /** Static options array. Merged with (or overridden by) `optionsSource`. */
-    options?: NiceOption[];
+    /** Static options array. Plain strings are treated as `{ value: s, label: s }`. Merged with (or overridden by) `optionsSource`. */
+    options?: Array<NiceOption | string>;
     value?: string | string[];
     onChange?: (value: string | string[]) => void;
     placeholder?: string;
@@ -2090,6 +2033,8 @@ export declare interface NiceSelectProps extends NiceFormFieldProps {
     loading?: boolean;
     /** Custom render function for option items. */
     renderOption?: (option: NiceOption, isSelected: boolean) => default_2.ReactNode;
+    /** When true (default false), the trigger width grows to fit selected items in `multiple` mode. When false, width stays fixed. */
+    multipleAutosize?: boolean;
 }
 
 export declare const NiceSignature: default_2.ForwardRefExoticComponent<NiceSignatureProps & default_2.RefAttributes<NiceSignatureRef>>;
@@ -2172,6 +2117,8 @@ export declare interface NiceSignatureProps {
     disabled?: boolean;
     /** Read only (shows signature but can't edit) */
     readOnly?: boolean;
+    /** Display mode — hides toolbar and prevents editing. Equivalent to readOnly + showClearButton/showUndoButton/showColorPicker/showSizeSlider all false. */
+    displayMode?: boolean;
     /** On begin stroke */
     onBegin?: () => void;
     /** On end stroke */
@@ -2209,13 +2156,12 @@ declare interface NiceSignatureStroke {
     width: number;
 }
 
-/** T-shirt sizing used across all components for consistent visual density. */
-declare type NiceSize = 'xxs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
-
 export declare const NiceSlider: default_2.ForwardRefExoticComponent<NiceSliderProps & default_2.RefAttributes<HTMLInputElement>>;
 
 /** Props for the {@link NiceSlider} component — a single-thumb range slider for numeric input. */
-export declare interface NiceSliderProps extends NiceFormFieldProps {
+export declare interface NiceSliderProps extends Omit<NiceFormFieldProps, 'labelPlacement'> {
+    /** Where to place the label relative to the slider. 'top' (default) shows label and value above the track; 'bottom' shows label and value above the track but in a row above (legacy 'left' behaviour); 'left' places label to the left and value to the right of the slider on a single row. */
+    labelPlacement?: 'top' | 'bottom' | 'left';
     /** Current value. */
     value?: number;
     /** Called when the value changes. */
@@ -2234,15 +2180,26 @@ export declare interface NiceSliderProps extends NiceFormFieldProps {
     formatValue?: (v: number) => string;
     /** Show tick marks on the slider track. */
     showTicks?: boolean;
+    /**
+     * Distance between ticks expressed in slider value units. Defaults to `step`
+     * when `showTicks` is true. If the resulting tick count would exceed
+     * {@link maxTicks}, the renderer falls back to evenly spaced ticks.
+     */
+    tickInterval?: number;
+    /** Maximum number of ticks rendered. Defaults to 21 (so a 0–100 step=5 shows 21 marks). */
+    maxTicks?: number;
+    /** Render numeric labels under each tick. Defaults to `false`. */
+    showTickLabels?: boolean;
 }
 
-/** Sort direction for data source queries. */
-declare type NiceSortDirection = 'asc' | 'desc';
-
-/** A single sort expression: field name + direction. */
-declare interface NiceSortExpression {
-    field: string;
-    direction: NiceSortDirection;
+/** An option for the prefix/suffix select dropdown with optional conversion weight. */
+export declare interface NiceSuffixOption {
+    /** Option value. */
+    value: string;
+    /** Display label. */
+    label: string;
+    /** Conversion weight relative to the base unit. When set and the user switches units, the numeric value is multiplied by `(prevWeight / newWeight)`. */
+    weight?: number;
 }
 
 export declare const NiceTagBox: default_2.FC<NiceTagBoxProps>;
@@ -2250,7 +2207,7 @@ export declare const NiceTagBox: default_2.FC<NiceTagBoxProps>;
 /** Props for the {@link NiceTagBox} component — a multi-select input that displays selected items as tags/chips. */
 export declare interface NiceTagBoxProps extends NiceFormFieldProps {
     /** Available options. */
-    options: NiceOption[];
+    options?: NiceOption[];
     /** Array of selected values. */
     value: string[];
     /** Called when the selection changes. */
@@ -2267,6 +2224,13 @@ export declare interface NiceTagBoxProps extends NiceFormFieldProps {
     placeholder?: string;
     /** Alias for options — array of string suggestions. */
     suggestions?: string[];
+    /**
+     * When true, the control grows vertically as more tags are added (tags wrap to
+     * new rows). When false (default), the control keeps a fixed single-row height
+     * and tags overflow horizontally with a scroll. Set to true to opt in to the
+     * legacy auto-expanding behaviour.
+     */
+    autoExpand?: boolean;
 }
 
 /**
@@ -2306,12 +2270,16 @@ export declare interface NiceTextAreaProps extends NiceFormFieldProps {
     resize?: 'none' | 'vertical' | 'horizontal' | 'both';
     autoFocus?: boolean;
     showCount?: boolean;
+    /** Where to display the character counter: 'bottom' (default, below control) or 'right' (beside control). */
+    counterPlacement?: 'bottom' | 'right';
 }
 
 export declare const NiceTextInput: default_2.ForwardRefExoticComponent<NiceTextInputProps & default_2.RefAttributes<HTMLInputElement>>;
 
 /** Props for the {@link NiceTextInput} component. */
-export declare interface NiceTextInputProps extends NiceFormFieldProps {
+export declare interface NiceTextInputProps extends Omit<NiceFormFieldProps, 'labelPlacement'> {
+    /** Where to place the label. 'inside' renders a Material-style floating label that sits as a placeholder inside the input and animates upward when focused or filled. Defaults to 'top'. */
+    labelPlacement?: 'top' | 'left' | 'inside';
     /** Controlled input value. */
     value?: string;
     /** Uncontrolled default value. */
@@ -2360,6 +2328,27 @@ export declare interface NiceTimePickerProps extends NiceFormFieldProps {
     max?: string;
     /** Show clear button */
     clearable?: boolean;
+    /**
+     * Optional explicit target date to combine with the picked time
+     * (`Date` or `YYYY-MM-DD` string). When omitted while {@link countdown}
+     * is enabled, the target auto-resolves to the **next occurrence**:
+     * today if the picked time hasn't passed yet, tomorrow if it has.
+     */
+    targetDate?: string | Date;
+    /** Fires whenever the resolved target Date changes. */
+    onTargetChange?: (target: Date) => void;
+    /** Show a live countdown label beside the picker. */
+    countdown?: boolean;
+    /** Built-in countdown format preset (default `'verbose'`). */
+    countdownFormat?: NiceCountdownFormat;
+    /** Custom formatter (overrides {@link countdownFormat}). */
+    formatCountdown?: (msRemaining: number, target: Date) => string;
+    /** Label rendered before the countdown text (e.g. `'starts in'`). */
+    countdownLabel?: default_2.ReactNode;
+    /** Update interval in ms (default `1000`). */
+    countdownInterval?: number;
+    /** Text shown when the target time has elapsed (default `'now'`). */
+    countdownDoneText?: string;
 }
 
 export declare const NiceToggle: default_2.ForwardRefExoticComponent<NiceToggleProps & default_2.RefAttributes<HTMLInputElement>>;
@@ -2374,64 +2363,30 @@ export declare interface NiceToggleProps extends NiceBaseProps {
     onChange?: (checked: boolean) => void;
     /** Disables the toggle. */
     disabled?: boolean;
+    /** Read-only mode. */
+    readOnly?: boolean;
+    /** Shows a loading spinner inside the control and disables interaction. */
+    loading?: boolean;
+    /** Marks the field as required. */
+    required?: boolean;
     /** Visual size. */
     size?: NiceSize;
     /** HTML name. */
     name?: string;
+    /** Validation error message. */
+    error?: string;
+    /** Assistive text shown below the field. */
+    helperText?: string;
     /** Show keyboard shortcuts hint. */
     showKeyboardHints?: boolean;
-}
-
-export declare const NiceTransferList: default_2.FC<NiceTransferListProps>;
-
-declare interface NiceTransferListItem {
-    key: string;
-    label: string;
-    disabled?: boolean;
-    group?: string;
-}
-
-export declare interface NiceTransferListProps {
-    /** All available items */
-    dataSource: NiceTransferListItem[];
-    /** Keys of items in the right (target) list */
-    targetKeys?: string[];
-    /** Controlled selection */
-    selectedKeys?: string[];
-    /** Callback when target keys change */
-    onChange?: (targetKeys: string[], direction: 'left' | 'right', moveKeys: string[]) => void;
-    /** Callback when selection changes */
-    onSelectChange?: (sourceSelectedKeys: string[], targetSelectedKeys: string[]) => void;
-    /** Custom render for items */
-    render?: (item: NiceTransferListItem) => default_2.ReactNode;
-    /** Custom render for list title */
-    titles?: [default_2.ReactNode, default_2.ReactNode];
-    /** Enable searching */
-    showSearch?: boolean;
-    /** Search placeholder */
-    searchPlaceholder?: string;
-    /** Filter function for search */
-    filterOption?: (inputValue: string, item: NiceTransferListItem) => boolean;
-    /** Enable select all */
-    showSelectAll?: boolean;
-    /** Disabled state */
-    disabled?: boolean;
-    /** Enable drag and drop transfer */
-    draggable?: boolean;
-    /** One-way mode (items can only move to target) */
-    oneWay?: boolean;
-    /** Custom operations buttons */
-    operations?: [default_2.ReactNode, default_2.ReactNode];
-    /** Group items by group field */
-    showGroups?: boolean;
-    /** Extra class name */
-    className?: string;
-    /** Inline styles */
-    style?: default_2.CSSProperties;
-    /** Height of the lists */
-    listHeight?: number;
-    /** Test ID */
-    'data-testid'?: string;
+    /** Label position: 'right' (default — to the right of the toggle) or 'left'. */
+    labelPlacement?: 'right' | 'left';
+    /** Error/validation position: 'bottom' (default) or 'right'. */
+    errorPlacement?: 'bottom' | 'right';
+    /** Explicit width for the label column when labelPlacement is 'left'. */
+    labelWidth?: string | number;
+    /** Explicit width for the control column. */
+    controlWidth?: string | number;
 }
 
 export declare const NiceTreeSelect: default_2.ForwardRefExoticComponent<NiceTreeSelectProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -2442,6 +2397,7 @@ declare interface NiceTreeSelectNode {
     label: string;
     children?: NiceTreeSelectNode[];
     disabled?: boolean;
+    /** @deprecated Icons are no longer rendered — prop kept for backward compatibility. */
     icon?: default_2.ReactNode;
 }
 
@@ -2617,44 +2573,6 @@ declare interface TextAnnotation extends AnnotationBase {
 
 declare type TextStyle = 'professional' | 'casual' | 'formal' | 'concise';
 
-/**
- * @fileoverview Traceless™ — Zero-Trace Privacy Architecture
- * @module @nice2dev/ui/core/traceless
- *
- * Traceless™ is OmniVerk's flagship privacy feature that allows complete control
- * over client-side storage (cookies, localStorage, sessionStorage).
- *
- * "Żadnych śladów. Żadnych cookies. Żadnego localStorage. Żadnego bannera. Traceless."
- *
- * @example
- * ```tsx
- * import { TracelessProvider, useTracelessPolicy, StorageAdapter } from '@nice2dev/ui';
- *
- * // In your app root:
- * <TracelessProvider>
- *   <App />
- * </TracelessProvider>
- *
- * // In components:
- * const { mode, canUseCookies, canUseLocalStorage } = useTracelessPolicy();
- * const storage = useStorageAdapter();
- * storage.set('key', 'value'); // Automatically respects policy
- * ```
- */
-/**
- * Privacy storage modes from most private to most permissive.
- *
- * | Mode       | Cookies | localStorage | sessionStorage | Consent Banner |
- * |------------|---------|--------------|----------------|----------------|
- * | traceless  | ❌      | ❌           | ❌             | ❌ Never       |
- * | ephemeral  | ❌      | ❌           | ✅             | ❌ Never       |
- * | private    | 1 auth  | ❌           | ✅             | ❌ Exempt      |
- * | balanced   | ❌      | ✅           | ✅             | ⚠️ Maybe       |
- * | full       | ✅      | ✅           | ✅             | ✅ Required    |
- * | custom     | Config  | Config       | Config         | Config         |
- */
-declare type TracelessMode = 'traceless' | 'ephemeral' | 'private' | 'balanced' | 'full' | 'custom';
-
 /**
  * Standard props that can be added to any component to support Traceless policy.
  */