@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/editors.d.ts CHANGED
@@ -83,7 +83,7 @@ declare interface BlurAnnotation extends AnnotationBase {
83
83
  intensity: number;
84
84
  }
85
85
 
86
- declare interface ChunkInfo {
86
+ export declare interface ChunkInfo {
87
87
  index: number;
88
88
  start: number;
89
89
  end: number;
@@ -124,14 +124,6 @@ declare interface CropResult {
124
124
  zoom: number;
125
125
  }
126
126
 
127
- /** Currency definition. */
128
- export declare interface CurrencyDef {
129
- code: string;
130
- symbol: string;
131
- name: string;
132
- decimals?: number;
133
- }
134
-
135
127
  declare interface CustomEmoji {
136
128
  id: string;
137
129
  name: string;
@@ -172,22 +164,26 @@ export declare const EMOJI_DATA: Emoji[];
172
164
 
173
165
  declare type EmojiCategory = 'recent' | 'smileys' | 'people' | 'animals' | 'food' | 'travel' | 'activities' | 'objects' | 'symbols' | 'flags';
174
166
 
175
- declare interface FileInfo {
167
+ /** Per-file record tracked by {@link NiceUpload}. */
168
+ export declare interface FileInfo {
176
169
  id: string;
177
170
  file: File;
178
171
  name: string;
179
172
  size: number;
180
173
  type: string;
181
174
  status: UploadStatus;
175
+ /** 0–100. */
182
176
  progress: number;
183
177
  error?: string;
178
+ /** Object URL for image/video/audio previews. */
184
179
  previewUrl?: string;
180
+ /** Server-returned URL after a successful upload. */
185
181
  uploadedUrl?: string;
186
182
  uploadedAt?: Date;
187
183
  chunks?: ChunkInfo[];
188
184
  }
189
185
 
190
- declare interface FileItemActions {
186
+ export declare interface FileItemActions {
191
187
  upload: () => void;
192
188
  cancel: () => void;
193
189
  retry: () => void;
@@ -316,6 +312,14 @@ export declare interface NiceAutocompleteProps extends NiceFormFieldProps {
316
312
  highlightMatch?: boolean;
317
313
  /** Alias for options — array of string suggestions. */
318
314
  suggestions?: (string | NiceOption)[];
315
+ /**
316
+ * When `true` (default), focusing the field (before typing) opens the dropdown
317
+ * with **all** options sorted alphabetically. Set `false` to only show
318
+ * suggestions once the user has typed `minSearchLength` characters.
319
+ */
320
+ showAll?: boolean;
321
+ /** Gap (px) between the input and the suggestion menu. Default 0 (menu abuts the input). */
322
+ menuGap?: number;
319
323
  }
320
324
 
321
325
  export declare const NiceCalendar: default_2.FC<NiceCalendarProps>;
@@ -337,6 +341,24 @@ export declare interface NiceCalendarProps extends NiceBaseProps, TracelessStora
337
341
  /** Array of selected dates when multiple=true. */
338
342
  selectedDates?: string[];
339
343
  onSelectedDatesChange?: (dates: string[]) => void;
344
+ /**
345
+ * `'single'` (default) selects one day via `value`/`onChange`. `'range'`
346
+ * selects a start/end pair in two clicks, driven by `rangeStart`/`rangeEnd`
347
+ * and reported through `onRangeChange`.
348
+ */
349
+ selectionMode?: 'single' | 'range';
350
+ /** First day of the selected range (ISO), when `selectionMode='range'`. */
351
+ rangeStart?: string;
352
+ /** Last day of the selected range (ISO), when `selectionMode='range'`. */
353
+ rangeEnd?: string;
354
+ /**
355
+ * Fires on every range edit. The first click opens a new range (`end` empty),
356
+ * the second closes it — clicking before the start swaps the two.
357
+ */
358
+ onRangeChange?: (range: {
359
+ start: string;
360
+ end: string;
361
+ }) => void;
340
362
  /** Custom render for day cells. Return ReactNode to replace default number. */
341
363
  renderDay?: (date: string, day: number) => default_2.ReactNode;
342
364
  /** Show keyboard hints. */
@@ -710,8 +732,16 @@ export declare interface NiceColorPaletteProps extends NiceBaseProps {
710
732
  variationCount?: number;
711
733
  /** Label */
712
734
  label?: string;
735
+ /** Label position relative to the swatch strip. Default `'top'`. */
736
+ labelPlacement?: 'top' | 'left';
713
737
  /** Disabled state */
714
738
  disabled?: boolean;
739
+ /** Looks enabled but the studio won't open and edits are blocked. */
740
+ readOnly?: boolean;
741
+ /** Show a loading spinner and dim the control. */
742
+ loading?: boolean;
743
+ /** Error ring; a string value also renders the message. */
744
+ error?: string | boolean;
715
745
  /**
716
746
  * Target number of colors in the generated palette. Overrides the natural
717
747
  * count of the active harmony mode (clamped between `minColors` and
@@ -784,19 +814,6 @@ export declare interface NiceContactPickerProps extends NiceFormFieldProps {
784
814
  maxSelections?: number;
785
815
  }
786
816
 
787
- /** Built-in countdown format presets. */
788
- declare type NiceCountdownFormat =
789
- /** `1d 02:34:15` / `02:34:15` — leading day count + clock */
790
- 'verbose'
791
- /** `1d 2h 34m 15s` — abbreviated units */
792
- | 'compact'
793
- /** `2:34:15` / `34:15` — pure clock */
794
- | 'short'
795
- /** `in 2h` / `in 5m` / `in 30s` — single coarsest unit */
796
- | 'minimal'
797
- /** `1 day, 2 hours, 34 minutes` — verbose words */
798
- | 'words';
799
-
800
817
  export declare const NiceCountryPicker: default_2.FC<NiceCountryPickerProps>;
801
818
 
802
819
  export declare interface NiceCountryPickerProps extends NiceFormFieldProps, DualVisibilityProps {
@@ -911,39 +928,6 @@ export declare interface NiceCropEditorProps {
911
928
  tutorial?: NiceComponentTutorial;
912
929
  }
913
930
 
914
- /**
915
- * {@link NiceCurrencyInput} — Amount input with currency selector, locale-aware formatting.
916
- */
917
- export declare const NiceCurrencyInput: default_2.ForwardRefExoticComponent<NiceCurrencyInputProps & default_2.RefAttributes<HTMLDivElement>>;
918
-
919
- /** Props for the {@link NiceCurrencyInput} component. */
920
- export declare interface NiceCurrencyInputProps extends NiceFormFieldProps {
921
- /** Controlled numeric amount (minor unit or major, based on `useMinorUnit`). */
922
- value?: number | null;
923
- /** Fires on amount change. */
924
- onChange?: (value: number | null) => void;
925
- /** Selected currency code (ISO 4217). */
926
- currency?: string;
927
- /** Fires when user changes currency. */
928
- onCurrencyChange?: (code: string) => void;
929
- /** Available currencies. */
930
- currencies?: CurrencyDef[];
931
- /** Whether to store value in minor units (cents). Default `false`. */
932
- useMinorUnit?: boolean;
933
- /** Minimum value. */
934
- min?: number;
935
- /** Maximum value. */
936
- max?: number;
937
- /** Override locale for formatting (e.g. "pl-PL"). */
938
- locale?: string;
939
- /** Placeholder text. */
940
- placeholder?: string;
941
- /** Whether to show currency selector (default `true` if currencies provided). */
942
- showCurrencySelector?: boolean;
943
- /** Fires on blur with the input event. */
944
- onBlur?: (e: default_2.FocusEvent<HTMLInputElement>) => void;
945
- }
946
-
947
931
  /** A user-defined harmony scheme (hue angles + optional lightness offsets). */
948
932
  declare interface NiceCustomHarmonyScheme {
949
933
  id: string;
@@ -956,10 +940,96 @@ declare interface NiceCustomHarmonyScheme {
956
940
  /** Predefined date-format presets. */
957
941
  export declare type NiceDateFormatPreset = 'date-local' | 'date-utc' | 'datetime-local' | 'datetime-utc' | 'month-local' | 'month-utc' | 'week' | 'time';
958
942
 
959
- export declare const NiceDatePicker: default_2.ForwardRefExoticComponent<NiceDatePickerProps & default_2.RefAttributes<HTMLInputElement>>;
943
+ export declare const NiceDateRangeBox: default_2.FC<NiceDateRangeBoxProps>;
944
+
945
+ /** Props for the {@link NiceDateRangeBox} component — a pair of date pickers for selecting a date range. */
946
+ export declare interface NiceDateRangeBoxProps extends NiceFormFieldProps {
947
+ /** Start date (ISO string). */
948
+ startDate: string;
949
+ /** End date (ISO string). */
950
+ endDate: string;
951
+ /** Called when the start date changes. */
952
+ onStartChange: (date: string) => void;
953
+ /** Called when the end date changes. */
954
+ onEndChange: (date: string) => void;
955
+ /** Earliest selectable date. */
956
+ min?: string;
957
+ /** Latest selectable date. */
958
+ max?: string;
959
+ /** Show a clear button. */
960
+ clearable?: boolean;
961
+ /** Placeholder for the start input. */
962
+ startPlaceholder?: string;
963
+ /** Placeholder for the end input. */
964
+ endPlaceholder?: string;
965
+ /** Label shown above (or before) the start picker. */
966
+ startLabel?: string;
967
+ /** Label shown above (or before) the end picker. */
968
+ endLabel?: string;
969
+ /**
970
+ * Collapse the pair into ONE field with ONE popup: the field shows
971
+ * `start – end` and the popup holds a single calendar on which the span is
972
+ * painted in two clicks. Default `false` (two fields, two popups).
973
+ */
974
+ singleField?: boolean;
975
+ /** Layout direction for the two pickers (default `horizontal`). */
976
+ layout?: 'horizontal' | 'vertical';
977
+ /** Custom separator rendered between pickers in horizontal layout (default `–`). Pass `''` to hide. */
978
+ separator?: default_2.ReactNode;
979
+ /** Gap in pixels between the two pickers (default 12). */
980
+ gap?: number;
981
+ /** Stretch each picker to fill available width. */
982
+ fullWidth?: boolean;
983
+ /**
984
+ * Format preset forwarded to BOTH inner pickers — so a range can be
985
+ * date, datetime (`'datetime-local'`), month, week or time, not just date.
986
+ */
987
+ dateFormatPreset?: NiceDateFormatPreset;
988
+ /**
989
+ * BCP 47 locale forwarded to BOTH inner pickers, controlling the displayed
990
+ * date mask (e.g. `'pl-PL'` → `dd.MM.yyyy`, `'en-US'` → `MM/dd/yyyy`). When
991
+ * omitted the pickers fall back to the app locale (`<html lang>`) then the
992
+ * browser locale. The emitted value stays ISO regardless of display locale.
993
+ */
994
+ locale?: string;
995
+ /**
996
+ * @deprecated Use `dateFormatPreset`. Native input type forwarded to both
997
+ * inner pickers.
998
+ */
999
+ type?: 'date' | 'datetime-local' | 'time' | 'month' | 'week';
1000
+ /**
1001
+ * How the end date is constrained relative to the start (default
1002
+ * `'greater-or-equal'` — the end can equal the start).
1003
+ */
1004
+ endCondition?: NiceDateRangeEndCondition;
1005
+ /**
1006
+ * How the start date is constrained relative to today (default
1007
+ * `'today-or-greater'` — the start can't be in the past).
1008
+ */
1009
+ startCondition?: NiceDateRangeStartCondition;
1010
+ /**
1011
+ * Time selector for datetime ranges, forwarded to both inner pickers:
1012
+ * `'spinners'` (default) or `'clock'` (analog clock face). Only relevant when
1013
+ * `dateFormatPreset` carries a time part.
1014
+ */
1015
+ timeSelectorType?: 'spinners' | 'clock';
1016
+ }
1017
+
1018
+ /** How the end date is constrained relative to the start date. Extensible. */
1019
+ declare type NiceDateRangeEndCondition = 'greater-or-equal' | 'greater' | 'none';
1020
+
1021
+ /** How the start date is constrained relative to today. Extensible. */
1022
+ declare type NiceDateRangeStartCondition = 'today-or-greater' | 'greater-than-today' | 'none';
1023
+
1024
+ /** Built-in countdown format presets (merged in from NiceTimePicker).
1025
+ * NOTE: deliberately NOT named `NiceCountdownFormat` — that name is already a
1026
+ * public export of the unrelated `NiceCountdown` display component. */
1027
+ declare type NiceDateTimeCountdownFormat = 'verbose' | 'compact' | 'short' | 'minimal' | 'words';
960
1028
 
961
- /** Props for the {@link NiceDatePicker} component — a masked, locale-aware date/time input. */
962
- export declare interface NiceDatePickerProps extends NiceFormFieldProps {
1029
+ export declare const NiceDateTimePicker: default_2.ForwardRefExoticComponent<NiceDateTimePickerProps & default_2.RefAttributes<HTMLInputElement>>;
1030
+
1031
+ /** Props for the {@link NiceDateTimePicker} component — a masked, locale-aware date/time input. */
1032
+ export declare interface NiceDateTimePickerProps extends NiceFormFieldProps {
963
1033
  /** ISO value (e.g. `'2024-06-15'`). Always ISO regardless of display locale. */
964
1034
  value?: string;
965
1035
  /** Fires with the new ISO value. Empty string while the input is incomplete. */
@@ -1003,66 +1073,51 @@ export declare interface NiceDatePickerProps extends NiceFormFieldProps {
1003
1073
  * Only fires for date / datetime / month presets.
1004
1074
  */
1005
1075
  keyboardShortcuts?: boolean;
1006
- }
1007
-
1008
- export declare const NiceDateRangeBox: default_2.FC<NiceDateRangeBoxProps>;
1009
-
1010
- /** Props for the {@link NiceDateRangeBox} component — a pair of date pickers for selecting a date range. */
1011
- export declare interface NiceDateRangeBoxProps extends NiceFormFieldProps {
1012
- /** Start date (ISO string). */
1013
- startDate: string;
1014
- /** End date (ISO string). */
1015
- endDate: string;
1016
- /** Called when the start date changes. */
1017
- onStartChange: (date: string) => void;
1018
- /** Called when the end date changes. */
1019
- onEndChange: (date: string) => void;
1020
- /** Earliest selectable date. */
1021
- min?: string;
1022
- /** Latest selectable date. */
1023
- max?: string;
1024
- /** Show a clear button. */
1025
- clearable?: boolean;
1026
- /** Placeholder for the start input. */
1027
- startPlaceholder?: string;
1028
- /** Placeholder for the end input. */
1029
- endPlaceholder?: string;
1030
- /** Label shown above (or before) the start picker. */
1031
- startLabel?: string;
1032
- /** Label shown above (or before) the end picker. */
1033
- endLabel?: string;
1034
- /** Layout direction for the two pickers (default `horizontal`). */
1035
- layout?: 'horizontal' | 'vertical';
1036
- /** Custom separator rendered between pickers in horizontal layout (default `–`). Pass `''` to hide. */
1037
- separator?: default_2.ReactNode;
1038
- /** Gap in pixels between the two pickers (default 12). */
1039
- gap?: number;
1040
- /** Stretch each picker to fill available width. */
1041
- fullWidth?: boolean;
1042
- }
1043
-
1044
- export declare const NiceDateTimePicker: default_2.ForwardRefExoticComponent<NiceDateTimePickerProps & default_2.RefAttributes<HTMLDivElement>>;
1045
-
1046
- /** Props for the {@link NiceDateTimePicker} component — a combined date and time picker with calendar dropdown. */
1047
- export declare interface NiceDateTimePickerProps extends NiceFormFieldProps {
1048
- /** ISO 8601 date-time string (e.g. "2026-03-16T14:30") */
1049
- value?: string;
1050
- onChange?: (value: string) => void;
1051
- onBlur?: (e: default_2.FocusEvent) => void;
1052
- /** Minimum allowed date-time (ISO string) */
1053
- min?: string;
1054
- /** Maximum allowed date-time (ISO string) */
1055
- max?: string;
1056
- /** Display format — 12h shows AM/PM toggle, 24h shows 0–23 */
1057
- hourFormat?: '12' | '24';
1058
- /** Minute increment step */
1059
- minuteStep?: number;
1060
- /** Show seconds input */
1076
+ /** Datetime/time: show a seconds section (`HH:mm:ss`). Default: `false`. */
1061
1077
  showSeconds?: boolean;
1062
- /** Show "Now" quick button */
1078
+ /**
1079
+ * Datetime/time: minute increment. Drives the native picker companion `step`
1080
+ * AND the ↑/↓ arrow stepping in the masked field.
1081
+ */
1082
+ minuteStep?: number;
1083
+ /**
1084
+ * Datetime/time: `'12'` renders an AM/PM toggle beside the field (and asks the
1085
+ * native picker for a 12-hour dialog where the OS locale supports it). The
1086
+ * masked field always edits 24-hour digits and the emitted value stays ISO 24h.
1087
+ */
1088
+ hourFormat?: '12' | '24';
1089
+ /**
1090
+ * Datetime/time: how the time-of-day is picked inside the popup. `'spinners'`
1091
+ * (default) are the scroll wheels; `'clock'` is an analog clock face with
1092
+ * hour/minute hands and an AM/PM toggle. A small in-popup toggle also lets the
1093
+ * user switch between the two at runtime. The emitted value stays ISO 24h.
1094
+ */
1095
+ timeSelectorType?: 'spinners' | 'clock';
1096
+ /**
1097
+ * Datetime/time/date: show a "Now" button that fills the current date/time.
1098
+ * Default: `false`.
1099
+ */
1063
1100
  showNow?: boolean;
1064
- /** Show clear button */
1065
- clearable?: boolean;
1101
+ /**
1102
+ * Explicit target date to combine with the picked time (`Date` or
1103
+ * `YYYY-MM-DD`). When omitted while {@link countdown} is on, the target
1104
+ * auto-resolves to the next occurrence (today, else tomorrow).
1105
+ */
1106
+ targetDate?: string | Date;
1107
+ /** Fires whenever the resolved countdown target changes. */
1108
+ onTargetChange?: (target: Date) => void;
1109
+ /** Show a live countdown label beside the field. */
1110
+ countdown?: boolean;
1111
+ /** Built-in countdown format preset (default `'verbose'`). */
1112
+ countdownFormat?: NiceDateTimeCountdownFormat;
1113
+ /** Custom countdown formatter (overrides {@link countdownFormat}). */
1114
+ formatCountdown?: (msRemaining: number, target: Date) => string;
1115
+ /** Label rendered before the countdown text (e.g. `'starts in'`). */
1116
+ countdownLabel?: default_2.ReactNode;
1117
+ /** Countdown tick interval in ms (default 1000, min 100). */
1118
+ countdownInterval?: number;
1119
+ /** Text shown once the countdown reaches zero. */
1120
+ countdownDoneText?: string;
1066
1121
  }
1067
1122
 
1068
1123
  /** A content block in the {@link NiceDocumentEditor}. */
@@ -1150,6 +1205,16 @@ export declare interface NiceDropDownBoxProps extends NiceFormFieldProps {
1150
1205
  onOpenChange?: (open: boolean) => void;
1151
1206
  /** Width of the dropdown panel. */
1152
1207
  dropdownWidth?: number | string;
1208
+ /**
1209
+ * Show a search box at the top of the panel (default `true`). Because the panel
1210
+ * holds arbitrary `children`, filtering is the caller's job — the search box only
1211
+ * renders when an `onSearch` handler is provided.
1212
+ */
1213
+ searchable?: boolean;
1214
+ /** Called with the query as the user types in the panel search box. */
1215
+ onSearch?: (query: string) => void;
1216
+ /** Placeholder for the panel search box. */
1217
+ searchPlaceholder?: string;
1153
1218
  }
1154
1219
 
1155
1220
  export declare const NiceEmojiPicker: default_2.FC<NiceEmojiPickerProps>;
@@ -1189,90 +1254,6 @@ export declare interface NiceEmojiPickerProps {
1189
1254
  'data-testid'?: string;
1190
1255
  }
1191
1256
 
1192
- export declare const NiceFileUpload: default_2.ForwardRefExoticComponent<NiceFileUploadProps & default_2.RefAttributes<NiceFileUploadRef>>;
1193
-
1194
- export declare interface NiceFileUploadProps extends NiceBaseProps {
1195
- /** Akceptowane typy plików (np. "image/*,.pdf") */
1196
- accept?: string;
1197
- /** Czy pozwalać na multiple files */
1198
- multiple?: boolean;
1199
- /** Maksymalny rozmiar pliku w bajtach */
1200
- maxFileSize?: number;
1201
- /** Maksymalna liczba plików */
1202
- maxFiles?: number;
1203
- /** Minimalny rozmiar pliku */
1204
- minFileSize?: number;
1205
- /** Rozmiar chunka dla dużych plików (domyślnie 5MB) */
1206
- chunkSize?: number;
1207
- /** Próg rozmiaru pliku dla chunked upload (domyślnie 10MB) */
1208
- chunkThreshold?: number;
1209
- /** Automatycznie rozpocznij upload po dodaniu */
1210
- autoUpload?: boolean;
1211
- /** Handler uploadu */
1212
- uploadHandler?: UploadHandler;
1213
- /** URL do uploadu (jeśli nie podano uploadHandler) */
1214
- uploadUrl?: string;
1215
- /** Nagłówki HTTP dla uploadu */
1216
- uploadHeaders?: Record<string, string>;
1217
- /** Callback po dodaniu plików */
1218
- onFilesAdded?: (files: FileInfo[]) => void;
1219
- /** Callback po zakończeniu uploadu */
1220
- onUploadComplete?: (file: FileInfo) => void;
1221
- /** Callback po błędzie */
1222
- onUploadError?: (file: FileInfo, error: string) => void;
1223
- /** Callback na postęp */
1224
- onProgress?: (file: FileInfo, progress: number) => void;
1225
- /** Callback po usunięciu */
1226
- onFileRemoved?: (file: FileInfo) => void;
1227
- /** Callback po zmianie stanu */
1228
- onChange?: (files: FileInfo[]) => void;
1229
- /** Niestandardowy renderer podglądu */
1230
- renderPreview?: (file: FileInfo) => default_2.ReactNode;
1231
- /** Niestandardowy renderer elementu listy */
1232
- renderFileItem?: (file: FileInfo, actions: FileItemActions) => default_2.ReactNode;
1233
- /** Pokaż podgląd obrazów */
1234
- showPreview?: boolean;
1235
- /** Pokaż listę plików */
1236
- showFileList?: boolean;
1237
- /** Tryb wyświetlania listy */
1238
- listMode?: 'list' | 'grid' | 'compact';
1239
- /** Rozmiar podglądu */
1240
- previewSize?: NiceSize;
1241
- /** Tekst w dropzone */
1242
- dropzoneText?: string;
1243
- /** Tekst pod przyciskiem */
1244
- browseText?: string;
1245
- /** Tekst podczas dragover */
1246
- dragActiveText?: string;
1247
- /** Wyłączony */
1248
- disabled?: boolean;
1249
- /** Read-only (tylko podgląd) */
1250
- readOnly?: boolean;
1251
- /** Customowe klasy CSS */
1252
- dropzoneClassName?: string;
1253
- /** Retry count */
1254
- maxRetries?: number;
1255
- /** Ilość równoczesnych uploadów */
1256
- concurrentUploads?: number;
1257
- /** Walidator plików */
1258
- validateFile?: (file: File) => string | null;
1259
- /** Zachowaj pliki po uploadzięciu */
1260
- keepFilesAfterUpload?: boolean;
1261
- /** Początkowe pliki */
1262
- initialFiles?: FileInfo[];
1263
- }
1264
-
1265
- declare interface NiceFileUploadRef {
1266
- addFiles: (files: File[]) => void;
1267
- uploadAll: () => void;
1268
- cancelAll: () => void;
1269
- clearAll: () => void;
1270
- getFiles: () => FileInfo[];
1271
- getFile: (id: string) => FileInfo | undefined;
1272
- retryFailed: () => void;
1273
- openFileBrowser: () => void;
1274
- }
1275
-
1276
1257
  export declare const NiceForm: default_2.FC<NiceFormProps>;
1277
1258
 
1278
1259
  /** Describes a single field in a {@link NiceForm} layout. */
@@ -1390,8 +1371,18 @@ export declare interface NiceGradientPickerProps extends NiceBaseProps {
1390
1371
  /** Maximum number of gradient stops */
1391
1372
  maxStops?: number;
1392
1373
  label?: string;
1374
+ /** Label position relative to the swatch. Default `'top'`. */
1375
+ labelPlacement?: 'top' | 'left';
1393
1376
  disabled?: boolean;
1394
- /** Fixed width of the whole control. Defaults to 320px so the layout stays stable when stops are added. */
1377
+ /** Looks enabled but the popup won't open and edits are blocked. */
1378
+ readOnly?: boolean;
1379
+ /** Show a loading spinner and dim the control. */
1380
+ loading?: boolean;
1381
+ /** Error ring; a string value also renders the message. */
1382
+ error?: string | boolean;
1383
+ /** Where the error message sits: below (default) or inline to the right. */
1384
+ errorPlacement?: 'bottom' | 'right';
1385
+ /** Fixed width of the popup. Defaults to 340px. */
1395
1386
  width?: string | number;
1396
1387
  }
1397
1388
 
@@ -1417,7 +1408,7 @@ declare interface NiceGradientValue {
1417
1408
  stops: NiceGradientStop[];
1418
1409
  }
1419
1410
 
1420
- declare type NiceHarmonyMode = 'monochromatic' | 'complementary' | 'split-complementary' | 'analogous' | 'triadic' | 'tetradic' | 'square' | 'shade-chain' | 'custom';
1411
+ declare type NiceHarmonyMode = 'monochromatic' | 'complementary' | 'split-complementary' | 'analogous' | 'analogous-complementary' | 'triadic' | 'tetradic' | 'square' | 'shade-chain' | 'custom';
1421
1412
 
1422
1413
  export declare const NiceHtmlEditor: default_2.FC<NiceHtmlEditorProps>;
1423
1414
 
@@ -1823,6 +1814,8 @@ export declare interface NiceLookupProps extends NiceFormFieldProps {
1823
1814
  displayField?: string;
1824
1815
  /** Width of the dropdown when in mini-grid mode (CSS). */
1825
1816
  dropdownWidth?: string | number;
1817
+ /** Gap (px) between the input and the dropdown menu. Default 0 (menu abuts the input). */
1818
+ menuGap?: number;
1826
1819
  }
1827
1820
 
1828
1821
  export declare const NiceMarkdownEditor: default_2.ForwardRefExoticComponent<NiceMarkdownEditorProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -1956,6 +1949,8 @@ export declare interface NiceNumberInputProps extends NiceFormFieldProps {
1956
1949
  suffixValue?: string;
1957
1950
  /** Called when the suffix select changes. */
1958
1951
  onSuffixChange?: (value: string, prevWeight: number | undefined, newWeight: number | undefined) => void;
1952
+ /** Show a divider line between the value and the suffix. Default `false`. */
1953
+ suffixSeparator?: boolean;
1959
1954
  }
1960
1955
 
1961
1956
  export declare const NicePasswordInput: default_2.ForwardRefExoticComponent<NicePasswordInputProps & default_2.RefAttributes<HTMLInputElement>>;
@@ -2033,31 +2028,6 @@ export declare interface NicePDFAnnotationEditorProps extends NiceFormFieldProps
2033
2028
  tutorial?: NiceComponentTutorial;
2034
2029
  }
2035
2030
 
2036
- /**
2037
- * {@link NicePhoneInput} — Phone number input with country code selector, masking, and E.164 formatting.
2038
- */
2039
- export declare const NicePhoneInput: default_2.ForwardRefExoticComponent<NicePhoneInputProps & default_2.RefAttributes<HTMLDivElement>>;
2040
-
2041
- /** Props for the {@link NicePhoneInput} component. */
2042
- export declare interface NicePhoneInputProps extends NiceFormFieldProps {
2043
- /** Controlled phone value. */
2044
- value?: PhoneValue;
2045
- /** Fires on value change with parsed phone value. */
2046
- onChange?: (value: PhoneValue) => void;
2047
- /** Available country codes. */
2048
- countryCodes?: PhoneCountryCode[];
2049
- /** Default country code (ISO alpha-2, e.g. "PL"). */
2050
- defaultCountry?: string;
2051
- /** Placeholder for the number part. */
2052
- placeholder?: string;
2053
- /** Whether to show the country flag emoji. */
2054
- showFlag?: boolean;
2055
- /** Whether to validate as E.164 on blur. */
2056
- validateE164?: boolean;
2057
- /** Fires with the raw input event. */
2058
- onBlur?: (e: default_2.FocusEvent<HTMLInputElement>) => void;
2059
- }
2060
-
2061
2031
  export declare const NicePickList: <T = unknown>(props: NicePickListProps<T> & default_2.RefAttributes<HTMLDivElement>) => default_2.ReactElement | null;
2062
2032
 
2063
2033
  /** Props for the {@link NicePickList} component — a dual-list control for moving items between source and target. */
@@ -2100,34 +2070,6 @@ export declare interface NicePickListProps<T = unknown> extends NiceBaseProps {
2100
2070
  size?: NiceSize;
2101
2071
  }
2102
2072
 
2103
- /**
2104
- * {@link NicePinCodeInput} — PIN code entry with individual digit boxes,
2105
- * optional numeric keypad, masking, and auto-submit.
2106
- */
2107
- export declare const NicePinCodeInput: default_2.ForwardRefExoticComponent<NicePinCodeInputProps & default_2.RefAttributes<HTMLDivElement>>;
2108
-
2109
- /** Props for the {@link NicePinCodeInput} component. */
2110
- export declare interface NicePinCodeInputProps extends NiceFormFieldProps {
2111
- /** Current PIN value. */
2112
- value?: string;
2113
- /** Fires when value changes. */
2114
- onChange?: (value: string) => void;
2115
- /** Fires when PIN is fully entered. */
2116
- onComplete?: (pin: string) => void;
2117
- /** Number of PIN digits. */
2118
- length?: number;
2119
- /** Whether to mask digits (show dots). */
2120
- masked?: boolean;
2121
- /** Whether to show a numeric keypad below the input. */
2122
- showKeypad?: boolean;
2123
- /** Whether to auto-submit when all digits are filled. */
2124
- autoSubmit?: boolean;
2125
- /** Error shake animation trigger (toggle to replay). */
2126
- shake?: boolean;
2127
- /** Placeholder character. */
2128
- placeholderChar?: string;
2129
- }
2130
-
2131
2073
  export declare const NiceRadioGroup: default_2.FC<NiceRadioGroupProps>;
2132
2074
 
2133
2075
  /** Props for the {@link NiceRadioGroup} component — a set of mutually exclusive radio options. */
@@ -2152,12 +2094,12 @@ export declare interface NiceRangeSliderProps extends NiceFormFieldProps {
2152
2094
  max?: number;
2153
2095
  /** Step increment. */
2154
2096
  step?: number;
2155
- /** Start (lower) thumb value. */
2156
- startValue: number;
2157
- /** End (upper) thumb value. */
2158
- endValue: number;
2097
+ /** Start (lower) thumb value. Defaults to `min`. */
2098
+ startValue?: number;
2099
+ /** End (upper) thumb value. Defaults to `max`. */
2100
+ endValue?: number;
2159
2101
  /** Called when either thumb moves. */
2160
- onChange: (start: number, end: number) => void;
2102
+ onChange?: (start: number, end: number) => void;
2161
2103
  /** Show value labels at each thumb. */
2162
2104
  showLabels?: boolean;
2163
2105
  /** Custom label formatter. */
@@ -2354,27 +2296,6 @@ declare interface NiceSignatureData {
2354
2296
 
2355
2297
  declare type NiceSignatureOutput = 'png' | 'jpeg' | 'svg';
2356
2298
 
2357
- export declare const NiceSignaturePad: ForwardRefExoticComponent<NiceSignaturePadProps & RefAttributes<HTMLDivElement>>;
2358
-
2359
- /** Props for the {@link NiceSignaturePad} component — a canvas-based digital signature capture pad. */
2360
- export declare interface NiceSignaturePadProps extends NiceBaseProps {
2361
- /** Signature image (data URL) — controlled value */
2362
- value?: string | null;
2363
- onChange?: (dataUrl: string | null) => void;
2364
- penColor?: string;
2365
- penWidth?: number;
2366
- backgroundColor?: string;
2367
- width?: number;
2368
- height?: number;
2369
- size?: NiceSize;
2370
- disabled?: boolean;
2371
- readOnly?: boolean;
2372
- showClear?: boolean;
2373
- showUndo?: boolean;
2374
- label?: string;
2375
- exportFormat?: 'image/png' | 'image/jpeg' | 'image/svg+xml';
2376
- }
2377
-
2378
2299
  declare interface NiceSignaturePoint {
2379
2300
  x: number;
2380
2301
  y: number;
@@ -2387,6 +2308,12 @@ export declare interface NiceSignatureProps {
2387
2308
  value?: NiceSignatureData | null;
2388
2309
  /** Value change callback */
2389
2310
  onChange?: (data: NiceSignatureData | null) => void;
2311
+ /** Convenience callback emitting the signature as a PNG data URL (null when
2312
+ * cleared) — for form consumers that bind a string value. Ported from the
2313
+ * former NiceSignaturePad. */
2314
+ onChangeDataUrl?: (url: string | null) => void;
2315
+ /** Field label shown above the pad. */
2316
+ label?: string;
2390
2317
  /** Width */
2391
2318
  width?: number | string;
2392
2319
  /** Height */
@@ -2535,29 +2462,6 @@ export declare interface NiceTagBoxProps extends NiceFormFieldProps {
2535
2462
  autoExpand?: boolean;
2536
2463
  }
2537
2464
 
2538
- /**
2539
- * {@link NiceTaxRatePicker} — VAT/tax rate selector with country-specific defaults.
2540
- * Supports Polish rates out-of-the-box, custom rates per country, and displays
2541
- * percentage values.
2542
- */
2543
- export declare const NiceTaxRatePicker: default_2.ForwardRefExoticComponent<NiceTaxRatePickerProps & default_2.RefAttributes<HTMLDivElement>>;
2544
-
2545
- /** Props for the {@link NiceTaxRatePicker} component. */
2546
- export declare interface NiceTaxRatePickerProps extends NiceFormFieldProps {
2547
- /** Selected tax rate id. */
2548
- value?: string;
2549
- /** Fires when selection changes. */
2550
- onChange?: (rateId: string, rate: TaxRate) => void;
2551
- /** Available tax rates. If empty, defaults to Polish VAT rates. */
2552
- rates?: TaxRate[];
2553
- /** Country code filter. */
2554
- countryCode?: string;
2555
- /** Placeholder text. */
2556
- placeholder?: string;
2557
- /** Whether to show rate percentage in the label. */
2558
- showPercentage?: boolean;
2559
- }
2560
-
2561
2465
  export declare const NiceTextArea: default_2.ForwardRefExoticComponent<NiceTextAreaProps & default_2.RefAttributes<HTMLTextAreaElement>>;
2562
2466
 
2563
2467
  export declare interface NiceTextAreaProps extends NiceFormFieldProps {
@@ -2610,49 +2514,6 @@ export declare interface NiceTextInputProps extends Omit<NiceFormFieldProps, 'la
2610
2514
  variant?: 'outlined' | 'filled' | 'underlined' | string;
2611
2515
  }
2612
2516
 
2613
- export declare const NiceTimePicker: default_2.ForwardRefExoticComponent<NiceTimePickerProps & default_2.RefAttributes<HTMLDivElement>>;
2614
-
2615
- /** Props for the {@link NiceTimePicker} component — a time-only picker with hour/minute/second spinners. */
2616
- export declare interface NiceTimePickerProps extends NiceFormFieldProps {
2617
- /** Time string in HH:mm or HH:mm:ss format */
2618
- value?: string;
2619
- onChange?: (value: string) => void;
2620
- onBlur?: (e: default_2.FocusEvent) => void;
2621
- /** Display format — 12h shows AM/PM toggle, 24h shows 0–23 */
2622
- hourFormat?: '12' | '24';
2623
- /** Minute increment step */
2624
- minuteStep?: number;
2625
- /** Show seconds input */
2626
- showSeconds?: boolean;
2627
- /** Minimum time (HH:mm) */
2628
- min?: string;
2629
- /** Maximum time (HH:mm) */
2630
- max?: string;
2631
- /** Show clear button */
2632
- clearable?: boolean;
2633
- /**
2634
- * Optional explicit target date to combine with the picked time
2635
- * (`Date` or `YYYY-MM-DD` string). When omitted while {@link countdown}
2636
- * is enabled, the target auto-resolves to the **next occurrence**:
2637
- * today if the picked time hasn't passed yet, tomorrow if it has.
2638
- */
2639
- targetDate?: string | Date;
2640
- /** Fires whenever the resolved target Date changes. */
2641
- onTargetChange?: (target: Date) => void;
2642
- /** Show a live countdown label beside the picker. */
2643
- countdown?: boolean;
2644
- /** Built-in countdown format preset (default `'verbose'`). */
2645
- countdownFormat?: NiceCountdownFormat;
2646
- /** Custom formatter (overrides {@link countdownFormat}). */
2647
- formatCountdown?: (msRemaining: number, target: Date) => string;
2648
- /** Label rendered before the countdown text (e.g. `'starts in'`). */
2649
- countdownLabel?: default_2.ReactNode;
2650
- /** Update interval in ms (default `1000`). */
2651
- countdownInterval?: number;
2652
- /** Text shown when the target time has elapsed (default `'now'`). */
2653
- countdownDoneText?: string;
2654
- }
2655
-
2656
2517
  export declare const NiceToggle: default_2.ForwardRefExoticComponent<NiceToggleProps & default_2.RefAttributes<HTMLInputElement>>;
2657
2518
 
2658
2519
  /** Props for the {@link NiceToggle} component — a boolean switch/toggle. */
@@ -2722,40 +2583,82 @@ export declare interface NiceTreeSelectProps extends NiceFormFieldProps {
2722
2583
  * leaves (children not rendered, no expand toggle). Default: unlimited.
2723
2584
  */
2724
2585
  maxDepth?: number;
2586
+ /** Gap (px) between the input and the dropdown menu. Default 0 (menu abuts the input). */
2587
+ menuGap?: number;
2725
2588
  }
2726
2589
 
2727
- /**
2728
- * {@link NiceVatInput} — VAT/NIP number input with country selector,
2729
- * prefix auto-prepend, pattern validation, and optional VIES verification.
2730
- */
2731
- export declare const NiceVatInput: default_2.ForwardRefExoticComponent<NiceVatInputProps & default_2.RefAttributes<HTMLDivElement>>;
2590
+ export declare const NiceUpload: default_2.ForwardRefExoticComponent<NiceUploadProps & default_2.RefAttributes<HTMLDivElement>>;
2732
2591
 
2733
- /** Props for the {@link NiceVatInput} component. */
2734
- export declare interface NiceVatInputProps extends NiceFormFieldProps {
2735
- /** Current VAT number value (with or without prefix). */
2736
- value?: string;
2737
- /** Fires when value changes. */
2738
- onChange?: (value: string, isValid: boolean) => void;
2739
- /** Selected country code (ISO 3166-1 alpha-2). */
2740
- countryCode?: string;
2741
- /** Fires when country changes. */
2742
- onCountryChange?: (code: string) => void;
2743
- /** Custom country configs. */
2744
- countries?: VatCountryConfig[];
2745
- /** Whether to show the country selector. */
2746
- showCountrySelector?: boolean;
2747
- /** Whether to auto-prepend VAT prefix. */
2748
- autoPrefixVat?: boolean;
2749
- /** External validation result. */
2750
- validationResult?: {
2751
- valid: boolean;
2752
- companyName?: string;
2753
- error?: string;
2754
- } | null;
2755
- /** Fires when user requests online validation (e.g. VIES). */
2756
- onValidateRequest?: (vatNumber: string, countryCode: string) => void;
2757
- /** Placeholder override. */
2758
- placeholder?: string;
2592
+ /** Imperative handle, exposed via the optional `apiRef` prop (not the div `ref`). */
2593
+ export declare interface NiceUploadHandle {
2594
+ addFiles: (files: File[]) => void;
2595
+ uploadAll: () => void;
2596
+ cancelAll: () => void;
2597
+ clearAll: () => void;
2598
+ getFiles: () => FileInfo[];
2599
+ getFile: (id: string) => FileInfo | undefined;
2600
+ retryFailed: () => void;
2601
+ openFileBrowser: () => void;
2602
+ }
2603
+
2604
+ /** Props for {@link NiceUpload} — drag-and-drop / button file upload with an
2605
+ * optional upload engine (progress, retry/cancel, chunked upload, validation,
2606
+ * previews) absorbed from the former NiceFileUpload. The legacy `NiceFileUploader`
2607
+ * export was retired in favour of this component. */
2608
+ export declare interface NiceUploadProps extends NiceBaseProps {
2609
+ accept?: string;
2610
+ multiple?: boolean;
2611
+ maxFileSize?: number;
2612
+ maxFiles?: number;
2613
+ minFileSize?: number;
2614
+ /** Fires with the current File[] on every add/remove (instant) / Upload click. */
2615
+ onFilesSelected: (files: File[]) => void;
2616
+ uploadMode?: 'instant' | 'useButtons';
2617
+ labelText?: string;
2618
+ /** Idle dropzone label; pass `""` for an icon-only dropzone. */
2619
+ text?: string;
2620
+ dropzoneText?: string;
2621
+ browseText?: string;
2622
+ dragActiveText?: string;
2623
+ /** Icon/label layout in the dropzone: `'right'` (label beside the icon, default) or `'bottom'` (label under it). */
2624
+ labelPlacement?: 'right' | 'bottom';
2625
+ icon?: string | null;
2626
+ showFileList?: boolean;
2627
+ imagePreview?: boolean;
2628
+ showPreview?: boolean;
2629
+ listMode?: 'list' | 'grid' | 'compact';
2630
+ previewSize?: NiceSize;
2631
+ /** External progress override keyed by `file.name` (0–100). */
2632
+ fileProgress?: Record<string, number>;
2633
+ renderPreview?: (file: FileInfo) => default_2.ReactNode;
2634
+ renderFileItem?: (file: FileInfo, actions: FileItemActions) => default_2.ReactNode;
2635
+ variant?: 'dropzone' | 'button';
2636
+ /** Custom content for `variant="button"`. */
2637
+ trigger?: default_2.ReactNode;
2638
+ /** Custom clickable/droppable surface content (replaces the default icon+label). */
2639
+ dropChildren?: default_2.ReactNode;
2640
+ autoUpload?: boolean;
2641
+ uploadHandler?: UploadHandler;
2642
+ uploadUrl?: string;
2643
+ uploadHeaders?: Record<string, string>;
2644
+ concurrentUploads?: number;
2645
+ maxRetries?: number;
2646
+ chunkSize?: number;
2647
+ chunkThreshold?: number;
2648
+ validateFile?: (file: File) => string | null;
2649
+ keepFilesAfterUpload?: boolean;
2650
+ initialFiles?: FileInfo[];
2651
+ disabled?: boolean;
2652
+ readOnly?: boolean;
2653
+ onFilesAdded?: (files: FileInfo[]) => void;
2654
+ onUploadComplete?: (file: FileInfo) => void;
2655
+ onUploadError?: (file: FileInfo, error: string) => void;
2656
+ onProgress?: (file: FileInfo, progress: number) => void;
2657
+ onFileRemoved?: (file: FileInfo) => void;
2658
+ onChange?: (files: FileInfo[]) => void;
2659
+ apiRef?: default_2.Ref<NiceUploadHandle>;
2660
+ /** Enable paste from clipboard (Ctrl+V). */
2661
+ pasteFromClipboard?: boolean;
2759
2662
  }
2760
2663
 
2761
2664
  /**
@@ -2823,23 +2726,6 @@ declare interface PDFAnnotation {
2823
2726
  }>;
2824
2727
  }
2825
2728
 
2826
- /** Country phone prefix entry. */
2827
- declare interface PhoneCountryCode {
2828
- code: string;
2829
- dialCode: string;
2830
- name: string;
2831
- mask?: string;
2832
- }
2833
-
2834
- /** Parsed phone value. */
2835
- declare interface PhoneValue {
2836
- countryCode?: string;
2837
- dialCode?: string;
2838
- number?: string;
2839
- /** Full E.164 formatted number (e.g. "+48123456789"). */
2840
- e164?: string;
2841
- }
2842
-
2843
2729
  declare interface RectangleAnnotation extends AnnotationBase {
2844
2730
  tool: 'rectangle';
2845
2731
  }
@@ -2857,22 +2743,6 @@ declare interface ScanResult {
2857
2743
  scannedAt: Date;
2858
2744
  }
2859
2745
 
2860
- /** A tax rate entry. */
2861
- declare interface TaxRate {
2862
- /** Rate identifier. */
2863
- id: string;
2864
- /** Display label (e.g. "23%", "8%", "zw."). */
2865
- label: string;
2866
- /** Numeric rate as decimal (0.23 = 23%). */
2867
- rate: number;
2868
- /** Country code this rate applies to. */
2869
- countryCode?: string;
2870
- /** Category (e.g. "standard", "reduced", "zero", "exempt"). */
2871
- category?: string;
2872
- /** Whether this is the default rate. */
2873
- isDefault?: boolean;
2874
- }
2875
-
2876
2746
  declare interface TextAnnotation extends AnnotationBase {
2877
2747
  tool: 'text';
2878
2748
  text: string;
@@ -2896,9 +2766,9 @@ declare interface TracelessStorageProps {
2896
2766
  storageKey?: string;
2897
2767
  }
2898
2768
 
2899
- declare type UploadHandler = (request: UploadRequest) => Promise<UploadResponse>;
2769
+ export declare type UploadHandler = (request: UploadRequest) => Promise<UploadResponse>;
2900
2770
 
2901
- declare interface UploadRequest {
2771
+ export declare interface UploadRequest {
2902
2772
  file: File;
2903
2773
  chunk?: Blob;
2904
2774
  chunkIndex?: number;
@@ -2908,29 +2778,15 @@ declare interface UploadRequest {
2908
2778
  signal?: AbortSignal;
2909
2779
  }
2910
2780
 
2911
- declare interface UploadResponse {
2781
+ export declare interface UploadResponse {
2912
2782
  success: boolean;
2913
2783
  url?: string;
2914
2784
  error?: string;
2915
2785
  fileId?: string;
2916
- metadata?: Record<string, any>;
2786
+ metadata?: Record<string, unknown>;
2917
2787
  }
2918
2788
 
2919
- declare type UploadStatus = 'pending' | 'uploading' | 'success' | 'error' | 'cancelled';
2920
-
2921
- /** Country-specific VAT/NIP validation config. */
2922
- declare interface VatCountryConfig {
2923
- /** ISO 3166‑1 alpha-2 code. */
2924
- code: string;
2925
- /** Display name. */
2926
- label: string;
2927
- /** VAT prefix (e.g. "PL", "DE"). */
2928
- prefix: string;
2929
- /** Regex pattern for the numeric part (without prefix). */
2930
- pattern: RegExp;
2931
- /** Mask/placeholder hint. */
2932
- placeholder?: string;
2933
- }
2789
+ export declare type UploadStatus = 'pending' | 'uploading' | 'success' | 'error' | 'cancelled';
2934
2790
 
2935
2791
  /** A wiki page tree node. */
2936
2792
  declare interface WikiPage {