@nice2dev/ui 1.0.30 → 1.0.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/CHANGELOG.md +495 -0
  2. package/README.md +30 -31
  3. package/dist/NiceCalendarScheduler.doc-BEtQkZjV.cjs +9 -0
  4. package/dist/NiceCalendarScheduler.doc-D__LRgOx.js +33 -0
  5. package/dist/NiceConfirmDialog-B57cl_F7.cjs +1 -0
  6. package/dist/NiceConfirmDialog-N9fBTLYm.js +81 -0
  7. package/dist/NiceDrawingCanvas.doc-Dv5vB4gY.js +32 -0
  8. package/dist/NiceDrawingCanvas.doc-Ww9zz17x.cjs +8 -0
  9. package/dist/NiceErrorBoundary-BD-uqk_q.js +709 -0
  10. package/dist/NiceErrorBoundary-CIPXaYik.cjs +1 -0
  11. package/dist/NiceFileManagerViews.doc-CKlnm6cX.cjs +1 -0
  12. package/dist/NiceFileManagerViews.doc-Cg21DArG.js +25 -0
  13. package/dist/NiceForm-BNZB31Pg.js +4499 -0
  14. package/dist/NiceForm-CPyAXxBO.cjs +1 -0
  15. package/dist/NiceMegaMenu.doc-7UyOCd3l.cjs +7 -0
  16. package/dist/NiceMegaMenu.doc-zeIyVa65.js +31 -0
  17. package/dist/NiceModal-Bj53SKLI.js +95 -0
  18. package/dist/NiceModal-DC0UlQhc.cjs +1 -0
  19. package/dist/NiceModuleLifecyclePanel-BBOg9g0b.cjs +1 -0
  20. package/dist/NiceModuleLifecyclePanel-DtuXRiLR.js +6991 -0
  21. package/dist/NiceModuleLifecyclePanel.css +1 -1
  22. package/dist/NicePagination-Bjxy9aEc.js +172 -0
  23. package/dist/NicePagination-CfFfNwrg.cjs +1 -0
  24. package/dist/NiceSavedQueryPanel-CH5c3rUG.js +6988 -0
  25. package/dist/NiceSavedQueryPanel-aQrEmmcC.cjs +596 -0
  26. package/dist/NiceScannerControl-Cd5KXJA9.js +12769 -0
  27. package/dist/NiceScannerControl-DZsERSw_.cjs +698 -0
  28. package/dist/NiceScannerControl.css +1 -0
  29. package/dist/NiceWindow-BoDzlGk-.js +1621 -0
  30. package/dist/NiceWindow-DgONWxBm.cjs +1 -0
  31. package/dist/charts-Bs0aDM0X.js +4671 -0
  32. package/dist/charts-DjjKkw0q.cjs +761 -0
  33. package/dist/charts.cjs +1 -1
  34. package/dist/charts.mjs +1 -1
  35. package/dist/core-BUsZ7_vI.js +27914 -0
  36. package/dist/core-CLfcCDKc.cjs +122 -0
  37. package/dist/data-branching-D7l_kILW.cjs +1 -0
  38. package/dist/data-branching-lJ07lDN-.js +6255 -0
  39. package/dist/data-branching.cjs +1 -1
  40. package/dist/data-branching.mjs +1 -1
  41. package/dist/data.cjs +1 -1
  42. package/dist/data.d.ts +41 -37
  43. package/dist/data.mjs +18 -19
  44. package/dist/devops-Bi8MXtko.js +8165 -0
  45. package/dist/devops-On_1wRf9.cjs +17 -0
  46. package/dist/devops.cjs +1 -1
  47. package/dist/devops.mjs +1 -1
  48. package/dist/editors.cjs +1 -1
  49. package/dist/editors.d.ts +215 -431
  50. package/dist/editors.mjs +48 -56
  51. package/dist/feedback.cjs +1 -1
  52. package/dist/feedback.mjs +3 -3
  53. package/dist/index-BDH1yDSg.js +69235 -0
  54. package/dist/index-C9njkNOD.cjs +5470 -0
  55. package/dist/index.cjs +1 -1
  56. package/dist/index.css +1 -1
  57. package/dist/index.d.ts +441 -916
  58. package/dist/index.mjs +908 -933
  59. package/dist/lazy.cjs +1 -1
  60. package/dist/lazy.mjs +24 -24
  61. package/dist/navigation.cjs +1 -1
  62. package/dist/navigation.d.ts +25 -213
  63. package/dist/navigation.mjs +105 -113
  64. package/dist/no-code-8lO7o6xi.js +7425 -0
  65. package/dist/no-code-K8tOLNew.cjs +332 -0
  66. package/dist/no-code.cjs +1 -1
  67. package/dist/no-code.mjs +1 -1
  68. package/dist/overlays.cjs +1 -1
  69. package/dist/overlays.d.ts +8 -0
  70. package/dist/overlays.mjs +36 -36
  71. package/dist/pickerCommons-CORo9j2a.js +2119 -0
  72. package/dist/pickerCommons-D3WShRrR.cjs +1 -0
  73. package/dist/style.css +5 -5
  74. package/package.json +3 -3
package/dist/index.d.ts CHANGED
@@ -3191,14 +3191,6 @@ declare interface CSATSurvey {
3191
3191
 
3192
3192
  export declare function cssToGradient(css: string): NiceGradientValue | null;
3193
3193
 
3194
- /** Currency definition. */
3195
- export declare interface CurrencyDef {
3196
- code: string;
3197
- symbol: string;
3198
- name: string;
3199
- decimals?: number;
3200
- }
3201
-
3202
3194
  /** Current schema version. */
3203
3195
  export declare const CURRENT_SCHEMA_VERSION = 2;
3204
3196
 
@@ -5011,6 +5003,7 @@ export declare interface FigmaTokens {
5011
5003
  shadows: Record<string, string>;
5012
5004
  }
5013
5005
 
5006
+ /** Per-file record tracked by {@link NiceUpload}. */
5014
5007
  export declare interface FileInfo {
5015
5008
  id: string;
5016
5009
  file: File;
@@ -5018,15 +5011,18 @@ export declare interface FileInfo {
5018
5011
  size: number;
5019
5012
  type: string;
5020
5013
  status: UploadStatus;
5014
+ /** 0–100. */
5021
5015
  progress: number;
5022
5016
  error?: string;
5017
+ /** Object URL for image/video/audio previews. */
5023
5018
  previewUrl?: string;
5019
+ /** Server-returned URL after a successful upload. */
5024
5020
  uploadedUrl?: string;
5025
5021
  uploadedAt?: Date;
5026
5022
  chunks?: ChunkInfo[];
5027
5023
  }
5028
5024
 
5029
- declare interface FileItemActions {
5025
+ export declare interface FileItemActions {
5030
5026
  upload: () => void;
5031
5027
  cancel: () => void;
5032
5028
  retry: () => void;
@@ -7346,6 +7342,14 @@ export declare interface NiceActionSheetProps extends NiceBaseProps {
7346
7342
  showCancelButton?: boolean;
7347
7343
  /** Cancel button text. */
7348
7344
  cancelText?: string;
7345
+ /** Sheet size (xs..xl) — scales the max-width + item font. */
7346
+ size?: NiceSize;
7347
+ /** Disabled: dims the sheet + blocks every action. */
7348
+ disabled?: boolean;
7349
+ /** Loading: a spinner overlay + aria-busy; actions blocked. */
7350
+ loading?: boolean;
7351
+ /** Error message shown at the top of the sheet. */
7352
+ error?: string;
7349
7353
  }
7350
7354
 
7351
7355
  /**
@@ -7681,7 +7685,7 @@ export declare interface NiceAppManifest {
7681
7685
  /**
7682
7686
  * {@link NiceAppShell} — reusable app chrome for richer, IDE/DAW-style tools:
7683
7687
  * a menubar, a tools toolbar, an optional sidebar, the content area and a status
7684
- * bar. Built to be composed with `NiceMenu`, `NiceToolbar` and the content of
7688
+ * bar. Built to be composed with `NiceMenu` and the content of
7685
7689
  * your choice (e.g. `NiceAudioStudio` builds on it).
7686
7690
  */
7687
7691
  export declare const NiceAppShell: default_2.ForwardRefExoticComponent<NiceAppShellProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -7690,12 +7694,13 @@ export declare const NiceAppShell: default_2.ForwardRefExoticComponent<NiceAppSh
7690
7694
  * Props for {@link NiceAppShell} — a generic desktop-application frame
7691
7695
  * (menubar → toolbar → [sidebar | content] → status bar). Each region is an
7692
7696
  * optional slot; compose the menubar from a horizontal `NiceMenu` and the
7693
- * toolbar from `NiceToolbar`. Theme-tokened and responsive.
7697
+ * toolbar from your own controls (buttons, a `NiceMenu`, etc.). Theme-tokened
7698
+ * and responsive.
7694
7699
  */
7695
7700
  export declare interface NiceAppShellProps extends NiceBaseProps {
7696
7701
  /** Top menubar row — typically a horizontal `NiceMenu` (File / Edit / View / Help). */
7697
7702
  menubar?: default_2.ReactNode;
7698
- /** Tools toolbar row, below the menubar — typically a `NiceToolbar`. */
7703
+ /** Tools toolbar row, below the menubar — typically buttons or a `NiceMenu`. */
7699
7704
  toolbar?: default_2.ReactNode;
7700
7705
  /** Optional left sidebar (panels, track list, tool palette / tool rail). */
7701
7706
  sidebar?: default_2.ReactNode;
@@ -8045,6 +8050,14 @@ export declare interface NiceAutocompleteProps extends NiceFormFieldProps {
8045
8050
  highlightMatch?: boolean;
8046
8051
  /** Alias for options — array of string suggestions. */
8047
8052
  suggestions?: (string | NiceOption)[];
8053
+ /**
8054
+ * When `true` (default), focusing the field (before typing) opens the dropdown
8055
+ * with **all** options sorted alphabetically. Set `false` to only show
8056
+ * suggestions once the user has typed `minSearchLength` characters.
8057
+ */
8058
+ showAll?: boolean;
8059
+ /** Gap (px) between the input and the suggestion menu. Default 0 (menu abuts the input). */
8060
+ menuGap?: number;
8048
8061
  }
8049
8062
 
8050
8063
  export declare const NiceAutomationRuleEditor: default_2.FC<NiceAutomationRuleEditorProps>;
@@ -8318,13 +8331,30 @@ export declare interface NiceBarcodeProps extends NiceStandardProps {
8318
8331
  size?: NiceSize;
8319
8332
  /**
8320
8333
  * Render an editable {@link NiceTextInput} above the barcode that live-encodes
8321
- * what the user types. Off by default — pass `showInput` to enable.
8334
+ * what the user types. Off by default — pass `showInput` to enable. The barcode
8335
+ * itself always renders; this only toggles the editor field above it.
8322
8336
  */
8323
8337
  showInput?: boolean;
8324
- /** Label for the built-in input (only when `showInput`). */
8338
+ /**
8339
+ * Alias for {@link showInput}. When `editable` is provided it takes precedence:
8340
+ * `editable={false}` hides the input (barcode still renders), `editable` shows it.
8341
+ */
8342
+ editable?: boolean;
8343
+ /** Label for the built-in input (only when the input is shown). */
8325
8344
  inputLabel?: string;
8326
- /** Placeholder for the built-in input (only when `showInput`). */
8345
+ /** Placeholder for the built-in input (only when the input is shown). */
8327
8346
  inputPlaceholder?: string;
8347
+ /** Where to place the built-in input's label (forwarded to {@link NiceTextInput}). */
8348
+ labelPlacement?: NiceTextInputProps['labelPlacement'];
8349
+ /**
8350
+ * Extra props forwarded to the built-in {@link NiceTextInput}, so the top editor
8351
+ * is a fully-featured NiceTextInput (variant, prefix/suffix, clearable, helperText,
8352
+ * error, disabled, readOnly, …). Explicit props (`inputLabel`, `inputPlaceholder`,
8353
+ * `labelPlacement`, `size`) win over the same keys here.
8354
+ */
8355
+ inputProps?: Partial<NiceTextInputProps>;
8356
+ /** Fires with the new value whenever the user edits the built-in input. */
8357
+ onValueChange?: (value: string) => void;
8328
8358
  }
8329
8359
 
8330
8360
  export declare const NiceBarGauge: default_2.FC<NiceBarGaugeProps>;
@@ -8406,34 +8436,6 @@ export declare interface NiceBlockUIProps extends NiceBaseProps {
8406
8436
  children: default_2.ReactNode;
8407
8437
  }
8408
8438
 
8409
- export declare const NiceBottomNavigation: default_2.ForwardRefExoticComponent<NiceBottomNavigationProps & default_2.RefAttributes<HTMLDivElement>>;
8410
-
8411
- /** A navigation item in the {@link NiceBottomNavigation} bar. */
8412
- export declare interface NiceBottomNavigationItem {
8413
- /** Unique key. */
8414
- key: string;
8415
- /** Label text. */
8416
- label: string;
8417
- /** Icon element. */
8418
- icon?: default_2.ReactNode;
8419
- /** Disable the item. */
8420
- disabled?: boolean;
8421
- }
8422
-
8423
- /** Props for the {@link NiceBottomNavigation} component — a mobile-style bottom tab bar. */
8424
- export declare interface NiceBottomNavigationProps extends NiceBaseProps {
8425
- /** Navigation items. */
8426
- items: NiceBottomNavigationItem[];
8427
- /** Currently active item key. */
8428
- activeKey?: string;
8429
- /** Called when the active item changes. */
8430
- onChange?: (key: string) => void;
8431
- /** Bar size preset. */
8432
- size?: NiceSize;
8433
- /** Show text labels below icons. */
8434
- showLabels?: boolean;
8435
- }
8436
-
8437
8439
  export declare const NiceBox: default_2.FC<NiceBoxProps>;
8438
8440
 
8439
8441
  /** Props for the {@link NiceBox} component — a flex-based layout container. */
@@ -8636,9 +8638,9 @@ export declare const NiceButtonGroup: default_2.FC<NiceButtonGroupProps>;
8636
8638
  * Props for the {@link NiceButtonGroup} component — visually groups
8637
8639
  * adjacent buttons into one connected cluster.
8638
8640
  *
8639
- * Children may be {@link NiceButton} (text, icon-only via `leftIcon` with
8640
- * empty children, or icon + text via `leftIcon` / `rightIcon`) or
8641
- * {@link NiceIconButton}. Use this for clusters of **independent action
8641
+ * Children are {@link NiceButton} elements (text, icon-only via `leftIcon`
8642
+ * with empty children, or icon + text via `leftIcon` / `rightIcon`). Use
8643
+ * this for clusters of **independent action
8642
8644
  * buttons**. For an exclusive single-select toggle pattern (with an
8643
8645
  * animated highlight) use {@link NiceSegmentedControl} instead.
8644
8646
  */
@@ -8785,25 +8787,73 @@ export declare interface NiceCardGridProps extends NiceStandardProps {
8785
8787
 
8786
8788
  /**
8787
8789
  * {@link NiceCardGroup} — themed, responsive CSS-grid layout for a set of cards.
8790
+ * With `value`/`onChange` it also acts as a single-select card radio group, and
8791
+ * with `items`/`renderCard` it renders a searchable data grid of cards.
8788
8792
  */
8789
8793
  export declare const NiceCardGroup: default_2.ForwardRefExoticComponent<NiceCardGroupProps & default_2.RefAttributes<HTMLDivElement>>;
8790
8794
 
8795
+ /** An item rendered by {@link NiceCardGroup} in data mode (consolidated from the former NiceCardView). */
8796
+ export declare interface NiceCardGroupItem {
8797
+ /** Unique key. */
8798
+ key: string;
8799
+ /** Additional data fields. */
8800
+ [field: string]: unknown;
8801
+ }
8802
+
8791
8803
  /**
8792
8804
  * Props for {@link NiceCardGroup} — a responsive grid container for cards (or any
8793
8805
  * tiles). By default it auto-fills as many `minColumnWidth`-wide columns as fit
8794
- * and wraps responsively; pass `columns` to pin an exact column count.
8806
+ * and wraps responsively; pass `columns` to pin an exact column count. Pass
8807
+ * `value`/`onChange` to make it a single-select **card radio group**: child
8808
+ * {@link NiceCard}s that carry a `value` become selectable and report selection.
8809
+ *
8810
+ * Provide `items` + `renderCard` to use **data mode** (the former NiceCardView):
8811
+ * the group renders each item through `renderCard`, with optional search and an
8812
+ * empty state.
8795
8813
  */
8796
8814
  export declare interface NiceCardGroupProps extends NiceStandardProps {
8797
- /** Cards / tiles to lay out. */
8798
- children: default_2.ReactNode;
8815
+ /** Cards / tiles to lay out (display / radio mode). */
8816
+ children?: default_2.ReactNode;
8817
+ /** Data items to render through `renderCard` (data mode). */
8818
+ items?: NiceCardGroupItem[];
8819
+ /** Custom card renderer for `items` (data mode). */
8820
+ renderCard?: (item: NiceCardGroupItem) => default_2.ReactNode;
8821
+ /** Show a search box above the grid (data mode). */
8822
+ searchable?: boolean;
8823
+ /** Item field searched when `searchable` is enabled (data mode). Default `text`. */
8824
+ searchField?: string;
8825
+ /** Search input placeholder (data mode). */
8826
+ searchPlaceholder?: string;
8827
+ /** Text shown when `items` is empty (data mode). */
8828
+ emptyText?: string;
8829
+ /** Called when a data-mode card is clicked. */
8830
+ onCardClick?: (item: NiceCardGroupItem) => void;
8831
+ /** Group size — scales the default gap (xs..xl) when `gap` is not set. */
8832
+ size?: NiceSize;
8799
8833
  /** Minimum column width (px) for the auto-fill grid. Default 240. */
8800
8834
  minColumnWidth?: number;
8801
8835
  /** Fixed column count — overrides `minColumnWidth` auto-fill when set. */
8802
8836
  columns?: number;
8803
- /** Gap between cards (px). Default 12. */
8837
+ /** Gap between cards (px). Defaults to a size-based value. */
8804
8838
  gap?: number;
8805
8839
  /** Vertical alignment of items within a row. */
8806
8840
  align?: 'stretch' | 'start' | 'center' | 'end';
8841
+ /** Selected value — enables single-select (radio) behaviour across child cards. */
8842
+ value?: NiceCardValue;
8843
+ /** Fired with the newly-selected card `value`. */
8844
+ onChange?: (value: NiceCardValue) => void;
8845
+ /** Radio group name applied to child cards (a11y). */
8846
+ name?: string;
8847
+ /** Disabled: dims the whole group + blocks selection. */
8848
+ disabled?: boolean;
8849
+ /** Read-only: blocks selection (radio mode) without dimming. */
8850
+ readOnly?: boolean;
8851
+ /** Loading: a spinner overlay + aria-busy. */
8852
+ loading?: boolean;
8853
+ /** Error state. A string is shown as the message; `true` shows `errorText`. */
8854
+ error?: string | boolean;
8855
+ /** Error message shown when `error` is boolean `true` (a string `error` wins). */
8856
+ errorText?: string;
8807
8857
  }
8808
8858
 
8809
8859
  /** Props for the {@link NiceCard} component — a bordered content container with optional header and footer. */
@@ -8827,75 +8877,30 @@ export declare interface NiceCardProps extends NiceBaseProps {
8827
8877
  /**
8828
8878
  * Make the card behave as a selectable option (radio): cursor/hover affordance,
8829
8879
  * `role="radio"` + `aria-checked`, keyboard select (Space/Enter). Inside a
8830
- * {@link NiceCardRadioGroup} this is implied for cards that carry a `value`.
8880
+ * {@link NiceCardGroup} this is implied for cards that carry a `value`.
8831
8881
  */
8832
8882
  selectable?: boolean;
8833
- /** Whether the card is currently selected (controlled; auto-wired inside a NiceCardRadioGroup). */
8883
+ /** Whether the card is currently selected (controlled; auto-wired inside a NiceCardGroup). */
8834
8884
  selected?: boolean;
8835
8885
  /** The option value bound to this card (used for selection + the group's onChange). */
8836
8886
  value?: NiceCardValue;
8837
8887
  /** Fired with `value` when the card is selected. */
8838
8888
  onSelect?: (value: NiceCardValue) => void;
8839
- /** Radio group name (auto-wired inside a NiceCardRadioGroup). */
8889
+ /** Radio group name (auto-wired inside a NiceCardGroup). */
8840
8890
  name?: string;
8841
- }
8842
-
8843
- /**
8844
- * {@link NiceCardRadioGroup} — wraps NiceCards into a single-select radio group:
8845
- * child cards that carry a `value` become selectable and report selection via
8846
- * `onChange` (the "binding + event on select"). Adds `role="radiogroup"`.
8847
- */
8848
- export declare const NiceCardRadioGroup: default_2.FC<NiceCardRadioGroupProps>;
8849
-
8850
- /** Props for {@link NiceCardRadioGroup} — coordinates single-selection across child NiceCards. */
8851
- export declare interface NiceCardRadioGroupProps extends NiceBaseProps {
8852
- /** Selected value (controlled). */
8853
- value?: NiceCardValue;
8854
- /** Fired with the newly-selected value. */
8855
- onChange?: (value: NiceCardValue) => void;
8856
- /** Radio group name applied to child cards. */
8857
- name?: string;
8858
- /** Child NiceCards (each with a `value`). */
8859
- children: default_2.ReactNode;
8891
+ /** Disabled: dimmed + non-interactive (blocks click/select). */
8892
+ disabled?: boolean;
8893
+ /** Read-only: inert (blocks selection) without the dimmed look. */
8894
+ readOnly?: boolean;
8895
+ /** Loading: a spinner overlay + `aria-busy`; interaction is blocked. */
8896
+ loading?: boolean;
8897
+ /** Error state — adds an error border; a non-empty string also renders a message. */
8898
+ error?: string | boolean;
8860
8899
  }
8861
8900
 
8862
8901
  /** Value type used by selectable cards / card radio groups. */
8863
8902
  export declare type NiceCardValue = string | number;
8864
8903
 
8865
- export declare function NiceCardView<T extends NiceCardViewItem>({ items, renderCard, columns, gap, searchable, searchField, searchPlaceholder, loading, emptyText, onCardClick, className, style, accessMode, id, }: NiceCardViewProps<T>): default_2.JSX.Element | null;
8866
-
8867
- /** An item displayed by the {@link NiceCardView} component. */
8868
- declare interface NiceCardViewItem {
8869
- /** Unique key. */
8870
- key: string;
8871
- /** Additional data fields. */
8872
- [field: string]: any;
8873
- }
8874
-
8875
- /** Props for the {@link NiceCardView} component — a responsive card grid with search and custom card rendering. */
8876
- export declare interface NiceCardViewProps<T extends NiceCardViewItem = NiceCardViewItem> extends NiceBaseProps {
8877
- /** Data items. */
8878
- items: T[];
8879
- /** Custom card renderer. */
8880
- renderCard: (item: T) => default_2.ReactNode;
8881
- /** Number of grid columns. */
8882
- columns?: number;
8883
- /** Gap between cards (px or CSS value). */
8884
- gap?: number | string;
8885
- /** Show a search box. */
8886
- searchable?: boolean;
8887
- /** Field searched when searchable is enabled. */
8888
- searchField?: string;
8889
- /** Search input placeholder. */
8890
- searchPlaceholder?: string;
8891
- /** Show a loading skeleton. */
8892
- loading?: boolean;
8893
- /** Text shown when items is empty. */
8894
- emptyText?: string;
8895
- /** Called when a card is clicked. */
8896
- onCardClick?: (item: T) => void;
8897
- }
8898
-
8899
8904
  export declare const NiceCarousel: default_2.ForwardRefExoticComponent<NiceCarouselProps & default_2.RefAttributes<HTMLDivElement>>;
8900
8905
 
8901
8906
  /** Props for the {@link NiceCarousel} component — a swipeable slide show with arrows, dots, and auto-play. */
@@ -8918,6 +8923,8 @@ export declare interface NiceCarouselProps extends NiceStandardProps {
8918
8923
  onChange?: (index: number) => void;
8919
8924
  /** Carousel size preset. */
8920
8925
  size?: NiceSize;
8926
+ /** Stretch to fill the container width (default: true). When false the carousel shrinks to its content. */
8927
+ fullWidth?: boolean;
8921
8928
  }
8922
8929
 
8923
8930
  /** Hierarchical option in a {@link NiceCascadeSelect} tree. */
@@ -9239,8 +9246,6 @@ export declare interface NiceCircularGaugeProps extends NiceStandardProps {
9239
9246
  }[];
9240
9247
  }
9241
9248
 
9242
- export declare const NiceClassicShell: ForwardRefExoticComponent<NiceShellProps & RefAttributes<HTMLDivElement>>;
9243
-
9244
9249
  /**
9245
9250
  * Component form of the `useClickOutside` hook — useful when you
9246
9251
  * already have a JSX tree and don't want to thread a ref through it.
@@ -9750,8 +9755,16 @@ export declare interface NiceColorPaletteProps extends NiceBaseProps {
9750
9755
  variationCount?: number;
9751
9756
  /** Label */
9752
9757
  label?: string;
9758
+ /** Label position relative to the swatch strip. Default `'top'`. */
9759
+ labelPlacement?: 'top' | 'left';
9753
9760
  /** Disabled state */
9754
9761
  disabled?: boolean;
9762
+ /** Looks enabled but the studio won't open and edits are blocked. */
9763
+ readOnly?: boolean;
9764
+ /** Show a loading spinner and dim the control. */
9765
+ loading?: boolean;
9766
+ /** Error ring; a string value also renders the message. */
9767
+ error?: string | boolean;
9755
9768
  /**
9756
9769
  * Target number of colors in the generated palette. Overrides the natural
9757
9770
  * count of the active harmony mode (clamped between `minColors` and
@@ -9973,17 +9986,6 @@ export declare interface NiceCommandPaletteProviderProps extends NiceCommandPale
9973
9986
  commands?: NiceCommand[];
9974
9987
  }
9975
9988
 
9976
- export declare const NiceCompactShell: ForwardRefExoticComponent<NiceCompactShellProps & RefAttributes<HTMLDivElement>>;
9977
-
9978
- export declare interface NiceCompactShellProps extends NiceBaseProps {
9979
- /** Top bar (minimal, icon-only navigation). */
9980
- topBar?: React.ReactNode;
9981
- /** Bottom navigation (mobile-style). */
9982
- bottomNav?: React.ReactNode;
9983
- /** Main content. */
9984
- children?: React.ReactNode;
9985
- }
9986
-
9987
9989
  /**
9988
9990
  * NiceComplianceDashboard — Compliance and certification dashboard.
9989
9991
  *
@@ -10603,19 +10605,6 @@ export declare const NiceCountdown: default_2.FC<NiceCountdownProps>;
10603
10605
 
10604
10606
  export declare type NiceCountdownFormat = 'full' | 'compact' | 'minimal';
10605
10607
 
10606
- /** Built-in countdown format presets. */
10607
- declare type NiceCountdownFormat_2 =
10608
- /** `1d 02:34:15` / `02:34:15` — leading day count + clock */
10609
- 'verbose'
10610
- /** `1d 2h 34m 15s` — abbreviated units */
10611
- | 'compact'
10612
- /** `2:34:15` / `34:15` — pure clock */
10613
- | 'short'
10614
- /** `in 2h` / `in 5m` / `in 30s` — single coarsest unit */
10615
- | 'minimal'
10616
- /** `1 day, 2 hours, 34 minutes` — verbose words */
10617
- | 'words';
10618
-
10619
10608
  /** Optional label overrides for the four time units. */
10620
10609
  export declare interface NiceCountdownLabels {
10621
10610
  days?: string;
@@ -10820,39 +10809,6 @@ declare interface NiceCSVOptions extends NiceExportOptions {
10820
10809
  encoding?: 'utf-8' | 'utf-16' | 'iso-8859-1';
10821
10810
  }
10822
10811
 
10823
- /**
10824
- * {@link NiceCurrencyInput} — Amount input with currency selector, locale-aware formatting.
10825
- */
10826
- export declare const NiceCurrencyInput: default_2.ForwardRefExoticComponent<NiceCurrencyInputProps & default_2.RefAttributes<HTMLDivElement>>;
10827
-
10828
- /** Props for the {@link NiceCurrencyInput} component. */
10829
- export declare interface NiceCurrencyInputProps extends NiceFormFieldProps {
10830
- /** Controlled numeric amount (minor unit or major, based on `useMinorUnit`). */
10831
- value?: number | null;
10832
- /** Fires on amount change. */
10833
- onChange?: (value: number | null) => void;
10834
- /** Selected currency code (ISO 4217). */
10835
- currency?: string;
10836
- /** Fires when user changes currency. */
10837
- onCurrencyChange?: (code: string) => void;
10838
- /** Available currencies. */
10839
- currencies?: CurrencyDef[];
10840
- /** Whether to store value in minor units (cents). Default `false`. */
10841
- useMinorUnit?: boolean;
10842
- /** Minimum value. */
10843
- min?: number;
10844
- /** Maximum value. */
10845
- max?: number;
10846
- /** Override locale for formatting (e.g. "pl-PL"). */
10847
- locale?: string;
10848
- /** Placeholder text. */
10849
- placeholder?: string;
10850
- /** Whether to show currency selector (default `true` if currencies provided). */
10851
- showCurrencySelector?: boolean;
10852
- /** Fires on blur with the input event. */
10853
- onBlur?: (e: default_2.FocusEvent<HTMLInputElement>) => void;
10854
- }
10855
-
10856
10812
  export { NiceCursorLoadOptions }
10857
10813
 
10858
10814
  export { NiceCursorPage }
@@ -11000,7 +10956,7 @@ export declare interface NiceDataDiffViewerProps extends NiceBaseProps {
11000
10956
  onSelectRecord?: (table: string, recordId: string) => void;
11001
10957
  }
11002
10958
 
11003
- export declare function NiceDataGrid<T extends Record<string, any>>({ columns, data: dataProp, keyField, dataSource, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, showAdvancedFilter, advancedFilter, onAdvancedFilterChange, filterFields, filterPresets, onSaveFilterPreset, onDeleteFilterPreset, selectable, selectedKeys: controlledSelected, onSelectionChange, pagination, pageSize: initPageSize, page: controlledPage, onPageChange, totalRows, autoPagination, stickyHeader, stickyFooter, 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>): default_2.JSX.Element | null;
10959
+ export declare function NiceDataGrid<T extends Record<string, any>>({ columns, data: dataProp, keyField, dataSource, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, showAdvancedFilter, advancedFilter, onAdvancedFilterChange, filterFields, filterPresets, onSaveFilterPreset, onDeleteFilterPreset, selectable, selectedKeys: controlledSelected, onSelectionChange, pagination, pageSize: initPageSize, page: controlledPage, onPageChange, totalRows, autoPagination, stickyHeader, stickyFooter, 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, size, 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, disabled: disabledProp, readOnly: readOnlyProp, error, }: NiceDataGridProps<T>): default_2.JSX.Element | null;
11004
10960
 
11005
10961
  export declare namespace NiceDataGrid {
11006
10962
  var displayName: string;
@@ -11206,7 +11162,19 @@ export declare interface NiceDataGridProps<T extends Record<string, any> = any>
11206
11162
  onRowReorder?: (fromIndex: number, toIndex: number) => void;
11207
11163
  striped?: boolean;
11208
11164
  compact?: boolean;
11165
+ /**
11166
+ * Visual density of the grid rows (cell padding + font size). Maps to the
11167
+ * `nice-table--{size}` scale. Independent of `compact` (which is tighter than
11168
+ * the smallest size). Default `md`.
11169
+ */
11170
+ size?: NiceSize;
11209
11171
  loading?: boolean;
11172
+ /** Disable the whole grid — dimmed and inert. */
11173
+ disabled?: boolean;
11174
+ /** Read-only: blocks inline editing (not dimmed). */
11175
+ readOnly?: boolean;
11176
+ /** Error message shown above the grid body. */
11177
+ error?: string;
11210
11178
  emptyText?: string;
11211
11179
  toolbar?: React.ReactNode;
11212
11180
  onRowClick?: (row: T) => void;
@@ -11381,10 +11349,61 @@ export { NiceDataSourceState }
11381
11349
  /** Predefined date-format presets. */
11382
11350
  declare type NiceDateFormatPreset = 'date-local' | 'date-utc' | 'datetime-local' | 'datetime-utc' | 'month-local' | 'month-utc' | 'week' | 'time';
11383
11351
 
11384
- export declare const NiceDatePicker: default_2.ForwardRefExoticComponent<NiceDatePickerProps & default_2.RefAttributes<HTMLInputElement>>;
11352
+ export declare const NiceDateRangeBox: default_2.FC<NiceDateRangeBoxProps>;
11353
+
11354
+ /** Props for the {@link NiceDateRangeBox} component — a pair of date pickers for selecting a date range. */
11355
+ export declare interface NiceDateRangeBoxProps extends NiceFormFieldProps {
11356
+ /** Start date (ISO string). */
11357
+ startDate: string;
11358
+ /** End date (ISO string). */
11359
+ endDate: string;
11360
+ /** Called when the start date changes. */
11361
+ onStartChange: (date: string) => void;
11362
+ /** Called when the end date changes. */
11363
+ onEndChange: (date: string) => void;
11364
+ /** Earliest selectable date. */
11365
+ min?: string;
11366
+ /** Latest selectable date. */
11367
+ max?: string;
11368
+ /** Show a clear button. */
11369
+ clearable?: boolean;
11370
+ /** Placeholder for the start input. */
11371
+ startPlaceholder?: string;
11372
+ /** Placeholder for the end input. */
11373
+ endPlaceholder?: string;
11374
+ /** Label shown above (or before) the start picker. */
11375
+ startLabel?: string;
11376
+ /** Label shown above (or before) the end picker. */
11377
+ endLabel?: string;
11378
+ /** Layout direction for the two pickers (default `horizontal`). */
11379
+ layout?: 'horizontal' | 'vertical';
11380
+ /** Custom separator rendered between pickers in horizontal layout (default `–`). Pass `''` to hide. */
11381
+ separator?: default_2.ReactNode;
11382
+ /** Gap in pixels between the two pickers (default 12). */
11383
+ gap?: number;
11384
+ /** Stretch each picker to fill available width. */
11385
+ fullWidth?: boolean;
11386
+ /**
11387
+ * Format preset forwarded to BOTH inner pickers — so a range can be
11388
+ * date, datetime (`'datetime-local'`), month, week or time, not just date.
11389
+ */
11390
+ dateFormatPreset?: NiceDateFormatPreset;
11391
+ /**
11392
+ * @deprecated Use `dateFormatPreset`. Native input type forwarded to both
11393
+ * inner pickers.
11394
+ */
11395
+ type?: 'date' | 'datetime-local' | 'time' | 'month' | 'week';
11396
+ }
11397
+
11398
+ /** Built-in countdown format presets (merged in from NiceTimePicker).
11399
+ * NOTE: deliberately NOT named `NiceCountdownFormat` — that name is already a
11400
+ * public export of the unrelated `NiceCountdown` display component. */
11401
+ declare type NiceDateTimeCountdownFormat = 'verbose' | 'compact' | 'short' | 'minimal' | 'words';
11385
11402
 
11386
- /** Props for the {@link NiceDatePicker} component — a masked, locale-aware date/time input. */
11387
- export declare interface NiceDatePickerProps extends NiceFormFieldProps {
11403
+ export declare const NiceDateTimePicker: default_2.ForwardRefExoticComponent<NiceDateTimePickerProps & default_2.RefAttributes<HTMLInputElement>>;
11404
+
11405
+ /** Props for the {@link NiceDateTimePicker} component — a masked, locale-aware date/time input. */
11406
+ export declare interface NiceDateTimePickerProps extends NiceFormFieldProps {
11388
11407
  /** ISO value (e.g. `'2024-06-15'`). Always ISO regardless of display locale. */
11389
11408
  value?: string;
11390
11409
  /** Fires with the new ISO value. Empty string while the input is incomplete. */
@@ -11428,66 +11447,44 @@ export declare interface NiceDatePickerProps extends NiceFormFieldProps {
11428
11447
  * Only fires for date / datetime / month presets.
11429
11448
  */
11430
11449
  keyboardShortcuts?: boolean;
11431
- }
11432
-
11433
- export declare const NiceDateRangeBox: default_2.FC<NiceDateRangeBoxProps>;
11434
-
11435
- /** Props for the {@link NiceDateRangeBox} component — a pair of date pickers for selecting a date range. */
11436
- export declare interface NiceDateRangeBoxProps extends NiceFormFieldProps {
11437
- /** Start date (ISO string). */
11438
- startDate: string;
11439
- /** End date (ISO string). */
11440
- endDate: string;
11441
- /** Called when the start date changes. */
11442
- onStartChange: (date: string) => void;
11443
- /** Called when the end date changes. */
11444
- onEndChange: (date: string) => void;
11445
- /** Earliest selectable date. */
11446
- min?: string;
11447
- /** Latest selectable date. */
11448
- max?: string;
11449
- /** Show a clear button. */
11450
- clearable?: boolean;
11451
- /** Placeholder for the start input. */
11452
- startPlaceholder?: string;
11453
- /** Placeholder for the end input. */
11454
- endPlaceholder?: string;
11455
- /** Label shown above (or before) the start picker. */
11456
- startLabel?: string;
11457
- /** Label shown above (or before) the end picker. */
11458
- endLabel?: string;
11459
- /** Layout direction for the two pickers (default `horizontal`). */
11460
- layout?: 'horizontal' | 'vertical';
11461
- /** Custom separator rendered between pickers in horizontal layout (default `–`). Pass `''` to hide. */
11462
- separator?: default_2.ReactNode;
11463
- /** Gap in pixels between the two pickers (default 12). */
11464
- gap?: number;
11465
- /** Stretch each picker to fill available width. */
11466
- fullWidth?: boolean;
11467
- }
11468
-
11469
- export declare const NiceDateTimePicker: default_2.ForwardRefExoticComponent<NiceDateTimePickerProps & default_2.RefAttributes<HTMLDivElement>>;
11470
-
11471
- /** Props for the {@link NiceDateTimePicker} component — a combined date and time picker with calendar dropdown. */
11472
- export declare interface NiceDateTimePickerProps extends NiceFormFieldProps {
11473
- /** ISO 8601 date-time string (e.g. "2026-03-16T14:30") */
11474
- value?: string;
11475
- onChange?: (value: string) => void;
11476
- onBlur?: (e: default_2.FocusEvent) => void;
11477
- /** Minimum allowed date-time (ISO string) */
11478
- min?: string;
11479
- /** Maximum allowed date-time (ISO string) */
11480
- max?: string;
11481
- /** Display format — 12h shows AM/PM toggle, 24h shows 0–23 */
11482
- hourFormat?: '12' | '24';
11483
- /** Minute increment step */
11484
- minuteStep?: number;
11485
- /** Show seconds input */
11450
+ /** Datetime/time: show a seconds section (`HH:mm:ss`). Default: `false`. */
11486
11451
  showSeconds?: boolean;
11487
- /** Show "Now" quick button */
11452
+ /**
11453
+ * Datetime/time: minute increment. Drives the native picker companion `step`
11454
+ * AND the ↑/↓ arrow stepping in the masked field.
11455
+ */
11456
+ minuteStep?: number;
11457
+ /**
11458
+ * Datetime/time: `'12'` renders an AM/PM toggle beside the field (and asks the
11459
+ * native picker for a 12-hour dialog where the OS locale supports it). The
11460
+ * masked field always edits 24-hour digits and the emitted value stays ISO 24h.
11461
+ */
11462
+ hourFormat?: '12' | '24';
11463
+ /**
11464
+ * Datetime/time/date: show a "Now" button that fills the current date/time.
11465
+ * Default: `false`.
11466
+ */
11488
11467
  showNow?: boolean;
11489
- /** Show clear button */
11490
- clearable?: boolean;
11468
+ /**
11469
+ * Explicit target date to combine with the picked time (`Date` or
11470
+ * `YYYY-MM-DD`). When omitted while {@link countdown} is on, the target
11471
+ * auto-resolves to the next occurrence (today, else tomorrow).
11472
+ */
11473
+ targetDate?: string | Date;
11474
+ /** Fires whenever the resolved countdown target changes. */
11475
+ onTargetChange?: (target: Date) => void;
11476
+ /** Show a live countdown label beside the field. */
11477
+ countdown?: boolean;
11478
+ /** Built-in countdown format preset (default `'verbose'`). */
11479
+ countdownFormat?: NiceDateTimeCountdownFormat;
11480
+ /** Custom countdown formatter (overrides {@link countdownFormat}). */
11481
+ formatCountdown?: (msRemaining: number, target: Date) => string;
11482
+ /** Label rendered before the countdown text (e.g. `'starts in'`). */
11483
+ countdownLabel?: default_2.ReactNode;
11484
+ /** Countdown tick interval in ms (default 1000, min 100). */
11485
+ countdownInterval?: number;
11486
+ /** Text shown once the countdown reaches zero. */
11487
+ countdownDoneText?: string;
11491
11488
  }
11492
11489
 
11493
11490
  export { NiceDensity }
@@ -12256,18 +12253,6 @@ export declare interface NiceDropDownButtonProps extends NiceBaseProps {
12256
12253
  errorPlacement?: 'bottom' | 'right';
12257
12254
  }
12258
12255
 
12259
- export declare const NiceDropZone: default_2.FC<NiceDropZoneProps>;
12260
-
12261
- export declare interface NiceDropZoneProps extends NiceBaseProps {
12262
- onFiles: (files: File[]) => void;
12263
- accept?: string;
12264
- multiple?: boolean;
12265
- disabled?: boolean;
12266
- children?: default_2.ReactNode;
12267
- dropzoneText?: string;
12268
- dragActiveText?: string;
12269
- }
12270
-
12271
12256
  export declare const NiceDynamicSidebar: ForwardRefExoticComponent<NiceDynamicSidebarProps & RefAttributes<HTMLElement>>;
12272
12257
 
12273
12258
  export declare interface NiceDynamicSidebarProps extends NiceBaseProps {
@@ -12874,16 +12859,6 @@ export declare type NiceFilePanel = 'left' | 'right';
12874
12859
  */
12875
12860
  export declare const NiceFilePicker: default_2.FC<NiceFilePickerProps>;
12876
12861
 
12877
- export declare const NiceFilePickerButton: default_2.FC<NiceFilePickerButtonProps>;
12878
-
12879
- export declare interface NiceFilePickerButtonProps extends NiceBaseProps {
12880
- onFiles: (files: File[]) => void;
12881
- accept?: string;
12882
- multiple?: boolean;
12883
- disabled?: boolean;
12884
- children?: default_2.ReactNode;
12885
- }
12886
-
12887
12862
  /** Props for {@link NiceFilePicker} — visually-customisable file input. */
12888
12863
  export declare interface NiceFilePickerProps extends NiceStandardProps {
12889
12864
  /** MIME types / extensions accepted (e.g. `"image/*,.pdf"`). */
@@ -12920,101 +12895,6 @@ export declare type NiceFileSortDir = 'asc' | 'desc';
12920
12895
  /** Sortable field for the {@link NiceFileManager} detail view. */
12921
12896
  export declare type NiceFileSortField = 'name' | 'size' | 'modified' | 'extension';
12922
12897
 
12923
- export declare const NiceFileUpload: default_2.ForwardRefExoticComponent<NiceFileUploadProps & default_2.RefAttributes<NiceFileUploadRef>>;
12924
-
12925
- /**
12926
- * @deprecated Use {@link NiceUpload}. The legacy alias is preserved to avoid
12927
- * breaking existing imports; remove in a future major release.
12928
- */
12929
- export declare const NiceFileUploader: default_2.ForwardRefExoticComponent<NiceUploadProps & default_2.RefAttributes<HTMLDivElement>>;
12930
-
12931
- /**
12932
- * @deprecated Use {@link NiceUploadProps}.
12933
- */
12934
- export declare type NiceFileUploaderProps = NiceUploadProps;
12935
-
12936
- export declare interface NiceFileUploadProps extends NiceBaseProps {
12937
- /** Akceptowane typy plików (np. "image/*,.pdf") */
12938
- accept?: string;
12939
- /** Czy pozwalać na multiple files */
12940
- multiple?: boolean;
12941
- /** Maksymalny rozmiar pliku w bajtach */
12942
- maxFileSize?: number;
12943
- /** Maksymalna liczba plików */
12944
- maxFiles?: number;
12945
- /** Minimalny rozmiar pliku */
12946
- minFileSize?: number;
12947
- /** Rozmiar chunka dla dużych plików (domyślnie 5MB) */
12948
- chunkSize?: number;
12949
- /** Próg rozmiaru pliku dla chunked upload (domyślnie 10MB) */
12950
- chunkThreshold?: number;
12951
- /** Automatycznie rozpocznij upload po dodaniu */
12952
- autoUpload?: boolean;
12953
- /** Handler uploadu */
12954
- uploadHandler?: UploadHandler;
12955
- /** URL do uploadu (jeśli nie podano uploadHandler) */
12956
- uploadUrl?: string;
12957
- /** Nagłówki HTTP dla uploadu */
12958
- uploadHeaders?: Record<string, string>;
12959
- /** Callback po dodaniu plików */
12960
- onFilesAdded?: (files: FileInfo[]) => void;
12961
- /** Callback po zakończeniu uploadu */
12962
- onUploadComplete?: (file: FileInfo) => void;
12963
- /** Callback po błędzie */
12964
- onUploadError?: (file: FileInfo, error: string) => void;
12965
- /** Callback na postęp */
12966
- onProgress?: (file: FileInfo, progress: number) => void;
12967
- /** Callback po usunięciu */
12968
- onFileRemoved?: (file: FileInfo) => void;
12969
- /** Callback po zmianie stanu */
12970
- onChange?: (files: FileInfo[]) => void;
12971
- /** Niestandardowy renderer podglądu */
12972
- renderPreview?: (file: FileInfo) => default_2.ReactNode;
12973
- /** Niestandardowy renderer elementu listy */
12974
- renderFileItem?: (file: FileInfo, actions: FileItemActions) => default_2.ReactNode;
12975
- /** Pokaż podgląd obrazów */
12976
- showPreview?: boolean;
12977
- /** Pokaż listę plików */
12978
- showFileList?: boolean;
12979
- /** Tryb wyświetlania listy */
12980
- listMode?: 'list' | 'grid' | 'compact';
12981
- /** Rozmiar podglądu */
12982
- previewSize?: NiceSize;
12983
- /** Tekst w dropzone */
12984
- dropzoneText?: string;
12985
- /** Tekst pod przyciskiem */
12986
- browseText?: string;
12987
- /** Tekst podczas dragover */
12988
- dragActiveText?: string;
12989
- /** Wyłączony */
12990
- disabled?: boolean;
12991
- /** Read-only (tylko podgląd) */
12992
- readOnly?: boolean;
12993
- /** Customowe klasy CSS */
12994
- dropzoneClassName?: string;
12995
- /** Retry count */
12996
- maxRetries?: number;
12997
- /** Ilość równoczesnych uploadów */
12998
- concurrentUploads?: number;
12999
- /** Walidator plików */
13000
- validateFile?: (file: File) => string | null;
13001
- /** Zachowaj pliki po uploadzięciu */
13002
- keepFilesAfterUpload?: boolean;
13003
- /** Początkowe pliki */
13004
- initialFiles?: FileInfo[];
13005
- }
13006
-
13007
- export declare interface NiceFileUploadRef {
13008
- addFiles: (files: File[]) => void;
13009
- uploadAll: () => void;
13010
- cancelAll: () => void;
13011
- clearAll: () => void;
13012
- getFiles: () => FileInfo[];
13013
- getFile: (id: string) => FileInfo | undefined;
13014
- retryFailed: () => void;
13015
- openFileBrowser: () => void;
13016
- }
13017
-
13018
12898
  export declare const NiceFilterBuilder: default_2.FC<NiceFilterBuilderProps>;
13019
12899
 
13020
12900
  /** Props for the {@link NiceFilterBuilder} component — a visual query builder for complex AND/OR filter trees. */
@@ -13454,6 +13334,12 @@ export declare interface NiceGalleryProps extends NiceStandardProps {
13454
13334
  height?: number | string;
13455
13335
  /** Number of thumbnails visible in the strip carousel window (default 4). */
13456
13336
  thumbnailWindow?: number;
13337
+ /**
13338
+ * Background colour of the letterbox/pillarbox bars shown behind an image
13339
+ * whose aspect ratio doesn't fill the frame. Defaults to the theme background
13340
+ * when omitted.
13341
+ */
13342
+ frameColor?: string;
13457
13343
  }
13458
13344
 
13459
13345
  export declare const NiceGamepad: default_2.FC<NiceGamepadProps>;
@@ -13768,8 +13654,16 @@ export declare interface NiceGradientPickerProps extends NiceBaseProps {
13768
13654
  /** Maximum number of gradient stops */
13769
13655
  maxStops?: number;
13770
13656
  label?: string;
13657
+ /** Label position relative to the swatch. Default `'top'`. */
13658
+ labelPlacement?: 'top' | 'left';
13771
13659
  disabled?: boolean;
13772
- /** Fixed width of the whole control. Defaults to 320px so the layout stays stable when stops are added. */
13660
+ /** Looks enabled but the popup won't open and edits are blocked. */
13661
+ readOnly?: boolean;
13662
+ /** Show a loading spinner and dim the control. */
13663
+ loading?: boolean;
13664
+ /** Error ring; a string value also renders the message. */
13665
+ error?: string | boolean;
13666
+ /** Fixed width of the popup. Defaults to 340px. */
13773
13667
  width?: string | number;
13774
13668
  }
13775
13669
 
@@ -14101,26 +13995,6 @@ export { NiceI18nProvider }
14101
13995
 
14102
13996
  export { NiceIcon }
14103
13997
 
14104
- export declare const NiceIconButton: default_2.ForwardRefExoticComponent<NiceIconButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
14105
-
14106
- /** Props for the {@link NiceIconButton} component — a compact icon-only button. */
14107
- export declare interface NiceIconButtonProps extends NiceBaseProps {
14108
- /** Icon element to render inside the button. */
14109
- icon: default_2.ReactNode;
14110
- /** Accessible label text (alias for aria-label). */
14111
- label?: string;
14112
- /** Button size. */
14113
- size?: NiceSize;
14114
- /** Click handler. */
14115
- onClick?: (e: default_2.MouseEvent<HTMLButtonElement>) => void;
14116
- /** Disables the button. */
14117
- disabled?: boolean;
14118
- /** Accessible label (required — icon-only buttons need a text description). */
14119
- 'aria-label': string;
14120
- /** Visual variant. */
14121
- variant?: NiceVariant;
14122
- }
14123
-
14124
13998
  export { NiceIconProps }
14125
13999
 
14126
14000
  export { NiceIconProvider }
@@ -14257,32 +14131,6 @@ export declare interface NiceImageEditorState {
14257
14131
  /** Available tools in the {@link NiceImageEditor} toolbar. */
14258
14132
  export declare type NiceImageEditorTool = 'crop' | 'rotate' | 'flip' | 'brightness' | 'contrast' | 'saturate' | 'blur' | 'annotate';
14259
14133
 
14260
- export declare const NiceImageViewer: default_2.ForwardRefExoticComponent<NiceImageViewerProps & default_2.RefAttributes<HTMLDivElement>>;
14261
-
14262
- /** Props for the {@link NiceImageViewer} component — an image with lightbox preview, zoom, pan, and rotation. */
14263
- export declare interface NiceImageViewerProps extends NiceStandardProps {
14264
- /** Image source URL. */
14265
- src: string;
14266
- /** Alt text. */
14267
- alt?: string;
14268
- /** Viewer layout size (minimal / compact / standard / fullscreen). */
14269
- editorSize?: NiceEditorSize;
14270
- /** Enable click-to-open lightbox preview (default true). */
14271
- preview?: boolean;
14272
- /** Allow rotation in the lightbox. */
14273
- rotatable?: boolean;
14274
- /** Allow zoom in the lightbox. */
14275
- zoomable?: boolean;
14276
- /** Minimum zoom level. */
14277
- minZoom?: number;
14278
- /** Maximum zoom level. */
14279
- maxZoom?: number;
14280
- /** Thumbnail width. */
14281
- width?: number | string;
14282
- /** Thumbnail height. */
14283
- height?: number | string;
14284
- }
14285
-
14286
14134
  /**
14287
14135
  * {@link NiceInbox} — Full-featured email inbox with reading pane, compose, folders,
14288
14136
  * batch actions, sorting, search, and keyboard navigation.
@@ -15056,6 +14904,14 @@ export declare interface NiceListProps extends NiceBaseProps {
15056
14904
  emptyText?: string;
15057
14905
  /** Size preset. */
15058
14906
  size?: NiceSize;
14907
+ /** Optional header shown above the list; stays visible during loading. */
14908
+ header?: default_2.ReactNode;
14909
+ /** Disable the whole list — dimmed and inert. */
14910
+ disabled?: boolean;
14911
+ /** Read-only: items are non-interactive but not dimmed. */
14912
+ readOnly?: boolean;
14913
+ /** Error message shown in place of the list. */
14914
+ error?: string;
15059
14915
  /** Show border around the list. */
15060
14916
  bordered?: boolean;
15061
14917
  /** Swipe actions revealed on mobile swipe gesture. */
@@ -15596,6 +15452,8 @@ export declare interface NiceLookupProps extends NiceFormFieldProps {
15596
15452
  displayField?: string;
15597
15453
  /** Width of the dropdown when in mini-grid mode (CSS). */
15598
15454
  dropdownWidth?: string | number;
15455
+ /** Gap (px) between the input and the dropdown menu. Default 0 (menu abuts the input). */
15456
+ menuGap?: number;
15599
15457
  }
15600
15458
 
15601
15459
  export { NiceLookupSourceState }
@@ -16041,6 +15899,8 @@ export declare interface NiceMenuProps extends NiceBaseProps {
16041
15899
  density?: NiceMenuDensity;
16042
15900
  /** Size preset. */
16043
15901
  size?: NiceSize;
15902
+ /** Loading: dims the bar, shows a spinner and blocks interaction. */
15903
+ loading?: boolean;
16044
15904
  /** Stretch top-level items to fill the container. */
16045
15905
  fullWidth?: boolean;
16046
15906
  /** Show vertical separators between top items. */
@@ -16634,43 +16494,6 @@ export declare interface NiceModuleRouteProps {
16634
16494
 
16635
16495
  export { NiceModuleStatus }
16636
16496
 
16637
- export declare const NiceMultiView: default_2.FC<NiceMultiViewProps>;
16638
-
16639
- /** A view entry in the {@link NiceMultiView}. */
16640
- declare interface NiceMultiViewItem {
16641
- /** Unique key. */
16642
- key: string;
16643
- /** Optional label shown in tabs / header. */
16644
- label?: string;
16645
- /** Optional icon shown in tabs / header. */
16646
- icon?: string;
16647
- /** Content renderer. */
16648
- render: () => default_2.ReactNode;
16649
- }
16650
-
16651
- /** Navigation style for the NiceMultiView. */
16652
- declare type NiceMultiViewNav = 'tabs' | 'dots' | 'arrows' | 'none';
16653
-
16654
- /** Props for the {@link NiceMultiView} component. */
16655
- export declare interface NiceMultiViewProps extends NiceBaseProps {
16656
- /** Size variant. */
16657
- size?: NiceSize;
16658
- /** View definitions. */
16659
- items: NiceMultiViewItem[];
16660
- /** Currently visible view index (controlled). */
16661
- selectedIndex?: number;
16662
- /** Called when the visible index changes. */
16663
- onSelectedIndexChange?: (index: number) => void;
16664
- /** Enable slide transition animation (default: true). */
16665
- animationEnabled?: boolean;
16666
- /** Navigation style (default: 'tabs'). */
16667
- nav?: NiceMultiViewNav;
16668
- /** Show prev/next arrows alongside any nav style (default: true for 'dots' / 'none'). */
16669
- showArrows?: boolean;
16670
- /** Auto-cycle interval in ms (0 = disabled). */
16671
- autoPlay?: number;
16672
- }
16673
-
16674
16497
  /**
16675
16498
  * {@link NiceNavbar} — Top navigation bar with logo, breadcrumbs, centre content,
16676
16499
  * and right-side slots for tenant switcher, notifications, and user menu.
@@ -17263,6 +17086,8 @@ export declare interface NiceNumberInputProps extends NiceFormFieldProps {
17263
17086
  suffixValue?: string;
17264
17087
  /** Called when the suffix select changes. */
17265
17088
  onSuffixChange?: (value: string, prevWeight: number | undefined, newWeight: number | undefined) => void;
17089
+ /** Show a divider line between the value and the suffix. Default `false`. */
17090
+ suffixSeparator?: boolean;
17266
17091
  }
17267
17092
 
17268
17093
  /**
@@ -17327,35 +17152,6 @@ export { NiceOnboardingAnswer }
17327
17152
 
17328
17153
  export { NiceOnboardingQuestion }
17329
17154
 
17330
- export declare const NiceOnboardingWizard: ForwardRefExoticComponent<NiceOnboardingWizardProps & RefAttributes<HTMLDivElement>>;
17331
-
17332
- export declare interface NiceOnboardingWizardProps extends NiceBaseProps {
17333
- /** Size variant. */
17334
- size?: NiceSize;
17335
- /** All onboarding questions. */
17336
- questions: NiceOnboardingQuestion[];
17337
- /** Pre-filled answers. */
17338
- initialAnswers?: NiceOnboardingAnswer[];
17339
- /** Step labels (if different from category names). */
17340
- stepLabels?: string[];
17341
- /** Called when user submits final answers. */
17342
- onComplete?: (answers: NiceOnboardingAnswer[]) => void;
17343
- /** Called when user leaves the wizard without finishing. */
17344
- onCancel?: () => void;
17345
- /** Called on each step transition. */
17346
- onStepChange?: (step: number) => void;
17347
- /** Welcome screen content (shown before step 1). */
17348
- welcomeContent?: React.ReactNode;
17349
- /** Completion screen content (shown after last step). */
17350
- completionContent?: React.ReactNode;
17351
- /** Show progress bar. */
17352
- showProgress?: boolean;
17353
- /** Allow going back to previous steps. */
17354
- allowBack?: boolean;
17355
- /** Logo / branding element for the wizard header. */
17356
- logo?: React.ReactNode;
17357
- }
17358
-
17359
17155
  export { NiceOnChange }
17360
17156
 
17361
17157
  export { NiceOnOpenChange }
@@ -17576,9 +17372,15 @@ export declare interface NicePaginationProps extends NiceBaseProps {
17576
17372
  totalPages: number;
17577
17373
  /** Called when the page changes. */
17578
17374
  onChange: (page: number) => void;
17579
- /** Show "Page X of Y" info text. */
17375
+ /**
17376
+ * Show "Page X of Y" info text.
17377
+ * @default true
17378
+ */
17580
17379
  showInfo?: boolean;
17581
- /** Number of page buttons shown on each side of the current page. */
17380
+ /**
17381
+ * Number of page buttons shown on each side of the current page.
17382
+ * @default 2
17383
+ */
17582
17384
  siblingCount?: number;
17583
17385
  /** Show ⏮ / ⏭ first/last page buttons. */
17584
17386
  showFirstLast?: boolean;
@@ -17748,6 +17550,10 @@ export declare interface NicePDFViewerProps extends NiceStandardProps {
17748
17550
  maxZoom?: number;
17749
17551
  /** Viewer viewport height. */
17750
17552
  height?: number | string;
17553
+ /** Aspect ratio of the page area (CSS `aspect-ratio`). Default `'210 / 297'` (A4 portrait). */
17554
+ aspectRatio?: string;
17555
+ /** How the page fits the frame. `'page'` (default) shows the whole page at zoom 100. */
17556
+ fit?: 'width' | 'height' | 'page' | 'none';
17751
17557
  /** Called when the current page changes. */
17752
17558
  onPageChange?: (page: number) => void;
17753
17559
  /** Called when zoom level changes. */
@@ -17803,31 +17609,6 @@ export declare interface NicePermissionMatrixProps {
17803
17609
  id?: string;
17804
17610
  }
17805
17611
 
17806
- /**
17807
- * {@link NicePhoneInput} — Phone number input with country code selector, masking, and E.164 formatting.
17808
- */
17809
- export declare const NicePhoneInput: default_2.ForwardRefExoticComponent<NicePhoneInputProps & default_2.RefAttributes<HTMLDivElement>>;
17810
-
17811
- /** Props for the {@link NicePhoneInput} component. */
17812
- export declare interface NicePhoneInputProps extends NiceFormFieldProps {
17813
- /** Controlled phone value. */
17814
- value?: PhoneValue;
17815
- /** Fires on value change with parsed phone value. */
17816
- onChange?: (value: PhoneValue) => void;
17817
- /** Available country codes. */
17818
- countryCodes?: PhoneCountryCode[];
17819
- /** Default country code (ISO alpha-2, e.g. "PL"). */
17820
- defaultCountry?: string;
17821
- /** Placeholder for the number part. */
17822
- placeholder?: string;
17823
- /** Whether to show the country flag emoji. */
17824
- showFlag?: boolean;
17825
- /** Whether to validate as E.164 on blur. */
17826
- validateE164?: boolean;
17827
- /** Fires with the raw input event. */
17828
- onBlur?: (e: default_2.FocusEvent<HTMLInputElement>) => void;
17829
- }
17830
-
17831
17612
  export declare const NicePickList: <T = unknown>(props: NicePickListProps<T> & default_2.RefAttributes<HTMLDivElement>) => default_2.ReactElement | null;
17832
17613
 
17833
17614
  /** Props for the {@link NicePickList} component — a dual-list control for moving items between source and target. */
@@ -17900,34 +17681,6 @@ export declare interface NicePieSlice {
17900
17681
  color?: string;
17901
17682
  }
17902
17683
 
17903
- /**
17904
- * {@link NicePinCodeInput} — PIN code entry with individual digit boxes,
17905
- * optional numeric keypad, masking, and auto-submit.
17906
- */
17907
- export declare const NicePinCodeInput: default_2.ForwardRefExoticComponent<NicePinCodeInputProps & default_2.RefAttributes<HTMLDivElement>>;
17908
-
17909
- /** Props for the {@link NicePinCodeInput} component. */
17910
- export declare interface NicePinCodeInputProps extends NiceFormFieldProps {
17911
- /** Current PIN value. */
17912
- value?: string;
17913
- /** Fires when value changes. */
17914
- onChange?: (value: string) => void;
17915
- /** Fires when PIN is fully entered. */
17916
- onComplete?: (pin: string) => void;
17917
- /** Number of PIN digits. */
17918
- length?: number;
17919
- /** Whether to mask digits (show dots). */
17920
- masked?: boolean;
17921
- /** Whether to show a numeric keypad below the input. */
17922
- showKeypad?: boolean;
17923
- /** Whether to auto-submit when all digits are filled. */
17924
- autoSubmit?: boolean;
17925
- /** Error shake animation trigger (toggle to replay). */
17926
- shake?: boolean;
17927
- /** Placeholder character. */
17928
- placeholderChar?: string;
17929
- }
17930
-
17931
17684
  export declare const NicePipelineEditor: default_2.FC<NicePipelineEditorProps>;
17932
17685
 
17933
17686
  export declare interface NicePipelineEditorProps extends NiceBaseProps {
@@ -18439,10 +18192,26 @@ export declare interface NiceQRCodeProps extends NiceStandardProps {
18439
18192
  * what the user types. Off by default — pass `showInput` to enable.
18440
18193
  */
18441
18194
  showInput?: boolean;
18442
- /** Label for the built-in input (only when `showInput`). */
18195
+ /**
18196
+ * Alias for {@link showInput}. When `editable` is provided it takes precedence:
18197
+ * `editable={false}` hides the input (QR still renders), `editable` shows it.
18198
+ */
18199
+ editable?: boolean;
18200
+ /** Label for the built-in input (only when the input is shown). */
18443
18201
  inputLabel?: string;
18444
- /** Placeholder for the built-in input (only when `showInput`). */
18202
+ /** Placeholder for the built-in input (only when the input is shown). */
18445
18203
  inputPlaceholder?: string;
18204
+ /** Where to place the built-in input's label (forwarded to {@link NiceTextInput}). */
18205
+ labelPlacement?: NiceTextInputProps['labelPlacement'];
18206
+ /**
18207
+ * Extra props forwarded to the built-in {@link NiceTextInput}, so the top editor
18208
+ * is a fully-featured NiceTextInput (variant, prefix/suffix, clearable, helperText,
18209
+ * error, disabled, readOnly, …). Explicit props (`inputLabel`, `inputPlaceholder`,
18210
+ * `labelPlacement`, `size`) win over the same keys here.
18211
+ */
18212
+ inputProps?: Partial<NiceTextInputProps>;
18213
+ /** Fires with the new value whenever the user edits the built-in input. */
18214
+ onValueChange?: (value: string) => void;
18446
18215
  }
18447
18216
 
18448
18217
  /** Reed-Solomon error correction level for QR codes. */
@@ -18569,12 +18338,12 @@ export declare interface NiceRangeSliderProps extends NiceFormFieldProps {
18569
18338
  max?: number;
18570
18339
  /** Step increment. */
18571
18340
  step?: number;
18572
- /** Start (lower) thumb value. */
18573
- startValue: number;
18574
- /** End (upper) thumb value. */
18575
- endValue: number;
18341
+ /** Start (lower) thumb value. Defaults to `min`. */
18342
+ startValue?: number;
18343
+ /** End (upper) thumb value. Defaults to `max`. */
18344
+ endValue?: number;
18576
18345
  /** Called when either thumb moves. */
18577
- onChange: (start: number, end: number) => void;
18346
+ onChange?: (start: number, end: number) => void;
18578
18347
  /** Show value labels at each thumb. */
18579
18348
  showLabels?: boolean;
18580
18349
  /** Custom label formatter. */
@@ -19983,11 +19752,9 @@ export declare interface NiceSectionProps extends NiceStandardProps {
19983
19752
  * - `NiceButtonGroup` — visual cluster of independent action buttons
19984
19753
  * (Save / Cancel, Bold / Italic / Underline). Each child is its own
19985
19754
  * `NiceButton`, so icon-only or icon + text combinations work via
19986
- * `<NiceButton leftIcon={...} />` or `<NiceIconButton />`.
19987
- * - `NiceToolbar` — long horizontal strip with separators / spacers /
19988
- * custom widgets, typically above content.
19755
+ * `<NiceButton leftIcon={...} />`.
19989
19756
  */
19990
- export declare function NiceSegmentedControl<T = string>({ options, value: controlledValue, defaultValue, onChange, size, block, disabled, className, style, 'data-testid': testId, }: NiceSegmentedControlProps<T>): default_2.JSX.Element;
19757
+ export declare function NiceSegmentedControl<T = string>({ options, value: controlledValue, defaultValue, onChange, size, block, disabled, readOnly, loading, error, highlightFill, errorPlacement, className, style, 'data-testid': testId, }: NiceSegmentedControlProps<T>): default_2.JSX.Element;
19991
19758
 
19992
19759
  export declare namespace NiceSegmentedControl {
19993
19760
  var displayName: string;
@@ -20008,6 +19775,19 @@ export declare interface NiceSegmentedControlProps<T = string> {
20008
19775
  block?: boolean;
20009
19776
  /** Disabled state */
20010
19777
  disabled?: boolean;
19778
+ /** Read-only: segments are inert but NOT greyed (unlike disabled). */
19779
+ readOnly?: boolean;
19780
+ /** Loading: shows a spinner overlay + aria-busy and blocks interaction. */
19781
+ loading?: boolean;
19782
+ /** Error message — red outline + message shown below the control. */
19783
+ error?: string;
19784
+ /**
19785
+ * Active highlight fills the container's inner edges (no surrounding sliver).
19786
+ * Default true; set false to keep the padded look with slivers.
19787
+ */
19788
+ highlightFill?: boolean;
19789
+ /** Error/validation position: 'bottom' (default) or 'right'. */
19790
+ errorPlacement?: 'bottom' | 'right';
20011
19791
  /** Extra class name */
20012
19792
  className?: string;
20013
19793
  /** Inline styles */
@@ -20464,27 +20244,6 @@ export declare interface NiceSignatureData {
20464
20244
 
20465
20245
  export declare type NiceSignatureOutput = 'png' | 'jpeg' | 'svg';
20466
20246
 
20467
- export declare const NiceSignaturePad: ForwardRefExoticComponent<NiceSignaturePadProps & RefAttributes<HTMLDivElement>>;
20468
-
20469
- /** Props for the {@link NiceSignaturePad} component — a canvas-based digital signature capture pad. */
20470
- export declare interface NiceSignaturePadProps extends NiceBaseProps {
20471
- /** Signature image (data URL) — controlled value */
20472
- value?: string | null;
20473
- onChange?: (dataUrl: string | null) => void;
20474
- penColor?: string;
20475
- penWidth?: number;
20476
- backgroundColor?: string;
20477
- width?: number;
20478
- height?: number;
20479
- size?: NiceSize;
20480
- disabled?: boolean;
20481
- readOnly?: boolean;
20482
- showClear?: boolean;
20483
- showUndo?: boolean;
20484
- label?: string;
20485
- exportFormat?: 'image/png' | 'image/jpeg' | 'image/svg+xml';
20486
- }
20487
-
20488
20247
  export declare interface NiceSignaturePoint {
20489
20248
  x: number;
20490
20249
  y: number;
@@ -20497,6 +20256,12 @@ export declare interface NiceSignatureProps {
20497
20256
  value?: NiceSignatureData | null;
20498
20257
  /** Value change callback */
20499
20258
  onChange?: (data: NiceSignatureData | null) => void;
20259
+ /** Convenience callback emitting the signature as a PNG data URL (null when
20260
+ * cleared) — for form consumers that bind a string value. Ported from the
20261
+ * former NiceSignaturePad. */
20262
+ onChangeDataUrl?: (url: string | null) => void;
20263
+ /** Field label shown above the pad. */
20264
+ label?: string;
20500
20265
  /** Width */
20501
20266
  width?: number | string;
20502
20267
  /** Height */
@@ -20613,6 +20378,10 @@ export declare interface NiceSkeletonProps extends Omit<NiceStandardProps, 'vari
20613
20378
  height?: string | number;
20614
20379
  /** Number of skeleton rows to render (text variant). */
20615
20380
  count?: number;
20381
+ /** Lay multiple rows out as a column (default) or a row of bars. */
20382
+ orientation?: 'horizontal' | 'vertical';
20383
+ /** Shimmer animation duration in seconds (default 1.8). */
20384
+ animationSpeed?: number;
20616
20385
  }
20617
20386
 
20618
20387
  export { NiceSkipLink }
@@ -20775,8 +20544,11 @@ export declare interface NiceSpeechToTextProps extends NiceBaseProps {
20775
20544
 
20776
20545
  export declare const NiceSpeedDialAction: default_2.FC<NiceSpeedDialProps>;
20777
20546
 
20547
+ /** Direction in which the {@link NiceSpeedDialAction} fans out its action items. */
20548
+ export declare type NiceSpeedDialDirection = 'up' | 'down' | 'left' | 'right';
20549
+
20778
20550
  /** A single action in the {@link NiceSpeedDialAction} floating menu. */
20779
- declare interface NiceSpeedDialItem {
20551
+ export declare interface NiceSpeedDialItem {
20780
20552
  /** Unique identifier. */
20781
20553
  key: string;
20782
20554
  /** Icon element. */
@@ -20789,12 +20561,12 @@ declare interface NiceSpeedDialItem {
20789
20561
 
20790
20562
  /** Props for the {@link NiceSpeedDialAction} component — a floating action button with expandable actions. */
20791
20563
  export declare interface NiceSpeedDialProps extends NiceBaseProps {
20792
- /** Icon for the trigger FAB button. */
20564
+ /** Icon for the trigger FAB button. Defaults to a built-in plus icon. */
20793
20565
  icon?: default_2.ReactNode;
20794
20566
  /** Action items that fan out when expanded. */
20795
20567
  items: NiceSpeedDialItem[];
20796
- /** Direction in which the action items expand. */
20797
- direction?: 'up' | 'down' | 'left' | 'right';
20568
+ /** Direction in which the action items expand. Defaults to `'right'`. */
20569
+ direction?: NiceSpeedDialDirection;
20798
20570
  /** CSS position offset for fixed placement (e.g. bottom-right corner). */
20799
20571
  position?: {
20800
20572
  bottom?: number;
@@ -20802,6 +20574,8 @@ export declare interface NiceSpeedDialProps extends NiceBaseProps {
20802
20574
  top?: number;
20803
20575
  left?: number;
20804
20576
  };
20577
+ /** Disables the trigger and hides the actions. */
20578
+ disabled?: boolean;
20805
20579
  }
20806
20580
 
20807
20581
  export declare const NiceSpinner: default_2.FC<NiceSpinnerProps>;
@@ -20895,6 +20669,14 @@ export declare interface NiceSpreadsheetProps extends NiceBaseProps {
20895
20669
  showSheetTabs?: boolean;
20896
20670
  /** Make the entire spreadsheet read-only. */
20897
20671
  readOnly?: boolean;
20672
+ /** Disabled: dimmed + inert (blocks editing/selection). */
20673
+ disabled?: boolean;
20674
+ /** Loading: a spinner overlay + aria-busy. */
20675
+ loading?: boolean;
20676
+ /** Error message shown above the grid. */
20677
+ error?: string;
20678
+ /** Density size (xs..xl) — scales cell padding + font. */
20679
+ size?: NiceSize;
20898
20680
  /** Called when any cell data changes. */
20899
20681
  onChange?: (sheets: NiceSpreadsheetSheet[]) => void;
20900
20682
  /** Called when the active sheet tab changes. */
@@ -21361,7 +21143,7 @@ export declare interface NiceTabItem {
21361
21143
  content?: default_2.ReactNode;
21362
21144
  }
21363
21145
 
21364
- export declare function NiceTable<T extends Record<string, any>>({ columns, data, striped, compact, emptyText, className, style, accessMode, id, displayStyle, }: NiceTableProps<T>): default_2.JSX.Element | null;
21146
+ export declare function NiceTable<T extends Record<string, any>>({ columns, data, striped, compact, size, emptyText, className, style, accessMode, id, displayStyle, }: NiceTableProps<T>): default_2.JSX.Element | null;
21365
21147
 
21366
21148
  /** Column definition for the {@link NiceTable} component. */
21367
21149
  export declare interface NiceTableColumn<T = any> {
@@ -21389,42 +21171,12 @@ export declare interface NiceTableProps<T extends Record<string, any> = any> ext
21389
21171
  striped?: boolean;
21390
21172
  /** Reduced padding. */
21391
21173
  compact?: boolean;
21174
+ /** Table size (font + cell padding). Independent of `compact`. */
21175
+ size?: NiceSize;
21392
21176
  /** Text shown when `data` is empty. */
21393
21177
  emptyText?: string;
21394
21178
  }
21395
21179
 
21396
- export declare const NiceTabPanel: default_2.FC<NiceTabPanelProps>;
21397
-
21398
- /** A tab definition for the {@link NiceTabPanel}. */
21399
- export declare interface NiceTabPanelItem {
21400
- /** Unique key. */
21401
- key: string;
21402
- /** Tab header label. */
21403
- title: string;
21404
- /** Optional tab icon. */
21405
- icon?: default_2.ReactNode;
21406
- /** Badge element shown after the title (e.g. count). */
21407
- badge?: default_2.ReactNode;
21408
- /** Disable the tab. */
21409
- disabled?: boolean;
21410
- /** Content renderer. */
21411
- render: () => default_2.ReactNode;
21412
- }
21413
-
21414
- /** Props for the {@link NiceTabPanel} component — a keyed tab strip with content panels and flexible position. */
21415
- export declare interface NiceTabPanelProps extends NiceBaseProps {
21416
- /** Tab panel size. */
21417
- size?: NiceSize;
21418
- /** Tab definitions. */
21419
- items: NiceTabPanelItem[];
21420
- /** Currently active tab key (controlled). */
21421
- selectedKey?: string;
21422
- /** Called when the active tab changes. */
21423
- onSelectedKeyChange?: (key: string) => void;
21424
- /** Side on which the tab strip is rendered. */
21425
- tabPosition?: 'top' | 'bottom' | 'left' | 'right';
21426
- }
21427
-
21428
21180
  export declare const NiceTabs: default_2.FC<NiceTabsProps>;
21429
21181
 
21430
21182
  /** Props for the {@link NiceTabs} component — a tabbed content panel. */
@@ -21441,6 +21193,10 @@ export declare interface NiceTabsProps extends NiceBaseProps {
21441
21193
  size?: NiceSize;
21442
21194
  /** Stack tabs vertically. */
21443
21195
  vertical?: boolean;
21196
+ /** Show only the tab icons (labels move to the tooltip / aria-label). */
21197
+ iconOnly?: boolean;
21198
+ /** Center the tab strip. `'auto'` (default) centers only when `iconOnly`. */
21199
+ centered?: boolean | 'auto';
21444
21200
  }
21445
21201
 
21446
21202
  export declare const NiceTag: default_2.FC<NiceTagProps>;
@@ -21582,29 +21338,6 @@ export declare interface NiceTaskInboxProps extends NiceBaseProps {
21582
21338
  onRefresh?: () => void;
21583
21339
  }
21584
21340
 
21585
- /**
21586
- * {@link NiceTaxRatePicker} — VAT/tax rate selector with country-specific defaults.
21587
- * Supports Polish rates out-of-the-box, custom rates per country, and displays
21588
- * percentage values.
21589
- */
21590
- export declare const NiceTaxRatePicker: default_2.ForwardRefExoticComponent<NiceTaxRatePickerProps & default_2.RefAttributes<HTMLDivElement>>;
21591
-
21592
- /** Props for the {@link NiceTaxRatePicker} component. */
21593
- export declare interface NiceTaxRatePickerProps extends NiceFormFieldProps {
21594
- /** Selected tax rate id. */
21595
- value?: string;
21596
- /** Fires when selection changes. */
21597
- onChange?: (rateId: string, rate: TaxRate) => void;
21598
- /** Available tax rates. If empty, defaults to Polish VAT rates. */
21599
- rates?: TaxRate[];
21600
- /** Country code filter. */
21601
- countryCode?: string;
21602
- /** Placeholder text. */
21603
- placeholder?: string;
21604
- /** Whether to show rate percentage in the label. */
21605
- showPercentage?: boolean;
21606
- }
21607
-
21608
21341
  export declare const NiceTempDial: default_2.FC<NiceTempDialProps>;
21609
21342
 
21610
21343
  export declare interface NiceTempDialProps extends NiceBaseProps {
@@ -21620,30 +21353,6 @@ export declare interface NiceTempDialProps extends NiceBaseProps {
21620
21353
  disabled?: boolean;
21621
21354
  }
21622
21355
 
21623
- /**
21624
- * {@link NiceTenantSwitcher} — Tenant/organization selector dropdown
21625
- * for multi-tenant SaaS applications.
21626
- */
21627
- export declare const NiceTenantSwitcher: default_2.ForwardRefExoticComponent<NiceTenantSwitcherProps & default_2.RefAttributes<HTMLDivElement>>;
21628
-
21629
- /** Props for the {@link NiceTenantSwitcher} component. */
21630
- export declare interface NiceTenantSwitcherProps extends NiceFormFieldProps {
21631
- /** Available tenants. */
21632
- tenants: TenantEntry[];
21633
- /** Currently selected tenant id. */
21634
- currentTenantId?: string | number;
21635
- /** Fires when tenant is switched. */
21636
- onSwitch?: (tenantId: string | number) => void;
21637
- /** Fires when "Manage tenants" is clicked. */
21638
- onManage?: () => void;
21639
- /** Fires when "Create tenant" is clicked. */
21640
- onCreate?: () => void;
21641
- /** Variant (inline selector or dropdown). */
21642
- variant?: 'dropdown' | 'inline';
21643
- /** Search filter enabled. */
21644
- searchable?: boolean;
21645
- }
21646
-
21647
21356
  /** A single line of terminal output in the {@link NiceTerminalUI}. */
21648
21357
  export declare interface NiceTerminalLine {
21649
21358
  /** Line type — determines styling (green for input, red for error, grey for system). */
@@ -21654,6 +21363,9 @@ export declare interface NiceTerminalLine {
21654
21363
  timestamp?: Date;
21655
21364
  }
21656
21365
 
21366
+ /** Colour scheme for the {@link NiceTerminalUI}. */
21367
+ export declare type NiceTerminalTheme = 'auto' | 'dark' | 'matrix';
21368
+
21657
21369
  export declare const NiceTerminalUI: ForwardRefExoticComponent<NiceTerminalUIProps & RefAttributes<HTMLDivElement>>;
21658
21370
 
21659
21371
  /** Props for the {@link NiceTerminalUI} component — a retro terminal / console emulator. */
@@ -21664,9 +21376,19 @@ export declare interface NiceTerminalUIProps extends NiceStandardProps {
21664
21376
  prompt?: string;
21665
21377
  /** Called when the user presses Enter with a command. */
21666
21378
  onCommand?: (command: string) => void;
21667
- /** Disable user input. */
21379
+ /** Disable user input (log-viewer mode — hides the input row). */
21668
21380
  readOnly?: boolean;
21669
- /** Terminal size preset. */
21381
+ /** Disabled: dims the terminal and blocks input. */
21382
+ disabled?: boolean;
21383
+ /** Error message rendered as an alert banner at the top of the terminal. */
21384
+ error?: string | boolean;
21385
+ /**
21386
+ * Colour scheme. `auto` (default) follows the page theme via canonical tokens
21387
+ * (light terminal in a light theme, dark in a dark theme); `dark` pins the
21388
+ * classic VS Code palette; `matrix` is black + green.
21389
+ */
21390
+ theme?: NiceTerminalTheme;
21391
+ /** Terminal size preset (scales the monospace font). */
21670
21392
  size?: NiceSize;
21671
21393
  /** Terminal viewport height. */
21672
21394
  height?: number | string;
@@ -21993,55 +21715,6 @@ export { NiceThemeShadows }
21993
21715
 
21994
21716
  export { NiceThemeSpacing }
21995
21717
 
21996
- /**
21997
- * NiceThemeSwitcher — Traceless-aware theme selection component.
21998
- *
21999
- * @example
22000
- * ```tsx
22001
- * // Basic usage with themes
22002
- * <NiceThemeSwitcher
22003
- * themes={[
22004
- * { key: 'light', label: 'Light', icon: '☀️', theme: lightTheme },
22005
- * { key: 'dark', label: 'Dark', icon: '🌙', theme: darkTheme },
22006
- * ]}
22007
- * />
22008
- *
22009
- * // In traceless mode (no persistence)
22010
- * <NiceThemeSwitcher themes={myThemes} storageMode="traceless" />
22011
- * ```
22012
- */
22013
- 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;
22014
-
22015
- /**
22016
- * Props for NiceThemeSwitcher.
22017
- */
22018
- export declare interface NiceThemeSwitcherProps extends ThemeSwitcherStorageProps {
22019
- /** Display variant */
22020
- variant?: ThemeSwitcherVariant;
22021
- /** Available theme options (required - define your light/dark themes) */
22022
- themes: ThemeOption[];
22023
- /** Size */
22024
- size?: 'sm' | 'md' | 'lg';
22025
- /** Show labels (only applies to 'icons' and 'buttons' variants) */
22026
- showLabels?: boolean;
22027
- /** Callback when theme changes */
22028
- onThemeChange?: (theme: NiceTheme, key: string) => void;
22029
- /** Default theme key (if not persisted or in traceless mode) */
22030
- defaultTheme?: string;
22031
- /** Show "System" option that follows OS preference */
22032
- showSystemOption?: boolean;
22033
- /** Custom class name */
22034
- className?: string;
22035
- /** Inline styles */
22036
- style?: default_2.CSSProperties;
22037
- /** Disabled state */
22038
- disabled?: boolean;
22039
- /** Label for the switcher */
22040
- label?: string;
22041
- /** Hide label visually (still accessible) */
22042
- hideLabel?: boolean;
22043
- }
22044
-
22045
21718
  export { NiceThemeText }
22046
21719
 
22047
21720
  export { NiceThemeTransitions }
@@ -22102,8 +21775,8 @@ export declare interface NiceTimelineItem {
22102
21775
  subtitle?: default_2.ReactNode;
22103
21776
  /** Body content */
22104
21777
  content?: default_2.ReactNode;
22105
- /** Custom icon in the dot */
22106
- icon?: default_2.ReactNode;
21778
+ /** Custom icon in the dot — a built-in icon name (e.g. `'check'`) or any React node. */
21779
+ icon?: default_2.ReactNode | string;
22107
21780
  /** Dot color override */
22108
21781
  color?: string;
22109
21782
  }
@@ -22116,6 +21789,11 @@ export declare interface NiceTimelineProps extends NiceStandardProps {
22116
21789
  mode?: 'left' | 'right' | 'alternate' | 'horizontal';
22117
21790
  /** Size of timeline dots and spacing */
22118
21791
  size?: NiceSize;
21792
+ /**
21793
+ * Render as a slice of a larger timeline: draws a leading line before the
21794
+ * first item and a trailing line after the last (so it reads as an excerpt).
21795
+ * Default false. */
21796
+ isFragment?: boolean;
22119
21797
  /** Custom renderer for each item */
22120
21798
  renderItem?: (item: NiceTimelineItem, index: number) => default_2.ReactNode;
22121
21799
  }
@@ -22137,49 +21815,6 @@ export declare interface NiceTimeoutFeedbackProps extends NiceStandardProps {
22137
21815
  loading: boolean;
22138
21816
  }
22139
21817
 
22140
- export declare const NiceTimePicker: default_2.ForwardRefExoticComponent<NiceTimePickerProps & default_2.RefAttributes<HTMLDivElement>>;
22141
-
22142
- /** Props for the {@link NiceTimePicker} component — a time-only picker with hour/minute/second spinners. */
22143
- export declare interface NiceTimePickerProps extends NiceFormFieldProps {
22144
- /** Time string in HH:mm or HH:mm:ss format */
22145
- value?: string;
22146
- onChange?: (value: string) => void;
22147
- onBlur?: (e: default_2.FocusEvent) => void;
22148
- /** Display format — 12h shows AM/PM toggle, 24h shows 0–23 */
22149
- hourFormat?: '12' | '24';
22150
- /** Minute increment step */
22151
- minuteStep?: number;
22152
- /** Show seconds input */
22153
- showSeconds?: boolean;
22154
- /** Minimum time (HH:mm) */
22155
- min?: string;
22156
- /** Maximum time (HH:mm) */
22157
- max?: string;
22158
- /** Show clear button */
22159
- clearable?: boolean;
22160
- /**
22161
- * Optional explicit target date to combine with the picked time
22162
- * (`Date` or `YYYY-MM-DD` string). When omitted while {@link countdown}
22163
- * is enabled, the target auto-resolves to the **next occurrence**:
22164
- * today if the picked time hasn't passed yet, tomorrow if it has.
22165
- */
22166
- targetDate?: string | Date;
22167
- /** Fires whenever the resolved target Date changes. */
22168
- onTargetChange?: (target: Date) => void;
22169
- /** Show a live countdown label beside the picker. */
22170
- countdown?: boolean;
22171
- /** Built-in countdown format preset (default `'verbose'`). */
22172
- countdownFormat?: NiceCountdownFormat_2;
22173
- /** Custom formatter (overrides {@link countdownFormat}). */
22174
- formatCountdown?: (msRemaining: number, target: Date) => string;
22175
- /** Label rendered before the countdown text (e.g. `'starts in'`). */
22176
- countdownLabel?: default_2.ReactNode;
22177
- /** Update interval in ms (default `1000`). */
22178
- countdownInterval?: number;
22179
- /** Text shown when the target time has elapsed (default `'now'`). */
22180
- countdownDoneText?: string;
22181
- }
22182
-
22183
21818
  export declare const NiceToastContainer: default_2.FC<ToastContainerProps>;
22184
21819
 
22185
21820
  /** Data object describing a single toast notification. */
@@ -22275,36 +21910,6 @@ export declare interface NiceToggleProps extends NiceBaseProps {
22275
21910
 
22276
21911
  export { NiceTone }
22277
21912
 
22278
- export declare const NiceToolbar: default_2.FC<NiceToolbarProps>;
22279
-
22280
- /** A toolbar entry in the {@link NiceToolbar}. */
22281
- export declare interface NiceToolbarItem {
22282
- /** Unique key. */
22283
- key: string;
22284
- /** Custom render function (overrides widget/text/icon). */
22285
- render?: () => default_2.ReactNode;
22286
- /** Built-in widget type: button, visual separator, or flexible spacer. */
22287
- widget?: 'button' | 'separator' | 'spacer';
22288
- /** Button label text. */
22289
- text?: string;
22290
- /** Button icon. */
22291
- icon?: default_2.ReactNode;
22292
- /** Disable the item. */
22293
- disabled?: boolean;
22294
- /** Click handler. */
22295
- onClick?: () => void;
22296
- /** Alignment group within the toolbar. */
22297
- location?: 'before' | 'center' | 'after';
22298
- }
22299
-
22300
- /** Props for the {@link NiceToolbar} component — a horizontal strip of action buttons and widgets. */
22301
- export declare interface NiceToolbarProps extends NiceBaseProps {
22302
- /** Toolbar items. */
22303
- items: NiceToolbarItem[];
22304
- /** Toolbar size preset. */
22305
- size?: NiceSize;
22306
- }
22307
-
22308
21913
  export declare const NiceTooltip: default_2.FC<NiceTooltipProps>;
22309
21914
 
22310
21915
  /** Props for the {@link NiceTooltip} component — shows contextual information on hover/focus. */
@@ -22313,14 +21918,20 @@ export declare interface NiceTooltipProps {
22313
21918
  size?: NiceSize;
22314
21919
  /** Tooltip content (text or rich elements). */
22315
21920
  content: default_2.ReactNode;
22316
- /** Preferred placement relative to the trigger. */
22317
- position?: 'top' | 'bottom' | 'left' | 'right';
21921
+ /**
21922
+ * Placement relative to the trigger. `'auto'` (default) picks the side with
21923
+ * the most room so the tooltip stays on-screen (collision detection).
21924
+ */
21925
+ position?: NiceTooltipSide | 'auto';
22318
21926
  /** Tooltip follows cursor position */
22319
21927
  followCursor?: boolean;
22320
21928
  /** Trigger element that the tooltip wraps. */
22321
21929
  children: default_2.ReactElement;
22322
21930
  }
22323
21931
 
21932
+ /** Concrete side a tooltip can be placed on (after `'auto'` is resolved). */
21933
+ declare type NiceTooltipSide = 'top' | 'bottom' | 'left' | 'right';
21934
+
22324
21935
  export declare const NiceTopNav: default_2.ForwardRefExoticComponent<NiceTopNavProps & default_2.RefAttributes<HTMLElement>>;
22325
21936
 
22326
21937
  export declare type NiceTopNavDensity = 'compact' | 'normal' | 'comfortable';
@@ -22678,7 +22289,7 @@ export declare interface NiceTreeContextMenuItem {
22678
22289
  disabled?: boolean;
22679
22290
  }
22680
22291
 
22681
- export declare function NiceTreeGrid<T extends NiceTreeGridNode>({ columns, data, keyField, parentKeyField, nested, childrenField, expandedKeys: controlledExpanded, onExpandedChange, defaultExpandAll, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, searchable, searchPlaceholder, striped, compact, loading, emptyText, toolbar, onRowClick, className, style, }: NiceTreeGridProps<T>): default_2.JSX.Element;
22292
+ export declare function NiceTreeGrid<T extends NiceTreeGridNode>({ columns, data, keyField, parentKeyField, nested, childrenField, expandedKeys: controlledExpanded, onExpandedChange, defaultExpandAll, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, searchable, searchPlaceholder, striped, compact, size, loading, disabled, readOnly, error, emptyText, toolbar, onRowClick, className, style, }: NiceTreeGridProps<T>): default_2.JSX.Element;
22682
22293
 
22683
22294
  /** A row node in the {@link NiceTreeGrid} (supports index-signature for dynamic fields). */
22684
22295
  export declare interface NiceTreeGridNode {
@@ -22727,8 +22338,16 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
22727
22338
  striped?: boolean;
22728
22339
  /** Reduced padding. */
22729
22340
  compact?: boolean;
22341
+ /** Grid density size (xs..xl) — scales row padding + font. */
22342
+ size?: NiceSize;
22730
22343
  /** Show a loading skeleton. */
22731
22344
  loading?: boolean;
22345
+ /** Disable the whole grid — dimmed and inert. */
22346
+ disabled?: boolean;
22347
+ /** Read-only: rows non-interactive (no selection/row-click) but not dimmed; expand/collapse still works. */
22348
+ readOnly?: boolean;
22349
+ /** Error message shown in place of the grid body. */
22350
+ error?: string;
22732
22351
  /** Text shown when data is empty. */
22733
22352
  emptyText?: string;
22734
22353
  /** Toolbar content rendered above the grid. */
@@ -22886,6 +22505,8 @@ export declare interface NiceTreeSelectProps extends NiceFormFieldProps {
22886
22505
  * leaves (children not rendered, no expand toggle). Default: unlimited.
22887
22506
  */
22888
22507
  maxDepth?: number;
22508
+ /** Gap (px) between the input and the dropdown menu. Default 0 (menu abuts the input). */
22509
+ menuGap?: number;
22889
22510
  }
22890
22511
 
22891
22512
  export declare const NiceTreeView: default_2.FC<NiceTreeViewProps>;
@@ -23232,41 +22853,75 @@ export declare interface NiceUpdatePromptProps extends NiceBaseProps, UseService
23232
22853
 
23233
22854
  export declare const NiceUpload: default_2.ForwardRefExoticComponent<NiceUploadProps & default_2.RefAttributes<HTMLDivElement>>;
23234
22855
 
23235
- /** Props for the {@link NiceUpload} component — drag-and-drop file upload area
23236
- * with progress, image preview, and clipboard paste. Renamed from
23237
- * `NiceFileUploader` and relocated to the basic inputs package per feedback
23238
- * (round 20, 2026-05-05). The legacy export name is kept as a deprecated
23239
- * alias for backward compatibility. */
22856
+ /** Imperative handle, exposed via the optional `apiRef` prop (not the div `ref`). */
22857
+ export declare interface NiceUploadHandle {
22858
+ addFiles: (files: File[]) => void;
22859
+ uploadAll: () => void;
22860
+ cancelAll: () => void;
22861
+ clearAll: () => void;
22862
+ getFiles: () => FileInfo[];
22863
+ getFile: (id: string) => FileInfo | undefined;
22864
+ retryFailed: () => void;
22865
+ openFileBrowser: () => void;
22866
+ }
22867
+
22868
+ /** Props for {@link NiceUpload} — drag-and-drop / button file upload with an
22869
+ * optional upload engine (progress, retry/cancel, chunked upload, validation,
22870
+ * previews) absorbed from the former NiceFileUpload. The legacy `NiceFileUploader`
22871
+ * export was retired in favour of this component. */
23240
22872
  export declare interface NiceUploadProps extends NiceBaseProps {
23241
22873
  accept?: string;
23242
22874
  multiple?: boolean;
23243
22875
  maxFileSize?: number;
23244
22876
  maxFiles?: number;
22877
+ minFileSize?: number;
22878
+ /** Fires with the current File[] on every add/remove (instant) / Upload click. */
23245
22879
  onFilesSelected: (files: File[]) => void;
23246
22880
  uploadMode?: 'instant' | 'useButtons';
23247
- /**
23248
- * Custom dropzone label. Falls back to `text` then to the default
23249
- * `t('dropOrClick', ...)` translation. Kept for backward compatibility
23250
- * with `NiceFileUploader`.
23251
- */
23252
22881
  labelText?: string;
23253
- /**
23254
- * i18n-ready text shown inside the dropzone. When omitted, the
23255
- * built-in translation key `dropOrClick` is used.
23256
- */
22882
+ /** Idle dropzone label; pass `""` for an icon-only dropzone. */
23257
22883
  text?: string;
23258
- /**
23259
- * Optional icon name from `@nice2dev/icons` shown above the dropzone
23260
- * text. Defaults to `'upload'`. Pass `null` to hide the icon.
23261
- */
22884
+ dropzoneText?: string;
22885
+ browseText?: string;
22886
+ dragActiveText?: string;
22887
+ /** Icon/label layout in the dropzone: `'right'` (label beside the icon, default) or `'bottom'` (label under it). */
22888
+ labelPlacement?: 'right' | 'bottom';
23262
22889
  icon?: string | null;
23263
22890
  showFileList?: boolean;
23264
- disabled?: boolean;
23265
- /** Show image thumbnails for image files */
23266
22891
  imagePreview?: boolean;
23267
- /** Per-file progress values 0-100 keyed by file name */
22892
+ showPreview?: boolean;
22893
+ listMode?: 'list' | 'grid' | 'compact';
22894
+ previewSize?: NiceSize;
22895
+ /** External progress override keyed by `file.name` (0–100). */
23268
22896
  fileProgress?: Record<string, number>;
23269
- /** Enable paste from clipboard (Ctrl+V) */
22897
+ renderPreview?: (file: FileInfo) => default_2.ReactNode;
22898
+ renderFileItem?: (file: FileInfo, actions: FileItemActions) => default_2.ReactNode;
22899
+ variant?: 'dropzone' | 'button';
22900
+ /** Custom content for `variant="button"`. */
22901
+ trigger?: default_2.ReactNode;
22902
+ /** Custom clickable/droppable surface content (replaces the default icon+label). */
22903
+ dropChildren?: default_2.ReactNode;
22904
+ autoUpload?: boolean;
22905
+ uploadHandler?: UploadHandler;
22906
+ uploadUrl?: string;
22907
+ uploadHeaders?: Record<string, string>;
22908
+ concurrentUploads?: number;
22909
+ maxRetries?: number;
22910
+ chunkSize?: number;
22911
+ chunkThreshold?: number;
22912
+ validateFile?: (file: File) => string | null;
22913
+ keepFilesAfterUpload?: boolean;
22914
+ initialFiles?: FileInfo[];
22915
+ disabled?: boolean;
22916
+ readOnly?: boolean;
22917
+ onFilesAdded?: (files: FileInfo[]) => void;
22918
+ onUploadComplete?: (file: FileInfo) => void;
22919
+ onUploadError?: (file: FileInfo, error: string) => void;
22920
+ onProgress?: (file: FileInfo, progress: number) => void;
22921
+ onFileRemoved?: (file: FileInfo) => void;
22922
+ onChange?: (files: FileInfo[]) => void;
22923
+ apiRef?: default_2.Ref<NiceUploadHandle>;
22924
+ /** Enable paste from clipboard (Ctrl+V). */
23270
22925
  pasteFromClipboard?: boolean;
23271
22926
  }
23272
22927
 
@@ -23422,40 +23077,6 @@ export declare interface NiceValidatorProps extends NiceBaseProps {
23422
23077
 
23423
23078
  export { NiceVariant }
23424
23079
 
23425
- /**
23426
- * {@link NiceVatInput} — VAT/NIP number input with country selector,
23427
- * prefix auto-prepend, pattern validation, and optional VIES verification.
23428
- */
23429
- export declare const NiceVatInput: default_2.ForwardRefExoticComponent<NiceVatInputProps & default_2.RefAttributes<HTMLDivElement>>;
23430
-
23431
- /** Props for the {@link NiceVatInput} component. */
23432
- export declare interface NiceVatInputProps extends NiceFormFieldProps {
23433
- /** Current VAT number value (with or without prefix). */
23434
- value?: string;
23435
- /** Fires when value changes. */
23436
- onChange?: (value: string, isValid: boolean) => void;
23437
- /** Selected country code (ISO 3166-1 alpha-2). */
23438
- countryCode?: string;
23439
- /** Fires when country changes. */
23440
- onCountryChange?: (code: string) => void;
23441
- /** Custom country configs. */
23442
- countries?: VatCountryConfig[];
23443
- /** Whether to show the country selector. */
23444
- showCountrySelector?: boolean;
23445
- /** Whether to auto-prepend VAT prefix. */
23446
- autoPrefixVat?: boolean;
23447
- /** External validation result. */
23448
- validationResult?: {
23449
- valid: boolean;
23450
- companyName?: string;
23451
- error?: string;
23452
- } | null;
23453
- /** Fires when user requests online validation (e.g. VIES). */
23454
- onValidateRequest?: (vatNumber: string, countryCode: string) => void;
23455
- /** Placeholder override. */
23456
- placeholder?: string;
23457
- }
23458
-
23459
23080
  export declare const NiceVectorMap: default_2.FC<NiceVectorMapProps>;
23460
23081
 
23461
23082
  /** Props for the {@link NiceVectorMap} component — an SVG choropleth map with region selection and tooltips. */
@@ -24118,6 +23739,12 @@ export declare interface NiceVirtualScrollerProps<T = unknown> extends NiceStand
24118
23739
  renderItem: (item: T, index: number) => default_2.ReactNode;
24119
23740
  /** Optional item key extractor */
24120
23741
  itemKey?: (item: T, index: number) => string | number;
23742
+ /** Disable interaction and dim the list. */
23743
+ disabled?: boolean;
23744
+ /** Read-only marker (a scroller is already read-only; kept for API parity). */
23745
+ readOnly?: boolean;
23746
+ /** Error message — shown as an alert in place of the list. */
23747
+ error?: string;
24121
23748
  }
24122
23749
 
24123
23750
  export { NiceVisuallyHidden }
@@ -24928,23 +24555,6 @@ export declare interface Person {
24928
24555
  metadata?: Record<string, any>;
24929
24556
  }
24930
24557
 
24931
- /** Country phone prefix entry. */
24932
- export declare interface PhoneCountryCode {
24933
- code: string;
24934
- dialCode: string;
24935
- name: string;
24936
- mask?: string;
24937
- }
24938
-
24939
- /** Parsed phone value. */
24940
- export declare interface PhoneValue {
24941
- countryCode?: string;
24942
- dialCode?: string;
24943
- number?: string;
24944
- /** Full E.164 formatted number (e.g. "+48123456789"). */
24945
- e164?: string;
24946
- }
24947
-
24948
24558
  export { PinchGesture }
24949
24559
 
24950
24560
  declare interface Pipeline {
@@ -27292,22 +26902,6 @@ export declare type TaskPriority = 'low' | 'medium' | 'high' | 'critical';
27292
26902
 
27293
26903
  export declare type TaskStatus = 'pending' | 'claimed' | 'inProgress' | 'completed' | 'delegated' | 'expired';
27294
26904
 
27295
- /** A tax rate entry. */
27296
- export declare interface TaxRate {
27297
- /** Rate identifier. */
27298
- id: string;
27299
- /** Display label (e.g. "23%", "8%", "zw."). */
27300
- label: string;
27301
- /** Numeric rate as decimal (0.23 = 23%). */
27302
- rate: number;
27303
- /** Country code this rate applies to. */
27304
- countryCode?: string;
27305
- /** Category (e.g. "standard", "reduced", "zero", "exempt"). */
27306
- category?: string;
27307
- /** Whether this is the default rate. */
27308
- isDefault?: boolean;
27309
- }
27310
-
27311
26905
  export declare type TempDialMode = 'heat' | 'cool' | 'auto' | 'off';
27312
26906
 
27313
26907
  declare type TemplateEngine = 'handlebars' | 'ejs' | 'mustache' | 'simple';
@@ -27338,19 +26932,6 @@ declare interface TemplateVariable {
27338
26932
  };
27339
26933
  }
27340
26934
 
27341
- /** A tenant/organization entry. */
27342
- export declare interface TenantEntry {
27343
- id: string | number;
27344
- /** Display name. */
27345
- name: string;
27346
- /** Logo/icon URL. */
27347
- logoUrl?: string;
27348
- /** Subtitle (e.g. role, plan). */
27349
- subtitle?: string;
27350
- /** Whether the tenant is active/current. */
27351
- isCurrent?: boolean;
27352
- }
27353
-
27354
26935
  declare type TestAction = 'render' | 'click' | 'type' | 'select' | 'hover' | 'focus' | 'blur' | 'submit' | 'keypress' | 'wait' | 'scroll' | 'drag' | 'assert' | 'snapshot' | 'a11y-check';
27355
26936
 
27356
26937
  declare interface TestCase {
@@ -27522,22 +27103,6 @@ export { themeOneDark }
27522
27103
 
27523
27104
  export { themeOnyx }
27524
27105
 
27525
- /**
27526
- * Theme option for the switcher.
27527
- */
27528
- export declare interface ThemeOption {
27529
- /** Unique key */
27530
- key: string;
27531
- /** Display label */
27532
- label: string;
27533
- /** Icon or emoji */
27534
- icon?: default_2.ReactNode;
27535
- /** The theme object */
27536
- theme: NiceTheme;
27537
- /** Whether this is the system theme (follows OS preference) */
27538
- isSystem?: boolean;
27539
- }
27540
-
27541
27106
  export { themeOrange }
27542
27107
 
27543
27108
  export { themePastelCoral }
@@ -27558,11 +27123,6 @@ export { themePastelSky }
27558
27123
 
27559
27124
  export { themePink }
27560
27125
 
27561
- /**
27562
- * Built-in theme presets.
27563
- */
27564
- export declare type ThemePreset = 'light' | 'dark' | 'system' | 'custom';
27565
-
27566
27126
  /** Colours used to render a theme preview thumbnail. All optional except `background`. */
27567
27127
  export declare interface ThemePreviewColors {
27568
27128
  /** Main page background. */
@@ -27625,27 +27185,6 @@ export { themeSummerBeach }
27625
27185
 
27626
27186
  export { themeSunset }
27627
27187
 
27628
- /**
27629
- * Traceless storage props interface for theme switcher.
27630
- */
27631
- declare interface ThemeSwitcherStorageProps {
27632
- /** Whether this component may use cookies */
27633
- cookies?: boolean;
27634
- /** Whether this component may use localStorage */
27635
- localStorage?: boolean;
27636
- /** Whether this component may use sessionStorage */
27637
- sessionStorage?: boolean;
27638
- /** Override storage mode for this component */
27639
- storageMode?: TracelessMode;
27640
- /** Storage key for persisting component state */
27641
- storageKey?: string;
27642
- }
27643
-
27644
- /**
27645
- * Display variant for the theme switcher.
27646
- */
27647
- export declare type ThemeSwitcherVariant = 'dropdown' | 'radio' | 'buttons' | 'icons';
27648
-
27649
27188
  export { themeSynthwave }
27650
27189
 
27651
27190
  export { themeTeal }
@@ -28313,7 +27852,7 @@ export declare interface UploadResponse {
28313
27852
  url?: string;
28314
27853
  error?: string;
28315
27854
  fileId?: string;
28316
- metadata?: Record<string, any>;
27855
+ metadata?: Record<string, unknown>;
28317
27856
  }
28318
27857
 
28319
27858
  export declare type UploadStatus = 'pending' | 'uploading' | 'success' | 'error' | 'cancelled';
@@ -29207,20 +28746,6 @@ declare type ValidationType = 'required' | 'type' | 'min' | 'max' | 'pattern' |
29207
28746
 
29208
28747
  export { VARIANT_PRESETS }
29209
28748
 
29210
- /** Country-specific VAT/NIP validation config. */
29211
- export declare interface VatCountryConfig {
29212
- /** ISO 3166‑1 alpha-2 code. */
29213
- code: string;
29214
- /** Display name. */
29215
- label: string;
29216
- /** VAT prefix (e.g. "PL", "DE"). */
29217
- prefix: string;
29218
- /** Regex pattern for the numeric part (without prefix). */
29219
- pattern: RegExp;
29220
- /** Mask/placeholder hint. */
29221
- placeholder?: string;
29222
- }
29223
-
29224
28749
  /** Author/User information */
29225
28750
  declare interface VersioningAuthor {
29226
28751
  id: string;