@nice2dev/ui 1.0.30 → 1.1.5

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 (126) hide show
  1. package/CHANGELOG.md +848 -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/NiceCodeEditor-BVUwp9yX.js +1134 -0
  6. package/dist/NiceCodeEditor-cIqUSk3j.cjs +260 -0
  7. package/dist/NiceColorPicker-C8NZZcXE.js +596 -0
  8. package/dist/NiceColorPicker-CKVbjicN.cjs +1 -0
  9. package/dist/NiceConfirmDialog-B57cl_F7.cjs +1 -0
  10. package/dist/NiceConfirmDialog-DmBX1Iea.js +81 -0
  11. package/dist/NiceConfirmDialog-N9fBTLYm.js +81 -0
  12. package/dist/NiceConfirmDialog-oSxVpsCs.cjs +1 -0
  13. package/dist/NiceDataGrid-3AIf2D3t.cjs +10 -0
  14. package/dist/NiceDataGrid-CXCUAkRb.js +1736 -0
  15. package/dist/NiceDocumentViewer-B-uEPZAf.js +672 -0
  16. package/dist/NiceDocumentViewer-BE0gKBlw.cjs +180 -0
  17. package/dist/NiceDrawingCanvas.doc-Dv5vB4gY.js +32 -0
  18. package/dist/NiceDrawingCanvas.doc-Ww9zz17x.cjs +8 -0
  19. package/dist/NiceErrorBoundary-BD-uqk_q.js +709 -0
  20. package/dist/NiceErrorBoundary-CIPXaYik.cjs +1 -0
  21. package/dist/NiceFileManagerViews.doc-CKlnm6cX.cjs +1 -0
  22. package/dist/NiceFileManagerViews.doc-Cg21DArG.js +25 -0
  23. package/dist/NiceForm-BNZB31Pg.js +4499 -0
  24. package/dist/NiceForm-C6F0HvrX.cjs +1 -0
  25. package/dist/NiceForm-CCyfWgIs.js +4805 -0
  26. package/dist/NiceForm-CPyAXxBO.cjs +1 -0
  27. package/dist/NiceGantt-CSFLZD2y.js +328 -0
  28. package/dist/NiceGantt-_ysNSVYR.cjs +1 -0
  29. package/dist/NiceHtmlEditor-B8B8AcSC.js +841 -0
  30. package/dist/NiceHtmlEditor-D8RQcBNp.cjs +10 -0
  31. package/dist/NiceLoginForm-Bai7aN8V.js +708 -0
  32. package/dist/NiceLoginForm-BrvIc-wq.cjs +1 -0
  33. package/dist/NiceMegaMenu.doc-7UyOCd3l.cjs +7 -0
  34. package/dist/NiceMegaMenu.doc-zeIyVa65.js +31 -0
  35. package/dist/NiceMention-CWoLD0SE.js +11082 -0
  36. package/dist/NiceMention-J1lUDLhg.cjs +430 -0
  37. package/dist/NiceMention.css +1 -0
  38. package/dist/NiceModal-0UxviEYE.cjs +1 -0
  39. package/dist/NiceModal-Bj53SKLI.js +95 -0
  40. package/dist/NiceModal-D-iOonog.js +95 -0
  41. package/dist/NiceModal-DC0UlQhc.cjs +1 -0
  42. package/dist/NiceModuleLifecyclePanel-4hzDw6it.js +6999 -0
  43. package/dist/NiceModuleLifecyclePanel-BBOg9g0b.cjs +1 -0
  44. package/dist/NiceModuleLifecyclePanel-Df_1k5qW.cjs +1 -0
  45. package/dist/NiceModuleLifecyclePanel-DtuXRiLR.js +6991 -0
  46. package/dist/NiceModuleLifecyclePanel.css +1 -1
  47. package/dist/NicePagination-Bjxy9aEc.js +172 -0
  48. package/dist/NicePagination-CPn-Q1h_.js +172 -0
  49. package/dist/NicePagination-CfFfNwrg.cjs +1 -0
  50. package/dist/NicePagination-EEQ6o1dF.cjs +1 -0
  51. package/dist/NicePivotGrid-Cmiolup9.cjs +152 -0
  52. package/dist/NicePivotGrid-DX_iUj2X.js +1167 -0
  53. package/dist/NiceSavedQueryPanel-BhjFJBvn.cjs +586 -0
  54. package/dist/NiceSavedQueryPanel-CH5c3rUG.js +6988 -0
  55. package/dist/NiceSavedQueryPanel-KvyXTnFx.js +5129 -0
  56. package/dist/NiceSavedQueryPanel-aQrEmmcC.cjs +596 -0
  57. package/dist/NiceScannerControl-Cd5KXJA9.js +12769 -0
  58. package/dist/NiceScannerControl-DZsERSw_.cjs +698 -0
  59. package/dist/NiceScannerControl.css +1 -0
  60. package/dist/NiceScheduler-DuxPzQQZ.js +1645 -0
  61. package/dist/NiceScheduler-nW7fMzKL.cjs +5 -0
  62. package/dist/NiceSelect-BVoqtfYN.cjs +1 -0
  63. package/dist/NiceSelect-DHowflmX.js +433 -0
  64. package/dist/NiceWindow-BoDzlGk-.js +1621 -0
  65. package/dist/NiceWindow-DdD9k4nc.cjs +1 -0
  66. package/dist/NiceWindow-DgONWxBm.cjs +1 -0
  67. package/dist/NiceWindow-xnTSHdHv.js +1623 -0
  68. package/dist/charts-B-sl1V9y.cjs +882 -0
  69. package/dist/charts-Bs0aDM0X.js +4671 -0
  70. package/dist/charts-DO2z6Ziu.js +31920 -0
  71. package/dist/charts-DjjKkw0q.cjs +761 -0
  72. package/dist/charts.cjs +1 -1
  73. package/dist/charts.mjs +7 -7
  74. package/dist/core-BUsZ7_vI.js +27914 -0
  75. package/dist/core-C2KhqEaU.cjs +1 -0
  76. package/dist/core-CLfcCDKc.cjs +122 -0
  77. package/dist/core-K2DIxXLn.js +795 -0
  78. package/dist/data-branching-D7l_kILW.cjs +1 -0
  79. package/dist/data-branching-DC6hcBQN.cjs +1 -0
  80. package/dist/data-branching-DykdTpjJ.js +6255 -0
  81. package/dist/data-branching-lJ07lDN-.js +6255 -0
  82. package/dist/data-branching.cjs +1 -1
  83. package/dist/data-branching.mjs +1 -1
  84. package/dist/data.cjs +1 -1
  85. package/dist/data.d.ts +70 -44
  86. package/dist/data.mjs +17 -16
  87. package/dist/devops-Bi8MXtko.js +8165 -0
  88. package/dist/devops-CU0sOVEA.cjs +17 -0
  89. package/dist/devops-CXyEwQeM.js +8165 -0
  90. package/dist/devops-On_1wRf9.cjs +17 -0
  91. package/dist/devops.cjs +1 -1
  92. package/dist/devops.mjs +1 -1
  93. package/dist/editors.cjs +1 -1
  94. package/dist/editors.d.ts +288 -432
  95. package/dist/editors.mjs +58 -62
  96. package/dist/feedback.cjs +1 -1
  97. package/dist/feedback.d.ts +1 -1
  98. package/dist/feedback.mjs +3 -3
  99. package/dist/index-BDH1yDSg.js +69235 -0
  100. package/dist/index-C9njkNOD.cjs +5470 -0
  101. package/dist/index.cjs +5137 -1
  102. package/dist/index.css +1 -1
  103. package/dist/index.d.ts +556 -929
  104. package/dist/index.mjs +66371 -1017
  105. package/dist/lazy.cjs +1 -1
  106. package/dist/lazy.mjs +24 -24
  107. package/dist/navigation.cjs +1 -1
  108. package/dist/navigation.d.ts +31 -213
  109. package/dist/navigation.mjs +105 -113
  110. package/dist/no-code-8lO7o6xi.js +7425 -0
  111. package/dist/no-code-C58g8_fb.cjs +332 -0
  112. package/dist/no-code-Cj4xJ3w9.js +7425 -0
  113. package/dist/no-code-K8tOLNew.cjs +332 -0
  114. package/dist/no-code.cjs +1 -1
  115. package/dist/no-code.mjs +1 -1
  116. package/dist/overlays.cjs +1 -1
  117. package/dist/overlays.d.ts +10 -0
  118. package/dist/overlays.mjs +36 -36
  119. package/dist/pickerCommons-B-wOzHFh.cjs +1 -0
  120. package/dist/pickerCommons-CORo9j2a.js +2119 -0
  121. package/dist/pickerCommons-COiSUiP2.js +1122 -0
  122. package/dist/pickerCommons-D3WShRrR.cjs +1 -0
  123. package/dist/style.css +6 -6
  124. package/dist/vendor-BPVpdtPp.js +271 -0
  125. package/dist/vendor-Bo2Q64AF.cjs +1 -0
  126. package/package.json +17 -17
package/dist/index.d.ts CHANGED
@@ -141,7 +141,7 @@ import { IndexedDBAdapter } from '@nice2dev/ui-core';
141
141
  import { InputStyleVariant } from '@nice2dev/ui-core';
142
142
  import { isRecordValid } from '@nice2dev/ui-core';
143
143
  import { ITracelessPolicy } from '@nice2dev/ui-core';
144
- import { JSX as JSX_2 } from 'react';
144
+ import { JSX } from 'react';
145
145
  import { KeyboardShortcut } from '@nice2dev/ui-core';
146
146
  import { LayoutPreferences } from '@nice2dev/ui-core';
147
147
  import { LeakDetectorConfig } from '@nice2dev/ui-core';
@@ -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,16 @@ 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
+ /** Read-only: the action items are inert (only Cancel stays active), without dimming. */
7350
+ readOnly?: boolean;
7351
+ /** Loading: a spinner overlay + aria-busy; actions blocked. */
7352
+ loading?: boolean;
7353
+ /** Error message shown at the top of the sheet. */
7354
+ error?: string;
7349
7355
  }
7350
7356
 
7351
7357
  /**
@@ -7681,7 +7687,7 @@ export declare interface NiceAppManifest {
7681
7687
  /**
7682
7688
  * {@link NiceAppShell} — reusable app chrome for richer, IDE/DAW-style tools:
7683
7689
  * 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
7690
+ * bar. Built to be composed with `NiceMenu` and the content of
7685
7691
  * your choice (e.g. `NiceAudioStudio` builds on it).
7686
7692
  */
7687
7693
  export declare const NiceAppShell: default_2.ForwardRefExoticComponent<NiceAppShellProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -7690,12 +7696,13 @@ export declare const NiceAppShell: default_2.ForwardRefExoticComponent<NiceAppSh
7690
7696
  * Props for {@link NiceAppShell} — a generic desktop-application frame
7691
7697
  * (menubar → toolbar → [sidebar | content] → status bar). Each region is an
7692
7698
  * optional slot; compose the menubar from a horizontal `NiceMenu` and the
7693
- * toolbar from `NiceToolbar`. Theme-tokened and responsive.
7699
+ * toolbar from your own controls (buttons, a `NiceMenu`, etc.). Theme-tokened
7700
+ * and responsive.
7694
7701
  */
7695
7702
  export declare interface NiceAppShellProps extends NiceBaseProps {
7696
7703
  /** Top menubar row — typically a horizontal `NiceMenu` (File / Edit / View / Help). */
7697
7704
  menubar?: default_2.ReactNode;
7698
- /** Tools toolbar row, below the menubar — typically a `NiceToolbar`. */
7705
+ /** Tools toolbar row, below the menubar — typically buttons or a `NiceMenu`. */
7699
7706
  toolbar?: default_2.ReactNode;
7700
7707
  /** Optional left sidebar (panels, track list, tool palette / tool rail). */
7701
7708
  sidebar?: default_2.ReactNode;
@@ -8045,6 +8052,14 @@ export declare interface NiceAutocompleteProps extends NiceFormFieldProps {
8045
8052
  highlightMatch?: boolean;
8046
8053
  /** Alias for options — array of string suggestions. */
8047
8054
  suggestions?: (string | NiceOption)[];
8055
+ /**
8056
+ * When `true` (default), focusing the field (before typing) opens the dropdown
8057
+ * with **all** options sorted alphabetically. Set `false` to only show
8058
+ * suggestions once the user has typed `minSearchLength` characters.
8059
+ */
8060
+ showAll?: boolean;
8061
+ /** Gap (px) between the input and the suggestion menu. Default 0 (menu abuts the input). */
8062
+ menuGap?: number;
8048
8063
  }
8049
8064
 
8050
8065
  export declare const NiceAutomationRuleEditor: default_2.FC<NiceAutomationRuleEditorProps>;
@@ -8318,13 +8333,30 @@ export declare interface NiceBarcodeProps extends NiceStandardProps {
8318
8333
  size?: NiceSize;
8319
8334
  /**
8320
8335
  * Render an editable {@link NiceTextInput} above the barcode that live-encodes
8321
- * what the user types. Off by default — pass `showInput` to enable.
8336
+ * what the user types. Off by default — pass `showInput` to enable. The barcode
8337
+ * itself always renders; this only toggles the editor field above it.
8322
8338
  */
8323
8339
  showInput?: boolean;
8324
- /** Label for the built-in input (only when `showInput`). */
8340
+ /**
8341
+ * Alias for {@link showInput}. When `editable` is provided it takes precedence:
8342
+ * `editable={false}` hides the input (barcode still renders), `editable` shows it.
8343
+ */
8344
+ editable?: boolean;
8345
+ /** Label for the built-in input (only when the input is shown). */
8325
8346
  inputLabel?: string;
8326
- /** Placeholder for the built-in input (only when `showInput`). */
8347
+ /** Placeholder for the built-in input (only when the input is shown). */
8327
8348
  inputPlaceholder?: string;
8349
+ /** Where to place the built-in input's label (forwarded to {@link NiceTextInput}). */
8350
+ labelPlacement?: NiceTextInputProps['labelPlacement'];
8351
+ /**
8352
+ * Extra props forwarded to the built-in {@link NiceTextInput}, so the top editor
8353
+ * is a fully-featured NiceTextInput (variant, prefix/suffix, clearable, helperText,
8354
+ * error, disabled, readOnly, …). Explicit props (`inputLabel`, `inputPlaceholder`,
8355
+ * `labelPlacement`, `size`) win over the same keys here.
8356
+ */
8357
+ inputProps?: Partial<NiceTextInputProps>;
8358
+ /** Fires with the new value whenever the user edits the built-in input. */
8359
+ onValueChange?: (value: string) => void;
8328
8360
  }
8329
8361
 
8330
8362
  export declare const NiceBarGauge: default_2.FC<NiceBarGaugeProps>;
@@ -8406,34 +8438,6 @@ export declare interface NiceBlockUIProps extends NiceBaseProps {
8406
8438
  children: default_2.ReactNode;
8407
8439
  }
8408
8440
 
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
8441
  export declare const NiceBox: default_2.FC<NiceBoxProps>;
8438
8442
 
8439
8443
  /** Props for the {@link NiceBox} component — a flex-based layout container. */
@@ -8636,9 +8640,9 @@ export declare const NiceButtonGroup: default_2.FC<NiceButtonGroupProps>;
8636
8640
  * Props for the {@link NiceButtonGroup} component — visually groups
8637
8641
  * adjacent buttons into one connected cluster.
8638
8642
  *
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
8643
+ * Children are {@link NiceButton} elements (text, icon-only via `leftIcon`
8644
+ * with empty children, or icon + text via `leftIcon` / `rightIcon`). Use
8645
+ * this for clusters of **independent action
8642
8646
  * buttons**. For an exclusive single-select toggle pattern (with an
8643
8647
  * animated highlight) use {@link NiceSegmentedControl} instead.
8644
8648
  */
@@ -8712,6 +8716,24 @@ export declare interface NiceCalendarProps extends NiceBaseProps, TracelessStora
8712
8716
  /** Array of selected dates when multiple=true. */
8713
8717
  selectedDates?: string[];
8714
8718
  onSelectedDatesChange?: (dates: string[]) => void;
8719
+ /**
8720
+ * `'single'` (default) selects one day via `value`/`onChange`. `'range'`
8721
+ * selects a start/end pair in two clicks, driven by `rangeStart`/`rangeEnd`
8722
+ * and reported through `onRangeChange`.
8723
+ */
8724
+ selectionMode?: 'single' | 'range';
8725
+ /** First day of the selected range (ISO), when `selectionMode='range'`. */
8726
+ rangeStart?: string;
8727
+ /** Last day of the selected range (ISO), when `selectionMode='range'`. */
8728
+ rangeEnd?: string;
8729
+ /**
8730
+ * Fires on every range edit. The first click opens a new range (`end` empty),
8731
+ * the second closes it — clicking before the start swaps the two.
8732
+ */
8733
+ onRangeChange?: (range: {
8734
+ start: string;
8735
+ end: string;
8736
+ }) => void;
8715
8737
  /** Custom render for day cells. Return ReactNode to replace default number. */
8716
8738
  renderDay?: (date: string, day: number) => default_2.ReactNode;
8717
8739
  /** Show keyboard hints. */
@@ -8785,25 +8807,73 @@ export declare interface NiceCardGridProps extends NiceStandardProps {
8785
8807
 
8786
8808
  /**
8787
8809
  * {@link NiceCardGroup} — themed, responsive CSS-grid layout for a set of cards.
8810
+ * With `value`/`onChange` it also acts as a single-select card radio group, and
8811
+ * with `items`/`renderCard` it renders a searchable data grid of cards.
8788
8812
  */
8789
8813
  export declare const NiceCardGroup: default_2.ForwardRefExoticComponent<NiceCardGroupProps & default_2.RefAttributes<HTMLDivElement>>;
8790
8814
 
8815
+ /** An item rendered by {@link NiceCardGroup} in data mode (consolidated from the former NiceCardView). */
8816
+ export declare interface NiceCardGroupItem {
8817
+ /** Unique key. */
8818
+ key: string;
8819
+ /** Additional data fields. */
8820
+ [field: string]: unknown;
8821
+ }
8822
+
8791
8823
  /**
8792
8824
  * Props for {@link NiceCardGroup} — a responsive grid container for cards (or any
8793
8825
  * 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.
8826
+ * and wraps responsively; pass `columns` to pin an exact column count. Pass
8827
+ * `value`/`onChange` to make it a single-select **card radio group**: child
8828
+ * {@link NiceCard}s that carry a `value` become selectable and report selection.
8829
+ *
8830
+ * Provide `items` + `renderCard` to use **data mode** (the former NiceCardView):
8831
+ * the group renders each item through `renderCard`, with optional search and an
8832
+ * empty state.
8795
8833
  */
8796
8834
  export declare interface NiceCardGroupProps extends NiceStandardProps {
8797
- /** Cards / tiles to lay out. */
8798
- children: default_2.ReactNode;
8835
+ /** Cards / tiles to lay out (display / radio mode). */
8836
+ children?: default_2.ReactNode;
8837
+ /** Data items to render through `renderCard` (data mode). */
8838
+ items?: NiceCardGroupItem[];
8839
+ /** Custom card renderer for `items` (data mode). */
8840
+ renderCard?: (item: NiceCardGroupItem) => default_2.ReactNode;
8841
+ /** Show a search box above the grid (data mode). */
8842
+ searchable?: boolean;
8843
+ /** Item field searched when `searchable` is enabled (data mode). Default `text`. */
8844
+ searchField?: string;
8845
+ /** Search input placeholder (data mode). */
8846
+ searchPlaceholder?: string;
8847
+ /** Text shown when `items` is empty (data mode). */
8848
+ emptyText?: string;
8849
+ /** Called when a data-mode card is clicked. */
8850
+ onCardClick?: (item: NiceCardGroupItem) => void;
8851
+ /** Group size — scales the default gap (xs..xl) when `gap` is not set. */
8852
+ size?: NiceSize;
8799
8853
  /** Minimum column width (px) for the auto-fill grid. Default 240. */
8800
8854
  minColumnWidth?: number;
8801
8855
  /** Fixed column count — overrides `minColumnWidth` auto-fill when set. */
8802
8856
  columns?: number;
8803
- /** Gap between cards (px). Default 12. */
8857
+ /** Gap between cards (px). Defaults to a size-based value. */
8804
8858
  gap?: number;
8805
8859
  /** Vertical alignment of items within a row. */
8806
8860
  align?: 'stretch' | 'start' | 'center' | 'end';
8861
+ /** Selected value — enables single-select (radio) behaviour across child cards. */
8862
+ value?: NiceCardValue;
8863
+ /** Fired with the newly-selected card `value`. */
8864
+ onChange?: (value: NiceCardValue) => void;
8865
+ /** Radio group name applied to child cards (a11y). */
8866
+ name?: string;
8867
+ /** Disabled: dims the whole group + blocks selection. */
8868
+ disabled?: boolean;
8869
+ /** Read-only: blocks selection (radio mode) without dimming. */
8870
+ readOnly?: boolean;
8871
+ /** Loading: a spinner overlay + aria-busy. */
8872
+ loading?: boolean;
8873
+ /** Error state. A string is shown as the message; `true` shows `errorText`. */
8874
+ error?: string | boolean;
8875
+ /** Error message shown when `error` is boolean `true` (a string `error` wins). */
8876
+ errorText?: string;
8807
8877
  }
8808
8878
 
8809
8879
  /** Props for the {@link NiceCard} component — a bordered content container with optional header and footer. */
@@ -8827,75 +8897,30 @@ export declare interface NiceCardProps extends NiceBaseProps {
8827
8897
  /**
8828
8898
  * Make the card behave as a selectable option (radio): cursor/hover affordance,
8829
8899
  * `role="radio"` + `aria-checked`, keyboard select (Space/Enter). Inside a
8830
- * {@link NiceCardRadioGroup} this is implied for cards that carry a `value`.
8900
+ * {@link NiceCardGroup} this is implied for cards that carry a `value`.
8831
8901
  */
8832
8902
  selectable?: boolean;
8833
- /** Whether the card is currently selected (controlled; auto-wired inside a NiceCardRadioGroup). */
8903
+ /** Whether the card is currently selected (controlled; auto-wired inside a NiceCardGroup). */
8834
8904
  selected?: boolean;
8835
8905
  /** The option value bound to this card (used for selection + the group's onChange). */
8836
8906
  value?: NiceCardValue;
8837
8907
  /** Fired with `value` when the card is selected. */
8838
8908
  onSelect?: (value: NiceCardValue) => void;
8839
- /** Radio group name (auto-wired inside a NiceCardRadioGroup). */
8840
- 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. */
8909
+ /** Radio group name (auto-wired inside a NiceCardGroup). */
8857
8910
  name?: string;
8858
- /** Child NiceCards (each with a `value`). */
8859
- children: default_2.ReactNode;
8911
+ /** Disabled: dimmed + non-interactive (blocks click/select). */
8912
+ disabled?: boolean;
8913
+ /** Read-only: inert (blocks selection) without the dimmed look. */
8914
+ readOnly?: boolean;
8915
+ /** Loading: a spinner overlay + `aria-busy`; interaction is blocked. */
8916
+ loading?: boolean;
8917
+ /** Error state — adds an error border; a non-empty string also renders a message. */
8918
+ error?: string | boolean;
8860
8919
  }
8861
8920
 
8862
8921
  /** Value type used by selectable cards / card radio groups. */
8863
8922
  export declare type NiceCardValue = string | number;
8864
8923
 
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
8924
  export declare const NiceCarousel: default_2.ForwardRefExoticComponent<NiceCarouselProps & default_2.RefAttributes<HTMLDivElement>>;
8900
8925
 
8901
8926
  /** Props for the {@link NiceCarousel} component — a swipeable slide show with arrows, dots, and auto-play. */
@@ -8918,6 +8943,8 @@ export declare interface NiceCarouselProps extends NiceStandardProps {
8918
8943
  onChange?: (index: number) => void;
8919
8944
  /** Carousel size preset. */
8920
8945
  size?: NiceSize;
8946
+ /** Stretch to fill the container width (default: true). When false the carousel shrinks to its content. */
8947
+ fullWidth?: boolean;
8921
8948
  }
8922
8949
 
8923
8950
  /** Hierarchical option in a {@link NiceCascadeSelect} tree. */
@@ -9239,8 +9266,6 @@ export declare interface NiceCircularGaugeProps extends NiceStandardProps {
9239
9266
  }[];
9240
9267
  }
9241
9268
 
9242
- export declare const NiceClassicShell: ForwardRefExoticComponent<NiceShellProps & RefAttributes<HTMLDivElement>>;
9243
-
9244
9269
  /**
9245
9270
  * Component form of the `useClickOutside` hook — useful when you
9246
9271
  * already have a JSX tree and don't want to thread a ref through it.
@@ -9750,8 +9775,16 @@ export declare interface NiceColorPaletteProps extends NiceBaseProps {
9750
9775
  variationCount?: number;
9751
9776
  /** Label */
9752
9777
  label?: string;
9778
+ /** Label position relative to the swatch strip. Default `'top'`. */
9779
+ labelPlacement?: 'top' | 'left';
9753
9780
  /** Disabled state */
9754
9781
  disabled?: boolean;
9782
+ /** Looks enabled but the studio won't open and edits are blocked. */
9783
+ readOnly?: boolean;
9784
+ /** Show a loading spinner and dim the control. */
9785
+ loading?: boolean;
9786
+ /** Error ring; a string value also renders the message. */
9787
+ error?: string | boolean;
9755
9788
  /**
9756
9789
  * Target number of colors in the generated palette. Overrides the natural
9757
9790
  * count of the active harmony mode (clamped between `minColors` and
@@ -9973,17 +10006,6 @@ export declare interface NiceCommandPaletteProviderProps extends NiceCommandPale
9973
10006
  commands?: NiceCommand[];
9974
10007
  }
9975
10008
 
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
10009
  /**
9988
10010
  * NiceComplianceDashboard — Compliance and certification dashboard.
9989
10011
  *
@@ -10603,19 +10625,6 @@ export declare const NiceCountdown: default_2.FC<NiceCountdownProps>;
10603
10625
 
10604
10626
  export declare type NiceCountdownFormat = 'full' | 'compact' | 'minimal';
10605
10627
 
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
10628
  /** Optional label overrides for the four time units. */
10620
10629
  export declare interface NiceCountdownLabels {
10621
10630
  days?: string;
@@ -10820,39 +10829,6 @@ declare interface NiceCSVOptions extends NiceExportOptions {
10820
10829
  encoding?: 'utf-8' | 'utf-16' | 'iso-8859-1';
10821
10830
  }
10822
10831
 
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
10832
  export { NiceCursorLoadOptions }
10857
10833
 
10858
10834
  export { NiceCursorPage }
@@ -11000,7 +10976,7 @@ export declare interface NiceDataDiffViewerProps extends NiceBaseProps {
11000
10976
  onSelectRecord?: (table: string, recordId: string) => void;
11001
10977
  }
11002
10978
 
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;
10979
+ 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
10980
 
11005
10981
  export declare namespace NiceDataGrid {
11006
10982
  var displayName: string;
@@ -11206,7 +11182,19 @@ export declare interface NiceDataGridProps<T extends Record<string, any> = any>
11206
11182
  onRowReorder?: (fromIndex: number, toIndex: number) => void;
11207
11183
  striped?: boolean;
11208
11184
  compact?: boolean;
11185
+ /**
11186
+ * Visual density of the grid rows (cell padding + font size). Maps to the
11187
+ * `nice-table--{size}` scale. Independent of `compact` (which is tighter than
11188
+ * the smallest size). Default `md`.
11189
+ */
11190
+ size?: NiceSize;
11209
11191
  loading?: boolean;
11192
+ /** Disable the whole grid — dimmed and inert. */
11193
+ disabled?: boolean;
11194
+ /** Read-only: blocks inline editing (not dimmed). */
11195
+ readOnly?: boolean;
11196
+ /** Error message shown above the grid body. */
11197
+ error?: string;
11210
11198
  emptyText?: string;
11211
11199
  toolbar?: React.ReactNode;
11212
11200
  onRowClick?: (row: T) => void;
@@ -11381,10 +11369,96 @@ export { NiceDataSourceState }
11381
11369
  /** Predefined date-format presets. */
11382
11370
  declare type NiceDateFormatPreset = 'date-local' | 'date-utc' | 'datetime-local' | 'datetime-utc' | 'month-local' | 'month-utc' | 'week' | 'time';
11383
11371
 
11384
- export declare const NiceDatePicker: default_2.ForwardRefExoticComponent<NiceDatePickerProps & default_2.RefAttributes<HTMLInputElement>>;
11372
+ export declare const NiceDateRangeBox: default_2.FC<NiceDateRangeBoxProps>;
11373
+
11374
+ /** Props for the {@link NiceDateRangeBox} component — a pair of date pickers for selecting a date range. */
11375
+ export declare interface NiceDateRangeBoxProps extends NiceFormFieldProps {
11376
+ /** Start date (ISO string). */
11377
+ startDate: string;
11378
+ /** End date (ISO string). */
11379
+ endDate: string;
11380
+ /** Called when the start date changes. */
11381
+ onStartChange: (date: string) => void;
11382
+ /** Called when the end date changes. */
11383
+ onEndChange: (date: string) => void;
11384
+ /** Earliest selectable date. */
11385
+ min?: string;
11386
+ /** Latest selectable date. */
11387
+ max?: string;
11388
+ /** Show a clear button. */
11389
+ clearable?: boolean;
11390
+ /** Placeholder for the start input. */
11391
+ startPlaceholder?: string;
11392
+ /** Placeholder for the end input. */
11393
+ endPlaceholder?: string;
11394
+ /** Label shown above (or before) the start picker. */
11395
+ startLabel?: string;
11396
+ /** Label shown above (or before) the end picker. */
11397
+ endLabel?: string;
11398
+ /**
11399
+ * Collapse the pair into ONE field with ONE popup: the field shows
11400
+ * `start – end` and the popup holds a single calendar on which the span is
11401
+ * painted in two clicks. Default `false` (two fields, two popups).
11402
+ */
11403
+ singleField?: boolean;
11404
+ /** Layout direction for the two pickers (default `horizontal`). */
11405
+ layout?: 'horizontal' | 'vertical';
11406
+ /** Custom separator rendered between pickers in horizontal layout (default `–`). Pass `''` to hide. */
11407
+ separator?: default_2.ReactNode;
11408
+ /** Gap in pixels between the two pickers (default 12). */
11409
+ gap?: number;
11410
+ /** Stretch each picker to fill available width. */
11411
+ fullWidth?: boolean;
11412
+ /**
11413
+ * Format preset forwarded to BOTH inner pickers — so a range can be
11414
+ * date, datetime (`'datetime-local'`), month, week or time, not just date.
11415
+ */
11416
+ dateFormatPreset?: NiceDateFormatPreset;
11417
+ /**
11418
+ * BCP 47 locale forwarded to BOTH inner pickers, controlling the displayed
11419
+ * date mask (e.g. `'pl-PL'` → `dd.MM.yyyy`, `'en-US'` → `MM/dd/yyyy`). When
11420
+ * omitted the pickers fall back to the app locale (`<html lang>`) then the
11421
+ * browser locale. The emitted value stays ISO regardless of display locale.
11422
+ */
11423
+ locale?: string;
11424
+ /**
11425
+ * @deprecated Use `dateFormatPreset`. Native input type forwarded to both
11426
+ * inner pickers.
11427
+ */
11428
+ type?: 'date' | 'datetime-local' | 'time' | 'month' | 'week';
11429
+ /**
11430
+ * How the end date is constrained relative to the start (default
11431
+ * `'greater-or-equal'` — the end can equal the start).
11432
+ */
11433
+ endCondition?: NiceDateRangeEndCondition;
11434
+ /**
11435
+ * How the start date is constrained relative to today (default
11436
+ * `'today-or-greater'` — the start can't be in the past).
11437
+ */
11438
+ startCondition?: NiceDateRangeStartCondition;
11439
+ /**
11440
+ * Time selector for datetime ranges, forwarded to both inner pickers:
11441
+ * `'spinners'` (default) or `'clock'` (analog clock face). Only relevant when
11442
+ * `dateFormatPreset` carries a time part.
11443
+ */
11444
+ timeSelectorType?: 'spinners' | 'clock';
11445
+ }
11446
+
11447
+ /** How the end date is constrained relative to the start date. Extensible. */
11448
+ declare type NiceDateRangeEndCondition = 'greater-or-equal' | 'greater' | 'none';
11385
11449
 
11386
- /** Props for the {@link NiceDatePicker} component — a masked, locale-aware date/time input. */
11387
- export declare interface NiceDatePickerProps extends NiceFormFieldProps {
11450
+ /** How the start date is constrained relative to today. Extensible. */
11451
+ declare type NiceDateRangeStartCondition = 'today-or-greater' | 'greater-than-today' | 'none';
11452
+
11453
+ /** Built-in countdown format presets (merged in from NiceTimePicker).
11454
+ * NOTE: deliberately NOT named `NiceCountdownFormat` — that name is already a
11455
+ * public export of the unrelated `NiceCountdown` display component. */
11456
+ declare type NiceDateTimeCountdownFormat = 'verbose' | 'compact' | 'short' | 'minimal' | 'words';
11457
+
11458
+ export declare const NiceDateTimePicker: default_2.ForwardRefExoticComponent<NiceDateTimePickerProps & default_2.RefAttributes<HTMLInputElement>>;
11459
+
11460
+ /** Props for the {@link NiceDateTimePicker} component — a masked, locale-aware date/time input. */
11461
+ export declare interface NiceDateTimePickerProps extends NiceFormFieldProps {
11388
11462
  /** ISO value (e.g. `'2024-06-15'`). Always ISO regardless of display locale. */
11389
11463
  value?: string;
11390
11464
  /** Fires with the new ISO value. Empty string while the input is incomplete. */
@@ -11428,66 +11502,51 @@ export declare interface NiceDatePickerProps extends NiceFormFieldProps {
11428
11502
  * Only fires for date / datetime / month presets.
11429
11503
  */
11430
11504
  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 */
11505
+ /** Datetime/time: show a seconds section (`HH:mm:ss`). Default: `false`. */
11486
11506
  showSeconds?: boolean;
11487
- /** Show "Now" quick button */
11507
+ /**
11508
+ * Datetime/time: minute increment. Drives the native picker companion `step`
11509
+ * AND the ↑/↓ arrow stepping in the masked field.
11510
+ */
11511
+ minuteStep?: number;
11512
+ /**
11513
+ * Datetime/time: `'12'` renders an AM/PM toggle beside the field (and asks the
11514
+ * native picker for a 12-hour dialog where the OS locale supports it). The
11515
+ * masked field always edits 24-hour digits and the emitted value stays ISO 24h.
11516
+ */
11517
+ hourFormat?: '12' | '24';
11518
+ /**
11519
+ * Datetime/time: how the time-of-day is picked inside the popup. `'spinners'`
11520
+ * (default) are the scroll wheels; `'clock'` is an analog clock face with
11521
+ * hour/minute hands and an AM/PM toggle. A small in-popup toggle also lets the
11522
+ * user switch between the two at runtime. The emitted value stays ISO 24h.
11523
+ */
11524
+ timeSelectorType?: 'spinners' | 'clock';
11525
+ /**
11526
+ * Datetime/time/date: show a "Now" button that fills the current date/time.
11527
+ * Default: `false`.
11528
+ */
11488
11529
  showNow?: boolean;
11489
- /** Show clear button */
11490
- clearable?: boolean;
11530
+ /**
11531
+ * Explicit target date to combine with the picked time (`Date` or
11532
+ * `YYYY-MM-DD`). When omitted while {@link countdown} is on, the target
11533
+ * auto-resolves to the next occurrence (today, else tomorrow).
11534
+ */
11535
+ targetDate?: string | Date;
11536
+ /** Fires whenever the resolved countdown target changes. */
11537
+ onTargetChange?: (target: Date) => void;
11538
+ /** Show a live countdown label beside the field. */
11539
+ countdown?: boolean;
11540
+ /** Built-in countdown format preset (default `'verbose'`). */
11541
+ countdownFormat?: NiceDateTimeCountdownFormat;
11542
+ /** Custom countdown formatter (overrides {@link countdownFormat}). */
11543
+ formatCountdown?: (msRemaining: number, target: Date) => string;
11544
+ /** Label rendered before the countdown text (e.g. `'starts in'`). */
11545
+ countdownLabel?: default_2.ReactNode;
11546
+ /** Countdown tick interval in ms (default 1000, min 100). */
11547
+ countdownInterval?: number;
11548
+ /** Text shown once the countdown reaches zero. */
11549
+ countdownDoneText?: string;
11491
11550
  }
11492
11551
 
11493
11552
  export { NiceDensity }
@@ -11667,7 +11726,7 @@ export declare interface NiceDeviceTileQuickControls {
11667
11726
  gain?: boolean;
11668
11727
  }
11669
11728
 
11670
- export declare function NiceDiagramDesigner({ initialSchema, onChange, onExport, className, style, tutorial, }: NiceDiagramDesignerProps): JSX.Element;
11729
+ export declare function NiceDiagramDesigner({ initialSchema, onChange, onExport, className, style, tutorial, }: NiceDiagramDesignerProps): default_2.JSX.Element;
11671
11730
 
11672
11731
  export declare interface NiceDiagramDesignerProps {
11673
11732
  /** Initial diagram schema. Accepts the canonical {@link DiagramSchema} or a looser input where nodes only need `id/x/y/label` and edges may use `from`/`to` aliases. */
@@ -12202,6 +12261,16 @@ export declare interface NiceDropDownBoxProps extends NiceFormFieldProps {
12202
12261
  onOpenChange?: (open: boolean) => void;
12203
12262
  /** Width of the dropdown panel. */
12204
12263
  dropdownWidth?: number | string;
12264
+ /**
12265
+ * Show a search box at the top of the panel (default `true`). Because the panel
12266
+ * holds arbitrary `children`, filtering is the caller's job — the search box only
12267
+ * renders when an `onSearch` handler is provided.
12268
+ */
12269
+ searchable?: boolean;
12270
+ /** Called with the query as the user types in the panel search box. */
12271
+ onSearch?: (query: string) => void;
12272
+ /** Placeholder for the panel search box. */
12273
+ searchPlaceholder?: string;
12205
12274
  }
12206
12275
 
12207
12276
  export declare const NiceDropDownButton: default_2.FC<NiceDropDownButtonProps>;
@@ -12256,18 +12325,6 @@ export declare interface NiceDropDownButtonProps extends NiceBaseProps {
12256
12325
  errorPlacement?: 'bottom' | 'right';
12257
12326
  }
12258
12327
 
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
12328
  export declare const NiceDynamicSidebar: ForwardRefExoticComponent<NiceDynamicSidebarProps & RefAttributes<HTMLElement>>;
12272
12329
 
12273
12330
  export declare interface NiceDynamicSidebarProps extends NiceBaseProps {
@@ -12434,7 +12491,7 @@ export declare class NiceErrorBoundary extends Component<NiceErrorBoundaryProps,
12434
12491
  static getDerivedStateFromError(error: Error): NiceErrorBoundaryState;
12435
12492
  componentDidCatch(error: Error, errorInfo: default_2.ErrorInfo): void;
12436
12493
  handleReset: () => void;
12437
- render(): string | number | boolean | Iterable<default_2.ReactNode> | default_2.JSX.Element | null | undefined;
12494
+ render(): string | number | bigint | boolean | Iterable<default_2.ReactNode> | Promise<string | number | bigint | boolean | default_2.ReactPortal | default_2.ReactElement<unknown, string | default_2.JSXElementConstructor<any>> | Iterable<default_2.ReactNode> | null | undefined> | default_2.JSX.Element | null | undefined;
12438
12495
  }
12439
12496
 
12440
12497
  /** Props for the {@link NiceErrorBoundary} component. */
@@ -12874,16 +12931,6 @@ export declare type NiceFilePanel = 'left' | 'right';
12874
12931
  */
12875
12932
  export declare const NiceFilePicker: default_2.FC<NiceFilePickerProps>;
12876
12933
 
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
12934
  /** Props for {@link NiceFilePicker} — visually-customisable file input. */
12888
12935
  export declare interface NiceFilePickerProps extends NiceStandardProps {
12889
12936
  /** MIME types / extensions accepted (e.g. `"image/*,.pdf"`). */
@@ -12920,101 +12967,6 @@ export declare type NiceFileSortDir = 'asc' | 'desc';
12920
12967
  /** Sortable field for the {@link NiceFileManager} detail view. */
12921
12968
  export declare type NiceFileSortField = 'name' | 'size' | 'modified' | 'extension';
12922
12969
 
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
12970
  export declare const NiceFilterBuilder: default_2.FC<NiceFilterBuilderProps>;
13019
12971
 
13020
12972
  /** Props for the {@link NiceFilterBuilder} component — a visual query builder for complex AND/OR filter trees. */
@@ -13454,6 +13406,12 @@ export declare interface NiceGalleryProps extends NiceStandardProps {
13454
13406
  height?: number | string;
13455
13407
  /** Number of thumbnails visible in the strip carousel window (default 4). */
13456
13408
  thumbnailWindow?: number;
13409
+ /**
13410
+ * Background colour of the letterbox/pillarbox bars shown behind an image
13411
+ * whose aspect ratio doesn't fill the frame. Defaults to the theme background
13412
+ * when omitted.
13413
+ */
13414
+ frameColor?: string;
13457
13415
  }
13458
13416
 
13459
13417
  export declare const NiceGamepad: default_2.FC<NiceGamepadProps>;
@@ -13768,8 +13726,18 @@ export declare interface NiceGradientPickerProps extends NiceBaseProps {
13768
13726
  /** Maximum number of gradient stops */
13769
13727
  maxStops?: number;
13770
13728
  label?: string;
13729
+ /** Label position relative to the swatch. Default `'top'`. */
13730
+ labelPlacement?: 'top' | 'left';
13771
13731
  disabled?: boolean;
13772
- /** Fixed width of the whole control. Defaults to 320px so the layout stays stable when stops are added. */
13732
+ /** Looks enabled but the popup won't open and edits are blocked. */
13733
+ readOnly?: boolean;
13734
+ /** Show a loading spinner and dim the control. */
13735
+ loading?: boolean;
13736
+ /** Error ring; a string value also renders the message. */
13737
+ error?: string | boolean;
13738
+ /** Where the error message sits: below (default) or inline to the right. */
13739
+ errorPlacement?: 'bottom' | 'right';
13740
+ /** Fixed width of the popup. Defaults to 340px. */
13773
13741
  width?: string | number;
13774
13742
  }
13775
13743
 
@@ -13797,7 +13765,7 @@ export declare interface NiceGradientValue {
13797
13765
 
13798
13766
  export { NiceGraphQLConfig }
13799
13767
 
13800
- export declare type NiceHarmonyMode = 'monochromatic' | 'complementary' | 'split-complementary' | 'analogous' | 'triadic' | 'tetradic' | 'square' | 'shade-chain' | 'custom';
13768
+ export declare type NiceHarmonyMode = 'monochromatic' | 'complementary' | 'split-complementary' | 'analogous' | 'analogous-complementary' | 'triadic' | 'tetradic' | 'square' | 'shade-chain' | 'custom';
13801
13769
 
13802
13770
  /**
13803
13771
  * Semantic heading with decoupled visual scale. Renders the correct
@@ -14101,26 +14069,6 @@ export { NiceI18nProvider }
14101
14069
 
14102
14070
  export { NiceIcon }
14103
14071
 
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
14072
  export { NiceIconProps }
14125
14073
 
14126
14074
  export { NiceIconProvider }
@@ -14257,32 +14205,6 @@ export declare interface NiceImageEditorState {
14257
14205
  /** Available tools in the {@link NiceImageEditor} toolbar. */
14258
14206
  export declare type NiceImageEditorTool = 'crop' | 'rotate' | 'flip' | 'brightness' | 'contrast' | 'saturate' | 'blur' | 'annotate';
14259
14207
 
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
14208
  /**
14287
14209
  * {@link NiceInbox} — Full-featured email inbox with reading pane, compose, folders,
14288
14210
  * batch actions, sorting, search, and keyboard navigation.
@@ -14554,6 +14476,12 @@ export declare interface NiceKanbanBoardProps extends NiceBaseProps, TracelessSt
14554
14476
  size?: NiceSize;
14555
14477
  /** Allow columns to be collapsed */
14556
14478
  collapsible?: boolean;
14479
+ /**
14480
+ * Direction a collapsed column shrinks to (default `vertical`):
14481
+ * `vertical` → a slim vertical rail with a rotated chevron + count,
14482
+ * `horizontal` → a short horizontal bar keeping the header on one line.
14483
+ */
14484
+ collapseDirection?: 'vertical' | 'horizontal';
14557
14485
  /** Layout mode — `scroll` (default, horizontal scroll when overflowing) or `responsive` (columns wrap to fit container width). */
14558
14486
  layoutMode?: NiceKanbanLayoutMode;
14559
14487
  /** View mode (default, compact, detailed) */
@@ -15056,6 +14984,14 @@ export declare interface NiceListProps extends NiceBaseProps {
15056
14984
  emptyText?: string;
15057
14985
  /** Size preset. */
15058
14986
  size?: NiceSize;
14987
+ /** Optional header shown above the list; stays visible during loading. */
14988
+ header?: default_2.ReactNode;
14989
+ /** Disable the whole list — dimmed and inert. */
14990
+ disabled?: boolean;
14991
+ /** Read-only: items are non-interactive but not dimmed. */
14992
+ readOnly?: boolean;
14993
+ /** Error message shown in place of the list. */
14994
+ error?: string;
15059
14995
  /** Show border around the list. */
15060
14996
  bordered?: boolean;
15061
14997
  /** Swipe actions revealed on mobile swipe gesture. */
@@ -15596,6 +15532,8 @@ export declare interface NiceLookupProps extends NiceFormFieldProps {
15596
15532
  displayField?: string;
15597
15533
  /** Width of the dropdown when in mini-grid mode (CSS). */
15598
15534
  dropdownWidth?: string | number;
15535
+ /** Gap (px) between the input and the dropdown menu. Default 0 (menu abuts the input). */
15536
+ menuGap?: number;
15599
15537
  }
15600
15538
 
15601
15539
  export { NiceLookupSourceState }
@@ -16041,6 +15979,8 @@ export declare interface NiceMenuProps extends NiceBaseProps {
16041
15979
  density?: NiceMenuDensity;
16042
15980
  /** Size preset. */
16043
15981
  size?: NiceSize;
15982
+ /** Loading: dims the bar, shows a spinner and blocks interaction. */
15983
+ loading?: boolean;
16044
15984
  /** Stretch top-level items to fill the container. */
16045
15985
  fullWidth?: boolean;
16046
15986
  /** Show vertical separators between top items. */
@@ -16281,7 +16221,7 @@ export declare const NiceModuleGrid: <T extends Record<string, any>>(props: Nice
16281
16221
  ref?: ForwardedRef<HTMLDivElement>;
16282
16222
  }) => ReturnType<typeof NiceModuleGridInner>;
16283
16223
 
16284
- declare function NiceModuleGridInner<T extends Record<string, any>>(props: NiceModuleGridProps<T>, ref: ForwardedRef<HTMLDivElement>): JSX_2.Element;
16224
+ declare function NiceModuleGridInner<T extends Record<string, any>>(props: NiceModuleGridProps<T>, ref: ForwardedRef<HTMLDivElement>): JSX.Element;
16285
16225
 
16286
16226
  /**
16287
16227
  * Props for NiceModuleGrid — enterprise data grid for OmniVerk modules.
@@ -16634,43 +16574,6 @@ export declare interface NiceModuleRouteProps {
16634
16574
 
16635
16575
  export { NiceModuleStatus }
16636
16576
 
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
16577
  /**
16675
16578
  * {@link NiceNavbar} — Top navigation bar with logo, breadcrumbs, centre content,
16676
16579
  * and right-side slots for tenant switcher, notifications, and user menu.
@@ -17263,6 +17166,8 @@ export declare interface NiceNumberInputProps extends NiceFormFieldProps {
17263
17166
  suffixValue?: string;
17264
17167
  /** Called when the suffix select changes. */
17265
17168
  onSuffixChange?: (value: string, prevWeight: number | undefined, newWeight: number | undefined) => void;
17169
+ /** Show a divider line between the value and the suffix. Default `false`. */
17170
+ suffixSeparator?: boolean;
17266
17171
  }
17267
17172
 
17268
17173
  /**
@@ -17327,35 +17232,6 @@ export { NiceOnboardingAnswer }
17327
17232
 
17328
17233
  export { NiceOnboardingQuestion }
17329
17234
 
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
17235
  export { NiceOnChange }
17360
17236
 
17361
17237
  export { NiceOnOpenChange }
@@ -17576,9 +17452,15 @@ export declare interface NicePaginationProps extends NiceBaseProps {
17576
17452
  totalPages: number;
17577
17453
  /** Called when the page changes. */
17578
17454
  onChange: (page: number) => void;
17579
- /** Show "Page X of Y" info text. */
17455
+ /**
17456
+ * Show "Page X of Y" info text.
17457
+ * @default true
17458
+ */
17580
17459
  showInfo?: boolean;
17581
- /** Number of page buttons shown on each side of the current page. */
17460
+ /**
17461
+ * Number of page buttons shown on each side of the current page.
17462
+ * @default 2
17463
+ */
17582
17464
  siblingCount?: number;
17583
17465
  /** Show ⏮ / ⏭ first/last page buttons. */
17584
17466
  showFirstLast?: boolean;
@@ -17748,6 +17630,10 @@ export declare interface NicePDFViewerProps extends NiceStandardProps {
17748
17630
  maxZoom?: number;
17749
17631
  /** Viewer viewport height. */
17750
17632
  height?: number | string;
17633
+ /** Aspect ratio of the page area (CSS `aspect-ratio`). Default `'210 / 297'` (A4 portrait). */
17634
+ aspectRatio?: string;
17635
+ /** How the page fits the frame. `'page'` (default) shows the whole page at zoom 100. */
17636
+ fit?: 'width' | 'height' | 'page' | 'none';
17751
17637
  /** Called when the current page changes. */
17752
17638
  onPageChange?: (page: number) => void;
17753
17639
  /** Called when zoom level changes. */
@@ -17803,31 +17689,6 @@ export declare interface NicePermissionMatrixProps {
17803
17689
  id?: string;
17804
17690
  }
17805
17691
 
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
17692
  export declare const NicePickList: <T = unknown>(props: NicePickListProps<T> & default_2.RefAttributes<HTMLDivElement>) => default_2.ReactElement | null;
17832
17693
 
17833
17694
  /** Props for the {@link NicePickList} component — a dual-list control for moving items between source and target. */
@@ -17900,34 +17761,6 @@ export declare interface NicePieSlice {
17900
17761
  color?: string;
17901
17762
  }
17902
17763
 
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
17764
  export declare const NicePipelineEditor: default_2.FC<NicePipelineEditorProps>;
17932
17765
 
17933
17766
  export declare interface NicePipelineEditorProps extends NiceBaseProps {
@@ -17987,6 +17820,8 @@ export declare interface NicePivotField {
17987
17820
  field: string;
17988
17821
  /** Display caption. */
17989
17822
  caption: string;
17823
+ /** Data type shown beside the caption in the field chooser (e.g. `'text'`, `'integer'`, `'float'`, `'date'`). */
17824
+ dataType?: string;
17990
17825
  /** Pivot area this field belongs to. */
17991
17826
  area?: 'row' | 'column' | 'data' | 'filter';
17992
17827
  /** Aggregation function applied in the data area. */
@@ -18005,9 +17840,14 @@ export declare interface NicePivotGridFieldChooserProps extends NiceBaseProps {
18005
17840
  fields: NicePivotField[];
18006
17841
  /** Called when the user rearranges fields. */
18007
17842
  onChange: (fields: NicePivotField[]) => void;
17843
+ /**
17844
+ * Show a per-field area `NiceSelect` as an explicit (accessible) alternative to
17845
+ * drag-and-drop. Off by default — assignment is drag-and-drop first.
17846
+ */
17847
+ showAreaSelect?: boolean;
18008
17848
  }
18009
17849
 
18010
- /** Props for the {@link NicePivotGrid} component — a cross-tab / pivot table with drag-and-drop field chooser, CSV export, and drill-through. */
17850
+ /** Props for the {@link NicePivotGrid} component — a cross-tab / pivot table with drag-and-drop field chooser, CSV/XLSX export, and drill-through. */
18011
17851
  export declare interface NicePivotGridProps extends NiceBaseProps {
18012
17852
  /** Raw data records. */
18013
17853
  data: Record<string, any>[];
@@ -18021,9 +17861,11 @@ export declare interface NicePivotGridProps extends NiceBaseProps {
18021
17861
  loading?: boolean;
18022
17862
  /** Text shown when data is empty. */
18023
17863
  emptyText?: string;
18024
- /** Enable CSV export. */
17864
+ /** Heading rendered at the left of the toolbar; the action buttons sit at its right. */
17865
+ headerText?: string;
17866
+ /** Enable data export (download menu offering CSV and XLSX). */
18025
17867
  exportCsv?: boolean;
18026
- /** Filename for CSV export. */
17868
+ /** Filename for exports (extension is appended). */
18027
17869
  exportFilename?: string;
18028
17870
  /** Callback when user clicks a cell to drill-through to underlying records. */
18029
17871
  onDrillThrough?: (rowValue: string, colValue: string, records: Record<string, any>[]) => void;
@@ -18188,7 +18030,7 @@ export declare const NicePresenceCursors: default_2.ForwardRefExoticComponent<Ni
18188
18030
 
18189
18031
  export declare interface NicePresenceCursorsProps extends NiceBaseProps {
18190
18032
  /** Container ref for cursor positioning */
18191
- containerRef?: default_2.RefObject<HTMLElement>;
18033
+ containerRef?: default_2.RefObject<HTMLElement | null>;
18192
18034
  /** Show user name label */
18193
18035
  showLabel?: boolean;
18194
18036
  /** Label fade delay (ms) */
@@ -18439,10 +18281,26 @@ export declare interface NiceQRCodeProps extends NiceStandardProps {
18439
18281
  * what the user types. Off by default — pass `showInput` to enable.
18440
18282
  */
18441
18283
  showInput?: boolean;
18442
- /** Label for the built-in input (only when `showInput`). */
18284
+ /**
18285
+ * Alias for {@link showInput}. When `editable` is provided it takes precedence:
18286
+ * `editable={false}` hides the input (QR still renders), `editable` shows it.
18287
+ */
18288
+ editable?: boolean;
18289
+ /** Label for the built-in input (only when the input is shown). */
18443
18290
  inputLabel?: string;
18444
- /** Placeholder for the built-in input (only when `showInput`). */
18291
+ /** Placeholder for the built-in input (only when the input is shown). */
18445
18292
  inputPlaceholder?: string;
18293
+ /** Where to place the built-in input's label (forwarded to {@link NiceTextInput}). */
18294
+ labelPlacement?: NiceTextInputProps['labelPlacement'];
18295
+ /**
18296
+ * Extra props forwarded to the built-in {@link NiceTextInput}, so the top editor
18297
+ * is a fully-featured NiceTextInput (variant, prefix/suffix, clearable, helperText,
18298
+ * error, disabled, readOnly, …). Explicit props (`inputLabel`, `inputPlaceholder`,
18299
+ * `labelPlacement`, `size`) win over the same keys here.
18300
+ */
18301
+ inputProps?: Partial<NiceTextInputProps>;
18302
+ /** Fires with the new value whenever the user edits the built-in input. */
18303
+ onValueChange?: (value: string) => void;
18446
18304
  }
18447
18305
 
18448
18306
  /** Reed-Solomon error correction level for QR codes. */
@@ -18569,12 +18427,12 @@ export declare interface NiceRangeSliderProps extends NiceFormFieldProps {
18569
18427
  max?: number;
18570
18428
  /** Step increment. */
18571
18429
  step?: number;
18572
- /** Start (lower) thumb value. */
18573
- startValue: number;
18574
- /** End (upper) thumb value. */
18575
- endValue: number;
18430
+ /** Start (lower) thumb value. Defaults to `min`. */
18431
+ startValue?: number;
18432
+ /** End (upper) thumb value. Defaults to `max`. */
18433
+ endValue?: number;
18576
18434
  /** Called when either thumb moves. */
18577
- onChange: (start: number, end: number) => void;
18435
+ onChange?: (start: number, end: number) => void;
18578
18436
  /** Show value labels at each thumb. */
18579
18437
  showLabels?: boolean;
18580
18438
  /** Custom label formatter. */
@@ -19983,11 +19841,9 @@ export declare interface NiceSectionProps extends NiceStandardProps {
19983
19841
  * - `NiceButtonGroup` — visual cluster of independent action buttons
19984
19842
  * (Save / Cancel, Bold / Italic / Underline). Each child is its own
19985
19843
  * `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.
19844
+ * `<NiceButton leftIcon={...} />`.
19989
19845
  */
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;
19846
+ 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
19847
 
19992
19848
  export declare namespace NiceSegmentedControl {
19993
19849
  var displayName: string;
@@ -20008,6 +19864,19 @@ export declare interface NiceSegmentedControlProps<T = string> {
20008
19864
  block?: boolean;
20009
19865
  /** Disabled state */
20010
19866
  disabled?: boolean;
19867
+ /** Read-only: segments are inert but NOT greyed (unlike disabled). */
19868
+ readOnly?: boolean;
19869
+ /** Loading: shows a spinner overlay + aria-busy and blocks interaction. */
19870
+ loading?: boolean;
19871
+ /** Error message — red outline + message shown below the control. */
19872
+ error?: string;
19873
+ /**
19874
+ * Active highlight fills the container's inner edges (no surrounding sliver).
19875
+ * Default true; set false to keep the padded look with slivers.
19876
+ */
19877
+ highlightFill?: boolean;
19878
+ /** Error/validation position: 'bottom' (default) or 'right'. */
19879
+ errorPlacement?: 'bottom' | 'right';
20011
19880
  /** Extra class name */
20012
19881
  className?: string;
20013
19882
  /** Inline styles */
@@ -20464,27 +20333,6 @@ export declare interface NiceSignatureData {
20464
20333
 
20465
20334
  export declare type NiceSignatureOutput = 'png' | 'jpeg' | 'svg';
20466
20335
 
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
20336
  export declare interface NiceSignaturePoint {
20489
20337
  x: number;
20490
20338
  y: number;
@@ -20497,6 +20345,12 @@ export declare interface NiceSignatureProps {
20497
20345
  value?: NiceSignatureData | null;
20498
20346
  /** Value change callback */
20499
20347
  onChange?: (data: NiceSignatureData | null) => void;
20348
+ /** Convenience callback emitting the signature as a PNG data URL (null when
20349
+ * cleared) — for form consumers that bind a string value. Ported from the
20350
+ * former NiceSignaturePad. */
20351
+ onChangeDataUrl?: (url: string | null) => void;
20352
+ /** Field label shown above the pad. */
20353
+ label?: string;
20500
20354
  /** Width */
20501
20355
  width?: number | string;
20502
20356
  /** Height */
@@ -20613,6 +20467,10 @@ export declare interface NiceSkeletonProps extends Omit<NiceStandardProps, 'vari
20613
20467
  height?: string | number;
20614
20468
  /** Number of skeleton rows to render (text variant). */
20615
20469
  count?: number;
20470
+ /** Lay multiple rows out as a column (default) or a row of bars. */
20471
+ orientation?: 'horizontal' | 'vertical';
20472
+ /** Shimmer animation duration in seconds (default 1.8). */
20473
+ animationSpeed?: number;
20616
20474
  }
20617
20475
 
20618
20476
  export { NiceSkipLink }
@@ -20775,8 +20633,11 @@ export declare interface NiceSpeechToTextProps extends NiceBaseProps {
20775
20633
 
20776
20634
  export declare const NiceSpeedDialAction: default_2.FC<NiceSpeedDialProps>;
20777
20635
 
20636
+ /** Direction in which the {@link NiceSpeedDialAction} fans out its action items. */
20637
+ export declare type NiceSpeedDialDirection = 'up' | 'down' | 'left' | 'right';
20638
+
20778
20639
  /** A single action in the {@link NiceSpeedDialAction} floating menu. */
20779
- declare interface NiceSpeedDialItem {
20640
+ export declare interface NiceSpeedDialItem {
20780
20641
  /** Unique identifier. */
20781
20642
  key: string;
20782
20643
  /** Icon element. */
@@ -20789,12 +20650,12 @@ declare interface NiceSpeedDialItem {
20789
20650
 
20790
20651
  /** Props for the {@link NiceSpeedDialAction} component — a floating action button with expandable actions. */
20791
20652
  export declare interface NiceSpeedDialProps extends NiceBaseProps {
20792
- /** Icon for the trigger FAB button. */
20653
+ /** Icon for the trigger FAB button. Defaults to a built-in plus icon. */
20793
20654
  icon?: default_2.ReactNode;
20794
20655
  /** Action items that fan out when expanded. */
20795
20656
  items: NiceSpeedDialItem[];
20796
- /** Direction in which the action items expand. */
20797
- direction?: 'up' | 'down' | 'left' | 'right';
20657
+ /** Direction in which the action items expand. Defaults to `'right'`. */
20658
+ direction?: NiceSpeedDialDirection;
20798
20659
  /** CSS position offset for fixed placement (e.g. bottom-right corner). */
20799
20660
  position?: {
20800
20661
  bottom?: number;
@@ -20802,6 +20663,8 @@ export declare interface NiceSpeedDialProps extends NiceBaseProps {
20802
20663
  top?: number;
20803
20664
  left?: number;
20804
20665
  };
20666
+ /** Disables the trigger and hides the actions. */
20667
+ disabled?: boolean;
20805
20668
  }
20806
20669
 
20807
20670
  export declare const NiceSpinner: default_2.FC<NiceSpinnerProps>;
@@ -20895,6 +20758,14 @@ export declare interface NiceSpreadsheetProps extends NiceBaseProps {
20895
20758
  showSheetTabs?: boolean;
20896
20759
  /** Make the entire spreadsheet read-only. */
20897
20760
  readOnly?: boolean;
20761
+ /** Disabled: dimmed + inert (blocks editing/selection). */
20762
+ disabled?: boolean;
20763
+ /** Loading: a spinner overlay + aria-busy. */
20764
+ loading?: boolean;
20765
+ /** Error message shown above the grid. */
20766
+ error?: string;
20767
+ /** Density size (xs..xl) — scales cell padding + font. */
20768
+ size?: NiceSize;
20898
20769
  /** Called when any cell data changes. */
20899
20770
  onChange?: (sheets: NiceSpreadsheetSheet[]) => void;
20900
20771
  /** Called when the active sheet tab changes. */
@@ -21361,7 +21232,7 @@ export declare interface NiceTabItem {
21361
21232
  content?: default_2.ReactNode;
21362
21233
  }
21363
21234
 
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;
21235
+ 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
21236
 
21366
21237
  /** Column definition for the {@link NiceTable} component. */
21367
21238
  export declare interface NiceTableColumn<T = any> {
@@ -21389,42 +21260,12 @@ export declare interface NiceTableProps<T extends Record<string, any> = any> ext
21389
21260
  striped?: boolean;
21390
21261
  /** Reduced padding. */
21391
21262
  compact?: boolean;
21263
+ /** Table size (font + cell padding). Independent of `compact`. */
21264
+ size?: NiceSize;
21392
21265
  /** Text shown when `data` is empty. */
21393
21266
  emptyText?: string;
21394
21267
  }
21395
21268
 
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
21269
  export declare const NiceTabs: default_2.FC<NiceTabsProps>;
21429
21270
 
21430
21271
  /** Props for the {@link NiceTabs} component — a tabbed content panel. */
@@ -21441,6 +21282,16 @@ export declare interface NiceTabsProps extends NiceBaseProps {
21441
21282
  size?: NiceSize;
21442
21283
  /** Stack tabs vertically. */
21443
21284
  vertical?: boolean;
21285
+ /** Show only the tab icons (labels move to the tooltip / aria-label). */
21286
+ iconOnly?: boolean;
21287
+ /** Center the tab strip. `'auto'` (default) centers only when `iconOnly`. */
21288
+ centered?: boolean | 'auto';
21289
+ /**
21290
+ * Where a tab's `badge`/count sits relative to the icon+label:
21291
+ * `'right'` (default) — inline after the label; `'bottom'` — stacked under the
21292
+ * icon as a heavily-rounded pill rectangle (not a circle).
21293
+ */
21294
+ countLocation?: 'right' | 'bottom';
21444
21295
  }
21445
21296
 
21446
21297
  export declare const NiceTag: default_2.FC<NiceTagProps>;
@@ -21582,29 +21433,6 @@ export declare interface NiceTaskInboxProps extends NiceBaseProps {
21582
21433
  onRefresh?: () => void;
21583
21434
  }
21584
21435
 
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
21436
  export declare const NiceTempDial: default_2.FC<NiceTempDialProps>;
21609
21437
 
21610
21438
  export declare interface NiceTempDialProps extends NiceBaseProps {
@@ -21620,30 +21448,6 @@ export declare interface NiceTempDialProps extends NiceBaseProps {
21620
21448
  disabled?: boolean;
21621
21449
  }
21622
21450
 
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
21451
  /** A single line of terminal output in the {@link NiceTerminalUI}. */
21648
21452
  export declare interface NiceTerminalLine {
21649
21453
  /** Line type — determines styling (green for input, red for error, grey for system). */
@@ -21654,6 +21458,9 @@ export declare interface NiceTerminalLine {
21654
21458
  timestamp?: Date;
21655
21459
  }
21656
21460
 
21461
+ /** Colour scheme for the {@link NiceTerminalUI}. */
21462
+ export declare type NiceTerminalTheme = 'auto' | 'dark' | 'matrix';
21463
+
21657
21464
  export declare const NiceTerminalUI: ForwardRefExoticComponent<NiceTerminalUIProps & RefAttributes<HTMLDivElement>>;
21658
21465
 
21659
21466
  /** Props for the {@link NiceTerminalUI} component — a retro terminal / console emulator. */
@@ -21664,9 +21471,19 @@ export declare interface NiceTerminalUIProps extends NiceStandardProps {
21664
21471
  prompt?: string;
21665
21472
  /** Called when the user presses Enter with a command. */
21666
21473
  onCommand?: (command: string) => void;
21667
- /** Disable user input. */
21474
+ /** Disable user input (log-viewer mode — hides the input row). */
21668
21475
  readOnly?: boolean;
21669
- /** Terminal size preset. */
21476
+ /** Disabled: dims the terminal and blocks input. */
21477
+ disabled?: boolean;
21478
+ /** Error message rendered as an alert banner at the top of the terminal. */
21479
+ error?: string | boolean;
21480
+ /**
21481
+ * Colour scheme. `auto` (default) follows the page theme via canonical tokens
21482
+ * (light terminal in a light theme, dark in a dark theme); `dark` pins the
21483
+ * classic VS Code palette; `matrix` is black + green.
21484
+ */
21485
+ theme?: NiceTerminalTheme;
21486
+ /** Terminal size preset (scales the monospace font). */
21670
21487
  size?: NiceSize;
21671
21488
  /** Terminal viewport height. */
21672
21489
  height?: number | string;
@@ -21993,55 +21810,6 @@ export { NiceThemeShadows }
21993
21810
 
21994
21811
  export { NiceThemeSpacing }
21995
21812
 
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
21813
  export { NiceThemeText }
22046
21814
 
22047
21815
  export { NiceThemeTransitions }
@@ -22102,8 +21870,8 @@ export declare interface NiceTimelineItem {
22102
21870
  subtitle?: default_2.ReactNode;
22103
21871
  /** Body content */
22104
21872
  content?: default_2.ReactNode;
22105
- /** Custom icon in the dot */
22106
- icon?: default_2.ReactNode;
21873
+ /** Custom icon in the dot — a built-in icon name (e.g. `'check'`) or any React node. */
21874
+ icon?: default_2.ReactNode | string;
22107
21875
  /** Dot color override */
22108
21876
  color?: string;
22109
21877
  }
@@ -22116,6 +21884,11 @@ export declare interface NiceTimelineProps extends NiceStandardProps {
22116
21884
  mode?: 'left' | 'right' | 'alternate' | 'horizontal';
22117
21885
  /** Size of timeline dots and spacing */
22118
21886
  size?: NiceSize;
21887
+ /**
21888
+ * Render as a slice of a larger timeline: draws a leading line before the
21889
+ * first item and a trailing line after the last (so it reads as an excerpt).
21890
+ * Default false. */
21891
+ isFragment?: boolean;
22119
21892
  /** Custom renderer for each item */
22120
21893
  renderItem?: (item: NiceTimelineItem, index: number) => default_2.ReactNode;
22121
21894
  }
@@ -22137,49 +21910,6 @@ export declare interface NiceTimeoutFeedbackProps extends NiceStandardProps {
22137
21910
  loading: boolean;
22138
21911
  }
22139
21912
 
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
21913
  export declare const NiceToastContainer: default_2.FC<ToastContainerProps>;
22184
21914
 
22185
21915
  /** Data object describing a single toast notification. */
@@ -22275,36 +22005,6 @@ export declare interface NiceToggleProps extends NiceBaseProps {
22275
22005
 
22276
22006
  export { NiceTone }
22277
22007
 
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
22008
  export declare const NiceTooltip: default_2.FC<NiceTooltipProps>;
22309
22009
 
22310
22010
  /** Props for the {@link NiceTooltip} component — shows contextual information on hover/focus. */
@@ -22313,14 +22013,20 @@ export declare interface NiceTooltipProps {
22313
22013
  size?: NiceSize;
22314
22014
  /** Tooltip content (text or rich elements). */
22315
22015
  content: default_2.ReactNode;
22316
- /** Preferred placement relative to the trigger. */
22317
- position?: 'top' | 'bottom' | 'left' | 'right';
22016
+ /**
22017
+ * Placement relative to the trigger. `'auto'` (default) picks the side with
22018
+ * the most room so the tooltip stays on-screen (collision detection).
22019
+ */
22020
+ position?: NiceTooltipSide | 'auto';
22318
22021
  /** Tooltip follows cursor position */
22319
22022
  followCursor?: boolean;
22320
22023
  /** Trigger element that the tooltip wraps. */
22321
- children: default_2.ReactElement;
22024
+ children: default_2.ReactElement<any>;
22322
22025
  }
22323
22026
 
22027
+ /** Concrete side a tooltip can be placed on (after `'auto'` is resolved). */
22028
+ declare type NiceTooltipSide = 'top' | 'bottom' | 'left' | 'right';
22029
+
22324
22030
  export declare const NiceTopNav: default_2.ForwardRefExoticComponent<NiceTopNavProps & default_2.RefAttributes<HTMLElement>>;
22325
22031
 
22326
22032
  export declare type NiceTopNavDensity = 'compact' | 'normal' | 'comfortable';
@@ -22678,7 +22384,7 @@ export declare interface NiceTreeContextMenuItem {
22678
22384
  disabled?: boolean;
22679
22385
  }
22680
22386
 
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;
22387
+ 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
22388
 
22683
22389
  /** A row node in the {@link NiceTreeGrid} (supports index-signature for dynamic fields). */
22684
22390
  export declare interface NiceTreeGridNode {
@@ -22727,8 +22433,16 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
22727
22433
  striped?: boolean;
22728
22434
  /** Reduced padding. */
22729
22435
  compact?: boolean;
22436
+ /** Grid density size (xs..xl) — scales row padding + font. */
22437
+ size?: NiceSize;
22730
22438
  /** Show a loading skeleton. */
22731
22439
  loading?: boolean;
22440
+ /** Disable the whole grid — dimmed and inert. */
22441
+ disabled?: boolean;
22442
+ /** Read-only: rows non-interactive (no selection/row-click) but not dimmed; expand/collapse still works. */
22443
+ readOnly?: boolean;
22444
+ /** Error message shown in place of the grid body. */
22445
+ error?: string;
22732
22446
  /** Text shown when data is empty. */
22733
22447
  emptyText?: string;
22734
22448
  /** Toolbar content rendered above the grid. */
@@ -22737,7 +22451,7 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
22737
22451
  onRowClick?: (row: T) => void;
22738
22452
  }
22739
22453
 
22740
- export declare function NiceTreeList<T extends NiceTreeListNode>({ columns, data, keyField, parentKeyField, expandedKeys: controlledExpanded, onExpandedChange, selectedKeys, onSelectionChange, selectable, loading, emptyText, className, style, accessMode, id, }: NiceTreeListProps<T>): default_2.JSX.Element | null;
22454
+ export declare function NiceTreeList<T extends NiceTreeListNode>({ columns, data, keyField, parentKeyField, expandedKeys: controlledExpanded, onExpandedChange, selectedKeys, onSelectionChange, selectable, sortable, loading, emptyText, className, style, accessMode, id, }: NiceTreeListProps<T>): default_2.JSX.Element | null;
22741
22455
 
22742
22456
  /** A tree-list node for the {@link NiceTreeList} component. */
22743
22457
  export declare interface NiceTreeListNode {
@@ -22769,8 +22483,10 @@ export declare interface NiceTreeListProps<T extends NiceTreeListNode = NiceTree
22769
22483
  selectedKeys?: string[];
22770
22484
  /** Called when selection changes. */
22771
22485
  onSelectionChange?: (keys: string[]) => void;
22772
- /** Enable row selection. */
22486
+ /** Enable row selection. Checking a parent row cascades to all its descendants. */
22773
22487
  selectable?: boolean;
22488
+ /** Enable column sorting (opt-in per column via `NiceDataGridColumn.sortable`). */
22489
+ sortable?: boolean;
22774
22490
  /** Show a loading skeleton. */
22775
22491
  loading?: boolean;
22776
22492
  /** Text shown when data is empty. */
@@ -22886,6 +22602,8 @@ export declare interface NiceTreeSelectProps extends NiceFormFieldProps {
22886
22602
  * leaves (children not rendered, no expand toggle). Default: unlimited.
22887
22603
  */
22888
22604
  maxDepth?: number;
22605
+ /** Gap (px) between the input and the dropdown menu. Default 0 (menu abuts the input). */
22606
+ menuGap?: number;
22889
22607
  }
22890
22608
 
22891
22609
  export declare const NiceTreeView: default_2.FC<NiceTreeViewProps>;
@@ -22894,6 +22612,11 @@ export declare const NiceTreeView: default_2.FC<NiceTreeViewProps>;
22894
22612
  export declare interface NiceTreeViewProps extends NiceBaseProps {
22895
22613
  /** Root nodes. */
22896
22614
  nodes: NiceTreeNode[];
22615
+ /**
22616
+ * Optional header rendered above the (optional) search box and the tree —
22617
+ * a title bar, toolbar or count. Pass any node; omit for no header.
22618
+ */
22619
+ header?: default_2.ReactNode;
22897
22620
  /** Currently selected node keys. */
22898
22621
  selectedKeys?: string[];
22899
22622
  /** Currently expanded node keys. */
@@ -23232,41 +22955,75 @@ export declare interface NiceUpdatePromptProps extends NiceBaseProps, UseService
23232
22955
 
23233
22956
  export declare const NiceUpload: default_2.ForwardRefExoticComponent<NiceUploadProps & default_2.RefAttributes<HTMLDivElement>>;
23234
22957
 
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. */
22958
+ /** Imperative handle, exposed via the optional `apiRef` prop (not the div `ref`). */
22959
+ export declare interface NiceUploadHandle {
22960
+ addFiles: (files: File[]) => void;
22961
+ uploadAll: () => void;
22962
+ cancelAll: () => void;
22963
+ clearAll: () => void;
22964
+ getFiles: () => FileInfo[];
22965
+ getFile: (id: string) => FileInfo | undefined;
22966
+ retryFailed: () => void;
22967
+ openFileBrowser: () => void;
22968
+ }
22969
+
22970
+ /** Props for {@link NiceUpload} — drag-and-drop / button file upload with an
22971
+ * optional upload engine (progress, retry/cancel, chunked upload, validation,
22972
+ * previews) absorbed from the former NiceFileUpload. The legacy `NiceFileUploader`
22973
+ * export was retired in favour of this component. */
23240
22974
  export declare interface NiceUploadProps extends NiceBaseProps {
23241
22975
  accept?: string;
23242
22976
  multiple?: boolean;
23243
22977
  maxFileSize?: number;
23244
22978
  maxFiles?: number;
22979
+ minFileSize?: number;
22980
+ /** Fires with the current File[] on every add/remove (instant) / Upload click. */
23245
22981
  onFilesSelected: (files: File[]) => void;
23246
22982
  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
22983
  labelText?: string;
23253
- /**
23254
- * i18n-ready text shown inside the dropzone. When omitted, the
23255
- * built-in translation key `dropOrClick` is used.
23256
- */
22984
+ /** Idle dropzone label; pass `""` for an icon-only dropzone. */
23257
22985
  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
- */
22986
+ dropzoneText?: string;
22987
+ browseText?: string;
22988
+ dragActiveText?: string;
22989
+ /** Icon/label layout in the dropzone: `'right'` (label beside the icon, default) or `'bottom'` (label under it). */
22990
+ labelPlacement?: 'right' | 'bottom';
23262
22991
  icon?: string | null;
23263
22992
  showFileList?: boolean;
23264
- disabled?: boolean;
23265
- /** Show image thumbnails for image files */
23266
22993
  imagePreview?: boolean;
23267
- /** Per-file progress values 0-100 keyed by file name */
22994
+ showPreview?: boolean;
22995
+ listMode?: 'list' | 'grid' | 'compact';
22996
+ previewSize?: NiceSize;
22997
+ /** External progress override keyed by `file.name` (0–100). */
23268
22998
  fileProgress?: Record<string, number>;
23269
- /** Enable paste from clipboard (Ctrl+V) */
22999
+ renderPreview?: (file: FileInfo) => default_2.ReactNode;
23000
+ renderFileItem?: (file: FileInfo, actions: FileItemActions) => default_2.ReactNode;
23001
+ variant?: 'dropzone' | 'button';
23002
+ /** Custom content for `variant="button"`. */
23003
+ trigger?: default_2.ReactNode;
23004
+ /** Custom clickable/droppable surface content (replaces the default icon+label). */
23005
+ dropChildren?: default_2.ReactNode;
23006
+ autoUpload?: boolean;
23007
+ uploadHandler?: UploadHandler;
23008
+ uploadUrl?: string;
23009
+ uploadHeaders?: Record<string, string>;
23010
+ concurrentUploads?: number;
23011
+ maxRetries?: number;
23012
+ chunkSize?: number;
23013
+ chunkThreshold?: number;
23014
+ validateFile?: (file: File) => string | null;
23015
+ keepFilesAfterUpload?: boolean;
23016
+ initialFiles?: FileInfo[];
23017
+ disabled?: boolean;
23018
+ readOnly?: boolean;
23019
+ onFilesAdded?: (files: FileInfo[]) => void;
23020
+ onUploadComplete?: (file: FileInfo) => void;
23021
+ onUploadError?: (file: FileInfo, error: string) => void;
23022
+ onProgress?: (file: FileInfo, progress: number) => void;
23023
+ onFileRemoved?: (file: FileInfo) => void;
23024
+ onChange?: (files: FileInfo[]) => void;
23025
+ apiRef?: default_2.Ref<NiceUploadHandle>;
23026
+ /** Enable paste from clipboard (Ctrl+V). */
23270
23027
  pasteFromClipboard?: boolean;
23271
23028
  }
23272
23029
 
@@ -23422,40 +23179,6 @@ export declare interface NiceValidatorProps extends NiceBaseProps {
23422
23179
 
23423
23180
  export { NiceVariant }
23424
23181
 
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
23182
  export declare const NiceVectorMap: default_2.FC<NiceVectorMapProps>;
23460
23183
 
23461
23184
  /** Props for the {@link NiceVectorMap} component — an SVG choropleth map with region selection and tooltips. */
@@ -24118,6 +23841,12 @@ export declare interface NiceVirtualScrollerProps<T = unknown> extends NiceStand
24118
23841
  renderItem: (item: T, index: number) => default_2.ReactNode;
24119
23842
  /** Optional item key extractor */
24120
23843
  itemKey?: (item: T, index: number) => string | number;
23844
+ /** Disable interaction and dim the list. */
23845
+ disabled?: boolean;
23846
+ /** Read-only marker (a scroller is already read-only; kept for API parity). */
23847
+ readOnly?: boolean;
23848
+ /** Error message — shown as an alert in place of the list. */
23849
+ error?: string;
24121
23850
  }
24122
23851
 
24123
23852
  export { NiceVisuallyHidden }
@@ -24928,23 +24657,6 @@ export declare interface Person {
24928
24657
  metadata?: Record<string, any>;
24929
24658
  }
24930
24659
 
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
24660
  export { PinchGesture }
24949
24661
 
24950
24662
  declare interface Pipeline {
@@ -27292,22 +27004,6 @@ export declare type TaskPriority = 'low' | 'medium' | 'high' | 'critical';
27292
27004
 
27293
27005
  export declare type TaskStatus = 'pending' | 'claimed' | 'inProgress' | 'completed' | 'delegated' | 'expired';
27294
27006
 
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
27007
  export declare type TempDialMode = 'heat' | 'cool' | 'auto' | 'off';
27312
27008
 
27313
27009
  declare type TemplateEngine = 'handlebars' | 'ejs' | 'mustache' | 'simple';
@@ -27338,19 +27034,6 @@ declare interface TemplateVariable {
27338
27034
  };
27339
27035
  }
27340
27036
 
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
27037
  declare type TestAction = 'render' | 'click' | 'type' | 'select' | 'hover' | 'focus' | 'blur' | 'submit' | 'keypress' | 'wait' | 'scroll' | 'drag' | 'assert' | 'snapshot' | 'a11y-check';
27355
27038
 
27356
27039
  declare interface TestCase {
@@ -27522,22 +27205,6 @@ export { themeOneDark }
27522
27205
 
27523
27206
  export { themeOnyx }
27524
27207
 
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
27208
  export { themeOrange }
27542
27209
 
27543
27210
  export { themePastelCoral }
@@ -27558,11 +27225,6 @@ export { themePastelSky }
27558
27225
 
27559
27226
  export { themePink }
27560
27227
 
27561
- /**
27562
- * Built-in theme presets.
27563
- */
27564
- export declare type ThemePreset = 'light' | 'dark' | 'system' | 'custom';
27565
-
27566
27228
  /** Colours used to render a theme preview thumbnail. All optional except `background`. */
27567
27229
  export declare interface ThemePreviewColors {
27568
27230
  /** Main page background. */
@@ -27625,27 +27287,6 @@ export { themeSummerBeach }
27625
27287
 
27626
27288
  export { themeSunset }
27627
27289
 
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
27290
  export { themeSynthwave }
27650
27291
 
27651
27292
  export { themeTeal }
@@ -28313,7 +27954,7 @@ export declare interface UploadResponse {
28313
27954
  url?: string;
28314
27955
  error?: string;
28315
27956
  fileId?: string;
28316
- metadata?: Record<string, any>;
27957
+ metadata?: Record<string, unknown>;
28317
27958
  }
28318
27959
 
28319
27960
  export declare type UploadStatus = 'pending' | 'uploading' | 'success' | 'error' | 'cancelled';
@@ -28606,7 +28247,7 @@ export { useIsTouchDevice }
28606
28247
  /**
28607
28248
  * Hook for intersection observer based lazy loading
28608
28249
  */
28609
- export declare function useLazyOnVisible(threshold?: number, rootMargin?: string): [default_2.RefObject<HTMLDivElement>, boolean];
28250
+ export declare function useLazyOnVisible(threshold?: number, rootMargin?: string): [default_2.RefObject<HTMLDivElement | null>, boolean];
28610
28251
 
28611
28252
  export { useLiveAnnouncement }
28612
28253
 
@@ -29207,20 +28848,6 @@ declare type ValidationType = 'required' | 'type' | 'min' | 'max' | 'pattern' |
29207
28848
 
29208
28849
  export { VARIANT_PRESETS }
29209
28850
 
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
28851
  /** Author/User information */
29225
28852
  declare interface VersioningAuthor {
29226
28853
  id: string;