@nice2dev/ui 1.3.8 → 1.3.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/CHANGELOG.md +107 -0
  2. package/dist/NiceColorPicker-BLwYNSXJ.cjs +1 -0
  3. package/dist/NiceColorPicker-DS59tNkP.js +552 -0
  4. package/dist/NiceDataGrid-CL2_7fS7.cjs +10 -0
  5. package/dist/NiceDataGrid-CpJrRN_H.js +2269 -0
  6. package/dist/NiceForm-BQj-K7p7.cjs +1 -0
  7. package/dist/NiceForm-HQ4h7hX_.js +5023 -0
  8. package/dist/NiceGantt-BygumlaY.cjs +1 -0
  9. package/dist/NiceGantt-DTC7OH-v.js +334 -0
  10. package/dist/NiceHtmlEditor-BtpuaLln.js +901 -0
  11. package/dist/NiceHtmlEditor-C1OVtLQ6.cjs +10 -0
  12. package/dist/NiceMention-CVxxCVtQ.js +11668 -0
  13. package/dist/NiceMention-Te66Oid1.cjs +430 -0
  14. package/dist/NiceModuleLifecyclePanel-DCrFyUH8.cjs +1 -0
  15. package/dist/NiceModuleLifecyclePanel-Mt80MdET.js +7441 -0
  16. package/dist/NicePagination-CKsAP38Q.cjs +1 -0
  17. package/dist/NicePagination-zOed5QxG.js +202 -0
  18. package/dist/NicePivotGrid-Clue9FM5.js +1184 -0
  19. package/dist/NicePivotGrid-Cnkr9WkC.cjs +152 -0
  20. package/dist/NiceSavedQueryPanel-B8hVgWR2.cjs +587 -0
  21. package/dist/NiceSavedQueryPanel-BFtY9GOP.js +6002 -0
  22. package/dist/NiceSavedQueryPanel-NgG58w6i.js +6226 -0
  23. package/dist/NiceSavedQueryPanel-lTWY2plm.cjs +587 -0
  24. package/dist/NiceScheduler-BWwqFKEc.js +1712 -0
  25. package/dist/NiceScheduler-DqWEJU7g.cjs +5 -0
  26. package/dist/NiceSelect-BNPXs6FQ.cjs +1 -0
  27. package/dist/NiceSelect-DEruWHan.js +495 -0
  28. package/dist/NiceTree.doc-AIR9cRQp.js +40 -0
  29. package/dist/NiceTree.doc-DGrIAx3G.cjs +16 -0
  30. package/dist/NiceWindow-D3V7A69Q.js +2247 -0
  31. package/dist/NiceWindow-pgR4c-kQ.cjs +1 -0
  32. package/dist/core-lazy-Bjdu111n.js +351 -0
  33. package/dist/core-lazy-Bx_8BOlG.cjs +1 -0
  34. package/dist/data.cjs +1 -1
  35. package/dist/data.d.ts +189 -14
  36. package/dist/data.mjs +3 -3
  37. package/dist/devops-CqhA0rjL.js +9130 -0
  38. package/dist/devops-cgRBnZVX.cjs +18 -0
  39. package/dist/devops.cjs +1 -1
  40. package/dist/devops.mjs +1 -1
  41. package/dist/editors.cjs +1 -1
  42. package/dist/editors.mjs +7 -7
  43. package/dist/feedback.cjs +1 -1
  44. package/dist/feedback.mjs +1 -1
  45. package/dist/index.cjs +130 -130
  46. package/dist/index.css +1 -1
  47. package/dist/index.d.ts +193 -17
  48. package/dist/index.mjs +14780 -14657
  49. package/dist/lazy.cjs +1 -1
  50. package/dist/lazy.mjs +15 -15
  51. package/dist/navigation.cjs +1 -1
  52. package/dist/navigation.d.ts +2 -0
  53. package/dist/navigation.mjs +3 -3
  54. package/dist/no-code-BQqK8mvU.cjs +331 -0
  55. package/dist/no-code-Cppb-xz3.js +8320 -0
  56. package/dist/no-code.cjs +1 -1
  57. package/dist/no-code.mjs +1 -1
  58. package/dist/overlays.cjs +1 -1
  59. package/dist/overlays.mjs +1 -1
  60. package/dist/pickerCommons-BA3-D5RC.js +663 -0
  61. package/dist/pickerCommons-KrBqCBDn.cjs +1 -0
  62. package/dist/style.css +1 -1
  63. package/package.json +4 -4
package/dist/index.d.ts CHANGED
@@ -9114,6 +9114,8 @@ export declare interface NiceCardProps extends NiceBaseProps {
9114
9114
  loading?: boolean;
9115
9115
  /** Error state — adds an error border; a non-empty string also renders a message. */
9116
9116
  error?: string | boolean;
9117
+ /** Test identifier (alias for `data-testid`), rendered on the card element. */
9118
+ testId?: string;
9117
9119
  }
9118
9120
 
9119
9121
  /** Value type used by selectable cards / card radio groups. */
@@ -15629,7 +15631,7 @@ export declare const NiceLiveDataGrid: (<T extends LiveGridRow = LiveGridRow>(pr
15629
15631
  displayName: string;
15630
15632
  };
15631
15633
 
15632
- declare function NiceLiveDataGridInner<T extends LiveGridRow = LiveGridRow>({ columns, data: initialData, dataSource, rowKey, showConnectionStatus, highlightDuration, updateAnimation, maxRows, selectable, selectedIds, onSelectionChange, onRowClick, onUpdate, onConnectionStatusChange, emptyContent, loadingContent, sortable, sortField, sortDirection, onSortChange, virtualized: _virtualized, rowHeight, height, className, style, }: NiceLiveDataGridProps<T>, ref: default_2.ForwardedRef<NiceLiveDataGridRef<T>>): default_2.JSX.Element;
15634
+ declare function NiceLiveDataGridInner<T extends LiveGridRow = LiveGridRow>({ columns, data: initialData, dataSource, rowKey, showConnectionStatus, highlightDuration, updateAnimation, maxRows, selectable, selectedIds, onSelectionChange, onRowClick, onUpdate, onConnectionStatusChange, emptyContent, loadingContent, sortable, sortField, sortDirection, onSortChange, virtualized: _virtualized, rowHeight, height, className, style, 'data-testid': dataTestId, }: NiceLiveDataGridProps<T>, ref: default_2.ForwardedRef<NiceLiveDataGridRef<T>>): default_2.JSX.Element;
15633
15635
 
15634
15636
  /** Props for NiceLiveDataGrid */
15635
15637
  export declare interface NiceLiveDataGridProps<T extends LiveGridRow = LiveGridRow> extends NiceBaseProps {
@@ -17865,7 +17867,7 @@ export { NiceOnChange }
17865
17867
 
17866
17868
  export { NiceOnOpenChange }
17867
17869
 
17868
- export declare const NiceOnScreenKeyboard: (({ value: valueProp, defaultValue, caret: caretProp, onChange, onSubmit, onClose, language, languages, layout, multiline, masked, maxLength, enterLabel, showPreview, fieldLabel, modal, className, style, }: NiceOnScreenKeyboardProps) => default_2.JSX.Element) & {
17870
+ export declare const NiceOnScreenKeyboard: (({ value: valueProp, defaultValue, caret: caretProp, onChange, onSubmit, onClose, language, languages, layout, multiline, masked, maxLength, enterLabel, showPreview, fieldLabel, modal, className, "data-testid": dataTestId, style, }: NiceOnScreenKeyboardProps) => default_2.JSX.Element) & {
17869
17871
  displayName: string;
17870
17872
  };
17871
17873
 
@@ -21369,7 +21371,7 @@ export declare interface NiceSliderProps extends Omit<NiceFormFieldProps, 'label
21369
21371
  showTickLabels?: boolean;
21370
21372
  }
21371
21373
 
21372
- export declare function NiceSortable<T extends Record<string, unknown>>({ items, keyField, onReorder, renderItem, direction, handle, group: _group, disabled, className, style, }: NiceSortableProps<T>): default_2.JSX.Element;
21374
+ export declare function NiceSortable<T extends Record<string, unknown>>({ items, keyField, onReorder, renderItem, direction, handle, group: _group, disabled, className, style, 'data-testid': dataTestId, }: NiceSortableProps<T>): default_2.JSX.Element;
21373
21375
 
21374
21376
  export declare namespace NiceSortable {
21375
21377
  var displayName: string;
@@ -22772,7 +22774,7 @@ export { NiceThemeVariantProvider }
22772
22774
 
22773
22775
  export { NiceThemeVariantProviderProps }
22774
22776
 
22775
- export declare function NiceTileView<T extends NiceTileViewItem>({ items, tileWidth, tileHeight, direction, renderTile, onTileClick, loading, emptyText, className, style, }: NiceTileViewProps<T>): default_2.JSX.Element;
22777
+ export declare function NiceTileView<T extends NiceTileViewItem>({ items, tileWidth, tileHeight, direction, renderTile, onTileClick, loading, emptyText, className, style, 'data-testid': dataTestId, }: NiceTileViewProps<T>): default_2.JSX.Element;
22776
22778
 
22777
22779
  /** A tile item displayed by the {@link NiceTileView} component. */
22778
22780
  declare interface NiceTileViewItem {
@@ -23307,6 +23309,33 @@ export { NiceTransitionState }
23307
23309
 
23308
23310
  export { NiceTranslateFn }
23309
23311
 
23312
+ /**
23313
+ * treeCheck — the check state of a tree with cascading checkboxes, shared by NiceTreeGrid,
23314
+ * NiceTreeList and NiceTreeView.
23315
+ *
23316
+ * - A **check node** is a node that can carry a checkbox (`isCheckable`, default true).
23317
+ * - A **check leaf** is a check node without check nodes below it — a module whose children are
23318
+ * only informational rows is a leaf. The check state lives on the leaves; every other node's
23319
+ * state is derived from the leaves below it: checked when all are, indeterminate when some are.
23320
+ * - A node that is **not checkable** never has a checkbox and is never emitted. Above check
23321
+ * nodes (a group header) it is transparent: its ancestors count the leaves below it.
23322
+ * - A **locked** leaf (disabled, or below a disabled node with `inheritDisabled`) keeps its
23323
+ * state when an ancestor is toggled. A parent still shows checked only when all its leaves are,
23324
+ * locked ones included.
23325
+ *
23326
+ * The leaves of every node form one contiguous slice of `index.leaves` (pre-order), so states
23327
+ * and counts are O(1) from a prefix sum; building the index and emitting keys are O(n).
23328
+ */
23329
+ export declare type NiceTreeCheckState = 'checked' | 'unchecked' | 'indeterminate';
23330
+
23331
+ /**
23332
+ * Which keys a checked tree reports:
23333
+ * - `'all'` — every check node whose leaves are all checked (parents and leaves);
23334
+ * - `'leaves'` — only the checked leaves;
23335
+ * - `'parents'` — the topmost fully checked nodes (a fully checked parent stands for its subtree).
23336
+ */
23337
+ export declare type NiceTreeCheckStrategy = 'all' | 'leaves' | 'parents';
23338
+
23310
23339
  /** A context-menu action for {@link NiceTreeView} nodes. */
23311
23340
  export declare interface NiceTreeContextMenuItem {
23312
23341
  /** Unique key. */
@@ -23319,16 +23348,43 @@ export declare interface NiceTreeContextMenuItem {
23319
23348
  disabled?: boolean;
23320
23349
  }
23321
23350
 
23322
- 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;
23351
+ export declare function NiceTreeGrid<T extends NiceTreeGridNode>({ columns, data, keyField, parentKeyField, nested, childrenField, expandedKeys: controlledExpanded, defaultExpandedKeys, onExpandedChange, hasChildren, loadChildren, rowActions, defaultExpandAll, sortable, sortField: controlledSortField, sortDirection: controlledSortDir, onSort, selectable, selectedKeys: controlledSelected, onSelectionChange, checkable, checkedKeys, defaultCheckedKeys, onCheckedChange, checkStrategy, isRowCheckable, isRowDisabled, checkboxPlacement, checkOnRowClick, showCheckedCount, checkedSummary, 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;
23352
+
23353
+ /** What a `checkedSummary` function of {@link NiceTreeGrid} gets. */
23354
+ declare interface NiceTreeGridCheckedSummaryInfo<T = NiceTreeGridNode> {
23355
+ /** Checked rows that count: rows with a checkbox and no checkboxes below them. */
23356
+ checked: number;
23357
+ /** All rows that count. */
23358
+ total: number;
23359
+ /** Keys of the checked rows that count. */
23360
+ leafKeys: string[];
23361
+ /** Their rows — e.g. to count distinct items when one item has a row under several parents. */
23362
+ rows: T[];
23363
+ }
23364
+
23365
+ /** What changed in a {@link NiceTreeGrid} check — the second argument of `onCheckedChange`. */
23366
+ export declare interface NiceTreeGridCheckInfo<T = NiceTreeGridNode> {
23367
+ /** A row's checkbox (or Space / a row click), the header's "select all", or "clear selection". */
23368
+ source: 'row' | 'selectAll' | 'clear';
23369
+ /** Whether rows went on. */
23370
+ checked: boolean;
23371
+ /** The toggled row (source `'row'`). */
23372
+ key?: string;
23373
+ row?: T;
23374
+ /** The checked leaves, whatever `checkStrategy` reports. */
23375
+ leafKeys: string[];
23376
+ /** Rows with checkboxes that are partly checked. */
23377
+ halfCheckedKeys: string[];
23378
+ }
23323
23379
 
23324
23380
  /** A row node in the {@link NiceTreeGrid} (supports index-signature for dynamic fields). */
23325
23381
  export declare interface NiceTreeGridNode {
23326
23382
  [field: string]: unknown;
23327
23383
  }
23328
23384
 
23329
- /** Props for the {@link NiceTreeGrid} component — a hierarchical data grid with sorting, selection, search, and NiceDataGrid column features. */
23330
- export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTreeGridNode> extends NiceBaseProps {
23331
- /** Column definitions (reuses NiceDataGridColumn). */
23385
+ /** Props for the {@link NiceTreeGrid} component — a hierarchical data grid with sorting, selection, cascading checkboxes, search, and NiceDataGrid column features. */
23386
+ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTreeGridNode> extends NiceStandardProps {
23387
+ /** Column definitions (reuses NiceDataGridColumn). The tree (indent, expander, checkbox) sits in the first one. */
23332
23388
  columns?: NiceDataGridColumn<T>[];
23333
23389
  /** Row data. */
23334
23390
  data?: T[];
@@ -23342,9 +23398,32 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
23342
23398
  childrenField?: string;
23343
23399
  /** Currently expanded keys. */
23344
23400
  expandedKeys?: string[];
23345
- /** Called when expanded keys change. */
23401
+ /** Rows expanded until the user expands or collapses one (uncontrolled). */
23402
+ defaultExpandedKeys?: string[];
23403
+ /**
23404
+ * Called when expanded keys change — also for the rows the user opens or closes while searching
23405
+ * (they stay so after the search), but not for the rows a search opens by itself.
23406
+ */
23346
23407
  onExpandedChange?: (keys: string[]) => void;
23347
- /** Expand all nodes by default. */
23408
+ /**
23409
+ * Whether a row has children that are not in `data` yet. Such a row gets an expander; opening
23410
+ * it calls `loadChildren`, or — without it — shows a loading row until you add the children to
23411
+ * `data`. Default with `loadChildren`: every row without children, until its load returns none.
23412
+ */
23413
+ hasChildren?: (row: T) => boolean;
23414
+ /**
23415
+ * Loads a row's children the first time it is opened; the grid keeps them. Flat rows may bring
23416
+ * deeper levels along through `parentKeyField`, nested rows through `childrenField`. A failed
23417
+ * load shows a row with a retry button. Search and "expand all" cover the loaded rows.
23418
+ */
23419
+ loadChildren?: (row: T) => Promise<T[]>;
23420
+ /**
23421
+ * Built-in buttons in the rows: `true` for all, or a list. `'expandSubtree'` opens everything
23422
+ * below a row — loading lazy rows on the way — and closes it all once it is open. Without the
23423
+ * button, Alt- or Shift-click on an expander and Shift+→ / Shift+← do the same.
23424
+ */
23425
+ rowActions?: boolean | NiceTreeGridRowAction[];
23426
+ /** Expand all nodes by default — also rows that arrive later, until the user toggles one. */
23348
23427
  defaultExpandAll?: boolean;
23349
23428
  /** Enable sorting. */
23350
23429
  sortable?: boolean;
@@ -23354,16 +23433,97 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
23354
23433
  sortDirection?: SortDirection;
23355
23434
  /** Called when sort changes. */
23356
23435
  onSort?: (field: string, direction: SortDirection) => void;
23357
- /** Enable row selection. */
23436
+ /**
23437
+ * Enable flat row selection: a checkbox per row, no cascade. With `checkable` the checkbox
23438
+ * belongs to the check and a row click toggles this selection (row highlight).
23439
+ */
23358
23440
  selectable?: boolean;
23359
23441
  /** Currently selected keys. */
23360
23442
  selectedKeys?: Set<string>;
23361
23443
  /** Called when selection changes. */
23362
23444
  onSelectionChange?: (keys: Set<string>) => void;
23445
+ /**
23446
+ * Cascading checkboxes: checking a parent checks every row below it, a parent shows checked
23447
+ * when all rows below it are and indeterminate when some are.
23448
+ */
23449
+ checkable?: boolean;
23450
+ /** Checked keys (controlled). A parent key checks its whole subtree. */
23451
+ checkedKeys?: string[];
23452
+ /** Checked keys at mount (uncontrolled). */
23453
+ defaultCheckedKeys?: string[];
23454
+ /** Called with the checked keys (see `checkStrategy`) and what changed. */
23455
+ onCheckedChange?: (keys: string[], info: NiceTreeGridCheckInfo<T>) => void;
23456
+ /**
23457
+ * Which keys `onCheckedChange` reports: `'all'` (default) every fully checked row, parents
23458
+ * included; `'leaves'` only the checked rows with no checkboxes below them; `'parents'` the
23459
+ * topmost fully checked rows. Keys of rows not in `data` are kept.
23460
+ */
23461
+ checkStrategy?: NiceTreeCheckStrategy;
23462
+ /**
23463
+ * `false` makes a row informational: no checkbox, never reported. Above checkable rows it is a
23464
+ * group header its ancestors count through; below a checkable row (a module's categories) the
23465
+ * checkable row counts as a leaf.
23466
+ */
23467
+ isRowCheckable?: (row: T) => boolean;
23468
+ /** `true` locks a row and every row below it: their checks keep their state. */
23469
+ isRowDisabled?: (row: T) => boolean;
23470
+ /** Where the checkboxes go: after the expander in the tree column (default) or a column of their own. */
23471
+ checkboxPlacement?: 'tree' | 'column';
23472
+ /** A row click toggles the row's checkbox. */
23473
+ checkOnRowClick?: boolean;
23474
+ /** Show a "checked / total" badge on rows with checkboxes below them. */
23475
+ showCheckedCount?: boolean;
23476
+ /**
23477
+ * The selection summary in the toolbar ("{checked} of {total} selected"): `false` hides it, a
23478
+ * function renders your own — e.g. distinct items when one item has a row under several parents.
23479
+ */
23480
+ checkedSummary?: false | ((info: NiceTreeGridCheckedSummaryInfo<T>) => default_2.ReactNode);
23481
+ /** A "select all" checkbox in the header — while searching, it acts on the results. Default true. */
23482
+ showSelectAll?: boolean;
23483
+ /** Show only the checked rows (controlled). */
23484
+ showOnlyChecked?: boolean;
23485
+ /** Show only the checked rows at mount (uncontrolled). */
23486
+ defaultShowOnlyChecked?: boolean;
23487
+ /** Called when "show selected only" is switched. */
23488
+ onShowOnlyCheckedChange?: (value: boolean) => void;
23489
+ /**
23490
+ * Built-in toolbar buttons: `true` for all that apply (expand all, collapse all and — when
23491
+ * `checkable` — show selected only, clear selection), or a list of them.
23492
+ */
23493
+ toolbarActions?: boolean | NiceTreeGridToolbarAction[];
23363
23494
  /** Show a search box. */
23364
23495
  searchable?: boolean;
23365
23496
  /** Search input placeholder. */
23366
23497
  searchPlaceholder?: string;
23498
+ /** Search text (controlled). */
23499
+ searchText?: string;
23500
+ /** Search text at mount (uncontrolled). */
23501
+ defaultSearchText?: string;
23502
+ /** Called when the search text changes. */
23503
+ onSearchChange?: (text: string) => void;
23504
+ /** Fields the search looks in (default: the visible columns). */
23505
+ searchFields?: string[];
23506
+ /** Own match test, instead of a substring of `searchFields`. */
23507
+ searchFilter?: (row: T, query: string) => boolean;
23508
+ /** A matching row keeps all rows below it, not only the matching ones. */
23509
+ searchKeepDescendants?: boolean;
23510
+ /** Open the rows above every match while searching (default true); they close again when the search is cleared. */
23511
+ searchAutoExpand?: boolean;
23512
+ /** Mark the matches in columns without a `render` (default true). */
23513
+ highlightMatches?: boolean;
23514
+ /** Extra class name of a row. */
23515
+ rowClassName?: string | ((row: T, index: number) => string | undefined);
23516
+ /** A row's name for its checkbox label (default: its first column's value). */
23517
+ getRowLabel?: (row: T) => string;
23518
+ /**
23519
+ * Render only the rows in view, for thousands of rows. Rows get a fixed height (`rowHeight`)
23520
+ * and long cells are cut with an ellipsis.
23521
+ */
23522
+ virtualScroll?: boolean;
23523
+ /** Row height in px with `virtualScroll` (default 36). */
23524
+ rowHeight?: number;
23525
+ /** Height of the scrolling body with `virtualScroll` (default 480). */
23526
+ height?: number | string;
23367
23527
  /** Alternate row coloring. */
23368
23528
  striped?: boolean;
23369
23529
  /** Reduced padding. */
@@ -23386,7 +23546,13 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
23386
23546
  onRowClick?: (row: T) => void;
23387
23547
  }
23388
23548
 
23389
- 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;
23549
+ /** A built-in button in the rows of {@link NiceTreeGrid}. */
23550
+ declare type NiceTreeGridRowAction = 'expandSubtree';
23551
+
23552
+ /** A built-in toolbar button of {@link NiceTreeGrid}. */
23553
+ export declare type NiceTreeGridToolbarAction = 'expandAll' | 'collapseAll' | 'onlyChecked' | 'clearChecked';
23554
+
23555
+ export declare function NiceTreeList<T extends NiceTreeListNode>({ columns, data, keyField, parentKeyField, expandedKeys: controlledExpanded, onExpandedChange, selectedKeys, onSelectionChange, selectable, sortable, loading, emptyText, className, style, accessMode, id, 'data-testid': dataTestId, }: NiceTreeListProps<T>): default_2.JSX.Element | null;
23390
23556
 
23391
23557
  /** A tree-list node for the {@link NiceTreeList} component. */
23392
23558
  export declare interface NiceTreeListNode {
@@ -23414,11 +23580,17 @@ export declare interface NiceTreeListProps<T extends NiceTreeListNode = NiceTree
23414
23580
  expandedKeys?: string[];
23415
23581
  /** Called when expanded keys change. */
23416
23582
  onExpandedChange?: (keys: string[]) => void;
23417
- /** Currently selected keys. */
23583
+ /**
23584
+ * Currently selected keys. A parent key selects its whole subtree. The keys handed back are every
23585
+ * fully selected row, parents included, in document order; keys of rows not in `data` are kept.
23586
+ */
23418
23587
  selectedKeys?: string[];
23419
23588
  /** Called when selection changes. */
23420
23589
  onSelectionChange?: (keys: string[]) => void;
23421
- /** Enable row selection. Checking a parent row cascades to all its descendants. */
23590
+ /**
23591
+ * Enable row selection. Checking a parent row cascades to all its descendants; a parent shows
23592
+ * checked when all its descendants are, indeterminate when some are.
23593
+ */
23422
23594
  selectable?: boolean;
23423
23595
  /** Enable column sorting (opt-in per column via `NiceDataGridColumn.sortable`). */
23424
23596
  sortable?: boolean;
@@ -23498,9 +23670,9 @@ export declare interface NiceTreeNode {
23498
23670
  icon?: default_2.ReactNode;
23499
23671
  /** Child nodes. */
23500
23672
  children?: NiceTreeNode[];
23501
- /** Disable the node. */
23673
+ /** Disable the node. With cascading checkboxes, its own checkbox keeps its state. */
23502
23674
  disabled?: boolean;
23503
- /** Default expanded state. */
23675
+ /** Expanded when the tree mounts (uncontrolled `expandedKeys` only). */
23504
23676
  expanded?: boolean;
23505
23677
  /** If true, children are loaded lazily via onLoadChildren. */
23506
23678
  leaf?: boolean;
@@ -23554,7 +23726,11 @@ export declare interface NiceTreeViewProps extends NiceBaseProps {
23554
23726
  * a title bar, toolbar or count. Pass any node; omit for no header.
23555
23727
  */
23556
23728
  header?: default_2.ReactNode;
23557
- /** Currently selected node keys. */
23729
+ /**
23730
+ * Currently selected node keys. With `showCheckboxes` and `selectionMode="multiple"` the
23731
+ * checkboxes cascade: a parent key checks its subtree, and the keys handed back are every fully
23732
+ * checked node, parents included, in document order.
23733
+ */
23558
23734
  selectedKeys?: string[];
23559
23735
  /** Currently expanded node keys. */
23560
23736
  expandedKeys?: string[];