@macrostrat/data-sheet 4.1.1 → 4.2.1

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 (304) hide show
  1. package/CHANGELOG.md +46 -0
  2. package/dist/actions/builtin.cjs +1 -1
  3. package/dist/actions/builtin.cjs.map +1 -1
  4. package/dist/actions/builtin.d.ts +0 -2
  5. package/dist/actions/builtin.js +1 -1
  6. package/dist/actions/builtin.js.map +1 -1
  7. package/dist/actions/clipboard.cjs +1 -1
  8. package/dist/actions/clipboard.cjs.map +1 -1
  9. package/dist/actions/clipboard.d.ts +3 -2
  10. package/dist/actions/clipboard.js +1 -1
  11. package/dist/actions/clipboard.js.map +1 -1
  12. package/dist/actions/column-controls.cjs +7 -196
  13. package/dist/actions/column-controls.cjs.map +1 -1
  14. package/dist/actions/column-controls.d.ts +1 -1
  15. package/dist/actions/column-controls.js +5 -194
  16. package/dist/actions/column-controls.js.map +1 -1
  17. package/dist/actions/column-filter.cjs +24 -73
  18. package/dist/actions/column-filter.cjs.map +1 -1
  19. package/dist/actions/column-filter.d.ts +6 -4
  20. package/dist/actions/column-filter.js +25 -74
  21. package/dist/actions/column-filter.js.map +1 -1
  22. package/dist/actions/context.cjs +147 -0
  23. package/dist/actions/context.cjs.map +1 -0
  24. package/dist/actions/context.d.ts +93 -0
  25. package/dist/actions/context.js +145 -0
  26. package/dist/actions/context.js.map +1 -0
  27. package/dist/actions/edit-actions.cjs.map +1 -1
  28. package/dist/actions/edit-actions.d.ts +3 -1
  29. package/dist/actions/edit-actions.js.map +1 -1
  30. package/dist/actions/index.d.ts +2 -3
  31. package/dist/actions/selection.cjs +70 -115
  32. package/dist/actions/selection.cjs.map +1 -1
  33. package/dist/actions/selection.d.ts +22 -12
  34. package/dist/actions/selection.js +71 -114
  35. package/dist/actions/selection.js.map +1 -1
  36. package/dist/actions/table-actions.cjs +41 -0
  37. package/dist/actions/table-actions.cjs.map +1 -0
  38. package/dist/actions/{table-controls.d.ts → table-actions.d.ts} +0 -4
  39. package/dist/actions/{table-controls.js → table-actions.js} +2 -23
  40. package/dist/actions/table-actions.js.map +1 -0
  41. package/dist/actions/types.d.ts +11 -89
  42. package/dist/components/cell-detail.cjs +6 -6
  43. package/dist/components/cell-detail.cjs.map +1 -1
  44. package/dist/components/cell-detail.js +1 -1
  45. package/dist/components/colors.cjs.map +1 -1
  46. package/dist/components/colors.js.map +1 -1
  47. package/dist/components/editor-popup.cjs +7 -7
  48. package/dist/components/editor-popup.cjs.map +1 -1
  49. package/dist/components/editor-popup.js +1 -1
  50. package/dist/components/index.d.ts +2 -1
  51. package/dist/components/indicators/filter-and-sort.cjs +378 -0
  52. package/dist/components/indicators/filter-and-sort.cjs.map +1 -0
  53. package/dist/components/indicators/filter-and-sort.d.ts +59 -0
  54. package/dist/components/indicators/filter-and-sort.js +376 -0
  55. package/dist/components/indicators/filter-and-sort.js.map +1 -0
  56. package/dist/components/indicators/filter-and-sort.module.sass.cjs +16 -0
  57. package/dist/components/indicators/filter-and-sort.module.sass.cjs.map +1 -0
  58. package/dist/components/indicators/filter-and-sort.module.sass.js +14 -0
  59. package/dist/components/indicators/filter-and-sort.module.sass.js.map +1 -0
  60. package/dist/components/indicators/index.d.ts +4 -0
  61. package/dist/components/indicators/selection.cjs +113 -0
  62. package/dist/components/indicators/selection.cjs.map +1 -0
  63. package/dist/components/indicators/selection.d.ts +3 -0
  64. package/dist/components/indicators/selection.js +111 -0
  65. package/dist/components/indicators/selection.js.map +1 -0
  66. package/dist/components/indicators/selection.module.sass.cjs +19 -0
  67. package/dist/components/indicators/selection.module.sass.cjs.map +1 -0
  68. package/dist/components/indicators/selection.module.sass.js +17 -0
  69. package/dist/components/indicators/selection.module.sass.js.map +1 -0
  70. package/dist/components/indicators/unified-filters.cjs +130 -0
  71. package/dist/components/indicators/unified-filters.cjs.map +1 -0
  72. package/dist/components/indicators/unified-filters.d.ts +10 -0
  73. package/dist/components/indicators/unified-filters.js +130 -0
  74. package/dist/components/indicators/unified-filters.js.map +1 -0
  75. package/dist/components/indicators/view-info.cjs +59 -0
  76. package/dist/components/indicators/view-info.cjs.map +1 -0
  77. package/dist/components/indicators/view-info.d.ts +11 -0
  78. package/dist/components/{view-info.js → indicators/view-info.js} +20 -16
  79. package/dist/components/indicators/view-info.js.map +1 -0
  80. package/dist/components/text-areas.cjs +5 -5
  81. package/dist/components/text-areas.cjs.map +1 -1
  82. package/dist/components/text-areas.js +1 -1
  83. package/dist/components/toolbars/actions-toolbar.cjs +185 -0
  84. package/dist/components/toolbars/actions-toolbar.cjs.map +1 -0
  85. package/dist/{actions/toolbar.d.ts → components/toolbars/actions-toolbar.d.ts} +9 -5
  86. package/dist/{actions/toolbar.js → components/toolbars/actions-toolbar.js} +37 -112
  87. package/dist/components/toolbars/actions-toolbar.js.map +1 -0
  88. package/dist/components/toolbars/actions-toolbar.module.sass.cjs +29 -0
  89. package/dist/components/toolbars/actions-toolbar.module.sass.cjs.map +1 -0
  90. package/dist/components/toolbars/actions-toolbar.module.sass.js +27 -0
  91. package/dist/components/toolbars/actions-toolbar.module.sass.js.map +1 -0
  92. package/dist/components/toolbars/active-filters.cjs +120 -0
  93. package/dist/components/toolbars/active-filters.cjs.map +1 -0
  94. package/dist/{actions/filters.d.ts → components/toolbars/active-filters.d.ts} +3 -3
  95. package/dist/components/toolbars/active-filters.js +120 -0
  96. package/dist/components/toolbars/active-filters.js.map +1 -0
  97. package/dist/components/toolbars/index.d.ts +2 -0
  98. package/dist/data-panel.cjs +291 -0
  99. package/dist/data-panel.cjs.map +1 -0
  100. package/dist/data-panel.d.ts +110 -0
  101. package/dist/data-panel.js +289 -0
  102. package/dist/data-panel.js.map +1 -0
  103. package/dist/data-panel.module.sass.cjs +40 -0
  104. package/dist/data-panel.module.sass.cjs.map +1 -0
  105. package/dist/data-panel.module.sass.js +38 -0
  106. package/dist/data-panel.module.sass.js.map +1 -0
  107. package/dist/{core.cjs → data-sheet.cjs} +126 -188
  108. package/dist/data-sheet.cjs.map +1 -0
  109. package/dist/data-sheet.css +241 -13
  110. package/dist/data-sheet.d.ts +16 -0
  111. package/dist/{core.js → data-sheet.js} +95 -157
  112. package/dist/data-sheet.js.map +1 -0
  113. package/dist/data-view.cjs +47 -0
  114. package/dist/data-view.cjs.map +1 -0
  115. package/dist/data-view.d.ts +15 -0
  116. package/dist/data-view.js +45 -0
  117. package/dist/data-view.js.map +1 -0
  118. package/dist/filters/operators.cjs +19 -2
  119. package/dist/filters/operators.cjs.map +1 -1
  120. package/dist/filters/operators.d.ts +4 -3
  121. package/dist/filters/operators.js +19 -2
  122. package/dist/filters/operators.js.map +1 -1
  123. package/dist/index.cjs +106 -47
  124. package/dist/index.cjs.map +1 -1
  125. package/dist/index.d.ts +4 -3
  126. package/dist/index.js +76 -17
  127. package/dist/index.js.map +1 -1
  128. package/dist/notifications.cjs +4 -4
  129. package/dist/notifications.cjs.map +1 -1
  130. package/dist/notifications.js +1 -1
  131. package/dist/postgrest-table/data-loaders.cjs +128 -95
  132. package/dist/postgrest-table/data-loaders.cjs.map +1 -1
  133. package/dist/postgrest-table/data-loaders.d.ts +52 -82
  134. package/dist/postgrest-table/data-loaders.js +109 -76
  135. package/dist/postgrest-table/data-loaders.js.map +1 -1
  136. package/dist/postgrest-table/index.cjs +18 -17
  137. package/dist/postgrest-table/index.cjs.map +1 -1
  138. package/dist/postgrest-table/index.d.ts +4 -3
  139. package/dist/postgrest-table/index.js +9 -8
  140. package/dist/postgrest-table/index.js.map +1 -1
  141. package/dist/{utils → provider}/column-spec.cjs +23 -9
  142. package/dist/provider/column-spec.cjs.map +1 -0
  143. package/dist/{utils → provider}/column-spec.d.ts +73 -2
  144. package/dist/{utils → provider}/column-spec.js +24 -10
  145. package/dist/provider/column-spec.js.map +1 -0
  146. package/dist/provider/core.cjs +382 -0
  147. package/dist/provider/core.cjs.map +1 -0
  148. package/dist/provider/core.d.ts +74 -0
  149. package/dist/provider/core.js +380 -0
  150. package/dist/provider/core.js.map +1 -0
  151. package/dist/provider/index.d.ts +7 -0
  152. package/dist/provider/interactions.cjs +128 -0
  153. package/dist/provider/interactions.cjs.map +1 -0
  154. package/dist/provider/interactions.d.ts +39 -0
  155. package/dist/provider/interactions.js +128 -0
  156. package/dist/provider/interactions.js.map +1 -0
  157. package/dist/provider/selection.cjs +29 -0
  158. package/dist/provider/selection.cjs.map +1 -0
  159. package/dist/provider/selection.d.ts +9 -0
  160. package/dist/provider/selection.js +29 -0
  161. package/dist/provider/selection.js.map +1 -0
  162. package/dist/provider/table-data.cjs +92 -0
  163. package/dist/provider/table-data.cjs.map +1 -0
  164. package/dist/provider/table-data.d.ts +81 -0
  165. package/dist/provider/table-data.js +92 -0
  166. package/dist/provider/table-data.js.map +1 -0
  167. package/dist/provider/types.cjs +22 -0
  168. package/dist/provider/types.cjs.map +1 -0
  169. package/dist/provider/types.d.ts +256 -0
  170. package/dist/provider/types.js +22 -0
  171. package/dist/provider/types.js.map +1 -0
  172. package/dist/{zustand-store.cjs → provider/zustand-store.cjs} +36 -23
  173. package/dist/provider/zustand-store.cjs.map +1 -0
  174. package/dist/{zustand-store.js → provider/zustand-store.js} +21 -8
  175. package/dist/provider/zustand-store.js.map +1 -0
  176. package/dist/{cell-renderer.cjs → renderers/cell-renderer.cjs} +67 -34
  177. package/dist/renderers/cell-renderer.cjs.map +1 -0
  178. package/dist/{cell-renderer.d.ts → renderers/cell-renderer.d.ts} +1 -2
  179. package/dist/{cell-renderer.js → renderers/cell-renderer.js} +65 -32
  180. package/dist/renderers/cell-renderer.js.map +1 -0
  181. package/dist/renderers/column-header-cell.cjs +21 -13
  182. package/dist/renderers/column-header-cell.cjs.map +1 -1
  183. package/dist/renderers/column-header-cell.d.ts +3 -2
  184. package/dist/renderers/column-header-cell.js +20 -12
  185. package/dist/renderers/column-header-cell.js.map +1 -1
  186. package/dist/renderers/index.d.ts +1 -0
  187. package/dist/types.cjs +7 -19
  188. package/dist/types.cjs.map +1 -1
  189. package/dist/types.d.ts +117 -229
  190. package/dist/types.js +7 -19
  191. package/dist/types.js.map +1 -1
  192. package/dist/utils/atoms.cjs +24 -0
  193. package/dist/utils/atoms.cjs.map +1 -0
  194. package/dist/utils/atoms.d.ts +4 -0
  195. package/dist/utils/atoms.js +24 -0
  196. package/dist/utils/atoms.js.map +1 -0
  197. package/dist/utils/debug-overlay.cjs.map +1 -1
  198. package/dist/utils/debug-overlay.js.map +1 -1
  199. package/dist/utils/index.d.ts +2 -3
  200. package/dist/utils/key-handling.cjs +140 -139
  201. package/dist/utils/key-handling.cjs.map +1 -1
  202. package/dist/utils/key-handling.d.ts +4 -2
  203. package/dist/utils/key-handling.js +136 -135
  204. package/dist/utils/key-handling.js.map +1 -1
  205. package/dist/utils/validation.cjs +6 -1
  206. package/dist/utils/validation.cjs.map +1 -1
  207. package/dist/utils/validation.d.ts +1 -1
  208. package/dist/utils/validation.js +6 -1
  209. package/dist/utils/validation.js.map +1 -1
  210. package/package.json +4 -3
  211. package/src/actions/builtin.ts +1 -4
  212. package/src/actions/clipboard.ts +4 -3
  213. package/src/actions/column-controls.ts +12 -245
  214. package/src/actions/column-filter.ts +28 -92
  215. package/src/actions/context.ts +299 -0
  216. package/src/actions/edit-actions.ts +3 -1
  217. package/src/actions/index.ts +2 -3
  218. package/src/actions/selection.ts +109 -156
  219. package/src/actions/{table-controls.ts → table-actions.ts} +0 -24
  220. package/src/actions/types.ts +17 -101
  221. package/src/components/colors.ts +1 -1
  222. package/src/components/index.ts +2 -1
  223. package/src/components/indicators/filter-and-sort.module.sass +13 -0
  224. package/src/components/indicators/filter-and-sort.ts +478 -0
  225. package/src/components/indicators/index.ts +4 -0
  226. package/src/components/indicators/selection.module.sass +22 -0
  227. package/src/components/indicators/selection.ts +141 -0
  228. package/src/components/indicators/unified-filters.ts +161 -0
  229. package/src/components/{view-info.ts → indicators/view-info.ts} +19 -30
  230. package/src/{actions/toolbar.module.sass → components/toolbars/actions-toolbar.module.sass} +17 -4
  231. package/src/{actions/toolbar.ts → components/toolbars/actions-toolbar.ts} +49 -150
  232. package/src/components/toolbars/active-filters.ts +150 -0
  233. package/src/components/toolbars/index.ts +2 -0
  234. package/src/data-panel.module.sass +185 -0
  235. package/src/data-panel.ts +556 -0
  236. package/src/{core.ts → data-sheet.ts} +156 -327
  237. package/src/data-view.ts +70 -0
  238. package/src/filters/operators.ts +33 -3
  239. package/src/index.ts +4 -3
  240. package/src/postgrest-table/data-loaders.ts +244 -171
  241. package/src/postgrest-table/index.ts +10 -9
  242. package/src/{utils → provider}/column-spec.ts +30 -15
  243. package/src/provider/core.ts +585 -0
  244. package/src/provider/index.ts +7 -0
  245. package/src/provider/interactions.ts +161 -0
  246. package/src/provider/selection.ts +31 -0
  247. package/src/provider/table-data.ts +178 -0
  248. package/src/provider/types.ts +273 -0
  249. package/src/{zustand-store.ts → provider/zustand-store.ts} +35 -14
  250. package/src/{cell-renderer.ts → renderers/cell-renderer.ts} +140 -57
  251. package/src/renderers/column-header-cell.ts +21 -14
  252. package/src/renderers/index.ts +1 -0
  253. package/src/types.ts +137 -239
  254. package/src/utils/atoms.ts +28 -0
  255. package/src/utils/debug-overlay.ts +1 -1
  256. package/src/utils/index.ts +2 -8
  257. package/src/utils/key-handling.ts +170 -164
  258. package/src/utils/validation.ts +7 -2
  259. package/dist/actions/filters.cjs +0 -139
  260. package/dist/actions/filters.cjs.map +0 -1
  261. package/dist/actions/filters.js +0 -139
  262. package/dist/actions/filters.js.map +0 -1
  263. package/dist/actions/table-controls.cjs +0 -62
  264. package/dist/actions/table-controls.cjs.map +0 -1
  265. package/dist/actions/table-controls.js.map +0 -1
  266. package/dist/actions/toolbar.cjs +0 -260
  267. package/dist/actions/toolbar.cjs.map +0 -1
  268. package/dist/actions/toolbar.js.map +0 -1
  269. package/dist/actions/toolbar.module.sass.cjs +0 -27
  270. package/dist/actions/toolbar.module.sass.cjs.map +0 -1
  271. package/dist/actions/toolbar.module.sass.js +0 -25
  272. package/dist/actions/toolbar.module.sass.js.map +0 -1
  273. package/dist/cell-renderer.cjs.map +0 -1
  274. package/dist/cell-renderer.js.map +0 -1
  275. package/dist/components/view-info.cjs +0 -55
  276. package/dist/components/view-info.cjs.map +0 -1
  277. package/dist/components/view-info.d.ts +0 -5
  278. package/dist/components/view-info.js.map +0 -1
  279. package/dist/core.cjs.map +0 -1
  280. package/dist/core.d.ts +0 -117
  281. package/dist/core.js.map +0 -1
  282. package/dist/provider.cjs +0 -197
  283. package/dist/provider.cjs.map +0 -1
  284. package/dist/provider.d.ts +0 -26
  285. package/dist/provider.js +0 -195
  286. package/dist/provider.js.map +0 -1
  287. package/dist/table-updates/data-parameter.d.ts +0 -14
  288. package/dist/table-updates/filter.d.ts +0 -16
  289. package/dist/table-updates/index.d.ts +0 -19
  290. package/dist/utils/column-spec.cjs.map +0 -1
  291. package/dist/utils/column-spec.js.map +0 -1
  292. package/dist/utils/index.cjs +0 -9
  293. package/dist/utils/index.cjs.map +0 -1
  294. package/dist/utils/index.js +0 -9
  295. package/dist/utils/index.js.map +0 -1
  296. package/dist/zustand-store.cjs.map +0 -1
  297. package/dist/zustand-store.js.map +0 -1
  298. package/src/actions/filters.ts +0 -176
  299. package/src/components/actions.module.sass +0 -8
  300. package/src/provider.ts +0 -267
  301. package/src/table-updates/data-parameter.ts +0 -44
  302. package/src/table-updates/filter.ts +0 -124
  303. package/src/table-updates/index.ts +0 -239
  304. /package/dist/{zustand-store.d.ts → provider/zustand-store.d.ts} +0 -0
package/src/types.ts CHANGED
@@ -1,259 +1,157 @@
1
- import type {
2
- FocusedCellCoordinates,
3
- Region,
4
- RegionCardinality,
5
- Table2,
6
- } from "@blueprintjs/table";
7
- import { ColumnSpec, ColumnSpecOptions } from "./utils";
8
- import { OverlayToaster } from "@blueprintjs/core";
9
- import type { CellEdit } from "./actions";
10
-
11
- /** A single column sort entry for client-side sorting.
12
- * Defined here (rather than in actions/types) to avoid circular imports. */
13
- export interface ColumnSort {
14
- key: string;
15
- ascending: boolean;
1
+ import {
2
+ EditEvent,
3
+ FetchData,
4
+ InteractionOptions,
5
+ RowHeaderRenderContext,
6
+ RowStatusStyles,
7
+ TableDataProvider,
8
+ TableElementStatus,
9
+ VisibleCells,
10
+ } from "./provider";
11
+ import type { ColumnSpec, ColumnSpecOptions } from "./provider";
12
+ import { ReactNode } from "react";
13
+ import { TableAction, TableActionContext, TableFilter } from "./actions";
14
+ import { Region, TableProps } from "@blueprintjs/table";
15
+
16
+ export type FetchMode = "scroll" | "paged";
17
+
18
+ export interface FetchDataOptions {
19
+ pageSize?: number;
20
+ fetchMode?: FetchMode;
16
21
  }
17
22
 
18
- /** Direction of keyboard navigation between cells. */
19
- export type NavDirection = "up" | "down" | "left" | "right";
20
-
21
- /**
22
- * A structured, revertible description of a user edit. Emitted via the
23
- * `onEdit` hook so a consumer can capture edits as operations (and, with the
24
- * controlled-overlay API, own the edited state) instead of diffing
25
- * `updatedData`. This is the write half of the data-sheet's read/write
26
- * contract — the mirror of how data flows in.
27
- */
28
- export type EditEvent<T = any> =
29
- | { type: "setCells"; cells: CellEdit[] }
30
- | { type: "deleteRows"; rowIndices: number[] }
31
- | { type: "restoreRows"; rowIndices: number[] }
32
- | { type: "addRow"; rowIndex: number; value: Partial<T> }
33
- | { type: "resetChanges" };
34
-
35
- export interface DataSheetCoreProps<T> {
36
- data: T[];
23
+ /** Props shared between the wrapper components and the provider */
24
+ export interface DataViewCoreProps<T> extends InteractionOptions {
25
+ /** In-memory rows. Internally wrapped in a local `TableDataProvider` and
26
+ * driven through the same loader as any other source. */
27
+ data?: T[];
37
28
  /** Column definitions. Either a static array, or a function derived from the
38
29
  * loaded rows — invoked once the first rows arrive (and re-invoked when the
39
30
  * function's identity changes), so a data-shaped spec needs no separate fetch
40
31
  * of sample data. Omit entirely to auto-generate a plain spec via
41
32
  * `columnSpecOptions`. */
42
33
  columnSpec?: ColumnSpec[] | ((rows: T[]) => ColumnSpec[]);
43
- editable?: boolean;
34
+ columnSpecOptions?: ColumnSpecOptions<T>;
44
35
  enableColumnReordering?: boolean;
45
36
  defaultColumnWidth?: number;
37
+ // function to fetch a chunk of data (the read side of a data provider)
38
+ fetchData?: FetchData<T>;
39
+ /** A data provider instantiated separately and passed in — bundles the read
40
+ * side (`fetchData` + `identity`) and, optionally, the persistence side
41
+ * (`saveRows` / `deleteRows` / `insertRow`) that drives the Save action. An
42
+ * explicit alternative to the loose `data` / `fetchData` / `identity` props;
43
+ * takes precedence when given. */
44
+ provider?: TableDataProvider<T>;
45
+ /** Row identity for the edit overlay — stable across a provider re-sort (a
46
+ * data provider supplies its own; defaults to `(row) => row?.id`). Lets edits
47
+ * survive a re-ordered re-fetch. */
48
+ identity?: (row: T) => string | number | null | undefined;
49
+ /** Shown as the toolbar's leading label when nothing is selected. */
50
+ name?: string;
51
+ // itemLabel (e.g., "row", "item")
52
+ itemLabel?: string;
53
+ /** Bump to force a re-fetch from scratch (e.g. after an immediate edit that
54
+ * mutated rows through the provider). */
55
+ refreshToken?: number | string;
46
56
  }
47
57
 
48
- export enum TableElementStatus {
49
- DELETED = "deleted",
50
- ADDED = "added",
51
- }
52
-
53
- /** A row's status value. The built-in `TableElementStatus` members
54
- * (`"deleted"` / `"added"`) plus any consumer-defined status string (e.g.
55
- * `"omitted"`). The `(string & {})` keeps autocomplete for the enum members
56
- * while still accepting arbitrary strings. */
57
- export type RowStatusValue = TableElementStatus | (string & {});
58
-
59
- /** Presentation for a row status: applied to the row's cells and its header
60
- * cell. Keyed by status value in `rowStatusStyles`. The library ships a
61
- * default for `"deleted"` (dimmed + struck through, danger intent); consumers
62
- * merge in styles for their own statuses (and may override the defaults). */
63
- export interface RowStatusStyle {
64
- /** Style merged onto each cell in a row with this status. */
65
- cellStyle?: import("react").CSSProperties;
66
- /** Style applied to the row's header cell. */
67
- headerStyle?: import("react").CSSProperties;
68
- /** Blueprint intent applied to the row's cells (precedence: validation >
69
- * this > edited-green). */
70
- intent?: import("@blueprintjs/core").Intent;
71
- }
72
-
73
- export type RowStatusStyles = Record<string, RowStatusStyle>;
74
-
75
- /** Built-in row-status presentation. Consumers' `rowStatusStyles` are merged
76
- * over this, so `"deleted"` keeps its look unless explicitly overridden. */
77
- export const DEFAULT_ROW_STATUS_STYLES: RowStatusStyles = {
78
- [TableElementStatus.DELETED]: {
79
- cellStyle: { opacity: 0.5, textDecoration: "line-through" },
80
- headerStyle: { opacity: 0.5, textDecoration: "line-through" },
81
- intent: "danger",
82
- },
83
- };
84
-
85
- /** Context passed to a custom `rowHeaderRenderer`, so it can label and style
86
- * the row header from the row's data and status (group-key labels, an
87
- * omit indicator, etc.). Return a node to use as the header's name, or a
88
- * nullish value to fall back to the default (1-based row number). */
89
- export interface RowHeaderRenderContext<T = any> {
90
- /** Data-row index (stable under sort/filter). */
91
- rowIndex: number;
92
- /** Visible (display) row index. */
93
- visibleIndex: number;
94
- /** The row's data (base, overlaid with edits if present). */
95
- row: T | undefined;
96
- /** The row's status, if any. */
97
- status: RowStatusValue | undefined;
98
- /** Convenience: `status === TableElementStatus.DELETED`. */
99
- isDeleted: boolean;
100
- /** The default label (`"${rowIndex + 1}"`). */
101
- defaultLabel: string;
58
+ export interface DataViewSharedProps<T = any>
59
+ extends FetchDataOptions, DataViewCoreProps<T> {
60
+ /** Configurable table actions shown in a selection-aware toolbar.
61
+ * When provided, the actions toolbar renders alongside the existing
62
+ * edit toolbar. Actions are filtered by the current selection cardinality. */
63
+ actions?: TableAction<T>[];
64
+ /** Available column/table filters shown in a filter bar.
65
+ * Filters can also be defined per-column via `ColumnSpec.filters`. */
66
+ filters?: TableFilter<T>[];
67
+ //enableSelection?: boolean;
102
68
  }
103
69
 
104
- /** Property key holding a stable synthetic id on rows added in-table. Added
105
- * rows aren't in the data provider, so they need their own identity to survive
106
- * a provider re-fetch; it's carried on the row and preserved through edits. */
107
- export const DS_ROW_ID = "__dsRowId";
108
-
109
- /** Proxy stored during a copy operation, enabling backend-mediated paste
110
- * for lazy-loaded tables where not all data is available locally. */
111
- export interface ClipboardProxy {
112
- cardinality: RegionCardinality;
113
- /** Source row indices (for row/cell copies) */
114
- rowIndices?: number[];
115
- /** Source column keys (for column/cell copies) */
116
- columnKeys?: string[];
117
- /** The plain text written to the clipboard, used to verify the proxy
118
- * is still valid on paste (i.e., clipboard hasn't been overwritten). */
119
- text: string;
70
+ export enum DataSheetDensity {
71
+ HIGH = "high",
72
+ MEDIUM = "medium",
73
+ LOW = "low",
120
74
  }
121
75
 
122
- export interface DataSheetState<T> {
123
- selection: Region[];
124
- columnSpec: ColumnSpec[];
125
- /** When `true`, the loader's first-chunk auto-generation of `columnSpec` is
126
- * suppressed — a function `columnSpec` derives it from the loaded rows
127
- * instead (in `_DataSheet`). Set at init from the prop's shape. */
128
- deferColumnSpec: boolean;
129
- fillValueBaseCell: FocusedCellCoordinates | null;
130
- focusedCell: FocusedCellCoordinates | null;
131
- topLeftCell: FocusedCellCoordinates | null;
132
- /**
133
- * Set of row indices that have been added to the table,
134
- * but not yet committed to the underlying data array.
135
- *
136
- * This is used to track which rows should be reverted when
137
- * a "reset" action is performed.
138
- */
139
- rowStatus: RowStatusValue[];
140
- /** Presentation per row-status value (merged: defaults + the
141
- * `rowStatusStyles` prop). Read by the cell renderer and row-header renderer
142
- * to style rows by status. */
143
- rowStatusStyles: RowStatusStyles;
144
- // Sparse data structure for updated data
145
- updatedData: T[];
146
- initialized: boolean;
147
- columnWidthsIndex: Map<string, number>;
148
- /** Active column/table filters. Keys are filter IDs, values carry the
149
- * filter definition and its current configuration state. */
150
- activeFilters: Map<string, { filter: any; state: any }>;
151
- /** Clipboard proxy from the last copy operation */
152
- clipboardProxy: ClipboardProxy | null;
153
- /** Visible row indices when filters are active. `null` means show all rows. */
154
- filteredRowIndices: number[] | null;
155
- /** Active column sort entries for client-side sorting. */
156
- columnSorts: ColumnSort[];
157
- /** Whether selecting a cell automatically activates its surface (opens an
158
- * editor/detail panel and, for editors, focuses it). `"manual"` opens only
159
- * on click. */
160
- cellInteraction: "auto" | "manual";
161
- /** Runtime override of `cellInteraction`: while `false`, auto-activation is
162
- * suppressed (set by pressing Escape, re-armed by clicking a cell) so the
163
- * keyboard prioritizes navigation. */
164
- autoActivateArmed: boolean;
165
- /** Direction of the last keyboard navigation, used to place an editor's
166
- * cursor on the side the user is travelling toward. `null` after a click. */
167
- lastNavDirection: NavDirection | null;
168
- /** The table's focusable holder element; editors return focus here when the
169
- * cursor leaves them so arrow-key navigation resumes. */
170
- tableElement: HTMLElement | null;
171
- /** Whether the focused cell's surface (editor or detail panel) is open.
172
- * Owned by the store — not per-popover — so navigation, clicks, and the
173
- * Escape handler all agree on it. */
174
- cellSurfaceOpen: boolean;
175
- /** Optional observer called for every user edit as a structured
176
- * `EditEvent`, in addition to the built-in `updatedData` overlay. Lets a
177
- * consumer capture edits as revertible operations. */
76
+ /**
77
+ * How selecting a cell activates its surface (an editor, or a read-only detail
78
+ * panel):
79
+ * - `"auto"` (default when `autoFocusEditor` is `true`): open the surface on
80
+ * selection and, for editors, focus it. Editors relinquish focus at their
81
+ * edges — arrow past the start/end of a text cell, or press Escape, and focus
82
+ * returns to the table — so the keyboard stays operable without the mouse.
83
+ * Pressing Escape drops into navigation mode (surfaces stop auto-opening)
84
+ * until the next click.
85
+ * - `"manual"` (default when `autoFocusEditor` is `false`): the surface stays
86
+ * closed until the cell is clicked; arrow keys always navigate the table.
87
+ */
88
+ export type CellInteraction = "auto" | "manual";
89
+
90
+ export interface DataSheetRendererProps<T = any>
91
+ extends TableProps, DataViewSharedProps<T> {
92
+ onVisibleCellsChange?: (visibleCells: VisibleCells) => void;
93
+ onUpdateData?: (updatedData: any[], data: T[]) => void;
94
+ /** Observer called for every user edit as a structured `EditEvent`
95
+ * (Workstream A). Additive: the built-in `updatedData` overlay still
96
+ * applies. */
178
97
  onEdit?: (event: EditEvent<T>) => void;
179
- /** Row identity for the edit overlay — stable across a provider re-sort,
180
- * unlike an array index. Defaults to `(row) => row?.id`; a data provider
181
- * supplies its own (e.g. a PostgREST identity key). Used to re-attach edits
182
- * when the loader replaces `data` with a re-ordered window. */
183
- identity: (row: any) => string | number | null | undefined;
184
- /** Edits/statuses held by identity for rows not currently loaded (server
185
- * sources), re-attached when their row next arrives. */
186
- pendingOverlayById: Map<
187
- string | number,
188
- { edit?: any; status?: TableElementStatus }
189
- >;
190
- /** True when the consumer controls the `updatedData`/`rowStatus` overlay; the
191
- * loader-boundary identity remap is skipped (the consumer owns it). */
192
- controlledOverlay: boolean;
193
- /** Whether row deletion is available. Set from the data provider: an explicit
194
- * `provider` without `deleteRows` disables deletion entirely (the delete
195
- * affordance greys out and the delete key is a no-op). Defaults to `true`. */
196
- canDeleteRows: boolean;
197
- }
198
-
199
- type DataSheetVals<T> = DataSheetState<T> & DataSheetCoreProps<T>;
200
- export type StateUpdater<T> = T[] | ((state: T[]) => T[]);
201
-
202
- export interface DataSheetStoreMain<T> extends DataSheetVals<T> {
203
- setSelection(selection: Region[]): void;
204
- onDragValue(event: MouseEvent): void;
205
- setUpdatedData(data: StateUpdater<T>): void;
206
- onCellEdited(rowIndex: number, columnName: string, value: any): void;
207
- onSelectionEdited(value: any): void;
208
- onColumnsReordered(oldIndex: number, newIndex: number, length: number): void;
209
- onColumnWidthChanged(columnIndex: number, newWidth: number): void;
210
- moveFocusedCell(direction: NavDirection): void;
211
- /** Suppress auto-activation until the next click (Escape enters nav mode). */
212
- suppressAutoActivate(): void;
213
- /** Re-arm auto-activation (a click re-enables auto-focus). */
214
- armAutoActivate(): void;
215
- /** Open the focused cell's surface (editor or detail panel). */
216
- openCellSurface(): void;
217
- /** Close the focused cell's surface. When `suppress` is true (the default,
218
- * as for Escape), auto mode also enters navigation mode (auto-activation is
219
- * suppressed until the next click). A click-dismiss passes `suppress: false`
220
- * so it just closes without changing the global mode. */
221
- closeCellSurface(opts?: { suppress?: boolean }): void;
222
- deleteSelectedRows(): void;
223
- clearSelection(): void;
224
- resetChanges(): void;
225
- addRow(): void;
226
- /** Activate or update a column/table filter.
227
- * Filter is any object satisfying `TableFilter` from the actions module. */
228
- setFilter(filterId: string, filter: any, filterState: any): void;
229
- /** Remove a filter by ID */
230
- removeFilter(filterId: string): void;
231
- /** Remove all active filters */
232
- clearFilters(): void;
233
- /** Set or clear a column sort. Pass `null` for ascending to clear. */
234
- setColumnSort(key: string, ascending: boolean | null): void;
235
- /** Remove all active column sorts */
236
- clearColumnSorts(): void;
237
- /** Store a clipboard proxy for potential backend-mediated paste */
238
- setClipboardProxy(proxy: ClipboardProxy | null): void;
239
- initialize(props: Partial<DataSheetStoreMain<T>>): void;
240
- onSelection(selection: Region[]): void;
241
- // Internal method used for infinite scrolling
242
- scrollToRow(rowIndex: number): void;
243
- tableRef: React.MutableRefObject<Table2>;
244
- columnWidthsIndex: Map<string, number>;
98
+ /** Controlled edited-cell overlay (Workstream A). When provided, it is
99
+ * synced into the store as the source of truth for edited values — pair with
100
+ * `onEdit` to own edit state externally (e.g. an ops model). Optimistic
101
+ * in-table edits are superseded by the next value you pass back. */
102
+ updatedData?: T[];
103
+ /** Controlled row-status overlay (edited / added / deleted), the companion
104
+ * to `updatedData`. */
105
+ rowStatus?: TableElementStatus[];
106
+
107
+ /** Derive the controlled edit overlay from the loaded rows, *inside* the
108
+ * sheet. For provider-backed tables whose overlay is a function of the loaded
109
+ * data plus external edit state (e.g. an ops stack): the library owns the
110
+ * rows, so it calls this with them and uses the result as the controlled
111
+ * overlay, re-deriving when the rows — or this function's identity (close it
112
+ * over your edit state) — change. Supersedes `updatedData`/`rowStatus`. */
113
+ deriveOverlay?: (rows: T[]) => {
114
+ updatedData: T[];
115
+ rowStatus: TableElementStatus[];
116
+ };
117
+ /** Persistence handler for the built-in Save action. When provided, a Save
118
+ * control is added to the toolbar (always visible, disabled when there are
119
+ * no pending changes). */
120
+ onSave?: (ctx: TableActionContext<T>) => void | Promise<void>;
121
+ onDeleteRows?: (selection: Region[]) => void;
122
+ verbose?: boolean;
123
+ enableColumnReordering?: boolean;
124
+ enableClipboard?: boolean;
125
+ enableFocusedCell?: boolean;
126
+ /** @deprecated Prefer `cellInteraction`. `true` maps to `"auto"`,
127
+ * `false` to `"manual"`. */
128
+ autoFocusEditor?: boolean;
129
+ /** How selecting a cell activates its surface (editor or detail panel).
130
+ * Defaults from `autoFocusEditor` for backward compatibility. */
131
+ cellInteraction?: CellInteraction;
132
+ density?: DataSheetDensity;
133
+ /** Optional custom column header cell renderer, called for each column.
134
+ * Receives the ColumnSpec and column index; should return a React element
135
+ * (typically a Blueprint ColumnHeaderCell). */
136
+ columnHeaderCellRenderer?: (col: any, colIndex: number) => ReactNode;
137
+ /** Arbitrary nodes for the bottom status bar (left group), rendered beside
138
+ * the active sort/filter tags — the home for view-state controls (show/hide
139
+ * omitted rows/columns, a group-by indicator, etc.). */
140
+ statusBar?: ReactNode;
141
+ /** Presentation per row-status value, merged over the built-in defaults
142
+ * (which style `"deleted"`). Supply styles for consumer-defined statuses
143
+ * (e.g. `"omitted"`) and/or override the defaults. Each entry may set the
144
+ * cells' style/intent and the row header's style. */
145
+ rowStatusStyles?: RowStatusStyles;
146
+ /** Render the content of a row's header cell (the left gutter). Receives the
147
+ * row, its status, and the default 1-based label; return a node to use, or a
148
+ * nullish value to keep the default. For group-key labels, omit indicators,
149
+ * etc. Header-cell *styling* still comes from `rowStatusStyles`. */
150
+ rowHeaderRenderer?: (ctx: RowHeaderRenderContext<T>) => ReactNode;
151
+ minRowHeight: number;
245
152
  defaultColumnWidth: number;
153
+ debug: boolean;
246
154
  }
247
155
 
248
- export type DataSheetProviderProps<T> = DataSheetCoreProps<T> & {
249
- children: React.ReactNode;
250
- columnSpecOptions?: ColumnSpecOptions<T>;
251
- toaster?: OverlayToaster;
252
- };
253
-
254
- export interface VisibleCells {
255
- rowIndexStart: number;
256
- rowIndexEnd: number;
257
- }
258
-
259
- export type DataSheetStore<T> = DataSheetStoreMain<T>;
156
+ export type DataSheetProps<T> = DataViewCoreProps<T> &
157
+ DataSheetRendererProps<T>;
@@ -0,0 +1,28 @@
1
+ import type { Getter, Setter, Atom, WritableAtom } from "jotai";
2
+
3
+ export function passThroughSet<V, Args extends unknown[], Result>(
4
+ atom: WritableAtom<V, Args, Result>,
5
+ ) {
6
+ return (get: Getter, set: Setter, ...args: Args): Result =>
7
+ set(atom, ...args);
8
+ }
9
+
10
+ export function passThroughGet<T>(atom: Atom<T>) {
11
+ return (get: Getter) => get(atom);
12
+ }
13
+
14
+ export function splitProps<T, R extends Partial<T>>(
15
+ input: T,
16
+ keys: Set<keyof R>,
17
+ ): [R, Omit<T, keyof R>] {
18
+ const requestedProps: Partial<T> = {};
19
+ const otherProps: Partial<T> = {};
20
+ for (const key in input) {
21
+ if (keys.has(key as keyof R)) {
22
+ requestedProps[key] = input[key];
23
+ } else {
24
+ otherProps[key] = input[key];
25
+ }
26
+ }
27
+ return [requestedProps as R, otherProps as Omit<T, keyof R>];
28
+ }
@@ -4,7 +4,7 @@ export function CellRendererDebugOverlay({ cellRendererDependencies, names }) {
4
4
  /** Debug overlay for cell renderer dependencies */
5
5
  const lastRenderDependencies = useRef<any[]>(cellRendererDependencies);
6
6
  useEffect(() => {
7
- let changeDepNames = [];
7
+ let changeDepNames: any[] = [];
8
8
  for (const [i, dep] of cellRendererDependencies.entries()) {
9
9
  if (dep !== lastRenderDependencies.current[i]) {
10
10
  changeDepNames.push(names[i]);
@@ -1,10 +1,4 @@
1
- export * from "./column-spec";
2
1
  export * from "./key-handling";
3
2
  export * from "./validation";
4
- export { CellRendererDebugOverlay } from "./debug-overlay.ts";
5
-
6
- export function range(arr: number[]) {
7
- if (arr.length != 2) throw new Error("Range must have two elements");
8
- const [start, end] = arr;
9
- return Array.from({ length: end - start + 1 }, (_, i) => i + start);
10
- }
3
+ export * from "./debug-overlay.ts";
4
+ export * from "./atoms.ts";