@macrostrat/data-sheet 4.1.1 → 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 (303) hide show
  1. package/CHANGELOG.md +34 -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/{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} +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} +123 -190
  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 -159
  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} +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} +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} +145 -330
  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.js.map +0 -1
  278. package/dist/core.cjs.map +0 -1
  279. package/dist/core.d.ts +0 -117
  280. package/dist/core.js.map +0 -1
  281. package/dist/provider.cjs +0 -197
  282. package/dist/provider.cjs.map +0 -1
  283. package/dist/provider.d.ts +0 -26
  284. package/dist/provider.js +0 -195
  285. package/dist/provider.js.map +0 -1
  286. package/dist/table-updates/data-parameter.d.ts +0 -14
  287. package/dist/table-updates/filter.d.ts +0 -16
  288. package/dist/table-updates/index.d.ts +0 -19
  289. package/dist/utils/column-spec.cjs.map +0 -1
  290. package/dist/utils/column-spec.js.map +0 -1
  291. package/dist/utils/index.cjs +0 -9
  292. package/dist/utils/index.cjs.map +0 -1
  293. package/dist/utils/index.js +0 -9
  294. package/dist/utils/index.js.map +0 -1
  295. package/dist/zustand-store.cjs.map +0 -1
  296. package/dist/zustand-store.js.map +0 -1
  297. package/src/actions/filters.ts +0 -176
  298. package/src/components/actions.module.sass +0 -8
  299. package/src/provider.ts +0 -267
  300. package/src/table-updates/data-parameter.ts +0 -44
  301. package/src/table-updates/filter.ts +0 -124
  302. package/src/table-updates/index.ts +0 -239
  303. /package/dist/{zustand-store.d.ts → provider/zustand-store.d.ts} +0 -0
@@ -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>;
@@ -0,0 +1,128 @@
1
+ import { RegionCardinality } from "@blueprintjs/table";
2
+ import { atom } from "jotai";
3
+ import { storeAtom } from "./core.js";
4
+ var DataViewRendererType = /* @__PURE__ */ ((DataViewRendererType2) => {
5
+ DataViewRendererType2["CARDS"] = "cards";
6
+ DataViewRendererType2["TABLE"] = "table";
7
+ return DataViewRendererType2;
8
+ })(DataViewRendererType || {});
9
+ const defaultInteractionOptions = {
10
+ enableEditing: false,
11
+ enableSelection: false,
12
+ enableModalSelection: false,
13
+ enableMultipleSelection: false,
14
+ enableDragValue: false,
15
+ selectionModes: []
16
+ };
17
+ const interactionOptionsAtom = atom(
18
+ defaultInteractionOptions
19
+ );
20
+ var SelectionInteractionStyle = /* @__PURE__ */ ((SelectionInteractionStyle2) => {
21
+ SelectionInteractionStyle2["ALWAYS"] = "always";
22
+ SelectionInteractionStyle2["NEVER"] = "never";
23
+ SelectionInteractionStyle2["MODAL"] = "modal";
24
+ return SelectionInteractionStyle2;
25
+ })(SelectionInteractionStyle || {});
26
+ const interactionOptionsKeys = /* @__PURE__ */ new Set([
27
+ "editable",
28
+ "enableEditing",
29
+ "enableSelection",
30
+ "enableMultipleSelection",
31
+ "enableDragValue",
32
+ "selectionModes",
33
+ "interactionOptions"
34
+ ]);
35
+ function resolveInteractionOptions(opts, renderer) {
36
+ if (opts.interactionOptions) return opts.interactionOptions;
37
+ let {
38
+ enableEditing,
39
+ selectionModes,
40
+ enableSelection: _enableSelection,
41
+ enableDragValue,
42
+ enableMultipleSelection
43
+ } = opts;
44
+ if (renderer == "cards") {
45
+ _enableSelection ??= true;
46
+ }
47
+ let enableSelection;
48
+ let enableModalSelection = false;
49
+ if (typeof _enableSelection === "string") {
50
+ switch (_enableSelection) {
51
+ case "always":
52
+ enableSelection = true;
53
+ break;
54
+ case "never":
55
+ enableSelection = false;
56
+ break;
57
+ case "modal":
58
+ enableSelection = false;
59
+ enableModalSelection = true;
60
+ break;
61
+ }
62
+ } else {
63
+ enableSelection ??= _enableSelection ?? true;
64
+ }
65
+ enableEditing ??= opts.editable ?? enableSelection ?? true;
66
+ enableMultipleSelection ??= true;
67
+ if (renderer == "table") {
68
+ if (selectionModes != null) {
69
+ enableSelection = new Set(selectionModes).size > 0;
70
+ }
71
+ enableSelection ??= true;
72
+ if (enableSelection) {
73
+ selectionModes ??= [
74
+ RegionCardinality.FULL_TABLE,
75
+ RegionCardinality.CELLS,
76
+ RegionCardinality.FULL_ROWS,
77
+ RegionCardinality.FULL_COLUMNS
78
+ ];
79
+ enableEditing ??= true;
80
+ enableDragValue ??= true;
81
+ } else {
82
+ selectionModes ??= [RegionCardinality.FULL_TABLE];
83
+ }
84
+ if (!selectionModes.includes(RegionCardinality.CELLS)) {
85
+ enableEditing = false;
86
+ }
87
+ enableDragValue ??= enableEditing;
88
+ } else if (renderer == "cards") {
89
+ if (enableSelection) {
90
+ selectionModes = [
91
+ RegionCardinality.FULL_ROWS,
92
+ RegionCardinality.FULL_TABLE
93
+ ];
94
+ enableEditing ??= true;
95
+ } else {
96
+ selectionModes = [RegionCardinality.FULL_TABLE];
97
+ }
98
+ enableDragValue = false;
99
+ }
100
+ if (!enableEditing) {
101
+ enableDragValue = false;
102
+ }
103
+ return {
104
+ enableEditing,
105
+ enableDragValue: enableDragValue ?? false,
106
+ enableMultipleSelection,
107
+ selectionModes,
108
+ enableModalSelection,
109
+ enableSelection
110
+ };
111
+ }
112
+ const enableDragValueAtom = atom((get) => {
113
+ return get(interactionOptionsAtom).enableDragValue;
114
+ });
115
+ const dragValueHandlerAtom = atom((get) => {
116
+ if (!get(enableDragValueAtom)) return void 0;
117
+ return get(storeAtom)?.onDragValue;
118
+ });
119
+ export {
120
+ DataViewRendererType,
121
+ SelectionInteractionStyle,
122
+ dragValueHandlerAtom,
123
+ enableDragValueAtom,
124
+ interactionOptionsAtom,
125
+ interactionOptionsKeys,
126
+ resolveInteractionOptions
127
+ };
128
+ //# sourceMappingURL=interactions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interactions.js","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","SelectionInteractionStyle"],"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,yBAAyB;AAAA,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,QACjB,kBAAkB;AAAA,QAClB,kBAAkB;AAAA,QAClB,kBAAkB;AAAA,QAClB,kBAAkB;AAAA,MAAA;AAEpB,wBAAkB;AAClB,0BAAoB;AAAA,IACtB,OAAO;AACL,yBAAmB,CAAC,kBAAkB,UAAU;AAAA,IAClD;AACA,QAAI,CAAC,eAAe,SAAS,kBAAkB,KAAK,GAAG;AACrD,sBAAgB;AAAA,IAClB;AACA,wBAAoB;AAAA,EACtB,WAAW,YAAY,SAA4B;AACjD,QAAI,iBAAiB;AAEnB,uBAAiB;AAAA,QACf,kBAAkB;AAAA,QAClB,kBAAkB;AAAA,MAAA;AAEpB,wBAAkB;AAAA,IACpB,OAAO;AACL,uBAAiB,CAAC,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,sBAAsB,KAAK,CAAC,QAAQ;AAC/C,SAAO,IAAI,sBAAsB,EAAE;AACrC,CAAC;AACM,MAAM,uBAAuB,KAAK,CAAC,QAAQ;AAChD,MAAI,CAAC,IAAI,mBAAmB,EAAG,QAAO;AACtC,SAAO,IAAI,SAAS,GAAG;AACzB,CAAC;"}
@@ -0,0 +1,29 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
+ const jotai = require("jotai");
4
+ const interactions = require("./interactions.cjs");
5
+ const core = require("./core.cjs");
6
+ const anchorRefAtom = jotai.atom({
7
+ current: null
8
+ });
9
+ const selectionAtom = jotai.atom(
10
+ (get) => {
11
+ if (!get(interactions.interactionOptionsAtom).enableSelection) return [];
12
+ return get(core.storeAtom)?.selection ?? [];
13
+ },
14
+ (get, set, regions = []) => {
15
+ if (!get(interactions.interactionOptionsAtom).enableSelection) return;
16
+ if (regions.length === 0) {
17
+ get(anchorRefAtom).current = null;
18
+ }
19
+ set(core.storeAtom, (s) => ({
20
+ ...s,
21
+ selection: regions,
22
+ focusedCell: null,
23
+ topLeftCell: null
24
+ }));
25
+ }
26
+ );
27
+ exports.anchorRefAtom = anchorRefAtom;
28
+ exports.selectionAtom = selectionAtom;
29
+ //# sourceMappingURL=selection.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"selection.cjs","sources":["../../src/provider/selection.ts"],"sourcesContent":["import { atom } from \"jotai\";\nimport { interactionOptionsAtom } from \"./interactions.ts\";\nimport { storeAtom } from \"./core.ts\";\nimport type { Region } from \"@blueprintjs/table\";\n\n// The anchor for shift-range selection: the last row clicked without shift.\n// Reset when the selection is cleared elsewhere (e.g. the toolbar's ✕).\nexport const anchorRefAtom = atom<{ current: number | null }>({\n current: null,\n});\n\nexport const selectionAtom = atom(\n (get) => {\n if (!get(interactionOptionsAtom).enableSelection) return [];\n return get(storeAtom)?.selection ?? [];\n },\n (get, set, regions: Region[] = []) => {\n /** Don't do anything if selection isn't enabled */\n if (!get(interactionOptionsAtom).enableSelection) return;\n /** Reset the selection anchor ref */\n if (regions.length === 0) {\n get(anchorRefAtom).current = null;\n }\n set(storeAtom, (s) => ({\n ...s,\n selection: regions,\n focusedCell: null,\n topLeftCell: null,\n }));\n },\n);\n"],"names":["atom","interactionOptionsAtom","storeAtom"],"mappings":";;;;;AAOO,MAAM,gBAAgBA,MAAAA,KAAiC;AAAA,EAC5D,SAAS;AACX,CAAC;AAEM,MAAM,gBAAgBA,MAAAA;AAAAA,EAC3B,CAAC,QAAQ;AACP,QAAI,CAAC,IAAIC,aAAAA,sBAAsB,EAAE,wBAAwB,CAAA;AACzD,WAAO,IAAIC,KAAAA,SAAS,GAAG,aAAa,CAAA;AAAA,EACtC;AAAA,EACA,CAAC,KAAK,KAAK,UAAoB,OAAO;AAEpC,QAAI,CAAC,IAAID,mCAAsB,EAAE,gBAAiB;AAElD,QAAI,QAAQ,WAAW,GAAG;AACxB,UAAI,aAAa,EAAE,UAAU;AAAA,IAC/B;AACA,QAAIC,KAAAA,WAAW,CAAC,OAAO;AAAA,MACrB,GAAG;AAAA,MACH,WAAW;AAAA,MACX,aAAa;AAAA,MACb,aAAa;AAAA,IAAA,EACb;AAAA,EACJ;AACF;;;"}
@@ -0,0 +1,9 @@
1
+ import { Region } from '@blueprintjs/table';
2
+ export declare const anchorRefAtom: import('jotai').PrimitiveAtom<{
3
+ current: number | null;
4
+ }> & {
5
+ init: {
6
+ current: number | null;
7
+ };
8
+ };
9
+ export declare const selectionAtom: import('jotai').WritableAtom<Region[], [regions?: Region[] | undefined], void>;
@@ -0,0 +1,29 @@
1
+ import { atom } from "jotai";
2
+ import { interactionOptionsAtom } from "./interactions.js";
3
+ import { storeAtom } from "./core.js";
4
+ const anchorRefAtom = atom({
5
+ current: null
6
+ });
7
+ const selectionAtom = atom(
8
+ (get) => {
9
+ if (!get(interactionOptionsAtom).enableSelection) return [];
10
+ return get(storeAtom)?.selection ?? [];
11
+ },
12
+ (get, set, regions = []) => {
13
+ if (!get(interactionOptionsAtom).enableSelection) return;
14
+ if (regions.length === 0) {
15
+ get(anchorRefAtom).current = null;
16
+ }
17
+ set(storeAtom, (s) => ({
18
+ ...s,
19
+ selection: regions,
20
+ focusedCell: null,
21
+ topLeftCell: null
22
+ }));
23
+ }
24
+ );
25
+ export {
26
+ anchorRefAtom,
27
+ selectionAtom
28
+ };
29
+ //# sourceMappingURL=selection.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"selection.js","sources":["../../src/provider/selection.ts"],"sourcesContent":["import { atom } from \"jotai\";\nimport { interactionOptionsAtom } from \"./interactions.ts\";\nimport { storeAtom } from \"./core.ts\";\nimport type { Region } from \"@blueprintjs/table\";\n\n// The anchor for shift-range selection: the last row clicked without shift.\n// Reset when the selection is cleared elsewhere (e.g. the toolbar's ✕).\nexport const anchorRefAtom = atom<{ current: number | null }>({\n current: null,\n});\n\nexport const selectionAtom = atom(\n (get) => {\n if (!get(interactionOptionsAtom).enableSelection) return [];\n return get(storeAtom)?.selection ?? [];\n },\n (get, set, regions: Region[] = []) => {\n /** Don't do anything if selection isn't enabled */\n if (!get(interactionOptionsAtom).enableSelection) return;\n /** Reset the selection anchor ref */\n if (regions.length === 0) {\n get(anchorRefAtom).current = null;\n }\n set(storeAtom, (s) => ({\n ...s,\n selection: regions,\n focusedCell: null,\n topLeftCell: null,\n }));\n },\n);\n"],"names":[],"mappings":";;;AAOO,MAAM,gBAAgB,KAAiC;AAAA,EAC5D,SAAS;AACX,CAAC;AAEM,MAAM,gBAAgB;AAAA,EAC3B,CAAC,QAAQ;AACP,QAAI,CAAC,IAAI,sBAAsB,EAAE,wBAAwB,CAAA;AACzD,WAAO,IAAI,SAAS,GAAG,aAAa,CAAA;AAAA,EACtC;AAAA,EACA,CAAC,KAAK,KAAK,UAAoB,OAAO;AAEpC,QAAI,CAAC,IAAI,sBAAsB,EAAE,gBAAiB;AAElD,QAAI,QAAQ,WAAW,GAAG;AACxB,UAAI,aAAa,EAAE,UAAU;AAAA,IAC/B;AACA,QAAI,WAAW,CAAC,OAAO;AAAA,MACrB,GAAG;AAAA,MACH,WAAW;AAAA,MACX,aAAa;AAAA,MACb,aAAa;AAAA,IAAA,EACb;AAAA,EACJ;AACF;"}
@@ -0,0 +1,92 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
+ const types = require("./types.cjs");
4
+ const jotai = require("jotai");
5
+ function createLocalProvider(data, options = {}) {
6
+ const identity = options.identity ?? defaultLocalIdentity;
7
+ return {
8
+ identity,
9
+ async fetchData({ offset, limit, sorts, filters }) {
10
+ let rows = data;
11
+ if (filters != null && filters.length > 0) {
12
+ rows = rows.filter(
13
+ (row) => filters.every(
14
+ (f) => f.predicate != null ? f.predicate(row, f.state) : true
15
+ )
16
+ );
17
+ }
18
+ if (sorts != null && sorts.length > 0) {
19
+ rows = [...rows].sort(compareRowsBySorts(sorts));
20
+ }
21
+ return {
22
+ rows: rows.slice(offset, offset + limit),
23
+ totalCount: rows.length
24
+ };
25
+ }
26
+ };
27
+ }
28
+ const _syntheticRowIds = /* @__PURE__ */ new WeakMap();
29
+ let _syntheticRowCounter = 0;
30
+ function defaultLocalIdentity(row) {
31
+ if (row == null) return void 0;
32
+ if (row.id != null) return row.id;
33
+ if (typeof row !== "object") return row;
34
+ let id = _syntheticRowIds.get(row);
35
+ if (id == null) {
36
+ id = `__row_${_syntheticRowCounter++}`;
37
+ _syntheticRowIds.set(row, id);
38
+ }
39
+ return id;
40
+ }
41
+ function compareRowsBySorts(sorts) {
42
+ return (a, b) => {
43
+ for (const sort of sorts) {
44
+ const av = a?.[sort.key];
45
+ const bv = b?.[sort.key];
46
+ if (av == null && bv == null) continue;
47
+ if (av == null) return sort.ascending ? -1 : 1;
48
+ if (bv == null) return sort.ascending ? 1 : -1;
49
+ const cmp = av < bv ? -1 : av > bv ? 1 : 0;
50
+ if (cmp !== 0) return sort.ascending ? cmp : -cmp;
51
+ }
52
+ return 0;
53
+ };
54
+ }
55
+ const dataRefreshTokenAtom = jotai.atom(0);
56
+ async function persistViaProvider(provider, ctx) {
57
+ const base = ctx.data ?? [];
58
+ const updates = ctx.updatedData ?? [];
59
+ const status = ctx.rowStatus ?? [];
60
+ const n = Math.max(base.length, updates.length, status.length);
61
+ const toSave = [];
62
+ const toInsert = [];
63
+ const toDelete = [];
64
+ for (let i = 0; i < n; i++) {
65
+ if (status[i] === types.TableElementStatus.DELETED) {
66
+ const id = provider.identity(base[i]);
67
+ if (id != null) toDelete.push(id);
68
+ continue;
69
+ }
70
+ const upd = updates[i];
71
+ const hasEdit = upd != null && typeof upd === "object" && Object.keys(upd).length > 0;
72
+ if (status[i] === types.TableElementStatus.ADDED) {
73
+ toInsert.push({ ...base[i], ...upd });
74
+ } else if (hasEdit) {
75
+ toSave.push({ ...base[i], ...upd });
76
+ }
77
+ }
78
+ if (toDelete.length > 0 && provider.deleteRows != null) {
79
+ await provider.deleteRows(toDelete);
80
+ }
81
+ for (const row of toInsert) {
82
+ if (provider.insertRow != null) await provider.insertRow(row);
83
+ }
84
+ if (toSave.length > 0 && provider.saveRows != null) {
85
+ await provider.saveRows(toSave);
86
+ }
87
+ }
88
+ exports.compareRowsBySorts = compareRowsBySorts;
89
+ exports.createLocalProvider = createLocalProvider;
90
+ exports.dataRefreshTokenAtom = dataRefreshTokenAtom;
91
+ exports.persistViaProvider = persistViaProvider;
92
+ //# sourceMappingURL=table-data.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"table-data.cjs","sources":["../../src/provider/table-data.ts"],"sourcesContent":["import { ColumnSort, TableElementStatus } from \"./types.ts\";\nimport { atom } from \"jotai\";\nimport { TableActionContext } from \"../actions\";\n\n/** The active view state (a filter's id / column / config), passed to a\n * `fetchChunk`. A server provider translates `columnKey` + `state` into a\n * query; a local (in-memory) provider applies `predicate` directly. Both come\n * from the same `TableFilter`, so one filter definition serves either target. */\nexport interface FetchDataFilter {\n id: string;\n columnKey?: string;\n state: any;\n /** Client-side row predicate (from the `TableFilter`). Server providers\n * ignore it and translate `columnKey` + `state` instead. */\n predicate?: (row: any, state: any) => boolean;\n}\n\n/** Parameters passed to a `fetchChunk` implementation for one window. */\nexport interface FetchDataParams {\n /** Row offset of the requested chunk (chunk-aligned). */\n offset: number;\n /** Maximum rows to return. */\n limit: number;\n /** Aborts when the request is superseded (view change / unmount). */\n signal: AbortSignal;\n /** Active sorts, in priority order. */\n sorts: ColumnSort[];\n /** Active filters (id + column + config). */\n filters: FetchDataFilter[];\n /** In scroll mode, the already-loaded row immediately before this chunk\n * (and its data-array index), or `null` at the start / in paged mode. Keyset\n * sources can page from this cursor (e.g. `WHERE key > cursor`) instead of a\n * slow `OFFSET`; offset-based sources can ignore it. */\n cursor?: { row: any; index: number } | null;\n}\n\n/** Result of a `fetchChunk` call. `totalCount` reports the source length when\n * known (drives sparse-array pre-sizing and a proportional scrollbar); omit it\n * for unknown-length sources (the array grows as chunks arrive). */\nexport interface FetchDataResult<T = any> {\n rows: T[];\n totalCount?: number | null;\n}\n\nexport type FetchData<T = any> = (\n params: FetchDataParams,\n) => Promise<FetchDataResult<T>>;\n\n/**\n * A table's data source, addressed uniformly whether it's an in-memory array or\n * a remote backend. `fetchChunk` returns a window with the active sorts/filters\n * already applied (in memory by the local provider, in SQL by a server one);\n * `identity` addresses a row for edits/mutations — stable across re-sorts,\n * unlike an array index. The mutation ops are present only for editable /\n * persisting sources. The in-memory case (`createLocalProvider`) is just the\n * degenerate implementation, so local and server tables share one path.\n */\nexport interface TableDataProvider<T = any> {\n fetchData(params: FetchDataParams): Promise<FetchDataResult<T>>;\n identity(row: T): string | number;\n saveRows?(rows: T[]): Promise<void>;\n deleteRows?(ids: Array<string | number>): Promise<void>;\n insertRow?(row: Partial<T>): Promise<void>;\n}\n\n/**\n * The degenerate provider: an in-memory array. `fetchChunk` applies the active\n * filter predicates and sorts over the array and returns the requested slice\n * plus the (fully-known) total — the same view engine used for client-side\n * tables, expressed as a provider.\n */\nexport function createLocalProvider<T = any>(\n data: T[],\n options: { identity?: (row: T) => string | number } = {},\n): TableDataProvider<T> {\n const identity: any = options.identity ?? defaultLocalIdentity;\n\n return {\n identity,\n async fetchData({ offset, limit, sorts, filters }) {\n let rows = data;\n if (filters != null && filters.length > 0) {\n rows = rows.filter((row) =>\n filters.every((f) =>\n f.predicate != null ? f.predicate(row, f.state) : true,\n ),\n );\n }\n if (sorts != null && sorts.length > 0) {\n rows = [...rows].sort(compareRowsBySorts(sorts));\n }\n return {\n rows: rows.slice(offset, offset + limit),\n totalCount: rows.length,\n };\n },\n };\n}\n\n// Stable synthetic identity for in-memory rows lacking a natural `id`. Keyed by\n// object reference (a local data array keeps the same row objects across\n// re-sorts), so edits survive re-ordering even without an id field.\nconst _syntheticRowIds = new WeakMap<object, string>();\nlet _syntheticRowCounter = 0;\n\nfunction defaultLocalIdentity(row: any): string | number | undefined {\n if (row == null) return undefined;\n if (row.id != null) return row.id;\n if (typeof row !== \"object\") return row;\n let id = _syntheticRowIds.get(row);\n if (id == null) {\n id = `__row_${_syntheticRowCounter++}`;\n _syntheticRowIds.set(row, id);\n }\n return id;\n}\n\n/** Multi-key row comparator (priority order; nulls first when ascending),\n * shared by the local provider and any other in-memory sort. */\nexport function compareRowsBySorts(sorts: ColumnSort[]) {\n return (a: any, b: any): number => {\n for (const sort of sorts) {\n const av = a?.[sort.key];\n const bv = b?.[sort.key];\n if (av == null && bv == null) continue;\n if (av == null) return sort.ascending ? -1 : 1;\n if (bv == null) return sort.ascending ? 1 : -1;\n const cmp = av < bv ? -1 : av > bv ? 1 : 0;\n if (cmp !== 0) return sort.ascending ? cmp : -cmp;\n }\n return 0;\n };\n}\n\n/** Bump this to force the active chunk loader to reset and re-fetch from\n * scratch — e.g. after a mutation (save/delete) that invalidates loaded rows. */\nexport const dataRefreshTokenAtom = atom(0);\n\n/** Persist all pending changes through a data provider: added rows via\n * `insertRow`, edited rows via `saveRows`, deleted rows via `deleteRows`\n * (addressed by `provider.identity`). Used by the built-in Save action when an\n * explicit provider owns persistence. */\nexport async function persistViaProvider<T>(\n provider: TableDataProvider<T>,\n ctx: TableActionContext<T>,\n): Promise<void> {\n const base = (ctx.data ?? []) as any[];\n const updates = (ctx.updatedData ?? []) as any[];\n const status = (ctx.rowStatus ?? []) as any[];\n const n = Math.max(base.length, updates.length, status.length);\n const toSave: T[] = [];\n const toInsert: T[] = [];\n const toDelete: Array<string | number> = [];\n for (let i = 0; i < n; i++) {\n if (status[i] === TableElementStatus.DELETED) {\n const id = provider.identity(base[i]);\n if (id != null) toDelete.push(id);\n continue;\n }\n const upd = updates[i];\n const hasEdit =\n upd != null && typeof upd === \"object\" && Object.keys(upd).length > 0;\n if (status[i] === TableElementStatus.ADDED) {\n toInsert.push({ ...base[i], ...upd } as T);\n } else if (hasEdit) {\n toSave.push({ ...base[i], ...upd } as T);\n }\n }\n if (toDelete.length > 0 && provider.deleteRows != null) {\n await provider.deleteRows(toDelete);\n }\n for (const row of toInsert) {\n if (provider.insertRow != null) await provider.insertRow(row);\n }\n if (toSave.length > 0 && provider.saveRows != null) {\n await provider.saveRows(toSave);\n }\n}\n"],"names":["atom","TableElementStatus"],"mappings":";;;;AAuEO,SAAS,oBACd,MACA,UAAsD,IAChC;AACtB,QAAM,WAAgB,QAAQ,YAAY;AAE1C,SAAO;AAAA,IACL;AAAA,IACA,MAAM,UAAU,EAAE,QAAQ,OAAO,OAAO,WAAW;AACjD,UAAI,OAAO;AACX,UAAI,WAAW,QAAQ,QAAQ,SAAS,GAAG;AACzC,eAAO,KAAK;AAAA,UAAO,CAAC,QAClB,QAAQ;AAAA,YAAM,CAAC,MACb,EAAE,aAAa,OAAO,EAAE,UAAU,KAAK,EAAE,KAAK,IAAI;AAAA,UAAA;AAAA,QACpD;AAAA,MAEJ;AACA,UAAI,SAAS,QAAQ,MAAM,SAAS,GAAG;AACrC,eAAO,CAAC,GAAG,IAAI,EAAE,KAAK,mBAAmB,KAAK,CAAC;AAAA,MACjD;AACA,aAAO;AAAA,QACL,MAAM,KAAK,MAAM,QAAQ,SAAS,KAAK;AAAA,QACvC,YAAY,KAAK;AAAA,MAAA;AAAA,IAErB;AAAA,EAAA;AAEJ;AAKA,MAAM,uCAAuB,QAAA;AAC7B,IAAI,uBAAuB;AAE3B,SAAS,qBAAqB,KAAuC;AACnE,MAAI,OAAO,KAAM,QAAO;AACxB,MAAI,IAAI,MAAM,KAAM,QAAO,IAAI;AAC/B,MAAI,OAAO,QAAQ,SAAU,QAAO;AACpC,MAAI,KAAK,iBAAiB,IAAI,GAAG;AACjC,MAAI,MAAM,MAAM;AACd,SAAK,SAAS,sBAAsB;AACpC,qBAAiB,IAAI,KAAK,EAAE;AAAA,EAC9B;AACA,SAAO;AACT;AAIO,SAAS,mBAAmB,OAAqB;AACtD,SAAO,CAAC,GAAQ,MAAmB;AACjC,eAAW,QAAQ,OAAO;AACxB,YAAM,KAAK,IAAI,KAAK,GAAG;AACvB,YAAM,KAAK,IAAI,KAAK,GAAG;AACvB,UAAI,MAAM,QAAQ,MAAM,KAAM;AAC9B,UAAI,MAAM,KAAM,QAAO,KAAK,YAAY,KAAK;AAC7C,UAAI,MAAM,KAAM,QAAO,KAAK,YAAY,IAAI;AAC5C,YAAM,MAAM,KAAK,KAAK,KAAK,KAAK,KAAK,IAAI;AACzC,UAAI,QAAQ,EAAG,QAAO,KAAK,YAAY,MAAM,CAAC;AAAA,IAChD;AACA,WAAO;AAAA,EACT;AACF;AAIO,MAAM,uBAAuBA,MAAAA,KAAK,CAAC;AAM1C,eAAsB,mBACpB,UACA,KACe;AACf,QAAM,OAAQ,IAAI,QAAQ,CAAA;AAC1B,QAAM,UAAW,IAAI,eAAe,CAAA;AACpC,QAAM,SAAU,IAAI,aAAa,CAAA;AACjC,QAAM,IAAI,KAAK,IAAI,KAAK,QAAQ,QAAQ,QAAQ,OAAO,MAAM;AAC7D,QAAM,SAAc,CAAA;AACpB,QAAM,WAAgB,CAAA;AACtB,QAAM,WAAmC,CAAA;AACzC,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,QAAI,OAAO,CAAC,MAAMC,MAAAA,mBAAmB,SAAS;AAC5C,YAAM,KAAK,SAAS,SAAS,KAAK,CAAC,CAAC;AACpC,UAAI,MAAM,KAAM,UAAS,KAAK,EAAE;AAChC;AAAA,IACF;AACA,UAAM,MAAM,QAAQ,CAAC;AACrB,UAAM,UACJ,OAAO,QAAQ,OAAO,QAAQ,YAAY,OAAO,KAAK,GAAG,EAAE,SAAS;AACtE,QAAI,OAAO,CAAC,MAAMA,MAAAA,mBAAmB,OAAO;AAC1C,eAAS,KAAK,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,KAAU;AAAA,IAC3C,WAAW,SAAS;AAClB,aAAO,KAAK,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,KAAU;AAAA,IACzC;AAAA,EACF;AACA,MAAI,SAAS,SAAS,KAAK,SAAS,cAAc,MAAM;AACtD,UAAM,SAAS,WAAW,QAAQ;AAAA,EACpC;AACA,aAAW,OAAO,UAAU;AAC1B,QAAI,SAAS,aAAa,KAAM,OAAM,SAAS,UAAU,GAAG;AAAA,EAC9D;AACA,MAAI,OAAO,SAAS,KAAK,SAAS,YAAY,MAAM;AAClD,UAAM,SAAS,SAAS,MAAM;AAAA,EAChC;AACF;;;;;"}
@@ -0,0 +1,81 @@
1
+ import { ColumnSort } from './types.ts';
2
+ import { TableActionContext } from '../actions';
3
+ /** The active view state (a filter's id / column / config), passed to a
4
+ * `fetchChunk`. A server provider translates `columnKey` + `state` into a
5
+ * query; a local (in-memory) provider applies `predicate` directly. Both come
6
+ * from the same `TableFilter`, so one filter definition serves either target. */
7
+ export interface FetchDataFilter {
8
+ id: string;
9
+ columnKey?: string;
10
+ state: any;
11
+ /** Client-side row predicate (from the `TableFilter`). Server providers
12
+ * ignore it and translate `columnKey` + `state` instead. */
13
+ predicate?: (row: any, state: any) => boolean;
14
+ }
15
+ /** Parameters passed to a `fetchChunk` implementation for one window. */
16
+ export interface FetchDataParams {
17
+ /** Row offset of the requested chunk (chunk-aligned). */
18
+ offset: number;
19
+ /** Maximum rows to return. */
20
+ limit: number;
21
+ /** Aborts when the request is superseded (view change / unmount). */
22
+ signal: AbortSignal;
23
+ /** Active sorts, in priority order. */
24
+ sorts: ColumnSort[];
25
+ /** Active filters (id + column + config). */
26
+ filters: FetchDataFilter[];
27
+ /** In scroll mode, the already-loaded row immediately before this chunk
28
+ * (and its data-array index), or `null` at the start / in paged mode. Keyset
29
+ * sources can page from this cursor (e.g. `WHERE key > cursor`) instead of a
30
+ * slow `OFFSET`; offset-based sources can ignore it. */
31
+ cursor?: {
32
+ row: any;
33
+ index: number;
34
+ } | null;
35
+ }
36
+ /** Result of a `fetchChunk` call. `totalCount` reports the source length when
37
+ * known (drives sparse-array pre-sizing and a proportional scrollbar); omit it
38
+ * for unknown-length sources (the array grows as chunks arrive). */
39
+ export interface FetchDataResult<T = any> {
40
+ rows: T[];
41
+ totalCount?: number | null;
42
+ }
43
+ export type FetchData<T = any> = (params: FetchDataParams) => Promise<FetchDataResult<T>>;
44
+ /**
45
+ * A table's data source, addressed uniformly whether it's an in-memory array or
46
+ * a remote backend. `fetchChunk` returns a window with the active sorts/filters
47
+ * already applied (in memory by the local provider, in SQL by a server one);
48
+ * `identity` addresses a row for edits/mutations — stable across re-sorts,
49
+ * unlike an array index. The mutation ops are present only for editable /
50
+ * persisting sources. The in-memory case (`createLocalProvider`) is just the
51
+ * degenerate implementation, so local and server tables share one path.
52
+ */
53
+ export interface TableDataProvider<T = any> {
54
+ fetchData(params: FetchDataParams): Promise<FetchDataResult<T>>;
55
+ identity(row: T): string | number;
56
+ saveRows?(rows: T[]): Promise<void>;
57
+ deleteRows?(ids: Array<string | number>): Promise<void>;
58
+ insertRow?(row: Partial<T>): Promise<void>;
59
+ }
60
+ /**
61
+ * The degenerate provider: an in-memory array. `fetchChunk` applies the active
62
+ * filter predicates and sorts over the array and returns the requested slice
63
+ * plus the (fully-known) total — the same view engine used for client-side
64
+ * tables, expressed as a provider.
65
+ */
66
+ export declare function createLocalProvider<T = any>(data: T[], options?: {
67
+ identity?: (row: T) => string | number;
68
+ }): TableDataProvider<T>;
69
+ /** Multi-key row comparator (priority order; nulls first when ascending),
70
+ * shared by the local provider and any other in-memory sort. */
71
+ export declare function compareRowsBySorts(sorts: ColumnSort[]): (a: any, b: any) => number;
72
+ /** Bump this to force the active chunk loader to reset and re-fetch from
73
+ * scratch — e.g. after a mutation (save/delete) that invalidates loaded rows. */
74
+ export declare const dataRefreshTokenAtom: import('jotai').PrimitiveAtom<number> & {
75
+ init: number;
76
+ };
77
+ /** Persist all pending changes through a data provider: added rows via
78
+ * `insertRow`, edited rows via `saveRows`, deleted rows via `deleteRows`
79
+ * (addressed by `provider.identity`). Used by the built-in Save action when an
80
+ * explicit provider owns persistence. */
81
+ export declare function persistViaProvider<T>(provider: TableDataProvider<T>, ctx: TableActionContext<T>): Promise<void>;