@nice2dev/ui 1.1.5 → 1.1.7

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 (164) hide show
  1. package/CHANGELOG.md +102 -0
  2. package/README.md +50 -29
  3. package/css/legacy-bg-text-aliases.css +65 -61
  4. package/dist/NiceCodeEditor-Bc81wiaN.js +1134 -0
  5. package/dist/NiceCodeEditor-D6f8KdHN.js +1134 -0
  6. package/dist/NiceCodeEditor-DE3saxyt.cjs +260 -0
  7. package/dist/NiceCodeEditor-DZM16My5.cjs +260 -0
  8. package/dist/NiceCodeEditor-HqmcJjmZ.js +1179 -0
  9. package/dist/NiceColorPicker-6EqXaDj0.cjs +1 -0
  10. package/dist/NiceColorPicker-BiEWqWnd.js +596 -0
  11. package/dist/NiceColorPicker-Cuc6YXqz.cjs +1 -0
  12. package/dist/NiceColorPicker-DMATcNWG.js +596 -0
  13. package/dist/NiceColorPicker-R3O1nemp.js +596 -0
  14. package/dist/NiceConfirmDialog-B0e10fRL.cjs +1 -0
  15. package/dist/NiceConfirmDialog-BBDgEMHv.js +81 -0
  16. package/dist/NiceConfirmDialog-C7kdr8jJ.js +81 -0
  17. package/dist/NiceConfirmDialog-DMHqPfFM.js +81 -0
  18. package/dist/NiceConfirmDialog-ZJpQLQQS.cjs +1 -0
  19. package/dist/NiceDataGrid-BzUw4dSu.cjs +10 -0
  20. package/dist/NiceDataGrid-CPKcVOVz.js +1743 -0
  21. package/dist/NiceDataGrid-DJr33WMy.cjs +10 -0
  22. package/dist/NiceDataGrid-D_4gZ1Hu.js +1736 -0
  23. package/dist/NiceDataGrid-DlUAaXhD.js +1736 -0
  24. package/dist/NiceDocumentViewer-8ghRVtfO.js +672 -0
  25. package/dist/NiceDocumentViewer-ChWtA_Ry.cjs +180 -0
  26. package/dist/NiceDocumentViewer-DwLUV7Tc.js +672 -0
  27. package/dist/NiceDocumentViewer-goMzF1w3.cjs +180 -0
  28. package/dist/NiceDocumentViewer-gt1mxzP8.js +672 -0
  29. package/dist/NiceForm-CHEAHxDw.js +4805 -0
  30. package/dist/NiceForm-CJUp1CL0.cjs +1 -0
  31. package/dist/NiceForm-Cp_RH3Yj.js +4805 -0
  32. package/dist/NiceForm-a6tGr6ss.js +4819 -0
  33. package/dist/NiceForm-jU89oe2S.cjs +1 -0
  34. package/dist/NiceGantt-BnQwyTfG.cjs +1 -0
  35. package/dist/NiceGantt-D8coFAvK.js +328 -0
  36. package/dist/NiceGantt-DOZfT6r5.js +328 -0
  37. package/dist/NiceGantt-DQzH1V-R.js +328 -0
  38. package/dist/NiceGantt-jQ8ZpXko.cjs +1 -0
  39. package/dist/NiceHtmlEditor-B1nlXJNW.cjs +10 -0
  40. package/dist/NiceHtmlEditor-Bv3VqJPG.js +862 -0
  41. package/dist/NiceHtmlEditor-CKsGj-Ei.cjs +10 -0
  42. package/dist/NiceHtmlEditor-CloMgyzg.js +841 -0
  43. package/dist/NiceHtmlEditor-DUAHmkWI.js +841 -0
  44. package/dist/NiceLoginForm-Ce_QLnLf.js +736 -0
  45. package/dist/NiceLoginForm-DLpNTQlR.cjs +1 -0
  46. package/dist/NiceLoginForm-Dg0286Cc.js +736 -0
  47. package/dist/NiceLoginForm-X05Vadeg.js +708 -0
  48. package/dist/NiceLoginForm-f_dBCnUi.cjs +1 -0
  49. package/dist/NiceMention-BByI4nFG.js +11120 -0
  50. package/dist/NiceMention-BjeLN4Jx.cjs +430 -0
  51. package/dist/NiceMention-C2TPiMph.cjs +430 -0
  52. package/dist/NiceMention-C67vT6m0.js +11145 -0
  53. package/dist/NiceMention-D1cdy63w.cjs +430 -0
  54. package/dist/NiceMention-OaCi-GNO.js +11094 -0
  55. package/dist/NiceMention-QIuggb9Y.js +11122 -0
  56. package/dist/NiceMention.css +1 -1
  57. package/dist/NiceModal-CHaan9al.js +95 -0
  58. package/dist/NiceModal-Czq6OEAT.js +95 -0
  59. package/dist/NiceModal-D-HFwawr.js +95 -0
  60. package/dist/NiceModal-DOy2XTzc.cjs +1 -0
  61. package/dist/NiceModal-DkawKzEE.cjs +1 -0
  62. package/dist/NiceModuleLifecyclePanel-1CsP8Zst.js +6997 -0
  63. package/dist/NiceModuleLifecyclePanel-Bkx4Yg-3.cjs +1 -0
  64. package/dist/NiceModuleLifecyclePanel-C5oYtczk.js +6999 -0
  65. package/dist/NiceModuleLifecyclePanel-DCcy2yYi.cjs +1 -0
  66. package/dist/NiceModuleLifecyclePanel-DqdgW-0s.js +7004 -0
  67. package/dist/NiceModuleLifecyclePanel.css +1 -1
  68. package/dist/NicePagination-7od5KUa3.cjs +1 -0
  69. package/dist/NicePagination-DMrkR8hH.cjs +1 -0
  70. package/dist/NicePagination-DQmZpsSQ.js +179 -0
  71. package/dist/NicePagination-DipQRjPq.js +172 -0
  72. package/dist/NicePagination-KhlVXYaT.js +172 -0
  73. package/dist/NicePivotGrid-B-KthuqL.cjs +152 -0
  74. package/dist/NicePivotGrid-CLCTHkKO.cjs +152 -0
  75. package/dist/NicePivotGrid-DV54FCsH.js +1174 -0
  76. package/dist/NicePivotGrid-DoWLUPUs.js +1167 -0
  77. package/dist/NicePivotGrid-etwpfccz.js +1167 -0
  78. package/dist/NiceSavedQueryPanel-BABkTNc5.js +5129 -0
  79. package/dist/NiceSavedQueryPanel-Cfeig83P.cjs +586 -0
  80. package/dist/NiceSavedQueryPanel-DTWRLseb.cjs +586 -0
  81. package/dist/NiceSavedQueryPanel-Dy154sxE.js +5129 -0
  82. package/dist/NiceSavedQueryPanel-v7AffOOe.js +5129 -0
  83. package/dist/NiceSavedQueryPanel.css +1 -1
  84. package/dist/NiceScheduler-BEgB7ZgF.cjs +5 -0
  85. package/dist/NiceScheduler-C9JprsEI.cjs +5 -0
  86. package/dist/NiceScheduler-DSP-PPh0.js +1645 -0
  87. package/dist/NiceScheduler-DuPnaA3t.js +1652 -0
  88. package/dist/NiceScheduler-Oa89YZx9.js +1645 -0
  89. package/dist/NiceSelect-A336yeLZ.js +433 -0
  90. package/dist/NiceSelect-B5hTbqi2.js +433 -0
  91. package/dist/NiceSelect-BYSgDYzq.cjs +1 -0
  92. package/dist/NiceSelect-Dudf2T5T.js +433 -0
  93. package/dist/NiceSelect-DwBAIrX7.cjs +1 -0
  94. package/dist/NiceWindow-B6zjBTl9.cjs +1 -0
  95. package/dist/NiceWindow-BKQEx7Vf.js +1623 -0
  96. package/dist/NiceWindow-BnTH7Gy0.js +1623 -0
  97. package/dist/NiceWindow-CZN9NVZw.cjs +1 -0
  98. package/dist/NiceWindow-lxtPR7yZ.js +1623 -0
  99. package/dist/NiceWindow.css +1 -1
  100. package/dist/charts-B8_V3_nq.cjs +882 -0
  101. package/dist/charts-BZgyyybE.js +31933 -0
  102. package/dist/charts-FuDk5-r6.js +31958 -0
  103. package/dist/charts-INj3yFo5.js +31946 -0
  104. package/dist/charts-NolNXKUL.cjs +882 -0
  105. package/dist/charts.cjs +1 -1
  106. package/dist/charts.css +1 -1
  107. package/dist/charts.mjs +1 -1
  108. package/dist/core-A_A6c7an.js +795 -0
  109. package/dist/core-B2iH2J_X.js +795 -0
  110. package/dist/core-BmspZEfD.js +795 -0
  111. package/dist/core-DAfLOet6.cjs +1 -0
  112. package/dist/core-ZG3bgnBR.cjs +1 -0
  113. package/dist/data-branching-B3TOqXAO.cjs +1 -0
  114. package/dist/data-branching-BUGiICDZ.js +6275 -0
  115. package/dist/data-branching-DMXmcocj.js +6275 -0
  116. package/dist/data-branching-YE8P9M5P.js +6275 -0
  117. package/dist/data-branching-t6uhAwIm.cjs +1 -0
  118. package/dist/data-branching.cjs +1 -1
  119. package/dist/data-branching.mjs +1 -1
  120. package/dist/data.cjs +1 -1
  121. package/dist/data.d.ts +7 -2
  122. package/dist/data.mjs +3 -3
  123. package/dist/devops-BhV3OmF7.js +8285 -0
  124. package/dist/devops-BqUxnbRi.cjs +17 -0
  125. package/dist/devops-Bx-Qwj9w.cjs +17 -0
  126. package/dist/devops-DYZatW45.js +8251 -0
  127. package/dist/devops-R98k2zpd.js +8251 -0
  128. package/dist/devops.cjs +1 -1
  129. package/dist/devops.d.ts +29 -16
  130. package/dist/devops.mjs +1 -1
  131. package/dist/editors.cjs +1 -1
  132. package/dist/editors.d.ts +59 -28
  133. package/dist/editors.mjs +7 -7
  134. package/dist/feedback.cjs +1 -1
  135. package/dist/feedback.mjs +3 -3
  136. package/dist/index.cjs +445 -445
  137. package/dist/index.css +1 -1
  138. package/dist/index.d.ts +214 -119
  139. package/dist/index.mjs +16635 -16351
  140. package/dist/lazy.cjs +1 -1
  141. package/dist/lazy.d.ts +31 -18
  142. package/dist/lazy.mjs +24 -24
  143. package/dist/navigation.cjs +1 -1
  144. package/dist/navigation.d.ts +17 -14
  145. package/dist/navigation.mjs +130 -130
  146. package/dist/no-code-BPaAS4wW.cjs +332 -0
  147. package/dist/no-code-CBwUVL1i.js +7447 -0
  148. package/dist/no-code-CjktkQ50.js +7447 -0
  149. package/dist/no-code-DW2NrRba.js +7447 -0
  150. package/dist/no-code-DmFxrZ5T.cjs +332 -0
  151. package/dist/no-code.cjs +1 -1
  152. package/dist/no-code.d.ts +2 -2
  153. package/dist/no-code.mjs +1 -1
  154. package/dist/overlays.cjs +1 -1
  155. package/dist/overlays.d.ts +4 -4
  156. package/dist/overlays.mjs +2 -2
  157. package/dist/pickerCommons-C4XWRUvH.cjs +1 -0
  158. package/dist/pickerCommons-C_BpYs_m.cjs +1 -0
  159. package/dist/pickerCommons-DAOXH_u5.js +1122 -0
  160. package/dist/pickerCommons-Dn4wnDco.js +1122 -0
  161. package/dist/pickerCommons-DskswPS5.js +1122 -0
  162. package/dist/pickerCommons.css +1 -1
  163. package/dist/style.css +7 -7
  164. package/package.json +3 -3
package/dist/index.d.ts CHANGED
@@ -7144,10 +7144,12 @@ export { NiceAccessControlProps }
7144
7144
  export declare const NiceAccessManager: ForwardRefExoticComponent<NiceAccessManagerProps & RefAttributes<HTMLDivElement>>;
7145
7145
 
7146
7146
  export declare interface NiceAccessManagerProps extends NiceBaseProps {
7147
- /** The RBAC model (controlled). */
7148
- value: NiceRbacModel;
7147
+ /** The RBAC model (controlled). Omit it to let the manager keep its own. */
7148
+ value?: NiceRbacModel;
7149
+ /** Initial model when uncontrolled. Defaults to an empty model. */
7150
+ defaultValue?: NiceRbacModel;
7149
7151
  /** Change callback with the full updated model. */
7150
- onChange: (model: NiceRbacModel) => void;
7152
+ onChange?: (model: NiceRbacModel) => void;
7151
7153
  /** Render read-only. */
7152
7154
  readOnly?: boolean;
7153
7155
  /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
@@ -7276,10 +7278,12 @@ export declare interface NiceAchievementBadgeProps {
7276
7278
  export declare const NiceActionBuilder: ForwardRefExoticComponent<NiceActionBuilderProps & RefAttributes<HTMLDivElement>>;
7277
7279
 
7278
7280
  export declare interface NiceActionBuilderProps {
7279
- /** Current actions (controlled). */
7280
- value: NiceViewAction[];
7281
+ /** Current actions (controlled). Omit it to let the builder keep its own. */
7282
+ value?: NiceViewAction[];
7283
+ /** Initial actions when uncontrolled. */
7284
+ defaultValue?: NiceViewAction[];
7281
7285
  /** Change callback with the full updated array. */
7282
- onChange: (actions: NiceViewAction[]) => void;
7286
+ onChange?: (actions: NiceViewAction[]) => void;
7283
7287
  /** Available custom handler names (for `type: 'custom'`). */
7284
7288
  handlers?: string[];
7285
7289
  /** Available data source keys (for `refresh`). */
@@ -8036,8 +8040,10 @@ export declare const NiceAutocomplete: default_2.FC<NiceAutocompleteProps>;
8036
8040
  /** Props for the {@link NiceAutocomplete} component — a text input with filtered suggestion dropdown and optional multi-select. */
8037
8041
  export declare interface NiceAutocompleteProps extends NiceFormFieldProps {
8038
8042
  options: NiceOption[];
8039
- /** Single value or array of values if multiple=true. */
8040
- value: string | string[];
8043
+ /** Single value or array of values if multiple=true (controlled). Omit it to let the field keep its own. */
8044
+ value?: string | string[];
8045
+ /** Initial value when uncontrolled. */
8046
+ defaultValue?: string | string[];
8041
8047
  onChange?: (value: string | string[]) => void;
8042
8048
  minSearchLength?: number;
8043
8049
  maxResults?: number;
@@ -8210,13 +8216,15 @@ export declare interface NiceBackupRestoreDialogProps {
8210
8216
  onClose?: () => void;
8211
8217
  }
8212
8218
 
8213
- export declare function NiceBackupScheduler({ value, onChange, onSave, loading, className, style, }: NiceBackupSchedulerProps): default_2.JSX.Element;
8219
+ export declare function NiceBackupScheduler({ value: valueProp, defaultValue, onChange, onSave, loading, className, style, }: NiceBackupSchedulerProps): default_2.JSX.Element;
8214
8220
 
8215
8221
  export declare interface NiceBackupSchedulerProps {
8216
- /** Current schedule configuration */
8217
- value: BackupScheduleConfig;
8222
+ /** Current schedule configuration (controlled). Omit it to let the scheduler keep its own. */
8223
+ value?: BackupScheduleConfig;
8224
+ /** Initial configuration when uncontrolled. */
8225
+ defaultValue?: BackupScheduleConfig;
8218
8226
  /** Called on any change */
8219
- onChange: (value: BackupScheduleConfig) => void;
8227
+ onChange?: (value: BackupScheduleConfig) => void;
8220
8228
  /** Called when user saves */
8221
8229
  onSave?: (value: BackupScheduleConfig) => void;
8222
8230
  /** Loading (disable save button) */
@@ -8311,8 +8319,10 @@ export declare type NiceBarcodeGeneratorProps = NiceBarcodeProps;
8311
8319
 
8312
8320
  /** Props for the {@link NiceBarcode} component — renders a barcode on a `<canvas>`. */
8313
8321
  export declare interface NiceBarcodeProps extends NiceStandardProps {
8314
- /** Text value to encode. */
8315
- value: string;
8322
+ /** Text value to encode (controlled). Omit it to let the barcode keep its own. */
8323
+ value?: string;
8324
+ /** Initial value when uncontrolled. */
8325
+ defaultValue?: string;
8316
8326
  /** Barcode symbology (default CODE128). */
8317
8327
  format?: NiceBarcodeFormat;
8318
8328
  /** Canvas width in pixels (auto-calculated if omitted). */
@@ -8598,8 +8608,10 @@ export declare const NiceBusinessCard: default_2.ForwardRefExoticComponent<NiceB
8598
8608
  * state-ish props below exist only for the optional inline-edit mode.
8599
8609
  */
8600
8610
  export declare interface NiceBusinessCardProps {
8601
- /** Business entity data. */
8602
- data: BusinessCardData;
8611
+ /** Business entity data (controlled). Omit it to let the card keep its own copy in edit mode. */
8612
+ data?: BusinessCardData;
8613
+ /** Initial data when uncontrolled. */
8614
+ defaultData?: BusinessCardData;
8603
8615
  /** Whether to render in edit mode. */
8604
8616
  editing?: boolean;
8605
8617
  /** Fires when data changes (in edit mode). */
@@ -9323,10 +9335,14 @@ export declare interface NiceCodeDecoration {
9323
9335
  export declare function NiceCodeDiffEditor(props: NiceCodeDiffEditorProps): default_2.ReactElement;
9324
9336
 
9325
9337
  export declare interface NiceCodeDiffEditorProps {
9326
- /** Original (left) code */
9327
- original: string;
9328
- /** Modified (right) code */
9329
- modified: string;
9338
+ /** Original (left) code (controlled). Omit it to let the editor keep its own. */
9339
+ original?: string;
9340
+ /** Initial original code when uncontrolled. */
9341
+ defaultOriginal?: string;
9342
+ /** Modified (right) code (controlled). Omit it to let the editor keep its own. */
9343
+ modified?: string;
9344
+ /** Initial modified code when uncontrolled. */
9345
+ defaultModified?: string;
9330
9346
  /** Language */
9331
9347
  language?: NiceCodeLanguage;
9332
9348
  /** Theme */
@@ -9483,8 +9499,10 @@ export declare interface NiceCodeEditorOptions {
9483
9499
  export declare interface NiceCodeEditorProps {
9484
9500
  /** Editor layout size (minimal / compact / standard / fullscreen). */
9485
9501
  editorSize?: NiceEditorSize;
9486
- /** Code value */
9487
- value: string;
9502
+ /** Code (controlled). Omit it to let the editor keep its own. */
9503
+ value?: string;
9504
+ /** Initial code when uncontrolled. */
9505
+ defaultValue?: string;
9488
9506
  /** Value change callback */
9489
9507
  onChange?: (value: string) => void;
9490
9508
  /** Language */
@@ -9638,8 +9656,8 @@ export declare interface NiceCodePreviewProps {
9638
9656
  export declare const NiceCodeTemplate: default_2.FC<NiceCodeTemplateProps>;
9639
9657
 
9640
9658
  export declare interface NiceCodeTemplateProps extends NiceBaseProps {
9641
- /** Available templates */
9642
- templates: CodeTemplate[];
9659
+ /** Available templates. Defaults to none. */
9660
+ templates?: CodeTemplate[];
9643
9661
  /** Framework presets */
9644
9662
  presets?: FrameworkPreset[];
9645
9663
  /** Currently selected template */
@@ -9948,10 +9966,9 @@ export declare interface NiceCommandBarCommand {
9948
9966
  keywords?: string[];
9949
9967
  }
9950
9968
 
9951
- /** Props for {@link NiceCommandBar} — searchable command palette. */
9952
9969
  export declare interface NiceCommandBarProps extends NiceStandardProps {
9953
- /** Command set. */
9954
- commands: NiceCommandBarCommand[];
9970
+ /** Command set. Defaults to none. */
9971
+ commands?: NiceCommandBarCommand[];
9955
9972
  /** Controlled visibility. When omitted the bar is always visible. */
9956
9973
  open?: boolean;
9957
9974
  /** Fires when open state changes (e.g. Escape closes). */
@@ -10323,10 +10340,9 @@ export declare interface NiceConsentBannerProps {
10323
10340
  */
10324
10341
  export declare const NiceConsentPanel: default_2.ForwardRefExoticComponent<NiceConsentPanelProps & default_2.RefAttributes<HTMLDivElement>>;
10325
10342
 
10326
- /** Props for the {@link NiceConsentPanel} component. */
10327
10343
  export declare interface NiceConsentPanelProps extends NiceFormFieldProps {
10328
- /** Consent items to display. */
10329
- consents: ConsentItem[];
10344
+ /** Consent items to display. Defaults to none. */
10345
+ consents?: ConsentItem[];
10330
10346
  /** Fires when a consent status changes. */
10331
10347
  onConsentChange?: (id: string, status: ConsentStatus) => void;
10332
10348
  /** Fires when "Accept all" is clicked. */
@@ -11373,14 +11389,30 @@ export declare const NiceDateRangeBox: default_2.FC<NiceDateRangeBoxProps>;
11373
11389
 
11374
11390
  /** Props for the {@link NiceDateRangeBox} component — a pair of date pickers for selecting a date range. */
11375
11391
  export declare interface NiceDateRangeBoxProps extends NiceFormFieldProps {
11376
- /** Start date (ISO string). */
11377
- startDate: string;
11378
- /** End date (ISO string). */
11379
- endDate: string;
11380
- /** Called when the start date changes. */
11381
- onStartChange: (date: string) => void;
11382
- /** Called when the end date changes. */
11383
- onEndChange: (date: string) => void;
11392
+ /**
11393
+ * Start date (ISO string) — **controlled**. Omit it (and pass
11394
+ * `defaultStartDate`, or nothing at all) to let the control keep its own copy.
11395
+ */
11396
+ startDate?: string;
11397
+ /**
11398
+ * End date (ISO string) — **controlled**. Omit it (and pass `defaultEndDate`,
11399
+ * or nothing at all) to let the control keep its own copy.
11400
+ */
11401
+ endDate?: string;
11402
+ /**
11403
+ * Initial start date for the **uncontrolled** mode. Ignored when `startDate`
11404
+ * is supplied.
11405
+ */
11406
+ defaultStartDate?: string;
11407
+ /**
11408
+ * Initial end date for the **uncontrolled** mode. Ignored when `endDate` is
11409
+ * supplied.
11410
+ */
11411
+ defaultEndDate?: string;
11412
+ /** Called when the start date changes — in both controlled and uncontrolled mode. */
11413
+ onStartChange?: (date: string) => void;
11414
+ /** Called when the end date changes — in both controlled and uncontrolled mode. */
11415
+ onEndChange?: (date: string) => void;
11384
11416
  /** Earliest selectable date. */
11385
11417
  min?: string;
11386
11418
  /** Latest selectable date. */
@@ -12205,8 +12237,8 @@ export declare interface NiceDrawerProps extends NiceStandardProps {
12205
12237
  export declare const NiceDrillDownChart: default_2.ForwardRefExoticComponent<NiceDrillDownChartProps & default_2.RefAttributes<NiceDrillDownChartRef>>;
12206
12238
 
12207
12239
  export declare interface NiceDrillDownChartProps extends NiceStandardProps {
12208
- /** Poziomy danych do drill-down */
12209
- levels: DrillDownLevel[];
12240
+ /** Poziomy danych do drill-down. Domyślnie brak. */
12241
+ levels?: DrillDownLevel[];
12210
12242
  /** Początkowy poziom */
12211
12243
  initialLevelId?: string;
12212
12244
  /** Typ wykresu */
@@ -12972,8 +13004,11 @@ export declare const NiceFilterBuilder: default_2.FC<NiceFilterBuilderProps>;
12972
13004
  /** Props for the {@link NiceFilterBuilder} component — a visual query builder for complex AND/OR filter trees. */
12973
13005
  export declare interface NiceFilterBuilderProps extends NiceBaseProps {
12974
13006
  fields: NiceFilterField[];
12975
- value: NiceFilterGroup;
12976
- onChange: (value: NiceFilterGroup) => void;
13007
+ /** Filter tree (controlled). Omit it to let the builder keep its own. */
13008
+ value?: NiceFilterGroup;
13009
+ /** Initial filter tree when uncontrolled. Defaults to an empty AND group. */
13010
+ defaultValue?: NiceFilterGroup;
13011
+ onChange?: (value: NiceFilterGroup) => void;
12977
13012
  maxDepth?: number;
12978
13013
  /** Named filter presets */
12979
13014
  presets?: NiceFilterPreset[];
@@ -13562,8 +13597,8 @@ export declare interface NiceGitConflictResolverProps extends NiceBaseProps {
13562
13597
  export declare const NiceGitDiffViewer: default_2.FC<NiceGitDiffViewerProps>;
13563
13598
 
13564
13599
  export declare interface NiceGitDiffViewerProps extends NiceBaseProps {
13565
- /** Diff files */
13566
- files: DiffFile[];
13600
+ /** Diff files. Defaults to none. */
13601
+ files?: DiffFile[];
13567
13602
  /** View mode */
13568
13603
  viewMode?: DiffViewMode;
13569
13604
  /** Show whitespace changes */
@@ -13590,12 +13625,12 @@ export declare interface NiceGitDiffViewerProps extends NiceBaseProps {
13590
13625
  export declare const NiceGitGraph: default_2.FC<NiceGitGraphProps>;
13591
13626
 
13592
13627
  export declare interface NiceGitGraphProps extends NiceBaseProps {
13593
- /** Commits to display (newest first) */
13594
- commits: GitCommit_2[];
13595
- /** All branches */
13596
- branches: GitBranch_2[];
13597
- /** All tags */
13598
- tags: GitTag_2[];
13628
+ /** Commits to display (newest first). Defaults to none. */
13629
+ commits?: GitCommit_2[];
13630
+ /** All branches. Defaults to none. */
13631
+ branches?: GitBranch_2[];
13632
+ /** All tags. Defaults to none. */
13633
+ tags?: GitTag_2[];
13599
13634
  /** Currently checked out branch/commit */
13600
13635
  head?: string;
13601
13636
  /** Selected commit hash */
@@ -13634,8 +13669,13 @@ export declare interface NiceGitGraphProps extends NiceBaseProps {
13634
13669
  export declare const NiceGitHooks: default_2.FC<NiceGitHooksProps>;
13635
13670
 
13636
13671
  export declare interface NiceGitHooksProps extends NiceBaseProps {
13637
- /** Current hooks configuration */
13638
- hooks: GitHook[];
13672
+ /**
13673
+ * Hooks configuration. Controlled only together with `onHooksChange`; on its own it is
13674
+ * the initial configuration the editor then keeps in a local copy.
13675
+ */
13676
+ hooks?: GitHook[];
13677
+ /** Initial hooks configuration when uncontrolled. */
13678
+ defaultHooks?: GitHook[];
13639
13679
  /** Available templates */
13640
13680
  templates?: HookTemplate[];
13641
13681
  /** Hook manager type */
@@ -13644,7 +13684,10 @@ export declare interface NiceGitHooksProps extends NiceBaseProps {
13644
13684
  repoPath?: string;
13645
13685
  /** Currently editing hook */
13646
13686
  selectedHook?: GitHookType;
13687
+ /** Called with each hook the user changed. */
13647
13688
  onHookChange?: (hook: GitHook) => void;
13689
+ /** Called with the whole hooks list after any change. */
13690
+ onHooksChange?: (hooks: GitHook[]) => void;
13648
13691
  onHookToggle?: (hookType: GitHookType, enabled: boolean) => void;
13649
13692
  onActionAdd?: (hookType: GitHookType, action: HookAction) => void;
13650
13693
  onActionRemove?: (hookType: GitHookType, actionId: string) => void;
@@ -14022,8 +14065,12 @@ declare interface NiceHtmlEditorAIRef {
14022
14065
  export declare type NiceHtmlEditorCommand = 'bold' | 'italic' | 'underline' | 'strikethrough' | 'h1' | 'h2' | 'h3' | 'ul' | 'ol' | 'link' | 'unlink' | 'undo' | 'redo' | 'clear' | 'table' | 'image' | 'code' | 'markdown' | 'blockquote' | 'hr' | 'fontSize' | 'fontColor' | 'bgColor' | 'subscript' | 'superscript' | 'indent' | 'outdent' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'fullscreen' | 'removeFormat' | 'print' | 'source' | 'emoji' | 'findReplace';
14023
14066
 
14024
14067
  export declare interface NiceHtmlEditorProps extends NiceFormFieldProps {
14025
- value: string;
14026
- onChange: (html: string) => void;
14068
+ /** HTML content (controlled). Omit it to let the editor keep its own. */
14069
+ value?: string;
14070
+ /** Initial HTML content when uncontrolled. */
14071
+ defaultValue?: string;
14072
+ /** Called with the new HTML after every edit. */
14073
+ onChange?: (html: string) => void;
14027
14074
  placeholder?: string;
14028
14075
  height?: number | string;
14029
14076
  toolbar?: NiceHtmlEditorCommand[];
@@ -14342,8 +14389,8 @@ export { NiceInstanceMonitor }
14342
14389
  export { NiceInstanceMonitor as NiceWorkflowInstanceMonitor }
14343
14390
 
14344
14391
  export declare interface NiceInstanceMonitorProps extends NiceBaseProps {
14345
- /** List of process instances */
14346
- instances: ProcessInstance[];
14392
+ /** List of process instances. Defaults to none. */
14393
+ instances?: ProcessInstance[];
14347
14394
  /** Currently selected instance ID */
14348
14395
  selectedInstanceId?: string;
14349
14396
  /** Called when an instance is selected */
@@ -14565,10 +14612,12 @@ export { NiceKeyboardHintProps }
14565
14612
  export declare const NiceKeyValueEditor: ForwardRefExoticComponent<NiceKeyValueEditorProps & RefAttributes<HTMLDivElement>>;
14566
14613
 
14567
14614
  export declare interface NiceKeyValueEditorProps extends NiceBaseProps {
14568
- /** Current rows (controlled). */
14569
- value: NiceKeyValuePair[];
14615
+ /** Current rows (controlled). Omit it to let the editor keep its own. */
14616
+ value?: NiceKeyValuePair[];
14617
+ /** Initial rows when uncontrolled. */
14618
+ defaultValue?: NiceKeyValuePair[];
14570
14619
  /** Change callback with the full updated array. */
14571
- onChange: (pairs: NiceKeyValuePair[]) => void;
14620
+ onChange?: (pairs: NiceKeyValuePair[]) => void;
14572
14621
  /** Allow toggling a row's value between text and secret (adds a lock toggle). */
14573
14622
  allowSecret?: boolean;
14574
14623
  /** Show a per-row enable/disable checkbox. */
@@ -15332,8 +15381,14 @@ export declare const NiceLocaleManager: default_2.FC<NiceLocaleManagerProps>;
15332
15381
 
15333
15382
  export declare interface NiceLocaleManagerProps extends NiceBaseProps {
15334
15383
  locales: NiceLocaleInfo[];
15335
- translations: Record<string, Record<string, string>>;
15336
- onTranslationChange: (locale: string, key: string, value: string) => void;
15384
+ /** Translations per locale, `translations[locale][key]` (controlled). Omit it to let the manager keep its own. */
15385
+ translations?: Record<string, Record<string, string>>;
15386
+ /** Initial translations when uncontrolled. */
15387
+ defaultTranslations?: Record<string, Record<string, string>>;
15388
+ /** Called with the single edited cell. */
15389
+ onTranslationChange?: (locale: string, key: string, value: string) => void;
15390
+ /** Called with the whole translations object after any edit. */
15391
+ onTranslationsChange?: (translations: Record<string, Record<string, string>>) => void;
15337
15392
  onLocaleAdd: (locale: NiceLocaleInfo) => void;
15338
15393
  onLocaleRemove: (localeCode: string) => void;
15339
15394
  onExport: (locale: string, format: 'json' | 'csv' | 'xliff') => void;
@@ -15510,10 +15565,12 @@ declare interface NiceLookupColumn {
15510
15565
  export declare interface NiceLookupProps extends NiceFormFieldProps {
15511
15566
  /** Available options. Used when `data`/`columns` aren't provided. */
15512
15567
  options?: NiceOption[];
15513
- /** Selected value. */
15514
- value: string;
15568
+ /** Selected value (controlled). Omit it to let the lookup keep its own. */
15569
+ value?: string;
15570
+ /** Initial selection when uncontrolled. */
15571
+ defaultValue?: string;
15515
15572
  /** Called when the selection changes. */
15516
- onChange: (value: string) => void;
15573
+ onChange?: (value: string) => void;
15517
15574
  /** Enable search/filter in the dropdown. */
15518
15575
  searchable?: boolean;
15519
15576
  /** Show a clear button. */
@@ -15783,8 +15840,10 @@ export declare const NiceMdiWorkspace: ForwardRefExoticComponent<NiceMdiWorkspac
15783
15840
  export declare interface NiceMdiWorkspaceProps extends NiceBaseProps {
15784
15841
  /** Currently open tabs. */
15785
15842
  tabs: NiceTabDescriptor[];
15786
- /** Index of the active (visible) tab. */
15787
- activeIndex: number;
15843
+ /** Index of the active (visible) tab (controlled). Omit it to let the workspace keep its own. */
15844
+ activeIndex?: number;
15845
+ /** Initial active index when uncontrolled. Defaults to 0. */
15846
+ defaultActiveIndex?: number;
15788
15847
  /** Render function returning the content for a given tab. */
15789
15848
  renderTab: (tab: NiceTabDescriptor, index: number) => React.ReactNode;
15790
15849
  /** Called when user selects a different tab. */
@@ -16071,8 +16130,8 @@ export declare type NiceMenuVariant = 'separated' | 'group' | 'pills' | 'ghost'
16071
16130
  export declare const NiceMergeRequestBuilder: default_2.FC<NiceMergeRequestBuilderProps>;
16072
16131
 
16073
16132
  export declare interface NiceMergeRequestBuilderProps extends NiceBaseProps {
16074
- /** Available branches */
16075
- branches: Array<{
16133
+ /** Available branches. Defaults to none. */
16134
+ branches?: Array<{
16076
16135
  name: string;
16077
16136
  isRemote?: boolean;
16078
16137
  }>;
@@ -16146,8 +16205,8 @@ export declare const NiceModeSelector: ForwardRefExoticComponent<NiceModeSelecto
16146
16205
  export declare interface NiceModeSelectorProps extends NiceBaseProps {
16147
16206
  /** Size variant. */
16148
16207
  size?: NiceSize;
16149
- /** Available modes. */
16150
- modes: NiceModeInfo[];
16208
+ /** Available modes. Defaults to none. */
16209
+ modes?: NiceModeInfo[];
16151
16210
  /** Currently active mode key. */
16152
16211
  activeMode: string;
16153
16212
  /** Called when user selects a mode. */
@@ -16837,8 +16896,8 @@ export declare interface NiceNavShellProps {
16837
16896
  mobileBreakpoint?: number;
16838
16897
  /** Force the shell into the mobile layout regardless of viewport. */
16839
16898
  forceMobileLayout?: boolean;
16840
- /** Map of route → content (ReactNode or factory). */
16841
- routes: Record<string, ReactNode | (() => ReactNode)>;
16899
+ /** Map of route → content (ReactNode or factory). Defaults to none (the empty state shows). */
16900
+ routes?: Record<string, ReactNode | (() => ReactNode)>;
16842
16901
  /** Initial / default route (used when uncontrolled). */
16843
16902
  defaultRoute?: string;
16844
16903
  /** Controlled active route. */
@@ -17446,12 +17505,14 @@ export declare const NicePagination: default_2.FC<NicePaginationProps>;
17446
17505
  export declare interface NicePaginationProps extends NiceBaseProps {
17447
17506
  /** Pagination size. */
17448
17507
  size?: NiceSize;
17449
- /** Current 1-based page number. */
17450
- page: number;
17508
+ /** Current 1-based page number (controlled). Omit it to let the bar keep its own. */
17509
+ page?: number;
17510
+ /** Initial page when uncontrolled. Defaults to 1. */
17511
+ defaultPage?: number;
17451
17512
  /** Total number of pages. */
17452
17513
  totalPages: number;
17453
17514
  /** Called when the page changes. */
17454
- onChange: (page: number) => void;
17515
+ onChange?: (page: number) => void;
17455
17516
  /**
17456
17517
  * Show "Page X of Y" info text.
17457
17518
  * @default true
@@ -17764,9 +17825,13 @@ export declare interface NicePieSlice {
17764
17825
  export declare const NicePipelineEditor: default_2.FC<NicePipelineEditorProps>;
17765
17826
 
17766
17827
  export declare interface NicePipelineEditorProps extends NiceBaseProps {
17767
- pipeline: Pipeline;
17828
+ /** The pipeline (controlled). Omit it to let the editor keep its own. */
17829
+ pipeline?: Pipeline;
17830
+ /** Initial pipeline when uncontrolled. */
17831
+ defaultPipeline?: Pipeline;
17768
17832
  templates: PipelineTemplate[];
17769
- runners: Array<{
17833
+ /** Runners a job can be assigned to. Defaults to none. */
17834
+ runners?: Array<{
17770
17835
  id: string;
17771
17836
  name: string;
17772
17837
  os: string;
@@ -17777,7 +17842,7 @@ export declare interface NicePipelineEditorProps extends NiceBaseProps {
17777
17842
  name: string;
17778
17843
  protection: boolean;
17779
17844
  }>;
17780
- onPipelineChange: (pipeline: Pipeline) => void;
17845
+ onPipelineChange?: (pipeline: Pipeline) => void;
17781
17846
  onStageAdd: () => void;
17782
17847
  onStageRemove: (stageId: string) => void;
17783
17848
  onStageMove: (stageId: string, direction: 'up' | 'down') => void;
@@ -17800,7 +17865,8 @@ export declare interface NicePipelineEditorProps extends NiceBaseProps {
17800
17865
  export declare const NicePipelineMonitor: default_2.FC<NicePipelineMonitorProps>;
17801
17866
 
17802
17867
  export declare interface NicePipelineMonitorProps extends NiceBaseProps {
17803
- runs: PipelineRun[];
17868
+ /** Pipeline runs. Defaults to none. */
17869
+ runs?: PipelineRun[];
17804
17870
  stats?: PipelineStats;
17805
17871
  selectedRunId?: string;
17806
17872
  onRunSelect: (runId: string) => void;
@@ -17851,8 +17917,13 @@ export declare interface NicePivotGridFieldChooserProps extends NiceBaseProps {
17851
17917
  export declare interface NicePivotGridProps extends NiceBaseProps {
17852
17918
  /** Raw data records. */
17853
17919
  data: Record<string, any>[];
17854
- /** Field definitions (row, column, data, filter areas). */
17855
- fields: NicePivotField[];
17920
+ /**
17921
+ * Field definitions (row, column, data, filter areas). Controlled only together with
17922
+ * `onFieldsChange`; on its own it is the initial layout the field chooser then edits.
17923
+ */
17924
+ fields?: NicePivotField[];
17925
+ /** Initial field layout when uncontrolled. */
17926
+ defaultFields?: NicePivotField[];
17856
17927
  /** Called when user rearranges fields. */
17857
17928
  onFieldsChange?: (fields: NicePivotField[]) => void;
17858
17929
  /** Show the field chooser panel. */
@@ -18250,8 +18321,10 @@ export declare const NiceQRCode: ForwardRefExoticComponent<NiceQRCodeProps & Ref
18250
18321
 
18251
18322
  /** Props for the {@link NiceQRCode} component — generates and renders a QR code from a text value. */
18252
18323
  export declare interface NiceQRCodeProps extends NiceStandardProps {
18253
- /** Text or URL to encode. */
18254
- value: string;
18324
+ /** Text or URL to encode (controlled). Omit it to let the code keep its own. */
18325
+ value?: string;
18326
+ /** Initial value when uncontrolled. */
18327
+ defaultValue?: string;
18255
18328
  /** Output size in pixels. */
18256
18329
  qrSize?: number;
18257
18330
  /**
@@ -19402,8 +19475,11 @@ export declare interface NiceScannerControlProps extends NiceFormFieldProps {
19402
19475
  export declare const NiceSceneActionBuilder: default_2.FC<NiceSceneActionBuilderProps>;
19403
19476
 
19404
19477
  export declare interface NiceSceneActionBuilderProps extends NiceBaseProps {
19405
- actions: SceneAction[];
19406
- onActionsChange: (actions: SceneAction[]) => void;
19478
+ /** Scene actions (controlled). Omit it to let the builder keep its own. */
19479
+ actions?: SceneAction[];
19480
+ /** Initial actions when uncontrolled. */
19481
+ defaultActions?: SceneAction[];
19482
+ onActionsChange?: (actions: SceneAction[]) => void;
19407
19483
  availableDevices: SmartDeviceDto[];
19408
19484
  availableRooms?: SmartRoomDto[];
19409
19485
  showPreview?: boolean;
@@ -19489,7 +19565,14 @@ export declare interface NiceSchedulerEventTypeDef {
19489
19565
 
19490
19566
  /** Props for the {@link NiceScheduler} component — a full-featured calendar / scheduler with drag, recurring events, resources, and inline editing. */
19491
19567
  export declare interface NiceSchedulerProps extends NiceBaseProps {
19492
- events: NiceSchedulerEvent[];
19568
+ /**
19569
+ * Events. Controlled only together with `onEventsChange` (the same rule as
19570
+ * `currentDate`/`view` here); on its own it is the live starting list, which the
19571
+ * built-in editor then takes over.
19572
+ */
19573
+ events?: NiceSchedulerEvent[];
19574
+ /** Initial events when uncontrolled. */
19575
+ defaultEvents?: NiceSchedulerEvent[];
19493
19576
  resources?: NiceSchedulerResource[];
19494
19577
  currentDate?: Date;
19495
19578
  view?: NiceSchedulerView;
@@ -19601,8 +19684,10 @@ export declare type NiceSchedulerView = 'day' | 'week' | 'workWeek' | 'month' |
19601
19684
  export declare const NiceScriptRunner: ForwardRefExoticComponent<NiceScriptRunnerProps & RefAttributes<HTMLDivElement>>;
19602
19685
 
19603
19686
  export declare interface NiceScriptRunnerProps extends NiceBaseProps {
19604
- /** Script source (controlled). */
19605
- value: string;
19687
+ /** Script source (controlled). Omit it to let the runner keep its own. */
19688
+ value?: string;
19689
+ /** Initial script source when uncontrolled. */
19690
+ defaultValue?: string;
19606
19691
  /** Script change callback. */
19607
19692
  onChange?: (value: string) => void;
19608
19693
  /** Editor language. Default `'javascript'`. */
@@ -19761,10 +19846,12 @@ export declare const NiceSearchInput: default_2.FC<NiceSearchInputProps>;
19761
19846
 
19762
19847
  /** Props for {@link NiceSearchInput} — text field with async suggestions + recents. */
19763
19848
  export declare interface NiceSearchInputProps extends NiceStandardProps {
19764
- /** Controlled search text. */
19765
- value: string;
19849
+ /** Search text (controlled). Omit it to let the input keep its own. */
19850
+ value?: string;
19851
+ /** Initial search text when uncontrolled. */
19852
+ defaultValue?: string;
19766
19853
  /** Fires on every keystroke. */
19767
- onChange: (value: string) => void;
19854
+ onChange?: (value: string) => void;
19768
19855
  /** Fires on Enter or when the user picks a suggestion. */
19769
19856
  onSearch?: (value: string) => void;
19770
19857
  /**
@@ -19965,10 +20052,9 @@ export declare interface NiceSensorGaugePanelProps extends NiceBaseProps {
19965
20052
  */
19966
20053
  export declare const NiceSetupWizard: default_2.ForwardRefExoticComponent<NiceSetupWizardProps & default_2.RefAttributes<HTMLDivElement>>;
19967
20054
 
19968
- /** Props */
19969
20055
  export declare interface NiceSetupWizardProps {
19970
- /** Step definitions */
19971
- steps: SetupWizardStep[];
20056
+ /** Step definitions. Defaults to none. */
20057
+ steps?: SetupWizardStep[];
19972
20058
  /** Initial values */
19973
20059
  initialValues?: Record<string, unknown>;
19974
20060
  /** Controlled current step */
@@ -20425,8 +20511,10 @@ export declare interface NiceSignatureStroke {
20425
20511
  export declare function NiceSimpleCodeEditor(props: NiceSimpleCodeEditorProps): default_2.ReactElement;
20426
20512
 
20427
20513
  export declare interface NiceSimpleCodeEditorProps {
20428
- /** Code value */
20429
- value: string;
20514
+ /** Code (controlled). Omit it to let the editor keep its own. */
20515
+ value?: string;
20516
+ /** Initial code when uncontrolled. */
20517
+ defaultValue?: string;
20430
20518
  /** Value change callback */
20431
20519
  onChange?: (value: string) => void;
20432
20520
  /** Language (for highlighting class) */
@@ -21302,10 +21390,12 @@ export declare const NiceTagBox: default_2.FC<NiceTagBoxProps>;
21302
21390
  export declare interface NiceTagBoxProps extends NiceFormFieldProps {
21303
21391
  /** Available options. */
21304
21392
  options?: NiceOption[];
21305
- /** Array of selected values. */
21306
- value: string[];
21393
+ /** Array of selected values (controlled). Omit it to let the box keep its own. */
21394
+ value?: string[];
21395
+ /** Initial selection when uncontrolled. */
21396
+ defaultValue?: string[];
21307
21397
  /** Called when the selection changes. */
21308
- onChange: (value: string[]) => void;
21398
+ onChange?: (value: string[]) => void;
21309
21399
  /** Enable search/filter within the dropdown. */
21310
21400
  searchable?: boolean;
21311
21401
  /** Show a clear-all button. */
@@ -21341,10 +21431,12 @@ export declare const NiceTagInput: default_2.FC<NiceTagInputProps>;
21341
21431
 
21342
21432
  /** Props for {@link NiceTagInput} — multi-value input rendering tags + textbox. */
21343
21433
  export declare interface NiceTagInputProps extends NiceStandardProps {
21344
- /** Controlled tag list. */
21345
- value: string[];
21434
+ /** Tag list (controlled). Omit it to let the input keep its own. */
21435
+ value?: string[];
21436
+ /** Initial tag list when uncontrolled. */
21437
+ defaultValue?: string[];
21346
21438
  /** Fires on every change. */
21347
- onChange: (tags: string[]) => void;
21439
+ onChange?: (tags: string[]) => void;
21348
21440
  /** Suggestions shown below the input as filterable dropdown. */
21349
21441
  suggestions?: string[];
21350
21442
  /** Hard cap on tag count. New entries beyond `maxTags` are rejected. */
@@ -21405,8 +21497,8 @@ export { NiceTaskInbox }
21405
21497
  export { NiceTaskInbox as NiceWorkflowTaskInbox }
21406
21498
 
21407
21499
  export declare interface NiceTaskInboxProps extends NiceBaseProps {
21408
- /** List of tasks to display */
21409
- tasks: WorkflowTask[];
21500
+ /** List of tasks to display. Defaults to none. */
21501
+ tasks?: WorkflowTask[];
21410
21502
  /** Currently selected task ID */
21411
21503
  selectedTaskId?: string;
21412
21504
  /** Called when a task is selected */
@@ -21436,12 +21528,15 @@ export declare interface NiceTaskInboxProps extends NiceBaseProps {
21436
21528
  export declare const NiceTempDial: default_2.FC<NiceTempDialProps>;
21437
21529
 
21438
21530
  export declare interface NiceTempDialProps extends NiceBaseProps {
21439
- value: number;
21531
+ /** Set temperature (controlled). Omit it to let the dial keep its own. */
21532
+ value?: number;
21533
+ /** Initial set temperature when uncontrolled. Defaults to `min`. */
21534
+ defaultValue?: number;
21440
21535
  currentTemp?: number;
21441
21536
  min?: number;
21442
21537
  max?: number;
21443
21538
  step?: number;
21444
- onChange: (value: number) => void;
21539
+ onChange?: (value: number) => void;
21445
21540
  mode?: TempDialMode;
21446
21541
  size?: NiceSize;
21447
21542
  showCurrentTemp?: boolean;
@@ -22718,8 +22813,8 @@ export declare interface NiceTutorialHostProps {
22718
22813
 
22719
22814
  /** Props for the {@link NiceTutorial} component — a guided walkthrough overlay with step-by-step highlighting. */
22720
22815
  export declare interface NiceTutorialProps {
22721
- /** Array of ordered tutorial steps */
22722
- steps: NiceTutorialStep[];
22816
+ /** Array of ordered tutorial steps. Defaults to none. */
22817
+ steps?: NiceTutorialStep[];
22723
22818
  /** Starts the tutorial when true */
22724
22819
  active: boolean;
22725
22820
  /** Called when tutorial finishes (last step completed) */
@@ -23088,9 +23183,11 @@ export declare const NiceValidationBuilder: default_2.FC<NiceValidationBuilderPr
23088
23183
  export declare interface NiceValidationBuilderProps extends NiceBaseProps {
23089
23184
  /** Fields that rules may target (reuses the filter field descriptor). */
23090
23185
  fields: NiceFilterField[];
23091
- /** The validation rules (controlled). */
23092
- value: NiceFieldValidationRule[];
23093
- onChange: (rules: NiceFieldValidationRule[]) => void;
23186
+ /** The validation rules (controlled). Omit it to let the builder keep its own. */
23187
+ value?: NiceFieldValidationRule[];
23188
+ /** Initial rules when uncontrolled. */
23189
+ defaultValue?: NiceFieldValidationRule[];
23190
+ onChange?: (rules: NiceFieldValidationRule[]) => void;
23094
23191
  /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
23095
23192
  tutorial?: NiceComponentTutorial;
23096
23193
  }
@@ -23865,10 +23962,9 @@ export { NiceWebSocketMessageType }
23865
23962
  */
23866
23963
  export declare const NiceWiki: default_2.ForwardRefExoticComponent<NiceWikiProps & default_2.RefAttributes<HTMLDivElement>>;
23867
23964
 
23868
- /** Props for the {@link NiceWiki} component. */
23869
23965
  export declare interface NiceWikiProps extends NiceFormFieldProps {
23870
- /** Page tree. */
23871
- pages: WikiPage[];
23966
+ /** Page tree. Defaults to none. */
23967
+ pages?: WikiPage[];
23872
23968
  /** Currently selected page id. */
23873
23969
  selectedPageId?: string | number;
23874
23970
  /** Content of the currently selected page (HTML or Markdown). */
@@ -23959,8 +24055,8 @@ export declare interface NiceWindowPosition {
23959
24055
  export declare interface NiceWindowProps extends NiceBaseProps {
23960
24056
  /** Unique window identifier. Auto-generated if not provided. */
23961
24057
  windowKey?: string;
23962
- /** Window title. */
23963
- title: string;
24058
+ /** Window title. Optional — without one the title bar is empty and the dialog carries no aria-label. */
24059
+ title?: string;
23964
24060
  /** Icon displayed in title bar */
23965
24061
  icon?: React.ReactNode;
23966
24062
  /** Window content */
@@ -24087,10 +24183,9 @@ export declare interface NiceWindowState {
24087
24183
  */
24088
24184
  export declare const NiceWizard: default_2.ForwardRefExoticComponent<NiceWizardProps & default_2.RefAttributes<HTMLDivElement>>;
24089
24185
 
24090
- /** Props for the {@link NiceWizard} component. */
24091
24186
  export declare interface NiceWizardProps {
24092
- /** Step definitions. */
24093
- steps: WizardStep[];
24187
+ /** Step definitions. Defaults to none. */
24188
+ steps?: WizardStep[];
24094
24189
  /** Controlled current step index. */
24095
24190
  activeStep?: number;
24096
24191
  /** Called when step changes. */