@nice2dev/ui 1.1.9 → 1.2.0

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 (163) hide show
  1. package/CHANGELOG.md +150 -0
  2. package/README.md +27 -34
  3. package/dist/NiceButton-5tWvfXKl.cjs +1 -0
  4. package/dist/NiceButton-DHSgQT1_.js +112 -0
  5. package/dist/NiceCodeEditor-B8At55f5.js +1179 -0
  6. package/dist/NiceCodeEditor-BJSEzhcY.cjs +260 -0
  7. package/dist/NiceCodeEditor-BfkH1bsZ.cjs +260 -0
  8. package/dist/NiceCodeEditor-CduGYggj.js +1179 -0
  9. package/dist/NiceColorPicker-CdUnhM-A.cjs +1 -0
  10. package/dist/NiceColorPicker-DCgmE-3H.cjs +1 -0
  11. package/dist/NiceColorPicker-DK30kJgy.js +486 -0
  12. package/dist/NiceColorPicker-DpXwnDwL.js +598 -0
  13. package/dist/NiceColorPicker-DtPFxDKM.cjs +1 -0
  14. package/dist/NiceColorPicker-bNJBAU_c.js +598 -0
  15. package/dist/NiceConfirmDialog-B7aNRL2K.cjs +1 -0
  16. package/dist/NiceConfirmDialog-BdhWenrO.js +81 -0
  17. package/dist/NiceDataGrid-BOCJr6XF.js +2217 -0
  18. package/dist/NiceDataGrid-BV5Oh-gy.cjs +10 -0
  19. package/dist/NiceDataGrid-CVYEo_nv.cjs +10 -0
  20. package/dist/NiceDataGrid-D-rm4lu8.js +2217 -0
  21. package/dist/NiceDataGrid-Dd7SI-M6.cjs +10 -0
  22. package/dist/NiceDataGrid-DjZchXYG.js +2217 -0
  23. package/dist/NiceDocumentViewer-BgcgLWJ3.cjs +180 -0
  24. package/dist/NiceDocumentViewer-sukmGhRx.js +672 -0
  25. package/dist/NiceForm-BCEXovJR.cjs +1 -0
  26. package/dist/NiceForm-D7oyWHXg.js +4820 -0
  27. package/dist/NiceForm-DUhxXArr.js +4817 -0
  28. package/dist/NiceForm-DVc0Xoly.js +4819 -0
  29. package/dist/NiceForm-qD_RKPYz.cjs +1 -0
  30. package/dist/NiceForm-uCeVmTrD.cjs +1 -0
  31. package/dist/NiceGantt-4UBd4uJ8.cjs +1 -0
  32. package/dist/NiceGantt-B_1lwEsp.js +328 -0
  33. package/dist/NiceHtmlEditor-BYk1roA4.cjs +10 -0
  34. package/dist/NiceHtmlEditor-Bce9Vwe1.cjs +10 -0
  35. package/dist/NiceHtmlEditor-C5kLeF9H.cjs +10 -0
  36. package/dist/NiceHtmlEditor-CFVMIC5L.js +848 -0
  37. package/dist/NiceHtmlEditor-CGRgcu2h.js +848 -0
  38. package/dist/NiceHtmlEditor-mWebBmy1.js +849 -0
  39. package/dist/NiceLoginForm-BHyDY7br.cjs +1 -0
  40. package/dist/NiceLoginForm-BTuQ0eKk.cjs +1 -0
  41. package/dist/NiceLoginForm-BuxFY2Rk.js +750 -0
  42. package/dist/NiceLoginForm-o1A-TBcp.js +736 -0
  43. package/dist/NiceLoginForm.css +1 -0
  44. package/dist/NiceMention-CA7CL5BI.js +11263 -0
  45. package/dist/NiceMention-CHcKRl-L.cjs +430 -0
  46. package/dist/NiceMention-DJD0BLcp.js +11269 -0
  47. package/dist/NiceMention-DcaUEMSg.cjs +430 -0
  48. package/dist/NiceMention-Dds9GQzk.cjs +430 -0
  49. package/dist/NiceMention-DlLXWddO.js +11268 -0
  50. package/dist/NiceMention.css +1 -1
  51. package/dist/NiceModal-C4p8a82e.cjs +1 -0
  52. package/dist/NiceModal-Dr1e3nQZ.cjs +1 -0
  53. package/dist/NiceModal-TNlkaL_i.js +85 -0
  54. package/dist/NiceModal-sihGCfDy.js +95 -0
  55. package/dist/NiceModuleLifecyclePanel-BWbKdVC_.js +7054 -0
  56. package/dist/NiceModuleLifecyclePanel-CZHIzvkE.cjs +1 -0
  57. package/dist/NiceModuleLifecyclePanel-Du7G3-RG.js +7053 -0
  58. package/dist/NiceModuleLifecyclePanel-OC9YK2kG.js +7052 -0
  59. package/dist/NiceModuleLifecyclePanel-_OcfDmtC.cjs +1 -0
  60. package/dist/NiceModuleLifecyclePanel-js1p7LIY.cjs +1 -0
  61. package/dist/NicePagination-8XsBbMNx.js +165 -0
  62. package/dist/NicePagination-CkOoXf0f.js +165 -0
  63. package/dist/NicePagination-D44waj9o.cjs +1 -0
  64. package/dist/NicePagination-D7lek1G7.cjs +1 -0
  65. package/dist/NicePagination-DdxH8KMG.js +179 -0
  66. package/dist/NicePagination-OjTEfZJE.cjs +1 -0
  67. package/dist/NicePivotGrid-B2YHP3Z6.js +1183 -0
  68. package/dist/NicePivotGrid-BJRSciWl.js +1183 -0
  69. package/dist/NicePivotGrid-BtVUWiud.cjs +152 -0
  70. package/dist/NicePivotGrid-CS1dPmNI.cjs +152 -0
  71. package/dist/NicePivotGrid-D2AxqDzJ.js +1183 -0
  72. package/dist/NicePivotGrid-DxQ6Py9D.cjs +152 -0
  73. package/dist/NiceSavedQueryPanel-B5HhqlAI.cjs +586 -0
  74. package/dist/NiceSavedQueryPanel-C0A-eoYN.js +5142 -0
  75. package/dist/NiceSavedQueryPanel-CMStDOKe.js +5125 -0
  76. package/dist/NiceSavedQueryPanel-D2i34e_b.cjs +586 -0
  77. package/dist/NiceSavedQueryPanel-ZrilZRtf.cjs +586 -0
  78. package/dist/NiceSavedQueryPanel-mPO2THs7.js +5142 -0
  79. package/dist/NiceSavedQueryPanel.css +1 -1
  80. package/dist/NiceScheduler-7gP7vcLy.cjs +5 -0
  81. package/dist/NiceScheduler-Cy7F9tgH.js +1693 -0
  82. package/dist/NiceScheduler-DquRUZxD.cjs +5 -0
  83. package/dist/NiceScheduler-KSzaUQxC.js +1693 -0
  84. package/dist/NiceScheduler-O3AwmdGG.cjs +5 -0
  85. package/dist/NiceScheduler-l8N4yCWd.js +1716 -0
  86. package/dist/NiceSelect-BCbWtu1v.js +433 -0
  87. package/dist/NiceSelect-BqtiQbfD.cjs +1 -0
  88. package/dist/NiceSelect-DZB1Rs9x.js +435 -0
  89. package/dist/NiceSelect-tMz9QQUs.cjs +1 -0
  90. package/dist/NiceStreamDashboard.doc-74KUXya1.cjs +8 -0
  91. package/dist/NiceStreamDashboard.doc-k8PQfCM0.js +32 -0
  92. package/dist/NiceWindow-BEov3s9F.js +2094 -0
  93. package/dist/NiceWindow-BU1Ce7gS.js +1623 -0
  94. package/dist/NiceWindow-CDt6PCEg.cjs +1 -0
  95. package/dist/NiceWindow-jjdE6vGy.cjs +1 -0
  96. package/dist/NiceWindow.css +1 -1
  97. package/dist/charts-C047IMVn.cjs +768 -0
  98. package/dist/charts-C44vJber.cjs +768 -0
  99. package/dist/charts-CCXSb3xk.js +4752 -0
  100. package/dist/charts-CqETcUhH.js +4752 -0
  101. package/dist/charts-DouiiHOT.cjs +768 -0
  102. package/dist/charts-XVlDwU0y.js +4732 -0
  103. package/dist/charts.cjs +1 -1
  104. package/dist/charts.mjs +8 -8
  105. package/dist/core-BL-KmGYC.js +795 -0
  106. package/dist/core-BxiH7vkV.cjs +1 -0
  107. package/dist/core-Chg-oYCr.cjs +1 -0
  108. package/dist/core-CxBnKAhs.cjs +1 -0
  109. package/dist/core-DMV6_SEE.js +795 -0
  110. package/dist/core-D_LRh59n.js +795 -0
  111. package/dist/data-branching-Km4lc8P_.cjs +1 -0
  112. package/dist/data-branching-YQtJJEtn.js +6273 -0
  113. package/dist/data-branching-oEH04O3i.js +6273 -0
  114. package/dist/data-branching-wmsbLNfa.cjs +1 -0
  115. package/dist/data-branching.cjs +1 -1
  116. package/dist/data-branching.mjs +1 -1
  117. package/dist/data.cjs +1 -1
  118. package/dist/data.d.ts +2 -53
  119. package/dist/data.mjs +3 -3
  120. package/dist/devops-Bt6EsfPa.cjs +17 -0
  121. package/dist/devops-CnZQ1rU5.js +8312 -0
  122. package/dist/devops-D5yIDM3e.js +8312 -0
  123. package/dist/devops-rVpB0ZAX.cjs +17 -0
  124. package/dist/devops.cjs +1 -1
  125. package/dist/devops.mjs +1 -1
  126. package/dist/editors.cjs +1 -1
  127. package/dist/editors.d.ts +8 -26
  128. package/dist/editors.mjs +55 -54
  129. package/dist/feedback.cjs +1 -1
  130. package/dist/feedback.d.ts +5 -0
  131. package/dist/feedback.mjs +3 -3
  132. package/dist/index.cjs +290 -290
  133. package/dist/index.css +1 -1
  134. package/dist/index.d.ts +239 -234
  135. package/dist/index.mjs +20262 -19440
  136. package/dist/lazy.cjs +1 -1
  137. package/dist/lazy.mjs +29 -29
  138. package/dist/navigation.cjs +1 -1
  139. package/dist/navigation.d.ts +4 -4
  140. package/dist/navigation.mjs +69 -69
  141. package/dist/no-code-4GtIBr6f.js +7503 -0
  142. package/dist/no-code-6WyYb3hL.cjs +331 -0
  143. package/dist/no-code-BH5oVFC6.js +8186 -0
  144. package/dist/no-code-Bdwh1vyS.cjs +332 -0
  145. package/dist/no-code-CnHG5_Vn.js +8186 -0
  146. package/dist/no-code-DMKlg1Zl.cjs +331 -0
  147. package/dist/no-code.cjs +1 -1
  148. package/dist/no-code.css +1 -1
  149. package/dist/no-code.d.ts +25 -18
  150. package/dist/no-code.mjs +3 -3
  151. package/dist/overlays.cjs +1 -1
  152. package/dist/overlays.d.ts +24 -24
  153. package/dist/overlays.mjs +24 -490
  154. package/dist/pickerCommons-0vyK1Knv.js +547 -0
  155. package/dist/pickerCommons-31hyz1gs.js +1122 -0
  156. package/dist/pickerCommons-BFbItm8o.cjs +1 -0
  157. package/dist/pickerCommons-BHirHJyn.js +548 -0
  158. package/dist/pickerCommons-BifIkPdk.cjs +1 -0
  159. package/dist/pickerCommons-Bt8JIaTN.cjs +1 -0
  160. package/dist/pickerCommons.css +1 -1
  161. package/dist/style.css +10 -7
  162. package/package.json +5 -7
  163. package/css/legacy-bg-text-aliases.css +0 -87
package/dist/index.d.ts CHANGED
@@ -48,6 +48,7 @@ import { createCustomDataSource } from '@nice2dev/ui-core';
48
48
  import { createGraphQLDataSource } from '@nice2dev/ui-core';
49
49
  import { createGraphQLSubscriptionSource } from '@nice2dev/ui-core';
50
50
  import { createICUTranslator } from '@nice2dev/ui-core';
51
+ import { createId } from '@nice2dev/ui-core';
51
52
  import { createIndexedDBDataSource } from '@nice2dev/ui-core';
52
53
  import { createInfiniteScroll } from '@nice2dev/ui-core';
53
54
  import { createMockDataSource } from '@nice2dev/ui-core';
@@ -150,6 +151,7 @@ import { LeakReport } from '@nice2dev/ui-core';
150
151
  import { LeakSeverity } from '@nice2dev/ui-core';
151
152
  import { LeakType } from '@nice2dev/ui-core';
152
153
  import { LiveRegionOptions } from '@nice2dev/ui-core';
154
+ import { loadNiceDictionary } from '@nice2dev/ui-core';
153
155
  import { LocalStorageAdapter } from '@nice2dev/ui-core';
154
156
  import { logicalProps } from '@nice2dev/ui-core';
155
157
  import { matchesShortcut } from '@nice2dev/ui-core';
@@ -229,6 +231,8 @@ import { NiceHelpIcon } from '@nice2dev/ui-core';
229
231
  import { NiceHelpIconProps } from '@nice2dev/ui-core';
230
232
  import { NiceHelpProvider } from '@nice2dev/ui-core';
231
233
  import { NiceHelpProviderProps } from '@nice2dev/ui-core';
234
+ import { NiceI18nLazyProvider } from '@nice2dev/ui-core';
235
+ import { NiceI18nLazyProviderProps } from '@nice2dev/ui-core';
232
236
  import { NiceI18nProvider } from '@nice2dev/ui-core';
233
237
  import { NiceIcon } from '@nice2dev/ui-core';
234
238
  import { NiceIconProps } from '@nice2dev/ui-core';
@@ -2652,7 +2656,9 @@ declare interface ComponentDefinition {
2652
2656
  id: string;
2653
2657
  name: string;
2654
2658
  category: string;
2659
+ /** NiceIcon name shown in the palette and on the canvas */
2655
2660
  icon?: string;
2661
+ /** Props a newly placed component starts with; editable in the Properties panel */
2656
2662
  defaultProps?: Record<string, unknown>;
2657
2663
  }
2658
2664
 
@@ -2745,6 +2751,7 @@ export declare interface ComponentDoc {
2745
2751
 
2746
2752
  declare interface ComponentInstance {
2747
2753
  id: string;
2754
+ /** The palette entry's id */
2748
2755
  type: string;
2749
2756
  props: Record<string, unknown>;
2750
2757
  children?: ComponentInstance[];
@@ -3074,6 +3081,8 @@ export { createGraphQLSubscriptionSource }
3074
3081
 
3075
3082
  export { createICUTranslator }
3076
3083
 
3084
+ export { createId }
3085
+
3077
3086
  export { createIndexedDBDataSource }
3078
3087
 
3079
3088
  export { createInfiniteScroll }
@@ -5058,19 +5067,6 @@ export declare const FlagIcon: default_2.FC<{
5058
5067
  className?: string;
5059
5068
  }>;
5060
5069
 
5061
- /**
5062
- * Legacy coloured-stripe swatch using the {@link getFlagColors} commons
5063
- * palette. Kept as a fallback for unknown ISO codes and for environments
5064
- * that cannot ship the SVG bundle. New code should prefer {@link FlagIcon}.
5065
- *
5066
- * @deprecated Prefer {@link FlagIcon} for accurate, heraldically-correct flags.
5067
- */
5068
- export declare const FlagSwatch: default_2.FC<{
5069
- code: string;
5070
- size?: number;
5071
- className?: string;
5072
- }>;
5073
-
5074
5070
  /**
5075
5071
  * Flat token map
5076
5072
  */
@@ -6372,6 +6368,8 @@ export { LiveRegionOptions }
6372
6368
  */
6373
6369
  export declare function loadComponentDoc(componentName: string): Promise<ComponentDoc | null>;
6374
6370
 
6371
+ export { loadNiceDictionary }
6372
+
6375
6373
  /**
6376
6374
  * Custom labels for localization.
6377
6375
  */
@@ -7034,19 +7032,6 @@ export declare interface ModuleGridResponse<T> {
7034
7032
  aggregates?: Record<string, number>;
7035
7033
  }
7036
7034
 
7037
- /** Grouped row structure. */
7038
- declare interface ModuleGroupedRow<T = any> {
7039
- isGroup: true;
7040
- groupKey: string;
7041
- groupValue: unknown;
7042
- groupLabel: string;
7043
- count: number;
7044
- aggregates?: Record<string, number>;
7045
- rows?: T[];
7046
- expanded?: boolean;
7047
- level: number;
7048
- }
7049
-
7050
7035
  /** Dynamic import function type. */
7051
7036
  export declare type ModuleImportFn = () => Promise<{
7052
7037
  default: ComponentType<Record<string, unknown>>;
@@ -7198,8 +7183,8 @@ export declare interface NiceAccordionItem {
7198
7183
  export declare interface NiceAccordionProps extends NiceBaseProps {
7199
7184
  /** Accordion size. */
7200
7185
  size?: NiceSize;
7201
- /** Panel definitions. */
7202
- items: NiceAccordionItem[];
7186
+ /** Panel definitions. Optional: without them the accordion renders empty. */
7187
+ items?: NiceAccordionItem[];
7203
7188
  /** Allow multiple panels to be open at once. */
7204
7189
  multiple?: boolean;
7205
7190
  /** IDs of panels that are open by default. */
@@ -7908,8 +7893,8 @@ export declare interface NiceAuditFieldChange {
7908
7893
  export declare function NiceAuditLog(props: NiceAuditLogProps): default_2.ReactElement;
7909
7894
 
7910
7895
  export declare interface NiceAuditLogProps {
7911
- /** Audit entries */
7912
- entries: NiceAuditEntry[];
7896
+ /** Audit entries. Optional: without them the log shows its empty state. */
7897
+ entries?: NiceAuditEntry[];
7913
7898
  /** Loading state */
7914
7899
  loading?: boolean;
7915
7900
  /** Load more callback (for infinite scroll) */
@@ -8044,7 +8029,8 @@ export declare const NiceAutocomplete: default_2.FC<NiceAutocompleteProps>;
8044
8029
 
8045
8030
  /** Props for the {@link NiceAutocomplete} component — a text input with filtered suggestion dropdown and optional multi-select. */
8046
8031
  export declare interface NiceAutocompleteProps extends NiceFormFieldProps {
8047
- options: NiceOption[];
8032
+ /** Suggestions to pick from. Optional: without them the field is a plain text input. */
8033
+ options?: NiceOption[];
8048
8034
  /** Single value or array of values if multiple=true (controlled). Omit it to let the field keep its own. */
8049
8035
  value?: string | string[];
8050
8036
  /** Initial value when uncontrolled. */
@@ -8061,8 +8047,6 @@ export declare interface NiceAutocompleteProps extends NiceFormFieldProps {
8061
8047
  renderOption?: (option: NiceOption, query: string) => default_2.ReactNode;
8062
8048
  /** Highlight matching text in suggestions (default true). */
8063
8049
  highlightMatch?: boolean;
8064
- /** Alias for options — array of string suggestions. */
8065
- suggestions?: (string | NiceOption)[];
8066
8050
  /**
8067
8051
  * When `true` (default), focusing the field (before typing) opens the dropdown
8068
8052
  * with **all** options sorted alphabetically. Set `false` to only show
@@ -8316,12 +8300,6 @@ export declare const NiceBarcode: ForwardRefExoticComponent<NiceBarcodeProps & R
8316
8300
  /** Supported barcode symbologies. */
8317
8301
  export declare type NiceBarcodeFormat = 'CODE128' | 'CODE39' | 'EAN13' | 'EAN8' | 'UPC' | 'ITF14' | 'MSI' | 'codabar';
8318
8302
 
8319
- /** @deprecated Renamed to {@link NiceBarcode}. Kept as an alias for backward compatibility. */
8320
- export declare const NiceBarcodeGenerator: ForwardRefExoticComponent<NiceBarcodeProps & RefAttributes<HTMLCanvasElement>>;
8321
-
8322
- /** @deprecated Renamed to {@link NiceBarcodeProps}. */
8323
- export declare type NiceBarcodeGeneratorProps = NiceBarcodeProps;
8324
-
8325
8303
  /** Props for the {@link NiceBarcode} component — renders a barcode on a `<canvas>`. */
8326
8304
  export declare interface NiceBarcodeProps extends NiceStandardProps {
8327
8305
  /** Text value to encode (controlled). Omit it to let the barcode keep its own. */
@@ -8989,8 +8967,8 @@ export declare const NiceCascadeSelect: default_2.FC<NiceCascadeSelectProps>;
8989
8967
 
8990
8968
  /** Props for {@link NiceCascadeSelect} — multi-column cascading dropdown. */
8991
8969
  export declare interface NiceCascadeSelectProps extends NiceStandardProps {
8992
- /** Top-level option tree. */
8993
- options: NiceCascadeOption[];
8970
+ /** Top-level option tree. Optional: without it the dropdown opens empty. */
8971
+ options?: NiceCascadeOption[];
8994
8972
  /** Controlled selection path (root → leaf). */
8995
8973
  value?: string[];
8996
8974
  /** Default selection path (uncontrolled). */
@@ -9152,10 +9130,13 @@ export declare interface NiceChatMessage {
9152
9130
 
9153
9131
  /** Props for the {@link NiceChat} component — a chat / messaging widget with message bubbles and input. */
9154
9132
  export declare interface NiceChatProps extends NiceBaseProps {
9155
- /** Chat messages. */
9156
- messages: NiceChatMessage[];
9157
- /** Called when the user sends a message. */
9158
- onSend: (text: string) => void;
9133
+ /** Chat messages. Optional: without them the chat starts empty. */
9134
+ messages?: NiceChatMessage[];
9135
+ /**
9136
+ * Called when the user sends a message. Optional: without it the chat is a read-only
9137
+ * transcript — no input field is rendered.
9138
+ */
9139
+ onSend?: (text: string) => void;
9159
9140
  /** Input placeholder text. */
9160
9141
  placeholder?: string;
9161
9142
  /** Chat window title. */
@@ -9624,29 +9605,31 @@ export declare interface NiceCodeMarker {
9624
9605
  }
9625
9606
 
9626
9607
  /**
9627
- * NiceCodePreview - Live code preview with syntax highlighting and diff
9608
+ * NiceCodePreview - read-only view of a piece of code, e.g. generated code
9628
9609
  *
9629
9610
  * Features:
9630
- * - Syntax highlighting for multiple languages
9631
- * - Line numbers
9632
- * - Live preview for React/HTML
9633
- * - Side-by-side diff view
9611
+ * - Language label and line numbers
9634
9612
  * - Copy to clipboard
9613
+ * - The previous and the current version side by side (`showDiff`)
9614
+ * - Live preview of HTML in a sandboxed iframe
9615
+ *
9616
+ * It does not colour the code itself: the block carries `language-<id>`, so a highlighter on
9617
+ * the page (Prism, highlight.js) can.
9635
9618
  */
9636
9619
  export declare const NiceCodePreview: default_2.FC<NiceCodePreviewProps>;
9637
9620
 
9638
9621
  export declare interface NiceCodePreviewProps {
9639
9622
  /** Code to display */
9640
9623
  code: string;
9641
- /** Programming language */
9624
+ /** Language: the label in the header and the `language-<id>` class on the code block */
9642
9625
  language?: string;
9643
9626
  /** Show line numbers */
9644
9627
  lineNumbers?: boolean;
9645
- /** Enable live preview (for React/HTML) */
9628
+ /** Render the code below it in a sandboxed iframe — HTML only */
9646
9629
  livePreview?: boolean;
9647
- /** Show diff view */
9630
+ /** Show `previousCode` and `code` side by side (whole texts, not a line diff) */
9648
9631
  showDiff?: boolean;
9649
- /** Previous code for diff comparison */
9632
+ /** The previous version, for `showDiff` */
9650
9633
  previousCode?: string;
9651
9634
  /** Theme */
9652
9635
  theme?: 'light' | 'dark';
@@ -10016,7 +9999,7 @@ export declare interface NiceCommandPaletteContextValue {
10016
9999
  }
10017
10000
 
10018
10001
  export declare interface NiceCommandPaletteProps {
10019
- /** Placeholder text for the search input */
10002
+ /** Placeholder text for the search input (default: translated "Type a command...") */
10020
10003
  placeholder?: string;
10021
10004
  /** Maximum items shown before scrolling */
10022
10005
  maxVisible?: number;
@@ -10024,7 +10007,7 @@ export declare interface NiceCommandPaletteProps {
10024
10007
  maxRecent?: number;
10025
10008
  /** Custom class name */
10026
10009
  className?: string;
10027
- /** Custom empty state text */
10010
+ /** Custom empty state text (default: translated "No commands found") */
10028
10011
  emptyText?: string;
10029
10012
  /** Close on action execution */
10030
10013
  closeOnAction?: boolean;
@@ -10327,7 +10310,7 @@ export declare interface NiceConnectorSelectorProps extends NiceBaseProps {
10327
10310
  /**
10328
10311
  * Cookie/storage consent banner that auto-hides based on Traceless policy.
10329
10312
  */
10330
- export declare function NiceConsentBanner({ className, position, variant, onAccept, onDecline, onCustomize, privacyPolicyUrl, acceptText, declineText, }: NiceConsentBannerProps): default_2.ReactElement | null;
10313
+ export declare function NiceConsentBanner({ className, position, onAccept, onDecline, onCustomize, privacyPolicyUrl, acceptText, declineText, }: NiceConsentBannerProps): default_2.ReactElement | null;
10331
10314
 
10332
10315
  /**
10333
10316
  * Props for NiceConsentBanner.
@@ -10337,8 +10320,6 @@ export declare interface NiceConsentBannerProps {
10337
10320
  className?: string;
10338
10321
  /** Position */
10339
10322
  position?: 'top' | 'bottom';
10340
- /** Theme variant */
10341
- variant?: 'minimal' | 'detailed';
10342
10323
  /** Callback when consent is given */
10343
10324
  onAccept?: () => void;
10344
10325
  /** Callback when consent is declined */
@@ -10347,9 +10328,9 @@ export declare interface NiceConsentBannerProps {
10347
10328
  onCustomize?: () => void;
10348
10329
  /** Privacy policy URL */
10349
10330
  privacyPolicyUrl?: string;
10350
- /** Custom accept button text */
10331
+ /** Custom accept button text (default: a translated "Accept all") */
10351
10332
  acceptText?: string;
10352
- /** Custom decline button text */
10333
+ /** Custom decline button text (default: a translated "Reject all") */
10353
10334
  declineText?: string;
10354
10335
  }
10355
10336
 
@@ -10670,8 +10651,11 @@ export declare interface NiceCountdownLabels {
10670
10651
 
10671
10652
  /** Props for {@link NiceCountdown} — live countdown to a target Date. */
10672
10653
  export declare interface NiceCountdownProps extends NiceStandardProps {
10673
- /** Target instant. Component re-renders every second until this time. */
10674
- targetDate: Date;
10654
+ /**
10655
+ * Target instant. Component re-renders every second until this time. Optional: without
10656
+ * one the countdown shows zero, runs no timer and never fires `onComplete`.
10657
+ */
10658
+ targetDate?: Date;
10675
10659
  /** Fires once when the countdown reaches zero or below. */
10676
10660
  onComplete?: () => void;
10677
10661
  /**
@@ -10689,6 +10673,41 @@ export declare interface NiceCountdownProps extends NiceStandardProps {
10689
10673
  labels?: NiceCountdownLabels;
10690
10674
  }
10691
10675
 
10676
+ /**
10677
+ * Countdown from a length of time: presets, hours / minutes / seconds fields, start / pause /
10678
+ * resume, reset and a bar of the time left. When the time runs out it stops, shows zero and
10679
+ * fires `onComplete` once. For a countdown to a date use `NiceCountdown`.
10680
+ */
10681
+ export declare const NiceCountdownTimer: default_2.FC<NiceCountdownTimerProps>;
10682
+
10683
+ /** Props for {@link NiceCountdownTimer}. */
10684
+ export declare interface NiceCountdownTimerProps extends NiceStandardProps {
10685
+ /** Length of the countdown in ms (controlled). */
10686
+ duration?: number;
10687
+ /** Initial length in ms (uncontrolled). Default 5 minutes. */
10688
+ defaultDuration?: number;
10689
+ /** Fires when the user picks a preset or edits the hours / minutes / seconds. */
10690
+ onDurationChange?: (ms: number) => void;
10691
+ /** Whether the timer runs (controlled). */
10692
+ running?: boolean;
10693
+ /** Initial running state (uncontrolled). Default `false`. */
10694
+ defaultRunning?: boolean;
10695
+ /** Fires on start, pause and when the time runs out. */
10696
+ onRunningChange?: (running: boolean) => void;
10697
+ /** Fires once when the remaining time reaches zero. */
10698
+ onComplete?: () => void;
10699
+ /** Quick-pick lengths in ms, shown while the timer is reset. Default 1, 5, 10 and 25 min; `[]` hides them. */
10700
+ presets?: number[];
10701
+ /** Let the user set hours / minutes / seconds while the timer is reset. Default `true`. */
10702
+ editable?: boolean;
10703
+ /** Display precision. Default `'seconds'`. */
10704
+ precision?: 'seconds' | 'tenths';
10705
+ /** Show a bar of the time left. Default `true`. */
10706
+ showProgress?: boolean;
10707
+ /** Caption above the time; also the accessible name of the clock. */
10708
+ label?: string;
10709
+ }
10710
+
10692
10711
  export declare const NiceCountryPicker: default_2.FC<NiceCountryPickerProps>;
10693
10712
 
10694
10713
  export declare interface NiceCountryPickerProps extends NiceFormFieldProps, DualVisibilityProps {
@@ -10704,16 +10723,6 @@ export declare interface NiceCountryPickerProps extends NiceFormFieldProps, Dual
10704
10723
  showSearch?: boolean;
10705
10724
  /** Search placeholder */
10706
10725
  searchPlaceholder?: string;
10707
- /**
10708
- * @deprecated Use `showDialCodeInValue` and `showDialCodeInMenu` for fine-grained control.
10709
- * When set, applies to both trigger and menu (legacy behaviour).
10710
- */
10711
- showDialCode?: boolean;
10712
- /**
10713
- * @deprecated Use `showFlagInValue` and `showFlagInMenu` for fine-grained control.
10714
- * When set, applies to both trigger and menu (legacy behaviour).
10715
- */
10716
- showFlag?: boolean;
10717
10726
  /** Show dial code in trigger (selected value). Default: false (compact) */
10718
10727
  showDialCodeInValue?: boolean;
10719
10728
  /** Show dial code in dropdown options. Default: true */
@@ -11516,11 +11525,6 @@ export declare interface NiceDateRangeBoxProps extends NiceFormFieldProps {
11516
11525
  * browser locale. The emitted value stays ISO regardless of display locale.
11517
11526
  */
11518
11527
  locale?: string;
11519
- /**
11520
- * @deprecated Use `dateFormatPreset`. Native input type forwarded to both
11521
- * inner pickers.
11522
- */
11523
- type?: 'date' | 'datetime-local' | 'time' | 'month' | 'week';
11524
11528
  /**
11525
11529
  * How the end date is constrained relative to the start (default
11526
11530
  * `'greater-or-equal'` — the end can equal the start).
@@ -11566,12 +11570,7 @@ export declare interface NiceDateTimePickerProps extends NiceFormFieldProps {
11566
11570
  min?: string;
11567
11571
  /** Maximum selectable date (passed to the hidden native picker). */
11568
11572
  max?: string;
11569
- /**
11570
- * @deprecated Use `dateFormatPreset` instead.
11571
- * Input type — `'date'`, `'datetime-local'`, `'time'`, `'month'`, or `'week'`.
11572
- */
11573
- type?: 'date' | 'datetime-local' | 'time' | 'month' | 'week';
11574
- /** Date format preset. Takes precedence over `type`. */
11573
+ /** Date format preset — what the field holds and how it is shown (default: a local date). */
11575
11574
  dateFormatPreset?: NiceDateFormatPreset;
11576
11575
  /** Placeholder text. Defaults to a derived placeholder (e.g. `dd.MM.yyyy`). */
11577
11576
  placeholder?: string;
@@ -12151,8 +12150,8 @@ export declare const NiceDocumentVersionList: default_2.ForwardRefExoticComponen
12151
12150
 
12152
12151
  /** Props for the {@link NiceDocumentVersionList} component. */
12153
12152
  export declare interface NiceDocumentVersionListProps extends NiceFormFieldProps {
12154
- /** Document versions, newest first. */
12155
- versions: DocumentVersion[];
12153
+ /** Document versions, newest first. Optional: without them the list is empty. */
12154
+ versions?: DocumentVersion[];
12156
12155
  /** Fires when user clicks to view a version. */
12157
12156
  onView?: (version: DocumentVersion) => void;
12158
12157
  /** Fires when user requests restoring a version. */
@@ -13145,30 +13144,6 @@ export declare interface NiceFlexProps extends NiceStandardProps {
13145
13144
 
13146
13145
  export declare type NiceFlexWrap = 'nowrap' | 'wrap' | 'wrap-reverse';
13147
13146
 
13148
- export declare const NiceFloorPlanCanvas: default_2.FC<NiceFloorPlanCanvasProps>;
13149
-
13150
- /**
13151
- * @deprecated Use `NiceSpatialEditor` from `@nice2dev/ui-buildings` instead.
13152
- */
13153
- export declare interface NiceFloorPlanCanvasProps extends NiceBaseProps {
13154
- svgUrl?: string;
13155
- devices: SmartDeviceDto[];
13156
- rooms?: SmartRoomDto[];
13157
- floor?: number;
13158
- floors?: FloorDescriptor[];
13159
- onDeviceClick?: (deviceId: string) => void;
13160
- onDeviceDrop?: (deviceId: string, x: number, y: number) => void;
13161
- /** Alias of `onDeviceDrop` (called whenever a device is dragged to a new position). */
13162
- onDeviceMove?: (deviceId: string, x: number, y: number) => void;
13163
- editMode?: boolean;
13164
- zoom?: number;
13165
- minZoom?: number;
13166
- maxZoom?: number;
13167
- showDeviceLabels?: boolean;
13168
- colorByState?: Record<string, string>;
13169
- animateStateChanges?: boolean;
13170
- }
13171
-
13172
13147
  export { NiceFocusable }
13173
13148
 
13174
13149
  export { NiceFocusableProps }
@@ -14181,6 +14156,10 @@ declare interface NiceHTMLOptions extends NiceExportOptions {
14181
14156
  standalone?: boolean;
14182
14157
  }
14183
14158
 
14159
+ export { NiceI18nLazyProvider }
14160
+
14161
+ export { NiceI18nLazyProviderProps }
14162
+
14184
14163
  export { NiceI18nProvider }
14185
14164
 
14186
14165
  export { NiceIcon }
@@ -14515,13 +14494,18 @@ export declare interface NiceIntegrationHubProps extends NiceBaseProps {
14515
14494
  onJobsChange?: (jobs: SyncJobConfig[]) => void;
14516
14495
  /** Called when webhooks change */
14517
14496
  onWebhooksChange?: (webhooks: IntegrationWebhookConfig[]) => void;
14518
- /** Custom connection test handler */
14497
+ /** Tests a connector against its system. Without it the Test button is disabled. */
14519
14498
  onTestConnection?: (connector: ConnectorConfig) => Promise<{
14520
14499
  success: boolean;
14521
14500
  message: string;
14522
14501
  }>;
14523
- /** Custom job runner */
14502
+ /** Runs a sync job. Without it jobs cannot run: the Run buttons are disabled. */
14524
14503
  onRunJob?: (job: SyncJobConfig) => Promise<SyncJobRun>;
14504
+ /** Sends a test request to a webhook. Without it the webhook Test button is disabled. */
14505
+ onTestWebhook?: (webhook: IntegrationWebhookConfig) => Promise<{
14506
+ success: boolean;
14507
+ response?: unknown;
14508
+ }>;
14525
14509
  /** Read-only mode */
14526
14510
  readOnly?: boolean;
14527
14511
  /** Show monitoring panel */
@@ -15272,9 +15256,9 @@ export declare interface NiceLiveDataGridProps<T extends LiveGridRow = LiveGridR
15272
15256
  onUpdate?: (update: LiveGridUpdate<T>) => void;
15273
15257
  /** Connection status change callback */
15274
15258
  onConnectionStatusChange?: (status: ConnectionStatus) => void;
15275
- /** Empty state content */
15259
+ /** Empty state content (default: a translated "No data") */
15276
15260
  emptyContent?: ReactNode;
15277
- /** Loading state content */
15261
+ /** Loading state content (default: a translated "Loading…") */
15278
15262
  loadingContent?: ReactNode;
15279
15263
  /** Enable sorting */
15280
15264
  sortable?: boolean;
@@ -15673,14 +15657,11 @@ export declare interface NiceLookupProps extends NiceFormFieldProps {
15673
15657
  export { NiceLookupSourceState }
15674
15658
 
15675
15659
  /**
15676
- * NiceLowCodeStudio - Visual no-code development environment
15660
+ * NiceLowCodeStudio - visual page composer
15677
15661
  *
15678
- * Central hub integrating all no-code tools:
15679
- * - Component Designer
15680
- * - Page Builder
15681
- * - State Designer
15682
- * - API Flow
15683
- * - Event Orchestrator
15662
+ * Drag components from the palette onto the canvas (or click them), select one to edit its
15663
+ * props, and see the result in Preview (through `renderComponent`) and as JSX in Code. Every
15664
+ * change goes to `onChange`, Save to `onSave`.
15684
15665
  */
15685
15666
  export declare const NiceLowCodeStudio: default_2.FC<NiceLowCodeStudioProps>;
15686
15667
 
@@ -15691,10 +15672,15 @@ export declare interface NiceLowCodeStudioProps {
15691
15672
  components?: ComponentDefinition[];
15692
15673
  /** Theme configuration */
15693
15674
  theme?: 'light' | 'dark';
15694
- /** Called when design changes */
15675
+ /** Called with the design after every change: a component added, removed or edited */
15695
15676
  onChange?: (design: DesignState) => void;
15696
- /** Called when save is requested */
15677
+ /** Called with the current design when Save is pressed */
15697
15678
  onSave?: (design: DesignState) => void;
15679
+ /**
15680
+ * Draws a placed component in the Preview tab: map `instance.type` (the palette entry's id)
15681
+ * to your real component. Without it the tab says the preview is not connected.
15682
+ */
15683
+ renderComponent?: (instance: ComponentInstance) => default_2.ReactNode;
15698
15684
  /** Additional class name */
15699
15685
  className?: string;
15700
15686
  /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
@@ -15822,12 +15808,15 @@ export declare interface NiceMapMarker {
15822
15808
 
15823
15809
  /** Props for the {@link NiceMap} component — an interactive map with markers and click callbacks. */
15824
15810
  export declare interface NiceMapProps extends NiceBaseProps {
15825
- /** Map center coordinates. */
15826
- center: {
15811
+ /**
15812
+ * Map center coordinates. Optional: without it the map opens on the markers' midpoint,
15813
+ * or on the whole world when there are no markers.
15814
+ */
15815
+ center?: {
15827
15816
  lat: number;
15828
15817
  lng: number;
15829
15818
  };
15830
- /** Zoom level. */
15819
+ /** Zoom level. Defaults to 10, or 2 for the whole-world view (no `center`, no markers). */
15831
15820
  zoom?: number;
15832
15821
  /** Map markers. */
15833
15822
  markers?: NiceMapMarker[];
@@ -16382,12 +16371,8 @@ export declare interface NiceModuleGridProps<T extends Record<string, any> = any
16382
16371
  onSortChange?: (sort: ModuleSortSpec[]) => void;
16383
16372
  /** Multi-column sort */
16384
16373
  multiSort?: boolean;
16385
- /** Enable column filtering */
16386
- filterable?: boolean;
16387
16374
  /** Current filter state */
16388
16375
  filter?: ModuleFilterGroup;
16389
- /** Filter change handler */
16390
- onFilterChange?: (filter: ModuleFilterGroup) => void;
16391
16376
  /** Quick search text */
16392
16377
  searchText?: string;
16393
16378
  /** Search change handler */
@@ -16418,38 +16403,10 @@ export declare interface NiceModuleGridProps<T extends Record<string, any> = any
16418
16403
  selectedKeys?: Set<string>;
16419
16404
  /** Selection change handler */
16420
16405
  onSelectionChange?: (keys: Set<string>, rows: T[]) => void;
16421
- /** Select all with server count */
16422
- selectAllServerCount?: number;
16423
- /** Select all handler for server-side */
16424
- onSelectAll?: () => Promise<Set<string>>;
16425
- /** Enable column reordering */
16426
- columnReorder?: boolean;
16427
- /** Column order change handler */
16428
- onColumnOrderChange?: (order: string[]) => void;
16429
16406
  /** Enable column resizing */
16430
16407
  columnResize?: boolean;
16431
16408
  /** Column width change handler */
16432
16409
  onColumnWidthChange?: (field: string, width: number) => void;
16433
- /** Column visibility change handler */
16434
- onColumnVisibilityChange?: (field: string, visible: boolean) => void;
16435
- /** Group by field */
16436
- groupBy?: string;
16437
- /** Group change handler */
16438
- onGroupByChange?: (field: string | null) => void;
16439
- /** Custom group row renderer */
16440
- groupRowRender?: (group: ModuleGroupedRow<T>) => React.ReactNode;
16441
- /** Expand all groups by default */
16442
- expandAllGroups?: boolean;
16443
- /** Enable inline editing */
16444
- editable?: boolean;
16445
- /** Cell edit handler */
16446
- onCellEdit?: (rowKey: string, field: string, value: unknown, row: T) => Promise<boolean> | boolean;
16447
- /** Row edit handler */
16448
- onRowEdit?: (rowKey: string, values: Partial<T>, row: T) => Promise<boolean> | boolean;
16449
- /** Edit mode: cell or row */
16450
- editMode?: 'cell' | 'row';
16451
- /** Validation error handler */
16452
- onValidationError?: (rowKey: string, field: string, error: string) => void;
16453
16410
  /** Context menu items */
16454
16411
  contextMenuItems?: ModuleContextMenuItem<T>[];
16455
16412
  /** Context menu action handler */
@@ -16464,8 +16421,6 @@ export declare interface NiceModuleGridProps<T extends Record<string, any> = any
16464
16421
  preferencesKey?: string;
16465
16422
  /** Initial preferences */
16466
16423
  initialPreferences?: ModuleViewPreferences;
16467
- /** Preferences change handler */
16468
- onPreferencesChange?: (prefs: ModuleViewPreferences) => void;
16469
16424
  /** Display density */
16470
16425
  density?: 'compact' | 'normal' | 'comfortable';
16471
16426
  /** Striped rows */
@@ -16497,10 +16452,6 @@ export declare interface NiceModuleGridProps<T extends Record<string, any> = any
16497
16452
  mobilePrimaryField?: string;
16498
16453
  /** Secondary field for mobile card subtitle */
16499
16454
  mobileSecondaryField?: string;
16500
- /** Module ID for permissions */
16501
- moduleId?: string;
16502
- /** Module permission for context menu filtering */
16503
- permissions?: Record<string, boolean>;
16504
16455
  /** Component size */
16505
16456
  size?: NiceSize;
16506
16457
  /** Show skeleton loading per column */
@@ -17360,6 +17311,11 @@ export declare interface NiceOfflineBannerProps extends NiceStandardProps {
17360
17311
  message?: string;
17361
17312
  variant?: 'warning' | 'error';
17362
17313
  icon?: default_2.ReactNode;
17314
+ /**
17315
+ * Overrides the browser's `navigator.onLine` — e.g. with your own health check, which also
17316
+ * catches a network that is up while the server is not. Leave it out to follow the browser.
17317
+ */
17318
+ online?: boolean;
17363
17319
  }
17364
17320
 
17365
17321
  export { NiceOfflineFirstConfig }
@@ -17798,10 +17754,10 @@ export declare const NicePermissionMatrix: default_2.ForwardRefExoticComponent<N
17798
17754
 
17799
17755
  /** Props for the {@link NicePermissionMatrix} component. */
17800
17756
  export declare interface NicePermissionMatrixProps {
17801
- /** Rows — roles or subjects. */
17802
- roles: PermissionRole[];
17803
- /** Columns — permissions/actions. */
17804
- actions: PermissionAction[];
17757
+ /** Rows — roles or subjects. Optional: without them the matrix has no rows. */
17758
+ roles?: PermissionRole[];
17759
+ /** Columns — permissions/actions. Optional: without them the matrix has no columns. */
17760
+ actions?: PermissionAction[];
17805
17761
  /** Controlled permission values. Key format: "roleId:actionId". */
17806
17762
  value?: PermissionMatrixValue;
17807
17763
  /** Fires when a permission changes. */
@@ -18303,8 +18259,6 @@ export declare interface NiceProgressProps extends Omit<NiceFormFieldProps, 'sub
18303
18259
  max?: number;
18304
18260
  /** Show the numeric percentage / value text alongside the bar. */
18305
18261
  showValue?: boolean;
18306
- /** @deprecated Renamed to {@link showValue}. Kept for backward compatibility. */
18307
- showLabel?: boolean;
18308
18262
  /** Optional custom text rendered next to the bar instead of the auto-formatted percentage. */
18309
18263
  text?: string;
18310
18264
  /** Colour variant for the filled portion. */
@@ -19024,6 +18978,39 @@ export declare interface NiceReconciliationViewProps extends NiceBaseProps {
19024
18978
 
19025
18979
  export { NiceRecordState }
19026
18980
 
18981
+ /**
18982
+ * Editor for a {@link NiceRecurrenceRule} — the rule `NiceScheduler` expands: frequency, interval,
18983
+ * weekdays of a weekly rule, and the end (never, on a date, after a number of occurrences). Below
18984
+ * the fields: the rule as one line of text and the next few dates it produces.
18985
+ */
18986
+ export declare const NiceRecurrenceEditor: default_2.FC<NiceRecurrenceEditorProps>;
18987
+
18988
+ /** Props for {@link NiceRecurrenceEditor}. */
18989
+ export declare interface NiceRecurrenceEditorProps extends NiceBaseProps {
18990
+ /** The rule (controlled); `null` means the event does not repeat. */
18991
+ value?: NiceRecurrenceRule | null;
18992
+ /** Initial rule (uncontrolled). Default `null`. */
18993
+ defaultValue?: NiceRecurrenceRule | null;
18994
+ /** Fires with the new rule, or `null` when "Does not repeat" is picked. */
18995
+ onChange?: (rule: NiceRecurrenceRule | null) => void;
18996
+ /** First occurrence: picks the weekday of a new weekly rule and anchors the preview. Default: now. */
18997
+ start?: Date;
18998
+ /** Offer "Does not repeat". Default `true`. */
18999
+ allowNone?: boolean;
19000
+ /** How many upcoming dates to list under the summary; `0` hides the list. Default `5`. */
19001
+ previewCount?: number;
19002
+ /** First day of the week in the day picker: `0` Sunday, `1` Monday. Default `1`. */
19003
+ weekStartsOn?: 0 | 1;
19004
+ /** Caption of the frequency field. Default: translated "Repeats". */
19005
+ label?: string;
19006
+ /** Size of the inner fields. Default `'md'`. */
19007
+ size?: NiceSize;
19008
+ /** Disables every field. */
19009
+ disabled?: boolean;
19010
+ /** Shows the rule without letting it change. */
19011
+ readOnly?: boolean;
19012
+ }
19013
+
19027
19014
  /** A recurrence rule for repeating {@link NiceSchedulerEvent} instances. */
19028
19015
  export declare type NiceRecurrenceRule = {
19029
19016
  freq: 'daily' | 'weekly' | 'monthly' | 'yearly';
@@ -20094,6 +20081,11 @@ export declare interface NiceSelectProps extends NiceFormFieldProps {
20094
20081
  renderOption?: (option: NiceOption, isSelected: boolean) => default_2.ReactNode;
20095
20082
  /** When true (default false), the trigger width grows to fit selected items in `multiple` mode. When false, width stays fixed. */
20096
20083
  multipleAutosize?: boolean;
20084
+ /**
20085
+ * Accessible name when the select has no visible `label` (a toolbar filter, a compact row).
20086
+ * It used to be dropped: the trigger had no name at all.
20087
+ */
20088
+ 'aria-label'?: string;
20097
20089
  }
20098
20090
 
20099
20091
  export declare const NiceSensorGaugePanel: default_2.FC<NiceSensorGaugePanelProps>;
@@ -21171,6 +21163,39 @@ export declare interface NiceStockDataPoint {
21171
21163
  volume?: number;
21172
21164
  }
21173
21165
 
21166
+ /**
21167
+ * Stopwatch: start / pause / resume, laps with split and total time, reset.
21168
+ *
21169
+ * Time comes from `performance.now()`, so a wall-clock change does not move it, and it is
21170
+ * repainted only as often as `precision` needs. `running` and `laps` are controllable; the
21171
+ * elapsed time itself is the component's own (it is time, not data).
21172
+ */
21173
+ export declare const NiceStopwatch: default_2.FC<NiceStopwatchProps>;
21174
+
21175
+ /** Props for {@link NiceStopwatch}. */
21176
+ export declare interface NiceStopwatchProps extends NiceStandardProps {
21177
+ /** Whether the stopwatch runs (controlled). */
21178
+ running?: boolean;
21179
+ /** Initial running state (uncontrolled). Default `false`. */
21180
+ defaultRunning?: boolean;
21181
+ /** Fires on start, pause and resume. */
21182
+ onRunningChange?: (running: boolean) => void;
21183
+ /** Lap marks — the total elapsed ms at each lap press, oldest first (controlled). */
21184
+ laps?: number[];
21185
+ /** Initial lap marks (uncontrolled). */
21186
+ defaultLaps?: number[];
21187
+ /** Fires with the new list when a lap is added and when the stopwatch is reset. */
21188
+ onLapsChange?: (laps: number[]) => void;
21189
+ /** Fires when the user resets the stopwatch (time back to zero, laps cleared). */
21190
+ onReset?: () => void;
21191
+ /** Display precision. Default `'hundredths'`. */
21192
+ precision?: NiceTimekeepingPrecision;
21193
+ /** Show the Lap button and the lap list. Default `true`. */
21194
+ showLaps?: boolean;
21195
+ /** Caption above the time; also the accessible name of the clock. */
21196
+ label?: string;
21197
+ }
21198
+
21174
21199
  /** Storybook story definition. */
21175
21200
  export declare interface NiceStoryDef {
21176
21201
  /** Story name. */
@@ -21201,7 +21226,7 @@ export declare interface NiceStoryMeta {
21201
21226
  parameters?: Record<string, unknown>;
21202
21227
  }
21203
21228
 
21204
- export declare function NiceStreamDashboard({ platforms: initialPlatforms, scenes: initialScenes, config: initialConfig, enableWebRTC: _enableWebRTC, rtmpServerUrl: _rtmpServerUrl, maxChatMessages: _maxChatMessages, autoRecord, recordingPath: _recordingPath, onStreamStart, onStreamStop, onChatMessage: _onChatMessage, onAlert, onAnalyticsUpdate: _onAnalyticsUpdate, onVODCreated, renderPreview, renderChatMessage, className, style, children, ...baseProps }: NiceStreamDashboardProps): default_2.JSX.Element;
21229
+ export declare function NiceStreamDashboard({ platforms: initialPlatforms, scenes: initialScenes, config: initialConfig, maxChatMessages, autoRecord, onStreamStart, onStreamStop, onChatMessage, onAlert, onAnalyticsUpdate, onVODCreated, renderPreview, renderChatMessage, onAddPlatform, onSendChatMessage, onTransition, onScreenshot, onOpenAudioMixer, onOpenSettings, className, style, children, ...baseProps }: NiceStreamDashboardProps): default_2.JSX.Element;
21205
21230
 
21206
21231
  export declare interface NiceStreamDashboardProps extends NiceBaseProps {
21207
21232
  /** Initial platform connections */
@@ -21210,16 +21235,10 @@ export declare interface NiceStreamDashboardProps extends NiceBaseProps {
21210
21235
  scenes?: Scene[];
21211
21236
  /** Initial stream configuration */
21212
21237
  config?: Partial<StreamConfig>;
21213
- /** Enable WebRTC broadcasting */
21214
- enableWebRTC?: boolean;
21215
- /** RTMP server URL for custom streaming */
21216
- rtmpServerUrl?: string;
21217
21238
  /** Maximum chat messages to keep */
21218
21239
  maxChatMessages?: number;
21219
21240
  /** Enable auto-recording */
21220
21241
  autoRecord?: boolean;
21221
- /** Recording path */
21222
- recordingPath?: string;
21223
21242
  /** Callback when stream starts */
21224
21243
  onStreamStart?: () => void;
21225
21244
  /** Callback when stream stops */
@@ -21236,6 +21255,27 @@ export declare interface NiceStreamDashboardProps extends NiceBaseProps {
21236
21255
  renderPreview?: (scene: Scene | null) => ReactNode;
21237
21256
  /** Custom render for chat message */
21238
21257
  renderChatMessage?: (message: ChatMessage) => ReactNode;
21258
+ /**
21259
+ * Called by "Add platform": connecting an account (credentials, OAuth) is the host's job.
21260
+ * Without it the button is disabled.
21261
+ */
21262
+ onAddPlatform?: () => void;
21263
+ /**
21264
+ * Sends a chat message through the platform's API. Without it the chat input is disabled —
21265
+ * the dashboard has no platform connection of its own.
21266
+ */
21267
+ onSendChatMessage?: (platform: StreamPlatform, message: string) => void | Promise<void>;
21268
+ /**
21269
+ * Called when the program switches to a scene, with the transition chosen next to the buttons
21270
+ * and its duration, so the host's renderer can animate it.
21271
+ */
21272
+ onTransition?: (sceneId: string, transition: string, durationMs: number) => void;
21273
+ /** "Screenshot" quick action; disabled without it. */
21274
+ onScreenshot?: () => void;
21275
+ /** "Audio Mixer" quick action; disabled without it. */
21276
+ onOpenAudioMixer?: () => void;
21277
+ /** "Settings" quick action; disabled without it. */
21278
+ onOpenSettings?: () => void;
21239
21279
  children?: ReactNode;
21240
21280
  }
21241
21281
 
@@ -21582,10 +21622,6 @@ export declare interface NiceTaskInboxProps extends NiceBaseProps {
21582
21622
  onTaskSelect?: (task: WorkflowTask) => void;
21583
21623
  /** Called when user claims a task */
21584
21624
  onTaskClaim?: (task: WorkflowTask) => void;
21585
- /** Called when user completes a task */
21586
- onTaskComplete?: (task: WorkflowTask, variables?: Record<string, unknown>) => void;
21587
- /** Called when user delegates a task */
21588
- onTaskDelegate?: (task: WorkflowTask, assignee: string) => void;
21589
21625
  /** Current user ID (for claimed/assigned logic) */
21590
21626
  currentUserId?: string;
21591
21627
  /** Show filter controls */
@@ -22030,6 +22066,9 @@ export declare interface NiceTileViewProps<T extends NiceTileViewItem = NiceTile
22030
22066
  emptyText?: string;
22031
22067
  }
22032
22068
 
22069
+ /** How finely {@link NiceStopwatch} and {@link NiceCountdownTimer} show the time. */
22070
+ export declare type NiceTimekeepingPrecision = 'seconds' | 'tenths' | 'hundredths';
22071
+
22033
22072
  export declare const NiceTimeline: default_2.ForwardRefExoticComponent<NiceTimelineProps & default_2.RefAttributes<HTMLDivElement>>;
22034
22073
 
22035
22074
  /** A single entry in the {@link NiceTimeline}. */
@@ -22221,32 +22260,6 @@ declare interface NiceTopNavExtraAction {
22221
22260
  badge?: number | string;
22222
22261
  }
22223
22262
 
22224
- /** @deprecated v2 nav-item type. Prefer {@link NiceNavMenuItem} via `navMenuItems`. */
22225
- export declare interface NiceTopNavItem {
22226
- id: string;
22227
- label: string;
22228
- icon?: default_2.ReactNode;
22229
- href?: string;
22230
- onClick?: () => void;
22231
- }
22232
-
22233
- /** @deprecated v2 language type. Prefer `<NiceLanguagePicker>` props. */
22234
- export declare interface NiceTopNavLanguageOption {
22235
- code: string;
22236
- label: string;
22237
- flag?: default_2.ReactNode;
22238
- }
22239
-
22240
- /** @deprecated v2 user-menu item. Prefer {@link UserMenuItem}. */
22241
- export declare interface NiceTopNavMenuItem {
22242
- id: string;
22243
- label: string;
22244
- icon?: default_2.ReactNode;
22245
- onClick?: () => void;
22246
- divider?: boolean;
22247
- href?: string;
22248
- }
22249
-
22250
22263
  export declare interface NiceTopNavProps {
22251
22264
  height?: number | string;
22252
22265
  density?: NiceTopNavDensity;
@@ -22334,7 +22347,6 @@ export declare interface NiceTopNavProps {
22334
22347
  * - `'minimal'` — bare brand bar: brand only, no nav, no right cluster.
22335
22348
  */
22336
22349
  preset?: 'marketing' | 'saas' | 'docs' | 'minimal';
22337
- navItems?: NiceTopNavItem[];
22338
22350
  navMenuItems?: NiceNavMenuItem[];
22339
22351
  activeNavId?: string;
22340
22352
  navAlignment?: 'start' | 'center' | 'end';
@@ -22364,12 +22376,10 @@ export declare interface NiceTopNavProps {
22364
22376
  centerContent?: default_2.ReactNode;
22365
22377
  /** Toggle search visibility independently of search props presence. Default: derived from search props. */
22366
22378
  showSearch?: boolean;
22367
- languages?: NiceTopNavLanguageOption[];
22368
22379
  currentLanguage?: string;
22369
22380
  onLanguageChange?: (code: string) => void;
22370
22381
  showLanguagePicker?: boolean;
22371
22382
  languagePickerProps?: Partial<NiceLanguagePickerProps>;
22372
- themes?: NiceTopNavThemeOption[];
22373
22383
  currentTheme?: string;
22374
22384
  onThemeChange?: (id: string) => void;
22375
22385
  showThemePicker?: boolean;
@@ -22380,10 +22390,8 @@ export declare interface NiceTopNavProps {
22380
22390
  onMarkAllNotificationsRead?: () => void;
22381
22391
  /** Toggle notifications visibility independently of notification props presence. */
22382
22392
  showNotifications?: boolean;
22383
- user?: NiceTopNavUser | NiceAuthUser;
22393
+ user?: NiceAuthUser;
22384
22394
  userMenuItems?: UserMenuItem[];
22385
- /** @deprecated Use `userMenuItems`. */
22386
- userMenu?: NiceTopNavMenuItem[];
22387
22395
  onProfile?: () => void;
22388
22396
  onLogout?: () => void;
22389
22397
  /**
@@ -22482,20 +22490,6 @@ export declare interface NiceTopNavProps {
22482
22490
  'data-testid'?: string;
22483
22491
  }
22484
22492
 
22485
- /** @deprecated v2 theme type. Prefer `<NiceThemePicker>` props. */
22486
- export declare interface NiceTopNavThemeOption {
22487
- id: string;
22488
- label: string;
22489
- icon?: default_2.ReactNode;
22490
- }
22491
-
22492
- /** @deprecated v2 user type. Prefer {@link NiceAuthUser}. */
22493
- export declare interface NiceTopNavUser {
22494
- name: string;
22495
- avatarUrl?: string;
22496
- initials?: string;
22497
- }
22498
-
22499
22493
  export declare type NiceTopNavVariant = 'default' | 'primary' | 'accent' | 'transparent' | 'glass' | 'dark';
22500
22494
 
22501
22495
  export declare interface NiceTopologyData {
@@ -22751,8 +22745,6 @@ export declare interface NiceTreeSelectNode {
22751
22745
  label: string;
22752
22746
  children?: NiceTreeSelectNode[];
22753
22747
  disabled?: boolean;
22754
- /** @deprecated Icons are no longer rendered — prop kept for backward compatibility. */
22755
- icon?: default_2.ReactNode;
22756
22748
  }
22757
22749
 
22758
22750
  /** Props for the {@link NiceTreeSelect} component — a dropdown that lets the user pick from a tree hierarchy. */
@@ -22782,8 +22774,8 @@ export declare const NiceTreeView: default_2.FC<NiceTreeViewProps>;
22782
22774
 
22783
22775
  /** Props for the {@link NiceTreeView} component — a hierarchical tree with selection, drag-drop, lazy loading, inline editing, and context menu. */
22784
22776
  export declare interface NiceTreeViewProps extends NiceBaseProps {
22785
- /** Root nodes. */
22786
- nodes: NiceTreeNode[];
22777
+ /** Root nodes. Optional: without them the tree renders empty. */
22778
+ nodes?: NiceTreeNode[];
22787
22779
  /**
22788
22780
  * Optional header rendered above the (optional) search box and the tree —
22789
22781
  * a title bar, toolbar or count. Pass any node; omit for no header.
@@ -25551,6 +25543,16 @@ export declare interface RectangleAnnotation extends AnnotationBase {
25551
25543
  tool: 'rectangle';
25552
25544
  }
25553
25545
 
25546
+ /**
25547
+ * Start times of the occurrences of `rule` for a series that begins at `start`, in order, up to
25548
+ * `rangeEnd` (inclusive), honouring `until` and `count` (counted from `start`). A weekly rule with
25549
+ * `byDay` (0 = Sunday … 6 = Saturday, as `Date.getDay()`) repeats on those weekdays of every
25550
+ * `interval`-th week, counted from the week of `start`, and never before `start`; without
25551
+ * `byDay` it repeats on the weekday of `start`. `limit` caps the list (for previews of open-ended
25552
+ * rules).
25553
+ */
25554
+ export declare function recurrenceDates(rule: NiceRecurrenceRule, start: Date, rangeEnd: Date, limit?: number): Date[];
25555
+
25554
25556
  declare interface ReducerStep {
25555
25557
  id: string;
25556
25558
  type: 'set' | 'update' | 'push' | 'remove' | 'reset' | 'custom';
@@ -26964,7 +26966,10 @@ declare interface StreamDashboardContextValue {
26964
26966
  updateAlertConfig: (id: string, updates: Partial<AlertConfig>) => void;
26965
26967
  removeAlertConfig: (id: string) => void;
26966
26968
  triggerAlert: (configId: string, data: unknown) => void;
26967
- sendChatMessage: (platform: StreamPlatform, message: string) => void;
26969
+ /** Sends through `onSendChatMessage`; without it nothing is sent. */
26970
+ sendChatMessage: (platform: StreamPlatform, message: string) => void | Promise<void>;
26971
+ /** Feed an incoming chat message (from the platform connections) into the chat panel. */
26972
+ receiveChatMessage: (message: ChatMessage) => void;
26968
26973
  clearChat: () => void;
26969
26974
  pauseChat: (paused: boolean) => void;
26970
26975
  setSlowMode: (seconds: number) => void;
@@ -29425,8 +29430,8 @@ export declare interface WizardStep {
29425
29430
  validate?: () => string | true | undefined;
29426
29431
  /** Whether this step is optional (can be skipped). */
29427
29432
  optional?: boolean;
29428
- /** Content renderer. */
29429
- content: default_2.ReactNode | ((ctx: WizardStepContext) => default_2.ReactNode);
29433
+ /** Content renderer. Optional: a step without content shows only its title and description. */
29434
+ content?: default_2.ReactNode | ((ctx: WizardStepContext) => default_2.ReactNode);
29430
29435
  }
29431
29436
 
29432
29437
  /** Context provided to each step's content renderer. */