@nice2dev/ui 1.0.29 → 1.0.30

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 (63) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/dist/NiceBackupStatusBadge.doc-Bx2bFmBQ.cjs +1 -0
  3. package/dist/NiceBackupStatusBadge.doc-CdDxIQ-M.js +25 -0
  4. package/dist/NiceConfirmDialog-BiTJVR4-.js +81 -0
  5. package/dist/NiceConfirmDialog-Bjw_rN4o.cjs +1 -0
  6. package/dist/NiceErrorBoundary-1H751jK7.cjs +1 -0
  7. package/dist/NiceErrorBoundary-B-txoU3Y.js +709 -0
  8. package/dist/NiceForm-DGUTmaZT.js +5014 -0
  9. package/dist/NiceForm-DmU-gmyv.cjs +382 -0
  10. package/dist/NiceModal-BClAtR5T.js +95 -0
  11. package/dist/NiceModal-iKwtagFB.cjs +1 -0
  12. package/dist/NiceModuleLifecyclePanel-BO8Hw_W9.js +7619 -0
  13. package/dist/NiceModuleLifecyclePanel-Ch7HRRoy.cjs +1 -0
  14. package/dist/NicePagination-BVo-4KAD.js +172 -0
  15. package/dist/NicePagination-CaohvQsY.cjs +1 -0
  16. package/dist/NicePinCodeInput-DsyLuc0b.cjs +696 -0
  17. package/dist/NicePinCodeInput-nuRCN-9R.js +13223 -0
  18. package/dist/NiceSavedQueryPanel-BBFV4qiF.js +6969 -0
  19. package/dist/NiceSavedQueryPanel-CsiVNkCT.cjs +596 -0
  20. package/dist/NiceWindow-Cm9E6EAi.cjs +1 -0
  21. package/dist/NiceWindow-FMrVS7zo.js +1603 -0
  22. package/dist/charts-B90sSFeJ.cjs +761 -0
  23. package/dist/charts-DaLf19vS.js +4671 -0
  24. package/dist/charts.cjs +1 -1
  25. package/dist/charts.mjs +1 -1
  26. package/dist/core-BUTtIHg0.js +27766 -0
  27. package/dist/core-CESNSRyS.cjs +122 -0
  28. package/dist/data-branching-ByQdcjKO.cjs +1 -0
  29. package/dist/data-branching-psTzlcrT.js +6255 -0
  30. package/dist/data-branching.cjs +1 -1
  31. package/dist/data-branching.mjs +1 -1
  32. package/dist/data.cjs +1 -1
  33. package/dist/data.mjs +1 -1
  34. package/dist/devops-D7bQ3rE4.cjs +17 -0
  35. package/dist/devops-jCmpD6O-.js +8165 -0
  36. package/dist/devops.cjs +1 -1
  37. package/dist/devops.mjs +3 -3
  38. package/dist/editors.cjs +1 -1
  39. package/dist/editors.d.ts +4 -0
  40. package/dist/editors.mjs +3 -3
  41. package/dist/feedback.cjs +1 -1
  42. package/dist/feedback.mjs +3 -3
  43. package/dist/index-BpixglWg.js +69337 -0
  44. package/dist/index-DLR-aWZR.cjs +5506 -0
  45. package/dist/index.cjs +1 -1
  46. package/dist/index.css +1 -1
  47. package/dist/index.d.ts +359 -145
  48. package/dist/index.mjs +986 -976
  49. package/dist/lazy.cjs +1 -1
  50. package/dist/lazy.mjs +24 -24
  51. package/dist/navigation.cjs +1 -1
  52. package/dist/navigation.mjs +146 -146
  53. package/dist/no-code-BHo5WrXr.js +7425 -0
  54. package/dist/no-code-DyA_1_Th.cjs +332 -0
  55. package/dist/no-code.cjs +1 -1
  56. package/dist/no-code.mjs +1 -1
  57. package/dist/overlays.cjs +1 -1
  58. package/dist/overlays.d.ts +4 -0
  59. package/dist/overlays.mjs +66 -66
  60. package/dist/pickerCommons-BEc3pZ_s.js +2044 -0
  61. package/dist/pickerCommons-CrITwM88.cjs +1 -0
  62. package/dist/style.css +1 -1
  63. package/package.json +2 -2
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 }
@@ -5220,6 +5239,14 @@ export declare interface FuzzyMatch {
5220
5239
 
5221
5240
  export declare function fuzzyMatch(query: string, text: string): FuzzyMatch | null;
5222
5241
 
5242
+ export { GamepadAction }
5243
+
5244
+ export { GamepadAxis }
5245
+
5246
+ export { GamepadButton_2 as GamepadButton }
5247
+
5248
+ export { GamepadState }
5249
+
5223
5250
  /**
5224
5251
  * Gap analysis item.
5225
5252
  */
@@ -5830,9 +5857,10 @@ declare interface InboxComposeData {
5830
5857
  }
5831
5858
 
5832
5859
  /** A folder/label in the inbox. */
5833
- declare interface InboxFolder {
5860
+ export declare interface InboxFolder {
5834
5861
  id: string;
5835
5862
  name: string;
5863
+ /** NiceIcon name (from the built-in @nice2dev/ui-core icon set), e.g. `'mail'`, `'star'`, `'trash'`. */
5836
5864
  icon?: string;
5837
5865
  count?: number;
5838
5866
  }
@@ -7650,6 +7678,51 @@ export declare interface NiceAppManifest {
7650
7678
  tenantId?: string;
7651
7679
  }
7652
7680
 
7681
+ /**
7682
+ * {@link NiceAppShell} — reusable app chrome for richer, IDE/DAW-style tools:
7683
+ * a menubar, a tools toolbar, an optional sidebar, the content area and a status
7684
+ * bar. Built to be composed with `NiceMenu`, `NiceToolbar` and the content of
7685
+ * your choice (e.g. `NiceAudioStudio` builds on it).
7686
+ */
7687
+ export declare const NiceAppShell: default_2.ForwardRefExoticComponent<NiceAppShellProps & default_2.RefAttributes<HTMLDivElement>>;
7688
+
7689
+ /**
7690
+ * Props for {@link NiceAppShell} — a generic desktop-application frame
7691
+ * (menubar → toolbar → [sidebar | content] → status bar). Each region is an
7692
+ * optional slot; compose the menubar from a horizontal `NiceMenu` and the
7693
+ * toolbar from `NiceToolbar`. Theme-tokened and responsive.
7694
+ */
7695
+ export declare interface NiceAppShellProps extends NiceBaseProps {
7696
+ /** Top menubar row — typically a horizontal `NiceMenu` (File / Edit / View / Help). */
7697
+ menubar?: default_2.ReactNode;
7698
+ /** Tools toolbar row, below the menubar — typically a `NiceToolbar`. */
7699
+ toolbar?: default_2.ReactNode;
7700
+ /** Optional left sidebar (panels, track list, tool palette / tool rail). */
7701
+ sidebar?: default_2.ReactNode;
7702
+ /** Sidebar width in px. Default 220. */
7703
+ sidebarWidth?: number;
7704
+ /** Optional right panel (properties / inspector). */
7705
+ rightSidebar?: default_2.ReactNode;
7706
+ /** Right-panel width in px. Default 280. */
7707
+ rightSidebarWidth?: number;
7708
+ /** Main content area. */
7709
+ children?: default_2.ReactNode;
7710
+ /** Optional bottom panel between the content and the status bar (timeline, console, output). */
7711
+ bottomPanel?: default_2.ReactNode;
7712
+ /** Bottom-panel height in px. When omitted, the panel's own content drives its height. */
7713
+ bottomPanelHeight?: number;
7714
+ /** Bottom status bar. */
7715
+ statusBar?: default_2.ReactNode;
7716
+ /** Overall height (px or CSS value). Default `'100%'`. */
7717
+ height?: number | string;
7718
+ /**
7719
+ * Render the side panels "flush" — no shell padding/background/border and no
7720
+ * forced width, so a self-styled panel (e.g. an editor tool-rail / inspector)
7721
+ * controls its own look and size. Default false.
7722
+ */
7723
+ flush?: boolean;
7724
+ }
7725
+
7653
7726
  export { NiceAriaProps }
7654
7727
 
7655
7728
  export { NiceArrayDataSourceConfig }
@@ -7989,13 +8062,30 @@ export declare const NiceAvatar: default_2.FC<NiceAvatarProps>;
7989
8062
 
7990
8063
  export declare const NiceAvatarGroup: default_2.FC<NiceAvatarGroupProps>;
7991
8064
 
7992
- /** Props for the {@link NiceAvatarGroup} component — stacks multiple {@link NiceAvatar} elements with a "+N" overflow indicator. */
8065
+ /** A single data-driven avatar in a {@link NiceAvatarGroup}. */
8066
+ declare interface NiceAvatarGroupItem {
8067
+ /** Image URL. When omitted, initials from `name` are shown. */
8068
+ src?: string;
8069
+ /** Display name (used for initials, alt text and the title tooltip). */
8070
+ name?: string;
8071
+ /** Makes the avatar a link to this URL. */
8072
+ href?: string;
8073
+ /** Click handler (makes the avatar a button when there is no `href`). */
8074
+ onClick?: () => void;
8075
+ }
8076
+
8077
+ /** Props for the {@link NiceAvatarGroup} component — stacks multiple avatars with a "+N" overflow indicator. */
7993
8078
  export declare interface NiceAvatarGroupProps extends NiceStandardProps {
7994
- /** Avatar group size. */
8079
+ /** Avatar group size — propagated to every avatar (and the +N chip). */
7995
8080
  size?: NiceSize;
7996
- /** NiceAvatar elements to display. */
7997
- children: default_2.ReactNode;
7998
- /** Maximum visible avatars before the overflow counter appears. */
8081
+ /** NiceAvatar elements to display (alternative to `items`). */
8082
+ children?: default_2.ReactNode;
8083
+ /**
8084
+ * Data-driven avatars (alternative to `children`). Each entry can be made
8085
+ * clickable via `href` (link) or `onClick` (button).
8086
+ */
8087
+ items?: NiceAvatarGroupItem[];
8088
+ /** Maximum visible avatars before the "+N" overflow counter appears. */
7999
8089
  max?: number;
8000
8090
  }
8001
8091
 
@@ -8181,19 +8271,31 @@ export declare interface NiceBadgeProps extends NiceStandardProps {
8181
8271
  dot?: boolean;
8182
8272
  /** Render with an outlined border instead of a filled background. */
8183
8273
  outline?: boolean;
8274
+ /** Soft tinted background with accent-coloured text (instead of a solid fill). */
8275
+ subtle?: boolean;
8276
+ /** Gently pulse to draw attention (e.g. live status). Respects prefers-reduced-motion. */
8277
+ pulse?: boolean;
8278
+ /** Optional icon rendered before the content. */
8279
+ icon?: default_2.ReactNode;
8184
8280
  /** Show a remove ("x") button inside the badge. */
8185
8281
  removable?: boolean;
8186
8282
  /** Called when the remove button is clicked. */
8187
8283
  onRemove?: () => void;
8188
8284
  }
8189
8285
 
8286
+ export declare const NiceBarcode: ForwardRefExoticComponent<NiceBarcodeProps & RefAttributes<HTMLCanvasElement>>;
8287
+
8190
8288
  /** Supported barcode symbologies. */
8191
8289
  export declare type NiceBarcodeFormat = 'CODE128' | 'CODE39' | 'EAN13' | 'EAN8' | 'UPC' | 'ITF14' | 'MSI' | 'codabar';
8192
8290
 
8193
- export declare const NiceBarcodeGenerator: ForwardRefExoticComponent<NiceBarcodeGeneratorProps & RefAttributes<HTMLCanvasElement>>;
8291
+ /** @deprecated Renamed to {@link NiceBarcode}. Kept as an alias for backward compatibility. */
8292
+ export declare const NiceBarcodeGenerator: ForwardRefExoticComponent<NiceBarcodeProps & RefAttributes<HTMLCanvasElement>>;
8194
8293
 
8195
- /** Props for the {@link NiceBarcodeGenerator} component — renders a barcode on a `<canvas>`. */
8196
- export declare interface NiceBarcodeGeneratorProps extends NiceStandardProps {
8294
+ /** @deprecated Renamed to {@link NiceBarcodeProps}. */
8295
+ export declare type NiceBarcodeGeneratorProps = NiceBarcodeProps;
8296
+
8297
+ /** Props for the {@link NiceBarcode} component — renders a barcode on a `<canvas>`. */
8298
+ export declare interface NiceBarcodeProps extends NiceStandardProps {
8197
8299
  /** Text value to encode. */
8198
8300
  value: string;
8199
8301
  /** Barcode symbology (default CODE128). */
@@ -8214,6 +8316,15 @@ export declare interface NiceBarcodeGeneratorProps extends NiceStandardProps {
8214
8316
  fontSize?: number;
8215
8317
  /** Component size preset. */
8216
8318
  size?: NiceSize;
8319
+ /**
8320
+ * Render an editable {@link NiceTextInput} above the barcode that live-encodes
8321
+ * what the user types. Off by default — pass `showInput` to enable.
8322
+ */
8323
+ showInput?: boolean;
8324
+ /** Label for the built-in input (only when `showInput`). */
8325
+ inputLabel?: string;
8326
+ /** Placeholder for the built-in input (only when `showInput`). */
8327
+ inputPlaceholder?: string;
8217
8328
  }
8218
8329
 
8219
8330
  export declare const NiceBarGauge: default_2.FC<NiceBarGaugeProps>;
@@ -8287,6 +8398,10 @@ export declare interface NiceBlockUIProps extends NiceBaseProps {
8287
8398
  blocked: boolean;
8288
8399
  /** Custom overlay message or spinner. */
8289
8400
  message?: default_2.ReactNode;
8401
+ /** Show a built-in loading spinner above the message. */
8402
+ spinner?: boolean;
8403
+ /** Blur the blocked content beneath the overlay. */
8404
+ blur?: boolean;
8290
8405
  /** Content to be blocked. */
8291
8406
  children: default_2.ReactNode;
8292
8407
  }
@@ -8470,8 +8585,15 @@ declare type NiceBulletState = 'normal' | 'loading' | 'error';
8470
8585
  */
8471
8586
  export declare const NiceBusinessCard: default_2.ForwardRefExoticComponent<NiceBusinessCardProps & default_2.RefAttributes<HTMLDivElement>>;
8472
8587
 
8473
- /** Props for the {@link NiceBusinessCard} component. */
8474
- export declare interface NiceBusinessCardProps extends NiceFormFieldProps {
8588
+ /**
8589
+ * Props for the {@link NiceBusinessCard} component.
8590
+ *
8591
+ * NiceBusinessCard is a display component, not a form input — it deliberately
8592
+ * does NOT extend `NiceFormFieldProps` so the showcase catalog does not surface
8593
+ * input-only STATE toggles (disabled/readOnly/loading/error) for it. The few
8594
+ * state-ish props below exist only for the optional inline-edit mode.
8595
+ */
8596
+ export declare interface NiceBusinessCardProps {
8475
8597
  /** Business entity data. */
8476
8598
  data: BusinessCardData;
8477
8599
  /** Whether to render in edit mode. */
@@ -8488,6 +8610,22 @@ export declare interface NiceBusinessCardProps extends NiceFormFieldProps {
8488
8610
  showLogo?: boolean;
8489
8611
  /** Whether to show bank details. */
8490
8612
  showBankDetails?: boolean;
8613
+ /** Card size (scales fonts and spacing). */
8614
+ size?: NiceSize;
8615
+ /** Optional caption rendered by a consuming form layout. */
8616
+ label?: default_2.ReactNode;
8617
+ /** Helper text rendered under the card. */
8618
+ helperText?: default_2.ReactNode;
8619
+ /** Error message rendered under the card. */
8620
+ error?: string | boolean;
8621
+ /** Dim the card and disable inputs while in edit mode. */
8622
+ disabled?: boolean;
8623
+ /** Read-only — hides the edit toggle. */
8624
+ readOnly?: boolean;
8625
+ className?: string;
8626
+ style?: default_2.CSSProperties;
8627
+ accessMode?: NiceAccessMode;
8628
+ id?: string;
8491
8629
  }
8492
8630
 
8493
8631
  export declare const NiceButton: default_2.ForwardRefExoticComponent<NiceButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
@@ -8549,6 +8687,8 @@ export declare interface NiceButtonProps extends NiceBaseProps {
8549
8687
  error?: default_2.ReactNode;
8550
8688
  /** Where to display the error: 'bottom' (default) or 'right'. */
8551
8689
  errorPlacement?: 'bottom' | 'right';
8690
+ /** Accessible label — applied as `aria-label` (use for icon-only buttons). */
8691
+ ariaLabel?: string;
8552
8692
  }
8553
8693
 
8554
8694
  export { NiceCacheConfig }
@@ -8643,6 +8783,29 @@ export declare interface NiceCardGridProps extends NiceStandardProps {
8643
8783
  hoverable?: boolean;
8644
8784
  }
8645
8785
 
8786
+ /**
8787
+ * {@link NiceCardGroup} — themed, responsive CSS-grid layout for a set of cards.
8788
+ */
8789
+ export declare const NiceCardGroup: default_2.ForwardRefExoticComponent<NiceCardGroupProps & default_2.RefAttributes<HTMLDivElement>>;
8790
+
8791
+ /**
8792
+ * Props for {@link NiceCardGroup} — a responsive grid container for cards (or any
8793
+ * tiles). By default it auto-fills as many `minColumnWidth`-wide columns as fit
8794
+ * and wraps responsively; pass `columns` to pin an exact column count.
8795
+ */
8796
+ export declare interface NiceCardGroupProps extends NiceStandardProps {
8797
+ /** Cards / tiles to lay out. */
8798
+ children: default_2.ReactNode;
8799
+ /** Minimum column width (px) for the auto-fill grid. Default 240. */
8800
+ minColumnWidth?: number;
8801
+ /** Fixed column count — overrides `minColumnWidth` auto-fill when set. */
8802
+ columns?: number;
8803
+ /** Gap between cards (px). Default 12. */
8804
+ gap?: number;
8805
+ /** Vertical alignment of items within a row. */
8806
+ align?: 'stretch' | 'start' | 'center' | 'end';
8807
+ }
8808
+
8646
8809
  /** Props for the {@link NiceCard} component — a bordered content container with optional header and footer. */
8647
8810
  export declare interface NiceCardProps extends NiceBaseProps {
8648
8811
  /** Card size. */
@@ -9625,6 +9788,10 @@ export declare interface NiceColorPickerProps extends NiceFormFieldProps {
9625
9788
  /** When true, the popup includes an alpha (transparency) slider and the
9626
9789
  * emitted value uses 8-character hex `#RRGGBBAA`. Default: `false`. */
9627
9790
  withAlpha?: boolean;
9791
+ /** Compact inline layout: swatch + hex on a single tight row and the
9792
+ * "Random" button hidden, so many fields can sit side-by-side in a grid.
9793
+ * Default: `false`. */
9794
+ compact?: boolean;
9628
9795
  }
9629
9796
 
9630
9797
  export declare type NiceColorPreset = 'lightest-pastel' | 'bright-pastel' | 'shiny' | 'pastel' | 'full' | 'dark' | 'deep' | 'muted' | 'earth';
@@ -11424,6 +11591,82 @@ export declare interface NiceDeviceControlCardProps extends NiceBaseProps {
11424
11591
  controlLayout?: ControlLayout;
11425
11592
  }
11426
11593
 
11594
+ export declare type NiceDeviceKind = 'microphone' | 'gamepad';
11595
+
11596
+ export declare type NiceDeviceLabelPlacement = 'top' | 'bottom' | 'left' | 'right';
11597
+
11598
+ export declare const NiceDeviceManager: default_2.FC<NiceDeviceManagerProps>;
11599
+
11600
+ export declare interface NiceDeviceManagerProps extends NiceBaseProps {
11601
+ devices?: NiceManagedDevice[];
11602
+ defaultDevices?: NiceManagedDevice[];
11603
+ onDevicesChange?: (devices: NiceManagedDevice[]) => void;
11604
+ /** Auto-detect connected mics + gamepads (default true). */
11605
+ autoDetect?: boolean;
11606
+ /** Which device kinds to manage (default both). */
11607
+ kinds?: NiceDeviceKind[];
11608
+ /** Slots (players/roles) devices can be assigned to. */
11609
+ slots?: NiceDeviceSlot[];
11610
+ onAssign?: (deviceId: string, slotId: string | null) => void;
11611
+ onOpenConfig?: (device: NiceManagedDevice) => void;
11612
+ columns?: number;
11613
+ minColumnWidth?: number;
11614
+ }
11615
+
11616
+ export declare interface NiceDeviceSlot {
11617
+ id: string;
11618
+ label: string;
11619
+ color?: string;
11620
+ }
11621
+
11622
+ export declare const NiceDeviceTile: default_2.ForwardRefExoticComponent<NiceDeviceTileProps & default_2.RefAttributes<HTMLDivElement>>;
11623
+
11624
+ export declare interface NiceDeviceTileProps extends NiceBaseProps {
11625
+ /** The device SVG (microphone / gamepad). */
11626
+ children: default_2.ReactNode;
11627
+ /** Primary label (line 1, small). */
11628
+ name?: string;
11629
+ /** Secondary label (line 2, very small) — also editable from the popover. */
11630
+ description?: string;
11631
+ defaultDescription?: string;
11632
+ onDescriptionChange?: (text: string) => void;
11633
+ /** Caption placement relative to the device (default 'bottom', centered). */
11634
+ labelPlacement?: NiceDeviceLabelPlacement;
11635
+ /** Index/number badge shown on the tile. */
11636
+ number?: number | string;
11637
+ /** Device tint. Default `'transparent'` → only the device outline shows. */
11638
+ color?: string;
11639
+ onColorChange?: (color: string) => void;
11640
+ volume?: number;
11641
+ defaultVolume?: number;
11642
+ onVolumeChange?: (v: number) => void;
11643
+ gain?: number;
11644
+ defaultGain?: number;
11645
+ onGainChange?: (v: number) => void;
11646
+ /** Enable the right-click quick-settings popover (default true). */
11647
+ contextMenu?: boolean;
11648
+ /** Which quick controls appear in the popover. */
11649
+ quickControls?: NiceDeviceTileQuickControls;
11650
+ /** "Full configuration" button handler (omit to hide the button). */
11651
+ onOpenConfig?: () => void;
11652
+ fullConfigLabel?: string;
11653
+ selected?: boolean;
11654
+ onClick?: () => void;
11655
+ /** Register with a surrounding NiceSpatialNavProvider under this id. */
11656
+ focusId?: string;
11657
+ }
11658
+
11659
+ export declare interface NiceDeviceTileQuickControls {
11660
+ /** Show the color picker row (default true). */
11661
+ color?: boolean;
11662
+ /** Show the description field (default true). */
11663
+ description?: boolean;
11664
+ /** Show the volume slider (default true). */
11665
+ volume?: boolean;
11666
+ /** Show the gain slider (default true). */
11667
+ gain?: boolean;
11668
+ }
11669
+
11427
11670
  export declare function NiceDiagramDesigner({ initialSchema, onChange, onExport, className, style, tutorial, }: NiceDiagramDesignerProps): JSX.Element;
11428
11671
 
11429
11672
  export declare interface NiceDiagramDesignerProps {
@@ -12870,6 +13113,10 @@ export declare interface NiceFloorPlanCanvasProps extends NiceBaseProps {
12870
13113
  animateStateChanges?: boolean;
12871
13114
  }
12872
13115
 
13116
+ export { NiceFocusable }
13117
+
13118
+ export { NiceFocusableProps }
13119
+
12873
13120
  /**
12874
13121
  * Cycles Tab / Shift+Tab between the first and last focusable
12875
13122
  * descendants. Use inside modals, dialogs, drawers — anywhere
@@ -13209,6 +13456,30 @@ export declare interface NiceGalleryProps extends NiceStandardProps {
13209
13456
  thumbnailWindow?: number;
13210
13457
  }
13211
13458
 
13459
+ export declare const NiceGamepad: default_2.FC<NiceGamepadProps>;
13460
+
13461
+ export declare interface NiceGamepadProps extends Omit<NiceDeviceTileProps, 'children'> {
13462
+ /** 'compact' = micro silhouette icon (default); 'full' = labeled layout. */
13463
+ view?: 'full' | 'compact';
13464
+ /** Icon size: px or a NiceSize preset (default 'md'). */
13465
+ size?: number | NiceSize;
13466
+ /** Fired when a button is pressed (click or live). */
13467
+ onButtonPress?: (button: GamepadButton_2) => void;
13468
+ /** Controlled momentary-press highlight. */
13469
+ pressedButtons?: GamepadButton_2[];
13470
+ /** Persistent highlight (e.g. to point out a button). */
13471
+ highlightedButtons?: GamepadButton_2[];
13472
+ /** Reflect a live physical controller via ui-core useGamepad. */
13473
+ live?: boolean;
13474
+ gamepadIndex?: number;
13475
+ /** Per-button text labels (full view). */
13476
+ buttonLabels?: Partial<Record<GamepadButton_2, string>>;
13477
+ /** Optional action tree to assign to buttons (full view). */
13478
+ actionTree?: NiceTreeNode[];
13479
+ assignments?: Partial<Record<GamepadButton_2, string>>;
13480
+ onAssign?: (button: GamepadButton_2, node: NiceTreeNode) => void;
13481
+ }
13482
+
13212
13483
  export declare const NiceGantt: default_2.FC<NiceGanttProps>;
13213
13484
 
13214
13485
  /** A table column shown in the {@link NiceGantt} left panel. */
@@ -14013,7 +14284,7 @@ export declare interface NiceImageViewerProps extends NiceStandardProps {
14013
14284
  }
14014
14285
 
14015
14286
  /**
14016
- * {@link NiceInbox} � Full-featured email inbox with reading pane, compose, folders,
14287
+ * {@link NiceInbox} — Full-featured email inbox with reading pane, compose, folders,
14017
14288
  * batch actions, sorting, search, and keyboard navigation.
14018
14289
  */
14019
14290
  export declare const NiceInbox: default_2.ForwardRefExoticComponent<NiceInboxProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -15401,6 +15672,23 @@ export declare interface NiceMAMProps extends NiceBaseProps {
15401
15672
  children?: ReactNode;
15402
15673
  }
15403
15674
 
15675
+ export declare interface NiceManagedDevice {
15676
+ id: string;
15677
+ kind: NiceDeviceKind;
15678
+ name?: string;
15679
+ description?: string;
15680
+ number?: number;
15681
+ /** Device tint; default transparent (outline only). */
15682
+ color?: string;
15683
+ /** mediaDevices deviceId (mic) or gamepad index id. */
15684
+ deviceId?: string;
15685
+ volume?: number;
15686
+ gain?: number;
15687
+ /** Live mic level 0..1 (fed by the consumer). */
15688
+ level?: number;
15689
+ assignedTo?: string | null;
15690
+ }
15691
+
15404
15692
  export declare const NiceMap: default_2.ForwardRefExoticComponent<NiceMapProps & default_2.RefAttributes<HTMLDivElement>>;
15405
15693
 
15406
15694
  export declare const NiceMapChart: default_2.FC<NiceMapChartProps>;
@@ -15874,6 +16162,17 @@ export declare interface NiceMergeRequestBuilderProps extends NiceBaseProps {
15874
16162
  tutorial?: NiceComponentTutorial;
15875
16163
  }
15876
16164
 
16165
+ export declare const NiceMicrophone: default_2.FC<NiceMicrophoneProps>;
16166
+
16167
+ export declare interface NiceMicrophoneProps extends Omit<NiceDeviceTileProps, 'children'> {
16168
+ /** Audio level 0..1 — fills the mic head from the bottom. */
16169
+ level?: number;
16170
+ /** Icon size: px or a NiceSize preset (default 'md'). */
16171
+ size?: number | NiceSize;
16172
+ /** Muted: dims the fill and shows a slash. */
16173
+ muted?: boolean;
16174
+ }
16175
+
15877
16176
  export declare const NiceModal: default_2.FC<NiceModalProps>;
15878
16177
 
15879
16178
  /** Props for the {@link NiceModal} component — a dialog overlay with focus trapping. */
@@ -16721,6 +17020,14 @@ export declare interface NiceNavShellProps {
16721
17020
  className?: string;
16722
17021
  contentClassName?: string;
16723
17022
  'data-testid'?: string;
17023
+ /**
17024
+ * Opt-in: wrap the shell in a {@link NiceSpatialNavProvider} so keyboard
17025
+ * arrows / a gamepad d-pad can navigate focusable controls (registered via
17026
+ * `useSpatialFocusable` / `<NiceFocusable>`). Default false.
17027
+ */
17028
+ spatialNavigation?: boolean;
17029
+ /** Options forwarded to NiceSpatialNavProvider when `spatialNavigation` is on. */
17030
+ spatialNavigationProps?: Omit<NiceSpatialNavProviderProps, 'children'>;
16724
17031
  }
16725
17032
 
16726
17033
  export declare interface NiceNavShellTab {
@@ -16796,36 +17103,6 @@ export declare interface NiceNotificationCategory {
16796
17103
  examples?: string[];
16797
17104
  }
16798
17105
 
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
17106
  export declare interface NiceNotificationChannel {
16830
17107
  id: string;
16831
17108
  name: string;
@@ -16905,10 +17182,14 @@ export declare interface NiceNotificationsProps {
16905
17182
  maxHeight?: number;
16906
17183
  /** Show "Mark all as read" link in panel header. Default: true. */
16907
17184
  showMarkAllRead?: boolean;
17185
+ /** Show a "Clear all" (bulk-dismiss) link in the panel header. Default: false. */
17186
+ showClearAll?: boolean;
16908
17187
  /** Show "View all" link at panel footer. Default: false. */
16909
17188
  showViewAll?: boolean;
16910
17189
  /** Mark-all-as-read handler. */
16911
17190
  onMarkAllRead?: () => void;
17191
+ /** Bulk-dismiss handler — fires when "Clear all" is clicked. */
17192
+ onClearAll?: () => void;
16912
17193
  /** View-all handler. */
16913
17194
  onViewAll?: () => void;
16914
17195
  /** Per-item read-toggle handler (called when user marks an item read). */
@@ -17019,6 +17300,8 @@ export declare interface NiceNumericInputProps extends NiceStandardProps {
17019
17300
  format?: string | ((value: number) => string);
17020
17301
  /** Render the +/- step buttons. */
17021
17302
  showButtons?: boolean;
17303
+ /** Visual size. `'xs'` is the most compact (for dense rows); default `'md'`. */
17304
+ size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
17022
17305
  /** Placeholder shown when the value is empty (uncontrolled / undefined). */
17023
17306
  placeholder?: string;
17024
17307
  /** Disable input + buttons. */
@@ -17328,7 +17611,7 @@ export declare interface NiceParagraphProps extends Omit<NiceStandardProps, 'siz
17328
17611
  muted?: boolean;
17329
17612
  }
17330
17613
 
17331
- export declare type NiceParagraphSize = 'sm' | 'md' | 'lg';
17614
+ export declare type NiceParagraphSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
17332
17615
 
17333
17616
  export declare const NicePasswordInput: default_2.ForwardRefExoticComponent<NicePasswordInputProps & default_2.RefAttributes<HTMLInputElement>>;
17334
17617
 
@@ -18151,6 +18434,15 @@ export declare interface NiceQRCodeProps extends NiceStandardProps {
18151
18434
  logo?: string;
18152
18435
  /** Logo dimensions in pixels. */
18153
18436
  logoSize?: number;
18437
+ /**
18438
+ * Render an editable {@link NiceTextInput} above the code that live-encodes
18439
+ * what the user types. Off by default — pass `showInput` to enable.
18440
+ */
18441
+ showInput?: boolean;
18442
+ /** Label for the built-in input (only when `showInput`). */
18443
+ inputLabel?: string;
18444
+ /** Placeholder for the built-in input (only when `showInput`). */
18445
+ inputPlaceholder?: string;
18154
18446
  }
18155
18447
 
18156
18448
  /** Reed-Solomon error correction level for QR codes. */
@@ -20453,6 +20745,12 @@ export declare interface NiceSparklineProps extends NiceStandardProps {
20453
20745
  showLastPoint?: boolean;
20454
20746
  }
20455
20747
 
20748
+ export { NiceSpatialNavContextValue }
20749
+
20750
+ export { NiceSpatialNavProvider }
20751
+
20752
+ export { NiceSpatialNavProviderProps }
20753
+
20456
20754
  export declare const NiceSpeechToText: default_2.ForwardRefExoticComponent<NiceSpeechToTextProps & default_2.RefAttributes<HTMLDivElement>>;
20457
20755
 
20458
20756
  /** Props for the {@link NiceSpeechToText} component — a browser Speech Recognition toggle button. */
@@ -20471,6 +20769,8 @@ export declare interface NiceSpeechToTextProps extends NiceBaseProps {
20471
20769
  label?: string;
20472
20770
  /** Button label when actively listening. */
20473
20771
  activeLabel?: string;
20772
+ /** Show the visible text label next to the icon. Defaults to `false` (icon-only). The aria-label is always present. */
20773
+ showLabel?: boolean;
20474
20774
  }
20475
20775
 
20476
20776
  export declare const NiceSpeedDialAction: default_2.FC<NiceSpeedDialProps>;
@@ -20764,39 +21064,6 @@ export declare interface NiceStatisticTrend {
20764
21064
  direction: 'up' | 'down';
20765
21065
  }
20766
21066
 
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
21067
  export declare const NiceStepper: default_2.FC<NiceStepperProps>;
20801
21068
 
20802
21069
  /** Props for the {@link NiceStepper} component — a step indicator / wizard with horizontal or vertical orientation. */
@@ -21498,10 +21765,8 @@ export { niceThemeBootstrap }
21498
21765
 
21499
21766
  export { NiceThemeBorders }
21500
21767
 
21501
- export declare const NiceThemeBuilder: default_2.ForwardRefExoticComponent<NiceThemeBuilderProps & default_2.RefAttributes<HTMLDivElement>>;
21502
-
21503
21768
  /** 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 {
21769
+ declare interface NiceThemeBuilderProps extends NiceBaseProps {
21505
21770
  /** Initial theme to edit (defaults to Light) */
21506
21771
  theme?: NiceTheme;
21507
21772
  /** Preset themes to offer in the picker */
@@ -21527,7 +21792,7 @@ export declare interface NiceThemeBuilderProps extends NiceBaseProps {
21527
21792
  }
21528
21793
 
21529
21794
  /** Editable sections in the {@link NiceThemeBuilder}. */
21530
- export declare type NiceThemeBuilderSection = 'general' | 'colors' | 'backgrounds' | 'background-image' | 'text' | 'borders' | 'spacing' | 'typography' | 'shadows' | 'transitions' | 'nesting';
21795
+ declare type NiceThemeBuilderSection = 'general' | 'colors' | 'backgrounds' | 'background-image' | 'text' | 'borders' | 'spacing' | 'typography' | 'shadows' | 'transitions' | 'nesting';
21531
21796
 
21532
21797
  export { NiceThemeColors }
21533
21798
 
@@ -24303,45 +24568,6 @@ declare interface NiceXLSXOptions extends NiceExportOptions {
24303
24568
  }>;
24304
24569
  }
24305
24570
 
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
24571
  /**
24346
24572
  * Node shape types
24347
24573
  */
@@ -24350,26 +24576,6 @@ export declare type NodeShape = 'rectangle' | 'rounded-rectangle' | 'circle' | '
24350
24576
  /** Prevent importing entire library — enforce tree-shaking. */
24351
24577
  export declare const noFullImport: ESLintRule;
24352
24578
 
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
24579
  /**
24374
24580
  * usePushNotifications — Push notification subscription management
24375
24581
  *
@@ -24408,9 +24614,6 @@ export declare interface NotificationEntry {
24408
24614
  */
24409
24615
  declare type NotificationPermission_2 = 'default' | 'granted' | 'denied';
24410
24616
 
24411
- /** Type of notification. */
24412
- export declare type NotificationType = 'info' | 'success' | 'warning' | 'error' | 'task' | 'mention' | 'system';
24413
-
24414
24617
  export declare interface OAuthConfigTemplate {
24415
24618
  authorizationUrl: string;
24416
24619
  tokenUrl: string;
@@ -26683,6 +26886,8 @@ export declare interface SpatialAnnotation {
26683
26886
  createdBy?: string;
26684
26887
  }
26685
26888
 
26889
+ export { SpatialFocusableMeta }
26890
+
26686
26891
  /** Speaker definition */
26687
26892
  export declare interface Speaker {
26688
26893
  id: string;
@@ -26763,9 +26968,6 @@ declare interface StateSlice {
26763
26968
  computed?: ComputedField[];
26764
26969
  }
26765
26970
 
26766
- /** Predefined status semantic categories. */
26767
- export declare type StatusCategory = 'success' | 'warning' | 'error' | 'info' | 'neutral' | 'custom';
26768
-
26769
26971
  export { StorageAdapter }
26770
26972
 
26771
26973
  export { StorageAuditResult }
@@ -28363,6 +28565,10 @@ export { useFocusTrap }
28363
28565
 
28364
28566
  export { useFormGeneration }
28365
28567
 
28568
+ export { useGamepad }
28569
+
28570
+ export { UseGamepadOptions }
28571
+
28366
28572
  export { useGridPreferences }
28367
28573
 
28368
28574
  /**
@@ -28797,6 +29003,14 @@ export declare function useSidebarPrefsScope(overrides?: SidebarPrefsScopeValue)
28797
29003
  /** Shortcut for pages that only need the userId. */
28798
29004
  export declare function useSidebarUserId(override?: string): string | undefined;
28799
29005
 
29006
+ export { useSpatialFocusable }
29007
+
29008
+ export { UseSpatialFocusableOptions }
29009
+
29010
+ export { useSpatialNav }
29011
+
29012
+ export { useSpatialNavOptional }
29013
+
28800
29014
  /**
28801
29015
  * Hook to get a namespaced storage adapter.
28802
29016
  */