@nice2dev/ui 1.3.9 → 1.3.11

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 (62) hide show
  1. package/CHANGELOG.md +88 -0
  2. package/README.md +16 -18
  3. package/dist/NiceColorPicker-BLwYNSXJ.cjs +1 -0
  4. package/dist/NiceColorPicker-DS59tNkP.js +552 -0
  5. package/dist/NiceDataGrid-CL2_7fS7.cjs +10 -0
  6. package/dist/NiceDataGrid-CpJrRN_H.js +2269 -0
  7. package/dist/NiceForm-BQj-K7p7.cjs +1 -0
  8. package/dist/NiceForm-HQ4h7hX_.js +5023 -0
  9. package/dist/NiceGantt-BygumlaY.cjs +1 -0
  10. package/dist/NiceGantt-DTC7OH-v.js +334 -0
  11. package/dist/NiceHtmlEditor-BtpuaLln.js +901 -0
  12. package/dist/NiceHtmlEditor-C1OVtLQ6.cjs +10 -0
  13. package/dist/NiceMention-CVxxCVtQ.js +11668 -0
  14. package/dist/NiceMention-Te66Oid1.cjs +430 -0
  15. package/dist/NiceModuleLifecyclePanel-DCrFyUH8.cjs +1 -0
  16. package/dist/NiceModuleLifecyclePanel-Mt80MdET.js +7441 -0
  17. package/dist/NicePagination-CKsAP38Q.cjs +1 -0
  18. package/dist/NicePagination-zOed5QxG.js +202 -0
  19. package/dist/NicePivotGrid-Clue9FM5.js +1184 -0
  20. package/dist/NicePivotGrid-Cnkr9WkC.cjs +152 -0
  21. package/dist/NicePropertyGrid.doc-BWNyWrWq.cjs +7 -0
  22. package/dist/NicePropertyGrid.doc-C_I3F4w8.js +31 -0
  23. package/dist/NiceSavedQueryPanel-NgG58w6i.js +6226 -0
  24. package/dist/NiceSavedQueryPanel-lTWY2plm.cjs +587 -0
  25. package/dist/NiceScheduler-BWwqFKEc.js +1712 -0
  26. package/dist/NiceScheduler-DqWEJU7g.cjs +5 -0
  27. package/dist/NiceSelect-BNPXs6FQ.cjs +1 -0
  28. package/dist/NiceSelect-DEruWHan.js +495 -0
  29. package/dist/NiceWindow-D3V7A69Q.js +2247 -0
  30. package/dist/NiceWindow-pgR4c-kQ.cjs +1 -0
  31. package/dist/core-lazy-Bjdu111n.js +351 -0
  32. package/dist/core-lazy-Bx_8BOlG.cjs +1 -0
  33. package/dist/data.cjs +1 -1
  34. package/dist/data.d.ts +47 -6
  35. package/dist/data.mjs +3 -3
  36. package/dist/devops-CqhA0rjL.js +9130 -0
  37. package/dist/devops-cgRBnZVX.cjs +18 -0
  38. package/dist/devops.cjs +1 -1
  39. package/dist/devops.mjs +1 -1
  40. package/dist/editors.cjs +1 -1
  41. package/dist/editors.mjs +7 -7
  42. package/dist/feedback.cjs +1 -1
  43. package/dist/feedback.mjs +1 -1
  44. package/dist/index.cjs +137 -151
  45. package/dist/index.css +1 -1
  46. package/dist/index.d.ts +113 -50
  47. package/dist/index.mjs +16556 -16423
  48. package/dist/lazy.cjs +1 -1
  49. package/dist/lazy.mjs +15 -15
  50. package/dist/navigation.cjs +1 -1
  51. package/dist/navigation.d.ts +2 -0
  52. package/dist/navigation.mjs +3 -3
  53. package/dist/no-code-BQqK8mvU.cjs +331 -0
  54. package/dist/no-code-Cppb-xz3.js +8320 -0
  55. package/dist/no-code.cjs +1 -1
  56. package/dist/no-code.mjs +1 -1
  57. package/dist/overlays.cjs +1 -1
  58. package/dist/overlays.mjs +1 -1
  59. package/dist/pickerCommons-BA3-D5RC.js +663 -0
  60. package/dist/pickerCommons-KrBqCBDn.cjs +1 -0
  61. package/dist/style.css +1 -1
  62. 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. */
@@ -11505,7 +11507,7 @@ export declare interface NiceDataGridProps<T extends Record<string, any> = any>
11505
11507
  formColumns?: number;
11506
11508
  /** Modal title for popup edit. Defaults to `'Edit row'`. */
11507
11509
  editFormTitle?: string;
11508
- /** Escape-hatch: extra props forwarded to the underlying `NiceForm` in the popup (e.g. `labelPosition`, `gap`, `size`, `responsiveColumns`). Aligns with the `NiceFormDesigner` standard. */
11510
+ /** Escape-hatch: extra props forwarded to the underlying `NiceForm` in the popup (e.g. `labelPosition`, `gap`, `size`, `responsiveColumns`). Takes the props of `NiceForm` itself. */
11509
11511
  formProps?: Partial<Omit<NiceFormProps, 'items' | 'data' | 'onFieldChange' | 'onSubmit' | 'columns' | 'showActions' | 'submitLabel'>>;
11510
11512
  /** Called when the popup form is submitted with the merged row. */
11511
11513
  onRowEdit?: (rowKey: string, updatedRow: T) => void;
@@ -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 {
@@ -17008,7 +17010,10 @@ export declare interface NiceModuleLoaderState {
17008
17010
  errors: Map<string, Error>;
17009
17011
  }
17010
17012
 
17011
- /** Full module manifest. */
17013
+ /**
17014
+ * Full runtime manifest of a front-end micro-module (loader, routes, flags). Not the seed
17015
+ * `*.manifest.json` of an ERP module — see the file header.
17016
+ */
17012
17017
  export declare interface NiceModuleManifest {
17013
17018
  /** Unique module identifier (kebab-case, e.g. "sales-orders"). */
17014
17019
  id: string;
@@ -17865,7 +17870,7 @@ export { NiceOnChange }
17865
17870
 
17866
17871
  export { NiceOnOpenChange }
17867
17872
 
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) & {
17873
+ 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
17874
  displayName: string;
17870
17875
  };
17871
17876
 
@@ -21369,7 +21374,7 @@ export declare interface NiceSliderProps extends Omit<NiceFormFieldProps, 'label
21369
21374
  showTickLabels?: boolean;
21370
21375
  }
21371
21376
 
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;
21377
+ 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
21378
 
21374
21379
  export declare namespace NiceSortable {
21375
21380
  var displayName: string;
@@ -22514,41 +22519,6 @@ export { niceThemeBootstrap }
22514
22519
 
22515
22520
  export { NiceThemeBorders }
22516
22521
 
22517
- /** Props for the {@link NiceThemeBuilder} component — an advanced visual theme editor with section pickers, presets, live preview, and export. */
22518
- declare interface NiceThemeBuilderProps extends NiceBaseProps {
22519
- /** Initial theme to edit (defaults to Light) */
22520
- theme?: NiceTheme;
22521
- /** Preset themes to offer in the picker */
22522
- presets?: NiceTheme[];
22523
- /** Sections to show (default: all) */
22524
- sections?: NiceThemeBuilderSection[];
22525
- /** Called when theme changes */
22526
- onChange?: (theme: NiceTheme) => void;
22527
- /**
22528
- * Called when user clicks Apply, after the theme went to the page: the enclosing
22529
- * NiceThemeProvider when there is one, otherwise the document root.
22530
- */
22531
- onApply?: (theme: NiceTheme) => void;
22532
- /** Called when user clicks Export; without it the button downloads the theme as `<name>.json`. */
22533
- onExport?: (json: string, cssVars: Record<string, string>) => void;
22534
- /**
22535
- * Apply every edit to the page live (default: false) — through the enclosing NiceThemeProvider
22536
- * when there is one, otherwise to the document root.
22537
- */
22538
- livePreview?: boolean;
22539
- /** Currently focused token from NiceThemePreview (auto-switches section + scrolls) */
22540
- focusedToken?: string;
22541
- /** Show the embedded NiceThemePreview pane (default: true) */
22542
- showPreview?: boolean;
22543
- /** Layout placement of the preview pane (default: 'right') */
22544
- previewPlacement?: 'right' | 'bottom';
22545
- /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
22546
- tutorial?: NiceComponentTutorial;
22547
- }
22548
-
22549
- /** Editable sections in the {@link NiceThemeBuilder}. */
22550
- declare type NiceThemeBuilderSection = 'general' | 'colors' | 'backgrounds' | 'background-image' | 'text' | 'borders' | 'spacing' | 'typography' | 'shadows' | 'transitions' | 'nesting';
22551
-
22552
22522
  export { NiceThemeColors }
22553
22523
 
22554
22524
  export { NiceThemeContext }
@@ -22580,13 +22550,44 @@ export declare interface NiceThemeDescriptor {
22580
22550
  meta?: Record<string, unknown>;
22581
22551
  }
22582
22552
 
22583
- export declare const NiceThemeDesigner: ForwardRefExoticComponent<NiceThemeBuilderProps & RefAttributes<HTMLDivElement>> & {
22553
+ export declare const NiceThemeDesigner: default_2.ForwardRefExoticComponent<NiceThemeDesignerProps & default_2.RefAttributes<HTMLDivElement>> & {
22584
22554
  displayName: string;
22585
22555
  };
22586
22556
 
22587
- export declare type NiceThemeDesignerProps = NiceThemeBuilderProps;
22557
+ /** Props for the {@link NiceThemeDesigner} component — an advanced visual theme editor with section pickers, presets, live preview, and export. */
22558
+ export declare interface NiceThemeDesignerProps extends NiceBaseProps {
22559
+ /** Initial theme to edit (defaults to Light) */
22560
+ theme?: NiceTheme;
22561
+ /** Preset themes to offer in the picker */
22562
+ presets?: NiceTheme[];
22563
+ /** Sections to show (default: all) */
22564
+ sections?: NiceThemeDesignerSection[];
22565
+ /** Called when theme changes */
22566
+ onChange?: (theme: NiceTheme) => void;
22567
+ /**
22568
+ * Called when user clicks Apply, after the theme went to the page: the enclosing
22569
+ * NiceThemeProvider when there is one, otherwise the document root.
22570
+ */
22571
+ onApply?: (theme: NiceTheme) => void;
22572
+ /** Called when user clicks Export; without it the button downloads the theme as `<name>.json`. */
22573
+ onExport?: (json: string, cssVars: Record<string, string>) => void;
22574
+ /**
22575
+ * Apply every edit to the page live (default: false) — through the enclosing NiceThemeProvider
22576
+ * when there is one, otherwise to the document root.
22577
+ */
22578
+ livePreview?: boolean;
22579
+ /** Currently focused token from NiceThemePreview (auto-switches section + scrolls) */
22580
+ focusedToken?: string;
22581
+ /** Show the embedded NiceThemePreview pane (default: true) */
22582
+ showPreview?: boolean;
22583
+ /** Layout placement of the preview pane (default: 'right') */
22584
+ previewPlacement?: 'right' | 'bottom';
22585
+ /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
22586
+ tutorial?: NiceComponentTutorial;
22587
+ }
22588
22588
 
22589
- export declare type NiceThemeDesignerSection = NiceThemeBuilderSection;
22589
+ /** Editable sections in the {@link NiceThemeDesigner}. */
22590
+ export declare type NiceThemeDesignerSection = 'general' | 'colors' | 'backgrounds' | 'background-image' | 'text' | 'borders' | 'spacing' | 'typography' | 'shadows' | 'transitions' | 'nesting';
22590
22591
 
22591
22592
  export { niceThemeFluent }
22592
22593
 
@@ -22772,7 +22773,7 @@ export { NiceThemeVariantProvider }
22772
22773
 
22773
22774
  export { NiceThemeVariantProviderProps }
22774
22775
 
22775
- export declare function NiceTileView<T extends NiceTileViewItem>({ items, tileWidth, tileHeight, direction, renderTile, onTileClick, loading, emptyText, className, style, }: NiceTileViewProps<T>): default_2.JSX.Element;
22776
+ 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
22777
 
22777
22778
  /** A tile item displayed by the {@link NiceTileView} component. */
22778
22779
  declare interface NiceTileViewItem {
@@ -23346,7 +23347,19 @@ export declare interface NiceTreeContextMenuItem {
23346
23347
  disabled?: boolean;
23347
23348
  }
23348
23349
 
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
+ 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;
23351
+
23352
+ /** What a `checkedSummary` function of {@link NiceTreeGrid} gets. */
23353
+ declare interface NiceTreeGridCheckedSummaryInfo<T = NiceTreeGridNode> {
23354
+ /** Checked rows that count: rows with a checkbox and no checkboxes below them. */
23355
+ checked: number;
23356
+ /** All rows that count. */
23357
+ total: number;
23358
+ /** Keys of the checked rows that count. */
23359
+ leafKeys: string[];
23360
+ /** Their rows — e.g. to count distinct items when one item has a row under several parents. */
23361
+ rows: T[];
23362
+ }
23350
23363
 
23351
23364
  /** What changed in a {@link NiceTreeGrid} check — the second argument of `onCheckedChange`. */
23352
23365
  export declare interface NiceTreeGridCheckInfo<T = NiceTreeGridNode> {
@@ -23386,8 +23399,29 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
23386
23399
  expandedKeys?: string[];
23387
23400
  /** Rows expanded until the user expands or collapses one (uncontrolled). */
23388
23401
  defaultExpandedKeys?: string[];
23389
- /** Called when expanded keys change. Not called for the rows a search opens. */
23402
+ /**
23403
+ * Called when expanded keys change — also for the rows the user opens or closes while searching
23404
+ * (they stay so after the search), but not for the rows a search opens by itself.
23405
+ */
23390
23406
  onExpandedChange?: (keys: string[]) => void;
23407
+ /**
23408
+ * Whether a row has children that are not in `data` yet. Such a row gets an expander; opening
23409
+ * it calls `loadChildren`, or — without it — shows a loading row until you add the children to
23410
+ * `data`. Default with `loadChildren`: every row without children, until its load returns none.
23411
+ */
23412
+ hasChildren?: (row: T) => boolean;
23413
+ /**
23414
+ * Loads a row's children the first time it is opened; the grid keeps them. Flat rows may bring
23415
+ * deeper levels along through `parentKeyField`, nested rows through `childrenField`. A failed
23416
+ * load shows a row with a retry button. Search and "expand all" cover the loaded rows.
23417
+ */
23418
+ loadChildren?: (row: T) => Promise<T[]>;
23419
+ /**
23420
+ * Built-in buttons in the rows: `true` for all, or a list. `'expandSubtree'` opens everything
23421
+ * below a row — loading lazy rows on the way — and closes it all once it is open. Without the
23422
+ * button, Alt- or Shift-click on an expander and Shift+→ / Shift+← do the same.
23423
+ */
23424
+ rowActions?: boolean | NiceTreeGridRowAction[];
23391
23425
  /** Expand all nodes by default — also rows that arrive later, until the user toggles one. */
23392
23426
  defaultExpandAll?: boolean;
23393
23427
  /** Enable sorting. */
@@ -23438,6 +23472,11 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
23438
23472
  checkOnRowClick?: boolean;
23439
23473
  /** Show a "checked / total" badge on rows with checkboxes below them. */
23440
23474
  showCheckedCount?: boolean;
23475
+ /**
23476
+ * The selection summary in the toolbar ("{checked} of {total} selected"): `false` hides it, a
23477
+ * function renders your own — e.g. distinct items when one item has a row under several parents.
23478
+ */
23479
+ checkedSummary?: false | ((info: NiceTreeGridCheckedSummaryInfo<T>) => default_2.ReactNode);
23441
23480
  /** A "select all" checkbox in the header — while searching, it acts on the results. Default true. */
23442
23481
  showSelectAll?: boolean;
23443
23482
  /** Show only the checked rows (controlled). */
@@ -23467,7 +23506,7 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
23467
23506
  searchFilter?: (row: T, query: string) => boolean;
23468
23507
  /** A matching row keeps all rows below it, not only the matching ones. */
23469
23508
  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. */
23509
+ /** Open the rows above every match while searching (default true); they close again when the search is cleared. */
23471
23510
  searchAutoExpand?: boolean;
23472
23511
  /** Mark the matches in columns without a `render` (default true). */
23473
23512
  highlightMatches?: boolean;
@@ -23506,10 +23545,13 @@ export declare interface NiceTreeGridProps<T extends NiceTreeGridNode = NiceTree
23506
23545
  onRowClick?: (row: T) => void;
23507
23546
  }
23508
23547
 
23548
+ /** A built-in button in the rows of {@link NiceTreeGrid}. */
23549
+ declare type NiceTreeGridRowAction = 'expandSubtree';
23550
+
23509
23551
  /** A built-in toolbar button of {@link NiceTreeGrid}. */
23510
23552
  export declare type NiceTreeGridToolbarAction = 'expandAll' | 'collapseAll' | 'onlyChecked' | 'clearChecked';
23511
23553
 
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;
23554
+ 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;
23513
23555
 
23514
23556
  /** A tree-list node for the {@link NiceTreeList} component. */
23515
23557
  export declare interface NiceTreeListNode {
@@ -24516,8 +24558,15 @@ export declare interface NiceViewContainer {
24516
24558
  export declare interface NiceViewDataSourceRef {
24517
24559
  /** Unique key within this view (e.g. "customers", "orders") */
24518
24560
  key: string;
24519
- /** REST endpoint or adapter type: "rest" | "odata" | "graphql" | "static" */
24520
- type: 'rest' | 'odata' | 'graphql' | 'static';
24561
+ /**
24562
+ * Where the rows come from: an adapter ("rest" | "odata" | "graphql" | "static"), a query the
24563
+ * module defines ("query", by `ref` — a `NiceDataSourceDef.key`), or a module entity ("entity").
24564
+ */
24565
+ type: 'rest' | 'odata' | 'graphql' | 'static' | 'query' | 'entity';
24566
+ /** The module data source this view reads (type="query"): the `key` of a `NiceDataSourceDef`. */
24567
+ ref?: string;
24568
+ /** The module entity this view reads (type="entity"). */
24569
+ entity?: string;
24521
24570
  /** URL or resource path (for rest/odata/graphql) */
24522
24571
  endpoint?: string;
24523
24572
  /** Static data (for type="static") */
@@ -24615,6 +24664,14 @@ export declare interface NiceViewEditorProps extends NiceStandardProps {
24615
24664
  registry?: NiceViewRegistry;
24616
24665
  /** Entities available for "New from entity" + binding field hints. */
24617
24666
  entities?: NiceEntityLike[];
24667
+ /**
24668
+ * The module's data sources (`NiceDataSourceDef` keys) a "query" data source can point at.
24669
+ * Without them its `ref` is typed in by hand.
24670
+ */
24671
+ dataSourceOptions?: Array<{
24672
+ key: string;
24673
+ label?: string;
24674
+ }>;
24618
24675
  /** Save callback (shows a Save button when provided). */
24619
24676
  onSave?: (view: NiceViewDefinition) => void;
24620
24677
  /**
@@ -28762,6 +28819,12 @@ export { TouchPoint }
28762
28819
 
28763
28820
  export { TouchTargetProps }
28764
28821
 
28822
+ /**
28823
+ * The view-standard data source that reads this one: `type: 'query'` with `ref` = its key, so a
28824
+ * view (NiceViewEditor / NiceViewRenderer) binds to the module's query by name.
28825
+ */
28826
+ export declare function toViewDataSourceRef(def: Pick<NiceDataSourceDef, 'key'>, key?: string): NiceViewDataSourceRef;
28827
+
28765
28828
  export { TRACELESS_MODE_PRESETS }
28766
28829
 
28767
28830
  /**