@macrostrat/data-sheet 4.4.0 → 4.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/CHANGELOG.md +73 -0
  2. package/dist/components/indicators/unified-filters.cjs +30 -10
  3. package/dist/components/indicators/unified-filters.cjs.map +1 -1
  4. package/dist/components/indicators/unified-filters.js +30 -10
  5. package/dist/components/indicators/unified-filters.js.map +1 -1
  6. package/dist/data-panel.cjs +3 -1
  7. package/dist/data-panel.cjs.map +1 -1
  8. package/dist/data-panel.d.ts +1 -1
  9. package/dist/data-panel.js +3 -1
  10. package/dist/data-panel.js.map +1 -1
  11. package/dist/data-panel.module.sass.cjs +25 -25
  12. package/dist/data-panel.module.sass.js +25 -25
  13. package/dist/data-sheet.cjs +3 -1
  14. package/dist/data-sheet.cjs.map +1 -1
  15. package/dist/data-sheet.css +37 -38
  16. package/dist/data-sheet.d.ts +1 -1
  17. package/dist/data-sheet.js +3 -1
  18. package/dist/data-sheet.js.map +1 -1
  19. package/dist/index.cjs +4 -0
  20. package/dist/index.cjs.map +1 -1
  21. package/dist/index.js +5 -1
  22. package/dist/index.js.map +1 -1
  23. package/dist/postgrest-table/data-loaders.cjs +67 -2
  24. package/dist/postgrest-table/data-loaders.cjs.map +1 -1
  25. package/dist/postgrest-table/data-loaders.d.ts +8 -1
  26. package/dist/postgrest-table/data-loaders.js +67 -2
  27. package/dist/postgrest-table/data-loaders.js.map +1 -1
  28. package/dist/provider/core.cjs +23 -2
  29. package/dist/provider/core.cjs.map +1 -1
  30. package/dist/provider/core.d.ts +2 -2
  31. package/dist/provider/core.js +23 -2
  32. package/dist/provider/core.js.map +1 -1
  33. package/dist/provider/distinct-values.cjs +65 -0
  34. package/dist/provider/distinct-values.cjs.map +1 -0
  35. package/dist/provider/distinct-values.d.ts +21 -0
  36. package/dist/provider/distinct-values.js +65 -0
  37. package/dist/provider/distinct-values.js.map +1 -0
  38. package/dist/provider/index.d.ts +1 -0
  39. package/dist/provider/table-data.cjs +21 -0
  40. package/dist/provider/table-data.cjs.map +1 -1
  41. package/dist/provider/table-data.d.ts +22 -0
  42. package/dist/provider/table-data.js +21 -0
  43. package/dist/provider/table-data.js.map +1 -1
  44. package/dist/types.cjs.map +1 -1
  45. package/dist/types.d.ts +27 -4
  46. package/dist/types.js.map +1 -1
  47. package/package.json +1 -1
  48. package/src/components/indicators/unified-filters.ts +40 -10
  49. package/src/data-panel.module.sass +2 -3
  50. package/src/data-panel.ts +3 -1
  51. package/src/data-sheet.ts +3 -1
  52. package/src/postgrest-table/data-loaders.ts +106 -3
  53. package/src/provider/core.ts +36 -3
  54. package/src/provider/distinct-values.ts +127 -0
  55. package/src/provider/index.ts +1 -0
  56. package/src/provider/table-data.ts +51 -0
  57. package/src/types.ts +33 -4
@@ -1478,7 +1478,7 @@ span._sep_1r3aw_9:first-child, span._sep_1r3aw_9:last-child {
1478
1478
  --data-panel-content-padding: 0px;
1479
1479
  }
1480
1480
 
1481
- ._data-panel_s95k2_5 {
1481
+ ._data-panel_lybzx_5 {
1482
1482
  display: flex;
1483
1483
  flex: 1 1 auto;
1484
1484
  min-height: 0;
@@ -1487,18 +1487,18 @@ span._sep_1r3aw_9:first-child, span._sep_1r3aw_9:last-child {
1487
1487
  min-width: 0;
1488
1488
  --data-panel-content-padding: 12px;
1489
1489
  --data-panel-item-gap: 8px;
1490
- --data-panel-content-width: 100cqw;
1490
+ --data-panel-content-width: 100%;
1491
1491
  --data-panel-selected-color: #2d72d2;
1492
1492
  --data-panel-selected-background: rgba(45, 114, 210, 0.1);
1493
1493
  }
1494
1494
 
1495
- ._data-panel-main_s95k2_19 {
1495
+ ._data-panel-main_lybzx_19 {
1496
1496
  display: flex;
1497
1497
  flex-direction: column;
1498
1498
  flex: 1 1 auto;
1499
1499
  }
1500
1500
 
1501
- ._data-panel-sidebar-container_s95k2_25 {
1501
+ ._data-panel-sidebar-container_lybzx_25 {
1502
1502
  flex: 0 0 auto;
1503
1503
  width: var(--data-panel-sidebar-width, 240px);
1504
1504
  min-height: 0;
@@ -1507,7 +1507,7 @@ span._sep_1r3aw_9:first-child, span._sep_1r3aw_9:last-child {
1507
1507
  border-left: 1px solid var(--panel-rule-color);
1508
1508
  }
1509
1509
 
1510
- ._data-panel-body_s95k2_34 {
1510
+ ._data-panel-body_lybzx_34 {
1511
1511
  flex: 1 1 auto;
1512
1512
  min-height: 0;
1513
1513
  min-width: 0;
@@ -1515,19 +1515,19 @@ span._sep_1r3aw_9:first-child, span._sep_1r3aw_9:last-child {
1515
1515
  padding: var(--data-panel-content-padding);
1516
1516
  }
1517
1517
 
1518
- ._data-panel-main_s95k2_19 > * {
1518
+ ._data-panel-main_lybzx_19 > * {
1519
1519
  display: flex;
1520
1520
  flex-direction: column;
1521
1521
  align-items: center;
1522
1522
  }
1523
- ._data-panel-main_s95k2_19 > * > * {
1523
+ ._data-panel-main_lybzx_19 > * > * {
1524
1524
  flex: 1;
1525
1525
  max-width: var(--data-panel-content-width, 100%);
1526
1526
  width: var(--data-panel-content-width, 100%);
1527
1527
  min-width: 0;
1528
1528
  }
1529
1529
 
1530
- ._content-footer-holder_s95k2_54 {
1530
+ ._content-footer-holder_lybzx_54 {
1531
1531
  flex: 0 0 auto;
1532
1532
  min-height: 44px;
1533
1533
  display: flex;
@@ -1535,29 +1535,29 @@ span._sep_1r3aw_9:first-child, span._sep_1r3aw_9:last-child {
1535
1535
  justify-content: center;
1536
1536
  }
1537
1537
 
1538
- ._data-panel-item-container_s95k2_62._is-skeleton_s95k2_62 {
1538
+ ._data-panel-item-container_lybzx_62._is-skeleton_lybzx_62 {
1539
1539
  pointer-events: none;
1540
1540
  }
1541
1541
 
1542
- ._data-panel-skeleton_s95k2_66 {
1542
+ ._data-panel-skeleton_lybzx_66 {
1543
1543
  width: 100%;
1544
1544
  min-height: 3.25em;
1545
1545
  border-radius: 4px;
1546
1546
  }
1547
1547
 
1548
- ._data-panel-list_s95k2_72 {
1548
+ ._data-panel-list_lybzx_72 {
1549
1549
  display: flex;
1550
1550
  flex-direction: column;
1551
1551
  gap: var(--data-panel-item-gap, 8px);
1552
1552
  flex-grow: 1;
1553
1553
  }
1554
1554
 
1555
- ._data-panel-item_s95k2_62 {
1555
+ ._data-panel-item_lybzx_62 {
1556
1556
  user-select: none;
1557
1557
  break-inside: avoid;
1558
1558
  }
1559
1559
 
1560
- ._sentinel_s95k2_84 {
1560
+ ._sentinel_lybzx_84 {
1561
1561
  display: flex;
1562
1562
  align-items: center;
1563
1563
  justify-content: center;
@@ -1567,29 +1567,29 @@ span._sep_1r3aw_9:first-child, span._sep_1r3aw_9:last-child {
1567
1567
  font-size: 13px;
1568
1568
  }
1569
1569
 
1570
- ._data-panel-toolbar-content_s95k2_94 {
1570
+ ._data-panel-toolbar-content_lybzx_94 {
1571
1571
  max-width: var(--data-panel-content-width);
1572
1572
  }
1573
1573
 
1574
- ._data-panel-footer_s95k2_98 {
1574
+ ._data-panel-footer_lybzx_98 {
1575
1575
  color: var(--text-subtle, #738091);
1576
1576
  }
1577
1577
 
1578
- ._data-panel-footer-content_s95k2_102 {
1578
+ ._data-panel-footer-content_lybzx_102 {
1579
1579
  gap: var(--data-panel-item-gap, 8px);
1580
1580
  padding: 0.2em var(--data-panel-content-padding);
1581
1581
  }
1582
- ._data-panel-footer-content_s95k2_102 ._spacer_s95k2_106 {
1582
+ ._data-panel-footer-content_lybzx_102 ._spacer_lybzx_106 {
1583
1583
  flex: 1;
1584
1584
  }
1585
1585
 
1586
- ._data-panel-status-bar_s95k2_110 {
1586
+ ._data-panel-status-bar_lybzx_110 {
1587
1587
  display: flex;
1588
1588
  flex-direction: row;
1589
1589
  align-items: center;
1590
1590
  }
1591
1591
 
1592
- ._data-card_s95k2_116 {
1592
+ ._data-card_lybzx_116 {
1593
1593
  display: flex;
1594
1594
  gap: var(--data-panel-item-gap, 1em);
1595
1595
  padding: var(--data-panel-card-padding, 1em);
@@ -1598,75 +1598,74 @@ span._sep_1r3aw_9:first-child, span._sep_1r3aw_9:last-child {
1598
1598
  background: var(--card-background-color);
1599
1599
  cursor: pointer;
1600
1600
  }
1601
- ._data-card_s95k2_116._selected_s95k2_125 {
1601
+ ._data-card_lybzx_116._selected_lybzx_125 {
1602
1602
  background: var(--data-panel-selected-background);
1603
1603
  outline: 1.5px solid var(--data-panel-selected-color);
1604
1604
  }
1605
- ._data-card_s95k2_116._selected_s95k2_125:hover {
1605
+ ._data-card_lybzx_116._selected_lybzx_125:hover {
1606
1606
  background: var(--data-panel-selected-background);
1607
1607
  border-color: var(--data-panel-selected-color);
1608
1608
  outline-width: 2px;
1609
1609
  }
1610
- ._data-card_s95k2_116._selectable_s95k2_134:not(._selected_s95k2_125):hover {
1610
+ ._data-card_lybzx_116._selectable_lybzx_134:not(._selected_lybzx_125):hover {
1611
1611
  border-color: rgba(128, 128, 128, 0.5);
1612
1612
  background: rgba(128, 128, 128, 0.08);
1613
1613
  }
1614
1614
 
1615
- ._data-panel_s95k2_5._toolbar-style-bordered_s95k2_139 ._data-panel-toolbar_s95k2_94, ._data-panel_s95k2_5._toolbar-style-bordered_s95k2_139 ._data-panel-footer_s95k2_98 {
1615
+ ._data-panel_lybzx_5._toolbar-style-bordered_lybzx_139 ._data-panel-toolbar_lybzx_94, ._data-panel_lybzx_5._toolbar-style-bordered_lybzx_139 ._data-panel-footer_lybzx_98 {
1616
1616
  background-color: var(--panel-secondary-background-color);
1617
1617
  }
1618
- ._data-panel_s95k2_5._toolbar-style-bordered_s95k2_139 ._data-panel-toolbar_s95k2_94 {
1618
+ ._data-panel_lybzx_5._toolbar-style-bordered_lybzx_139 ._data-panel-toolbar_lybzx_94 {
1619
1619
  border-bottom: 1px solid var(--panel-rule-color);
1620
1620
  }
1621
- ._data-panel_s95k2_5._toolbar-style-bordered_s95k2_139 ._data-panel-footer_s95k2_98 {
1621
+ ._data-panel_lybzx_5._toolbar-style-bordered_lybzx_139 ._data-panel-footer_lybzx_98 {
1622
1622
  border-top: 1px solid var(--panel-rule-color);
1623
1623
  }
1624
- ._data-panel_s95k2_5._toolbar-style-floating_s95k2_148 {
1624
+ ._data-panel_lybzx_5._toolbar-style-floating_lybzx_148 {
1625
1625
  --data-panel-top-margin: calc(var(--data-panel-toolbar-height, 40px) + 2 * var(--data-panel-content-padding, 12px));
1626
1626
  }
1627
- ._data-panel_s95k2_5._toolbar-style-floating_s95k2_148 ._data-panel-toolbar_s95k2_94, ._data-panel_s95k2_5._toolbar-style-floating_s95k2_148 ._data-panel-footer_s95k2_98 {
1627
+ ._data-panel_lybzx_5._toolbar-style-floating_lybzx_148 ._data-panel-toolbar_lybzx_94, ._data-panel_lybzx_5._toolbar-style-floating_lybzx_148 ._data-panel-footer_lybzx_98 {
1628
1628
  border-radius: 4px;
1629
1629
  }
1630
- ._data-panel_s95k2_5._toolbar-style-floating_s95k2_148 ._data-panel-footer_s95k2_98, ._data-panel_s95k2_5._toolbar-style-floating_s95k2_148 ._data-panel-toolbar_s95k2_94 {
1630
+ ._data-panel_lybzx_5._toolbar-style-floating_lybzx_148 ._data-panel-footer_lybzx_98, ._data-panel_lybzx_5._toolbar-style-floating_lybzx_148 ._data-panel-toolbar_lybzx_94 {
1631
1631
  z-index: 10;
1632
1632
  min-width: 0;
1633
1633
  max-width: fit-content;
1634
1634
  position: absolute;
1635
1635
  width: var(--data-panel-content-width, 100%);
1636
1636
  }
1637
- ._data-panel_s95k2_5._toolbar-style-floating_s95k2_148 ._data-panel-footer_s95k2_98 > *, ._data-panel_s95k2_5._toolbar-style-floating_s95k2_148 ._data-panel-toolbar_s95k2_94 > * {
1637
+ ._data-panel_lybzx_5._toolbar-style-floating_lybzx_148 ._data-panel-footer_lybzx_98 > *, ._data-panel_lybzx_5._toolbar-style-floating_lybzx_148 ._data-panel-toolbar_lybzx_94 > * {
1638
1638
  max-width: unset;
1639
1639
  flex-grow: unset;
1640
1640
  width: unset;
1641
1641
  }
1642
- ._data-panel_s95k2_5._toolbar-style-floating_s95k2_148 ._data-panel-toolbar_s95k2_94 {
1643
- left: 50%;
1644
- transform: translateX(calc(var(--data-panel-content-width, 100cqw) / -2 + var(--data-panel-content-padding) - 4px));
1642
+ ._data-panel_lybzx_5._toolbar-style-floating_lybzx_148 ._data-panel-toolbar_lybzx_94 {
1643
+ left: calc(var(--data-panel-content-padding, 12px) - 4px);
1645
1644
  top: var(--data-panel-content-padding, 12px);
1646
1645
  background-color: var(--panel-secondary-background-color);
1647
1646
  box-shadow: 0 0 0 1px var(--panel-rule-color);
1648
1647
  }
1649
- ._data-panel_s95k2_5._toolbar-style-floating_s95k2_148 ._data-panel-toolbar_s95k2_94 ._data-panel-toolbar-content_s95k2_94 {
1648
+ ._data-panel_lybzx_5._toolbar-style-floating_lybzx_148 ._data-panel-toolbar_lybzx_94 ._data-panel-toolbar-content_lybzx_94 {
1650
1649
  padding-left: 6px;
1651
1650
  padding-right: 6px;
1652
1651
  }
1653
- ._data-panel_s95k2_5._toolbar-style-floating_s95k2_148 ._data-panel-toolbar_s95k2_94 ._data-panel-toolbar-content_s95k2_94 > *:empty {
1652
+ ._data-panel_lybzx_5._toolbar-style-floating_lybzx_148 ._data-panel-toolbar_lybzx_94 ._data-panel-toolbar-content_lybzx_94 > *:empty {
1654
1653
  display: none;
1655
1654
  }
1656
- ._data-panel_s95k2_5._toolbar-style-floating_s95k2_148 ._data-panel-footer_s95k2_98 {
1655
+ ._data-panel_lybzx_5._toolbar-style-floating_lybzx_148 ._data-panel-footer_lybzx_98 {
1657
1656
  bottom: var(--data-panel-content-padding, 12px);
1658
1657
  height: fit-content;
1659
1658
  right: var(--data-panel-content-padding, 12px);
1660
1659
  background-color: var(--background-color);
1661
1660
  }
1662
- ._data-panel_s95k2_5._toolbar-style-floating_s95k2_148 ._data-panel-body_s95k2_34 {
1661
+ ._data-panel_lybzx_5._toolbar-style-floating_lybzx_148 ._data-panel-body_lybzx_34 {
1663
1662
  padding-top: var(--data-panel-top-margin);
1664
1663
  mask-image: linear-gradient(to bottom, transparent 4px, var(--background-color) var(--data-panel-top-margin));
1665
1664
  }
1666
- ._data-panel_s95k2_5._toolbar-style-fade_s95k2_190 ._data-panel-body_s95k2_34._is-scrolled_s95k2_190 {
1665
+ ._data-panel_lybzx_5._toolbar-style-fade_lybzx_189 ._data-panel-body_lybzx_34._is-scrolled_lybzx_189 {
1667
1666
  mask-image: linear-gradient(to bottom, transparent 0, var(--background-color) 20px);
1668
1667
  }
1669
1668
 
1670
- ._collapsed-controls_s95k2_194 {
1669
+ ._collapsed-controls_lybzx_193 {
1671
1670
  max-width: 360px;
1672
1671
  }
@@ -10,7 +10,7 @@ export declare function DataSheet<T>(props: DataSheetProps<T>): import('react').
10
10
  /** The table (cell-grid) renderer. Assumes it is rendered inside a
11
11
  * `DataSheetProvider` (the `DataSheet` wrapper, or `DataView`). Exported so a
12
12
  * shared-store `DataView` can mount it directly alongside `_DataPanel`. */
13
- export declare function DataSheetRenderer<T>({ fetchData, provider, pageSize, fetchMode, filterDebounce, onVisibleCellsChange, onUpdateData, onEdit, onSave, updatedData: updatedDataProp, rowStatus: rowStatusProp, identity: _identity, deriveOverlay, refreshToken: _refreshToken, onDeleteRows, name, verbose, debug, enableFocusedCell, autoFocusEditor, cellInteraction, enableClipboard, density, selectionModes, actions, filters, columnHeaderCellRenderer, statusBar, rowStatusStyles, rowHeaderRenderer, children, ...tableProps }: DataSheetRendererProps<T>): import('react').FunctionComponentElement<any> | import('react').ReactElement<{
13
+ export declare function DataSheetRenderer<T>({ fetchData, provider, pageSize, fetchMode, filterDebounce, initialData, onVisibleCellsChange, onUpdateData, onEdit, onSave, updatedData: updatedDataProp, rowStatus: rowStatusProp, identity: _identity, deriveOverlay, refreshToken: _refreshToken, onDeleteRows, name, verbose, debug, enableFocusedCell, autoFocusEditor, cellInteraction, enableClipboard, density, selectionModes, actions, filters, columnHeaderCellRenderer, statusBar, rowStatusStyles, rowHeaderRenderer, children, ...tableProps }: DataSheetRendererProps<T>): import('react').FunctionComponentElement<any> | import('react').ReactElement<{
14
14
  className: string;
15
15
  style: Record<string, string>;
16
16
  }, string | import('react').JSXElementConstructor<any>>;
@@ -53,6 +53,7 @@ function DataSheetRenderer({
53
53
  pageSize,
54
54
  fetchMode,
55
55
  filterDebounce,
56
+ initialData,
56
57
  onVisibleCellsChange,
57
58
  onUpdateData,
58
59
  onEdit,
@@ -334,7 +335,8 @@ function DataSheetRenderer({
334
335
  fetchData: activeProvider.fetchData,
335
336
  pageSize: isLocalProvider ? Math.max(localCount, 1) : pageSize,
336
337
  fetchMode: isLocalProvider ? void 0 : fetchMode,
337
- filterDebounce
338
+ filterDebounce,
339
+ initialData
338
340
  });
339
341
  }
340
342
  const showFilterBar = filters != null && filters.length > 0 || hasSortableOrFilterable;
@@ -1 +1 @@
1
- {"version":3,"file":"data-sheet.js","sources":["../src/data-sheet.ts"],"sourcesContent":["import { useHotkeys } from \"@blueprintjs/core\";\nimport {\n Column,\n RegionCardinality,\n RowHeaderCell,\n Table,\n} from \"@blueprintjs/table\";\nimport \"@blueprintjs/table/lib/css/table.css\";\nimport {\n CSSProperties,\n ReactNode,\n useCallback,\n useEffect,\n useMemo,\n useRef,\n} from \"react\";\nimport {\n LoadProgressIndicator,\n ActionsToolbar,\n ActiveFiltersList,\n} from \"./components\";\nimport { basicCellRenderer, renderColumnHeaderCell } from \"./renderers\";\nimport h from \"./main.module.sass\";\nimport {\n columnSpecAtom,\n ctx,\n dataProviderAtom,\n dataRefreshTokenAtom,\n DataSheetProvider,\n DataViewRendererType,\n DEFAULT_ROW_STATUS_STYLES,\n FetchData,\n persistViaProvider,\n RowStatusStyles,\n splitDataProviderProps,\n storeAtom,\n tableActionsAtom,\n TableElementStatus,\n useSelector,\n useStoreAPI,\n VisibleCells,\n} from \"./provider\";\nimport { atom } from \"jotai\";\nimport { CellRendererDebugOverlay, tableHotkeysAtom } from \"./utils\";\nimport {\n clipboardActions,\n columnControlActions,\n createSaveAction,\n resetChangesAction,\n TableAction,\n TableActionContext,\n} from \"./actions\";\nimport {\n tableFooterAtom,\n useDataLoader,\n useScrollHandler,\n} from \"./postgrest-table\";\nimport {\n CellInteraction,\n DataSheetDensity,\n DataSheetProps,\n DataSheetRendererProps,\n FetchDataOptions,\n} from \"./types.ts\";\nimport { ErrorCallout } from \"@macrostrat/ui-components\";\n\n// More on component templates: https://storybook.js.org/docs/react/writing-stories/introduction#using-args\n\n// TODO: add a \"copy to selection\" tool (the little square in the bottom right corner of a cell)\n// This should copy the value of a cell (or a set of cells in the same row) downwards.\n\n/** Approximate column-header + scrollbar allowance, used to size the table to\n * its content in paged mode. */\nconst COLUMN_HEADER_HEIGHT = 34;\n\nexport function DataSheet<T>(props: DataSheetProps<T>) {\n const {\n data,\n columnSpec,\n columnSpecOptions,\n editable = true,\n enableColumnReordering = false,\n enableFocusedCell = false,\n defaultColumnWidth = 150,\n children,\n name,\n ...rest\n } = props;\n\n const [providerProps, rendererProps] = splitDataProviderProps<T>({\n ...props,\n viewType: DataViewRendererType.TABLE,\n });\n return h(\n DataSheetProvider<T>,\n providerProps,\n h(DataSheetRenderer<any>, rendererProps),\n );\n}\n\nconst verboseAtom = atom(false);\n\n/** The table (cell-grid) renderer. Assumes it is rendered inside a\n * `DataSheetProvider` (the `DataSheet` wrapper, or `DataView`). Exported so a\n * shared-store `DataView` can mount it directly alongside `_DataPanel`. */\nexport function DataSheetRenderer<T>({\n fetchData,\n provider,\n pageSize,\n fetchMode,\n filterDebounce,\n onVisibleCellsChange,\n onUpdateData,\n onEdit,\n onSave,\n updatedData: updatedDataProp,\n rowStatus: rowStatusProp,\n // Identity/canDeleteRows sync (was here) is now handled by the provider\n // (`DataSheetProviderInner`); still destructured so `identity`/`refreshToken`\n // don't leak into `...rest` (spread onto the Blueprint `Table` below).\n identity: _identity,\n deriveOverlay,\n refreshToken: _refreshToken,\n onDeleteRows,\n name,\n verbose = false,\n debug = false,\n enableFocusedCell,\n autoFocusEditor = true,\n cellInteraction,\n enableClipboard = true,\n density = DataSheetDensity.HIGH,\n selectionModes,\n actions,\n filters,\n columnHeaderCellRenderer,\n statusBar,\n rowStatusStyles,\n rowHeaderRenderer,\n children,\n ...tableProps\n}: DataSheetRendererProps<T>) {\n /**\n * @param data: The data to be displayed in the table\n * @param columnSpec: The specification for all columns in the table. If not provided, the column spec will be generated from the data.\n * @param columnSpecOptions: Options for generating a column spec from data\n */\n\n ctx.useSync(verboseAtom, verbose);\n\n const editable = useSelector((state) => state.editable);\n\n // The active data source is resolved in the wrapper (`DataSheet`) and held in\n // the provider layer; read it here rather than resolving per render.\n const {\n provider: activeProvider,\n isLocalProvider,\n localCount,\n } = ctx.useValue(dataProviderAtom);\n\n // When an explicit provider owns persistence, its methods drive the built-in\n // Save (batch: edits→saveRows, added→insertRow, deleted→deleteRows), then a\n // refresh. Otherwise the loose `onSave` handler is used.\n const bumpRefresh = ctx.useSet(dataRefreshTokenAtom);\n const providerSave = useMemo(() => {\n const p = provider;\n if (\n p == null ||\n (p.saveRows == null && p.deleteRows == null && p.insertRow == null)\n ) {\n return null;\n }\n return async (actionCtx: TableActionContext<T>) => {\n await persistViaProvider(p, actionCtx);\n bumpRefresh((v) => v + 1);\n };\n }, [provider, bumpRefresh]);\n const saveHandler = onSave ?? providerSave;\n\n // Sync table actions to atom. Consumer actions come first (they override a\n // built-in by reusing its id); the built-in column controls (sort/filter)\n // fill in the rest — so both the toolbar and the header dropdown source from\n // one registry. Built-ins self-gate (single sortable/filterable column).\n const _actions: TableAction[] = useMemo(() => {\n const _actions: TableAction[] = [];\n const add = (list: TableAction[]) => {\n for (const a of list) {\n if (!_actions.some((x) => x.id === a.id)) _actions.push(a);\n }\n };\n if (actions != null) add(actions);\n add(columnControlActions);\n if (enableClipboard) add(clipboardActions);\n // Save/reset last — they're the most significant actions — and present for\n // every cardinality (editable), so the toolbar stays mounted regardless of\n // selection.\n if (editable) {\n if (saveHandler != null) add([createSaveAction(saveHandler)]);\n add([resetChangesAction]);\n }\n return _actions;\n }, [actions, enableClipboard, editable, saveHandler]);\n\n /*** TODO: generalize this, probably shouldn't need 'set' */\n ctx.useSync(tableActionsAtom, _actions);\n const getHotkeys = ctx.useSet(tableHotkeysAtom);\n\n // This is quite hacky!\n const hotkeysConfig = useMemo(() => {\n return getHotkeys();\n }, [_actions]);\n\n const { handleKeyDown, handleKeyUp } = useHotkeys(hotkeysConfig);\n\n // For now, we only consider a single cell \"focused\" when we have one cell selected.\n // Multi-cell selections have a different set of \"bulk\" actions.\n const selectedRegions = useSelector<T>((state) => state.selection ?? []);\n\n const data = useSelector((state) => state.data);\n\n const rowStatus = useSelector((state) => state.rowStatus);\n\n const focusedCell = useSelector((state) => state.focusedCell);\n\n const ref = useSelector((state) => state.tableRef);\n\n const columnSpec = useSelector((state) => state.columnSpec);\n\n // A sparse array to hold updates\n // TODO: create a \"changeset\" concept to facilitate undo/redo\n const updatedData = useSelector((state) => state.updatedData);\n\n const onSelection = useSelector((state) => state.onSelection);\n\n const storeAPI = useStoreAPI<T>();\n\n const onScroll = useScrollHandler();\n const _onVisibleCellsChange = useCallback(\n (visibleCells: VisibleCells) => {\n onScroll(visibleCells);\n onVisibleCellsChange?.(visibleCells);\n },\n [onVisibleCellsChange, onScroll],\n );\n\n useEffect(() => {\n if (!verbose) return;\n console.log(\"Updated data\", updatedData);\n }, [updatedData]);\n\n useEffect(() => {\n onUpdateData?.(updatedData, data);\n }, [onUpdateData, data, updatedData]);\n\n useEffect(() => {\n if (!verbose) return;\n console.log(\"Selected regions\", selectedRegions);\n }, [selectedRegions]);\n\n const tableElementRef = useRef<HTMLElement>(null);\n useEffect(() => {\n // Return the focus to the table\n tableElementRef.current?.focus();\n }, [focusedCell]);\n\n const columnWidths = ctx.useValue(columnWidthsAtom);\n\n // When filters are active, only show matching rows\n const filteredRowIndices = useSelector((state) => state.filteredRowIndices);\n const totalRows = Math.max(updatedData.length, data.length);\n const numRows =\n filteredRowIndices != null ? filteredRowIndices.length : totalRows;\n\n let className = `${density}-density`;\n\n const { rowHeight, style } = styleParamsForDensity(density);\n\n // In paged mode the row count is small and fixed, so let the table size to\n // its content (header + rows) instead of filling the viewport.\n const footerInfo = ctx.useValue(tableFooterAtom);\n let holderStyle: CSSProperties | undefined = undefined;\n if (footerInfo.mode === \"paged\") {\n holderStyle = {\n flex: \"0 0 auto\" as const,\n height: numRows * rowHeight + COLUMN_HEADER_HEIGHT,\n };\n }\n\n const onColumnsReordered = useSelector((state) => state.onColumnsReordered);\n // Whether table-level column drag-reordering is enabled. Held in the store\n // (set from the `enableColumnReordering` prop by the provider); it must reach\n // the Blueprint `Table` — the `onColumnsReordered` handler alone doesn't turn\n // on the drag affordance.\n const enableColumnReordering = useSelector(\n (state) => state.enableColumnReordering,\n );\n\n // Auto-detect if any columns have sortable/filterable set.\n // If so and no explicit columnHeaderCellRenderer was provided,\n // use the built-in client-side sort/filter header.\n const hasSortableOrFilterable = useMemo(\n () =>\n columnSpec.some(\n (col) =>\n col.sortable ||\n col.filterable ||\n (Array.isArray(col.filters) && col.filters.length > 0),\n ),\n [columnSpec],\n );\n\n const columnSorts = useSelector((state) => state.columnSorts);\n const activeFilters = useSelector((state) => state.activeFilters);\n\n // Cell activation mode, defaulting from the legacy `autoFocusEditor` boolean\n // so existing consumers are unaffected. Synced into the store so the cell\n // renderer, editors, and key handlers all read it consistently.\n const cellInteractionMode: CellInteraction =\n cellInteraction ?? (autoFocusEditor ? \"auto\" : \"manual\");\n\n const storeState = storeAPI;\n useEffect(() => {\n storeState.setState({ cellInteraction: cellInteractionMode });\n }, [storeState, cellInteractionMode]);\n\n useEffect(() => {\n // Give the store a handle to the focusable holder so editors can return\n // keyboard focus to the table when the cursor leaves them.\n storeState.setState({ tableElement: tableElementRef.current });\n }, [storeState]);\n\n useEffect(() => {\n storeState.setState({ onEdit });\n }, [storeState, onEdit]);\n\n useEffect(() => {\n // Controlled overlay: mirror the caller's edited state into the store as\n // the source of truth. Optimistic in-table edits are superseded on the\n // next render when the caller passes an updated value back. When the caller\n // controls it, the loader-boundary identity remap steps aside.\n const controlled =\n updatedDataProp !== undefined ||\n rowStatusProp !== undefined ||\n deriveOverlay != null;\n const patch: Record<string, unknown> = { controlledOverlay: controlled };\n if (updatedDataProp !== undefined) patch.updatedData = updatedDataProp;\n if (rowStatusProp !== undefined) patch.rowStatus = rowStatusProp;\n storeState.setState(patch);\n }, [storeState, updatedDataProp, rowStatusProp, deriveOverlay]);\n\n // Derived controlled overlay: the library owns the loaded rows, so it runs\n // the consumer's `deriveOverlay(rows)` here and pushes the result. Re-derives\n // when the rows load/change or the function's identity changes (close it over\n // your external edit state). The `controlledOverlay` flag above suppresses the\n // loader-boundary identity remap so this derivation is authoritative.\n useEffect(() => {\n if (deriveOverlay == null) return;\n const overlay = deriveOverlay(data);\n storeState.setState({\n updatedData: overlay.updatedData,\n rowStatus: overlay.rowStatus,\n });\n }, [deriveOverlay, data, storeState]);\n\n // Function `columnSpec` derivation is hoisted to the provider\n // (`DataSheetProviderInner`), shared by both renderers.\n\n // Identity and canDeleteRows sync are hoisted to the provider\n // (`DataSheetProviderInner`), shared with `_DataPanel` — both depend only on\n // the resolved data provider, not any sheet-specific state.\n\n // Merge consumer `rowStatusStyles` over the built-in defaults and hand the\n // result to the store, where the cell renderer and row-header renderer read\n // it. Merged (not replaced) so overriding one status doesn't drop the rest.\n const mergedRowStatusStyles = useMemo<RowStatusStyles>(\n () => ({ ...DEFAULT_ROW_STATUS_STYLES, ...rowStatusStyles }),\n [rowStatusStyles],\n );\n useEffect(() => {\n storeState.setState({ rowStatusStyles: mergedRowStatusStyles });\n }, [storeState, mergedRowStatusStyles]);\n\n const realizedColumns = useMemo(() => {\n return columnSpec.map((col, colIndex) => {\n let fn =\n col.headerRenderer ??\n columnHeaderCellRenderer ??\n renderColumnHeaderCell;\n let activeSort: any = null;\n let activeFilter: any = null;\n if (col.sortable) {\n activeSort = columnSorts?.find((s) => s.key === col.key);\n }\n // The active filter for this column is whichever active filter targets\n // it (a rich `col.filters` filter or the generic operator filter) — match\n // by columnKey rather than a fixed id.\n for (const entry of activeFilters?.values() ?? []) {\n if ((entry as any)?.filter?.columnKey === col.key) {\n activeFilter = entry;\n break;\n }\n }\n\n const _columnHeaderCellRenderer: any = (colIndex) => {\n return fn(\n {\n col,\n colIndex,\n activeSort,\n activeFilter,\n },\n colIndex,\n );\n };\n\n return h(Column, {\n id: col.key,\n name: col.name,\n columnHeaderCellRenderer: _columnHeaderCellRenderer as any,\n cellRenderer: (rowIndex) => {\n const state = storeAPI.getState();\n return basicCellRenderer<T>(\n rowIndex,\n colIndex,\n col,\n state,\n filteredRowIndices,\n );\n },\n });\n });\n }, [\n columnSpec,\n columnSorts,\n activeFilters,\n storeAPI,\n filteredRowIndices,\n columnHeaderCellRenderer,\n ]);\n\n const onColumnWidthChanged = useSelector(\n (state) => state.onColumnWidthChanged,\n );\n\n const rowHeaderCellRenderer = useCallback(\n (rowIndex: number) => {\n let dataRowIndex = rowIndex;\n if (filteredRowIndices != null) {\n dataRowIndex = filteredRowIndices[rowIndex] ?? rowIndex;\n }\n const statusVal = rowStatus[dataRowIndex];\n let style: CSSProperties | undefined;\n if (statusVal != null) {\n style = mergedRowStatusStyles[statusVal]?.headerStyle;\n }\n\n const defaultLabel = `${dataRowIndex + 1}`;\n // A custom renderer supplies the header's *name* content (a group-key\n // label, an omit indicator, …); a nullish return keeps the default\n // 1-based label. Either way the node is wrapped in a `RowHeaderCell` so\n // status styling and the row index are always applied — the renderer is\n // not responsible for producing the whole cell.\n let name: ReactNode = defaultLabel;\n if (rowHeaderRenderer != null) {\n const custom = rowHeaderRenderer({\n rowIndex: dataRowIndex,\n visibleIndex: rowIndex,\n row: data[dataRowIndex] ?? updatedData[dataRowIndex],\n status: statusVal,\n isDeleted: statusVal === TableElementStatus.DELETED,\n defaultLabel,\n });\n if (custom != null) name = custom;\n }\n\n return h(RowHeaderCell, {\n enableRowReordering: false,\n index: rowIndex,\n name,\n style,\n });\n },\n [\n rowStatus,\n filteredRowIndices,\n mergedRowStatusStyles,\n rowHeaderRenderer,\n data,\n updatedData,\n ],\n );\n\n // Done with hooks!\n /** Guard for unacceptable state combinations:\n * editable = true requires selectionModes to include cells, else the user cannot select a cell to edit.\n * TODO: make this an impossible state to enter.\n */\n if (\n editable &&\n selectionModes &&\n !selectionModes.includes(RegionCardinality.CELLS)\n ) {\n return h(ErrorCallout, {\n title: \"Invalid selection mode\",\n description: \"Editable sheet requires cell selection\",\n });\n }\n\n // TODO: hoist this\n let _selectionModes = selectionModes;\n if (\n editable &&\n _selectionModes != null &&\n !_selectionModes.includes(RegionCardinality.CELLS)\n ) {\n _selectionModes = [..._selectionModes, RegionCardinality.CELLS];\n // Ensure selection mode includes \"cells\"\n }\n\n const cellRendererDependencies = [\n data,\n updatedData,\n focusedCell,\n rowStatus,\n filteredRowIndices,\n ];\n\n // Drive the table from the active provider's `fetchData`. A local (in-memory)\n // provider loads the whole array at once; a remote one uses the `pageSize` /\n // `fetchMode` props and shows load progress.\n let _showLoadProgress: boolean = false;\n let dataLoader: ReactNode = null;\n if (activeProvider != null) {\n _showLoadProgress = !isLocalProvider;\n // A local (in-memory) source loads all its rows in one page; its count\n // rides on the resolved provider (`localCount`), so `_DataSheet` no longer\n // takes a `data` prop — live rows come only from the store.\n dataLoader = h(_DataLoaderManager, {\n key: \"__data_loader\",\n fetchData: activeProvider.fetchData,\n pageSize: isLocalProvider ? Math.max(localCount, 1) : pageSize,\n fetchMode: isLocalProvider ? undefined : fetchMode,\n filterDebounce,\n });\n }\n const showFilterBar =\n (filters != null && filters.length > 0) || hasSortableOrFilterable;\n\n let filterStatus: ReactNode = null;\n if (showFilterBar) {\n filterStatus = h(ActiveFiltersList, { filters: filters ?? [] });\n }\n\n return h(\"div.data-sheet-container\", { className, style }, [\n // The actions/tools toolbar (selection-modal). Table-scoped controls like\n // scroll-to-row / full-text search live here as ordinary actions.\n h(ActionsToolbar, { actions: _actions }),\n dataLoader,\n children,\n h(\n \"div.data-sheet-holder\",\n {\n tabIndex: 0,\n onKeyDown: handleKeyDown,\n onKeyUp: handleKeyUp,\n ref: tableElementRef,\n style: holderStyle,\n },\n h(\n Table as any, // Some sort of hyperscript type error\n {\n ref,\n numRows,\n className: \"data-sheet\",\n enableFocusedCell,\n enableColumnReordering,\n onColumnsReordered,\n focusedCell,\n selectedRegions,\n defaultRowHeight: rowHeight,\n columnWidths,\n onColumnWidthChanged,\n onSelection,\n /** TODO: we could enable this if we had a use-case */\n enableRowReordering: false,\n enableRowResizing: false,\n // The cell renderer is memoized internally based on these data dependencies\n cellRendererDependencies,\n onVisibleCellsChange: _onVisibleCellsChange,\n rowHeaderCellRenderer,\n selectionModes: _selectionModes,\n ...tableProps,\n getCellClipboardData: null,\n },\n realizedColumns,\n ),\n ),\n h(\"div.status-bar\", [\n filterStatus,\n statusBar,\n h(\"div.spacer\"),\n h.if(_showLoadProgress)(LoadProgressIndicator),\n ]),\n h.if(debug)(CellRendererDebugOverlay, {\n cellRendererDependencies,\n names: [\n \"data\",\n \"updatedData\",\n \"focusedCell\",\n \"rowStatus\",\n \"filteredRowIndices\",\n ],\n }),\n ]);\n}\n\nconst EMPTY_MAP = new Map<string, number>();\n\nconst columnWidthsIndexAtom = atom(\n (get) => get(storeAtom)?.columnWidthsIndex ?? EMPTY_MAP,\n);\nconst defaultColumnWidthAtom = atom(\n (get) => get(storeAtom)?.defaultColumnWidth ?? 150,\n);\n\nconst columnWidthsAtom = atom((get) => {\n const ix = get(columnWidthsIndexAtom);\n return get(columnSpecAtom).map(\n (col) => ix.get(col.key) ?? col.width ?? get(defaultColumnWidthAtom),\n );\n});\n\nfunction styleParamsForDensity(density: DataSheetDensity): {\n rowHeight: number;\n style: Record<string, string>;\n} {\n switch (density) {\n case DataSheetDensity.MEDIUM:\n return {\n rowHeight: 24,\n style: {\n \"--data-sheet-row-height\": \"24px\",\n \"--data-sheet-font-size\": \"14px\",\n },\n };\n case DataSheetDensity.LOW:\n return {\n rowHeight: 30,\n style: {\n \"--data-sheet-row-height\": \"30px\",\n \"--data-sheet-font-size\": \"18px\",\n },\n };\n case DataSheetDensity.HIGH:\n default:\n return {\n rowHeight: 20,\n style: {\n \"--data-sheet-row-height\": \"20px\",\n \"--data-sheet-font-size\": \"12px\",\n },\n };\n }\n}\n\n/** Convenience component: runs `useChunkLoader` from inside a `DataSheet`.\n * Render as a child of `DataSheet` (it renders nothing itself). */\nfunction _DataLoaderManager<T = any>({\n fetchData,\n ...rest\n}: {\n fetchData: FetchData<T>;\n} & FetchDataOptions) {\n useDataLoader(fetchData, rest);\n return null;\n}\n"],"names":["_actions","colIndex","style","name"],"mappings":"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"}
1
+ {"version":3,"file":"data-sheet.js","sources":["../src/data-sheet.ts"],"sourcesContent":["import { useHotkeys } from \"@blueprintjs/core\";\nimport {\n Column,\n RegionCardinality,\n RowHeaderCell,\n Table,\n} from \"@blueprintjs/table\";\nimport \"@blueprintjs/table/lib/css/table.css\";\nimport {\n CSSProperties,\n ReactNode,\n useCallback,\n useEffect,\n useMemo,\n useRef,\n} from \"react\";\nimport {\n LoadProgressIndicator,\n ActionsToolbar,\n ActiveFiltersList,\n} from \"./components\";\nimport { basicCellRenderer, renderColumnHeaderCell } from \"./renderers\";\nimport h from \"./main.module.sass\";\nimport {\n columnSpecAtom,\n ctx,\n dataProviderAtom,\n dataRefreshTokenAtom,\n DataSheetProvider,\n DataViewRendererType,\n DEFAULT_ROW_STATUS_STYLES,\n FetchData,\n persistViaProvider,\n RowStatusStyles,\n splitDataProviderProps,\n storeAtom,\n tableActionsAtom,\n TableElementStatus,\n useSelector,\n useStoreAPI,\n VisibleCells,\n} from \"./provider\";\nimport { atom } from \"jotai\";\nimport { CellRendererDebugOverlay, tableHotkeysAtom } from \"./utils\";\nimport {\n clipboardActions,\n columnControlActions,\n createSaveAction,\n resetChangesAction,\n TableAction,\n TableActionContext,\n} from \"./actions\";\nimport {\n tableFooterAtom,\n useDataLoader,\n useScrollHandler,\n} from \"./postgrest-table\";\nimport {\n CellInteraction,\n DataSheetDensity,\n DataSheetProps,\n DataSheetRendererProps,\n FetchDataOptions,\n} from \"./types.ts\";\nimport { ErrorCallout } from \"@macrostrat/ui-components\";\n\n// More on component templates: https://storybook.js.org/docs/react/writing-stories/introduction#using-args\n\n// TODO: add a \"copy to selection\" tool (the little square in the bottom right corner of a cell)\n// This should copy the value of a cell (or a set of cells in the same row) downwards.\n\n/** Approximate column-header + scrollbar allowance, used to size the table to\n * its content in paged mode. */\nconst COLUMN_HEADER_HEIGHT = 34;\n\nexport function DataSheet<T>(props: DataSheetProps<T>) {\n const {\n data,\n columnSpec,\n columnSpecOptions,\n editable = true,\n enableColumnReordering = false,\n enableFocusedCell = false,\n defaultColumnWidth = 150,\n children,\n name,\n ...rest\n } = props;\n\n const [providerProps, rendererProps] = splitDataProviderProps<T>({\n ...props,\n viewType: DataViewRendererType.TABLE,\n });\n return h(\n DataSheetProvider<T>,\n providerProps,\n h(DataSheetRenderer<any>, rendererProps),\n );\n}\n\nconst verboseAtom = atom(false);\n\n/** The table (cell-grid) renderer. Assumes it is rendered inside a\n * `DataSheetProvider` (the `DataSheet` wrapper, or `DataView`). Exported so a\n * shared-store `DataView` can mount it directly alongside `_DataPanel`. */\nexport function DataSheetRenderer<T>({\n fetchData,\n provider,\n pageSize,\n fetchMode,\n filterDebounce,\n initialData,\n onVisibleCellsChange,\n onUpdateData,\n onEdit,\n onSave,\n updatedData: updatedDataProp,\n rowStatus: rowStatusProp,\n // Identity/canDeleteRows sync (was here) is now handled by the provider\n // (`DataSheetProviderInner`); still destructured so `identity`/`refreshToken`\n // don't leak into `...rest` (spread onto the Blueprint `Table` below).\n identity: _identity,\n deriveOverlay,\n refreshToken: _refreshToken,\n onDeleteRows,\n name,\n verbose = false,\n debug = false,\n enableFocusedCell,\n autoFocusEditor = true,\n cellInteraction,\n enableClipboard = true,\n density = DataSheetDensity.HIGH,\n selectionModes,\n actions,\n filters,\n columnHeaderCellRenderer,\n statusBar,\n rowStatusStyles,\n rowHeaderRenderer,\n children,\n ...tableProps\n}: DataSheetRendererProps<T>) {\n /**\n * @param data: The data to be displayed in the table\n * @param columnSpec: The specification for all columns in the table. If not provided, the column spec will be generated from the data.\n * @param columnSpecOptions: Options for generating a column spec from data\n */\n\n ctx.useSync(verboseAtom, verbose);\n\n const editable = useSelector((state) => state.editable);\n\n // The active data source is resolved in the wrapper (`DataSheet`) and held in\n // the provider layer; read it here rather than resolving per render.\n const {\n provider: activeProvider,\n isLocalProvider,\n localCount,\n } = ctx.useValue(dataProviderAtom);\n\n // When an explicit provider owns persistence, its methods drive the built-in\n // Save (batch: edits→saveRows, added→insertRow, deleted→deleteRows), then a\n // refresh. Otherwise the loose `onSave` handler is used.\n const bumpRefresh = ctx.useSet(dataRefreshTokenAtom);\n const providerSave = useMemo(() => {\n const p = provider;\n if (\n p == null ||\n (p.saveRows == null && p.deleteRows == null && p.insertRow == null)\n ) {\n return null;\n }\n return async (actionCtx: TableActionContext<T>) => {\n await persistViaProvider(p, actionCtx);\n bumpRefresh((v) => v + 1);\n };\n }, [provider, bumpRefresh]);\n const saveHandler = onSave ?? providerSave;\n\n // Sync table actions to atom. Consumer actions come first (they override a\n // built-in by reusing its id); the built-in column controls (sort/filter)\n // fill in the rest — so both the toolbar and the header dropdown source from\n // one registry. Built-ins self-gate (single sortable/filterable column).\n const _actions: TableAction[] = useMemo(() => {\n const _actions: TableAction[] = [];\n const add = (list: TableAction[]) => {\n for (const a of list) {\n if (!_actions.some((x) => x.id === a.id)) _actions.push(a);\n }\n };\n if (actions != null) add(actions);\n add(columnControlActions);\n if (enableClipboard) add(clipboardActions);\n // Save/reset last — they're the most significant actions — and present for\n // every cardinality (editable), so the toolbar stays mounted regardless of\n // selection.\n if (editable) {\n if (saveHandler != null) add([createSaveAction(saveHandler)]);\n add([resetChangesAction]);\n }\n return _actions;\n }, [actions, enableClipboard, editable, saveHandler]);\n\n /*** TODO: generalize this, probably shouldn't need 'set' */\n ctx.useSync(tableActionsAtom, _actions);\n const getHotkeys = ctx.useSet(tableHotkeysAtom);\n\n // This is quite hacky!\n const hotkeysConfig = useMemo(() => {\n return getHotkeys();\n }, [_actions]);\n\n const { handleKeyDown, handleKeyUp } = useHotkeys(hotkeysConfig);\n\n // For now, we only consider a single cell \"focused\" when we have one cell selected.\n // Multi-cell selections have a different set of \"bulk\" actions.\n const selectedRegions = useSelector<T>((state) => state.selection ?? []);\n\n const data = useSelector((state) => state.data);\n\n const rowStatus = useSelector((state) => state.rowStatus);\n\n const focusedCell = useSelector((state) => state.focusedCell);\n\n const ref = useSelector((state) => state.tableRef);\n\n const columnSpec = useSelector((state) => state.columnSpec);\n\n // A sparse array to hold updates\n // TODO: create a \"changeset\" concept to facilitate undo/redo\n const updatedData = useSelector((state) => state.updatedData);\n\n const onSelection = useSelector((state) => state.onSelection);\n\n const storeAPI = useStoreAPI<T>();\n\n const onScroll = useScrollHandler();\n const _onVisibleCellsChange = useCallback(\n (visibleCells: VisibleCells) => {\n onScroll(visibleCells);\n onVisibleCellsChange?.(visibleCells);\n },\n [onVisibleCellsChange, onScroll],\n );\n\n useEffect(() => {\n if (!verbose) return;\n console.log(\"Updated data\", updatedData);\n }, [updatedData]);\n\n useEffect(() => {\n onUpdateData?.(updatedData, data);\n }, [onUpdateData, data, updatedData]);\n\n useEffect(() => {\n if (!verbose) return;\n console.log(\"Selected regions\", selectedRegions);\n }, [selectedRegions]);\n\n const tableElementRef = useRef<HTMLElement>(null);\n useEffect(() => {\n // Return the focus to the table\n tableElementRef.current?.focus();\n }, [focusedCell]);\n\n const columnWidths = ctx.useValue(columnWidthsAtom);\n\n // When filters are active, only show matching rows\n const filteredRowIndices = useSelector((state) => state.filteredRowIndices);\n const totalRows = Math.max(updatedData.length, data.length);\n const numRows =\n filteredRowIndices != null ? filteredRowIndices.length : totalRows;\n\n let className = `${density}-density`;\n\n const { rowHeight, style } = styleParamsForDensity(density);\n\n // In paged mode the row count is small and fixed, so let the table size to\n // its content (header + rows) instead of filling the viewport.\n const footerInfo = ctx.useValue(tableFooterAtom);\n let holderStyle: CSSProperties | undefined = undefined;\n if (footerInfo.mode === \"paged\") {\n holderStyle = {\n flex: \"0 0 auto\" as const,\n height: numRows * rowHeight + COLUMN_HEADER_HEIGHT,\n };\n }\n\n const onColumnsReordered = useSelector((state) => state.onColumnsReordered);\n // Whether table-level column drag-reordering is enabled. Held in the store\n // (set from the `enableColumnReordering` prop by the provider); it must reach\n // the Blueprint `Table` — the `onColumnsReordered` handler alone doesn't turn\n // on the drag affordance.\n const enableColumnReordering = useSelector(\n (state) => state.enableColumnReordering,\n );\n\n // Auto-detect if any columns have sortable/filterable set.\n // If so and no explicit columnHeaderCellRenderer was provided,\n // use the built-in client-side sort/filter header.\n const hasSortableOrFilterable = useMemo(\n () =>\n columnSpec.some(\n (col) =>\n col.sortable ||\n col.filterable ||\n (Array.isArray(col.filters) && col.filters.length > 0),\n ),\n [columnSpec],\n );\n\n const columnSorts = useSelector((state) => state.columnSorts);\n const activeFilters = useSelector((state) => state.activeFilters);\n\n // Cell activation mode, defaulting from the legacy `autoFocusEditor` boolean\n // so existing consumers are unaffected. Synced into the store so the cell\n // renderer, editors, and key handlers all read it consistently.\n const cellInteractionMode: CellInteraction =\n cellInteraction ?? (autoFocusEditor ? \"auto\" : \"manual\");\n\n const storeState = storeAPI;\n useEffect(() => {\n storeState.setState({ cellInteraction: cellInteractionMode });\n }, [storeState, cellInteractionMode]);\n\n useEffect(() => {\n // Give the store a handle to the focusable holder so editors can return\n // keyboard focus to the table when the cursor leaves them.\n storeState.setState({ tableElement: tableElementRef.current });\n }, [storeState]);\n\n useEffect(() => {\n storeState.setState({ onEdit });\n }, [storeState, onEdit]);\n\n useEffect(() => {\n // Controlled overlay: mirror the caller's edited state into the store as\n // the source of truth. Optimistic in-table edits are superseded on the\n // next render when the caller passes an updated value back. When the caller\n // controls it, the loader-boundary identity remap steps aside.\n const controlled =\n updatedDataProp !== undefined ||\n rowStatusProp !== undefined ||\n deriveOverlay != null;\n const patch: Record<string, unknown> = { controlledOverlay: controlled };\n if (updatedDataProp !== undefined) patch.updatedData = updatedDataProp;\n if (rowStatusProp !== undefined) patch.rowStatus = rowStatusProp;\n storeState.setState(patch);\n }, [storeState, updatedDataProp, rowStatusProp, deriveOverlay]);\n\n // Derived controlled overlay: the library owns the loaded rows, so it runs\n // the consumer's `deriveOverlay(rows)` here and pushes the result. Re-derives\n // when the rows load/change or the function's identity changes (close it over\n // your external edit state). The `controlledOverlay` flag above suppresses the\n // loader-boundary identity remap so this derivation is authoritative.\n useEffect(() => {\n if (deriveOverlay == null) return;\n const overlay = deriveOverlay(data);\n storeState.setState({\n updatedData: overlay.updatedData,\n rowStatus: overlay.rowStatus,\n });\n }, [deriveOverlay, data, storeState]);\n\n // Function `columnSpec` derivation is hoisted to the provider\n // (`DataSheetProviderInner`), shared by both renderers.\n\n // Identity and canDeleteRows sync are hoisted to the provider\n // (`DataSheetProviderInner`), shared with `_DataPanel` — both depend only on\n // the resolved data provider, not any sheet-specific state.\n\n // Merge consumer `rowStatusStyles` over the built-in defaults and hand the\n // result to the store, where the cell renderer and row-header renderer read\n // it. Merged (not replaced) so overriding one status doesn't drop the rest.\n const mergedRowStatusStyles = useMemo<RowStatusStyles>(\n () => ({ ...DEFAULT_ROW_STATUS_STYLES, ...rowStatusStyles }),\n [rowStatusStyles],\n );\n useEffect(() => {\n storeState.setState({ rowStatusStyles: mergedRowStatusStyles });\n }, [storeState, mergedRowStatusStyles]);\n\n const realizedColumns = useMemo(() => {\n return columnSpec.map((col, colIndex) => {\n let fn =\n col.headerRenderer ??\n columnHeaderCellRenderer ??\n renderColumnHeaderCell;\n let activeSort: any = null;\n let activeFilter: any = null;\n if (col.sortable) {\n activeSort = columnSorts?.find((s) => s.key === col.key);\n }\n // The active filter for this column is whichever active filter targets\n // it (a rich `col.filters` filter or the generic operator filter) — match\n // by columnKey rather than a fixed id.\n for (const entry of activeFilters?.values() ?? []) {\n if ((entry as any)?.filter?.columnKey === col.key) {\n activeFilter = entry;\n break;\n }\n }\n\n const _columnHeaderCellRenderer: any = (colIndex) => {\n return fn(\n {\n col,\n colIndex,\n activeSort,\n activeFilter,\n },\n colIndex,\n );\n };\n\n return h(Column, {\n id: col.key,\n name: col.name,\n columnHeaderCellRenderer: _columnHeaderCellRenderer as any,\n cellRenderer: (rowIndex) => {\n const state = storeAPI.getState();\n return basicCellRenderer<T>(\n rowIndex,\n colIndex,\n col,\n state,\n filteredRowIndices,\n );\n },\n });\n });\n }, [\n columnSpec,\n columnSorts,\n activeFilters,\n storeAPI,\n filteredRowIndices,\n columnHeaderCellRenderer,\n ]);\n\n const onColumnWidthChanged = useSelector(\n (state) => state.onColumnWidthChanged,\n );\n\n const rowHeaderCellRenderer = useCallback(\n (rowIndex: number) => {\n let dataRowIndex = rowIndex;\n if (filteredRowIndices != null) {\n dataRowIndex = filteredRowIndices[rowIndex] ?? rowIndex;\n }\n const statusVal = rowStatus[dataRowIndex];\n let style: CSSProperties | undefined;\n if (statusVal != null) {\n style = mergedRowStatusStyles[statusVal]?.headerStyle;\n }\n\n const defaultLabel = `${dataRowIndex + 1}`;\n // A custom renderer supplies the header's *name* content (a group-key\n // label, an omit indicator, …); a nullish return keeps the default\n // 1-based label. Either way the node is wrapped in a `RowHeaderCell` so\n // status styling and the row index are always applied — the renderer is\n // not responsible for producing the whole cell.\n let name: ReactNode = defaultLabel;\n if (rowHeaderRenderer != null) {\n const custom = rowHeaderRenderer({\n rowIndex: dataRowIndex,\n visibleIndex: rowIndex,\n row: data[dataRowIndex] ?? updatedData[dataRowIndex],\n status: statusVal,\n isDeleted: statusVal === TableElementStatus.DELETED,\n defaultLabel,\n });\n if (custom != null) name = custom;\n }\n\n return h(RowHeaderCell, {\n enableRowReordering: false,\n index: rowIndex,\n name,\n style,\n });\n },\n [\n rowStatus,\n filteredRowIndices,\n mergedRowStatusStyles,\n rowHeaderRenderer,\n data,\n updatedData,\n ],\n );\n\n // Done with hooks!\n /** Guard for unacceptable state combinations:\n * editable = true requires selectionModes to include cells, else the user cannot select a cell to edit.\n * TODO: make this an impossible state to enter.\n */\n if (\n editable &&\n selectionModes &&\n !selectionModes.includes(RegionCardinality.CELLS)\n ) {\n return h(ErrorCallout, {\n title: \"Invalid selection mode\",\n description: \"Editable sheet requires cell selection\",\n });\n }\n\n // TODO: hoist this\n let _selectionModes = selectionModes;\n if (\n editable &&\n _selectionModes != null &&\n !_selectionModes.includes(RegionCardinality.CELLS)\n ) {\n _selectionModes = [..._selectionModes, RegionCardinality.CELLS];\n // Ensure selection mode includes \"cells\"\n }\n\n const cellRendererDependencies = [\n data,\n updatedData,\n focusedCell,\n rowStatus,\n filteredRowIndices,\n ];\n\n // Drive the table from the active provider's `fetchData`. A local (in-memory)\n // provider loads the whole array at once; a remote one uses the `pageSize` /\n // `fetchMode` props and shows load progress.\n let _showLoadProgress: boolean = false;\n let dataLoader: ReactNode = null;\n if (activeProvider != null) {\n _showLoadProgress = !isLocalProvider;\n // A local (in-memory) source loads all its rows in one page; its count\n // rides on the resolved provider (`localCount`), so `_DataSheet` no longer\n // takes a `data` prop — live rows come only from the store.\n dataLoader = h(_DataLoaderManager, {\n key: \"__data_loader\",\n fetchData: activeProvider.fetchData,\n pageSize: isLocalProvider ? Math.max(localCount, 1) : pageSize,\n fetchMode: isLocalProvider ? undefined : fetchMode,\n filterDebounce,\n initialData,\n });\n }\n const showFilterBar =\n (filters != null && filters.length > 0) || hasSortableOrFilterable;\n\n let filterStatus: ReactNode = null;\n if (showFilterBar) {\n filterStatus = h(ActiveFiltersList, { filters: filters ?? [] });\n }\n\n return h(\"div.data-sheet-container\", { className, style }, [\n // The actions/tools toolbar (selection-modal). Table-scoped controls like\n // scroll-to-row / full-text search live here as ordinary actions.\n h(ActionsToolbar, { actions: _actions }),\n dataLoader,\n children,\n h(\n \"div.data-sheet-holder\",\n {\n tabIndex: 0,\n onKeyDown: handleKeyDown,\n onKeyUp: handleKeyUp,\n ref: tableElementRef,\n style: holderStyle,\n },\n h(\n Table as any, // Some sort of hyperscript type error\n {\n ref,\n numRows,\n className: \"data-sheet\",\n enableFocusedCell,\n enableColumnReordering,\n onColumnsReordered,\n focusedCell,\n selectedRegions,\n defaultRowHeight: rowHeight,\n columnWidths,\n onColumnWidthChanged,\n onSelection,\n /** TODO: we could enable this if we had a use-case */\n enableRowReordering: false,\n enableRowResizing: false,\n // The cell renderer is memoized internally based on these data dependencies\n cellRendererDependencies,\n onVisibleCellsChange: _onVisibleCellsChange,\n rowHeaderCellRenderer,\n selectionModes: _selectionModes,\n ...tableProps,\n getCellClipboardData: null,\n },\n realizedColumns,\n ),\n ),\n h(\"div.status-bar\", [\n filterStatus,\n statusBar,\n h(\"div.spacer\"),\n h.if(_showLoadProgress)(LoadProgressIndicator),\n ]),\n h.if(debug)(CellRendererDebugOverlay, {\n cellRendererDependencies,\n names: [\n \"data\",\n \"updatedData\",\n \"focusedCell\",\n \"rowStatus\",\n \"filteredRowIndices\",\n ],\n }),\n ]);\n}\n\nconst EMPTY_MAP = new Map<string, number>();\n\nconst columnWidthsIndexAtom = atom(\n (get) => get(storeAtom)?.columnWidthsIndex ?? EMPTY_MAP,\n);\nconst defaultColumnWidthAtom = atom(\n (get) => get(storeAtom)?.defaultColumnWidth ?? 150,\n);\n\nconst columnWidthsAtom = atom((get) => {\n const ix = get(columnWidthsIndexAtom);\n return get(columnSpecAtom).map(\n (col) => ix.get(col.key) ?? col.width ?? get(defaultColumnWidthAtom),\n );\n});\n\nfunction styleParamsForDensity(density: DataSheetDensity): {\n rowHeight: number;\n style: Record<string, string>;\n} {\n switch (density) {\n case DataSheetDensity.MEDIUM:\n return {\n rowHeight: 24,\n style: {\n \"--data-sheet-row-height\": \"24px\",\n \"--data-sheet-font-size\": \"14px\",\n },\n };\n case DataSheetDensity.LOW:\n return {\n rowHeight: 30,\n style: {\n \"--data-sheet-row-height\": \"30px\",\n \"--data-sheet-font-size\": \"18px\",\n },\n };\n case DataSheetDensity.HIGH:\n default:\n return {\n rowHeight: 20,\n style: {\n \"--data-sheet-row-height\": \"20px\",\n \"--data-sheet-font-size\": \"12px\",\n },\n };\n }\n}\n\n/** Convenience component: runs `useChunkLoader` from inside a `DataSheet`.\n * Render as a child of `DataSheet` (it renders nothing itself). */\nfunction _DataLoaderManager<T = any>({\n fetchData,\n ...rest\n}: {\n fetchData: FetchData<T>;\n} & FetchDataOptions<any>) {\n useDataLoader(fetchData, rest);\n return null;\n}\n"],"names":["_actions","colIndex","style","name"],"mappings":"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"}
package/dist/index.cjs CHANGED
@@ -37,6 +37,7 @@ const columnSpec = require("./provider/column-spec.cjs");
37
37
  const atoms = require("./utils/atoms.cjs");
38
38
  const tableActions = require("./actions/table-actions.cjs");
39
39
  const unifiedFilters = require("./components/indicators/unified-filters.cjs");
40
+ const distinctValues = require("./provider/distinct-values.cjs");
40
41
  exports.DataSheet = dataSheet.DataSheet;
41
42
  exports.DataSheetRenderer = dataSheet.DataSheetRenderer;
42
43
  exports.DataCard = dataPanel.DataCard;
@@ -169,6 +170,7 @@ exports.isColumnFilterable = columnControls.isColumnFilterable;
169
170
  exports.compareRowsBySorts = tableData.compareRowsBySorts;
170
171
  exports.createLocalProvider = tableData.createLocalProvider;
171
172
  exports.dataRefreshTokenAtom = tableData.dataRefreshTokenAtom;
173
+ exports.distinctValuesOf = tableData.distinctValuesOf;
172
174
  exports.persistViaProvider = tableData.persistViaProvider;
173
175
  exports.createZustandStore = zustandStore.createZustandStore;
174
176
  exports.singleFocusedCell = zustandStore.singleFocusedCell;
@@ -185,4 +187,6 @@ exports.passThroughSet = atoms.passThroughSet;
185
187
  exports.splitProps = atoms.splitProps;
186
188
  exports.scrollToRowAction = tableActions.scrollToRowAction;
187
189
  exports.useDataPanelControls = unifiedFilters.useDataPanelControls;
190
+ exports.useDistinctValueList = distinctValues.useDistinctValueList;
191
+ exports.useDistinctValues = distinctValues.useDistinctValues;
188
192
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
1
+ {"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
package/dist/index.js CHANGED
@@ -28,13 +28,14 @@ import { buildDataViewSelection, computeFilteredRowIndices, computeSelectionShap
28
28
  import { buildMultiOperatorColumnFilter, columnFilterId, enhanceColumnFilter } from "./actions/column-filter.js";
29
29
  import { collectValidationErrors, validateCell } from "./utils/validation.js";
30
30
  import { columnControlActions, columnFilterAction, columnSortAction, isColumnFilterable } from "./actions/column-controls.js";
31
- import { compareRowsBySorts, createLocalProvider, dataRefreshTokenAtom, persistViaProvider } from "./provider/table-data.js";
31
+ import { compareRowsBySorts, createLocalProvider, dataRefreshTokenAtom, distinctValuesOf, persistViaProvider } from "./provider/table-data.js";
32
32
  import { createZustandStore, singleFocusedCell, topLeftCell, updateSelection } from "./provider/zustand-store.js";
33
33
  import { editorKeyHandlerAtom, multiLineTextKeyHandler, tableHotkeysAtom } from "./utils/key-handling.js";
34
34
  import { generateColumnSpec, generateDefaultColumnSpec, postprocessColumnSpec } from "./provider/column-spec.js";
35
35
  import { passThroughGet, passThroughSet, splitProps } from "./utils/atoms.js";
36
36
  import { scrollToRowAction } from "./actions/table-actions.js";
37
37
  import { useDataPanelControls } from "./components/indicators/unified-filters.js";
38
+ import { useDistinctValueList, useDistinctValues } from "./provider/distinct-values.js";
38
39
  export {
39
40
  ALL_CARDINALITIES,
40
41
  ActionsToolbar,
@@ -116,6 +117,7 @@ export {
116
117
  dataRefreshTokenAtom,
117
118
  defaultTableActions,
118
119
  deleteRowsAction,
120
+ distinctValuesOf,
119
121
  dragValueHandlerAtom,
120
122
  editorKeyHandlerAtom,
121
123
  enableDragValueAtom,
@@ -172,6 +174,8 @@ export {
172
174
  updateSelection,
173
175
  useDataLoader,
174
176
  useDataPanelControls,
177
+ useDistinctValueList,
178
+ useDistinctValues,
175
179
  useItemCount,
176
180
  useLoadControls,
177
181
  useResolvedProvider,
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
1
+ {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
@@ -84,6 +84,22 @@ function lazyLoadingReducer(state, action) {
84
84
  fetchMode: state.fetchMode,
85
85
  pageSize: state.pageSize
86
86
  };
87
+ case "seed": {
88
+ const rows = action.data ?? [];
89
+ const size = Math.max(action.totalCount ?? rows.length, rows.length);
90
+ const data2 = new Array(size).fill(null);
91
+ for (let i = 0; i < rows.length; i++) data2[i] = rows[i];
92
+ return {
93
+ visibleRegion: defaultVisibleRegion,
94
+ data: data2,
95
+ loading: false,
96
+ error: null,
97
+ initialized: true,
98
+ totalCount: action.totalCount ?? null,
99
+ fetchMode: state.fetchMode,
100
+ pageSize: state.pageSize
101
+ };
102
+ }
87
103
  case "error":
88
104
  return {
89
105
  ...state,
@@ -234,7 +250,15 @@ function useLoadControls() {
234
250
  total: footer.total,
235
251
  paused,
236
252
  canLoadMore,
237
- advance
253
+ advance,
254
+ pageSize,
255
+ page: footer.page,
256
+ totalPages: footer.totalPages
257
+ // Page addressing is exposed so a footer can render a real link to the next
258
+ // page, not just a button that calls `loadMore`. That's the difference
259
+ // between a list a crawler (or a JS-less client) can follow and one it
260
+ // can't — see the note on crawlable pagination in the Data list editors
261
+ // feature doc.
238
262
  };
239
263
  }
240
264
  const viewInfoAtom = jotai.atom((get) => {
@@ -323,7 +347,12 @@ function useScrollHandler() {
323
347
  );
324
348
  }
325
349
  function useDataLoader(fetchChunk, options = {}) {
326
- const { pageSize = 100, fetchMode = "scroll", filterDebounce = 0 } = options;
350
+ const {
351
+ pageSize = 100,
352
+ fetchMode = "scroll",
353
+ filterDebounce = 0,
354
+ initialData
355
+ } = options;
327
356
  const [state, dispatch] = useLazyLoaderReducer();
328
357
  const { isLocalProvider, provider } = core.ctx.useValue(core.dataProviderAtom);
329
358
  const visibleRegion = core.ctx.useValue(visibleRegionAtom);
@@ -356,12 +385,26 @@ function useDataLoader(fetchChunk, options = {}) {
356
385
  [columnSorts, filters]
357
386
  );
358
387
  const debouncedViewKey = useDebouncedValue(viewKey, filterDebounce);
388
+ const seedRef = react.useRef(resolveInitialData(initialData));
389
+ const awaitingSeedRef = react.useRef(seedRef.current != null);
359
390
  react.useEffect(() => {
391
+ const seed = seedRef.current;
392
+ seedRef.current = null;
393
+ if (seed != null) {
394
+ dispatch({ type: "seed", data: seed.rows, totalCount: seed.totalCount });
395
+ setPage(0);
396
+ loadedRef.current = { page: 0, viewKey };
397
+ return;
398
+ }
360
399
  dispatch({ type: "reset" });
361
400
  setPage(0);
362
401
  }, [debouncedViewKey, fetchMode, refreshToken]);
363
402
  uiComponents.useAsyncEffect(async () => {
364
403
  if (state.loading) return;
404
+ if (awaitingSeedRef.current) {
405
+ if (state.initialized) awaitingSeedRef.current = false;
406
+ return;
407
+ }
365
408
  let offset;
366
409
  let cursor = null;
367
410
  if (fetchMode === "paged") {
@@ -428,6 +471,15 @@ function useDataLoader(fetchChunk, options = {}) {
428
471
  }, [state.data, visibleRegion, debouncedViewKey, page, fetchMode]);
429
472
  return { data: state.data, loading: state.loading, error: state.error };
430
473
  }
474
+ function resolveInitialData(initialData) {
475
+ if (initialData == null) return null;
476
+ if (Array.isArray(initialData)) {
477
+ if (initialData.length === 0) return null;
478
+ return { rows: initialData };
479
+ }
480
+ if ((initialData.rows ?? []).length === 0) return null;
481
+ return initialData;
482
+ }
431
483
  function useDebouncedValue(value, delay) {
432
484
  const [debounced, setDebounced] = react.useState(value);
433
485
  react.useEffect(() => {
@@ -484,6 +536,19 @@ function createPostgRESTProvider(config) {
484
536
  return {
485
537
  fetchData: createPostgRESTFetchChunk(config),
486
538
  identity: (row) => row?.[config.identityKey],
539
+ async distinctValues(columnKey, options = {}) {
540
+ let req = from().select(`${columnKey},count()`);
541
+ if (config.baseFilter != null) req = config.baseFilter(req);
542
+ req = req.order(columnKey, { ascending: true, nullsFirst: false });
543
+ if (options.limit != null) req = req.limit(options.limit);
544
+ if (options.signal != null) req = req.abortSignal(options.signal);
545
+ const { data, error } = await req;
546
+ if (error != null) throw error;
547
+ return (data ?? []).map((row) => ({
548
+ value: row[columnKey],
549
+ count: row.count
550
+ }));
551
+ },
487
552
  async saveRows(rows) {
488
553
  const res = await from().upsert(rows, {
489
554
  defaultToNull: false