@nice2dev/ui 1.3.7 → 1.3.9

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 (66) hide show
  1. package/CHANGELOG.md +116 -0
  2. package/dist/NiceCodeEditor-B5YtKZOe.js +1222 -0
  3. package/dist/NiceCodeEditor-D0QZW88r.cjs +268 -0
  4. package/dist/NiceColorPicker-Bzvei7D6.cjs +1 -0
  5. package/dist/NiceColorPicker-DzzJhSXT.js +552 -0
  6. package/dist/NiceDataGrid-BSaBBoNr.js +2267 -0
  7. package/dist/NiceDataGrid-C_E6zIGS.cjs +10 -0
  8. package/dist/NiceForm-D2P6XuaT.cjs +1 -0
  9. package/dist/NiceForm-_kaB4Ikt.js +5017 -0
  10. package/dist/NiceHtmlEditor-CBCJdjmy.cjs +10 -0
  11. package/dist/NiceHtmlEditor-DfkdSxL3.js +901 -0
  12. package/dist/NiceLoginForm-BFvbroGJ.js +820 -0
  13. package/dist/NiceLoginForm-FGf32sro.cjs +1 -0
  14. package/dist/NiceMention-CctjYriS.cjs +430 -0
  15. package/dist/NiceMention-umOghLCf.js +11653 -0
  16. package/dist/NiceModal-BRVzjuUN.cjs +1 -0
  17. package/dist/NiceModal-CU9FqzIH.js +83 -0
  18. package/dist/NiceModuleLifecyclePanel-DQT_forg.js +7404 -0
  19. package/dist/NiceModuleLifecyclePanel-DtOlPChV.cjs +1 -0
  20. package/dist/NicePagination-CK4ZJgu4.cjs +1 -0
  21. package/dist/NicePagination-flHgG-FT.js +200 -0
  22. package/dist/NicePivotGrid-99ZeQ9j6.js +1180 -0
  23. package/dist/NicePivotGrid-CpsBxUhq.cjs +152 -0
  24. package/dist/NiceSavedQueryPanel-B8hVgWR2.cjs +587 -0
  25. package/dist/NiceSavedQueryPanel-BFtY9GOP.js +6002 -0
  26. package/dist/NiceSavedQueryPanel-Br1LQR7u.js +5311 -0
  27. package/dist/NiceSavedQueryPanel-C4SU6W22.cjs +586 -0
  28. package/dist/NiceScheduler-CeYqH0Ux.cjs +5 -0
  29. package/dist/NiceScheduler-yTpVRxfe.js +1710 -0
  30. package/dist/NiceSelect-C3NqDYwR.js +495 -0
  31. package/dist/NiceSelect-CTwSAb8G.cjs +1 -0
  32. package/dist/NiceTree.doc-AIR9cRQp.js +40 -0
  33. package/dist/NiceTree.doc-DGrIAx3G.cjs +16 -0
  34. package/dist/charts-B0tHOpJ7.cjs +768 -0
  35. package/dist/charts-C3u-VyJj.js +5019 -0
  36. package/dist/charts.cjs +1 -1
  37. package/dist/charts.mjs +1 -1
  38. package/dist/core-lazy-Bglo0hFt.cjs +1 -0
  39. package/dist/core-lazy-CRBgQkQl.js +351 -0
  40. package/dist/data.cjs +1 -1
  41. package/dist/data.d.ts +146 -12
  42. package/dist/data.mjs +3 -3
  43. package/dist/devops-Bzp3ZqZ3.cjs +18 -0
  44. package/dist/devops-fLElpPvD.js +9128 -0
  45. package/dist/devops.cjs +1 -1
  46. package/dist/devops.mjs +1 -1
  47. package/dist/editors.cjs +1 -1
  48. package/dist/editors.d.ts +5 -0
  49. package/dist/editors.mjs +7 -7
  50. package/dist/feedback.cjs +1 -1
  51. package/dist/feedback.mjs +3 -3
  52. package/dist/index.cjs +252 -252
  53. package/dist/index.css +1 -1
  54. package/dist/index.d.ts +221 -21
  55. package/dist/index.mjs +16036 -15771
  56. package/dist/lazy.cjs +1 -1
  57. package/dist/lazy.mjs +18 -18
  58. package/dist/navigation.cjs +1 -1
  59. package/dist/navigation.d.ts +42 -3
  60. package/dist/navigation.mjs +2 -2
  61. package/dist/no-code-Bt7SWzsN.js +8318 -0
  62. package/dist/no-code-DnT061qn.cjs +331 -0
  63. package/dist/no-code.cjs +1 -1
  64. package/dist/no-code.mjs +1 -1
  65. package/dist/style.css +1 -1
  66. package/package.json +4 -4
package/dist/index.d.ts CHANGED
@@ -9372,7 +9372,7 @@ export declare const NiceCheckbox: default_2.ForwardRefExoticComponent<NiceCheck
9372
9372
  * multi-selection. Keeps controlled / uncontrolled state in sync via
9373
9373
  * the standard pattern.
9374
9374
  */
9375
- export declare function NiceCheckboxGroup<T = string>({ value, defaultValue, options, disabled, direction, name, onChange, className, style, }: NiceCheckboxGroupProps<T>): default_2.ReactElement;
9375
+ export declare function NiceCheckboxGroup<T = string>({ value, defaultValue, options, disabled, direction, name, onChange, className, style, testId, 'data-testid': dataTestId, }: NiceCheckboxGroupProps<T>): default_2.ReactElement;
9376
9376
 
9377
9377
  export declare namespace NiceCheckboxGroup {
9378
9378
  var displayName: string;
@@ -15203,6 +15203,11 @@ export declare interface NiceLanguagePickerProps extends NiceFormFieldProps, Dua
15203
15203
  allowClear?: boolean;
15204
15204
  /** Size variant */
15205
15205
  size?: NiceSize;
15206
+ /**
15207
+ * Accessible name of the trigger (1.3.8). Default: none while a `label` or the language's name
15208
+ * shows; otherwise (compact: a flag only) the translated "Language: {name}".
15209
+ */
15210
+ 'aria-label'?: string;
15206
15211
  /** Test ID */
15207
15212
  'data-testid'?: string;
15208
15213
  }
@@ -17347,6 +17352,18 @@ export declare interface NiceNavShellProps {
17347
17352
  colorStyle?: 'bar' | 'fill';
17348
17353
  /** Extra props for the built-in NiceSidebarNav (rendered from `sidebarData`), e.g. `levelColors`. */
17349
17354
  sidebarProps?: Partial<NiceSidebarNavProps>;
17355
+ /**
17356
+ * The sidebar's preferences when the host keeps them itself, e.g. on its server (1.3.8) — the
17357
+ * same object it passes to its own `NiceSidebarNav` as `preferences`. The preference pages
17358
+ * (`preferences/*`) then read and change these instead of the library's localStorage, the shell
17359
+ * takes `pageMode` / `colorStyle` from them, and the pages' routes are merged in even with your
17360
+ * own `sidebar` slot. The Order page lists the items of `sidebarData`; without it (which also
17361
+ * brings a NiceTopNav when there is no `topNav`), render `NiceSidebarPrefsOrder data={…}` under
17362
+ * a route of your own. The pages' route keys have no leading slash (`preferences/general`).
17363
+ */
17364
+ sidebarPreferences?: Partial<SidebarNavUserPrefs>;
17365
+ /** Receives the preference pages' changes, like `NiceSidebarNav.onPreferencesChange` (1.3.8). */
17366
+ onSidebarPreferencesChange?: SidebarNavPrefsChangeHandler;
17350
17367
  /**
17351
17368
  * Resolves a route key to a URL. Forwarded to the auto-rendered
17352
17369
  * `NiceSidebarNav` so its right-click context menu can show "Open in
@@ -17356,8 +17373,8 @@ export declare interface NiceNavShellProps {
17356
17373
  /**
17357
17374
  * Auto-merge the built-in sidebar preference page routes
17358
17375
  * (`preferences/general`, `/display`, `/order`, `/hidden`, `/reset`) into
17359
- * `routes`. Defaults to `true` when `sidebarData` is provided. User-defined
17360
- * routes with matching keys still win.
17376
+ * `routes`. Defaults to `true` when `sidebarData` or `sidebarPreferences` (1.3.8) is provided.
17377
+ * User-defined routes with matching keys still win.
17361
17378
  */
17362
17379
  includeSidebarPreferenceRoutes?: boolean;
17363
17380
  /**
@@ -18194,6 +18211,11 @@ export declare interface NicePasswordRule {
18194
18211
  label: string;
18195
18212
  /** Test function — returns true if the rule is satisfied */
18196
18213
  test: (value: string) => boolean;
18214
+ /**
18215
+ * A must-have rule (1.3.8): while it fails, the strength is `weak` however many other rules
18216
+ * pass — a 6-character password under a 12-character policy no longer reads "Good".
18217
+ */
18218
+ required?: boolean;
18197
18219
  }
18198
18220
 
18199
18221
  /**
@@ -20763,8 +20785,13 @@ export declare interface NiceSetupWizardProps {
20763
20785
  steps?: SetupWizardStep[];
20764
20786
  /** Initial values */
20765
20787
  initialValues?: Record<string, unknown>;
20766
- /** Controlled current step */
20788
+ /** Controlled current step — a new value moves the wizard to that step (1.3.8: not only on mount). */
20767
20789
  activeStep?: string;
20790
+ /**
20791
+ * Steps to show as completed (a check mark), whether or not they were visited in this mount
20792
+ * (1.3.8) — e.g. the steps a server already has done.
20793
+ */
20794
+ completedSteps?: string[];
20768
20795
  /** Layout variant */
20769
20796
  layout?: SetupWizardLayout;
20770
20797
  /** Size */
@@ -21012,8 +21039,13 @@ export declare interface NiceSidebarNavProps {
21012
21039
  * loading from localStorage. Changes still fire onPreferencesChange.
21013
21040
  */
21014
21041
  preferences?: Partial<SidebarNavUserPrefs>;
21015
- /** Called whenever preferences change (for server-side persistence) */
21016
- onPreferencesChange?: (prefs: SidebarNavUserPrefs) => void;
21042
+ /**
21043
+ * Called whenever preferences change (for server-side persistence). `prefs` is the whole object,
21044
+ * including the defaults of fields the user never touched (e.g. `pageMode: 'auto'`) — a host
21045
+ * that stores it whole keeps those defaults as if chosen. `changed` (1.3.8) holds only the fields
21046
+ * this change set: store that to keep the user's choices alone.
21047
+ */
21048
+ onPreferencesChange?: SidebarNavPrefsChangeHandler;
21017
21049
  /** Sidebar width in px (default: 264) */
21018
21050
  width?: number;
21019
21051
  /** Sidebar width in px when collapsed/icon-only (default: 56). */
@@ -22692,6 +22724,11 @@ export declare interface NiceThemePickerProps extends NiceFormFieldProps, DualVi
22692
22724
  allowClear?: boolean;
22693
22725
  /** Size variant */
22694
22726
  size?: NiceSize;
22727
+ /**
22728
+ * Accessible name of the trigger (1.3.8). Default: none while a `label` or the theme's name
22729
+ * shows; otherwise (compact: a swatch only) the translated "Theme: {name}".
22730
+ */
22731
+ 'aria-label'?: string;
22695
22732
  /** Test ID */
22696
22733
  'data-testid'?: string;
22697
22734
  }
@@ -23270,6 +23307,33 @@ export { NiceTransitionState }
23270
23307
 
23271
23308
  export { NiceTranslateFn }
23272
23309
 
23310
+ /**
23311
+ * treeCheck — the check state of a tree with cascading checkboxes, shared by NiceTreeGrid,
23312
+ * NiceTreeList and NiceTreeView.
23313
+ *
23314
+ * - A **check node** is a node that can carry a checkbox (`isCheckable`, default true).
23315
+ * - A **check leaf** is a check node without check nodes below it — a module whose children are
23316
+ * only informational rows is a leaf. The check state lives on the leaves; every other node's
23317
+ * state is derived from the leaves below it: checked when all are, indeterminate when some are.
23318
+ * - A node that is **not checkable** never has a checkbox and is never emitted. Above check
23319
+ * nodes (a group header) it is transparent: its ancestors count the leaves below it.
23320
+ * - A **locked** leaf (disabled, or below a disabled node with `inheritDisabled`) keeps its
23321
+ * state when an ancestor is toggled. A parent still shows checked only when all its leaves are,
23322
+ * locked ones included.
23323
+ *
23324
+ * The leaves of every node form one contiguous slice of `index.leaves` (pre-order), so states
23325
+ * and counts are O(1) from a prefix sum; building the index and emitting keys are O(n).
23326
+ */
23327
+ export declare type NiceTreeCheckState = 'checked' | 'unchecked' | 'indeterminate';
23328
+
23329
+ /**
23330
+ * Which keys a checked tree reports:
23331
+ * - `'all'` — every check node whose leaves are all checked (parents and leaves);
23332
+ * - `'leaves'` — only the checked leaves;
23333
+ * - `'parents'` — the topmost fully checked nodes (a fully checked parent stands for its subtree).
23334
+ */
23335
+ export declare type NiceTreeCheckStrategy = 'all' | 'leaves' | 'parents';
23336
+
23273
23337
  /** A context-menu action for {@link NiceTreeView} nodes. */
23274
23338
  export declare interface NiceTreeContextMenuItem {
23275
23339
  /** Unique key. */
@@ -23282,16 +23346,31 @@ export declare interface NiceTreeContextMenuItem {
23282
23346
  disabled?: boolean;
23283
23347
  }
23284
23348
 
23285
- export declare function NiceTreeGrid<T extends NiceTreeGridNode>({ columns, data, keyField, parentKeyField, nested, childrenField, expandedKeys: controlledExpanded, onExpandedChange, defaultExpandAll, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, searchable, searchPlaceholder, striped, compact, size, loading, disabled, readOnly, error, emptyText, toolbar, onRowClick, className, style, }: NiceTreeGridProps<T>): default_2.JSX.Element;
23349
+ export declare function NiceTreeGrid<T extends NiceTreeGridNode>({ columns, data, keyField, parentKeyField, nested, childrenField, expandedKeys: controlledExpanded, defaultExpandedKeys, onExpandedChange, defaultExpandAll, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, checkable, checkedKeys, defaultCheckedKeys, onCheckedChange, checkStrategy, isRowCheckable, isRowDisabled, checkboxPlacement, checkOnRowClick, showCheckedCount, showSelectAll, showOnlyChecked: controlledOnlyChecked, defaultShowOnlyChecked, onShowOnlyCheckedChange, toolbarActions, searchable, searchPlaceholder, searchText, defaultSearchText, onSearchChange, searchFields, searchFilter, searchKeepDescendants, searchAutoExpand, highlightMatches, rowClassName, getRowLabel, virtualScroll, rowHeight, height, striped, compact, size, loading, disabled, readOnly, error, emptyText, toolbar, onRowClick, className, style, id, testId, 'data-testid': dataTestId, accessMode, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, }: NiceTreeGridProps<T>): default_2.JSX.Element | null;
23350
+
23351
+ /** What changed in a {@link NiceTreeGrid} check — the second argument of `onCheckedChange`. */
23352
+ export declare interface NiceTreeGridCheckInfo<T = NiceTreeGridNode> {
23353
+ /** A row's checkbox (or Space / a row click), the header's "select all", or "clear selection". */
23354
+ source: 'row' | 'selectAll' | 'clear';
23355
+ /** Whether rows went on. */
23356
+ checked: boolean;
23357
+ /** The toggled row (source `'row'`). */
23358
+ key?: string;
23359
+ row?: T;
23360
+ /** The checked leaves, whatever `checkStrategy` reports. */
23361
+ leafKeys: string[];
23362
+ /** Rows with checkboxes that are partly checked. */
23363
+ halfCheckedKeys: string[];
23364
+ }
23286
23365
 
23287
23366
  /** A row node in the {@link NiceTreeGrid} (supports index-signature for dynamic fields). */
23288
23367
  export declare interface NiceTreeGridNode {
23289
23368
  [field: string]: unknown;
23290
23369
  }
23291
23370
 
23292
- /** Props for the {@link NiceTreeGrid} component — a hierarchical data grid with sorting, selection, search, and NiceDataGrid column features. */
23293
- export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTreeGridNode> extends NiceBaseProps {
23294
- /** Column definitions (reuses NiceDataGridColumn). */
23371
+ /** Props for the {@link NiceTreeGrid} component — a hierarchical data grid with sorting, selection, cascading checkboxes, search, and NiceDataGrid column features. */
23372
+ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTreeGridNode> extends NiceStandardProps {
23373
+ /** Column definitions (reuses NiceDataGridColumn). The tree (indent, expander, checkbox) sits in the first one. */
23295
23374
  columns?: NiceDataGridColumn<T>[];
23296
23375
  /** Row data. */
23297
23376
  data?: T[];
@@ -23305,9 +23384,11 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
23305
23384
  childrenField?: string;
23306
23385
  /** Currently expanded keys. */
23307
23386
  expandedKeys?: string[];
23308
- /** Called when expanded keys change. */
23387
+ /** Rows expanded until the user expands or collapses one (uncontrolled). */
23388
+ defaultExpandedKeys?: string[];
23389
+ /** Called when expanded keys change. Not called for the rows a search opens. */
23309
23390
  onExpandedChange?: (keys: string[]) => void;
23310
- /** Expand all nodes by default. */
23391
+ /** Expand all nodes by default — also rows that arrive later, until the user toggles one. */
23311
23392
  defaultExpandAll?: boolean;
23312
23393
  /** Enable sorting. */
23313
23394
  sortable?: boolean;
@@ -23317,16 +23398,92 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
23317
23398
  sortDirection?: SortDirection;
23318
23399
  /** Called when sort changes. */
23319
23400
  onSort?: (field: string, direction: SortDirection) => void;
23320
- /** Enable row selection. */
23401
+ /**
23402
+ * Enable flat row selection: a checkbox per row, no cascade. With `checkable` the checkbox
23403
+ * belongs to the check and a row click toggles this selection (row highlight).
23404
+ */
23321
23405
  selectable?: boolean;
23322
23406
  /** Currently selected keys. */
23323
23407
  selectedKeys?: Set<string>;
23324
23408
  /** Called when selection changes. */
23325
23409
  onSelectionChange?: (keys: Set<string>) => void;
23410
+ /**
23411
+ * Cascading checkboxes: checking a parent checks every row below it, a parent shows checked
23412
+ * when all rows below it are and indeterminate when some are.
23413
+ */
23414
+ checkable?: boolean;
23415
+ /** Checked keys (controlled). A parent key checks its whole subtree. */
23416
+ checkedKeys?: string[];
23417
+ /** Checked keys at mount (uncontrolled). */
23418
+ defaultCheckedKeys?: string[];
23419
+ /** Called with the checked keys (see `checkStrategy`) and what changed. */
23420
+ onCheckedChange?: (keys: string[], info: NiceTreeGridCheckInfo<T>) => void;
23421
+ /**
23422
+ * Which keys `onCheckedChange` reports: `'all'` (default) every fully checked row, parents
23423
+ * included; `'leaves'` only the checked rows with no checkboxes below them; `'parents'` the
23424
+ * topmost fully checked rows. Keys of rows not in `data` are kept.
23425
+ */
23426
+ checkStrategy?: NiceTreeCheckStrategy;
23427
+ /**
23428
+ * `false` makes a row informational: no checkbox, never reported. Above checkable rows it is a
23429
+ * group header its ancestors count through; below a checkable row (a module's categories) the
23430
+ * checkable row counts as a leaf.
23431
+ */
23432
+ isRowCheckable?: (row: T) => boolean;
23433
+ /** `true` locks a row and every row below it: their checks keep their state. */
23434
+ isRowDisabled?: (row: T) => boolean;
23435
+ /** Where the checkboxes go: after the expander in the tree column (default) or a column of their own. */
23436
+ checkboxPlacement?: 'tree' | 'column';
23437
+ /** A row click toggles the row's checkbox. */
23438
+ checkOnRowClick?: boolean;
23439
+ /** Show a "checked / total" badge on rows with checkboxes below them. */
23440
+ showCheckedCount?: boolean;
23441
+ /** A "select all" checkbox in the header — while searching, it acts on the results. Default true. */
23442
+ showSelectAll?: boolean;
23443
+ /** Show only the checked rows (controlled). */
23444
+ showOnlyChecked?: boolean;
23445
+ /** Show only the checked rows at mount (uncontrolled). */
23446
+ defaultShowOnlyChecked?: boolean;
23447
+ /** Called when "show selected only" is switched. */
23448
+ onShowOnlyCheckedChange?: (value: boolean) => void;
23449
+ /**
23450
+ * Built-in toolbar buttons: `true` for all that apply (expand all, collapse all and — when
23451
+ * `checkable` — show selected only, clear selection), or a list of them.
23452
+ */
23453
+ toolbarActions?: boolean | NiceTreeGridToolbarAction[];
23326
23454
  /** Show a search box. */
23327
23455
  searchable?: boolean;
23328
23456
  /** Search input placeholder. */
23329
23457
  searchPlaceholder?: string;
23458
+ /** Search text (controlled). */
23459
+ searchText?: string;
23460
+ /** Search text at mount (uncontrolled). */
23461
+ defaultSearchText?: string;
23462
+ /** Called when the search text changes. */
23463
+ onSearchChange?: (text: string) => void;
23464
+ /** Fields the search looks in (default: the visible columns). */
23465
+ searchFields?: string[];
23466
+ /** Own match test, instead of a substring of `searchFields`. */
23467
+ searchFilter?: (row: T, query: string) => boolean;
23468
+ /** A matching row keeps all rows below it, not only the matching ones. */
23469
+ searchKeepDescendants?: boolean;
23470
+ /** Open the rows above every match while searching (default true); the user's own expansion comes back when the search is cleared. */
23471
+ searchAutoExpand?: boolean;
23472
+ /** Mark the matches in columns without a `render` (default true). */
23473
+ highlightMatches?: boolean;
23474
+ /** Extra class name of a row. */
23475
+ rowClassName?: string | ((row: T, index: number) => string | undefined);
23476
+ /** A row's name for its checkbox label (default: its first column's value). */
23477
+ getRowLabel?: (row: T) => string;
23478
+ /**
23479
+ * Render only the rows in view, for thousands of rows. Rows get a fixed height (`rowHeight`)
23480
+ * and long cells are cut with an ellipsis.
23481
+ */
23482
+ virtualScroll?: boolean;
23483
+ /** Row height in px with `virtualScroll` (default 36). */
23484
+ rowHeight?: number;
23485
+ /** Height of the scrolling body with `virtualScroll` (default 480). */
23486
+ height?: number | string;
23330
23487
  /** Alternate row coloring. */
23331
23488
  striped?: boolean;
23332
23489
  /** Reduced padding. */
@@ -23349,6 +23506,9 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
23349
23506
  onRowClick?: (row: T) => void;
23350
23507
  }
23351
23508
 
23509
+ /** A built-in toolbar button of {@link NiceTreeGrid}. */
23510
+ export declare type NiceTreeGridToolbarAction = 'expandAll' | 'collapseAll' | 'onlyChecked' | 'clearChecked';
23511
+
23352
23512
  export declare function NiceTreeList<T extends NiceTreeListNode>({ columns, data, keyField, parentKeyField, expandedKeys: controlledExpanded, onExpandedChange, selectedKeys, onSelectionChange, selectable, sortable, loading, emptyText, className, style, accessMode, id, }: NiceTreeListProps<T>): default_2.JSX.Element | null;
23353
23513
 
23354
23514
  /** A tree-list node for the {@link NiceTreeList} component. */
@@ -23377,11 +23537,17 @@ export declare interface NiceTreeListProps<T extends NiceTreeListNode = NiceTree
23377
23537
  expandedKeys?: string[];
23378
23538
  /** Called when expanded keys change. */
23379
23539
  onExpandedChange?: (keys: string[]) => void;
23380
- /** Currently selected keys. */
23540
+ /**
23541
+ * Currently selected keys. A parent key selects its whole subtree. The keys handed back are every
23542
+ * fully selected row, parents included, in document order; keys of rows not in `data` are kept.
23543
+ */
23381
23544
  selectedKeys?: string[];
23382
23545
  /** Called when selection changes. */
23383
23546
  onSelectionChange?: (keys: string[]) => void;
23384
- /** Enable row selection. Checking a parent row cascades to all its descendants. */
23547
+ /**
23548
+ * Enable row selection. Checking a parent row cascades to all its descendants; a parent shows
23549
+ * checked when all its descendants are, indeterminate when some are.
23550
+ */
23385
23551
  selectable?: boolean;
23386
23552
  /** Enable column sorting (opt-in per column via `NiceDataGridColumn.sortable`). */
23387
23553
  sortable?: boolean;
@@ -23461,9 +23627,9 @@ export declare interface NiceTreeNode {
23461
23627
  icon?: default_2.ReactNode;
23462
23628
  /** Child nodes. */
23463
23629
  children?: NiceTreeNode[];
23464
- /** Disable the node. */
23630
+ /** Disable the node. With cascading checkboxes, its own checkbox keeps its state. */
23465
23631
  disabled?: boolean;
23466
- /** Default expanded state. */
23632
+ /** Expanded when the tree mounts (uncontrolled `expandedKeys` only). */
23467
23633
  expanded?: boolean;
23468
23634
  /** If true, children are loaded lazily via onLoadChildren. */
23469
23635
  leaf?: boolean;
@@ -23517,7 +23683,11 @@ export declare interface NiceTreeViewProps extends NiceBaseProps {
23517
23683
  * a title bar, toolbar or count. Pass any node; omit for no header.
23518
23684
  */
23519
23685
  header?: default_2.ReactNode;
23520
- /** Currently selected node keys. */
23686
+ /**
23687
+ * Currently selected node keys. With `showCheckboxes` and `selectionMode="multiple"` the
23688
+ * checkboxes cascade: a parent key checks its subtree, and the keys handed back are every fully
23689
+ * checked node, parents included, in document order.
23690
+ */
23521
23691
  selectedKeys?: string[];
23522
23692
  /** Currently expanded node keys. */
23523
23693
  expandedKeys?: string[];
@@ -27097,6 +27267,18 @@ export declare interface SetupWizardStep {
27097
27267
  badge?: default_2.ReactNode;
27098
27268
  /** Estimated time to complete (displayed to user) */
27099
27269
  estimatedTime?: string;
27270
+ /**
27271
+ * `false`: no way back from this step (1.3.8) — no Back button, and `goPrev` / LB do nothing
27272
+ * (e.g. while an installation runs and after it). Default: `true`.
27273
+ */
27274
+ canGoBack?: boolean;
27275
+ /**
27276
+ * `false`: the main button is disabled on this step, without a validation message, and
27277
+ * `goNext` / RB do nothing (1.3.8) — e.g. until a restarted server is back. Default: `true`.
27278
+ */
27279
+ canProceed?: boolean;
27280
+ /** Label of the main button on this step only (1.3.8); wins over `labels.next` / `labels.finish`. */
27281
+ nextLabel?: string;
27100
27282
  }
27101
27283
 
27102
27284
  export { SHADOW_DARK_MODE_VALUES }
@@ -27261,6 +27443,13 @@ export declare interface SidebarNavPathEntry {
27261
27443
  icon?: ReactNode;
27262
27444
  }
27263
27445
 
27446
+ /**
27447
+ * Receives the sidebar preferences after a change: `prefs` whole (defaults included), `changed`
27448
+ * only the fields this change set (1.3.8) — the part to store when the host keeps the user's
27449
+ * choices on its server.
27450
+ */
27451
+ export declare type SidebarNavPrefsChangeHandler = (prefs: SidebarNavUserPrefs, changed: Partial<SidebarNavUserPrefs>) => void;
27452
+
27264
27453
  /** A role grouping modules */
27265
27454
  export declare interface SidebarNavRole extends SidebarNavBranchColors {
27266
27455
  id: string;
@@ -27414,7 +27603,7 @@ export declare interface SidebarPrefsCategory {
27414
27603
  icon: ReactNode;
27415
27604
  }
27416
27605
 
27417
- export declare function SidebarPrefsScopeProvider({ userId, data, tabsAvailable, children, }: SidebarPrefsScopeProviderProps): default_2.ReactElement;
27606
+ export declare function SidebarPrefsScopeProvider({ userId, data, tabsAvailable, preferences, onPreferencesChange, children, }: SidebarPrefsScopeProviderProps): default_2.ReactElement;
27418
27607
 
27419
27608
  export declare interface SidebarPrefsScopeProviderProps extends SidebarPrefsScopeValue {
27420
27609
  children: ReactNode;
@@ -27433,6 +27622,14 @@ export declare interface SidebarPrefsScopeValue {
27433
27622
  * page then lets the user choose how pages open. Unset outside a NavShell.
27434
27623
  */
27435
27624
  tabsAvailable?: boolean;
27625
+ /**
27626
+ * The preferences of a sidebar the host keeps itself (1.3.8) — e.g. on its server, passed to its
27627
+ * own `NiceSidebarNav` as `preferences`. The pages read and change these instead of the
27628
+ * library's localStorage; without them they keep to localStorage.
27629
+ */
27630
+ preferences?: Partial<SidebarNavUserPrefs>;
27631
+ /** Receives the pages' changes, like `NiceSidebarNav.onPreferencesChange` (1.3.8). */
27632
+ onPreferencesChange?: SidebarNavPrefsChangeHandler;
27436
27633
  }
27437
27634
 
27438
27635
  export declare interface SignalRLiveChartSourceConfig {
@@ -29772,9 +29969,12 @@ export { useShowAt }
29772
29969
 
29773
29970
  export { UseShowAtOptions }
29774
29971
 
29775
- export declare function useSidebarNavPrefs(userId: string | undefined, initialEnableModeIcons: boolean | undefined, controlledPrefs: Partial<SidebarNavUserPrefs> | undefined, onChange: ((prefs: SidebarNavUserPrefs) => void) | undefined): [SidebarNavUserPrefs, SidebarNavHelpers];
29972
+ export declare function useSidebarNavPrefs(userId: string | undefined, initialEnableModeIcons: boolean | undefined, controlledPrefs: Partial<SidebarNavUserPrefs> | undefined, onChange: SidebarNavPrefsChangeHandler | undefined): [SidebarNavUserPrefs, SidebarNavHelpers];
29776
29973
 
29777
- /** Resolve `{ userId, data, tabsAvailable }` for a preferences page. Props override context. */
29974
+ /**
29975
+ * Resolve `{ userId, data, tabsAvailable, preferences, onPreferencesChange }` for a preferences
29976
+ * page. Props override context.
29977
+ */
29778
29978
  export declare function useSidebarPrefsScope(overrides?: SidebarPrefsScopeValue): SidebarPrefsScopeValue;
29779
29979
 
29780
29980
  /** Shortcut for pages that only need the userId. */