@nice2dev/ui 1.0.29 → 1.0.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (108) hide show
  1. package/CHANGELOG.md +512 -0
  2. package/README.md +30 -31
  3. package/dist/NiceBackupStatusBadge.doc-Bx2bFmBQ.cjs +1 -0
  4. package/dist/NiceBackupStatusBadge.doc-CdDxIQ-M.js +25 -0
  5. package/dist/NiceCalendarScheduler.doc-BEtQkZjV.cjs +9 -0
  6. package/dist/NiceCalendarScheduler.doc-D__LRgOx.js +33 -0
  7. package/dist/NiceConfirmDialog-B57cl_F7.cjs +1 -0
  8. package/dist/NiceConfirmDialog-BiTJVR4-.js +81 -0
  9. package/dist/NiceConfirmDialog-Bjw_rN4o.cjs +1 -0
  10. package/dist/NiceConfirmDialog-N9fBTLYm.js +81 -0
  11. package/dist/NiceDrawingCanvas.doc-Dv5vB4gY.js +32 -0
  12. package/dist/NiceDrawingCanvas.doc-Ww9zz17x.cjs +8 -0
  13. package/dist/NiceErrorBoundary-1H751jK7.cjs +1 -0
  14. package/dist/NiceErrorBoundary-B-txoU3Y.js +709 -0
  15. package/dist/NiceErrorBoundary-BD-uqk_q.js +709 -0
  16. package/dist/NiceErrorBoundary-CIPXaYik.cjs +1 -0
  17. package/dist/NiceFileManagerViews.doc-CKlnm6cX.cjs +1 -0
  18. package/dist/NiceFileManagerViews.doc-Cg21DArG.js +25 -0
  19. package/dist/NiceForm-BNZB31Pg.js +4499 -0
  20. package/dist/NiceForm-CPyAXxBO.cjs +1 -0
  21. package/dist/NiceForm-DGUTmaZT.js +5014 -0
  22. package/dist/NiceForm-DmU-gmyv.cjs +382 -0
  23. package/dist/NiceMegaMenu.doc-7UyOCd3l.cjs +7 -0
  24. package/dist/NiceMegaMenu.doc-zeIyVa65.js +31 -0
  25. package/dist/NiceModal-BClAtR5T.js +95 -0
  26. package/dist/NiceModal-Bj53SKLI.js +95 -0
  27. package/dist/NiceModal-DC0UlQhc.cjs +1 -0
  28. package/dist/NiceModal-iKwtagFB.cjs +1 -0
  29. package/dist/NiceModuleLifecyclePanel-BBOg9g0b.cjs +1 -0
  30. package/dist/NiceModuleLifecyclePanel-BO8Hw_W9.js +7619 -0
  31. package/dist/NiceModuleLifecyclePanel-Ch7HRRoy.cjs +1 -0
  32. package/dist/NiceModuleLifecyclePanel-DtuXRiLR.js +6991 -0
  33. package/dist/NiceModuleLifecyclePanel.css +1 -1
  34. package/dist/NicePagination-BVo-4KAD.js +172 -0
  35. package/dist/NicePagination-Bjxy9aEc.js +172 -0
  36. package/dist/NicePagination-CaohvQsY.cjs +1 -0
  37. package/dist/NicePagination-CfFfNwrg.cjs +1 -0
  38. package/dist/NicePinCodeInput-DsyLuc0b.cjs +696 -0
  39. package/dist/NicePinCodeInput-nuRCN-9R.js +13223 -0
  40. package/dist/NiceSavedQueryPanel-BBFV4qiF.js +6969 -0
  41. package/dist/NiceSavedQueryPanel-CH5c3rUG.js +6988 -0
  42. package/dist/NiceSavedQueryPanel-CsiVNkCT.cjs +596 -0
  43. package/dist/NiceSavedQueryPanel-aQrEmmcC.cjs +596 -0
  44. package/dist/NiceScannerControl-Cd5KXJA9.js +12769 -0
  45. package/dist/NiceScannerControl-DZsERSw_.cjs +698 -0
  46. package/dist/NiceScannerControl.css +1 -0
  47. package/dist/NiceWindow-BoDzlGk-.js +1621 -0
  48. package/dist/NiceWindow-Cm9E6EAi.cjs +1 -0
  49. package/dist/NiceWindow-DgONWxBm.cjs +1 -0
  50. package/dist/NiceWindow-FMrVS7zo.js +1603 -0
  51. package/dist/charts-B90sSFeJ.cjs +761 -0
  52. package/dist/charts-Bs0aDM0X.js +4671 -0
  53. package/dist/charts-DaLf19vS.js +4671 -0
  54. package/dist/charts-DjjKkw0q.cjs +761 -0
  55. package/dist/charts.cjs +1 -1
  56. package/dist/charts.mjs +1 -1
  57. package/dist/core-BUTtIHg0.js +27766 -0
  58. package/dist/core-BUsZ7_vI.js +27914 -0
  59. package/dist/core-CESNSRyS.cjs +122 -0
  60. package/dist/core-CLfcCDKc.cjs +122 -0
  61. package/dist/data-branching-ByQdcjKO.cjs +1 -0
  62. package/dist/data-branching-D7l_kILW.cjs +1 -0
  63. package/dist/data-branching-lJ07lDN-.js +6255 -0
  64. package/dist/data-branching-psTzlcrT.js +6255 -0
  65. package/dist/data-branching.cjs +1 -1
  66. package/dist/data-branching.mjs +1 -1
  67. package/dist/data.cjs +1 -1
  68. package/dist/data.d.ts +41 -37
  69. package/dist/data.mjs +18 -19
  70. package/dist/devops-Bi8MXtko.js +8165 -0
  71. package/dist/devops-D7bQ3rE4.cjs +17 -0
  72. package/dist/devops-On_1wRf9.cjs +17 -0
  73. package/dist/devops-jCmpD6O-.js +8165 -0
  74. package/dist/devops.cjs +1 -1
  75. package/dist/devops.mjs +3 -3
  76. package/dist/editors.cjs +1 -1
  77. package/dist/editors.d.ts +219 -431
  78. package/dist/editors.mjs +48 -56
  79. package/dist/feedback.cjs +1 -1
  80. package/dist/feedback.mjs +3 -3
  81. package/dist/index-BDH1yDSg.js +69235 -0
  82. package/dist/index-BpixglWg.js +69337 -0
  83. package/dist/index-C9njkNOD.cjs +5470 -0
  84. package/dist/index-DLR-aWZR.cjs +5506 -0
  85. package/dist/index.cjs +1 -1
  86. package/dist/index.css +1 -1
  87. package/dist/index.d.ts +798 -1059
  88. package/dist/index.mjs +741 -756
  89. package/dist/lazy.cjs +1 -1
  90. package/dist/lazy.mjs +24 -24
  91. package/dist/navigation.cjs +1 -1
  92. package/dist/navigation.d.ts +25 -213
  93. package/dist/navigation.mjs +143 -151
  94. package/dist/no-code-8lO7o6xi.js +7425 -0
  95. package/dist/no-code-BHo5WrXr.js +7425 -0
  96. package/dist/no-code-DyA_1_Th.cjs +332 -0
  97. package/dist/no-code-K8tOLNew.cjs +332 -0
  98. package/dist/no-code.cjs +1 -1
  99. package/dist/no-code.mjs +1 -1
  100. package/dist/overlays.cjs +1 -1
  101. package/dist/overlays.d.ts +12 -0
  102. package/dist/overlays.mjs +82 -82
  103. package/dist/pickerCommons-BEc3pZ_s.js +2044 -0
  104. package/dist/pickerCommons-CORo9j2a.js +2119 -0
  105. package/dist/pickerCommons-CrITwM88.cjs +1 -0
  106. package/dist/pickerCommons-D3WShRrR.cjs +1 -0
  107. package/dist/style.css +5 -5
  108. package/package.json +3 -3
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>;
@@ -710,8 +714,16 @@ export declare interface NiceColorPaletteProps extends NiceBaseProps {
710
714
  variationCount?: number;
711
715
  /** Label */
712
716
  label?: string;
717
+ /** Label position relative to the swatch strip. Default `'top'`. */
718
+ labelPlacement?: 'top' | 'left';
713
719
  /** Disabled state */
714
720
  disabled?: boolean;
721
+ /** Looks enabled but the studio won't open and edits are blocked. */
722
+ readOnly?: boolean;
723
+ /** Show a loading spinner and dim the control. */
724
+ loading?: boolean;
725
+ /** Error ring; a string value also renders the message. */
726
+ error?: string | boolean;
715
727
  /**
716
728
  * Target number of colors in the generated palette. Overrides the natural
717
729
  * count of the active harmony mode (clamped between `minColors` and
@@ -748,6 +760,10 @@ export declare interface NiceColorPickerProps extends NiceFormFieldProps {
748
760
  /** When true, the popup includes an alpha (transparency) slider and the
749
761
  * emitted value uses 8-character hex `#RRGGBBAA`. Default: `false`. */
750
762
  withAlpha?: boolean;
763
+ /** Compact inline layout: swatch + hex on a single tight row and the
764
+ * "Random" button hidden, so many fields can sit side-by-side in a grid.
765
+ * Default: `false`. */
766
+ compact?: boolean;
751
767
  }
752
768
 
753
769
  declare type NiceColorPreset = 'lightest-pastel' | 'bright-pastel' | 'shiny' | 'pastel' | 'full' | 'dark' | 'deep' | 'muted' | 'earth';
@@ -780,19 +796,6 @@ export declare interface NiceContactPickerProps extends NiceFormFieldProps {
780
796
  maxSelections?: number;
781
797
  }
782
798
 
783
- /** Built-in countdown format presets. */
784
- declare type NiceCountdownFormat =
785
- /** `1d 02:34:15` / `02:34:15` — leading day count + clock */
786
- 'verbose'
787
- /** `1d 2h 34m 15s` — abbreviated units */
788
- | 'compact'
789
- /** `2:34:15` / `34:15` — pure clock */
790
- | 'short'
791
- /** `in 2h` / `in 5m` / `in 30s` — single coarsest unit */
792
- | 'minimal'
793
- /** `1 day, 2 hours, 34 minutes` — verbose words */
794
- | 'words';
795
-
796
799
  export declare const NiceCountryPicker: default_2.FC<NiceCountryPickerProps>;
797
800
 
798
801
  export declare interface NiceCountryPickerProps extends NiceFormFieldProps, DualVisibilityProps {
@@ -907,39 +910,6 @@ export declare interface NiceCropEditorProps {
907
910
  tutorial?: NiceComponentTutorial;
908
911
  }
909
912
 
910
- /**
911
- * {@link NiceCurrencyInput} — Amount input with currency selector, locale-aware formatting.
912
- */
913
- export declare const NiceCurrencyInput: default_2.ForwardRefExoticComponent<NiceCurrencyInputProps & default_2.RefAttributes<HTMLDivElement>>;
914
-
915
- /** Props for the {@link NiceCurrencyInput} component. */
916
- export declare interface NiceCurrencyInputProps extends NiceFormFieldProps {
917
- /** Controlled numeric amount (minor unit or major, based on `useMinorUnit`). */
918
- value?: number | null;
919
- /** Fires on amount change. */
920
- onChange?: (value: number | null) => void;
921
- /** Selected currency code (ISO 4217). */
922
- currency?: string;
923
- /** Fires when user changes currency. */
924
- onCurrencyChange?: (code: string) => void;
925
- /** Available currencies. */
926
- currencies?: CurrencyDef[];
927
- /** Whether to store value in minor units (cents). Default `false`. */
928
- useMinorUnit?: boolean;
929
- /** Minimum value. */
930
- min?: number;
931
- /** Maximum value. */
932
- max?: number;
933
- /** Override locale for formatting (e.g. "pl-PL"). */
934
- locale?: string;
935
- /** Placeholder text. */
936
- placeholder?: string;
937
- /** Whether to show currency selector (default `true` if currencies provided). */
938
- showCurrencySelector?: boolean;
939
- /** Fires on blur with the input event. */
940
- onBlur?: (e: default_2.FocusEvent<HTMLInputElement>) => void;
941
- }
942
-
943
913
  /** A user-defined harmony scheme (hue angles + optional lightness offsets). */
944
914
  declare interface NiceCustomHarmonyScheme {
945
915
  id: string;
@@ -952,10 +922,61 @@ declare interface NiceCustomHarmonyScheme {
952
922
  /** Predefined date-format presets. */
953
923
  export declare type NiceDateFormatPreset = 'date-local' | 'date-utc' | 'datetime-local' | 'datetime-utc' | 'month-local' | 'month-utc' | 'week' | 'time';
954
924
 
955
- export declare const NiceDatePicker: default_2.ForwardRefExoticComponent<NiceDatePickerProps & default_2.RefAttributes<HTMLInputElement>>;
925
+ export declare const NiceDateRangeBox: default_2.FC<NiceDateRangeBoxProps>;
926
+
927
+ /** Props for the {@link NiceDateRangeBox} component — a pair of date pickers for selecting a date range. */
928
+ export declare interface NiceDateRangeBoxProps extends NiceFormFieldProps {
929
+ /** Start date (ISO string). */
930
+ startDate: string;
931
+ /** End date (ISO string). */
932
+ endDate: string;
933
+ /** Called when the start date changes. */
934
+ onStartChange: (date: string) => void;
935
+ /** Called when the end date changes. */
936
+ onEndChange: (date: string) => void;
937
+ /** Earliest selectable date. */
938
+ min?: string;
939
+ /** Latest selectable date. */
940
+ max?: string;
941
+ /** Show a clear button. */
942
+ clearable?: boolean;
943
+ /** Placeholder for the start input. */
944
+ startPlaceholder?: string;
945
+ /** Placeholder for the end input. */
946
+ endPlaceholder?: string;
947
+ /** Label shown above (or before) the start picker. */
948
+ startLabel?: string;
949
+ /** Label shown above (or before) the end picker. */
950
+ endLabel?: string;
951
+ /** Layout direction for the two pickers (default `horizontal`). */
952
+ layout?: 'horizontal' | 'vertical';
953
+ /** Custom separator rendered between pickers in horizontal layout (default `–`). Pass `''` to hide. */
954
+ separator?: default_2.ReactNode;
955
+ /** Gap in pixels between the two pickers (default 12). */
956
+ gap?: number;
957
+ /** Stretch each picker to fill available width. */
958
+ fullWidth?: boolean;
959
+ /**
960
+ * Format preset forwarded to BOTH inner pickers — so a range can be
961
+ * date, datetime (`'datetime-local'`), month, week or time, not just date.
962
+ */
963
+ dateFormatPreset?: NiceDateFormatPreset;
964
+ /**
965
+ * @deprecated Use `dateFormatPreset`. Native input type forwarded to both
966
+ * inner pickers.
967
+ */
968
+ type?: 'date' | 'datetime-local' | 'time' | 'month' | 'week';
969
+ }
970
+
971
+ /** Built-in countdown format presets (merged in from NiceTimePicker).
972
+ * NOTE: deliberately NOT named `NiceCountdownFormat` — that name is already a
973
+ * public export of the unrelated `NiceCountdown` display component. */
974
+ declare type NiceDateTimeCountdownFormat = 'verbose' | 'compact' | 'short' | 'minimal' | 'words';
956
975
 
957
- /** Props for the {@link NiceDatePicker} component — a masked, locale-aware date/time input. */
958
- export declare interface NiceDatePickerProps extends NiceFormFieldProps {
976
+ export declare const NiceDateTimePicker: default_2.ForwardRefExoticComponent<NiceDateTimePickerProps & default_2.RefAttributes<HTMLInputElement>>;
977
+
978
+ /** Props for the {@link NiceDateTimePicker} component — a masked, locale-aware date/time input. */
979
+ export declare interface NiceDateTimePickerProps extends NiceFormFieldProps {
959
980
  /** ISO value (e.g. `'2024-06-15'`). Always ISO regardless of display locale. */
960
981
  value?: string;
961
982
  /** Fires with the new ISO value. Empty string while the input is incomplete. */
@@ -999,66 +1020,44 @@ export declare interface NiceDatePickerProps extends NiceFormFieldProps {
999
1020
  * Only fires for date / datetime / month presets.
1000
1021
  */
1001
1022
  keyboardShortcuts?: boolean;
1002
- }
1003
-
1004
- export declare const NiceDateRangeBox: default_2.FC<NiceDateRangeBoxProps>;
1005
-
1006
- /** Props for the {@link NiceDateRangeBox} component — a pair of date pickers for selecting a date range. */
1007
- export declare interface NiceDateRangeBoxProps extends NiceFormFieldProps {
1008
- /** Start date (ISO string). */
1009
- startDate: string;
1010
- /** End date (ISO string). */
1011
- endDate: string;
1012
- /** Called when the start date changes. */
1013
- onStartChange: (date: string) => void;
1014
- /** Called when the end date changes. */
1015
- onEndChange: (date: string) => void;
1016
- /** Earliest selectable date. */
1017
- min?: string;
1018
- /** Latest selectable date. */
1019
- max?: string;
1020
- /** Show a clear button. */
1021
- clearable?: boolean;
1022
- /** Placeholder for the start input. */
1023
- startPlaceholder?: string;
1024
- /** Placeholder for the end input. */
1025
- endPlaceholder?: string;
1026
- /** Label shown above (or before) the start picker. */
1027
- startLabel?: string;
1028
- /** Label shown above (or before) the end picker. */
1029
- endLabel?: string;
1030
- /** Layout direction for the two pickers (default `horizontal`). */
1031
- layout?: 'horizontal' | 'vertical';
1032
- /** Custom separator rendered between pickers in horizontal layout (default `–`). Pass `''` to hide. */
1033
- separator?: default_2.ReactNode;
1034
- /** Gap in pixels between the two pickers (default 12). */
1035
- gap?: number;
1036
- /** Stretch each picker to fill available width. */
1037
- fullWidth?: boolean;
1038
- }
1039
-
1040
- export declare const NiceDateTimePicker: default_2.ForwardRefExoticComponent<NiceDateTimePickerProps & default_2.RefAttributes<HTMLDivElement>>;
1041
-
1042
- /** Props for the {@link NiceDateTimePicker} component — a combined date and time picker with calendar dropdown. */
1043
- export declare interface NiceDateTimePickerProps extends NiceFormFieldProps {
1044
- /** ISO 8601 date-time string (e.g. "2026-03-16T14:30") */
1045
- value?: string;
1046
- onChange?: (value: string) => void;
1047
- onBlur?: (e: default_2.FocusEvent) => void;
1048
- /** Minimum allowed date-time (ISO string) */
1049
- min?: string;
1050
- /** Maximum allowed date-time (ISO string) */
1051
- max?: string;
1052
- /** Display format — 12h shows AM/PM toggle, 24h shows 0–23 */
1053
- hourFormat?: '12' | '24';
1054
- /** Minute increment step */
1055
- minuteStep?: number;
1056
- /** Show seconds input */
1023
+ /** Datetime/time: show a seconds section (`HH:mm:ss`). Default: `false`. */
1057
1024
  showSeconds?: boolean;
1058
- /** Show "Now" quick button */
1025
+ /**
1026
+ * Datetime/time: minute increment. Drives the native picker companion `step`
1027
+ * AND the ↑/↓ arrow stepping in the masked field.
1028
+ */
1029
+ minuteStep?: number;
1030
+ /**
1031
+ * Datetime/time: `'12'` renders an AM/PM toggle beside the field (and asks the
1032
+ * native picker for a 12-hour dialog where the OS locale supports it). The
1033
+ * masked field always edits 24-hour digits and the emitted value stays ISO 24h.
1034
+ */
1035
+ hourFormat?: '12' | '24';
1036
+ /**
1037
+ * Datetime/time/date: show a "Now" button that fills the current date/time.
1038
+ * Default: `false`.
1039
+ */
1059
1040
  showNow?: boolean;
1060
- /** Show clear button */
1061
- clearable?: boolean;
1041
+ /**
1042
+ * Explicit target date to combine with the picked time (`Date` or
1043
+ * `YYYY-MM-DD`). When omitted while {@link countdown} is on, the target
1044
+ * auto-resolves to the next occurrence (today, else tomorrow).
1045
+ */
1046
+ targetDate?: string | Date;
1047
+ /** Fires whenever the resolved countdown target changes. */
1048
+ onTargetChange?: (target: Date) => void;
1049
+ /** Show a live countdown label beside the field. */
1050
+ countdown?: boolean;
1051
+ /** Built-in countdown format preset (default `'verbose'`). */
1052
+ countdownFormat?: NiceDateTimeCountdownFormat;
1053
+ /** Custom countdown formatter (overrides {@link countdownFormat}). */
1054
+ formatCountdown?: (msRemaining: number, target: Date) => string;
1055
+ /** Label rendered before the countdown text (e.g. `'starts in'`). */
1056
+ countdownLabel?: default_2.ReactNode;
1057
+ /** Countdown tick interval in ms (default 1000, min 100). */
1058
+ countdownInterval?: number;
1059
+ /** Text shown once the countdown reaches zero. */
1060
+ countdownDoneText?: string;
1062
1061
  }
1063
1062
 
1064
1063
  /** A content block in the {@link NiceDocumentEditor}. */
@@ -1185,90 +1184,6 @@ export declare interface NiceEmojiPickerProps {
1185
1184
  'data-testid'?: string;
1186
1185
  }
1187
1186
 
1188
- export declare const NiceFileUpload: default_2.ForwardRefExoticComponent<NiceFileUploadProps & default_2.RefAttributes<NiceFileUploadRef>>;
1189
-
1190
- export declare interface NiceFileUploadProps extends NiceBaseProps {
1191
- /** Akceptowane typy plików (np. "image/*,.pdf") */
1192
- accept?: string;
1193
- /** Czy pozwalać na multiple files */
1194
- multiple?: boolean;
1195
- /** Maksymalny rozmiar pliku w bajtach */
1196
- maxFileSize?: number;
1197
- /** Maksymalna liczba plików */
1198
- maxFiles?: number;
1199
- /** Minimalny rozmiar pliku */
1200
- minFileSize?: number;
1201
- /** Rozmiar chunka dla dużych plików (domyślnie 5MB) */
1202
- chunkSize?: number;
1203
- /** Próg rozmiaru pliku dla chunked upload (domyślnie 10MB) */
1204
- chunkThreshold?: number;
1205
- /** Automatycznie rozpocznij upload po dodaniu */
1206
- autoUpload?: boolean;
1207
- /** Handler uploadu */
1208
- uploadHandler?: UploadHandler;
1209
- /** URL do uploadu (jeśli nie podano uploadHandler) */
1210
- uploadUrl?: string;
1211
- /** Nagłówki HTTP dla uploadu */
1212
- uploadHeaders?: Record<string, string>;
1213
- /** Callback po dodaniu plików */
1214
- onFilesAdded?: (files: FileInfo[]) => void;
1215
- /** Callback po zakończeniu uploadu */
1216
- onUploadComplete?: (file: FileInfo) => void;
1217
- /** Callback po błędzie */
1218
- onUploadError?: (file: FileInfo, error: string) => void;
1219
- /** Callback na postęp */
1220
- onProgress?: (file: FileInfo, progress: number) => void;
1221
- /** Callback po usunięciu */
1222
- onFileRemoved?: (file: FileInfo) => void;
1223
- /** Callback po zmianie stanu */
1224
- onChange?: (files: FileInfo[]) => void;
1225
- /** Niestandardowy renderer podglądu */
1226
- renderPreview?: (file: FileInfo) => default_2.ReactNode;
1227
- /** Niestandardowy renderer elementu listy */
1228
- renderFileItem?: (file: FileInfo, actions: FileItemActions) => default_2.ReactNode;
1229
- /** Pokaż podgląd obrazów */
1230
- showPreview?: boolean;
1231
- /** Pokaż listę plików */
1232
- showFileList?: boolean;
1233
- /** Tryb wyświetlania listy */
1234
- listMode?: 'list' | 'grid' | 'compact';
1235
- /** Rozmiar podglądu */
1236
- previewSize?: NiceSize;
1237
- /** Tekst w dropzone */
1238
- dropzoneText?: string;
1239
- /** Tekst pod przyciskiem */
1240
- browseText?: string;
1241
- /** Tekst podczas dragover */
1242
- dragActiveText?: string;
1243
- /** Wyłączony */
1244
- disabled?: boolean;
1245
- /** Read-only (tylko podgląd) */
1246
- readOnly?: boolean;
1247
- /** Customowe klasy CSS */
1248
- dropzoneClassName?: string;
1249
- /** Retry count */
1250
- maxRetries?: number;
1251
- /** Ilość równoczesnych uploadów */
1252
- concurrentUploads?: number;
1253
- /** Walidator plików */
1254
- validateFile?: (file: File) => string | null;
1255
- /** Zachowaj pliki po uploadzięciu */
1256
- keepFilesAfterUpload?: boolean;
1257
- /** Początkowe pliki */
1258
- initialFiles?: FileInfo[];
1259
- }
1260
-
1261
- declare interface NiceFileUploadRef {
1262
- addFiles: (files: File[]) => void;
1263
- uploadAll: () => void;
1264
- cancelAll: () => void;
1265
- clearAll: () => void;
1266
- getFiles: () => FileInfo[];
1267
- getFile: (id: string) => FileInfo | undefined;
1268
- retryFailed: () => void;
1269
- openFileBrowser: () => void;
1270
- }
1271
-
1272
1187
  export declare const NiceForm: default_2.FC<NiceFormProps>;
1273
1188
 
1274
1189
  /** Describes a single field in a {@link NiceForm} layout. */
@@ -1386,8 +1301,16 @@ export declare interface NiceGradientPickerProps extends NiceBaseProps {
1386
1301
  /** Maximum number of gradient stops */
1387
1302
  maxStops?: number;
1388
1303
  label?: string;
1304
+ /** Label position relative to the swatch. Default `'top'`. */
1305
+ labelPlacement?: 'top' | 'left';
1389
1306
  disabled?: boolean;
1390
- /** Fixed width of the whole control. Defaults to 320px so the layout stays stable when stops are added. */
1307
+ /** Looks enabled but the popup won't open and edits are blocked. */
1308
+ readOnly?: boolean;
1309
+ /** Show a loading spinner and dim the control. */
1310
+ loading?: boolean;
1311
+ /** Error ring; a string value also renders the message. */
1312
+ error?: string | boolean;
1313
+ /** Fixed width of the popup. Defaults to 340px. */
1391
1314
  width?: string | number;
1392
1315
  }
1393
1316
 
@@ -1819,6 +1742,8 @@ export declare interface NiceLookupProps extends NiceFormFieldProps {
1819
1742
  displayField?: string;
1820
1743
  /** Width of the dropdown when in mini-grid mode (CSS). */
1821
1744
  dropdownWidth?: string | number;
1745
+ /** Gap (px) between the input and the dropdown menu. Default 0 (menu abuts the input). */
1746
+ menuGap?: number;
1822
1747
  }
1823
1748
 
1824
1749
  export declare const NiceMarkdownEditor: default_2.ForwardRefExoticComponent<NiceMarkdownEditorProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -1952,6 +1877,8 @@ export declare interface NiceNumberInputProps extends NiceFormFieldProps {
1952
1877
  suffixValue?: string;
1953
1878
  /** Called when the suffix select changes. */
1954
1879
  onSuffixChange?: (value: string, prevWeight: number | undefined, newWeight: number | undefined) => void;
1880
+ /** Show a divider line between the value and the suffix. Default `false`. */
1881
+ suffixSeparator?: boolean;
1955
1882
  }
1956
1883
 
1957
1884
  export declare const NicePasswordInput: default_2.ForwardRefExoticComponent<NicePasswordInputProps & default_2.RefAttributes<HTMLInputElement>>;
@@ -2029,31 +1956,6 @@ export declare interface NicePDFAnnotationEditorProps extends NiceFormFieldProps
2029
1956
  tutorial?: NiceComponentTutorial;
2030
1957
  }
2031
1958
 
2032
- /**
2033
- * {@link NicePhoneInput} — Phone number input with country code selector, masking, and E.164 formatting.
2034
- */
2035
- export declare const NicePhoneInput: default_2.ForwardRefExoticComponent<NicePhoneInputProps & default_2.RefAttributes<HTMLDivElement>>;
2036
-
2037
- /** Props for the {@link NicePhoneInput} component. */
2038
- export declare interface NicePhoneInputProps extends NiceFormFieldProps {
2039
- /** Controlled phone value. */
2040
- value?: PhoneValue;
2041
- /** Fires on value change with parsed phone value. */
2042
- onChange?: (value: PhoneValue) => void;
2043
- /** Available country codes. */
2044
- countryCodes?: PhoneCountryCode[];
2045
- /** Default country code (ISO alpha-2, e.g. "PL"). */
2046
- defaultCountry?: string;
2047
- /** Placeholder for the number part. */
2048
- placeholder?: string;
2049
- /** Whether to show the country flag emoji. */
2050
- showFlag?: boolean;
2051
- /** Whether to validate as E.164 on blur. */
2052
- validateE164?: boolean;
2053
- /** Fires with the raw input event. */
2054
- onBlur?: (e: default_2.FocusEvent<HTMLInputElement>) => void;
2055
- }
2056
-
2057
1959
  export declare const NicePickList: <T = unknown>(props: NicePickListProps<T> & default_2.RefAttributes<HTMLDivElement>) => default_2.ReactElement | null;
2058
1960
 
2059
1961
  /** Props for the {@link NicePickList} component — a dual-list control for moving items between source and target. */
@@ -2096,34 +1998,6 @@ export declare interface NicePickListProps<T = unknown> extends NiceBaseProps {
2096
1998
  size?: NiceSize;
2097
1999
  }
2098
2000
 
2099
- /**
2100
- * {@link NicePinCodeInput} — PIN code entry with individual digit boxes,
2101
- * optional numeric keypad, masking, and auto-submit.
2102
- */
2103
- export declare const NicePinCodeInput: default_2.ForwardRefExoticComponent<NicePinCodeInputProps & default_2.RefAttributes<HTMLDivElement>>;
2104
-
2105
- /** Props for the {@link NicePinCodeInput} component. */
2106
- export declare interface NicePinCodeInputProps extends NiceFormFieldProps {
2107
- /** Current PIN value. */
2108
- value?: string;
2109
- /** Fires when value changes. */
2110
- onChange?: (value: string) => void;
2111
- /** Fires when PIN is fully entered. */
2112
- onComplete?: (pin: string) => void;
2113
- /** Number of PIN digits. */
2114
- length?: number;
2115
- /** Whether to mask digits (show dots). */
2116
- masked?: boolean;
2117
- /** Whether to show a numeric keypad below the input. */
2118
- showKeypad?: boolean;
2119
- /** Whether to auto-submit when all digits are filled. */
2120
- autoSubmit?: boolean;
2121
- /** Error shake animation trigger (toggle to replay). */
2122
- shake?: boolean;
2123
- /** Placeholder character. */
2124
- placeholderChar?: string;
2125
- }
2126
-
2127
2001
  export declare const NiceRadioGroup: default_2.FC<NiceRadioGroupProps>;
2128
2002
 
2129
2003
  /** Props for the {@link NiceRadioGroup} component — a set of mutually exclusive radio options. */
@@ -2148,12 +2022,12 @@ export declare interface NiceRangeSliderProps extends NiceFormFieldProps {
2148
2022
  max?: number;
2149
2023
  /** Step increment. */
2150
2024
  step?: number;
2151
- /** Start (lower) thumb value. */
2152
- startValue: number;
2153
- /** End (upper) thumb value. */
2154
- endValue: number;
2025
+ /** Start (lower) thumb value. Defaults to `min`. */
2026
+ startValue?: number;
2027
+ /** End (upper) thumb value. Defaults to `max`. */
2028
+ endValue?: number;
2155
2029
  /** Called when either thumb moves. */
2156
- onChange: (start: number, end: number) => void;
2030
+ onChange?: (start: number, end: number) => void;
2157
2031
  /** Show value labels at each thumb. */
2158
2032
  showLabels?: boolean;
2159
2033
  /** Custom label formatter. */
@@ -2350,27 +2224,6 @@ declare interface NiceSignatureData {
2350
2224
 
2351
2225
  declare type NiceSignatureOutput = 'png' | 'jpeg' | 'svg';
2352
2226
 
2353
- export declare const NiceSignaturePad: ForwardRefExoticComponent<NiceSignaturePadProps & RefAttributes<HTMLDivElement>>;
2354
-
2355
- /** Props for the {@link NiceSignaturePad} component — a canvas-based digital signature capture pad. */
2356
- export declare interface NiceSignaturePadProps extends NiceBaseProps {
2357
- /** Signature image (data URL) — controlled value */
2358
- value?: string | null;
2359
- onChange?: (dataUrl: string | null) => void;
2360
- penColor?: string;
2361
- penWidth?: number;
2362
- backgroundColor?: string;
2363
- width?: number;
2364
- height?: number;
2365
- size?: NiceSize;
2366
- disabled?: boolean;
2367
- readOnly?: boolean;
2368
- showClear?: boolean;
2369
- showUndo?: boolean;
2370
- label?: string;
2371
- exportFormat?: 'image/png' | 'image/jpeg' | 'image/svg+xml';
2372
- }
2373
-
2374
2227
  declare interface NiceSignaturePoint {
2375
2228
  x: number;
2376
2229
  y: number;
@@ -2383,6 +2236,12 @@ export declare interface NiceSignatureProps {
2383
2236
  value?: NiceSignatureData | null;
2384
2237
  /** Value change callback */
2385
2238
  onChange?: (data: NiceSignatureData | null) => void;
2239
+ /** Convenience callback emitting the signature as a PNG data URL (null when
2240
+ * cleared) — for form consumers that bind a string value. Ported from the
2241
+ * former NiceSignaturePad. */
2242
+ onChangeDataUrl?: (url: string | null) => void;
2243
+ /** Field label shown above the pad. */
2244
+ label?: string;
2386
2245
  /** Width */
2387
2246
  width?: number | string;
2388
2247
  /** Height */
@@ -2531,29 +2390,6 @@ export declare interface NiceTagBoxProps extends NiceFormFieldProps {
2531
2390
  autoExpand?: boolean;
2532
2391
  }
2533
2392
 
2534
- /**
2535
- * {@link NiceTaxRatePicker} — VAT/tax rate selector with country-specific defaults.
2536
- * Supports Polish rates out-of-the-box, custom rates per country, and displays
2537
- * percentage values.
2538
- */
2539
- export declare const NiceTaxRatePicker: default_2.ForwardRefExoticComponent<NiceTaxRatePickerProps & default_2.RefAttributes<HTMLDivElement>>;
2540
-
2541
- /** Props for the {@link NiceTaxRatePicker} component. */
2542
- export declare interface NiceTaxRatePickerProps extends NiceFormFieldProps {
2543
- /** Selected tax rate id. */
2544
- value?: string;
2545
- /** Fires when selection changes. */
2546
- onChange?: (rateId: string, rate: TaxRate) => void;
2547
- /** Available tax rates. If empty, defaults to Polish VAT rates. */
2548
- rates?: TaxRate[];
2549
- /** Country code filter. */
2550
- countryCode?: string;
2551
- /** Placeholder text. */
2552
- placeholder?: string;
2553
- /** Whether to show rate percentage in the label. */
2554
- showPercentage?: boolean;
2555
- }
2556
-
2557
2393
  export declare const NiceTextArea: default_2.ForwardRefExoticComponent<NiceTextAreaProps & default_2.RefAttributes<HTMLTextAreaElement>>;
2558
2394
 
2559
2395
  export declare interface NiceTextAreaProps extends NiceFormFieldProps {
@@ -2606,49 +2442,6 @@ export declare interface NiceTextInputProps extends Omit<NiceFormFieldProps, 'la
2606
2442
  variant?: 'outlined' | 'filled' | 'underlined' | string;
2607
2443
  }
2608
2444
 
2609
- export declare const NiceTimePicker: default_2.ForwardRefExoticComponent<NiceTimePickerProps & default_2.RefAttributes<HTMLDivElement>>;
2610
-
2611
- /** Props for the {@link NiceTimePicker} component — a time-only picker with hour/minute/second spinners. */
2612
- export declare interface NiceTimePickerProps extends NiceFormFieldProps {
2613
- /** Time string in HH:mm or HH:mm:ss format */
2614
- value?: string;
2615
- onChange?: (value: string) => void;
2616
- onBlur?: (e: default_2.FocusEvent) => void;
2617
- /** Display format — 12h shows AM/PM toggle, 24h shows 0–23 */
2618
- hourFormat?: '12' | '24';
2619
- /** Minute increment step */
2620
- minuteStep?: number;
2621
- /** Show seconds input */
2622
- showSeconds?: boolean;
2623
- /** Minimum time (HH:mm) */
2624
- min?: string;
2625
- /** Maximum time (HH:mm) */
2626
- max?: string;
2627
- /** Show clear button */
2628
- clearable?: boolean;
2629
- /**
2630
- * Optional explicit target date to combine with the picked time
2631
- * (`Date` or `YYYY-MM-DD` string). When omitted while {@link countdown}
2632
- * is enabled, the target auto-resolves to the **next occurrence**:
2633
- * today if the picked time hasn't passed yet, tomorrow if it has.
2634
- */
2635
- targetDate?: string | Date;
2636
- /** Fires whenever the resolved target Date changes. */
2637
- onTargetChange?: (target: Date) => void;
2638
- /** Show a live countdown label beside the picker. */
2639
- countdown?: boolean;
2640
- /** Built-in countdown format preset (default `'verbose'`). */
2641
- countdownFormat?: NiceCountdownFormat;
2642
- /** Custom formatter (overrides {@link countdownFormat}). */
2643
- formatCountdown?: (msRemaining: number, target: Date) => string;
2644
- /** Label rendered before the countdown text (e.g. `'starts in'`). */
2645
- countdownLabel?: default_2.ReactNode;
2646
- /** Update interval in ms (default `1000`). */
2647
- countdownInterval?: number;
2648
- /** Text shown when the target time has elapsed (default `'now'`). */
2649
- countdownDoneText?: string;
2650
- }
2651
-
2652
2445
  export declare const NiceToggle: default_2.ForwardRefExoticComponent<NiceToggleProps & default_2.RefAttributes<HTMLInputElement>>;
2653
2446
 
2654
2447
  /** Props for the {@link NiceToggle} component — a boolean switch/toggle. */
@@ -2718,40 +2511,82 @@ export declare interface NiceTreeSelectProps extends NiceFormFieldProps {
2718
2511
  * leaves (children not rendered, no expand toggle). Default: unlimited.
2719
2512
  */
2720
2513
  maxDepth?: number;
2514
+ /** Gap (px) between the input and the dropdown menu. Default 0 (menu abuts the input). */
2515
+ menuGap?: number;
2721
2516
  }
2722
2517
 
2723
- /**
2724
- * {@link NiceVatInput} — VAT/NIP number input with country selector,
2725
- * prefix auto-prepend, pattern validation, and optional VIES verification.
2726
- */
2727
- export declare const NiceVatInput: default_2.ForwardRefExoticComponent<NiceVatInputProps & default_2.RefAttributes<HTMLDivElement>>;
2518
+ export declare const NiceUpload: default_2.ForwardRefExoticComponent<NiceUploadProps & default_2.RefAttributes<HTMLDivElement>>;
2728
2519
 
2729
- /** Props for the {@link NiceVatInput} component. */
2730
- export declare interface NiceVatInputProps extends NiceFormFieldProps {
2731
- /** Current VAT number value (with or without prefix). */
2732
- value?: string;
2733
- /** Fires when value changes. */
2734
- onChange?: (value: string, isValid: boolean) => void;
2735
- /** Selected country code (ISO 3166-1 alpha-2). */
2736
- countryCode?: string;
2737
- /** Fires when country changes. */
2738
- onCountryChange?: (code: string) => void;
2739
- /** Custom country configs. */
2740
- countries?: VatCountryConfig[];
2741
- /** Whether to show the country selector. */
2742
- showCountrySelector?: boolean;
2743
- /** Whether to auto-prepend VAT prefix. */
2744
- autoPrefixVat?: boolean;
2745
- /** External validation result. */
2746
- validationResult?: {
2747
- valid: boolean;
2748
- companyName?: string;
2749
- error?: string;
2750
- } | null;
2751
- /** Fires when user requests online validation (e.g. VIES). */
2752
- onValidateRequest?: (vatNumber: string, countryCode: string) => void;
2753
- /** Placeholder override. */
2754
- placeholder?: string;
2520
+ /** Imperative handle, exposed via the optional `apiRef` prop (not the div `ref`). */
2521
+ export declare interface NiceUploadHandle {
2522
+ addFiles: (files: File[]) => void;
2523
+ uploadAll: () => void;
2524
+ cancelAll: () => void;
2525
+ clearAll: () => void;
2526
+ getFiles: () => FileInfo[];
2527
+ getFile: (id: string) => FileInfo | undefined;
2528
+ retryFailed: () => void;
2529
+ openFileBrowser: () => void;
2530
+ }
2531
+
2532
+ /** Props for {@link NiceUpload} — drag-and-drop / button file upload with an
2533
+ * optional upload engine (progress, retry/cancel, chunked upload, validation,
2534
+ * previews) absorbed from the former NiceFileUpload. The legacy `NiceFileUploader`
2535
+ * export was retired in favour of this component. */
2536
+ export declare interface NiceUploadProps extends NiceBaseProps {
2537
+ accept?: string;
2538
+ multiple?: boolean;
2539
+ maxFileSize?: number;
2540
+ maxFiles?: number;
2541
+ minFileSize?: number;
2542
+ /** Fires with the current File[] on every add/remove (instant) / Upload click. */
2543
+ onFilesSelected: (files: File[]) => void;
2544
+ uploadMode?: 'instant' | 'useButtons';
2545
+ labelText?: string;
2546
+ /** Idle dropzone label; pass `""` for an icon-only dropzone. */
2547
+ text?: string;
2548
+ dropzoneText?: string;
2549
+ browseText?: string;
2550
+ dragActiveText?: string;
2551
+ /** Icon/label layout in the dropzone: `'right'` (label beside the icon, default) or `'bottom'` (label under it). */
2552
+ labelPlacement?: 'right' | 'bottom';
2553
+ icon?: string | null;
2554
+ showFileList?: boolean;
2555
+ imagePreview?: boolean;
2556
+ showPreview?: boolean;
2557
+ listMode?: 'list' | 'grid' | 'compact';
2558
+ previewSize?: NiceSize;
2559
+ /** External progress override keyed by `file.name` (0–100). */
2560
+ fileProgress?: Record<string, number>;
2561
+ renderPreview?: (file: FileInfo) => default_2.ReactNode;
2562
+ renderFileItem?: (file: FileInfo, actions: FileItemActions) => default_2.ReactNode;
2563
+ variant?: 'dropzone' | 'button';
2564
+ /** Custom content for `variant="button"`. */
2565
+ trigger?: default_2.ReactNode;
2566
+ /** Custom clickable/droppable surface content (replaces the default icon+label). */
2567
+ dropChildren?: default_2.ReactNode;
2568
+ autoUpload?: boolean;
2569
+ uploadHandler?: UploadHandler;
2570
+ uploadUrl?: string;
2571
+ uploadHeaders?: Record<string, string>;
2572
+ concurrentUploads?: number;
2573
+ maxRetries?: number;
2574
+ chunkSize?: number;
2575
+ chunkThreshold?: number;
2576
+ validateFile?: (file: File) => string | null;
2577
+ keepFilesAfterUpload?: boolean;
2578
+ initialFiles?: FileInfo[];
2579
+ disabled?: boolean;
2580
+ readOnly?: boolean;
2581
+ onFilesAdded?: (files: FileInfo[]) => void;
2582
+ onUploadComplete?: (file: FileInfo) => void;
2583
+ onUploadError?: (file: FileInfo, error: string) => void;
2584
+ onProgress?: (file: FileInfo, progress: number) => void;
2585
+ onFileRemoved?: (file: FileInfo) => void;
2586
+ onChange?: (files: FileInfo[]) => void;
2587
+ apiRef?: default_2.Ref<NiceUploadHandle>;
2588
+ /** Enable paste from clipboard (Ctrl+V). */
2589
+ pasteFromClipboard?: boolean;
2755
2590
  }
2756
2591
 
2757
2592
  /**
@@ -2819,23 +2654,6 @@ declare interface PDFAnnotation {
2819
2654
  }>;
2820
2655
  }
2821
2656
 
2822
- /** Country phone prefix entry. */
2823
- declare interface PhoneCountryCode {
2824
- code: string;
2825
- dialCode: string;
2826
- name: string;
2827
- mask?: string;
2828
- }
2829
-
2830
- /** Parsed phone value. */
2831
- declare interface PhoneValue {
2832
- countryCode?: string;
2833
- dialCode?: string;
2834
- number?: string;
2835
- /** Full E.164 formatted number (e.g. "+48123456789"). */
2836
- e164?: string;
2837
- }
2838
-
2839
2657
  declare interface RectangleAnnotation extends AnnotationBase {
2840
2658
  tool: 'rectangle';
2841
2659
  }
@@ -2853,22 +2671,6 @@ declare interface ScanResult {
2853
2671
  scannedAt: Date;
2854
2672
  }
2855
2673
 
2856
- /** A tax rate entry. */
2857
- declare interface TaxRate {
2858
- /** Rate identifier. */
2859
- id: string;
2860
- /** Display label (e.g. "23%", "8%", "zw."). */
2861
- label: string;
2862
- /** Numeric rate as decimal (0.23 = 23%). */
2863
- rate: number;
2864
- /** Country code this rate applies to. */
2865
- countryCode?: string;
2866
- /** Category (e.g. "standard", "reduced", "zero", "exempt"). */
2867
- category?: string;
2868
- /** Whether this is the default rate. */
2869
- isDefault?: boolean;
2870
- }
2871
-
2872
2674
  declare interface TextAnnotation extends AnnotationBase {
2873
2675
  tool: 'text';
2874
2676
  text: string;
@@ -2892,9 +2694,9 @@ declare interface TracelessStorageProps {
2892
2694
  storageKey?: string;
2893
2695
  }
2894
2696
 
2895
- declare type UploadHandler = (request: UploadRequest) => Promise<UploadResponse>;
2697
+ export declare type UploadHandler = (request: UploadRequest) => Promise<UploadResponse>;
2896
2698
 
2897
- declare interface UploadRequest {
2699
+ export declare interface UploadRequest {
2898
2700
  file: File;
2899
2701
  chunk?: Blob;
2900
2702
  chunkIndex?: number;
@@ -2904,29 +2706,15 @@ declare interface UploadRequest {
2904
2706
  signal?: AbortSignal;
2905
2707
  }
2906
2708
 
2907
- declare interface UploadResponse {
2709
+ export declare interface UploadResponse {
2908
2710
  success: boolean;
2909
2711
  url?: string;
2910
2712
  error?: string;
2911
2713
  fileId?: string;
2912
- metadata?: Record<string, any>;
2714
+ metadata?: Record<string, unknown>;
2913
2715
  }
2914
2716
 
2915
- declare type UploadStatus = 'pending' | 'uploading' | 'success' | 'error' | 'cancelled';
2916
-
2917
- /** Country-specific VAT/NIP validation config. */
2918
- declare interface VatCountryConfig {
2919
- /** ISO 3166‑1 alpha-2 code. */
2920
- code: string;
2921
- /** Display name. */
2922
- label: string;
2923
- /** VAT prefix (e.g. "PL", "DE"). */
2924
- prefix: string;
2925
- /** Regex pattern for the numeric part (without prefix). */
2926
- pattern: RegExp;
2927
- /** Mask/placeholder hint. */
2928
- placeholder?: string;
2929
- }
2717
+ export declare type UploadStatus = 'pending' | 'uploading' | 'success' | 'error' | 'cancelled';
2930
2718
 
2931
2719
  /** A wiki page tree node. */
2932
2720
  declare interface WikiPage {