@macrostrat/data-sheet 4.1.0 → 4.2.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 (302) hide show
  1. package/CHANGELOG.md +40 -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 -184
  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 -182
  16. package/dist/actions/column-controls.js.map +1 -1
  17. package/dist/actions/column-filter.cjs +24 -50
  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 -51
  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-controls.cjs → table-actions.cjs} +7 -24
  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 -19
  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/{view-info.d.ts → indicators/view-info.d.ts} +1 -0
  78. package/dist/components/{view-info.js → indicators/view-info.js} +17 -13
  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} +36 -97
  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} +123 -181
  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} +92 -150
  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 +21 -4
  119. package/dist/filters/operators.cjs.map +1 -1
  120. package/dist/filters/operators.d.ts +5 -4
  121. package/dist/filters/operators.js +21 -4
  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 +129 -103
  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 +110 -84
  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 +77 -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} +37 -23
  173. package/dist/provider/zustand-store.cjs.map +1 -0
  174. package/dist/{zustand-store.js → provider/zustand-store.js} +22 -8
  175. package/dist/provider/zustand-store.js.map +1 -0
  176. package/dist/{cell-renderer.cjs → renderers/cell-renderer.cjs} +68 -35
  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} +66 -33
  180. package/dist/renderers/cell-renderer.js.map +1 -0
  181. package/dist/renderers/column-header-cell.cjs +40 -17
  182. package/dist/renderers/column-header-cell.cjs.map +1 -1
  183. package/dist/renderers/column-header-cell.d.ts +2 -2
  184. package/dist/renderers/column-header-cell.js +40 -17
  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 +123 -226
  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 -228
  214. package/src/actions/column-filter.ts +28 -63
  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 -20
  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} +16 -27
  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} +53 -126
  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} +144 -306
  237. package/src/data-view.ts +70 -0
  238. package/src/filters/operators.ts +38 -6
  239. package/src/index.ts +4 -3
  240. package/src/postgrest-table/data-loaders.ts +250 -181
  241. package/src/postgrest-table/index.ts +10 -9
  242. package/src/{utils → provider}/column-spec.ts +34 -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} +36 -14
  250. package/src/{cell-renderer.ts → renderers/cell-renderer.ts} +146 -58
  251. package/src/renderers/column-header-cell.ts +51 -17
  252. package/src/renderers/index.ts +1 -0
  253. package/src/types.ts +143 -236
  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.map +0 -1
  264. package/dist/actions/table-controls.js.map +0 -1
  265. package/dist/actions/toolbar.cjs +0 -246
  266. package/dist/actions/toolbar.cjs.map +0 -1
  267. package/dist/actions/toolbar.js.map +0 -1
  268. package/dist/actions/toolbar.module.sass.cjs +0 -27
  269. package/dist/actions/toolbar.module.sass.cjs.map +0 -1
  270. package/dist/actions/toolbar.module.sass.js +0 -25
  271. package/dist/actions/toolbar.module.sass.js.map +0 -1
  272. package/dist/cell-renderer.cjs.map +0 -1
  273. package/dist/cell-renderer.js.map +0 -1
  274. package/dist/components/view-info.cjs +0 -55
  275. package/dist/components/view-info.cjs.map +0 -1
  276. package/dist/components/view-info.js.map +0 -1
  277. package/dist/core.cjs.map +0 -1
  278. package/dist/core.d.ts +0 -113
  279. package/dist/core.js.map +0 -1
  280. package/dist/provider.cjs +0 -191
  281. package/dist/provider.cjs.map +0 -1
  282. package/dist/provider.d.ts +0 -25
  283. package/dist/provider.js +0 -189
  284. package/dist/provider.js.map +0 -1
  285. package/dist/table-updates/data-parameter.d.ts +0 -14
  286. package/dist/table-updates/filter.d.ts +0 -16
  287. package/dist/table-updates/index.d.ts +0 -19
  288. package/dist/utils/column-spec.cjs.map +0 -1
  289. package/dist/utils/column-spec.js.map +0 -1
  290. package/dist/utils/index.cjs +0 -9
  291. package/dist/utils/index.cjs.map +0 -1
  292. package/dist/utils/index.js +0 -9
  293. package/dist/utils/index.js.map +0 -1
  294. package/dist/zustand-store.cjs.map +0 -1
  295. package/dist/zustand-store.js.map +0 -1
  296. package/src/actions/filters.ts +0 -176
  297. package/src/components/actions.module.sass +0 -8
  298. package/src/provider.ts +0 -250
  299. package/src/table-updates/data-parameter.ts +0 -44
  300. package/src/table-updates/filter.ts +0 -124
  301. package/src/table-updates/index.ts +0 -239
  302. /package/dist/{zustand-store.d.ts → provider/zustand-store.d.ts} +0 -0
@@ -0,0 +1,380 @@
1
+ import { useRef, useMemo, useEffect, useState } from "react";
2
+ import h from "@macrostrat/hyper";
3
+ import { useStore, createStore } from "zustand";
4
+ import { generateColumnSpec, postprocessColumnSpec } from "./column-spec.js";
5
+ import { createScopedStore } from "@macrostrat/data-components";
6
+ import { TableElementStatus, DS_ROW_ID } from "./types.js";
7
+ import { createZustandStore } from "./zustand-store.js";
8
+ import { atomWithStore } from "jotai-zustand";
9
+ import { toasterAtom } from "../notifications.js";
10
+ import { atom } from "jotai";
11
+ import { dataRefreshTokenAtom, createLocalProvider } from "./table-data.js";
12
+ import { ToasterContext, ErrorBoundary } from "@macrostrat/ui-components";
13
+ import { resolveInteractionOptions, DataViewRendererType, interactionOptionsAtom, interactionOptionsKeys } from "./interactions.js";
14
+ import { splitProps } from "../utils/atoms.js";
15
+ const ctx = createScopedStore();
16
+ const storeAPIAtom = atom();
17
+ const storeWrapperAtom = atom((get) => {
18
+ const _storeAPIAtom = get(storeAPIAtom);
19
+ if (_storeAPIAtom == null) {
20
+ return void 0;
21
+ }
22
+ return atomWithStore(_storeAPIAtom);
23
+ });
24
+ const storeAtom = atom(
25
+ (get) => {
26
+ const storeWrapper = get(storeWrapperAtom);
27
+ if (storeWrapper == null) {
28
+ return void 0;
29
+ }
30
+ return get(storeWrapper);
31
+ },
32
+ (get, set, action) => {
33
+ const storeWrapper = get(storeWrapperAtom);
34
+ if (storeWrapper == null) {
35
+ throw new Error("Missing DataSheetProvider");
36
+ }
37
+ return set(storeWrapper, action);
38
+ }
39
+ );
40
+ const EMPTY_SPEC = [];
41
+ const initializeStoreAtom = atom(
42
+ null,
43
+ (get, set, payload) => {
44
+ set(storeAtom, (state) => {
45
+ return {
46
+ ...state,
47
+ ...payload
48
+ };
49
+ });
50
+ }
51
+ );
52
+ const tableActionsAtom = atom([]);
53
+ const DEFAULT_DATA_PROVIDER = {
54
+ provider: null,
55
+ isLocalProvider: true,
56
+ isExplicitProvider: false,
57
+ localCount: 0
58
+ };
59
+ const dataProviderAtom = atom(
60
+ DEFAULT_DATA_PROVIDER
61
+ );
62
+ const EMPTY_ARRAY = [];
63
+ function useResolvedProvider(props) {
64
+ const _data = props.data ?? EMPTY_ARRAY;
65
+ const isLocalProvider = props.provider == null && props.fetchData == null;
66
+ const isExplicitProvider = props.provider != null;
67
+ const activeProvider = useMemo(() => {
68
+ if (props.provider != null) return props.provider;
69
+ if (props.fetchData != null) {
70
+ return {
71
+ fetchData: props.fetchData,
72
+ identity: props.identity ?? ((r) => r?.id)
73
+ };
74
+ }
75
+ if (_data.length > 0) {
76
+ return createLocalProvider(
77
+ _data,
78
+ props.identity != null ? { identity: props.identity } : void 0
79
+ );
80
+ }
81
+ return null;
82
+ }, [props.provider, props.fetchData, _data, props.identity]);
83
+ const localCount = isLocalProvider ? _data.length : 0;
84
+ const dataProvider = useMemo(
85
+ () => ({
86
+ provider: activeProvider,
87
+ isLocalProvider,
88
+ isExplicitProvider,
89
+ localCount
90
+ }),
91
+ [activeProvider, isLocalProvider, isExplicitProvider, localCount]
92
+ );
93
+ return { data: _data, isLocalProvider, activeProvider, dataProvider };
94
+ }
95
+ function DataSheetStoreWrapper(props) {
96
+ const { toaster, ...rest } = props;
97
+ const [store] = useState(() => {
98
+ return createStore(createZustandStore);
99
+ });
100
+ return h(
101
+ ctx.Provider,
102
+ {
103
+ atoms: [
104
+ [storeAPIAtom, store],
105
+ [toasterAtom, toaster]
106
+ ]
107
+ },
108
+ h(DataSheetProviderInner, rest)
109
+ );
110
+ }
111
+ const tableDataProviderKeys = /* @__PURE__ */ new Set([
112
+ "provider",
113
+ "fetchData",
114
+ "data",
115
+ "identity"
116
+ ]);
117
+ const dataProviderKeys = /* @__PURE__ */ new Set([
118
+ "columnSpec",
119
+ "columnSpecOptions",
120
+ "name",
121
+ "itemLabel",
122
+ "enableColumnReordering",
123
+ "defaultColumnWidth",
124
+ "refreshToken",
125
+ "identity",
126
+ "toaster",
127
+ "viewType",
128
+ "interactionOptions"
129
+ ]);
130
+ function splitDataProviderProps(props) {
131
+ return splitProps(
132
+ props,
133
+ dataProviderKeys.union(interactionOptionsKeys).union(tableDataProviderKeys)
134
+ );
135
+ }
136
+ function DataSheetProvider(props) {
137
+ return h(
138
+ ToasterContext,
139
+ h(ErrorBoundary, h(DataSheetStoreWrapper, props))
140
+ );
141
+ }
142
+ function DataSheetProviderInner(props) {
143
+ const tableRef = useRef(null);
144
+ const [interactionOptionsProps, providerProps] = splitProps(props, interactionOptionsKeys);
145
+ const interactionOptions = resolveInteractionOptions(
146
+ interactionOptionsProps,
147
+ props.viewType ?? DataViewRendererType.TABLE
148
+ );
149
+ const {
150
+ children,
151
+ columnSpec,
152
+ columnSpecOptions,
153
+ name,
154
+ itemLabel,
155
+ enableColumnReordering,
156
+ defaultColumnWidth = 150,
157
+ refreshToken,
158
+ identity
159
+ } = providerProps;
160
+ const { data, dataProvider } = useResolvedProvider(providerProps);
161
+ const initializeStore = ctx.useSet(initializeStoreAtom);
162
+ const storeAPI = useStoreAPI();
163
+ ctx.useSync(dataProviderAtom, dataProvider ?? DEFAULT_DATA_PROVIDER);
164
+ ctx.useSync(interactionOptionsAtom, interactionOptions);
165
+ const contentLabels = useMemo(() => {
166
+ return { tableName: name, itemLabel };
167
+ }, [name, itemLabel]);
168
+ ctx.useSync(contentLabelsAtom, contentLabels);
169
+ const isFnSpec = typeof columnSpec === "function";
170
+ const staticSpec = isFnSpec ? EMPTY_SPEC : columnSpec;
171
+ const baseSpec = staticSpec ?? generateColumnSpec(data, columnSpecOptions);
172
+ useEffect(() => {
173
+ initializeStore({
174
+ columnSpec: postprocessColumnSpec(baseSpec),
175
+ // A function spec is derived from the loaded rows in `_DataSheet`; tell
176
+ // the loader not to auto-generate a plain spec from the first chunk.
177
+ deferColumnSpec: isFnSpec,
178
+ editable: interactionOptions.enableEditing,
179
+ enableColumnReordering,
180
+ data,
181
+ defaultColumnWidth,
182
+ tableRef
183
+ });
184
+ }, [
185
+ data,
186
+ interactionOptions.enableEditing,
187
+ staticSpec,
188
+ isFnSpec,
189
+ columnSpecOptions,
190
+ enableColumnReordering
191
+ ]);
192
+ const loadedData = useSelector((s) => s.data ?? []);
193
+ const derivedSpecFor = useRef(null);
194
+ useEffect(() => {
195
+ if (typeof columnSpec !== "function") return;
196
+ if (derivedSpecFor.current === columnSpec) return;
197
+ const rows = loadedData.filter((r) => r != null);
198
+ if (rows.length === 0) return;
199
+ derivedSpecFor.current = columnSpec;
200
+ storeAPI.setState({ columnSpec: columnSpec(rows) });
201
+ }, [columnSpec, loadedData, storeAPI]);
202
+ const bumpRefresh = ctx.useSet(dataRefreshTokenAtom);
203
+ const firstRefreshToken = useRef(true);
204
+ useEffect(() => {
205
+ if (firstRefreshToken.current) {
206
+ firstRefreshToken.current = false;
207
+ return;
208
+ }
209
+ bumpRefresh((v) => v + 1);
210
+ }, [refreshToken, bumpRefresh]);
211
+ useEffect(() => {
212
+ const p = dataProvider?.provider ?? null;
213
+ const refresh = () => bumpRefresh((v) => v + 1);
214
+ const withRefresh = (fn) => fn == null ? void 0 : async (...args) => {
215
+ await fn(...args);
216
+ refresh();
217
+ };
218
+ storeAPI.setState({
219
+ rowEditing: {
220
+ saveRows: withRefresh(p?.saveRows?.bind(p)),
221
+ deleteRows: withRefresh(p?.deleteRows?.bind(p)),
222
+ insertRow: withRefresh(p?.insertRow?.bind(p)),
223
+ refresh
224
+ }
225
+ });
226
+ }, [storeAPI, dataProvider, bumpRefresh]);
227
+ useEffect(() => {
228
+ const id = dataProvider?.provider?.identity ?? identity;
229
+ if (id != null) storeAPI.setState({ identity: id });
230
+ }, [storeAPI, dataProvider, identity]);
231
+ useEffect(() => {
232
+ const canDeleteRows = !dataProvider?.isExplicitProvider || dataProvider.provider?.deleteRows != null;
233
+ storeAPI.setState({ canDeleteRows });
234
+ }, [storeAPI, dataProvider]);
235
+ return children;
236
+ }
237
+ function useStoreAPI() {
238
+ const store = ctx.useValue(storeAPIAtom);
239
+ if (!store) {
240
+ throw new Error("Missing DataSheetProvider");
241
+ }
242
+ return store;
243
+ }
244
+ function useSelector(selector) {
245
+ const store = useStoreAPI();
246
+ return useStore(store, selector);
247
+ }
248
+ const columnSpecAtom = atom((get) => get(storeAtom)?.columnSpec ?? []);
249
+ const tableDataAtom = atom(
250
+ (get) => {
251
+ return get(storeAtom)?.data ?? [];
252
+ },
253
+ (get, set, newData) => {
254
+ set(storeAtom, (state) => {
255
+ let next = { ...state, data: newData };
256
+ if (state.columnSpec.length == 0 && !state.deferColumnSpec) {
257
+ const sample = newData.filter((row) => row != null);
258
+ if (sample.length > 0) {
259
+ next.columnSpec = generateColumnSpec(sample, state.columnSpecOptions);
260
+ }
261
+ }
262
+ if (!state.controlledOverlay) {
263
+ const remap = remapOverlayByIdentity(state, newData);
264
+ next.data = remap.data;
265
+ next.updatedData = remap.updatedData;
266
+ next.rowStatus = remap.rowStatus;
267
+ next.pendingOverlayById = remap.pending;
268
+ }
269
+ return next;
270
+ });
271
+ }
272
+ );
273
+ function overlayIdentity(state, row) {
274
+ if (row == null) return void 0;
275
+ const added = row[DS_ROW_ID];
276
+ if (added != null) return added;
277
+ return state.identity(row);
278
+ }
279
+ function remapOverlayByIdentity(state, newData) {
280
+ const { data: oldData, updatedData, rowStatus } = state;
281
+ const byId = new Map(state.pendingOverlayById);
282
+ const n = Math.max(
283
+ oldData.length,
284
+ updatedData?.length ?? 0,
285
+ rowStatus?.length ?? 0
286
+ );
287
+ for (let i = 0; i < n; i++) {
288
+ const row = oldData[i];
289
+ if (row == null) continue;
290
+ const id = overlayIdentity(state, row);
291
+ if (id == null) continue;
292
+ const edit = updatedData?.[i];
293
+ const status = rowStatus?.[i];
294
+ if (edit != null || status != null) byId.set(id, { edit, status });
295
+ }
296
+ const resultData = newData.slice();
297
+ const nextUpdated = [];
298
+ const nextStatus = [];
299
+ const attached = /* @__PURE__ */ new Set();
300
+ for (let j = 0; j < resultData.length; j++) {
301
+ const row = resultData[j];
302
+ if (row == null) continue;
303
+ const id = overlayIdentity(state, row);
304
+ if (id == null) continue;
305
+ const entry = byId.get(id);
306
+ if (entry == null) continue;
307
+ if (entry.edit != null) nextUpdated[j] = entry.edit;
308
+ if (entry.status != null) nextStatus[j] = entry.status;
309
+ attached.add(id);
310
+ }
311
+ const pending = /* @__PURE__ */ new Map();
312
+ for (const [id, entry] of byId) {
313
+ if (attached.has(id)) continue;
314
+ if (entry.status === TableElementStatus.ADDED) {
315
+ const idx = resultData.length;
316
+ resultData.push(entry.edit ?? {});
317
+ nextUpdated[idx] = entry.edit;
318
+ nextStatus[idx] = entry.status;
319
+ } else {
320
+ pending.set(id, entry);
321
+ }
322
+ }
323
+ return {
324
+ data: resultData,
325
+ updatedData: nextUpdated,
326
+ rowStatus: nextStatus,
327
+ pending
328
+ };
329
+ }
330
+ const contentLabelsAtom = atom({
331
+ tableName: null,
332
+ itemLabel: null
333
+ });
334
+ const itemLabelAtom = atom((get) => {
335
+ return get(contentLabelsAtom).itemLabel ?? "row";
336
+ });
337
+ const tableNameAtom = atom((get) => {
338
+ let { tableName, itemLabel } = get(contentLabelsAtom);
339
+ if (tableName != null) return tableName;
340
+ if (itemLabel != null) capitalize(pluralize(itemLabel, 2));
341
+ return "Table";
342
+ });
343
+ function useItemCount(n) {
344
+ const dataKind = ctx.useValue(itemLabelAtom);
345
+ return itemCount(n, dataKind ?? "row");
346
+ }
347
+ function itemCount(n, dataKind) {
348
+ const base = n == 0 ? "No" : `${n}`;
349
+ return base + " " + pluralize(dataKind, n);
350
+ }
351
+ function pluralize(singularForm, n) {
352
+ const pluralForm = singularForm + "s";
353
+ if (n == 0) return `${pluralForm}`;
354
+ if (n == 1) return singularForm;
355
+ return pluralForm;
356
+ }
357
+ function capitalize(s) {
358
+ return s.charAt(0).toUpperCase() + s.slice(1);
359
+ }
360
+ export {
361
+ DataSheetProvider,
362
+ DataSheetProviderInner,
363
+ capitalize,
364
+ columnSpecAtom,
365
+ ctx,
366
+ dataProviderAtom,
367
+ itemLabelAtom,
368
+ pluralize,
369
+ splitDataProviderProps,
370
+ storeAPIAtom,
371
+ storeAtom,
372
+ tableActionsAtom,
373
+ tableDataAtom,
374
+ tableNameAtom,
375
+ useItemCount,
376
+ useResolvedProvider,
377
+ useSelector,
378
+ useStoreAPI
379
+ };
380
+ //# sourceMappingURL=core.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core.js","sources":["../../src/provider/core.ts"],"sourcesContent":["import { SetStateAction, useEffect, useMemo, useRef, useState } from \"react\";\nimport h from \"@macrostrat/hyper\";\nimport { createStore, StoreApi, useStore } from \"zustand\";\nimport { Table } from \"@blueprintjs/table\";\nimport {\n type ColumnSpec,\n generateColumnSpec,\n postprocessColumnSpec,\n} from \"./column-spec.ts\";\nimport { splitProps } from \"../utils\";\nimport { createScopedStore } from \"@macrostrat/data-components\";\nimport {\n DataSheetProviderProps,\n DataSheetState,\n DataSheetStore,\n DS_ROW_ID,\n TableElementStatus,\n} from \"./types.ts\";\nimport { createZustandStore } from \"./zustand-store.ts\";\nimport { atomWithStore } from \"jotai-zustand\";\nimport { toasterAtom } from \"../notifications.ts\";\nimport { TableAction } from \"../actions\";\nimport { atom } from \"jotai\";\nimport {\n createLocalProvider,\n dataRefreshTokenAtom,\n FetchData,\n TableDataProvider,\n} from \"./table-data.ts\";\nimport { ErrorBoundary, ToasterContext } from \"@macrostrat/ui-components\";\nimport {\n DataViewRendererType,\n InteractionOptions,\n interactionOptionsAtom,\n interactionOptionsKeys,\n resolveInteractionOptions,\n} from \"./interactions.ts\";\nimport { DataViewProps } from \"../data-view.ts\";\nimport { DataSheetProps } from \"../types.ts\";\nimport { DataPanelProps } from \"../data-panel.ts\";\n\n/** Create a Jotai scoped store */\nexport const ctx = createScopedStore();\n\nexport const storeAPIAtom = atom<StoreApi<DataSheetStore<any>>>();\n\nconst storeWrapperAtom = atom((get) => {\n const _storeAPIAtom = get(storeAPIAtom);\n if (_storeAPIAtom == null) {\n return undefined;\n }\n return atomWithStore(_storeAPIAtom);\n});\n\n/** This is the basis for all other atoms that manipulate the store. */\nexport const storeAtom = atom(\n (get) => {\n const storeWrapper = get(storeWrapperAtom);\n if (storeWrapper == null) {\n return undefined;\n }\n return get(storeWrapper);\n },\n (get, set, action: SetStateAction<any>) => {\n const storeWrapper = get(storeWrapperAtom);\n if (storeWrapper == null) {\n throw new Error(\"Missing DataSheetProvider\");\n }\n return set(storeWrapper, action);\n },\n);\n\n/** Stable empty spec so a function `columnSpec` yields a constant init value\n * (see `DataSheetProviderInner`). */\nconst EMPTY_SPEC: ColumnSpec[] = [];\n\nconst initializeStoreAtom = atom(\n null,\n (get, set, payload: Partial<DataSheetStore<any>>) => {\n set(storeAtom, (state) => {\n return {\n ...state,\n ...payload,\n };\n });\n },\n);\n\nexport const tableActionsAtom = atom<TableAction[]>([]);\n\n/** The resolved data source for the table, held in the provider layer (next to\n * the store) rather than resolved inside the render loop. `provider` is the\n * unified `TableDataProvider` (explicit, loose-`fetchData`-wrapped, or a local\n * in-memory provider); `isLocalProvider` distinguishes the in-memory case (it\n * loads the whole array at once and shows no load progress). `isExplicitProvider`\n * distinguishes an explicit `provider` object from a loose `fetchData`/`data`\n * source — only an explicit provider without `deleteRows` disables row\n * deletion; loose sources keep the local delete overlay. */\nexport interface ResolvedDataProvider {\n provider: TableDataProvider<any> | null;\n isLocalProvider: boolean;\n isExplicitProvider: boolean;\n /** Row count of an in-memory (local) source, so a renderer can size the\n * loader's page to \"all of it\" without also receiving the `data` prop. `0`\n * for non-local sources. */\n localCount: number;\n}\n\nconst DEFAULT_DATA_PROVIDER: ResolvedDataProvider = {\n provider: null,\n isLocalProvider: true,\n isExplicitProvider: false,\n localCount: 0,\n};\n\nexport const dataProviderAtom = atom<ResolvedDataProvider>(\n DEFAULT_DATA_PROVIDER,\n);\n\nconst EMPTY_ARRAY: any[] = [];\n\n/** Resolve a table's data source from the loose `provider` / `fetchData` /\n * `data` props (an explicit `provider` wins; else a loose `fetchData` (+\n * `identity`) is wrapped as one; else in-memory `data` becomes a local\n * provider). Shared by `DataSheet`, `DataPanel`, and `DataView` so all three\n * resolve identically. */\nexport function useResolvedProvider<T>(props: {\n provider?: TableDataProvider<T>;\n fetchData?: FetchData<T>;\n data?: T[];\n identity?: (row: T) => string | number | null | undefined;\n}): {\n data: T[];\n isLocalProvider: boolean;\n activeProvider: TableDataProvider<any> | null;\n dataProvider: ResolvedDataProvider;\n} {\n const _data = props.data ?? (EMPTY_ARRAY as T[]);\n const isLocalProvider = props.provider == null && props.fetchData == null;\n const isExplicitProvider = props.provider != null;\n const activeProvider = useMemo<TableDataProvider<any> | null>(() => {\n if (props.provider != null) return props.provider;\n if (props.fetchData != null) {\n return {\n fetchData: props.fetchData,\n identity: props.identity ?? ((r: any) => r?.id),\n } as TableDataProvider<any>;\n }\n if (_data.length > 0) {\n return createLocalProvider(\n _data,\n props.identity != null\n ? { identity: props.identity as (row: any) => string | number }\n : undefined,\n );\n }\n return null;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [props.provider, props.fetchData, _data, props.identity]);\n const localCount = isLocalProvider ? _data.length : 0;\n const dataProvider = useMemo(\n () => ({\n provider: activeProvider,\n isLocalProvider,\n isExplicitProvider,\n localCount,\n }),\n [activeProvider, isLocalProvider, isExplicitProvider, localCount],\n );\n return { data: _data, isLocalProvider, activeProvider, dataProvider };\n}\n\nfunction DataSheetStoreWrapper<T>(props: DataSheetProviderProps<T>) {\n const { toaster, ...rest } = props;\n const [store] = useState(() => {\n return createStore<DataSheetStore<T>>(createZustandStore);\n });\n return h(\n ctx.Provider,\n {\n atoms: [\n [storeAPIAtom, store],\n [toasterAtom, toaster],\n ],\n },\n h(DataSheetProviderInner, rest),\n );\n}\n\nconst tableDataProviderKeys = new Set([\n \"provider\",\n \"fetchData\",\n \"data\",\n \"identity\",\n]);\n\nconst dataProviderKeys = new Set([\n \"columnSpec\",\n \"columnSpecOptions\",\n \"name\",\n \"itemLabel\",\n \"enableColumnReordering\",\n \"defaultColumnWidth\",\n \"refreshToken\",\n \"identity\",\n \"toaster\",\n \"viewType\",\n \"interactionOptions\",\n]);\n\ntype AnyDataSheetProps<T> =\n | DataViewProps<T>\n | DataPanelProps<T>\n | DataSheetProps<T>;\n\nexport function splitDataProviderProps<T>(props: AnyDataSheetProps<T>) {\n /** Split provided props based on provider's needs */\n return splitProps<AnyDataSheetProps<T>, DataSheetProviderProps<T>>(\n props,\n dataProviderKeys\n .union(interactionOptionsKeys)\n .union(tableDataProviderKeys) as Set<keyof DataSheetProviderProps<T>>,\n );\n}\n\nexport function DataSheetProvider<T>(\n props: DataSheetProviderProps<T> & { children: React.ReactNode },\n) {\n return h(\n ToasterContext,\n h(ErrorBoundary, h(DataSheetStoreWrapper<T>, props)),\n );\n}\n\ntype DataSheetProviderInnerProps<T> = DataSheetProviderProps<T> & {\n dataProvider?: ResolvedDataProvider;\n};\n\nexport function DataSheetProviderInner<T>(\n props: DataSheetProviderInnerProps<T>,\n) {\n const tableRef = useRef<Table>(null);\n\n const [interactionOptionsProps, providerProps] = splitProps<\n DataSheetProviderInnerProps<T>,\n InteractionOptions\n >(props, interactionOptionsKeys);\n const interactionOptions = resolveInteractionOptions(\n interactionOptionsProps,\n props.viewType ?? DataViewRendererType.TABLE,\n );\n\n const {\n children,\n columnSpec,\n columnSpecOptions,\n name,\n itemLabel,\n enableColumnReordering,\n defaultColumnWidth = 150,\n refreshToken,\n identity,\n } = providerProps;\n\n const { data, dataProvider } = useResolvedProvider<T>(providerProps);\n\n const initializeStore = ctx.useSet(initializeStoreAtom);\n const storeAPI = useStoreAPI<T>();\n\n // The wrapper resolves the data source (see `DataSheet`); publish it into the\n // scoped atom so the loader/store read it, rather than the inner render\n // component resolving it each render. Kept updated as `data`/`provider`\n // changes.\n\n ctx.useSync(dataProviderAtom, dataProvider ?? DEFAULT_DATA_PROVIDER);\n ctx.useSync(interactionOptionsAtom, interactionOptions);\n\n const contentLabels = useMemo(() => {\n return { tableName: name, itemLabel };\n }, [name, itemLabel]);\n\n ctx.useSync(contentLabelsAtom, contentLabels);\n\n // A function `columnSpec` is derived from the loaded rows later (in\n // `_DataSheet`), not here — start it empty. Crucially it's kept OUT of the\n // init effect's deps: re-running init also resets `data`, so re-initializing\n // when the function's identity changes (e.g. a consumer hiding a column)\n // would wipe the loaded rows. `staticSpec` is a stable value in that case.\n const isFnSpec = typeof columnSpec === \"function\";\n\n const staticSpec = isFnSpec ? EMPTY_SPEC : columnSpec;\n // Not sure how required this initialization is\n const baseSpec = staticSpec ?? generateColumnSpec(data, columnSpecOptions);\n\n useEffect(() => {\n initializeStore({\n columnSpec: postprocessColumnSpec(baseSpec),\n // A function spec is derived from the loaded rows in `_DataSheet`; tell\n // the loader not to auto-generate a plain spec from the first chunk.\n deferColumnSpec: isFnSpec,\n editable: interactionOptions.enableEditing,\n enableColumnReordering,\n data,\n defaultColumnWidth,\n tableRef,\n });\n }, [\n data,\n interactionOptions.enableEditing,\n staticSpec,\n isFnSpec,\n columnSpecOptions,\n enableColumnReordering,\n ]);\n\n // Function `columnSpec`: derive the spec from the loaded rows (no separate\n // fetch of sample data), here at the provider level so BOTH renderers get it\n // — the sheet's cell grid and the panel's `FacetControls` read the same\n // derived spec. Derive once the first rows arrive, and re-derive when the\n // function's identity changes (a consumer memoizes it over its own view state\n // — hidden columns, order, overrides). Guarded by the function identity, so\n // it never re-runs as more rows page in (which would clobber in-store column\n // state on scroll).\n const loadedData = useSelector<T, T[]>((s) => s.data ?? []);\n const derivedSpecFor = useRef<unknown>(null);\n useEffect(() => {\n if (typeof columnSpec !== \"function\") return;\n if (derivedSpecFor.current === columnSpec) return;\n const rows = loadedData.filter((r) => r != null);\n if (rows.length === 0) return;\n derivedSpecFor.current = columnSpec;\n storeAPI.setState({ columnSpec: columnSpec(rows) });\n }, [columnSpec, loadedData, storeAPI]);\n\n const bumpRefresh = ctx.useSet(dataRefreshTokenAtom);\n\n // Imperative re-fetch: bump `refreshToken` to reload the provider (e.g.\n // after a save). Skips the initial mount (the loader does its own first\n // fetch). Shared by `_DataSheet` and `_DataPanel` — driven off this one\n // provider-level `refreshToken`, whichever renderer is mounted.\n const firstRefreshToken = useRef(true);\n useEffect(() => {\n if (firstRefreshToken.current) {\n firstRefreshToken.current = false;\n return;\n }\n bumpRefresh((v) => v + 1);\n }, [refreshToken, bumpRefresh]);\n\n // Provider-backed, auto-refreshing row mutations on the action context\n // (`ctx.saveRows` / `deleteRows` / `insertRow`) — shared by `_DataSheet` and\n // `_DataPanel` (the basis of a table/cards toggle) — so an immediate-edit\n // action persists through the active provider and then re-fetches. Only the\n // capabilities the provider supports are present.\n useEffect(() => {\n const p = dataProvider?.provider ?? null;\n const refresh = () => bumpRefresh((v) => v + 1);\n const withRefresh = <A extends any[]>(\n fn?: (...args: A) => Promise<void>,\n ) =>\n fn == null\n ? undefined\n : async (...args: A) => {\n await fn(...args);\n refresh();\n };\n storeAPI.setState({\n rowEditing: {\n saveRows: withRefresh(p?.saveRows?.bind(p)),\n deleteRows: withRefresh(p?.deleteRows?.bind(p)),\n insertRow: withRefresh(p?.insertRow?.bind(p)),\n refresh,\n },\n });\n }, [storeAPI, dataProvider, bumpRefresh]);\n\n // The active provider supplies the row identity for the edit overlay\n // (`tableDataAtom`'s remap-by-identity), shared by `_DataSheet` and\n // `_DataPanel` — falls back to the loose `identity` prop when the resolved\n // provider doesn't carry its own (e.g. before the first row loads).\n useEffect(() => {\n const id = dataProvider?.provider?.identity ?? identity;\n if (id != null) storeAPI.setState({ identity: id });\n }, [storeAPI, dataProvider, identity]);\n\n // Row deletion is a provider capability: an explicit `provider` (not a loose\n // `fetchData`/`data` source) without `deleteRows` disables deletion\n // entirely. Loose/local sources keep the in-table delete overlay. Shared by\n // `_DataSheet` and `_DataPanel` — gates the delete action's disabled state\n // read by the shared `ActionsToolbar`.\n useEffect(() => {\n const canDeleteRows =\n !dataProvider?.isExplicitProvider ||\n dataProvider.provider?.deleteRows != null;\n storeAPI.setState({ canDeleteRows });\n }, [storeAPI, dataProvider]);\n\n return children;\n}\n\nexport function useStoreAPI<T>(): StoreApi<DataSheetStore<T>> {\n const store = ctx.useValue(storeAPIAtom);\n if (!store) {\n throw new Error(\"Missing DataSheetProvider\");\n }\n return store;\n}\n\nexport function useSelector<T = any, A = any>(\n selector: (state: DataSheetStore<T>) => A,\n): A {\n const store = useStoreAPI<T>();\n return useStore(store, selector);\n}\n/** Atoms for efficient sub-selection of state */\n\nexport const columnSpecAtom = atom((get) => get(storeAtom)?.columnSpec ?? []);\n\nexport const tableDataAtom = atom(\n (get) => {\n return get(storeAtom)?.data ?? [];\n },\n (get, set, newData: any[]) => {\n set(storeAtom, (state: DataSheetState<any>): DataSheetState<any> => {\n let next: DataSheetState<any> = { ...state, data: newData };\n // Auto-generate a plain column spec the first time real rows arrive — no\n // spec yet and none deferred to a function (a function spec is derived\n // separately). Keyed on \"spec still empty + a non-null row present\", NOT\n // on `data.length == 0`: the loader pre-fills `data` with a page of `null`\n // ghost rows on reset, so the array is non-empty before the first chunk.\n if (state.columnSpec.length == 0 && !state.deferColumnSpec) {\n const sample = newData.filter((row) => row != null);\n if (sample.length > 0) {\n next.columnSpec = generateColumnSpec(sample, state.columnSpecOptions);\n }\n }\n\n // Re-attach the edit overlay by identity. The loader replaces `data` with\n // re-ordered windows on sort/filter, so an index-keyed overlay would\n // smear; keying by identity keeps edits (and deletes) on their rows, holds\n // edits for not-yet-loaded rows, and re-appends locally-added rows (which\n // aren't in the provider's data) after it. Skipped when the consumer\n // controls the overlay (they own reconciliation).\n if (!state.controlledOverlay) {\n const remap = remapOverlayByIdentity(state, newData);\n next.data = remap.data;\n next.updatedData = remap.updatedData;\n next.rowStatus = remap.rowStatus;\n next.pendingOverlayById = remap.pending;\n }\n\n return next;\n });\n },\n);\n\ntype OverlayEntry = { edit?: any; status?: any };\n\n/** Row identity used by the overlay: an in-table-added row's synthetic id\n * (stable across its edits), else the provider/consumer `identity`. */\nfunction overlayIdentity(\n state: DataSheetState<any>,\n row: any,\n): string | number | null | undefined {\n if (row == null) return undefined;\n const added = row[DS_ROW_ID];\n if (added != null) return added;\n return state.identity(row);\n}\n\n/** Re-project the (index-keyed) edit overlay from the old `data` order onto a\n * new one, matching rows by identity. Edits/statuses whose row is absent from\n * `newData` are held in `pending` and re-applied when the row loads; rows added\n * in-table (status `ADDED`) are re-appended after the provider data (they have\n * no provider row). Starts from the prior pending set so edits survive multiple\n * re-sorts. Returns the reconstructed data (provider rows + re-appended added\n * rows) alongside the re-aligned overlay. */\nfunction remapOverlayByIdentity(\n state: DataSheetState<any>,\n newData: any[],\n): {\n data: any[];\n updatedData: any[];\n rowStatus: any[];\n pending: Map<string | number, OverlayEntry>;\n} {\n const { data: oldData, updatedData, rowStatus } = state;\n\n // Collect current overlay entries by identity, seeded with prior pending.\n const byId = new Map<string | number, OverlayEntry>(state.pendingOverlayById);\n const n = Math.max(\n oldData.length,\n updatedData?.length ?? 0,\n rowStatus?.length ?? 0,\n );\n for (let i = 0; i < n; i++) {\n const row = oldData[i];\n if (row == null) continue;\n const id = overlayIdentity(state, row);\n if (id == null) continue;\n const edit = updatedData?.[i];\n const status = rowStatus?.[i];\n if (edit != null || status != null) byId.set(id, { edit, status });\n }\n\n // Project onto the new data order.\n const resultData = newData.slice();\n const nextUpdated: any[] = [];\n const nextStatus: any[] = [];\n const attached = new Set<string | number>();\n for (let j = 0; j < resultData.length; j++) {\n const row = resultData[j];\n if (row == null) continue;\n const id = overlayIdentity(state, row);\n if (id == null) continue;\n const entry = byId.get(id);\n if (entry == null) continue;\n if (entry.edit != null) nextUpdated[j] = entry.edit;\n if (entry.status != null) nextStatus[j] = entry.status;\n attached.add(id);\n }\n\n // Re-append in-table-added rows (not present in the provider data), then hold\n // anything still unattached (rows not currently loaded) as pending.\n const pending = new Map<string | number, OverlayEntry>();\n for (const [id, entry] of byId) {\n if (attached.has(id)) continue;\n if (entry.status === TableElementStatus.ADDED) {\n const idx = resultData.length;\n resultData.push(entry.edit ?? {});\n nextUpdated[idx] = entry.edit;\n nextStatus[idx] = entry.status;\n } else {\n pending.set(id, entry);\n }\n }\n\n return {\n data: resultData,\n updatedData: nextUpdated,\n rowStatus: nextStatus,\n pending,\n };\n}\n\ninterface ContentLabels {\n tableName: string | null | undefined;\n itemLabel: string | null | undefined;\n}\n\nconst contentLabelsAtom = atom<ContentLabels>({\n tableName: null,\n itemLabel: null,\n});\n\nexport const itemLabelAtom = atom<string>((get) => {\n return get(contentLabelsAtom).itemLabel ?? \"row\";\n});\nexport const tableNameAtom = atom<string | null>((get) => {\n let { tableName, itemLabel } = get(contentLabelsAtom);\n if (tableName != null) return tableName;\n if (itemLabel != null) capitalize(pluralize(itemLabel, 2));\n return \"Table\";\n});\n\nexport function useItemCount(n: number) {\n const dataKind = ctx.useValue(itemLabelAtom);\n return itemCount(n, dataKind ?? \"row\");\n}\n\nfunction itemCount(n: number, dataKind: string) {\n const base = n == 0 ? \"No\" : `${n}`;\n return base + \" \" + pluralize(dataKind, n);\n}\n\nexport function pluralize(singularForm: string, n: number) {\n const pluralForm = singularForm + \"s\";\n if (n == 0) return `${pluralForm}`;\n if (n == 1) return singularForm;\n return pluralForm;\n}\n\nexport function capitalize(s: string) {\n return s.charAt(0).toUpperCase() + s.slice(1);\n}\n"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ export * from './core';
2
+ export * from './table-data';
3
+ export * from './types';
4
+ export * from './zustand-store';
5
+ export * from './interactions.ts';
6
+ export * from './selection.ts';
7
+ export * from './column-spec.ts';
@@ -0,0 +1,128 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
+ const table = require("@blueprintjs/table");
4
+ const jotai = require("jotai");
5
+ const core = require("./core.cjs");
6
+ var DataViewRendererType = /* @__PURE__ */ ((DataViewRendererType2) => {
7
+ DataViewRendererType2["CARDS"] = "cards";
8
+ DataViewRendererType2["TABLE"] = "table";
9
+ return DataViewRendererType2;
10
+ })(DataViewRendererType || {});
11
+ const defaultInteractionOptions = {
12
+ enableEditing: false,
13
+ enableSelection: false,
14
+ enableModalSelection: false,
15
+ enableMultipleSelection: false,
16
+ enableDragValue: false,
17
+ selectionModes: []
18
+ };
19
+ const interactionOptionsAtom = jotai.atom(
20
+ defaultInteractionOptions
21
+ );
22
+ var SelectionInteractionStyle = /* @__PURE__ */ ((SelectionInteractionStyle2) => {
23
+ SelectionInteractionStyle2["ALWAYS"] = "always";
24
+ SelectionInteractionStyle2["NEVER"] = "never";
25
+ SelectionInteractionStyle2["MODAL"] = "modal";
26
+ return SelectionInteractionStyle2;
27
+ })(SelectionInteractionStyle || {});
28
+ const interactionOptionsKeys = /* @__PURE__ */ new Set([
29
+ "editable",
30
+ "enableEditing",
31
+ "enableSelection",
32
+ "enableMultipleSelection",
33
+ "enableDragValue",
34
+ "selectionModes",
35
+ "interactionOptions"
36
+ ]);
37
+ function resolveInteractionOptions(opts, renderer) {
38
+ if (opts.interactionOptions) return opts.interactionOptions;
39
+ let {
40
+ enableEditing,
41
+ selectionModes,
42
+ enableSelection: _enableSelection,
43
+ enableDragValue,
44
+ enableMultipleSelection
45
+ } = opts;
46
+ if (renderer == "cards") {
47
+ _enableSelection ??= true;
48
+ }
49
+ let enableSelection;
50
+ let enableModalSelection = false;
51
+ if (typeof _enableSelection === "string") {
52
+ switch (_enableSelection) {
53
+ case "always":
54
+ enableSelection = true;
55
+ break;
56
+ case "never":
57
+ enableSelection = false;
58
+ break;
59
+ case "modal":
60
+ enableSelection = false;
61
+ enableModalSelection = true;
62
+ break;
63
+ }
64
+ } else {
65
+ enableSelection ??= _enableSelection ?? true;
66
+ }
67
+ enableEditing ??= opts.editable ?? enableSelection ?? true;
68
+ enableMultipleSelection ??= true;
69
+ if (renderer == "table") {
70
+ if (selectionModes != null) {
71
+ enableSelection = new Set(selectionModes).size > 0;
72
+ }
73
+ enableSelection ??= true;
74
+ if (enableSelection) {
75
+ selectionModes ??= [
76
+ table.RegionCardinality.FULL_TABLE,
77
+ table.RegionCardinality.CELLS,
78
+ table.RegionCardinality.FULL_ROWS,
79
+ table.RegionCardinality.FULL_COLUMNS
80
+ ];
81
+ enableEditing ??= true;
82
+ enableDragValue ??= true;
83
+ } else {
84
+ selectionModes ??= [table.RegionCardinality.FULL_TABLE];
85
+ }
86
+ if (!selectionModes.includes(table.RegionCardinality.CELLS)) {
87
+ enableEditing = false;
88
+ }
89
+ enableDragValue ??= enableEditing;
90
+ } else if (renderer == "cards") {
91
+ if (enableSelection) {
92
+ selectionModes = [
93
+ table.RegionCardinality.FULL_ROWS,
94
+ table.RegionCardinality.FULL_TABLE
95
+ ];
96
+ enableEditing ??= true;
97
+ } else {
98
+ selectionModes = [table.RegionCardinality.FULL_TABLE];
99
+ }
100
+ enableDragValue = false;
101
+ }
102
+ if (!enableEditing) {
103
+ enableDragValue = false;
104
+ }
105
+ return {
106
+ enableEditing,
107
+ enableDragValue: enableDragValue ?? false,
108
+ enableMultipleSelection,
109
+ selectionModes,
110
+ enableModalSelection,
111
+ enableSelection
112
+ };
113
+ }
114
+ const enableDragValueAtom = jotai.atom((get) => {
115
+ return get(interactionOptionsAtom).enableDragValue;
116
+ });
117
+ const dragValueHandlerAtom = jotai.atom((get) => {
118
+ if (!get(enableDragValueAtom)) return void 0;
119
+ return get(core.storeAtom)?.onDragValue;
120
+ });
121
+ exports.DataViewRendererType = DataViewRendererType;
122
+ exports.SelectionInteractionStyle = SelectionInteractionStyle;
123
+ exports.dragValueHandlerAtom = dragValueHandlerAtom;
124
+ exports.enableDragValueAtom = enableDragValueAtom;
125
+ exports.interactionOptionsAtom = interactionOptionsAtom;
126
+ exports.interactionOptionsKeys = interactionOptionsKeys;
127
+ exports.resolveInteractionOptions = resolveInteractionOptions;
128
+ //# sourceMappingURL=interactions.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interactions.cjs","sources":["../../src/provider/interactions.ts"],"sourcesContent":["import { RegionCardinality } from \"@blueprintjs/table\";\nimport { atom } from \"jotai\";\nimport { storeAtom } from \"./core.ts\";\n\nexport enum DataViewRendererType {\n CARDS = \"cards\",\n TABLE = \"table\",\n}\n\nexport interface InteractionOptionsResolved {\n enableEditing: boolean;\n enableSelection: boolean;\n // We have a potentially modal selection\n enableModalSelection: boolean;\n /** Options for data interaction (editing and selection) */\n enableMultipleSelection: boolean;\n // Enable drag-to-select (data table only)\n enableDragValue: boolean;\n selectionModes: RegionCardinality[];\n}\n\nconst defaultInteractionOptions: InteractionOptionsResolved = {\n enableEditing: false,\n enableSelection: false,\n enableModalSelection: false,\n enableMultipleSelection: false,\n enableDragValue: false,\n selectionModes: [],\n};\n\n/** Atom to store interaction options state */\nexport const interactionOptionsAtom = atom<InteractionOptionsResolved>(\n defaultInteractionOptions,\n);\n\nexport enum SelectionInteractionStyle {\n ALWAYS = \"always\",\n NEVER = \"never\",\n MODAL = \"modal\",\n}\n\nexport interface InteractionOptions {\n /** Options for data interaction (editing and selection) */\n /** @deprecated: Use enableEditing instead */\n editable?: boolean;\n enableEditing?: boolean;\n enableSelection?: boolean | SelectionInteractionStyle;\n enableMultipleSelection?: boolean;\n // Enable drag-to-select (data table only)\n enableDragValue?: boolean;\n selectionModes?: RegionCardinality[];\n interactionOptions?: InteractionOptionsResolved;\n}\n\nexport const interactionOptionsKeys: Set<keyof InteractionOptions> = new Set([\n \"editable\",\n \"enableEditing\",\n \"enableSelection\",\n \"enableMultipleSelection\",\n \"enableDragValue\",\n \"selectionModes\",\n \"interactionOptions\",\n]);\n\n/** Resolve the granular interaction options for a particular editing domain */\nexport function resolveInteractionOptions(\n opts: InteractionOptions,\n renderer: DataViewRendererType,\n): InteractionOptionsResolved {\n // If the user has provided interaction options, use them.\n if (opts.interactionOptions) return opts.interactionOptions;\n\n /** Resolve a unified set of interaction options for the table and cards */\n let {\n enableEditing,\n selectionModes,\n enableSelection: _enableSelection,\n enableDragValue,\n enableMultipleSelection,\n } = opts;\n\n if (renderer == DataViewRendererType.CARDS) {\n _enableSelection ??= true;\n }\n\n let enableSelection: boolean;\n let enableModalSelection = false;\n if (typeof _enableSelection === \"string\") {\n switch (_enableSelection) {\n case SelectionInteractionStyle.ALWAYS:\n enableSelection = true;\n break;\n case SelectionInteractionStyle.NEVER:\n enableSelection = false;\n break;\n case SelectionInteractionStyle.MODAL:\n enableSelection = false;\n enableModalSelection = true;\n break;\n }\n } else {\n enableSelection ??= _enableSelection ?? true;\n }\n\n enableEditing ??= opts.editable ?? enableSelection ?? true;\n enableMultipleSelection ??= true;\n if (renderer == DataViewRendererType.TABLE) {\n if (selectionModes != null) {\n enableSelection = new Set(selectionModes).size > 0;\n }\n enableSelection ??= true;\n if (enableSelection) {\n selectionModes ??= [\n RegionCardinality.FULL_TABLE,\n RegionCardinality.CELLS,\n RegionCardinality.FULL_ROWS,\n RegionCardinality.FULL_COLUMNS,\n ];\n enableEditing ??= true;\n enableDragValue ??= true;\n } else {\n selectionModes ??= [RegionCardinality.FULL_TABLE];\n }\n if (!selectionModes.includes(RegionCardinality.CELLS)) {\n enableEditing = false;\n }\n enableDragValue ??= enableEditing;\n } else if (renderer == DataViewRendererType.CARDS) {\n if (enableSelection) {\n // Only one selection mode possible\n selectionModes = [\n RegionCardinality.FULL_ROWS,\n RegionCardinality.FULL_TABLE,\n ];\n enableEditing ??= true;\n } else {\n selectionModes = [RegionCardinality.FULL_TABLE];\n }\n enableDragValue = false;\n }\n if (!enableEditing) {\n enableDragValue = false;\n }\n\n return {\n enableEditing,\n enableDragValue: enableDragValue ?? false,\n enableMultipleSelection,\n selectionModes: selectionModes as RegionCardinality[],\n enableModalSelection,\n enableSelection,\n };\n}\n\nexport const enableDragValueAtom = atom((get) => {\n return get(interactionOptionsAtom).enableDragValue;\n});\nexport const dragValueHandlerAtom = atom((get) => {\n if (!get(enableDragValueAtom)) return undefined;\n return get(storeAtom)?.onDragValue;\n});\n"],"names":["DataViewRendererType","atom","SelectionInteractionStyle","RegionCardinality","storeAtom"],"mappings":";;;;;AAIO,IAAK,yCAAAA,0BAAL;AACLA,wBAAA,OAAA,IAAQ;AACRA,wBAAA,OAAA,IAAQ;AAFE,SAAAA;AAAA,GAAA,wBAAA,CAAA,CAAA;AAiBZ,MAAM,4BAAwD;AAAA,EAC5D,eAAe;AAAA,EACf,iBAAiB;AAAA,EACjB,sBAAsB;AAAA,EACtB,yBAAyB;AAAA,EACzB,iBAAiB;AAAA,EACjB,gBAAgB,CAAA;AAClB;AAGO,MAAM,yBAAyBC,MAAAA;AAAAA,EACpC;AACF;AAEO,IAAK,8CAAAC,+BAAL;AACLA,6BAAA,QAAA,IAAS;AACTA,6BAAA,OAAA,IAAQ;AACRA,6BAAA,OAAA,IAAQ;AAHE,SAAAA;AAAA,GAAA,6BAAA,CAAA,CAAA;AAmBL,MAAM,6CAA4D,IAAI;AAAA,EAC3E;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAGM,SAAS,0BACd,MACA,UAC4B;AAE5B,MAAI,KAAK,mBAAoB,QAAO,KAAK;AAGzC,MAAI;AAAA,IACF;AAAA,IACA;AAAA,IACA,iBAAiB;AAAA,IACjB;AAAA,IACA;AAAA,EAAA,IACE;AAEJ,MAAI,YAAY,SAA4B;AAC1C,yBAAqB;AAAA,EACvB;AAEA,MAAI;AACJ,MAAI,uBAAuB;AAC3B,MAAI,OAAO,qBAAqB,UAAU;AACxC,YAAQ,kBAAA;AAAA,MACN,KAAK;AACH,0BAAkB;AAClB;AAAA,MACF,KAAK;AACH,0BAAkB;AAClB;AAAA,MACF,KAAK;AACH,0BAAkB;AAClB,+BAAuB;AACvB;AAAA,IAAA;AAAA,EAEN,OAAO;AACL,wBAAoB,oBAAoB;AAAA,EAC1C;AAEA,oBAAkB,KAAK,YAAY,mBAAmB;AACtD,8BAA4B;AAC5B,MAAI,YAAY,SAA4B;AAC1C,QAAI,kBAAkB,MAAM;AAC1B,wBAAkB,IAAI,IAAI,cAAc,EAAE,OAAO;AAAA,IACnD;AACA,wBAAoB;AACpB,QAAI,iBAAiB;AACnB,yBAAmB;AAAA,QACjBC,MAAAA,kBAAkB;AAAA,QAClBA,MAAAA,kBAAkB;AAAA,QAClBA,MAAAA,kBAAkB;AAAA,QAClBA,wBAAkB;AAAA,MAAA;AAEpB,wBAAkB;AAClB,0BAAoB;AAAA,IACtB,OAAO;AACL,yBAAmB,CAACA,MAAAA,kBAAkB,UAAU;AAAA,IAClD;AACA,QAAI,CAAC,eAAe,SAASA,MAAAA,kBAAkB,KAAK,GAAG;AACrD,sBAAgB;AAAA,IAClB;AACA,wBAAoB;AAAA,EACtB,WAAW,YAAY,SAA4B;AACjD,QAAI,iBAAiB;AAEnB,uBAAiB;AAAA,QACfA,MAAAA,kBAAkB;AAAA,QAClBA,wBAAkB;AAAA,MAAA;AAEpB,wBAAkB;AAAA,IACpB,OAAO;AACL,uBAAiB,CAACA,MAAAA,kBAAkB,UAAU;AAAA,IAChD;AACA,sBAAkB;AAAA,EACpB;AACA,MAAI,CAAC,eAAe;AAClB,sBAAkB;AAAA,EACpB;AAEA,SAAO;AAAA,IACL;AAAA,IACA,iBAAiB,mBAAmB;AAAA,IACpC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEO,MAAM,sBAAsBF,MAAAA,KAAK,CAAC,QAAQ;AAC/C,SAAO,IAAI,sBAAsB,EAAE;AACrC,CAAC;AACM,MAAM,uBAAuBA,MAAAA,KAAK,CAAC,QAAQ;AAChD,MAAI,CAAC,IAAI,mBAAmB,EAAG,QAAO;AACtC,SAAO,IAAIG,KAAAA,SAAS,GAAG;AACzB,CAAC;;;;;;;;"}
@@ -0,0 +1,39 @@
1
+ import { RegionCardinality } from '@blueprintjs/table';
2
+ export declare enum DataViewRendererType {
3
+ CARDS = "cards",
4
+ TABLE = "table"
5
+ }
6
+ export interface InteractionOptionsResolved {
7
+ enableEditing: boolean;
8
+ enableSelection: boolean;
9
+ enableModalSelection: boolean;
10
+ /** Options for data interaction (editing and selection) */
11
+ enableMultipleSelection: boolean;
12
+ enableDragValue: boolean;
13
+ selectionModes: RegionCardinality[];
14
+ }
15
+ /** Atom to store interaction options state */
16
+ export declare const interactionOptionsAtom: import('jotai').PrimitiveAtom<InteractionOptionsResolved> & {
17
+ init: InteractionOptionsResolved;
18
+ };
19
+ export declare enum SelectionInteractionStyle {
20
+ ALWAYS = "always",
21
+ NEVER = "never",
22
+ MODAL = "modal"
23
+ }
24
+ export interface InteractionOptions {
25
+ /** Options for data interaction (editing and selection) */
26
+ /** @deprecated: Use enableEditing instead */
27
+ editable?: boolean;
28
+ enableEditing?: boolean;
29
+ enableSelection?: boolean | SelectionInteractionStyle;
30
+ enableMultipleSelection?: boolean;
31
+ enableDragValue?: boolean;
32
+ selectionModes?: RegionCardinality[];
33
+ interactionOptions?: InteractionOptionsResolved;
34
+ }
35
+ export declare const interactionOptionsKeys: Set<keyof InteractionOptions>;
36
+ /** Resolve the granular interaction options for a particular editing domain */
37
+ export declare function resolveInteractionOptions(opts: InteractionOptions, renderer: DataViewRendererType): InteractionOptionsResolved;
38
+ export declare const enableDragValueAtom: import('jotai').Atom<boolean>;
39
+ export declare const dragValueHandlerAtom: import('jotai').Atom<((event: MouseEvent) => void) | undefined>;