@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/index.d.ts CHANGED
@@ -51,6 +51,7 @@ import { createICUTranslator } from '@nice2dev/ui-core';
51
51
  import { createIndexedDBDataSource } from '@nice2dev/ui-core';
52
52
  import { createInfiniteScroll } from '@nice2dev/ui-core';
53
53
  import { createMockDataSource } from '@nice2dev/ui-core';
54
+ import { createNavigationActions } from '@nice2dev/ui-core';
54
55
  import { createNiceReduxMiddleware } from '@nice2dev/ui-core';
55
56
  import { createODataDataSource } from '@nice2dev/ui-core';
56
57
  import { createOfflineFirstDataSource } from '@nice2dev/ui-core';
@@ -88,6 +89,10 @@ import { FormFieldDef } from '@nice2dev/ui-core';
88
89
  import { FormPreferences } from '@nice2dev/ui-core';
89
90
  import { ForwardedRef } from 'react';
90
91
  import { ForwardRefExoticComponent } from 'react';
92
+ import { GamepadAction } from '@nice2dev/ui-core';
93
+ import { GamepadAxis } from '@nice2dev/ui-core';
94
+ import { GamepadButton as GamepadButton_2 } from '@nice2dev/ui-core';
95
+ import { GamepadState } from '@nice2dev/ui-core';
91
96
  import { generateBadgeStyles } from '@nice2dev/ui-core';
92
97
  import { generateButtonStyles } from '@nice2dev/ui-core';
93
98
  import { generateCardStyles } from '@nice2dev/ui-core';
@@ -216,6 +221,8 @@ import { NiceFieldValidationRule } from '@nice2dev/ui-core';
216
221
  import { NiceFilterCondition } from '@nice2dev/ui-core';
217
222
  import { NiceFilterGroup } from '@nice2dev/ui-core';
218
223
  import { NiceFilterOperator } from '@nice2dev/ui-core';
224
+ import { NiceFocusable } from '@nice2dev/ui-core';
225
+ import { NiceFocusableProps } from '@nice2dev/ui-core';
219
226
  import { NiceFormFieldProps } from '@nice2dev/ui-core';
220
227
  import { NiceGraphQLConfig } from '@nice2dev/ui-core';
221
228
  import { NiceHelpIcon } from '@nice2dev/ui-core';
@@ -282,6 +289,9 @@ import { NiceSkipLink } from '@nice2dev/ui-core';
282
289
  import { NiceSkipLinkProps } from '@nice2dev/ui-core';
283
290
  import { NiceSortDirection } from '@nice2dev/ui-core';
284
291
  import { NiceSortExpression } from '@nice2dev/ui-core';
292
+ import { NiceSpatialNavContextValue } from '@nice2dev/ui-core';
293
+ import { NiceSpatialNavProvider } from '@nice2dev/ui-core';
294
+ import { NiceSpatialNavProviderProps } from '@nice2dev/ui-core';
285
295
  import { NiceSqlWhere } from '@nice2dev/ui-core';
286
296
  import { NiceSSEConfig } from '@nice2dev/ui-core';
287
297
  import { NiceSSEDataSource } from '@nice2dev/ui-core';
@@ -391,6 +401,7 @@ import { ShadowVariant } from '@nice2dev/ui-core';
391
401
  import { simulateKeyboard } from '@nice2dev/ui-core';
392
402
  import { simulateType } from '@nice2dev/ui-core';
393
403
  import { sortModelToOrderBy } from '@nice2dev/ui-core';
404
+ import { SpatialFocusableMeta } from '@nice2dev/ui-core';
394
405
  import { startMark } from '@nice2dev/ui-core';
395
406
  import { StorageAdapter } from '@nice2dev/ui-core';
396
407
  import { StorageAuditResult } from '@nice2dev/ui-core';
@@ -549,6 +560,8 @@ import { useDisplayDensity } from '@nice2dev/ui-core';
549
560
  import { useFocusManagement } from '@nice2dev/ui-core';
550
561
  import { useFocusTrap } from '@nice2dev/ui-core';
551
562
  import { useFormGeneration } from '@nice2dev/ui-core';
563
+ import { useGamepad } from '@nice2dev/ui-core';
564
+ import { UseGamepadOptions } from '@nice2dev/ui-core';
552
565
  import { useGridPreferences } from '@nice2dev/ui-core';
553
566
  import { useHaptic } from '@nice2dev/ui-core';
554
567
  import { useInputMode } from '@nice2dev/ui-core';
@@ -610,6 +623,10 @@ import { useSafeTimeout } from '@nice2dev/ui-core';
610
623
  import { useSafeWebSocket } from '@nice2dev/ui-core';
611
624
  import { useShowAt } from '@nice2dev/ui-core';
612
625
  import { UseShowAtOptions } from '@nice2dev/ui-core';
626
+ import { useSpatialFocusable } from '@nice2dev/ui-core';
627
+ import { UseSpatialFocusableOptions } from '@nice2dev/ui-core';
628
+ import { useSpatialNav } from '@nice2dev/ui-core';
629
+ import { useSpatialNavOptional } from '@nice2dev/ui-core';
613
630
  import { useSubmitOnEnter } from '@nice2dev/ui-core';
614
631
  import { UseSubmitOnEnterOptions } from '@nice2dev/ui-core';
615
632
  import { useSwipe } from '@nice2dev/ui-core';
@@ -3086,6 +3103,8 @@ export { createMockDataSource }
3086
3103
 
3087
3104
  export declare function createMockLiveChartSource(config: MockLiveChartSourceConfig): LiveChartDataSource;
3088
3105
 
3106
+ export { createNavigationActions }
3107
+
3089
3108
  export { createNiceReduxMiddleware }
3090
3109
 
3091
3110
  export { createODataDataSource }
@@ -3172,14 +3191,6 @@ declare interface CSATSurvey {
3172
3191
 
3173
3192
  export declare function cssToGradient(css: string): NiceGradientValue | null;
3174
3193
 
3175
- /** Currency definition. */
3176
- export declare interface CurrencyDef {
3177
- code: string;
3178
- symbol: string;
3179
- name: string;
3180
- decimals?: number;
3181
- }
3182
-
3183
3194
  /** Current schema version. */
3184
3195
  export declare const CURRENT_SCHEMA_VERSION = 2;
3185
3196
 
@@ -4992,6 +5003,7 @@ export declare interface FigmaTokens {
4992
5003
  shadows: Record<string, string>;
4993
5004
  }
4994
5005
 
5006
+ /** Per-file record tracked by {@link NiceUpload}. */
4995
5007
  export declare interface FileInfo {
4996
5008
  id: string;
4997
5009
  file: File;
@@ -4999,15 +5011,18 @@ export declare interface FileInfo {
4999
5011
  size: number;
5000
5012
  type: string;
5001
5013
  status: UploadStatus;
5014
+ /** 0–100. */
5002
5015
  progress: number;
5003
5016
  error?: string;
5017
+ /** Object URL for image/video/audio previews. */
5004
5018
  previewUrl?: string;
5019
+ /** Server-returned URL after a successful upload. */
5005
5020
  uploadedUrl?: string;
5006
5021
  uploadedAt?: Date;
5007
5022
  chunks?: ChunkInfo[];
5008
5023
  }
5009
5024
 
5010
- declare interface FileItemActions {
5025
+ export declare interface FileItemActions {
5011
5026
  upload: () => void;
5012
5027
  cancel: () => void;
5013
5028
  retry: () => void;
@@ -5220,6 +5235,14 @@ export declare interface FuzzyMatch {
5220
5235
 
5221
5236
  export declare function fuzzyMatch(query: string, text: string): FuzzyMatch | null;
5222
5237
 
5238
+ export { GamepadAction }
5239
+
5240
+ export { GamepadAxis }
5241
+
5242
+ export { GamepadButton_2 as GamepadButton }
5243
+
5244
+ export { GamepadState }
5245
+
5223
5246
  /**
5224
5247
  * Gap analysis item.
5225
5248
  */
@@ -5830,9 +5853,10 @@ declare interface InboxComposeData {
5830
5853
  }
5831
5854
 
5832
5855
  /** A folder/label in the inbox. */
5833
- declare interface InboxFolder {
5856
+ export declare interface InboxFolder {
5834
5857
  id: string;
5835
5858
  name: string;
5859
+ /** NiceIcon name (from the built-in @nice2dev/ui-core icon set), e.g. `'mail'`, `'star'`, `'trash'`. */
5836
5860
  icon?: string;
5837
5861
  count?: number;
5838
5862
  }
@@ -7318,6 +7342,14 @@ export declare interface NiceActionSheetProps extends NiceBaseProps {
7318
7342
  showCancelButton?: boolean;
7319
7343
  /** Cancel button text. */
7320
7344
  cancelText?: string;
7345
+ /** Sheet size (xs..xl) — scales the max-width + item font. */
7346
+ size?: NiceSize;
7347
+ /** Disabled: dims the sheet + blocks every action. */
7348
+ disabled?: boolean;
7349
+ /** Loading: a spinner overlay + aria-busy; actions blocked. */
7350
+ loading?: boolean;
7351
+ /** Error message shown at the top of the sheet. */
7352
+ error?: string;
7321
7353
  }
7322
7354
 
7323
7355
  /**
@@ -7650,6 +7682,52 @@ export declare interface NiceAppManifest {
7650
7682
  tenantId?: string;
7651
7683
  }
7652
7684
 
7685
+ /**
7686
+ * {@link NiceAppShell} — reusable app chrome for richer, IDE/DAW-style tools:
7687
+ * a menubar, a tools toolbar, an optional sidebar, the content area and a status
7688
+ * bar. Built to be composed with `NiceMenu` and the content of
7689
+ * your choice (e.g. `NiceAudioStudio` builds on it).
7690
+ */
7691
+ export declare const NiceAppShell: default_2.ForwardRefExoticComponent<NiceAppShellProps & default_2.RefAttributes<HTMLDivElement>>;
7692
+
7693
+ /**
7694
+ * Props for {@link NiceAppShell} — a generic desktop-application frame
7695
+ * (menubar → toolbar → [sidebar | content] → status bar). Each region is an
7696
+ * optional slot; compose the menubar from a horizontal `NiceMenu` and the
7697
+ * toolbar from your own controls (buttons, a `NiceMenu`, etc.). Theme-tokened
7698
+ * and responsive.
7699
+ */
7700
+ export declare interface NiceAppShellProps extends NiceBaseProps {
7701
+ /** Top menubar row — typically a horizontal `NiceMenu` (File / Edit / View / Help). */
7702
+ menubar?: default_2.ReactNode;
7703
+ /** Tools toolbar row, below the menubar — typically buttons or a `NiceMenu`. */
7704
+ toolbar?: default_2.ReactNode;
7705
+ /** Optional left sidebar (panels, track list, tool palette / tool rail). */
7706
+ sidebar?: default_2.ReactNode;
7707
+ /** Sidebar width in px. Default 220. */
7708
+ sidebarWidth?: number;
7709
+ /** Optional right panel (properties / inspector). */
7710
+ rightSidebar?: default_2.ReactNode;
7711
+ /** Right-panel width in px. Default 280. */
7712
+ rightSidebarWidth?: number;
7713
+ /** Main content area. */
7714
+ children?: default_2.ReactNode;
7715
+ /** Optional bottom panel between the content and the status bar (timeline, console, output). */
7716
+ bottomPanel?: default_2.ReactNode;
7717
+ /** Bottom-panel height in px. When omitted, the panel's own content drives its height. */
7718
+ bottomPanelHeight?: number;
7719
+ /** Bottom status bar. */
7720
+ statusBar?: default_2.ReactNode;
7721
+ /** Overall height (px or CSS value). Default `'100%'`. */
7722
+ height?: number | string;
7723
+ /**
7724
+ * Render the side panels "flush" — no shell padding/background/border and no
7725
+ * forced width, so a self-styled panel (e.g. an editor tool-rail / inspector)
7726
+ * controls its own look and size. Default false.
7727
+ */
7728
+ flush?: boolean;
7729
+ }
7730
+
7653
7731
  export { NiceAriaProps }
7654
7732
 
7655
7733
  export { NiceArrayDataSourceConfig }
@@ -7972,6 +8050,14 @@ export declare interface NiceAutocompleteProps extends NiceFormFieldProps {
7972
8050
  highlightMatch?: boolean;
7973
8051
  /** Alias for options — array of string suggestions. */
7974
8052
  suggestions?: (string | NiceOption)[];
8053
+ /**
8054
+ * When `true` (default), focusing the field (before typing) opens the dropdown
8055
+ * with **all** options sorted alphabetically. Set `false` to only show
8056
+ * suggestions once the user has typed `minSearchLength` characters.
8057
+ */
8058
+ showAll?: boolean;
8059
+ /** Gap (px) between the input and the suggestion menu. Default 0 (menu abuts the input). */
8060
+ menuGap?: number;
7975
8061
  }
7976
8062
 
7977
8063
  export declare const NiceAutomationRuleEditor: default_2.FC<NiceAutomationRuleEditorProps>;
@@ -7989,13 +8075,30 @@ export declare const NiceAvatar: default_2.FC<NiceAvatarProps>;
7989
8075
 
7990
8076
  export declare const NiceAvatarGroup: default_2.FC<NiceAvatarGroupProps>;
7991
8077
 
7992
- /** Props for the {@link NiceAvatarGroup} component — stacks multiple {@link NiceAvatar} elements with a "+N" overflow indicator. */
8078
+ /** A single data-driven avatar in a {@link NiceAvatarGroup}. */
8079
+ declare interface NiceAvatarGroupItem {
8080
+ /** Image URL. When omitted, initials from `name` are shown. */
8081
+ src?: string;
8082
+ /** Display name (used for initials, alt text and the title tooltip). */
8083
+ name?: string;
8084
+ /** Makes the avatar a link to this URL. */
8085
+ href?: string;
8086
+ /** Click handler (makes the avatar a button when there is no `href`). */
8087
+ onClick?: () => void;
8088
+ }
8089
+
8090
+ /** Props for the {@link NiceAvatarGroup} component — stacks multiple avatars with a "+N" overflow indicator. */
7993
8091
  export declare interface NiceAvatarGroupProps extends NiceStandardProps {
7994
- /** Avatar group size. */
8092
+ /** Avatar group size — propagated to every avatar (and the +N chip). */
7995
8093
  size?: NiceSize;
7996
- /** NiceAvatar elements to display. */
7997
- children: default_2.ReactNode;
7998
- /** Maximum visible avatars before the overflow counter appears. */
8094
+ /** NiceAvatar elements to display (alternative to `items`). */
8095
+ children?: default_2.ReactNode;
8096
+ /**
8097
+ * Data-driven avatars (alternative to `children`). Each entry can be made
8098
+ * clickable via `href` (link) or `onClick` (button).
8099
+ */
8100
+ items?: NiceAvatarGroupItem[];
8101
+ /** Maximum visible avatars before the "+N" overflow counter appears. */
7999
8102
  max?: number;
8000
8103
  }
8001
8104
 
@@ -8181,19 +8284,31 @@ export declare interface NiceBadgeProps extends NiceStandardProps {
8181
8284
  dot?: boolean;
8182
8285
  /** Render with an outlined border instead of a filled background. */
8183
8286
  outline?: boolean;
8287
+ /** Soft tinted background with accent-coloured text (instead of a solid fill). */
8288
+ subtle?: boolean;
8289
+ /** Gently pulse to draw attention (e.g. live status). Respects prefers-reduced-motion. */
8290
+ pulse?: boolean;
8291
+ /** Optional icon rendered before the content. */
8292
+ icon?: default_2.ReactNode;
8184
8293
  /** Show a remove ("x") button inside the badge. */
8185
8294
  removable?: boolean;
8186
8295
  /** Called when the remove button is clicked. */
8187
8296
  onRemove?: () => void;
8188
8297
  }
8189
8298
 
8299
+ export declare const NiceBarcode: ForwardRefExoticComponent<NiceBarcodeProps & RefAttributes<HTMLCanvasElement>>;
8300
+
8190
8301
  /** Supported barcode symbologies. */
8191
8302
  export declare type NiceBarcodeFormat = 'CODE128' | 'CODE39' | 'EAN13' | 'EAN8' | 'UPC' | 'ITF14' | 'MSI' | 'codabar';
8192
8303
 
8193
- export declare const NiceBarcodeGenerator: ForwardRefExoticComponent<NiceBarcodeGeneratorProps & RefAttributes<HTMLCanvasElement>>;
8304
+ /** @deprecated Renamed to {@link NiceBarcode}. Kept as an alias for backward compatibility. */
8305
+ export declare const NiceBarcodeGenerator: ForwardRefExoticComponent<NiceBarcodeProps & RefAttributes<HTMLCanvasElement>>;
8306
+
8307
+ /** @deprecated Renamed to {@link NiceBarcodeProps}. */
8308
+ export declare type NiceBarcodeGeneratorProps = NiceBarcodeProps;
8194
8309
 
8195
- /** Props for the {@link NiceBarcodeGenerator} component — renders a barcode on a `<canvas>`. */
8196
- export declare interface NiceBarcodeGeneratorProps extends NiceStandardProps {
8310
+ /** Props for the {@link NiceBarcode} component — renders a barcode on a `<canvas>`. */
8311
+ export declare interface NiceBarcodeProps extends NiceStandardProps {
8197
8312
  /** Text value to encode. */
8198
8313
  value: string;
8199
8314
  /** Barcode symbology (default CODE128). */
@@ -8214,6 +8329,32 @@ export declare interface NiceBarcodeGeneratorProps extends NiceStandardProps {
8214
8329
  fontSize?: number;
8215
8330
  /** Component size preset. */
8216
8331
  size?: NiceSize;
8332
+ /**
8333
+ * Render an editable {@link NiceTextInput} above the barcode that live-encodes
8334
+ * what the user types. Off by default — pass `showInput` to enable. The barcode
8335
+ * itself always renders; this only toggles the editor field above it.
8336
+ */
8337
+ showInput?: boolean;
8338
+ /**
8339
+ * Alias for {@link showInput}. When `editable` is provided it takes precedence:
8340
+ * `editable={false}` hides the input (barcode still renders), `editable` shows it.
8341
+ */
8342
+ editable?: boolean;
8343
+ /** Label for the built-in input (only when the input is shown). */
8344
+ inputLabel?: string;
8345
+ /** Placeholder for the built-in input (only when the input is shown). */
8346
+ inputPlaceholder?: string;
8347
+ /** Where to place the built-in input's label (forwarded to {@link NiceTextInput}). */
8348
+ labelPlacement?: NiceTextInputProps['labelPlacement'];
8349
+ /**
8350
+ * Extra props forwarded to the built-in {@link NiceTextInput}, so the top editor
8351
+ * is a fully-featured NiceTextInput (variant, prefix/suffix, clearable, helperText,
8352
+ * error, disabled, readOnly, …). Explicit props (`inputLabel`, `inputPlaceholder`,
8353
+ * `labelPlacement`, `size`) win over the same keys here.
8354
+ */
8355
+ inputProps?: Partial<NiceTextInputProps>;
8356
+ /** Fires with the new value whenever the user edits the built-in input. */
8357
+ onValueChange?: (value: string) => void;
8217
8358
  }
8218
8359
 
8219
8360
  export declare const NiceBarGauge: default_2.FC<NiceBarGaugeProps>;
@@ -8287,38 +8428,14 @@ export declare interface NiceBlockUIProps extends NiceBaseProps {
8287
8428
  blocked: boolean;
8288
8429
  /** Custom overlay message or spinner. */
8289
8430
  message?: default_2.ReactNode;
8431
+ /** Show a built-in loading spinner above the message. */
8432
+ spinner?: boolean;
8433
+ /** Blur the blocked content beneath the overlay. */
8434
+ blur?: boolean;
8290
8435
  /** Content to be blocked. */
8291
8436
  children: default_2.ReactNode;
8292
8437
  }
8293
8438
 
8294
- export declare const NiceBottomNavigation: default_2.ForwardRefExoticComponent<NiceBottomNavigationProps & default_2.RefAttributes<HTMLDivElement>>;
8295
-
8296
- /** A navigation item in the {@link NiceBottomNavigation} bar. */
8297
- export declare interface NiceBottomNavigationItem {
8298
- /** Unique key. */
8299
- key: string;
8300
- /** Label text. */
8301
- label: string;
8302
- /** Icon element. */
8303
- icon?: default_2.ReactNode;
8304
- /** Disable the item. */
8305
- disabled?: boolean;
8306
- }
8307
-
8308
- /** Props for the {@link NiceBottomNavigation} component — a mobile-style bottom tab bar. */
8309
- export declare interface NiceBottomNavigationProps extends NiceBaseProps {
8310
- /** Navigation items. */
8311
- items: NiceBottomNavigationItem[];
8312
- /** Currently active item key. */
8313
- activeKey?: string;
8314
- /** Called when the active item changes. */
8315
- onChange?: (key: string) => void;
8316
- /** Bar size preset. */
8317
- size?: NiceSize;
8318
- /** Show text labels below icons. */
8319
- showLabels?: boolean;
8320
- }
8321
-
8322
8439
  export declare const NiceBox: default_2.FC<NiceBoxProps>;
8323
8440
 
8324
8441
  /** Props for the {@link NiceBox} component — a flex-based layout container. */
@@ -8470,8 +8587,15 @@ declare type NiceBulletState = 'normal' | 'loading' | 'error';
8470
8587
  */
8471
8588
  export declare const NiceBusinessCard: default_2.ForwardRefExoticComponent<NiceBusinessCardProps & default_2.RefAttributes<HTMLDivElement>>;
8472
8589
 
8473
- /** Props for the {@link NiceBusinessCard} component. */
8474
- export declare interface NiceBusinessCardProps extends NiceFormFieldProps {
8590
+ /**
8591
+ * Props for the {@link NiceBusinessCard} component.
8592
+ *
8593
+ * NiceBusinessCard is a display component, not a form input — it deliberately
8594
+ * does NOT extend `NiceFormFieldProps` so the showcase catalog does not surface
8595
+ * input-only STATE toggles (disabled/readOnly/loading/error) for it. The few
8596
+ * state-ish props below exist only for the optional inline-edit mode.
8597
+ */
8598
+ export declare interface NiceBusinessCardProps {
8475
8599
  /** Business entity data. */
8476
8600
  data: BusinessCardData;
8477
8601
  /** Whether to render in edit mode. */
@@ -8488,6 +8612,22 @@ export declare interface NiceBusinessCardProps extends NiceFormFieldProps {
8488
8612
  showLogo?: boolean;
8489
8613
  /** Whether to show bank details. */
8490
8614
  showBankDetails?: boolean;
8615
+ /** Card size (scales fonts and spacing). */
8616
+ size?: NiceSize;
8617
+ /** Optional caption rendered by a consuming form layout. */
8618
+ label?: default_2.ReactNode;
8619
+ /** Helper text rendered under the card. */
8620
+ helperText?: default_2.ReactNode;
8621
+ /** Error message rendered under the card. */
8622
+ error?: string | boolean;
8623
+ /** Dim the card and disable inputs while in edit mode. */
8624
+ disabled?: boolean;
8625
+ /** Read-only — hides the edit toggle. */
8626
+ readOnly?: boolean;
8627
+ className?: string;
8628
+ style?: default_2.CSSProperties;
8629
+ accessMode?: NiceAccessMode;
8630
+ id?: string;
8491
8631
  }
8492
8632
 
8493
8633
  export declare const NiceButton: default_2.ForwardRefExoticComponent<NiceButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
@@ -8498,9 +8638,9 @@ export declare const NiceButtonGroup: default_2.FC<NiceButtonGroupProps>;
8498
8638
  * Props for the {@link NiceButtonGroup} component — visually groups
8499
8639
  * adjacent buttons into one connected cluster.
8500
8640
  *
8501
- * Children may be {@link NiceButton} (text, icon-only via `leftIcon` with
8502
- * empty children, or icon + text via `leftIcon` / `rightIcon`) or
8503
- * {@link NiceIconButton}. Use this for clusters of **independent action
8641
+ * Children are {@link NiceButton} elements (text, icon-only via `leftIcon`
8642
+ * with empty children, or icon + text via `leftIcon` / `rightIcon`). Use
8643
+ * this for clusters of **independent action
8504
8644
  * buttons**. For an exclusive single-select toggle pattern (with an
8505
8645
  * animated highlight) use {@link NiceSegmentedControl} instead.
8506
8646
  */
@@ -8549,6 +8689,8 @@ export declare interface NiceButtonProps extends NiceBaseProps {
8549
8689
  error?: default_2.ReactNode;
8550
8690
  /** Where to display the error: 'bottom' (default) or 'right'. */
8551
8691
  errorPlacement?: 'bottom' | 'right';
8692
+ /** Accessible label — applied as `aria-label` (use for icon-only buttons). */
8693
+ ariaLabel?: string;
8552
8694
  }
8553
8695
 
8554
8696
  export { NiceCacheConfig }
@@ -8643,6 +8785,77 @@ export declare interface NiceCardGridProps extends NiceStandardProps {
8643
8785
  hoverable?: boolean;
8644
8786
  }
8645
8787
 
8788
+ /**
8789
+ * {@link NiceCardGroup} — themed, responsive CSS-grid layout for a set of cards.
8790
+ * With `value`/`onChange` it also acts as a single-select card radio group, and
8791
+ * with `items`/`renderCard` it renders a searchable data grid of cards.
8792
+ */
8793
+ export declare const NiceCardGroup: default_2.ForwardRefExoticComponent<NiceCardGroupProps & default_2.RefAttributes<HTMLDivElement>>;
8794
+
8795
+ /** An item rendered by {@link NiceCardGroup} in data mode (consolidated from the former NiceCardView). */
8796
+ export declare interface NiceCardGroupItem {
8797
+ /** Unique key. */
8798
+ key: string;
8799
+ /** Additional data fields. */
8800
+ [field: string]: unknown;
8801
+ }
8802
+
8803
+ /**
8804
+ * Props for {@link NiceCardGroup} — a responsive grid container for cards (or any
8805
+ * tiles). By default it auto-fills as many `minColumnWidth`-wide columns as fit
8806
+ * and wraps responsively; pass `columns` to pin an exact column count. Pass
8807
+ * `value`/`onChange` to make it a single-select **card radio group**: child
8808
+ * {@link NiceCard}s that carry a `value` become selectable and report selection.
8809
+ *
8810
+ * Provide `items` + `renderCard` to use **data mode** (the former NiceCardView):
8811
+ * the group renders each item through `renderCard`, with optional search and an
8812
+ * empty state.
8813
+ */
8814
+ export declare interface NiceCardGroupProps extends NiceStandardProps {
8815
+ /** Cards / tiles to lay out (display / radio mode). */
8816
+ children?: default_2.ReactNode;
8817
+ /** Data items to render through `renderCard` (data mode). */
8818
+ items?: NiceCardGroupItem[];
8819
+ /** Custom card renderer for `items` (data mode). */
8820
+ renderCard?: (item: NiceCardGroupItem) => default_2.ReactNode;
8821
+ /** Show a search box above the grid (data mode). */
8822
+ searchable?: boolean;
8823
+ /** Item field searched when `searchable` is enabled (data mode). Default `text`. */
8824
+ searchField?: string;
8825
+ /** Search input placeholder (data mode). */
8826
+ searchPlaceholder?: string;
8827
+ /** Text shown when `items` is empty (data mode). */
8828
+ emptyText?: string;
8829
+ /** Called when a data-mode card is clicked. */
8830
+ onCardClick?: (item: NiceCardGroupItem) => void;
8831
+ /** Group size — scales the default gap (xs..xl) when `gap` is not set. */
8832
+ size?: NiceSize;
8833
+ /** Minimum column width (px) for the auto-fill grid. Default 240. */
8834
+ minColumnWidth?: number;
8835
+ /** Fixed column count — overrides `minColumnWidth` auto-fill when set. */
8836
+ columns?: number;
8837
+ /** Gap between cards (px). Defaults to a size-based value. */
8838
+ gap?: number;
8839
+ /** Vertical alignment of items within a row. */
8840
+ align?: 'stretch' | 'start' | 'center' | 'end';
8841
+ /** Selected value — enables single-select (radio) behaviour across child cards. */
8842
+ value?: NiceCardValue;
8843
+ /** Fired with the newly-selected card `value`. */
8844
+ onChange?: (value: NiceCardValue) => void;
8845
+ /** Radio group name applied to child cards (a11y). */
8846
+ name?: string;
8847
+ /** Disabled: dims the whole group + blocks selection. */
8848
+ disabled?: boolean;
8849
+ /** Read-only: blocks selection (radio mode) without dimming. */
8850
+ readOnly?: boolean;
8851
+ /** Loading: a spinner overlay + aria-busy. */
8852
+ loading?: boolean;
8853
+ /** Error state. A string is shown as the message; `true` shows `errorText`. */
8854
+ error?: string | boolean;
8855
+ /** Error message shown when `error` is boolean `true` (a string `error` wins). */
8856
+ errorText?: string;
8857
+ }
8858
+
8646
8859
  /** Props for the {@link NiceCard} component — a bordered content container with optional header and footer. */
8647
8860
  export declare interface NiceCardProps extends NiceBaseProps {
8648
8861
  /** Card size. */
@@ -8664,75 +8877,30 @@ export declare interface NiceCardProps extends NiceBaseProps {
8664
8877
  /**
8665
8878
  * Make the card behave as a selectable option (radio): cursor/hover affordance,
8666
8879
  * `role="radio"` + `aria-checked`, keyboard select (Space/Enter). Inside a
8667
- * {@link NiceCardRadioGroup} this is implied for cards that carry a `value`.
8880
+ * {@link NiceCardGroup} this is implied for cards that carry a `value`.
8668
8881
  */
8669
8882
  selectable?: boolean;
8670
- /** Whether the card is currently selected (controlled; auto-wired inside a NiceCardRadioGroup). */
8883
+ /** Whether the card is currently selected (controlled; auto-wired inside a NiceCardGroup). */
8671
8884
  selected?: boolean;
8672
8885
  /** The option value bound to this card (used for selection + the group's onChange). */
8673
8886
  value?: NiceCardValue;
8674
8887
  /** Fired with `value` when the card is selected. */
8675
8888
  onSelect?: (value: NiceCardValue) => void;
8676
- /** Radio group name (auto-wired inside a NiceCardRadioGroup). */
8677
- name?: string;
8678
- }
8679
-
8680
- /**
8681
- * {@link NiceCardRadioGroup} — wraps NiceCards into a single-select radio group:
8682
- * child cards that carry a `value` become selectable and report selection via
8683
- * `onChange` (the "binding + event on select"). Adds `role="radiogroup"`.
8684
- */
8685
- export declare const NiceCardRadioGroup: default_2.FC<NiceCardRadioGroupProps>;
8686
-
8687
- /** Props for {@link NiceCardRadioGroup} — coordinates single-selection across child NiceCards. */
8688
- export declare interface NiceCardRadioGroupProps extends NiceBaseProps {
8689
- /** Selected value (controlled). */
8690
- value?: NiceCardValue;
8691
- /** Fired with the newly-selected value. */
8692
- onChange?: (value: NiceCardValue) => void;
8693
- /** Radio group name applied to child cards. */
8889
+ /** Radio group name (auto-wired inside a NiceCardGroup). */
8694
8890
  name?: string;
8695
- /** Child NiceCards (each with a `value`). */
8696
- children: default_2.ReactNode;
8891
+ /** Disabled: dimmed + non-interactive (blocks click/select). */
8892
+ disabled?: boolean;
8893
+ /** Read-only: inert (blocks selection) without the dimmed look. */
8894
+ readOnly?: boolean;
8895
+ /** Loading: a spinner overlay + `aria-busy`; interaction is blocked. */
8896
+ loading?: boolean;
8897
+ /** Error state — adds an error border; a non-empty string also renders a message. */
8898
+ error?: string | boolean;
8697
8899
  }
8698
8900
 
8699
8901
  /** Value type used by selectable cards / card radio groups. */
8700
8902
  export declare type NiceCardValue = string | number;
8701
8903
 
8702
- export declare function NiceCardView<T extends NiceCardViewItem>({ items, renderCard, columns, gap, searchable, searchField, searchPlaceholder, loading, emptyText, onCardClick, className, style, accessMode, id, }: NiceCardViewProps<T>): default_2.JSX.Element | null;
8703
-
8704
- /** An item displayed by the {@link NiceCardView} component. */
8705
- declare interface NiceCardViewItem {
8706
- /** Unique key. */
8707
- key: string;
8708
- /** Additional data fields. */
8709
- [field: string]: any;
8710
- }
8711
-
8712
- /** Props for the {@link NiceCardView} component — a responsive card grid with search and custom card rendering. */
8713
- export declare interface NiceCardViewProps<T extends NiceCardViewItem = NiceCardViewItem> extends NiceBaseProps {
8714
- /** Data items. */
8715
- items: T[];
8716
- /** Custom card renderer. */
8717
- renderCard: (item: T) => default_2.ReactNode;
8718
- /** Number of grid columns. */
8719
- columns?: number;
8720
- /** Gap between cards (px or CSS value). */
8721
- gap?: number | string;
8722
- /** Show a search box. */
8723
- searchable?: boolean;
8724
- /** Field searched when searchable is enabled. */
8725
- searchField?: string;
8726
- /** Search input placeholder. */
8727
- searchPlaceholder?: string;
8728
- /** Show a loading skeleton. */
8729
- loading?: boolean;
8730
- /** Text shown when items is empty. */
8731
- emptyText?: string;
8732
- /** Called when a card is clicked. */
8733
- onCardClick?: (item: T) => void;
8734
- }
8735
-
8736
8904
  export declare const NiceCarousel: default_2.ForwardRefExoticComponent<NiceCarouselProps & default_2.RefAttributes<HTMLDivElement>>;
8737
8905
 
8738
8906
  /** Props for the {@link NiceCarousel} component — a swipeable slide show with arrows, dots, and auto-play. */
@@ -8755,6 +8923,8 @@ export declare interface NiceCarouselProps extends NiceStandardProps {
8755
8923
  onChange?: (index: number) => void;
8756
8924
  /** Carousel size preset. */
8757
8925
  size?: NiceSize;
8926
+ /** Stretch to fill the container width (default: true). When false the carousel shrinks to its content. */
8927
+ fullWidth?: boolean;
8758
8928
  }
8759
8929
 
8760
8930
  /** Hierarchical option in a {@link NiceCascadeSelect} tree. */
@@ -9076,8 +9246,6 @@ export declare interface NiceCircularGaugeProps extends NiceStandardProps {
9076
9246
  }[];
9077
9247
  }
9078
9248
 
9079
- export declare const NiceClassicShell: ForwardRefExoticComponent<NiceShellProps & RefAttributes<HTMLDivElement>>;
9080
-
9081
9249
  /**
9082
9250
  * Component form of the `useClickOutside` hook — useful when you
9083
9251
  * already have a JSX tree and don't want to thread a ref through it.
@@ -9587,8 +9755,16 @@ export declare interface NiceColorPaletteProps extends NiceBaseProps {
9587
9755
  variationCount?: number;
9588
9756
  /** Label */
9589
9757
  label?: string;
9758
+ /** Label position relative to the swatch strip. Default `'top'`. */
9759
+ labelPlacement?: 'top' | 'left';
9590
9760
  /** Disabled state */
9591
9761
  disabled?: boolean;
9762
+ /** Looks enabled but the studio won't open and edits are blocked. */
9763
+ readOnly?: boolean;
9764
+ /** Show a loading spinner and dim the control. */
9765
+ loading?: boolean;
9766
+ /** Error ring; a string value also renders the message. */
9767
+ error?: string | boolean;
9592
9768
  /**
9593
9769
  * Target number of colors in the generated palette. Overrides the natural
9594
9770
  * count of the active harmony mode (clamped between `minColors` and
@@ -9625,6 +9801,10 @@ export declare interface NiceColorPickerProps extends NiceFormFieldProps {
9625
9801
  /** When true, the popup includes an alpha (transparency) slider and the
9626
9802
  * emitted value uses 8-character hex `#RRGGBBAA`. Default: `false`. */
9627
9803
  withAlpha?: boolean;
9804
+ /** Compact inline layout: swatch + hex on a single tight row and the
9805
+ * "Random" button hidden, so many fields can sit side-by-side in a grid.
9806
+ * Default: `false`. */
9807
+ compact?: boolean;
9628
9808
  }
9629
9809
 
9630
9810
  export declare type NiceColorPreset = 'lightest-pastel' | 'bright-pastel' | 'shiny' | 'pastel' | 'full' | 'dark' | 'deep' | 'muted' | 'earth';
@@ -9806,17 +9986,6 @@ export declare interface NiceCommandPaletteProviderProps extends NiceCommandPale
9806
9986
  commands?: NiceCommand[];
9807
9987
  }
9808
9988
 
9809
- export declare const NiceCompactShell: ForwardRefExoticComponent<NiceCompactShellProps & RefAttributes<HTMLDivElement>>;
9810
-
9811
- export declare interface NiceCompactShellProps extends NiceBaseProps {
9812
- /** Top bar (minimal, icon-only navigation). */
9813
- topBar?: React.ReactNode;
9814
- /** Bottom navigation (mobile-style). */
9815
- bottomNav?: React.ReactNode;
9816
- /** Main content. */
9817
- children?: React.ReactNode;
9818
- }
9819
-
9820
9989
  /**
9821
9990
  * NiceComplianceDashboard — Compliance and certification dashboard.
9822
9991
  *
@@ -10436,19 +10605,6 @@ export declare const NiceCountdown: default_2.FC<NiceCountdownProps>;
10436
10605
 
10437
10606
  export declare type NiceCountdownFormat = 'full' | 'compact' | 'minimal';
10438
10607
 
10439
- /** Built-in countdown format presets. */
10440
- declare type NiceCountdownFormat_2 =
10441
- /** `1d 02:34:15` / `02:34:15` — leading day count + clock */
10442
- 'verbose'
10443
- /** `1d 2h 34m 15s` — abbreviated units */
10444
- | 'compact'
10445
- /** `2:34:15` / `34:15` — pure clock */
10446
- | 'short'
10447
- /** `in 2h` / `in 5m` / `in 30s` — single coarsest unit */
10448
- | 'minimal'
10449
- /** `1 day, 2 hours, 34 minutes` — verbose words */
10450
- | 'words';
10451
-
10452
10608
  /** Optional label overrides for the four time units. */
10453
10609
  export declare interface NiceCountdownLabels {
10454
10610
  days?: string;
@@ -10653,39 +10809,6 @@ declare interface NiceCSVOptions extends NiceExportOptions {
10653
10809
  encoding?: 'utf-8' | 'utf-16' | 'iso-8859-1';
10654
10810
  }
10655
10811
 
10656
- /**
10657
- * {@link NiceCurrencyInput} — Amount input with currency selector, locale-aware formatting.
10658
- */
10659
- export declare const NiceCurrencyInput: default_2.ForwardRefExoticComponent<NiceCurrencyInputProps & default_2.RefAttributes<HTMLDivElement>>;
10660
-
10661
- /** Props for the {@link NiceCurrencyInput} component. */
10662
- export declare interface NiceCurrencyInputProps extends NiceFormFieldProps {
10663
- /** Controlled numeric amount (minor unit or major, based on `useMinorUnit`). */
10664
- value?: number | null;
10665
- /** Fires on amount change. */
10666
- onChange?: (value: number | null) => void;
10667
- /** Selected currency code (ISO 4217). */
10668
- currency?: string;
10669
- /** Fires when user changes currency. */
10670
- onCurrencyChange?: (code: string) => void;
10671
- /** Available currencies. */
10672
- currencies?: CurrencyDef[];
10673
- /** Whether to store value in minor units (cents). Default `false`. */
10674
- useMinorUnit?: boolean;
10675
- /** Minimum value. */
10676
- min?: number;
10677
- /** Maximum value. */
10678
- max?: number;
10679
- /** Override locale for formatting (e.g. "pl-PL"). */
10680
- locale?: string;
10681
- /** Placeholder text. */
10682
- placeholder?: string;
10683
- /** Whether to show currency selector (default `true` if currencies provided). */
10684
- showCurrencySelector?: boolean;
10685
- /** Fires on blur with the input event. */
10686
- onBlur?: (e: default_2.FocusEvent<HTMLInputElement>) => void;
10687
- }
10688
-
10689
10812
  export { NiceCursorLoadOptions }
10690
10813
 
10691
10814
  export { NiceCursorPage }
@@ -10833,7 +10956,7 @@ export declare interface NiceDataDiffViewerProps extends NiceBaseProps {
10833
10956
  onSelectRecord?: (table: string, recordId: string) => void;
10834
10957
  }
10835
10958
 
10836
- export declare function NiceDataGrid<T extends Record<string, any>>({ columns, data: dataProp, keyField, dataSource, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, showAdvancedFilter, advancedFilter, onAdvancedFilterChange, filterFields, filterPresets, onSaveFilterPreset, onDeleteFilterPreset, selectable, selectedKeys: controlledSelected, onSelectionChange, pagination, pageSize: initPageSize, page: controlledPage, onPageChange, totalRows, autoPagination, stickyHeader, stickyFooter, searchable, searchPlaceholder, virtualScroll, rowHeight, groupBy, groupRender, onCellEdit, editMode, formItems, formColumns, editFormTitle, formProps, onRowEdit, onRowAdd, onRowDelete: _onRowDelete, bulkActions, onBulkDelete, exportCsv, exportFilename, detailRow, expandedRowKeys: controlledExpandedRows, onExpandedRowChange, columnReorder: _columnReorder, onColumnReorder: _onColumnReorder, columnResize, rowDraggable, onRowReorder, striped, compact, loading: loadingProp, emptyText, toolbar, onRowClick, pinnedTopKeys, pinnedBottomKeys, colSpan: colSpanFn, showStatusBar, contextMenuItems, onContextMenuAction, printFriendly, keyboardNavigation, focusedCell: controlledFocusedCell, onFocusedCellChange, cellRangeSelection, selectedCellRange: controlledCellRange, onCellRangeChange, clipboard, clipboardFormat, onBeforeCopy, onCopy, onPaste, quickFilters, activeQuickFilters: controlledQuickFilters, onQuickFilterChange, columnGroups: _columnGroups, stateStorageKey, initialState, onStateChange, flashRowKeys, flashDuration, autoFitColumns: _autoFitColumns, showColumnStats: _showColumnStats, rowIndicator, frozenRows: _frozenRows, className, style, accessMode, id, displayStyle, }: NiceDataGridProps<T>): default_2.JSX.Element | null;
10959
+ export declare function NiceDataGrid<T extends Record<string, any>>({ columns, data: dataProp, keyField, dataSource, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, showAdvancedFilter, advancedFilter, onAdvancedFilterChange, filterFields, filterPresets, onSaveFilterPreset, onDeleteFilterPreset, selectable, selectedKeys: controlledSelected, onSelectionChange, pagination, pageSize: initPageSize, page: controlledPage, onPageChange, totalRows, autoPagination, stickyHeader, stickyFooter, searchable, searchPlaceholder, virtualScroll, rowHeight, groupBy, groupRender, onCellEdit, editMode, formItems, formColumns, editFormTitle, formProps, onRowEdit, onRowAdd, onRowDelete: _onRowDelete, bulkActions, onBulkDelete, exportCsv, exportFilename, detailRow, expandedRowKeys: controlledExpandedRows, onExpandedRowChange, columnReorder: _columnReorder, onColumnReorder: _onColumnReorder, columnResize, rowDraggable, onRowReorder, striped, compact, size, loading: loadingProp, emptyText, toolbar, onRowClick, pinnedTopKeys, pinnedBottomKeys, colSpan: colSpanFn, showStatusBar, contextMenuItems, onContextMenuAction, printFriendly, keyboardNavigation, focusedCell: controlledFocusedCell, onFocusedCellChange, cellRangeSelection, selectedCellRange: controlledCellRange, onCellRangeChange, clipboard, clipboardFormat, onBeforeCopy, onCopy, onPaste, quickFilters, activeQuickFilters: controlledQuickFilters, onQuickFilterChange, columnGroups: _columnGroups, stateStorageKey, initialState, onStateChange, flashRowKeys, flashDuration, autoFitColumns: _autoFitColumns, showColumnStats: _showColumnStats, rowIndicator, frozenRows: _frozenRows, className, style, accessMode, id, displayStyle, disabled: disabledProp, readOnly: readOnlyProp, error, }: NiceDataGridProps<T>): default_2.JSX.Element | null;
10837
10960
 
10838
10961
  export declare namespace NiceDataGrid {
10839
10962
  var displayName: string;
@@ -11039,7 +11162,19 @@ export declare interface NiceDataGridProps<T extends Record<string, any> = any>
11039
11162
  onRowReorder?: (fromIndex: number, toIndex: number) => void;
11040
11163
  striped?: boolean;
11041
11164
  compact?: boolean;
11165
+ /**
11166
+ * Visual density of the grid rows (cell padding + font size). Maps to the
11167
+ * `nice-table--{size}` scale. Independent of `compact` (which is tighter than
11168
+ * the smallest size). Default `md`.
11169
+ */
11170
+ size?: NiceSize;
11042
11171
  loading?: boolean;
11172
+ /** Disable the whole grid — dimmed and inert. */
11173
+ disabled?: boolean;
11174
+ /** Read-only: blocks inline editing (not dimmed). */
11175
+ readOnly?: boolean;
11176
+ /** Error message shown above the grid body. */
11177
+ error?: string;
11043
11178
  emptyText?: string;
11044
11179
  toolbar?: React.ReactNode;
11045
11180
  onRowClick?: (row: T) => void;
@@ -11214,10 +11349,61 @@ export { NiceDataSourceState }
11214
11349
  /** Predefined date-format presets. */
11215
11350
  declare type NiceDateFormatPreset = 'date-local' | 'date-utc' | 'datetime-local' | 'datetime-utc' | 'month-local' | 'month-utc' | 'week' | 'time';
11216
11351
 
11217
- export declare const NiceDatePicker: default_2.ForwardRefExoticComponent<NiceDatePickerProps & default_2.RefAttributes<HTMLInputElement>>;
11352
+ export declare const NiceDateRangeBox: default_2.FC<NiceDateRangeBoxProps>;
11353
+
11354
+ /** Props for the {@link NiceDateRangeBox} component — a pair of date pickers for selecting a date range. */
11355
+ export declare interface NiceDateRangeBoxProps extends NiceFormFieldProps {
11356
+ /** Start date (ISO string). */
11357
+ startDate: string;
11358
+ /** End date (ISO string). */
11359
+ endDate: string;
11360
+ /** Called when the start date changes. */
11361
+ onStartChange: (date: string) => void;
11362
+ /** Called when the end date changes. */
11363
+ onEndChange: (date: string) => void;
11364
+ /** Earliest selectable date. */
11365
+ min?: string;
11366
+ /** Latest selectable date. */
11367
+ max?: string;
11368
+ /** Show a clear button. */
11369
+ clearable?: boolean;
11370
+ /** Placeholder for the start input. */
11371
+ startPlaceholder?: string;
11372
+ /** Placeholder for the end input. */
11373
+ endPlaceholder?: string;
11374
+ /** Label shown above (or before) the start picker. */
11375
+ startLabel?: string;
11376
+ /** Label shown above (or before) the end picker. */
11377
+ endLabel?: string;
11378
+ /** Layout direction for the two pickers (default `horizontal`). */
11379
+ layout?: 'horizontal' | 'vertical';
11380
+ /** Custom separator rendered between pickers in horizontal layout (default `–`). Pass `''` to hide. */
11381
+ separator?: default_2.ReactNode;
11382
+ /** Gap in pixels between the two pickers (default 12). */
11383
+ gap?: number;
11384
+ /** Stretch each picker to fill available width. */
11385
+ fullWidth?: boolean;
11386
+ /**
11387
+ * Format preset forwarded to BOTH inner pickers — so a range can be
11388
+ * date, datetime (`'datetime-local'`), month, week or time, not just date.
11389
+ */
11390
+ dateFormatPreset?: NiceDateFormatPreset;
11391
+ /**
11392
+ * @deprecated Use `dateFormatPreset`. Native input type forwarded to both
11393
+ * inner pickers.
11394
+ */
11395
+ type?: 'date' | 'datetime-local' | 'time' | 'month' | 'week';
11396
+ }
11397
+
11398
+ /** Built-in countdown format presets (merged in from NiceTimePicker).
11399
+ * NOTE: deliberately NOT named `NiceCountdownFormat` — that name is already a
11400
+ * public export of the unrelated `NiceCountdown` display component. */
11401
+ declare type NiceDateTimeCountdownFormat = 'verbose' | 'compact' | 'short' | 'minimal' | 'words';
11402
+
11403
+ export declare const NiceDateTimePicker: default_2.ForwardRefExoticComponent<NiceDateTimePickerProps & default_2.RefAttributes<HTMLInputElement>>;
11218
11404
 
11219
- /** Props for the {@link NiceDatePicker} component — a masked, locale-aware date/time input. */
11220
- export declare interface NiceDatePickerProps extends NiceFormFieldProps {
11405
+ /** Props for the {@link NiceDateTimePicker} component — a masked, locale-aware date/time input. */
11406
+ export declare interface NiceDateTimePickerProps extends NiceFormFieldProps {
11221
11407
  /** ISO value (e.g. `'2024-06-15'`). Always ISO regardless of display locale. */
11222
11408
  value?: string;
11223
11409
  /** Fires with the new ISO value. Empty string while the input is incomplete. */
@@ -11261,69 +11447,47 @@ export declare interface NiceDatePickerProps extends NiceFormFieldProps {
11261
11447
  * Only fires for date / datetime / month presets.
11262
11448
  */
11263
11449
  keyboardShortcuts?: boolean;
11450
+ /** Datetime/time: show a seconds section (`HH:mm:ss`). Default: `false`. */
11451
+ showSeconds?: boolean;
11452
+ /**
11453
+ * Datetime/time: minute increment. Drives the native picker companion `step`
11454
+ * AND the ↑/↓ arrow stepping in the masked field.
11455
+ */
11456
+ minuteStep?: number;
11457
+ /**
11458
+ * Datetime/time: `'12'` renders an AM/PM toggle beside the field (and asks the
11459
+ * native picker for a 12-hour dialog where the OS locale supports it). The
11460
+ * masked field always edits 24-hour digits and the emitted value stays ISO 24h.
11461
+ */
11462
+ hourFormat?: '12' | '24';
11463
+ /**
11464
+ * Datetime/time/date: show a "Now" button that fills the current date/time.
11465
+ * Default: `false`.
11466
+ */
11467
+ showNow?: boolean;
11468
+ /**
11469
+ * Explicit target date to combine with the picked time (`Date` or
11470
+ * `YYYY-MM-DD`). When omitted while {@link countdown} is on, the target
11471
+ * auto-resolves to the next occurrence (today, else tomorrow).
11472
+ */
11473
+ targetDate?: string | Date;
11474
+ /** Fires whenever the resolved countdown target changes. */
11475
+ onTargetChange?: (target: Date) => void;
11476
+ /** Show a live countdown label beside the field. */
11477
+ countdown?: boolean;
11478
+ /** Built-in countdown format preset (default `'verbose'`). */
11479
+ countdownFormat?: NiceDateTimeCountdownFormat;
11480
+ /** Custom countdown formatter (overrides {@link countdownFormat}). */
11481
+ formatCountdown?: (msRemaining: number, target: Date) => string;
11482
+ /** Label rendered before the countdown text (e.g. `'starts in'`). */
11483
+ countdownLabel?: default_2.ReactNode;
11484
+ /** Countdown tick interval in ms (default 1000, min 100). */
11485
+ countdownInterval?: number;
11486
+ /** Text shown once the countdown reaches zero. */
11487
+ countdownDoneText?: string;
11264
11488
  }
11265
11489
 
11266
- export declare const NiceDateRangeBox: default_2.FC<NiceDateRangeBoxProps>;
11267
-
11268
- /** Props for the {@link NiceDateRangeBox} component — a pair of date pickers for selecting a date range. */
11269
- export declare interface NiceDateRangeBoxProps extends NiceFormFieldProps {
11270
- /** Start date (ISO string). */
11271
- startDate: string;
11272
- /** End date (ISO string). */
11273
- endDate: string;
11274
- /** Called when the start date changes. */
11275
- onStartChange: (date: string) => void;
11276
- /** Called when the end date changes. */
11277
- onEndChange: (date: string) => void;
11278
- /** Earliest selectable date. */
11279
- min?: string;
11280
- /** Latest selectable date. */
11281
- max?: string;
11282
- /** Show a clear button. */
11283
- clearable?: boolean;
11284
- /** Placeholder for the start input. */
11285
- startPlaceholder?: string;
11286
- /** Placeholder for the end input. */
11287
- endPlaceholder?: string;
11288
- /** Label shown above (or before) the start picker. */
11289
- startLabel?: string;
11290
- /** Label shown above (or before) the end picker. */
11291
- endLabel?: string;
11292
- /** Layout direction for the two pickers (default `horizontal`). */
11293
- layout?: 'horizontal' | 'vertical';
11294
- /** Custom separator rendered between pickers in horizontal layout (default `–`). Pass `''` to hide. */
11295
- separator?: default_2.ReactNode;
11296
- /** Gap in pixels between the two pickers (default 12). */
11297
- gap?: number;
11298
- /** Stretch each picker to fill available width. */
11299
- fullWidth?: boolean;
11300
- }
11301
-
11302
- export declare const NiceDateTimePicker: default_2.ForwardRefExoticComponent<NiceDateTimePickerProps & default_2.RefAttributes<HTMLDivElement>>;
11303
-
11304
- /** Props for the {@link NiceDateTimePicker} component — a combined date and time picker with calendar dropdown. */
11305
- export declare interface NiceDateTimePickerProps extends NiceFormFieldProps {
11306
- /** ISO 8601 date-time string (e.g. "2026-03-16T14:30") */
11307
- value?: string;
11308
- onChange?: (value: string) => void;
11309
- onBlur?: (e: default_2.FocusEvent) => void;
11310
- /** Minimum allowed date-time (ISO string) */
11311
- min?: string;
11312
- /** Maximum allowed date-time (ISO string) */
11313
- max?: string;
11314
- /** Display format — 12h shows AM/PM toggle, 24h shows 0–23 */
11315
- hourFormat?: '12' | '24';
11316
- /** Minute increment step */
11317
- minuteStep?: number;
11318
- /** Show seconds input */
11319
- showSeconds?: boolean;
11320
- /** Show "Now" quick button */
11321
- showNow?: boolean;
11322
- /** Show clear button */
11323
- clearable?: boolean;
11324
- }
11325
-
11326
- export { NiceDensity }
11490
+ export { NiceDensity }
11327
11491
 
11328
11492
  /**
11329
11493
  * NiceDesignTokens - Visual token generator component
@@ -11424,6 +11588,82 @@ export declare interface NiceDeviceControlCardProps extends NiceBaseProps {
11424
11588
  controlLayout?: ControlLayout;
11425
11589
  }
11426
11590
 
11591
+ export declare type NiceDeviceKind = 'microphone' | 'gamepad';
11592
+
11593
+ export declare type NiceDeviceLabelPlacement = 'top' | 'bottom' | 'left' | 'right';
11594
+
11595
+ export declare const NiceDeviceManager: default_2.FC<NiceDeviceManagerProps>;
11596
+
11597
+ export declare interface NiceDeviceManagerProps extends NiceBaseProps {
11598
+ devices?: NiceManagedDevice[];
11599
+ defaultDevices?: NiceManagedDevice[];
11600
+ onDevicesChange?: (devices: NiceManagedDevice[]) => void;
11601
+ /** Auto-detect connected mics + gamepads (default true). */
11602
+ autoDetect?: boolean;
11603
+ /** Which device kinds to manage (default both). */
11604
+ kinds?: NiceDeviceKind[];
11605
+ /** Slots (players/roles) devices can be assigned to. */
11606
+ slots?: NiceDeviceSlot[];
11607
+ onAssign?: (deviceId: string, slotId: string | null) => void;
11608
+ onOpenConfig?: (device: NiceManagedDevice) => void;
11609
+ columns?: number;
11610
+ minColumnWidth?: number;
11611
+ }
11612
+
11613
+ export declare interface NiceDeviceSlot {
11614
+ id: string;
11615
+ label: string;
11616
+ color?: string;
11617
+ }
11618
+
11619
+ export declare const NiceDeviceTile: default_2.ForwardRefExoticComponent<NiceDeviceTileProps & default_2.RefAttributes<HTMLDivElement>>;
11620
+
11621
+ export declare interface NiceDeviceTileProps extends NiceBaseProps {
11622
+ /** The device SVG (microphone / gamepad). */
11623
+ children: default_2.ReactNode;
11624
+ /** Primary label (line 1, small). */
11625
+ name?: string;
11626
+ /** Secondary label (line 2, very small) — also editable from the popover. */
11627
+ description?: string;
11628
+ defaultDescription?: string;
11629
+ onDescriptionChange?: (text: string) => void;
11630
+ /** Caption placement relative to the device (default 'bottom', centered). */
11631
+ labelPlacement?: NiceDeviceLabelPlacement;
11632
+ /** Index/number badge shown on the tile. */
11633
+ number?: number | string;
11634
+ /** Device tint. Default `'transparent'` → only the device outline shows. */
11635
+ color?: string;
11636
+ onColorChange?: (color: string) => void;
11637
+ volume?: number;
11638
+ defaultVolume?: number;
11639
+ onVolumeChange?: (v: number) => void;
11640
+ gain?: number;
11641
+ defaultGain?: number;
11642
+ onGainChange?: (v: number) => void;
11643
+ /** Enable the right-click quick-settings popover (default true). */
11644
+ contextMenu?: boolean;
11645
+ /** Which quick controls appear in the popover. */
11646
+ quickControls?: NiceDeviceTileQuickControls;
11647
+ /** "Full configuration" button handler (omit to hide the button). */
11648
+ onOpenConfig?: () => void;
11649
+ fullConfigLabel?: string;
11650
+ selected?: boolean;
11651
+ onClick?: () => void;
11652
+ /** Register with a surrounding NiceSpatialNavProvider under this id. */
11653
+ focusId?: string;
11654
+ }
11655
+
11656
+ export declare interface NiceDeviceTileQuickControls {
11657
+ /** Show the color picker row (default true). */
11658
+ color?: boolean;
11659
+ /** Show the description field (default true). */
11660
+ description?: boolean;
11661
+ /** Show the volume slider (default true). */
11662
+ volume?: boolean;
11663
+ /** Show the gain slider (default true). */
11664
+ gain?: boolean;
11665
+ }
11666
+
11427
11667
  export declare function NiceDiagramDesigner({ initialSchema, onChange, onExport, className, style, tutorial, }: NiceDiagramDesignerProps): JSX.Element;
11428
11668
 
11429
11669
  export declare interface NiceDiagramDesignerProps {
@@ -12013,18 +12253,6 @@ export declare interface NiceDropDownButtonProps extends NiceBaseProps {
12013
12253
  errorPlacement?: 'bottom' | 'right';
12014
12254
  }
12015
12255
 
12016
- export declare const NiceDropZone: default_2.FC<NiceDropZoneProps>;
12017
-
12018
- export declare interface NiceDropZoneProps extends NiceBaseProps {
12019
- onFiles: (files: File[]) => void;
12020
- accept?: string;
12021
- multiple?: boolean;
12022
- disabled?: boolean;
12023
- children?: default_2.ReactNode;
12024
- dropzoneText?: string;
12025
- dragActiveText?: string;
12026
- }
12027
-
12028
12256
  export declare const NiceDynamicSidebar: ForwardRefExoticComponent<NiceDynamicSidebarProps & RefAttributes<HTMLElement>>;
12029
12257
 
12030
12258
  export declare interface NiceDynamicSidebarProps extends NiceBaseProps {
@@ -12631,16 +12859,6 @@ export declare type NiceFilePanel = 'left' | 'right';
12631
12859
  */
12632
12860
  export declare const NiceFilePicker: default_2.FC<NiceFilePickerProps>;
12633
12861
 
12634
- export declare const NiceFilePickerButton: default_2.FC<NiceFilePickerButtonProps>;
12635
-
12636
- export declare interface NiceFilePickerButtonProps extends NiceBaseProps {
12637
- onFiles: (files: File[]) => void;
12638
- accept?: string;
12639
- multiple?: boolean;
12640
- disabled?: boolean;
12641
- children?: default_2.ReactNode;
12642
- }
12643
-
12644
12862
  /** Props for {@link NiceFilePicker} — visually-customisable file input. */
12645
12863
  export declare interface NiceFilePickerProps extends NiceStandardProps {
12646
12864
  /** MIME types / extensions accepted (e.g. `"image/*,.pdf"`). */
@@ -12677,101 +12895,6 @@ export declare type NiceFileSortDir = 'asc' | 'desc';
12677
12895
  /** Sortable field for the {@link NiceFileManager} detail view. */
12678
12896
  export declare type NiceFileSortField = 'name' | 'size' | 'modified' | 'extension';
12679
12897
 
12680
- export declare const NiceFileUpload: default_2.ForwardRefExoticComponent<NiceFileUploadProps & default_2.RefAttributes<NiceFileUploadRef>>;
12681
-
12682
- /**
12683
- * @deprecated Use {@link NiceUpload}. The legacy alias is preserved to avoid
12684
- * breaking existing imports; remove in a future major release.
12685
- */
12686
- export declare const NiceFileUploader: default_2.ForwardRefExoticComponent<NiceUploadProps & default_2.RefAttributes<HTMLDivElement>>;
12687
-
12688
- /**
12689
- * @deprecated Use {@link NiceUploadProps}.
12690
- */
12691
- export declare type NiceFileUploaderProps = NiceUploadProps;
12692
-
12693
- export declare interface NiceFileUploadProps extends NiceBaseProps {
12694
- /** Akceptowane typy plików (np. "image/*,.pdf") */
12695
- accept?: string;
12696
- /** Czy pozwalać na multiple files */
12697
- multiple?: boolean;
12698
- /** Maksymalny rozmiar pliku w bajtach */
12699
- maxFileSize?: number;
12700
- /** Maksymalna liczba plików */
12701
- maxFiles?: number;
12702
- /** Minimalny rozmiar pliku */
12703
- minFileSize?: number;
12704
- /** Rozmiar chunka dla dużych plików (domyślnie 5MB) */
12705
- chunkSize?: number;
12706
- /** Próg rozmiaru pliku dla chunked upload (domyślnie 10MB) */
12707
- chunkThreshold?: number;
12708
- /** Automatycznie rozpocznij upload po dodaniu */
12709
- autoUpload?: boolean;
12710
- /** Handler uploadu */
12711
- uploadHandler?: UploadHandler;
12712
- /** URL do uploadu (jeśli nie podano uploadHandler) */
12713
- uploadUrl?: string;
12714
- /** Nagłówki HTTP dla uploadu */
12715
- uploadHeaders?: Record<string, string>;
12716
- /** Callback po dodaniu plików */
12717
- onFilesAdded?: (files: FileInfo[]) => void;
12718
- /** Callback po zakończeniu uploadu */
12719
- onUploadComplete?: (file: FileInfo) => void;
12720
- /** Callback po błędzie */
12721
- onUploadError?: (file: FileInfo, error: string) => void;
12722
- /** Callback na postęp */
12723
- onProgress?: (file: FileInfo, progress: number) => void;
12724
- /** Callback po usunięciu */
12725
- onFileRemoved?: (file: FileInfo) => void;
12726
- /** Callback po zmianie stanu */
12727
- onChange?: (files: FileInfo[]) => void;
12728
- /** Niestandardowy renderer podglądu */
12729
- renderPreview?: (file: FileInfo) => default_2.ReactNode;
12730
- /** Niestandardowy renderer elementu listy */
12731
- renderFileItem?: (file: FileInfo, actions: FileItemActions) => default_2.ReactNode;
12732
- /** Pokaż podgląd obrazów */
12733
- showPreview?: boolean;
12734
- /** Pokaż listę plików */
12735
- showFileList?: boolean;
12736
- /** Tryb wyświetlania listy */
12737
- listMode?: 'list' | 'grid' | 'compact';
12738
- /** Rozmiar podglądu */
12739
- previewSize?: NiceSize;
12740
- /** Tekst w dropzone */
12741
- dropzoneText?: string;
12742
- /** Tekst pod przyciskiem */
12743
- browseText?: string;
12744
- /** Tekst podczas dragover */
12745
- dragActiveText?: string;
12746
- /** Wyłączony */
12747
- disabled?: boolean;
12748
- /** Read-only (tylko podgląd) */
12749
- readOnly?: boolean;
12750
- /** Customowe klasy CSS */
12751
- dropzoneClassName?: string;
12752
- /** Retry count */
12753
- maxRetries?: number;
12754
- /** Ilość równoczesnych uploadów */
12755
- concurrentUploads?: number;
12756
- /** Walidator plików */
12757
- validateFile?: (file: File) => string | null;
12758
- /** Zachowaj pliki po uploadzięciu */
12759
- keepFilesAfterUpload?: boolean;
12760
- /** Początkowe pliki */
12761
- initialFiles?: FileInfo[];
12762
- }
12763
-
12764
- export declare interface NiceFileUploadRef {
12765
- addFiles: (files: File[]) => void;
12766
- uploadAll: () => void;
12767
- cancelAll: () => void;
12768
- clearAll: () => void;
12769
- getFiles: () => FileInfo[];
12770
- getFile: (id: string) => FileInfo | undefined;
12771
- retryFailed: () => void;
12772
- openFileBrowser: () => void;
12773
- }
12774
-
12775
12898
  export declare const NiceFilterBuilder: default_2.FC<NiceFilterBuilderProps>;
12776
12899
 
12777
12900
  /** Props for the {@link NiceFilterBuilder} component — a visual query builder for complex AND/OR filter trees. */
@@ -12870,6 +12993,10 @@ export declare interface NiceFloorPlanCanvasProps extends NiceBaseProps {
12870
12993
  animateStateChanges?: boolean;
12871
12994
  }
12872
12995
 
12996
+ export { NiceFocusable }
12997
+
12998
+ export { NiceFocusableProps }
12999
+
12873
13000
  /**
12874
13001
  * Cycles Tab / Shift+Tab between the first and last focusable
12875
13002
  * descendants. Use inside modals, dialogs, drawers — anywhere
@@ -13207,6 +13334,36 @@ export declare interface NiceGalleryProps extends NiceStandardProps {
13207
13334
  height?: number | string;
13208
13335
  /** Number of thumbnails visible in the strip carousel window (default 4). */
13209
13336
  thumbnailWindow?: number;
13337
+ /**
13338
+ * Background colour of the letterbox/pillarbox bars shown behind an image
13339
+ * whose aspect ratio doesn't fill the frame. Defaults to the theme background
13340
+ * when omitted.
13341
+ */
13342
+ frameColor?: string;
13343
+ }
13344
+
13345
+ export declare const NiceGamepad: default_2.FC<NiceGamepadProps>;
13346
+
13347
+ export declare interface NiceGamepadProps extends Omit<NiceDeviceTileProps, 'children'> {
13348
+ /** 'compact' = micro silhouette icon (default); 'full' = labeled layout. */
13349
+ view?: 'full' | 'compact';
13350
+ /** Icon size: px or a NiceSize preset (default 'md'). */
13351
+ size?: number | NiceSize;
13352
+ /** Fired when a button is pressed (click or live). */
13353
+ onButtonPress?: (button: GamepadButton_2) => void;
13354
+ /** Controlled momentary-press highlight. */
13355
+ pressedButtons?: GamepadButton_2[];
13356
+ /** Persistent highlight (e.g. to point out a button). */
13357
+ highlightedButtons?: GamepadButton_2[];
13358
+ /** Reflect a live physical controller via ui-core useGamepad. */
13359
+ live?: boolean;
13360
+ gamepadIndex?: number;
13361
+ /** Per-button text labels (full view). */
13362
+ buttonLabels?: Partial<Record<GamepadButton_2, string>>;
13363
+ /** Optional action tree to assign to buttons (full view). */
13364
+ actionTree?: NiceTreeNode[];
13365
+ assignments?: Partial<Record<GamepadButton_2, string>>;
13366
+ onAssign?: (button: GamepadButton_2, node: NiceTreeNode) => void;
13210
13367
  }
13211
13368
 
13212
13369
  export declare const NiceGantt: default_2.FC<NiceGanttProps>;
@@ -13497,8 +13654,16 @@ export declare interface NiceGradientPickerProps extends NiceBaseProps {
13497
13654
  /** Maximum number of gradient stops */
13498
13655
  maxStops?: number;
13499
13656
  label?: string;
13657
+ /** Label position relative to the swatch. Default `'top'`. */
13658
+ labelPlacement?: 'top' | 'left';
13500
13659
  disabled?: boolean;
13501
- /** Fixed width of the whole control. Defaults to 320px so the layout stays stable when stops are added. */
13660
+ /** Looks enabled but the popup won't open and edits are blocked. */
13661
+ readOnly?: boolean;
13662
+ /** Show a loading spinner and dim the control. */
13663
+ loading?: boolean;
13664
+ /** Error ring; a string value also renders the message. */
13665
+ error?: string | boolean;
13666
+ /** Fixed width of the popup. Defaults to 340px. */
13502
13667
  width?: string | number;
13503
13668
  }
13504
13669
 
@@ -13830,26 +13995,6 @@ export { NiceI18nProvider }
13830
13995
 
13831
13996
  export { NiceIcon }
13832
13997
 
13833
- export declare const NiceIconButton: default_2.ForwardRefExoticComponent<NiceIconButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
13834
-
13835
- /** Props for the {@link NiceIconButton} component — a compact icon-only button. */
13836
- export declare interface NiceIconButtonProps extends NiceBaseProps {
13837
- /** Icon element to render inside the button. */
13838
- icon: default_2.ReactNode;
13839
- /** Accessible label text (alias for aria-label). */
13840
- label?: string;
13841
- /** Button size. */
13842
- size?: NiceSize;
13843
- /** Click handler. */
13844
- onClick?: (e: default_2.MouseEvent<HTMLButtonElement>) => void;
13845
- /** Disables the button. */
13846
- disabled?: boolean;
13847
- /** Accessible label (required — icon-only buttons need a text description). */
13848
- 'aria-label': string;
13849
- /** Visual variant. */
13850
- variant?: NiceVariant;
13851
- }
13852
-
13853
13998
  export { NiceIconProps }
13854
13999
 
13855
14000
  export { NiceIconProvider }
@@ -13986,34 +14131,8 @@ export declare interface NiceImageEditorState {
13986
14131
  /** Available tools in the {@link NiceImageEditor} toolbar. */
13987
14132
  export declare type NiceImageEditorTool = 'crop' | 'rotate' | 'flip' | 'brightness' | 'contrast' | 'saturate' | 'blur' | 'annotate';
13988
14133
 
13989
- export declare const NiceImageViewer: default_2.ForwardRefExoticComponent<NiceImageViewerProps & default_2.RefAttributes<HTMLDivElement>>;
13990
-
13991
- /** Props for the {@link NiceImageViewer} component — an image with lightbox preview, zoom, pan, and rotation. */
13992
- export declare interface NiceImageViewerProps extends NiceStandardProps {
13993
- /** Image source URL. */
13994
- src: string;
13995
- /** Alt text. */
13996
- alt?: string;
13997
- /** Viewer layout size (minimal / compact / standard / fullscreen). */
13998
- editorSize?: NiceEditorSize;
13999
- /** Enable click-to-open lightbox preview (default true). */
14000
- preview?: boolean;
14001
- /** Allow rotation in the lightbox. */
14002
- rotatable?: boolean;
14003
- /** Allow zoom in the lightbox. */
14004
- zoomable?: boolean;
14005
- /** Minimum zoom level. */
14006
- minZoom?: number;
14007
- /** Maximum zoom level. */
14008
- maxZoom?: number;
14009
- /** Thumbnail width. */
14010
- width?: number | string;
14011
- /** Thumbnail height. */
14012
- height?: number | string;
14013
- }
14014
-
14015
14134
  /**
14016
- * {@link NiceInbox} � Full-featured email inbox with reading pane, compose, folders,
14135
+ * {@link NiceInbox} — Full-featured email inbox with reading pane, compose, folders,
14017
14136
  * batch actions, sorting, search, and keyboard navigation.
14018
14137
  */
14019
14138
  export declare const NiceInbox: default_2.ForwardRefExoticComponent<NiceInboxProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -14785,6 +14904,14 @@ export declare interface NiceListProps extends NiceBaseProps {
14785
14904
  emptyText?: string;
14786
14905
  /** Size preset. */
14787
14906
  size?: NiceSize;
14907
+ /** Optional header shown above the list; stays visible during loading. */
14908
+ header?: default_2.ReactNode;
14909
+ /** Disable the whole list — dimmed and inert. */
14910
+ disabled?: boolean;
14911
+ /** Read-only: items are non-interactive but not dimmed. */
14912
+ readOnly?: boolean;
14913
+ /** Error message shown in place of the list. */
14914
+ error?: string;
14788
14915
  /** Show border around the list. */
14789
14916
  bordered?: boolean;
14790
14917
  /** Swipe actions revealed on mobile swipe gesture. */
@@ -15325,6 +15452,8 @@ export declare interface NiceLookupProps extends NiceFormFieldProps {
15325
15452
  displayField?: string;
15326
15453
  /** Width of the dropdown when in mini-grid mode (CSS). */
15327
15454
  dropdownWidth?: string | number;
15455
+ /** Gap (px) between the input and the dropdown menu. Default 0 (menu abuts the input). */
15456
+ menuGap?: number;
15328
15457
  }
15329
15458
 
15330
15459
  export { NiceLookupSourceState }
@@ -15401,6 +15530,23 @@ export declare interface NiceMAMProps extends NiceBaseProps {
15401
15530
  children?: ReactNode;
15402
15531
  }
15403
15532
 
15533
+ export declare interface NiceManagedDevice {
15534
+ id: string;
15535
+ kind: NiceDeviceKind;
15536
+ name?: string;
15537
+ description?: string;
15538
+ number?: number;
15539
+ /** Device tint; default transparent (outline only). */
15540
+ color?: string;
15541
+ /** mediaDevices deviceId (mic) or gamepad index id. */
15542
+ deviceId?: string;
15543
+ volume?: number;
15544
+ gain?: number;
15545
+ /** Live mic level 0..1 (fed by the consumer). */
15546
+ level?: number;
15547
+ assignedTo?: string | null;
15548
+ }
15549
+
15404
15550
  export declare const NiceMap: default_2.ForwardRefExoticComponent<NiceMapProps & default_2.RefAttributes<HTMLDivElement>>;
15405
15551
 
15406
15552
  export declare const NiceMapChart: default_2.FC<NiceMapChartProps>;
@@ -15753,6 +15899,8 @@ export declare interface NiceMenuProps extends NiceBaseProps {
15753
15899
  density?: NiceMenuDensity;
15754
15900
  /** Size preset. */
15755
15901
  size?: NiceSize;
15902
+ /** Loading: dims the bar, shows a spinner and blocks interaction. */
15903
+ loading?: boolean;
15756
15904
  /** Stretch top-level items to fill the container. */
15757
15905
  fullWidth?: boolean;
15758
15906
  /** Show vertical separators between top items. */
@@ -15874,6 +16022,17 @@ export declare interface NiceMergeRequestBuilderProps extends NiceBaseProps {
15874
16022
  tutorial?: NiceComponentTutorial;
15875
16023
  }
15876
16024
 
16025
+ export declare const NiceMicrophone: default_2.FC<NiceMicrophoneProps>;
16026
+
16027
+ export declare interface NiceMicrophoneProps extends Omit<NiceDeviceTileProps, 'children'> {
16028
+ /** Audio level 0..1 — fills the mic head from the bottom. */
16029
+ level?: number;
16030
+ /** Icon size: px or a NiceSize preset (default 'md'). */
16031
+ size?: number | NiceSize;
16032
+ /** Muted: dims the fill and shows a slash. */
16033
+ muted?: boolean;
16034
+ }
16035
+
15877
16036
  export declare const NiceModal: default_2.FC<NiceModalProps>;
15878
16037
 
15879
16038
  /** Props for the {@link NiceModal} component — a dialog overlay with focus trapping. */
@@ -16335,43 +16494,6 @@ export declare interface NiceModuleRouteProps {
16335
16494
 
16336
16495
  export { NiceModuleStatus }
16337
16496
 
16338
- export declare const NiceMultiView: default_2.FC<NiceMultiViewProps>;
16339
-
16340
- /** A view entry in the {@link NiceMultiView}. */
16341
- declare interface NiceMultiViewItem {
16342
- /** Unique key. */
16343
- key: string;
16344
- /** Optional label shown in tabs / header. */
16345
- label?: string;
16346
- /** Optional icon shown in tabs / header. */
16347
- icon?: string;
16348
- /** Content renderer. */
16349
- render: () => default_2.ReactNode;
16350
- }
16351
-
16352
- /** Navigation style for the NiceMultiView. */
16353
- declare type NiceMultiViewNav = 'tabs' | 'dots' | 'arrows' | 'none';
16354
-
16355
- /** Props for the {@link NiceMultiView} component. */
16356
- export declare interface NiceMultiViewProps extends NiceBaseProps {
16357
- /** Size variant. */
16358
- size?: NiceSize;
16359
- /** View definitions. */
16360
- items: NiceMultiViewItem[];
16361
- /** Currently visible view index (controlled). */
16362
- selectedIndex?: number;
16363
- /** Called when the visible index changes. */
16364
- onSelectedIndexChange?: (index: number) => void;
16365
- /** Enable slide transition animation (default: true). */
16366
- animationEnabled?: boolean;
16367
- /** Navigation style (default: 'tabs'). */
16368
- nav?: NiceMultiViewNav;
16369
- /** Show prev/next arrows alongside any nav style (default: true for 'dots' / 'none'). */
16370
- showArrows?: boolean;
16371
- /** Auto-cycle interval in ms (0 = disabled). */
16372
- autoPlay?: number;
16373
- }
16374
-
16375
16497
  /**
16376
16498
  * {@link NiceNavbar} — Top navigation bar with logo, breadcrumbs, centre content,
16377
16499
  * and right-side slots for tenant switcher, notifications, and user menu.
@@ -16721,6 +16843,14 @@ export declare interface NiceNavShellProps {
16721
16843
  className?: string;
16722
16844
  contentClassName?: string;
16723
16845
  'data-testid'?: string;
16846
+ /**
16847
+ * Opt-in: wrap the shell in a {@link NiceSpatialNavProvider} so keyboard
16848
+ * arrows / a gamepad d-pad can navigate focusable controls (registered via
16849
+ * `useSpatialFocusable` / `<NiceFocusable>`). Default false.
16850
+ */
16851
+ spatialNavigation?: boolean;
16852
+ /** Options forwarded to NiceSpatialNavProvider when `spatialNavigation` is on. */
16853
+ spatialNavigationProps?: Omit<NiceSpatialNavProviderProps, 'children'>;
16724
16854
  }
16725
16855
 
16726
16856
  export declare interface NiceNavShellTab {
@@ -16796,36 +16926,6 @@ export declare interface NiceNotificationCategory {
16796
16926
  examples?: string[];
16797
16927
  }
16798
16928
 
16799
- /**
16800
- * {@link NiceNotificationCenter} — Notification dropdown/panel with read/unread state,
16801
- * filtering, grouping, dismiss, and bulk actions.
16802
- */
16803
- export declare const NiceNotificationCenter: default_2.ForwardRefExoticComponent<NiceNotificationCenterProps & default_2.RefAttributes<HTMLDivElement>>;
16804
-
16805
- /** Props for the {@link NiceNotificationCenter} component. */
16806
- export declare interface NiceNotificationCenterProps extends NiceFormFieldProps {
16807
- /** Notifications. */
16808
- notifications: NotificationEntry[];
16809
- /** Fires when a notification is clicked. */
16810
- onClick?: (notification: NotificationEntry) => void;
16811
- /** Fires when a notification is dismissed. */
16812
- onDismiss?: (id: string | number) => void;
16813
- /** Fires when all are marked as read. */
16814
- onMarkAllRead?: () => void;
16815
- /** Fires when all are cleared. */
16816
- onClearAll?: () => void;
16817
- /** Whether the dropdown is open. */
16818
- open?: boolean;
16819
- /** Fires on toggle. */
16820
- onOpenChange?: (open: boolean) => void;
16821
- /** Maximum notifications to show before "more". */
16822
- maxVisible?: number;
16823
- /** Locale for date formatting. */
16824
- locale?: string;
16825
- /** Whether to group by notification group key. */
16826
- groupByCategory?: boolean;
16827
- }
16828
-
16829
16929
  export declare interface NiceNotificationChannel {
16830
16930
  id: string;
16831
16931
  name: string;
@@ -16905,10 +17005,14 @@ export declare interface NiceNotificationsProps {
16905
17005
  maxHeight?: number;
16906
17006
  /** Show "Mark all as read" link in panel header. Default: true. */
16907
17007
  showMarkAllRead?: boolean;
17008
+ /** Show a "Clear all" (bulk-dismiss) link in the panel header. Default: false. */
17009
+ showClearAll?: boolean;
16908
17010
  /** Show "View all" link at panel footer. Default: false. */
16909
17011
  showViewAll?: boolean;
16910
17012
  /** Mark-all-as-read handler. */
16911
17013
  onMarkAllRead?: () => void;
17014
+ /** Bulk-dismiss handler — fires when "Clear all" is clicked. */
17015
+ onClearAll?: () => void;
16912
17016
  /** View-all handler. */
16913
17017
  onViewAll?: () => void;
16914
17018
  /** Per-item read-toggle handler (called when user marks an item read). */
@@ -16982,6 +17086,8 @@ export declare interface NiceNumberInputProps extends NiceFormFieldProps {
16982
17086
  suffixValue?: string;
16983
17087
  /** Called when the suffix select changes. */
16984
17088
  onSuffixChange?: (value: string, prevWeight: number | undefined, newWeight: number | undefined) => void;
17089
+ /** Show a divider line between the value and the suffix. Default `false`. */
17090
+ suffixSeparator?: boolean;
16985
17091
  }
16986
17092
 
16987
17093
  /**
@@ -17019,6 +17125,8 @@ export declare interface NiceNumericInputProps extends NiceStandardProps {
17019
17125
  format?: string | ((value: number) => string);
17020
17126
  /** Render the +/- step buttons. */
17021
17127
  showButtons?: boolean;
17128
+ /** Visual size. `'xs'` is the most compact (for dense rows); default `'md'`. */
17129
+ size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
17022
17130
  /** Placeholder shown when the value is empty (uncontrolled / undefined). */
17023
17131
  placeholder?: string;
17024
17132
  /** Disable input + buttons. */
@@ -17044,35 +17152,6 @@ export { NiceOnboardingAnswer }
17044
17152
 
17045
17153
  export { NiceOnboardingQuestion }
17046
17154
 
17047
- export declare const NiceOnboardingWizard: ForwardRefExoticComponent<NiceOnboardingWizardProps & RefAttributes<HTMLDivElement>>;
17048
-
17049
- export declare interface NiceOnboardingWizardProps extends NiceBaseProps {
17050
- /** Size variant. */
17051
- size?: NiceSize;
17052
- /** All onboarding questions. */
17053
- questions: NiceOnboardingQuestion[];
17054
- /** Pre-filled answers. */
17055
- initialAnswers?: NiceOnboardingAnswer[];
17056
- /** Step labels (if different from category names). */
17057
- stepLabels?: string[];
17058
- /** Called when user submits final answers. */
17059
- onComplete?: (answers: NiceOnboardingAnswer[]) => void;
17060
- /** Called when user leaves the wizard without finishing. */
17061
- onCancel?: () => void;
17062
- /** Called on each step transition. */
17063
- onStepChange?: (step: number) => void;
17064
- /** Welcome screen content (shown before step 1). */
17065
- welcomeContent?: React.ReactNode;
17066
- /** Completion screen content (shown after last step). */
17067
- completionContent?: React.ReactNode;
17068
- /** Show progress bar. */
17069
- showProgress?: boolean;
17070
- /** Allow going back to previous steps. */
17071
- allowBack?: boolean;
17072
- /** Logo / branding element for the wizard header. */
17073
- logo?: React.ReactNode;
17074
- }
17075
-
17076
17155
  export { NiceOnChange }
17077
17156
 
17078
17157
  export { NiceOnOpenChange }
@@ -17293,9 +17372,15 @@ export declare interface NicePaginationProps extends NiceBaseProps {
17293
17372
  totalPages: number;
17294
17373
  /** Called when the page changes. */
17295
17374
  onChange: (page: number) => void;
17296
- /** Show "Page X of Y" info text. */
17375
+ /**
17376
+ * Show "Page X of Y" info text.
17377
+ * @default true
17378
+ */
17297
17379
  showInfo?: boolean;
17298
- /** Number of page buttons shown on each side of the current page. */
17380
+ /**
17381
+ * Number of page buttons shown on each side of the current page.
17382
+ * @default 2
17383
+ */
17299
17384
  siblingCount?: number;
17300
17385
  /** Show ⏮ / ⏭ first/last page buttons. */
17301
17386
  showFirstLast?: boolean;
@@ -17328,7 +17413,7 @@ export declare interface NiceParagraphProps extends Omit<NiceStandardProps, 'siz
17328
17413
  muted?: boolean;
17329
17414
  }
17330
17415
 
17331
- export declare type NiceParagraphSize = 'sm' | 'md' | 'lg';
17416
+ export declare type NiceParagraphSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
17332
17417
 
17333
17418
  export declare const NicePasswordInput: default_2.ForwardRefExoticComponent<NicePasswordInputProps & default_2.RefAttributes<HTMLInputElement>>;
17334
17419
 
@@ -17465,6 +17550,10 @@ export declare interface NicePDFViewerProps extends NiceStandardProps {
17465
17550
  maxZoom?: number;
17466
17551
  /** Viewer viewport height. */
17467
17552
  height?: number | string;
17553
+ /** Aspect ratio of the page area (CSS `aspect-ratio`). Default `'210 / 297'` (A4 portrait). */
17554
+ aspectRatio?: string;
17555
+ /** How the page fits the frame. `'page'` (default) shows the whole page at zoom 100. */
17556
+ fit?: 'width' | 'height' | 'page' | 'none';
17468
17557
  /** Called when the current page changes. */
17469
17558
  onPageChange?: (page: number) => void;
17470
17559
  /** Called when zoom level changes. */
@@ -17520,31 +17609,6 @@ export declare interface NicePermissionMatrixProps {
17520
17609
  id?: string;
17521
17610
  }
17522
17611
 
17523
- /**
17524
- * {@link NicePhoneInput} — Phone number input with country code selector, masking, and E.164 formatting.
17525
- */
17526
- export declare const NicePhoneInput: default_2.ForwardRefExoticComponent<NicePhoneInputProps & default_2.RefAttributes<HTMLDivElement>>;
17527
-
17528
- /** Props for the {@link NicePhoneInput} component. */
17529
- export declare interface NicePhoneInputProps extends NiceFormFieldProps {
17530
- /** Controlled phone value. */
17531
- value?: PhoneValue;
17532
- /** Fires on value change with parsed phone value. */
17533
- onChange?: (value: PhoneValue) => void;
17534
- /** Available country codes. */
17535
- countryCodes?: PhoneCountryCode[];
17536
- /** Default country code (ISO alpha-2, e.g. "PL"). */
17537
- defaultCountry?: string;
17538
- /** Placeholder for the number part. */
17539
- placeholder?: string;
17540
- /** Whether to show the country flag emoji. */
17541
- showFlag?: boolean;
17542
- /** Whether to validate as E.164 on blur. */
17543
- validateE164?: boolean;
17544
- /** Fires with the raw input event. */
17545
- onBlur?: (e: default_2.FocusEvent<HTMLInputElement>) => void;
17546
- }
17547
-
17548
17612
  export declare const NicePickList: <T = unknown>(props: NicePickListProps<T> & default_2.RefAttributes<HTMLDivElement>) => default_2.ReactElement | null;
17549
17613
 
17550
17614
  /** Props for the {@link NicePickList} component — a dual-list control for moving items between source and target. */
@@ -17617,34 +17681,6 @@ export declare interface NicePieSlice {
17617
17681
  color?: string;
17618
17682
  }
17619
17683
 
17620
- /**
17621
- * {@link NicePinCodeInput} — PIN code entry with individual digit boxes,
17622
- * optional numeric keypad, masking, and auto-submit.
17623
- */
17624
- export declare const NicePinCodeInput: default_2.ForwardRefExoticComponent<NicePinCodeInputProps & default_2.RefAttributes<HTMLDivElement>>;
17625
-
17626
- /** Props for the {@link NicePinCodeInput} component. */
17627
- export declare interface NicePinCodeInputProps extends NiceFormFieldProps {
17628
- /** Current PIN value. */
17629
- value?: string;
17630
- /** Fires when value changes. */
17631
- onChange?: (value: string) => void;
17632
- /** Fires when PIN is fully entered. */
17633
- onComplete?: (pin: string) => void;
17634
- /** Number of PIN digits. */
17635
- length?: number;
17636
- /** Whether to mask digits (show dots). */
17637
- masked?: boolean;
17638
- /** Whether to show a numeric keypad below the input. */
17639
- showKeypad?: boolean;
17640
- /** Whether to auto-submit when all digits are filled. */
17641
- autoSubmit?: boolean;
17642
- /** Error shake animation trigger (toggle to replay). */
17643
- shake?: boolean;
17644
- /** Placeholder character. */
17645
- placeholderChar?: string;
17646
- }
17647
-
17648
17684
  export declare const NicePipelineEditor: default_2.FC<NicePipelineEditorProps>;
17649
17685
 
17650
17686
  export declare interface NicePipelineEditorProps extends NiceBaseProps {
@@ -18151,6 +18187,31 @@ export declare interface NiceQRCodeProps extends NiceStandardProps {
18151
18187
  logo?: string;
18152
18188
  /** Logo dimensions in pixels. */
18153
18189
  logoSize?: number;
18190
+ /**
18191
+ * Render an editable {@link NiceTextInput} above the code that live-encodes
18192
+ * what the user types. Off by default — pass `showInput` to enable.
18193
+ */
18194
+ showInput?: boolean;
18195
+ /**
18196
+ * Alias for {@link showInput}. When `editable` is provided it takes precedence:
18197
+ * `editable={false}` hides the input (QR still renders), `editable` shows it.
18198
+ */
18199
+ editable?: boolean;
18200
+ /** Label for the built-in input (only when the input is shown). */
18201
+ inputLabel?: string;
18202
+ /** Placeholder for the built-in input (only when the input is shown). */
18203
+ inputPlaceholder?: string;
18204
+ /** Where to place the built-in input's label (forwarded to {@link NiceTextInput}). */
18205
+ labelPlacement?: NiceTextInputProps['labelPlacement'];
18206
+ /**
18207
+ * Extra props forwarded to the built-in {@link NiceTextInput}, so the top editor
18208
+ * is a fully-featured NiceTextInput (variant, prefix/suffix, clearable, helperText,
18209
+ * error, disabled, readOnly, …). Explicit props (`inputLabel`, `inputPlaceholder`,
18210
+ * `labelPlacement`, `size`) win over the same keys here.
18211
+ */
18212
+ inputProps?: Partial<NiceTextInputProps>;
18213
+ /** Fires with the new value whenever the user edits the built-in input. */
18214
+ onValueChange?: (value: string) => void;
18154
18215
  }
18155
18216
 
18156
18217
  /** Reed-Solomon error correction level for QR codes. */
@@ -18277,12 +18338,12 @@ export declare interface NiceRangeSliderProps extends NiceFormFieldProps {
18277
18338
  max?: number;
18278
18339
  /** Step increment. */
18279
18340
  step?: number;
18280
- /** Start (lower) thumb value. */
18281
- startValue: number;
18282
- /** End (upper) thumb value. */
18283
- endValue: number;
18341
+ /** Start (lower) thumb value. Defaults to `min`. */
18342
+ startValue?: number;
18343
+ /** End (upper) thumb value. Defaults to `max`. */
18344
+ endValue?: number;
18284
18345
  /** Called when either thumb moves. */
18285
- onChange: (start: number, end: number) => void;
18346
+ onChange?: (start: number, end: number) => void;
18286
18347
  /** Show value labels at each thumb. */
18287
18348
  showLabels?: boolean;
18288
18349
  /** Custom label formatter. */
@@ -19691,11 +19752,9 @@ export declare interface NiceSectionProps extends NiceStandardProps {
19691
19752
  * - `NiceButtonGroup` — visual cluster of independent action buttons
19692
19753
  * (Save / Cancel, Bold / Italic / Underline). Each child is its own
19693
19754
  * `NiceButton`, so icon-only or icon + text combinations work via
19694
- * `<NiceButton leftIcon={...} />` or `<NiceIconButton />`.
19695
- * - `NiceToolbar` — long horizontal strip with separators / spacers /
19696
- * custom widgets, typically above content.
19755
+ * `<NiceButton leftIcon={...} />`.
19697
19756
  */
19698
- export declare function NiceSegmentedControl<T = string>({ options, value: controlledValue, defaultValue, onChange, size, block, disabled, className, style, 'data-testid': testId, }: NiceSegmentedControlProps<T>): default_2.JSX.Element;
19757
+ export declare function NiceSegmentedControl<T = string>({ options, value: controlledValue, defaultValue, onChange, size, block, disabled, readOnly, loading, error, highlightFill, errorPlacement, className, style, 'data-testid': testId, }: NiceSegmentedControlProps<T>): default_2.JSX.Element;
19699
19758
 
19700
19759
  export declare namespace NiceSegmentedControl {
19701
19760
  var displayName: string;
@@ -19716,6 +19775,19 @@ export declare interface NiceSegmentedControlProps<T = string> {
19716
19775
  block?: boolean;
19717
19776
  /** Disabled state */
19718
19777
  disabled?: boolean;
19778
+ /** Read-only: segments are inert but NOT greyed (unlike disabled). */
19779
+ readOnly?: boolean;
19780
+ /** Loading: shows a spinner overlay + aria-busy and blocks interaction. */
19781
+ loading?: boolean;
19782
+ /** Error message — red outline + message shown below the control. */
19783
+ error?: string;
19784
+ /**
19785
+ * Active highlight fills the container's inner edges (no surrounding sliver).
19786
+ * Default true; set false to keep the padded look with slivers.
19787
+ */
19788
+ highlightFill?: boolean;
19789
+ /** Error/validation position: 'bottom' (default) or 'right'. */
19790
+ errorPlacement?: 'bottom' | 'right';
19719
19791
  /** Extra class name */
19720
19792
  className?: string;
19721
19793
  /** Inline styles */
@@ -20172,27 +20244,6 @@ export declare interface NiceSignatureData {
20172
20244
 
20173
20245
  export declare type NiceSignatureOutput = 'png' | 'jpeg' | 'svg';
20174
20246
 
20175
- export declare const NiceSignaturePad: ForwardRefExoticComponent<NiceSignaturePadProps & RefAttributes<HTMLDivElement>>;
20176
-
20177
- /** Props for the {@link NiceSignaturePad} component — a canvas-based digital signature capture pad. */
20178
- export declare interface NiceSignaturePadProps extends NiceBaseProps {
20179
- /** Signature image (data URL) — controlled value */
20180
- value?: string | null;
20181
- onChange?: (dataUrl: string | null) => void;
20182
- penColor?: string;
20183
- penWidth?: number;
20184
- backgroundColor?: string;
20185
- width?: number;
20186
- height?: number;
20187
- size?: NiceSize;
20188
- disabled?: boolean;
20189
- readOnly?: boolean;
20190
- showClear?: boolean;
20191
- showUndo?: boolean;
20192
- label?: string;
20193
- exportFormat?: 'image/png' | 'image/jpeg' | 'image/svg+xml';
20194
- }
20195
-
20196
20247
  export declare interface NiceSignaturePoint {
20197
20248
  x: number;
20198
20249
  y: number;
@@ -20205,6 +20256,12 @@ export declare interface NiceSignatureProps {
20205
20256
  value?: NiceSignatureData | null;
20206
20257
  /** Value change callback */
20207
20258
  onChange?: (data: NiceSignatureData | null) => void;
20259
+ /** Convenience callback emitting the signature as a PNG data URL (null when
20260
+ * cleared) — for form consumers that bind a string value. Ported from the
20261
+ * former NiceSignaturePad. */
20262
+ onChangeDataUrl?: (url: string | null) => void;
20263
+ /** Field label shown above the pad. */
20264
+ label?: string;
20208
20265
  /** Width */
20209
20266
  width?: number | string;
20210
20267
  /** Height */
@@ -20321,6 +20378,10 @@ export declare interface NiceSkeletonProps extends Omit<NiceStandardProps, 'vari
20321
20378
  height?: string | number;
20322
20379
  /** Number of skeleton rows to render (text variant). */
20323
20380
  count?: number;
20381
+ /** Lay multiple rows out as a column (default) or a row of bars. */
20382
+ orientation?: 'horizontal' | 'vertical';
20383
+ /** Shimmer animation duration in seconds (default 1.8). */
20384
+ animationSpeed?: number;
20324
20385
  }
20325
20386
 
20326
20387
  export { NiceSkipLink }
@@ -20453,6 +20514,12 @@ export declare interface NiceSparklineProps extends NiceStandardProps {
20453
20514
  showLastPoint?: boolean;
20454
20515
  }
20455
20516
 
20517
+ export { NiceSpatialNavContextValue }
20518
+
20519
+ export { NiceSpatialNavProvider }
20520
+
20521
+ export { NiceSpatialNavProviderProps }
20522
+
20456
20523
  export declare const NiceSpeechToText: default_2.ForwardRefExoticComponent<NiceSpeechToTextProps & default_2.RefAttributes<HTMLDivElement>>;
20457
20524
 
20458
20525
  /** Props for the {@link NiceSpeechToText} component — a browser Speech Recognition toggle button. */
@@ -20471,12 +20538,17 @@ export declare interface NiceSpeechToTextProps extends NiceBaseProps {
20471
20538
  label?: string;
20472
20539
  /** Button label when actively listening. */
20473
20540
  activeLabel?: string;
20541
+ /** Show the visible text label next to the icon. Defaults to `false` (icon-only). The aria-label is always present. */
20542
+ showLabel?: boolean;
20474
20543
  }
20475
20544
 
20476
20545
  export declare const NiceSpeedDialAction: default_2.FC<NiceSpeedDialProps>;
20477
20546
 
20547
+ /** Direction in which the {@link NiceSpeedDialAction} fans out its action items. */
20548
+ export declare type NiceSpeedDialDirection = 'up' | 'down' | 'left' | 'right';
20549
+
20478
20550
  /** A single action in the {@link NiceSpeedDialAction} floating menu. */
20479
- declare interface NiceSpeedDialItem {
20551
+ export declare interface NiceSpeedDialItem {
20480
20552
  /** Unique identifier. */
20481
20553
  key: string;
20482
20554
  /** Icon element. */
@@ -20489,12 +20561,12 @@ declare interface NiceSpeedDialItem {
20489
20561
 
20490
20562
  /** Props for the {@link NiceSpeedDialAction} component — a floating action button with expandable actions. */
20491
20563
  export declare interface NiceSpeedDialProps extends NiceBaseProps {
20492
- /** Icon for the trigger FAB button. */
20564
+ /** Icon for the trigger FAB button. Defaults to a built-in plus icon. */
20493
20565
  icon?: default_2.ReactNode;
20494
20566
  /** Action items that fan out when expanded. */
20495
20567
  items: NiceSpeedDialItem[];
20496
- /** Direction in which the action items expand. */
20497
- direction?: 'up' | 'down' | 'left' | 'right';
20568
+ /** Direction in which the action items expand. Defaults to `'right'`. */
20569
+ direction?: NiceSpeedDialDirection;
20498
20570
  /** CSS position offset for fixed placement (e.g. bottom-right corner). */
20499
20571
  position?: {
20500
20572
  bottom?: number;
@@ -20502,6 +20574,8 @@ export declare interface NiceSpeedDialProps extends NiceBaseProps {
20502
20574
  top?: number;
20503
20575
  left?: number;
20504
20576
  };
20577
+ /** Disables the trigger and hides the actions. */
20578
+ disabled?: boolean;
20505
20579
  }
20506
20580
 
20507
20581
  export declare const NiceSpinner: default_2.FC<NiceSpinnerProps>;
@@ -20595,6 +20669,14 @@ export declare interface NiceSpreadsheetProps extends NiceBaseProps {
20595
20669
  showSheetTabs?: boolean;
20596
20670
  /** Make the entire spreadsheet read-only. */
20597
20671
  readOnly?: boolean;
20672
+ /** Disabled: dimmed + inert (blocks editing/selection). */
20673
+ disabled?: boolean;
20674
+ /** Loading: a spinner overlay + aria-busy. */
20675
+ loading?: boolean;
20676
+ /** Error message shown above the grid. */
20677
+ error?: string;
20678
+ /** Density size (xs..xl) — scales cell padding + font. */
20679
+ size?: NiceSize;
20598
20680
  /** Called when any cell data changes. */
20599
20681
  onChange?: (sheets: NiceSpreadsheetSheet[]) => void;
20600
20682
  /** Called when the active sheet tab changes. */
@@ -20764,39 +20846,6 @@ export declare interface NiceStatisticTrend {
20764
20846
  direction: 'up' | 'down';
20765
20847
  }
20766
20848
 
20767
- /**
20768
- * {@link NiceStatusBadge} — Workflow status badge with semantic coloring and optional pulse animation.
20769
- */
20770
- export declare const NiceStatusBadge: default_2.ForwardRefExoticComponent<NiceStatusBadgeProps & default_2.RefAttributes<HTMLSpanElement>>;
20771
-
20772
- /** Props for the {@link NiceStatusBadge} component. */
20773
- export declare interface NiceStatusBadgeProps {
20774
- /** Status label text. */
20775
- label: string;
20776
- /** Semantic category (maps to color). */
20777
- category?: StatusCategory;
20778
- /** Custom color (overrides category). CSS value. */
20779
- color?: string;
20780
- /** Custom background color. */
20781
- backgroundColor?: string;
20782
- /** Icon or emoji. */
20783
- icon?: default_2.ReactNode;
20784
- /** Whether to pulse/animate the badge. */
20785
- pulse?: boolean;
20786
- /** Whether to show a dot indicator instead of text. */
20787
- dot?: boolean;
20788
- /** Size variant. */
20789
- size?: NiceSize;
20790
- /** Visual variant. */
20791
- variant?: 'filled' | 'outlined' | 'subtle';
20792
- /** Custom class name. */
20793
- className?: string;
20794
- /** Custom style. */
20795
- style?: default_2.CSSProperties;
20796
- accessMode?: NiceAccessMode;
20797
- id?: string;
20798
- }
20799
-
20800
20849
  export declare const NiceStepper: default_2.FC<NiceStepperProps>;
20801
20850
 
20802
20851
  /** Props for the {@link NiceStepper} component — a step indicator / wizard with horizontal or vertical orientation. */
@@ -21094,7 +21143,7 @@ export declare interface NiceTabItem {
21094
21143
  content?: default_2.ReactNode;
21095
21144
  }
21096
21145
 
21097
- export declare function NiceTable<T extends Record<string, any>>({ columns, data, striped, compact, emptyText, className, style, accessMode, id, displayStyle, }: NiceTableProps<T>): default_2.JSX.Element | null;
21146
+ export declare function NiceTable<T extends Record<string, any>>({ columns, data, striped, compact, size, emptyText, className, style, accessMode, id, displayStyle, }: NiceTableProps<T>): default_2.JSX.Element | null;
21098
21147
 
21099
21148
  /** Column definition for the {@link NiceTable} component. */
21100
21149
  export declare interface NiceTableColumn<T = any> {
@@ -21116,46 +21165,16 @@ export declare interface NiceTableColumn<T = any> {
21116
21165
  export declare interface NiceTableProps<T extends Record<string, any> = any> extends NiceBaseProps {
21117
21166
  /** Column definitions. */
21118
21167
  columns: NiceTableColumn<T>[];
21119
- /** Row data. */
21120
- data: T[];
21121
- /** Alternate row coloring. */
21122
- striped?: boolean;
21123
- /** Reduced padding. */
21124
- compact?: boolean;
21125
- /** Text shown when `data` is empty. */
21126
- emptyText?: string;
21127
- }
21128
-
21129
- export declare const NiceTabPanel: default_2.FC<NiceTabPanelProps>;
21130
-
21131
- /** A tab definition for the {@link NiceTabPanel}. */
21132
- export declare interface NiceTabPanelItem {
21133
- /** Unique key. */
21134
- key: string;
21135
- /** Tab header label. */
21136
- title: string;
21137
- /** Optional tab icon. */
21138
- icon?: default_2.ReactNode;
21139
- /** Badge element shown after the title (e.g. count). */
21140
- badge?: default_2.ReactNode;
21141
- /** Disable the tab. */
21142
- disabled?: boolean;
21143
- /** Content renderer. */
21144
- render: () => default_2.ReactNode;
21145
- }
21146
-
21147
- /** Props for the {@link NiceTabPanel} component — a keyed tab strip with content panels and flexible position. */
21148
- export declare interface NiceTabPanelProps extends NiceBaseProps {
21149
- /** Tab panel size. */
21168
+ /** Row data. */
21169
+ data: T[];
21170
+ /** Alternate row coloring. */
21171
+ striped?: boolean;
21172
+ /** Reduced padding. */
21173
+ compact?: boolean;
21174
+ /** Table size (font + cell padding). Independent of `compact`. */
21150
21175
  size?: NiceSize;
21151
- /** Tab definitions. */
21152
- items: NiceTabPanelItem[];
21153
- /** Currently active tab key (controlled). */
21154
- selectedKey?: string;
21155
- /** Called when the active tab changes. */
21156
- onSelectedKeyChange?: (key: string) => void;
21157
- /** Side on which the tab strip is rendered. */
21158
- tabPosition?: 'top' | 'bottom' | 'left' | 'right';
21176
+ /** Text shown when `data` is empty. */
21177
+ emptyText?: string;
21159
21178
  }
21160
21179
 
21161
21180
  export declare const NiceTabs: default_2.FC<NiceTabsProps>;
@@ -21174,6 +21193,10 @@ export declare interface NiceTabsProps extends NiceBaseProps {
21174
21193
  size?: NiceSize;
21175
21194
  /** Stack tabs vertically. */
21176
21195
  vertical?: boolean;
21196
+ /** Show only the tab icons (labels move to the tooltip / aria-label). */
21197
+ iconOnly?: boolean;
21198
+ /** Center the tab strip. `'auto'` (default) centers only when `iconOnly`. */
21199
+ centered?: boolean | 'auto';
21177
21200
  }
21178
21201
 
21179
21202
  export declare const NiceTag: default_2.FC<NiceTagProps>;
@@ -21315,29 +21338,6 @@ export declare interface NiceTaskInboxProps extends NiceBaseProps {
21315
21338
  onRefresh?: () => void;
21316
21339
  }
21317
21340
 
21318
- /**
21319
- * {@link NiceTaxRatePicker} — VAT/tax rate selector with country-specific defaults.
21320
- * Supports Polish rates out-of-the-box, custom rates per country, and displays
21321
- * percentage values.
21322
- */
21323
- export declare const NiceTaxRatePicker: default_2.ForwardRefExoticComponent<NiceTaxRatePickerProps & default_2.RefAttributes<HTMLDivElement>>;
21324
-
21325
- /** Props for the {@link NiceTaxRatePicker} component. */
21326
- export declare interface NiceTaxRatePickerProps extends NiceFormFieldProps {
21327
- /** Selected tax rate id. */
21328
- value?: string;
21329
- /** Fires when selection changes. */
21330
- onChange?: (rateId: string, rate: TaxRate) => void;
21331
- /** Available tax rates. If empty, defaults to Polish VAT rates. */
21332
- rates?: TaxRate[];
21333
- /** Country code filter. */
21334
- countryCode?: string;
21335
- /** Placeholder text. */
21336
- placeholder?: string;
21337
- /** Whether to show rate percentage in the label. */
21338
- showPercentage?: boolean;
21339
- }
21340
-
21341
21341
  export declare const NiceTempDial: default_2.FC<NiceTempDialProps>;
21342
21342
 
21343
21343
  export declare interface NiceTempDialProps extends NiceBaseProps {
@@ -21353,30 +21353,6 @@ export declare interface NiceTempDialProps extends NiceBaseProps {
21353
21353
  disabled?: boolean;
21354
21354
  }
21355
21355
 
21356
- /**
21357
- * {@link NiceTenantSwitcher} — Tenant/organization selector dropdown
21358
- * for multi-tenant SaaS applications.
21359
- */
21360
- export declare const NiceTenantSwitcher: default_2.ForwardRefExoticComponent<NiceTenantSwitcherProps & default_2.RefAttributes<HTMLDivElement>>;
21361
-
21362
- /** Props for the {@link NiceTenantSwitcher} component. */
21363
- export declare interface NiceTenantSwitcherProps extends NiceFormFieldProps {
21364
- /** Available tenants. */
21365
- tenants: TenantEntry[];
21366
- /** Currently selected tenant id. */
21367
- currentTenantId?: string | number;
21368
- /** Fires when tenant is switched. */
21369
- onSwitch?: (tenantId: string | number) => void;
21370
- /** Fires when "Manage tenants" is clicked. */
21371
- onManage?: () => void;
21372
- /** Fires when "Create tenant" is clicked. */
21373
- onCreate?: () => void;
21374
- /** Variant (inline selector or dropdown). */
21375
- variant?: 'dropdown' | 'inline';
21376
- /** Search filter enabled. */
21377
- searchable?: boolean;
21378
- }
21379
-
21380
21356
  /** A single line of terminal output in the {@link NiceTerminalUI}. */
21381
21357
  export declare interface NiceTerminalLine {
21382
21358
  /** Line type — determines styling (green for input, red for error, grey for system). */
@@ -21387,6 +21363,9 @@ export declare interface NiceTerminalLine {
21387
21363
  timestamp?: Date;
21388
21364
  }
21389
21365
 
21366
+ /** Colour scheme for the {@link NiceTerminalUI}. */
21367
+ export declare type NiceTerminalTheme = 'auto' | 'dark' | 'matrix';
21368
+
21390
21369
  export declare const NiceTerminalUI: ForwardRefExoticComponent<NiceTerminalUIProps & RefAttributes<HTMLDivElement>>;
21391
21370
 
21392
21371
  /** Props for the {@link NiceTerminalUI} component — a retro terminal / console emulator. */
@@ -21397,9 +21376,19 @@ export declare interface NiceTerminalUIProps extends NiceStandardProps {
21397
21376
  prompt?: string;
21398
21377
  /** Called when the user presses Enter with a command. */
21399
21378
  onCommand?: (command: string) => void;
21400
- /** Disable user input. */
21379
+ /** Disable user input (log-viewer mode — hides the input row). */
21401
21380
  readOnly?: boolean;
21402
- /** Terminal size preset. */
21381
+ /** Disabled: dims the terminal and blocks input. */
21382
+ disabled?: boolean;
21383
+ /** Error message rendered as an alert banner at the top of the terminal. */
21384
+ error?: string | boolean;
21385
+ /**
21386
+ * Colour scheme. `auto` (default) follows the page theme via canonical tokens
21387
+ * (light terminal in a light theme, dark in a dark theme); `dark` pins the
21388
+ * classic VS Code palette; `matrix` is black + green.
21389
+ */
21390
+ theme?: NiceTerminalTheme;
21391
+ /** Terminal size preset (scales the monospace font). */
21403
21392
  size?: NiceSize;
21404
21393
  /** Terminal viewport height. */
21405
21394
  height?: number | string;
@@ -21498,10 +21487,8 @@ export { niceThemeBootstrap }
21498
21487
 
21499
21488
  export { NiceThemeBorders }
21500
21489
 
21501
- export declare const NiceThemeBuilder: default_2.ForwardRefExoticComponent<NiceThemeBuilderProps & default_2.RefAttributes<HTMLDivElement>>;
21502
-
21503
21490
  /** Props for the {@link NiceThemeBuilder} component — an advanced visual theme editor with section pickers, presets, live preview, and export. */
21504
- export declare interface NiceThemeBuilderProps extends NiceBaseProps {
21491
+ declare interface NiceThemeBuilderProps extends NiceBaseProps {
21505
21492
  /** Initial theme to edit (defaults to Light) */
21506
21493
  theme?: NiceTheme;
21507
21494
  /** Preset themes to offer in the picker */
@@ -21527,7 +21514,7 @@ export declare interface NiceThemeBuilderProps extends NiceBaseProps {
21527
21514
  }
21528
21515
 
21529
21516
  /** Editable sections in the {@link NiceThemeBuilder}. */
21530
- export declare type NiceThemeBuilderSection = 'general' | 'colors' | 'backgrounds' | 'background-image' | 'text' | 'borders' | 'spacing' | 'typography' | 'shadows' | 'transitions' | 'nesting';
21517
+ declare type NiceThemeBuilderSection = 'general' | 'colors' | 'backgrounds' | 'background-image' | 'text' | 'borders' | 'spacing' | 'typography' | 'shadows' | 'transitions' | 'nesting';
21531
21518
 
21532
21519
  export { NiceThemeColors }
21533
21520
 
@@ -21728,55 +21715,6 @@ export { NiceThemeShadows }
21728
21715
 
21729
21716
  export { NiceThemeSpacing }
21730
21717
 
21731
- /**
21732
- * NiceThemeSwitcher — Traceless-aware theme selection component.
21733
- *
21734
- * @example
21735
- * ```tsx
21736
- * // Basic usage with themes
21737
- * <NiceThemeSwitcher
21738
- * themes={[
21739
- * { key: 'light', label: 'Light', icon: '☀️', theme: lightTheme },
21740
- * { key: 'dark', label: 'Dark', icon: '🌙', theme: darkTheme },
21741
- * ]}
21742
- * />
21743
- *
21744
- * // In traceless mode (no persistence)
21745
- * <NiceThemeSwitcher themes={myThemes} storageMode="traceless" />
21746
- * ```
21747
- */
21748
- export declare function NiceThemeSwitcher({ variant, themes, size, showLabels, onThemeChange, defaultTheme, showSystemOption, className, style, disabled, label, hideLabel, cookies: _cookies, localStorage: _localStorage, sessionStorage, storageMode: _storageMode, storageKey, }: NiceThemeSwitcherProps): default_2.ReactElement;
21749
-
21750
- /**
21751
- * Props for NiceThemeSwitcher.
21752
- */
21753
- export declare interface NiceThemeSwitcherProps extends ThemeSwitcherStorageProps {
21754
- /** Display variant */
21755
- variant?: ThemeSwitcherVariant;
21756
- /** Available theme options (required - define your light/dark themes) */
21757
- themes: ThemeOption[];
21758
- /** Size */
21759
- size?: 'sm' | 'md' | 'lg';
21760
- /** Show labels (only applies to 'icons' and 'buttons' variants) */
21761
- showLabels?: boolean;
21762
- /** Callback when theme changes */
21763
- onThemeChange?: (theme: NiceTheme, key: string) => void;
21764
- /** Default theme key (if not persisted or in traceless mode) */
21765
- defaultTheme?: string;
21766
- /** Show "System" option that follows OS preference */
21767
- showSystemOption?: boolean;
21768
- /** Custom class name */
21769
- className?: string;
21770
- /** Inline styles */
21771
- style?: default_2.CSSProperties;
21772
- /** Disabled state */
21773
- disabled?: boolean;
21774
- /** Label for the switcher */
21775
- label?: string;
21776
- /** Hide label visually (still accessible) */
21777
- hideLabel?: boolean;
21778
- }
21779
-
21780
21718
  export { NiceThemeText }
21781
21719
 
21782
21720
  export { NiceThemeTransitions }
@@ -21837,8 +21775,8 @@ export declare interface NiceTimelineItem {
21837
21775
  subtitle?: default_2.ReactNode;
21838
21776
  /** Body content */
21839
21777
  content?: default_2.ReactNode;
21840
- /** Custom icon in the dot */
21841
- icon?: default_2.ReactNode;
21778
+ /** Custom icon in the dot — a built-in icon name (e.g. `'check'`) or any React node. */
21779
+ icon?: default_2.ReactNode | string;
21842
21780
  /** Dot color override */
21843
21781
  color?: string;
21844
21782
  }
@@ -21851,6 +21789,11 @@ export declare interface NiceTimelineProps extends NiceStandardProps {
21851
21789
  mode?: 'left' | 'right' | 'alternate' | 'horizontal';
21852
21790
  /** Size of timeline dots and spacing */
21853
21791
  size?: NiceSize;
21792
+ /**
21793
+ * Render as a slice of a larger timeline: draws a leading line before the
21794
+ * first item and a trailing line after the last (so it reads as an excerpt).
21795
+ * Default false. */
21796
+ isFragment?: boolean;
21854
21797
  /** Custom renderer for each item */
21855
21798
  renderItem?: (item: NiceTimelineItem, index: number) => default_2.ReactNode;
21856
21799
  }
@@ -21872,49 +21815,6 @@ export declare interface NiceTimeoutFeedbackProps extends NiceStandardProps {
21872
21815
  loading: boolean;
21873
21816
  }
21874
21817
 
21875
- export declare const NiceTimePicker: default_2.ForwardRefExoticComponent<NiceTimePickerProps & default_2.RefAttributes<HTMLDivElement>>;
21876
-
21877
- /** Props for the {@link NiceTimePicker} component — a time-only picker with hour/minute/second spinners. */
21878
- export declare interface NiceTimePickerProps extends NiceFormFieldProps {
21879
- /** Time string in HH:mm or HH:mm:ss format */
21880
- value?: string;
21881
- onChange?: (value: string) => void;
21882
- onBlur?: (e: default_2.FocusEvent) => void;
21883
- /** Display format — 12h shows AM/PM toggle, 24h shows 0–23 */
21884
- hourFormat?: '12' | '24';
21885
- /** Minute increment step */
21886
- minuteStep?: number;
21887
- /** Show seconds input */
21888
- showSeconds?: boolean;
21889
- /** Minimum time (HH:mm) */
21890
- min?: string;
21891
- /** Maximum time (HH:mm) */
21892
- max?: string;
21893
- /** Show clear button */
21894
- clearable?: boolean;
21895
- /**
21896
- * Optional explicit target date to combine with the picked time
21897
- * (`Date` or `YYYY-MM-DD` string). When omitted while {@link countdown}
21898
- * is enabled, the target auto-resolves to the **next occurrence**:
21899
- * today if the picked time hasn't passed yet, tomorrow if it has.
21900
- */
21901
- targetDate?: string | Date;
21902
- /** Fires whenever the resolved target Date changes. */
21903
- onTargetChange?: (target: Date) => void;
21904
- /** Show a live countdown label beside the picker. */
21905
- countdown?: boolean;
21906
- /** Built-in countdown format preset (default `'verbose'`). */
21907
- countdownFormat?: NiceCountdownFormat_2;
21908
- /** Custom formatter (overrides {@link countdownFormat}). */
21909
- formatCountdown?: (msRemaining: number, target: Date) => string;
21910
- /** Label rendered before the countdown text (e.g. `'starts in'`). */
21911
- countdownLabel?: default_2.ReactNode;
21912
- /** Update interval in ms (default `1000`). */
21913
- countdownInterval?: number;
21914
- /** Text shown when the target time has elapsed (default `'now'`). */
21915
- countdownDoneText?: string;
21916
- }
21917
-
21918
21818
  export declare const NiceToastContainer: default_2.FC<ToastContainerProps>;
21919
21819
 
21920
21820
  /** Data object describing a single toast notification. */
@@ -22010,36 +21910,6 @@ export declare interface NiceToggleProps extends NiceBaseProps {
22010
21910
 
22011
21911
  export { NiceTone }
22012
21912
 
22013
- export declare const NiceToolbar: default_2.FC<NiceToolbarProps>;
22014
-
22015
- /** A toolbar entry in the {@link NiceToolbar}. */
22016
- export declare interface NiceToolbarItem {
22017
- /** Unique key. */
22018
- key: string;
22019
- /** Custom render function (overrides widget/text/icon). */
22020
- render?: () => default_2.ReactNode;
22021
- /** Built-in widget type: button, visual separator, or flexible spacer. */
22022
- widget?: 'button' | 'separator' | 'spacer';
22023
- /** Button label text. */
22024
- text?: string;
22025
- /** Button icon. */
22026
- icon?: default_2.ReactNode;
22027
- /** Disable the item. */
22028
- disabled?: boolean;
22029
- /** Click handler. */
22030
- onClick?: () => void;
22031
- /** Alignment group within the toolbar. */
22032
- location?: 'before' | 'center' | 'after';
22033
- }
22034
-
22035
- /** Props for the {@link NiceToolbar} component — a horizontal strip of action buttons and widgets. */
22036
- export declare interface NiceToolbarProps extends NiceBaseProps {
22037
- /** Toolbar items. */
22038
- items: NiceToolbarItem[];
22039
- /** Toolbar size preset. */
22040
- size?: NiceSize;
22041
- }
22042
-
22043
21913
  export declare const NiceTooltip: default_2.FC<NiceTooltipProps>;
22044
21914
 
22045
21915
  /** Props for the {@link NiceTooltip} component — shows contextual information on hover/focus. */
@@ -22048,14 +21918,20 @@ export declare interface NiceTooltipProps {
22048
21918
  size?: NiceSize;
22049
21919
  /** Tooltip content (text or rich elements). */
22050
21920
  content: default_2.ReactNode;
22051
- /** Preferred placement relative to the trigger. */
22052
- position?: 'top' | 'bottom' | 'left' | 'right';
21921
+ /**
21922
+ * Placement relative to the trigger. `'auto'` (default) picks the side with
21923
+ * the most room so the tooltip stays on-screen (collision detection).
21924
+ */
21925
+ position?: NiceTooltipSide | 'auto';
22053
21926
  /** Tooltip follows cursor position */
22054
21927
  followCursor?: boolean;
22055
21928
  /** Trigger element that the tooltip wraps. */
22056
21929
  children: default_2.ReactElement;
22057
21930
  }
22058
21931
 
21932
+ /** Concrete side a tooltip can be placed on (after `'auto'` is resolved). */
21933
+ declare type NiceTooltipSide = 'top' | 'bottom' | 'left' | 'right';
21934
+
22059
21935
  export declare const NiceTopNav: default_2.ForwardRefExoticComponent<NiceTopNavProps & default_2.RefAttributes<HTMLElement>>;
22060
21936
 
22061
21937
  export declare type NiceTopNavDensity = 'compact' | 'normal' | 'comfortable';
@@ -22413,7 +22289,7 @@ export declare interface NiceTreeContextMenuItem {
22413
22289
  disabled?: boolean;
22414
22290
  }
22415
22291
 
22416
- export declare function NiceTreeGrid<T extends NiceTreeGridNode>({ columns, data, keyField, parentKeyField, nested, childrenField, expandedKeys: controlledExpanded, onExpandedChange, defaultExpandAll, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, searchable, searchPlaceholder, striped, compact, loading, emptyText, toolbar, onRowClick, className, style, }: NiceTreeGridProps<T>): default_2.JSX.Element;
22292
+ export declare function NiceTreeGrid<T extends NiceTreeGridNode>({ columns, data, keyField, parentKeyField, nested, childrenField, expandedKeys: controlledExpanded, onExpandedChange, defaultExpandAll, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, searchable, searchPlaceholder, striped, compact, size, loading, disabled, readOnly, error, emptyText, toolbar, onRowClick, className, style, }: NiceTreeGridProps<T>): default_2.JSX.Element;
22417
22293
 
22418
22294
  /** A row node in the {@link NiceTreeGrid} (supports index-signature for dynamic fields). */
22419
22295
  export declare interface NiceTreeGridNode {
@@ -22462,8 +22338,16 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
22462
22338
  striped?: boolean;
22463
22339
  /** Reduced padding. */
22464
22340
  compact?: boolean;
22341
+ /** Grid density size (xs..xl) — scales row padding + font. */
22342
+ size?: NiceSize;
22465
22343
  /** Show a loading skeleton. */
22466
22344
  loading?: boolean;
22345
+ /** Disable the whole grid — dimmed and inert. */
22346
+ disabled?: boolean;
22347
+ /** Read-only: rows non-interactive (no selection/row-click) but not dimmed; expand/collapse still works. */
22348
+ readOnly?: boolean;
22349
+ /** Error message shown in place of the grid body. */
22350
+ error?: string;
22467
22351
  /** Text shown when data is empty. */
22468
22352
  emptyText?: string;
22469
22353
  /** Toolbar content rendered above the grid. */
@@ -22621,6 +22505,8 @@ export declare interface NiceTreeSelectProps extends NiceFormFieldProps {
22621
22505
  * leaves (children not rendered, no expand toggle). Default: unlimited.
22622
22506
  */
22623
22507
  maxDepth?: number;
22508
+ /** Gap (px) between the input and the dropdown menu. Default 0 (menu abuts the input). */
22509
+ menuGap?: number;
22624
22510
  }
22625
22511
 
22626
22512
  export declare const NiceTreeView: default_2.FC<NiceTreeViewProps>;
@@ -22967,41 +22853,75 @@ export declare interface NiceUpdatePromptProps extends NiceBaseProps, UseService
22967
22853
 
22968
22854
  export declare const NiceUpload: default_2.ForwardRefExoticComponent<NiceUploadProps & default_2.RefAttributes<HTMLDivElement>>;
22969
22855
 
22970
- /** Props for the {@link NiceUpload} component — drag-and-drop file upload area
22971
- * with progress, image preview, and clipboard paste. Renamed from
22972
- * `NiceFileUploader` and relocated to the basic inputs package per feedback
22973
- * (round 20, 2026-05-05). The legacy export name is kept as a deprecated
22974
- * alias for backward compatibility. */
22856
+ /** Imperative handle, exposed via the optional `apiRef` prop (not the div `ref`). */
22857
+ export declare interface NiceUploadHandle {
22858
+ addFiles: (files: File[]) => void;
22859
+ uploadAll: () => void;
22860
+ cancelAll: () => void;
22861
+ clearAll: () => void;
22862
+ getFiles: () => FileInfo[];
22863
+ getFile: (id: string) => FileInfo | undefined;
22864
+ retryFailed: () => void;
22865
+ openFileBrowser: () => void;
22866
+ }
22867
+
22868
+ /** Props for {@link NiceUpload} — drag-and-drop / button file upload with an
22869
+ * optional upload engine (progress, retry/cancel, chunked upload, validation,
22870
+ * previews) absorbed from the former NiceFileUpload. The legacy `NiceFileUploader`
22871
+ * export was retired in favour of this component. */
22975
22872
  export declare interface NiceUploadProps extends NiceBaseProps {
22976
22873
  accept?: string;
22977
22874
  multiple?: boolean;
22978
22875
  maxFileSize?: number;
22979
22876
  maxFiles?: number;
22877
+ minFileSize?: number;
22878
+ /** Fires with the current File[] on every add/remove (instant) / Upload click. */
22980
22879
  onFilesSelected: (files: File[]) => void;
22981
22880
  uploadMode?: 'instant' | 'useButtons';
22982
- /**
22983
- * Custom dropzone label. Falls back to `text` then to the default
22984
- * `t('dropOrClick', ...)` translation. Kept for backward compatibility
22985
- * with `NiceFileUploader`.
22986
- */
22987
22881
  labelText?: string;
22988
- /**
22989
- * i18n-ready text shown inside the dropzone. When omitted, the
22990
- * built-in translation key `dropOrClick` is used.
22991
- */
22882
+ /** Idle dropzone label; pass `""` for an icon-only dropzone. */
22992
22883
  text?: string;
22993
- /**
22994
- * Optional icon name from `@nice2dev/icons` shown above the dropzone
22995
- * text. Defaults to `'upload'`. Pass `null` to hide the icon.
22996
- */
22884
+ dropzoneText?: string;
22885
+ browseText?: string;
22886
+ dragActiveText?: string;
22887
+ /** Icon/label layout in the dropzone: `'right'` (label beside the icon, default) or `'bottom'` (label under it). */
22888
+ labelPlacement?: 'right' | 'bottom';
22997
22889
  icon?: string | null;
22998
22890
  showFileList?: boolean;
22999
- disabled?: boolean;
23000
- /** Show image thumbnails for image files */
23001
22891
  imagePreview?: boolean;
23002
- /** Per-file progress values 0-100 keyed by file name */
22892
+ showPreview?: boolean;
22893
+ listMode?: 'list' | 'grid' | 'compact';
22894
+ previewSize?: NiceSize;
22895
+ /** External progress override keyed by `file.name` (0–100). */
23003
22896
  fileProgress?: Record<string, number>;
23004
- /** Enable paste from clipboard (Ctrl+V) */
22897
+ renderPreview?: (file: FileInfo) => default_2.ReactNode;
22898
+ renderFileItem?: (file: FileInfo, actions: FileItemActions) => default_2.ReactNode;
22899
+ variant?: 'dropzone' | 'button';
22900
+ /** Custom content for `variant="button"`. */
22901
+ trigger?: default_2.ReactNode;
22902
+ /** Custom clickable/droppable surface content (replaces the default icon+label). */
22903
+ dropChildren?: default_2.ReactNode;
22904
+ autoUpload?: boolean;
22905
+ uploadHandler?: UploadHandler;
22906
+ uploadUrl?: string;
22907
+ uploadHeaders?: Record<string, string>;
22908
+ concurrentUploads?: number;
22909
+ maxRetries?: number;
22910
+ chunkSize?: number;
22911
+ chunkThreshold?: number;
22912
+ validateFile?: (file: File) => string | null;
22913
+ keepFilesAfterUpload?: boolean;
22914
+ initialFiles?: FileInfo[];
22915
+ disabled?: boolean;
22916
+ readOnly?: boolean;
22917
+ onFilesAdded?: (files: FileInfo[]) => void;
22918
+ onUploadComplete?: (file: FileInfo) => void;
22919
+ onUploadError?: (file: FileInfo, error: string) => void;
22920
+ onProgress?: (file: FileInfo, progress: number) => void;
22921
+ onFileRemoved?: (file: FileInfo) => void;
22922
+ onChange?: (files: FileInfo[]) => void;
22923
+ apiRef?: default_2.Ref<NiceUploadHandle>;
22924
+ /** Enable paste from clipboard (Ctrl+V). */
23005
22925
  pasteFromClipboard?: boolean;
23006
22926
  }
23007
22927
 
@@ -23157,40 +23077,6 @@ export declare interface NiceValidatorProps extends NiceBaseProps {
23157
23077
 
23158
23078
  export { NiceVariant }
23159
23079
 
23160
- /**
23161
- * {@link NiceVatInput} — VAT/NIP number input with country selector,
23162
- * prefix auto-prepend, pattern validation, and optional VIES verification.
23163
- */
23164
- export declare const NiceVatInput: default_2.ForwardRefExoticComponent<NiceVatInputProps & default_2.RefAttributes<HTMLDivElement>>;
23165
-
23166
- /** Props for the {@link NiceVatInput} component. */
23167
- export declare interface NiceVatInputProps extends NiceFormFieldProps {
23168
- /** Current VAT number value (with or without prefix). */
23169
- value?: string;
23170
- /** Fires when value changes. */
23171
- onChange?: (value: string, isValid: boolean) => void;
23172
- /** Selected country code (ISO 3166-1 alpha-2). */
23173
- countryCode?: string;
23174
- /** Fires when country changes. */
23175
- onCountryChange?: (code: string) => void;
23176
- /** Custom country configs. */
23177
- countries?: VatCountryConfig[];
23178
- /** Whether to show the country selector. */
23179
- showCountrySelector?: boolean;
23180
- /** Whether to auto-prepend VAT prefix. */
23181
- autoPrefixVat?: boolean;
23182
- /** External validation result. */
23183
- validationResult?: {
23184
- valid: boolean;
23185
- companyName?: string;
23186
- error?: string;
23187
- } | null;
23188
- /** Fires when user requests online validation (e.g. VIES). */
23189
- onValidateRequest?: (vatNumber: string, countryCode: string) => void;
23190
- /** Placeholder override. */
23191
- placeholder?: string;
23192
- }
23193
-
23194
23080
  export declare const NiceVectorMap: default_2.FC<NiceVectorMapProps>;
23195
23081
 
23196
23082
  /** Props for the {@link NiceVectorMap} component — an SVG choropleth map with region selection and tooltips. */
@@ -23853,6 +23739,12 @@ export declare interface NiceVirtualScrollerProps<T = unknown> extends NiceStand
23853
23739
  renderItem: (item: T, index: number) => default_2.ReactNode;
23854
23740
  /** Optional item key extractor */
23855
23741
  itemKey?: (item: T, index: number) => string | number;
23742
+ /** Disable interaction and dim the list. */
23743
+ disabled?: boolean;
23744
+ /** Read-only marker (a scroller is already read-only; kept for API parity). */
23745
+ readOnly?: boolean;
23746
+ /** Error message — shown as an alert in place of the list. */
23747
+ error?: string;
23856
23748
  }
23857
23749
 
23858
23750
  export { NiceVisuallyHidden }
@@ -24303,45 +24195,6 @@ declare interface NiceXLSXOptions extends NiceExportOptions {
24303
24195
  }>;
24304
24196
  }
24305
24197
 
24306
- /**
24307
- * {@link NiceXPBar} — Experience points progress bar with level display and level-up animation.
24308
- */
24309
- export declare const NiceXPBar: default_2.ForwardRefExoticComponent<NiceXPBarProps & default_2.RefAttributes<HTMLDivElement>>;
24310
-
24311
- /** Props for the {@link NiceXPBar} component. */
24312
- export declare interface NiceXPBarProps {
24313
- /** Current XP points. */
24314
- currentXP: number;
24315
- /** XP required for next level. */
24316
- maxXP: number;
24317
- /** Current level number. */
24318
- level: number;
24319
- /** Label shown on the bar (optional, defaults to "Level X"). */
24320
- levelLabel?: string;
24321
- /** Previous XP value for animated transition. */
24322
- previousXP?: number;
24323
- /** Whether to animate XP changes. */
24324
- animated?: boolean;
24325
- /** Duration of fill animation in ms (default 800). */
24326
- animationDuration?: number;
24327
- /** Whether to show level-up celebration effect. */
24328
- showLevelUp?: boolean;
24329
- /** Fires when level-up animation completes. */
24330
- onLevelUpComplete?: () => void;
24331
- /** Color of the XP fill bar (CSS value). */
24332
- fillColor?: string;
24333
- /** Whether to show the XP numbers. */
24334
- showNumbers?: boolean;
24335
- /** Size variant. */
24336
- size?: NiceSize;
24337
- /** Custom class name. */
24338
- className?: string;
24339
- /** Custom style. */
24340
- style?: default_2.CSSProperties;
24341
- accessMode?: NiceAccessMode;
24342
- id?: string;
24343
- }
24344
-
24345
24198
  /**
24346
24199
  * Node shape types
24347
24200
  */
@@ -24350,26 +24203,6 @@ export declare type NodeShape = 'rectangle' | 'rounded-rectangle' | 'circle' | '
24350
24203
  /** Prevent importing entire library — enforce tree-shaking. */
24351
24204
  export declare const noFullImport: ESLintRule;
24352
24205
 
24353
- /** A single notification entry. */
24354
- export declare interface NotificationEntry {
24355
- id: string | number;
24356
- type: NotificationType;
24357
- /** Notification title. */
24358
- title: string;
24359
- /** Body text or description. */
24360
- body?: string;
24361
- /** ISO date string. */
24362
- createdAt: string;
24363
- /** Whether the notification has been read. */
24364
- isRead?: boolean;
24365
- /** Icon override (emoji or URL). */
24366
- icon?: string;
24367
- /** Action URL or route path to navigate to when clicked. */
24368
- actionUrl?: string;
24369
- /** Group key for categorization. */
24370
- group?: string;
24371
- }
24372
-
24373
24206
  /**
24374
24207
  * usePushNotifications — Push notification subscription management
24375
24208
  *
@@ -24408,9 +24241,6 @@ export declare interface NotificationEntry {
24408
24241
  */
24409
24242
  declare type NotificationPermission_2 = 'default' | 'granted' | 'denied';
24410
24243
 
24411
- /** Type of notification. */
24412
- export declare type NotificationType = 'info' | 'success' | 'warning' | 'error' | 'task' | 'mention' | 'system';
24413
-
24414
24244
  export declare interface OAuthConfigTemplate {
24415
24245
  authorizationUrl: string;
24416
24246
  tokenUrl: string;
@@ -24725,23 +24555,6 @@ export declare interface Person {
24725
24555
  metadata?: Record<string, any>;
24726
24556
  }
24727
24557
 
24728
- /** Country phone prefix entry. */
24729
- export declare interface PhoneCountryCode {
24730
- code: string;
24731
- dialCode: string;
24732
- name: string;
24733
- mask?: string;
24734
- }
24735
-
24736
- /** Parsed phone value. */
24737
- export declare interface PhoneValue {
24738
- countryCode?: string;
24739
- dialCode?: string;
24740
- number?: string;
24741
- /** Full E.164 formatted number (e.g. "+48123456789"). */
24742
- e164?: string;
24743
- }
24744
-
24745
24558
  export { PinchGesture }
24746
24559
 
24747
24560
  declare interface Pipeline {
@@ -26683,6 +26496,8 @@ export declare interface SpatialAnnotation {
26683
26496
  createdBy?: string;
26684
26497
  }
26685
26498
 
26499
+ export { SpatialFocusableMeta }
26500
+
26686
26501
  /** Speaker definition */
26687
26502
  export declare interface Speaker {
26688
26503
  id: string;
@@ -26763,9 +26578,6 @@ declare interface StateSlice {
26763
26578
  computed?: ComputedField[];
26764
26579
  }
26765
26580
 
26766
- /** Predefined status semantic categories. */
26767
- export declare type StatusCategory = 'success' | 'warning' | 'error' | 'info' | 'neutral' | 'custom';
26768
-
26769
26581
  export { StorageAdapter }
26770
26582
 
26771
26583
  export { StorageAuditResult }
@@ -27090,22 +26902,6 @@ export declare type TaskPriority = 'low' | 'medium' | 'high' | 'critical';
27090
26902
 
27091
26903
  export declare type TaskStatus = 'pending' | 'claimed' | 'inProgress' | 'completed' | 'delegated' | 'expired';
27092
26904
 
27093
- /** A tax rate entry. */
27094
- export declare interface TaxRate {
27095
- /** Rate identifier. */
27096
- id: string;
27097
- /** Display label (e.g. "23%", "8%", "zw."). */
27098
- label: string;
27099
- /** Numeric rate as decimal (0.23 = 23%). */
27100
- rate: number;
27101
- /** Country code this rate applies to. */
27102
- countryCode?: string;
27103
- /** Category (e.g. "standard", "reduced", "zero", "exempt"). */
27104
- category?: string;
27105
- /** Whether this is the default rate. */
27106
- isDefault?: boolean;
27107
- }
27108
-
27109
26905
  export declare type TempDialMode = 'heat' | 'cool' | 'auto' | 'off';
27110
26906
 
27111
26907
  declare type TemplateEngine = 'handlebars' | 'ejs' | 'mustache' | 'simple';
@@ -27136,19 +26932,6 @@ declare interface TemplateVariable {
27136
26932
  };
27137
26933
  }
27138
26934
 
27139
- /** A tenant/organization entry. */
27140
- export declare interface TenantEntry {
27141
- id: string | number;
27142
- /** Display name. */
27143
- name: string;
27144
- /** Logo/icon URL. */
27145
- logoUrl?: string;
27146
- /** Subtitle (e.g. role, plan). */
27147
- subtitle?: string;
27148
- /** Whether the tenant is active/current. */
27149
- isCurrent?: boolean;
27150
- }
27151
-
27152
26935
  declare type TestAction = 'render' | 'click' | 'type' | 'select' | 'hover' | 'focus' | 'blur' | 'submit' | 'keypress' | 'wait' | 'scroll' | 'drag' | 'assert' | 'snapshot' | 'a11y-check';
27153
26936
 
27154
26937
  declare interface TestCase {
@@ -27320,22 +27103,6 @@ export { themeOneDark }
27320
27103
 
27321
27104
  export { themeOnyx }
27322
27105
 
27323
- /**
27324
- * Theme option for the switcher.
27325
- */
27326
- export declare interface ThemeOption {
27327
- /** Unique key */
27328
- key: string;
27329
- /** Display label */
27330
- label: string;
27331
- /** Icon or emoji */
27332
- icon?: default_2.ReactNode;
27333
- /** The theme object */
27334
- theme: NiceTheme;
27335
- /** Whether this is the system theme (follows OS preference) */
27336
- isSystem?: boolean;
27337
- }
27338
-
27339
27106
  export { themeOrange }
27340
27107
 
27341
27108
  export { themePastelCoral }
@@ -27356,11 +27123,6 @@ export { themePastelSky }
27356
27123
 
27357
27124
  export { themePink }
27358
27125
 
27359
- /**
27360
- * Built-in theme presets.
27361
- */
27362
- export declare type ThemePreset = 'light' | 'dark' | 'system' | 'custom';
27363
-
27364
27126
  /** Colours used to render a theme preview thumbnail. All optional except `background`. */
27365
27127
  export declare interface ThemePreviewColors {
27366
27128
  /** Main page background. */
@@ -27423,27 +27185,6 @@ export { themeSummerBeach }
27423
27185
 
27424
27186
  export { themeSunset }
27425
27187
 
27426
- /**
27427
- * Traceless storage props interface for theme switcher.
27428
- */
27429
- declare interface ThemeSwitcherStorageProps {
27430
- /** Whether this component may use cookies */
27431
- cookies?: boolean;
27432
- /** Whether this component may use localStorage */
27433
- localStorage?: boolean;
27434
- /** Whether this component may use sessionStorage */
27435
- sessionStorage?: boolean;
27436
- /** Override storage mode for this component */
27437
- storageMode?: TracelessMode;
27438
- /** Storage key for persisting component state */
27439
- storageKey?: string;
27440
- }
27441
-
27442
- /**
27443
- * Display variant for the theme switcher.
27444
- */
27445
- export declare type ThemeSwitcherVariant = 'dropdown' | 'radio' | 'buttons' | 'icons';
27446
-
27447
27188
  export { themeSynthwave }
27448
27189
 
27449
27190
  export { themeTeal }
@@ -28111,7 +27852,7 @@ export declare interface UploadResponse {
28111
27852
  url?: string;
28112
27853
  error?: string;
28113
27854
  fileId?: string;
28114
- metadata?: Record<string, any>;
27855
+ metadata?: Record<string, unknown>;
28115
27856
  }
28116
27857
 
28117
27858
  export declare type UploadStatus = 'pending' | 'uploading' | 'success' | 'error' | 'cancelled';
@@ -28363,6 +28104,10 @@ export { useFocusTrap }
28363
28104
 
28364
28105
  export { useFormGeneration }
28365
28106
 
28107
+ export { useGamepad }
28108
+
28109
+ export { UseGamepadOptions }
28110
+
28366
28111
  export { useGridPreferences }
28367
28112
 
28368
28113
  /**
@@ -28797,6 +28542,14 @@ export declare function useSidebarPrefsScope(overrides?: SidebarPrefsScopeValue)
28797
28542
  /** Shortcut for pages that only need the userId. */
28798
28543
  export declare function useSidebarUserId(override?: string): string | undefined;
28799
28544
 
28545
+ export { useSpatialFocusable }
28546
+
28547
+ export { UseSpatialFocusableOptions }
28548
+
28549
+ export { useSpatialNav }
28550
+
28551
+ export { useSpatialNavOptional }
28552
+
28800
28553
  /**
28801
28554
  * Hook to get a namespaced storage adapter.
28802
28555
  */
@@ -28993,20 +28746,6 @@ declare type ValidationType = 'required' | 'type' | 'min' | 'max' | 'pattern' |
28993
28746
 
28994
28747
  export { VARIANT_PRESETS }
28995
28748
 
28996
- /** Country-specific VAT/NIP validation config. */
28997
- export declare interface VatCountryConfig {
28998
- /** ISO 3166‑1 alpha-2 code. */
28999
- code: string;
29000
- /** Display name. */
29001
- label: string;
29002
- /** VAT prefix (e.g. "PL", "DE"). */
29003
- prefix: string;
29004
- /** Regex pattern for the numeric part (without prefix). */
29005
- pattern: RegExp;
29006
- /** Mask/placeholder hint. */
29007
- placeholder?: string;
29008
- }
29009
-
29010
28749
  /** Author/User information */
29011
28750
  declare interface VersioningAuthor {
29012
28751
  id: string;