@macrostrat/data-sheet 4.0.0-dev2 → 4.0.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 (212) hide show
  1. package/CHANGELOG.md +66 -0
  2. package/README.md +44 -0
  3. package/dist/actions/builtin.cjs +36 -5
  4. package/dist/actions/builtin.cjs.map +1 -1
  5. package/dist/actions/builtin.d.ts +3 -2
  6. package/dist/actions/builtin.js +36 -5
  7. package/dist/actions/builtin.js.map +1 -1
  8. package/dist/actions/column-controls.cjs +149 -0
  9. package/dist/actions/column-controls.cjs.map +1 -0
  10. package/dist/actions/column-controls.d.ts +11 -0
  11. package/dist/actions/column-controls.js +147 -0
  12. package/dist/actions/column-controls.js.map +1 -0
  13. package/dist/actions/column-filter.cjs +68 -0
  14. package/dist/actions/column-filter.cjs.map +1 -0
  15. package/dist/actions/column-filter.d.ts +11 -0
  16. package/dist/actions/column-filter.js +66 -0
  17. package/dist/actions/column-filter.js.map +1 -0
  18. package/dist/actions/edit-actions.cjs +42 -0
  19. package/dist/actions/edit-actions.cjs.map +1 -0
  20. package/dist/actions/edit-actions.d.ts +14 -0
  21. package/dist/actions/edit-actions.js +42 -0
  22. package/dist/actions/edit-actions.js.map +1 -0
  23. package/dist/actions/filters.cjs +39 -23
  24. package/dist/actions/filters.cjs.map +1 -1
  25. package/dist/actions/filters.d.ts +6 -3
  26. package/dist/actions/filters.js +41 -25
  27. package/dist/actions/filters.js.map +1 -1
  28. package/dist/actions/index.d.ts +4 -0
  29. package/dist/actions/selection.cjs +39 -30
  30. package/dist/actions/selection.cjs.map +1 -1
  31. package/dist/actions/selection.d.ts +3 -7
  32. package/dist/actions/selection.js +39 -30
  33. package/dist/actions/selection.js.map +1 -1
  34. package/dist/actions/table-controls.cjs +41 -0
  35. package/dist/actions/table-controls.cjs.map +1 -0
  36. package/dist/actions/table-controls.d.ts +4 -0
  37. package/dist/actions/table-controls.js +39 -0
  38. package/dist/actions/table-controls.js.map +1 -0
  39. package/dist/actions/toolbar.cjs +69 -10
  40. package/dist/actions/toolbar.cjs.map +1 -1
  41. package/dist/actions/toolbar.d.ts +9 -6
  42. package/dist/actions/toolbar.js +69 -10
  43. package/dist/actions/toolbar.js.map +1 -1
  44. package/dist/actions/toolbar.module.sass.cjs +12 -7
  45. package/dist/actions/toolbar.module.sass.cjs.map +1 -1
  46. package/dist/actions/toolbar.module.sass.js +12 -7
  47. package/dist/actions/toolbar.module.sass.js.map +1 -1
  48. package/dist/actions/types.d.ts +49 -4
  49. package/dist/cell-renderer.cjs +150 -14
  50. package/dist/cell-renderer.cjs.map +1 -1
  51. package/dist/cell-renderer.d.ts +1 -1
  52. package/dist/cell-renderer.js +151 -15
  53. package/dist/cell-renderer.js.map +1 -1
  54. package/dist/components/cell-detail.cjs +24 -0
  55. package/dist/components/cell-detail.cjs.map +1 -0
  56. package/dist/components/cell-detail.d.ts +12 -0
  57. package/dist/components/cell-detail.js +24 -0
  58. package/dist/components/cell-detail.js.map +1 -0
  59. package/dist/components/editor-popup.cjs +28 -24
  60. package/dist/components/editor-popup.cjs.map +1 -1
  61. package/dist/components/editor-popup.js +29 -25
  62. package/dist/components/editor-popup.js.map +1 -1
  63. package/dist/components/index.d.ts +2 -2
  64. package/dist/components/text-areas.cjs +51 -7
  65. package/dist/components/text-areas.cjs.map +1 -1
  66. package/dist/components/text-areas.d.ts +4 -1
  67. package/dist/components/text-areas.js +51 -7
  68. package/dist/components/text-areas.js.map +1 -1
  69. package/dist/components/view-info.cjs +46 -9
  70. package/dist/components/view-info.cjs.map +1 -1
  71. package/dist/components/view-info.d.ts +5 -1
  72. package/dist/components/view-info.js +47 -10
  73. package/dist/components/view-info.js.map +1 -1
  74. package/dist/core.cjs +167 -73
  75. package/dist/core.cjs.map +1 -1
  76. package/dist/core.d.ts +53 -6
  77. package/dist/core.js +169 -75
  78. package/dist/core.js.map +1 -1
  79. package/dist/data-sheet.css +72 -123
  80. package/dist/filters/operators.cjs +91 -0
  81. package/dist/filters/operators.cjs.map +1 -0
  82. package/dist/filters/operators.d.ts +17 -0
  83. package/dist/filters/operators.js +91 -0
  84. package/dist/filters/operators.js.map +1 -0
  85. package/dist/index.cjs +38 -10
  86. package/dist/index.cjs.map +1 -1
  87. package/dist/index.d.ts +2 -0
  88. package/dist/index.js +44 -16
  89. package/dist/index.js.map +1 -1
  90. package/dist/main.module.sass.cjs +13 -12
  91. package/dist/main.module.sass.cjs.map +1 -1
  92. package/dist/main.module.sass.js +13 -12
  93. package/dist/main.module.sass.js.map +1 -1
  94. package/dist/postgrest-table/data-loaders.cjs +255 -146
  95. package/dist/postgrest-table/data-loaders.cjs.map +1 -1
  96. package/dist/postgrest-table/data-loaders.d.ts +144 -46
  97. package/dist/postgrest-table/data-loaders.js +259 -150
  98. package/dist/postgrest-table/data-loaders.js.map +1 -1
  99. package/dist/postgrest-table/index.cjs +58 -169
  100. package/dist/postgrest-table/index.cjs.map +1 -1
  101. package/dist/postgrest-table/index.d.ts +5 -2
  102. package/dist/postgrest-table/index.js +63 -174
  103. package/dist/postgrest-table/index.js.map +1 -1
  104. package/dist/postgrest-table/loading-utils.cjs +0 -4
  105. package/dist/postgrest-table/loading-utils.cjs.map +1 -1
  106. package/dist/postgrest-table/loading-utils.js +1 -5
  107. package/dist/postgrest-table/loading-utils.js.map +1 -1
  108. package/dist/postgrest-table/main.module.sass.cjs +14 -13
  109. package/dist/postgrest-table/main.module.sass.cjs.map +1 -1
  110. package/dist/postgrest-table/main.module.sass.js +14 -13
  111. package/dist/postgrest-table/main.module.sass.js.map +1 -1
  112. package/dist/provider.cjs +68 -11
  113. package/dist/provider.cjs.map +1 -1
  114. package/dist/provider.d.ts +25 -0
  115. package/dist/provider.js +68 -11
  116. package/dist/provider.js.map +1 -1
  117. package/dist/renderers/column-header-cell.cjs +95 -75
  118. package/dist/renderers/column-header-cell.cjs.map +1 -1
  119. package/dist/renderers/column-header-cell.d.ts +3 -18
  120. package/dist/renderers/column-header-cell.js +98 -78
  121. package/dist/renderers/column-header-cell.js.map +1 -1
  122. package/dist/renderers/index.d.ts +0 -1
  123. package/dist/types.cjs +2 -0
  124. package/dist/types.cjs.map +1 -1
  125. package/dist/types.d.ts +84 -1
  126. package/dist/types.js +2 -0
  127. package/dist/types.js.map +1 -1
  128. package/dist/utils/column-spec.cjs.map +1 -1
  129. package/dist/utils/column-spec.d.ts +101 -1
  130. package/dist/utils/column-spec.js.map +1 -1
  131. package/dist/utils/debug-overlay.cjs +24 -0
  132. package/dist/utils/debug-overlay.cjs.map +1 -0
  133. package/dist/utils/debug-overlay.d.ts +4 -0
  134. package/dist/utils/debug-overlay.js +24 -0
  135. package/dist/utils/debug-overlay.js.map +1 -0
  136. package/dist/utils/index.cjs.map +1 -1
  137. package/dist/utils/index.d.ts +2 -0
  138. package/dist/utils/index.js.map +1 -1
  139. package/dist/utils/key-handling.cjs +52 -6
  140. package/dist/utils/key-handling.cjs.map +1 -1
  141. package/dist/utils/key-handling.js +52 -6
  142. package/dist/utils/key-handling.js.map +1 -1
  143. package/dist/utils/validation.cjs +41 -0
  144. package/dist/utils/validation.cjs.map +1 -0
  145. package/dist/utils/validation.d.ts +26 -0
  146. package/dist/utils/validation.js +41 -0
  147. package/dist/utils/validation.js.map +1 -0
  148. package/dist/zustand-store.cjs +119 -61
  149. package/dist/zustand-store.cjs.map +1 -1
  150. package/dist/zustand-store.js +121 -63
  151. package/dist/zustand-store.js.map +1 -1
  152. package/package.json +6 -6
  153. package/src/actions/builtin.ts +62 -7
  154. package/src/actions/column-controls.ts +185 -0
  155. package/src/actions/column-filter.ts +104 -0
  156. package/src/actions/edit-actions.ts +67 -0
  157. package/src/actions/filters.ts +54 -28
  158. package/src/actions/index.ts +4 -0
  159. package/src/actions/selection.ts +59 -52
  160. package/src/actions/table-controls.ts +46 -0
  161. package/src/actions/toolbar.module.sass +22 -2
  162. package/src/actions/toolbar.ts +113 -16
  163. package/src/actions/types.ts +49 -4
  164. package/src/cell-renderer.ts +211 -16
  165. package/src/components/cell-detail.ts +30 -0
  166. package/src/components/editor-popup.ts +39 -25
  167. package/src/components/index.ts +2 -2
  168. package/src/components/text-areas.ts +80 -16
  169. package/src/components/view-info.ts +63 -4
  170. package/src/core.ts +321 -103
  171. package/src/filters/operators.ts +127 -0
  172. package/src/index.ts +2 -0
  173. package/src/main.module.sass +6 -0
  174. package/src/postgrest-table/data-loaders.ts +459 -209
  175. package/src/postgrest-table/index.ts +81 -254
  176. package/src/postgrest-table/main.module.sass +11 -0
  177. package/src/provider.ts +109 -12
  178. package/src/renderers/column-header-cell.ts +60 -272
  179. package/src/renderers/index.ts +0 -1
  180. package/src/types.ts +76 -2
  181. package/src/utils/column-spec.ts +112 -1
  182. package/src/utils/debug-overlay.ts +22 -0
  183. package/src/utils/index.ts +2 -0
  184. package/src/utils/key-handling.ts +70 -6
  185. package/src/utils/validation.ts +72 -0
  186. package/src/zustand-store.ts +167 -60
  187. package/dist/components/actions.cjs +0 -12
  188. package/dist/components/actions.cjs.map +0 -1
  189. package/dist/components/actions.d.ts +0 -2
  190. package/dist/components/actions.js +0 -12
  191. package/dist/components/actions.js.map +0 -1
  192. package/dist/components/actions.module.sass.cjs +0 -12
  193. package/dist/components/actions.module.sass.cjs.map +0 -1
  194. package/dist/components/actions.module.sass.js +0 -11
  195. package/dist/components/actions.module.sass.js.map +0 -1
  196. package/dist/postgrest-table/lazy-loader-table.cjs +0 -27
  197. package/dist/postgrest-table/lazy-loader-table.cjs.map +0 -1
  198. package/dist/postgrest-table/lazy-loader-table.d.ts +0 -3
  199. package/dist/postgrest-table/lazy-loader-table.js +0 -27
  200. package/dist/postgrest-table/lazy-loader-table.js.map +0 -1
  201. package/dist/renderers/column-header-cell-postgrest.cjs +0 -216
  202. package/dist/renderers/column-header-cell-postgrest.cjs.map +0 -1
  203. package/dist/renderers/column-header-cell-postgrest.d.ts +0 -13
  204. package/dist/renderers/column-header-cell-postgrest.js +0 -216
  205. package/dist/renderers/column-header-cell-postgrest.js.map +0 -1
  206. package/dist/renderers/column-header-cell-postgrest.module.sass.cjs +0 -23
  207. package/dist/renderers/column-header-cell-postgrest.module.sass.cjs.map +0 -1
  208. package/dist/renderers/column-header-cell-postgrest.module.sass.js +0 -22
  209. package/dist/renderers/column-header-cell-postgrest.module.sass.js.map +0 -1
  210. package/src/components/actions.ts +0 -9
  211. package/src/postgrest-table/lazy-loader-table.ts +0 -25
  212. package/src/renderers/column-header-cell-postgrest.ts +0 -282
@@ -7,10 +7,34 @@ const provider = require("../provider.cjs");
7
7
  const selection = require("./selection.cjs");
8
8
  const table = require("@blueprintjs/table");
9
9
  const notifications = require("../notifications.cjs");
10
- function ActionsToolbar({ actions }) {
10
+ function selectionTitle(ctx) {
11
+ const sh = ctx.selectionShape;
12
+ switch (sh.cardinality) {
13
+ case table.RegionCardinality.FULL_COLUMNS: {
14
+ if (ctx.columnKey != null) {
15
+ const col = ctx.columnSpec.find((c) => c.key === ctx.columnKey);
16
+ return col?.name ?? "Column";
17
+ }
18
+ return `${sh.columns} columns`;
19
+ }
20
+ case table.RegionCardinality.FULL_ROWS:
21
+ return ctx.rowIndex != null ? "1 row" : `${sh.rows} rows`;
22
+ case table.RegionCardinality.CELLS:
23
+ return ctx.cell != null ? "Cell" : `${sh.columns}×${sh.rows} cells`;
24
+ case table.RegionCardinality.FULL_TABLE:
25
+ return null;
26
+ default:
27
+ return null;
28
+ }
29
+ }
30
+ function ActionsToolbar({
31
+ actions,
32
+ tableName
33
+ }) {
11
34
  const selection$1 = provider.useSelector((state) => state.selection);
12
35
  const editable = provider.useSelector((state) => state.editable);
13
36
  const columnSpec = provider.useSelector((state) => state.columnSpec);
37
+ const storeAPI = provider.useStoreAPI();
14
38
  const cardinality = react.useMemo(
15
39
  () => selection.getSelectionCardinality(selection$1) ?? table.RegionCardinality.FULL_TABLE,
16
40
  [selection$1]
@@ -23,17 +47,31 @@ function ActionsToolbar({ actions }) {
23
47
  () => selection.getApplicableActions(allActions, cardinality, editable),
24
48
  [allActions, cardinality, editable]
25
49
  );
26
- if (applicableActions.length === 0) return null;
27
- return toolbar_module.default(
28
- "div.actions-toolbar",
50
+ const ctx = selection.buildActionContext(
51
+ storeAPI.getState(),
52
+ storeAPI.setState
53
+ );
54
+ const shownActions = applicableActions.filter(
55
+ (action) => action.hotkey == null && (action.appliesTo?.(ctx) ?? true)
56
+ );
57
+ const toolbarIsShown = react.useMemo(
58
+ () => hasAnyDisplayableActions(actions, columnSpec),
59
+ [actions, columnSpec]
60
+ );
61
+ if (!toolbarIsShown) {
62
+ return null;
63
+ }
64
+ const title = selectionTitle(ctx) ?? tableName ?? "Table";
65
+ return toolbar_module.default("div.actions-toolbar", [
66
+ toolbar_module.default("span.toolbar-title", { key: "title" }, title),
29
67
  toolbar_module.default(
30
68
  core.ButtonGroup,
31
- { minimal: true },
32
- applicableActions.map(
33
- (action) => toolbar_module.default(ActionButton, { key: action.id, action })
69
+ { key: "actions", minimal: true },
70
+ shownActions.map(
71
+ (action) => toolbar_module.default(ActionButton, { key: action.id, action, ctx })
34
72
  )
35
73
  )
36
- );
74
+ ]);
37
75
  }
38
76
  function getMessageForError(e) {
39
77
  if (e instanceof Error) return e.message;
@@ -58,7 +96,7 @@ function runActionWrapper(action, state, setState, toaster, configState = void 0
58
96
  return;
59
97
  }
60
98
  try {
61
- const res = action.run(ctx, configState);
99
+ const res = action.run?.(ctx, configState);
62
100
  if (res instanceof Promise) {
63
101
  res.then(() => {
64
102
  }).catch((e) => {
@@ -69,7 +107,16 @@ function runActionWrapper(action, state, setState, toaster, configState = void 0
69
107
  displayErrorForAction(action, e, toaster);
70
108
  }
71
109
  }
72
- function ActionButton({ action }) {
110
+ function ActionButton({
111
+ action,
112
+ ctx
113
+ }) {
114
+ if (action.render != null) {
115
+ return action.render(ctx);
116
+ }
117
+ return toolbar_module.default(RunActionButton, { action });
118
+ }
119
+ function RunActionButton({ action }) {
73
120
  const storeAPI = provider.useStoreAPI();
74
121
  const toaster = notifications.useToaster();
75
122
  const isDisabled = provider.useSelector((state) => {
@@ -166,6 +213,18 @@ function ActionButtonWithForm({
166
213
  )
167
214
  );
168
215
  }
216
+ function hasAnyDisplayableActions(actions, columnSpec) {
217
+ const allActions = [
218
+ ...actions,
219
+ ...columnSpec.flatMap((c) => c.actions ?? [])
220
+ ];
221
+ if (allActions.length === 0) {
222
+ return false;
223
+ }
224
+ return allActions.some(
225
+ (action) => action.hotkey == null && !isActionDisabled(action, {})
226
+ );
227
+ }
169
228
  exports.ActionsToolbar = ActionsToolbar;
170
229
  exports.runActionWrapper = runActionWrapper;
171
230
  //# sourceMappingURL=toolbar.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"toolbar.cjs","sources":["../../src/actions/toolbar.ts"],"sourcesContent":["import { Button, ButtonGroup, PopoverNext } from \"@blueprintjs/core\";\nimport { useCallback, useMemo, useState } from \"react\";\nimport h from \"./toolbar.module.sass\";\nimport { useSelector, useStoreAPI } from \"../provider\";\nimport {\n buildActionContext,\n getApplicableActions,\n getSelectionCardinality,\n mergeColumnActions,\n} from \"./selection\";\nimport type { TableAction, TableActionContext } from \"./types\";\nimport { RegionCardinality } from \"@blueprintjs/table\";\nimport { useToaster } from \"../notifications.ts\";\nimport { DataSheetStore } from \"../types.ts\";\n\n/** Toolbar that renders applicable table actions based on the\n * current selection cardinality and edit mode.\n * Automatically merges column-specific actions from `ColumnSpec.actions`\n * when the corresponding columns are in the selection. */\nexport function ActionsToolbar<T>({ actions }: { actions: TableAction<T>[] }) {\n const selection = useSelector((state) => state.selection);\n const editable = useSelector((state) => state.editable);\n const columnSpec = useSelector((state) => state.columnSpec);\n\n const cardinality = useMemo(\n () => getSelectionCardinality(selection) ?? RegionCardinality.FULL_TABLE,\n [selection],\n );\n\n // Merge global actions with column-specific actions from the selection\n const allActions = useMemo(\n () => mergeColumnActions(actions, columnSpec, selection),\n [actions, columnSpec, selection],\n );\n\n const applicableActions = useMemo(\n () => getApplicableActions(allActions, cardinality, editable),\n [allActions, cardinality, editable],\n );\n\n if (applicableActions.length === 0) return null;\n\n return h(\n \"div.actions-toolbar\",\n h(\n ButtonGroup,\n { minimal: true },\n applicableActions.map((action) =>\n h(ActionButton, { key: action.id, action }),\n ),\n ),\n );\n}\n\nfunction getMessageForError(e: any) {\n if (e instanceof Error) return e.message;\n if (typeof e === \"string\") return e;\n if (e instanceof Object) return JSON.stringify(e);\n return null;\n}\n\nfunction isActionDisabled(action: TableAction, state: any): boolean {\n if (typeof action.disabled === \"boolean\") return action.disabled;\n if (typeof action.disabled === \"function\") {\n return action.disabled(state);\n }\n return false;\n}\n\nexport function runActionWrapper<T>(\n action: TableAction<T>,\n state: DataSheetStore<any>,\n setState: (state: Partial<DataSheetStore<any>>) => void,\n toaster: any,\n configState: any = undefined,\n) {\n const ctx = buildActionContext(state, setState) as TableActionContext<T>;\n if (action.disabled instanceof Function) {\n if (action.disabled(ctx)) {\n return;\n }\n } else if (action.disabled) {\n return;\n }\n try {\n const res = action.run(ctx, configState);\n if (res instanceof Promise) {\n res\n .then(() => {})\n .catch((e) => {\n displayErrorForAction(action, e, toaster);\n });\n }\n } catch (e) {\n displayErrorForAction(action, e, toaster);\n }\n}\n\n/** A single action button. Handles both simple actions (direct click)\n * and actions with a `detailsForm` (popover with config + run). */\nfunction ActionButton<T>({ action }: { action: TableAction<T> }) {\n const storeAPI = useStoreAPI();\n const toaster = useToaster();\n\n // Reactive disabled check — re-renders when relevant state changes\n const isDisabled = useSelector((state) => {\n return isActionDisabled(action, state);\n });\n\n const runAction = useCallback(\n (configState?: any) => {\n runActionWrapper(\n action,\n storeAPI.getState(),\n storeAPI.setState,\n toaster,\n configState,\n );\n },\n [storeAPI, action, toaster],\n );\n\n if (action.detailsForm != null) {\n return h(ActionButtonWithForm, { action, runAction, isDisabled });\n }\n\n return h(\n Button,\n {\n icon: action.icon,\n intent: action.intent,\n disabled: isDisabled,\n onClick() {\n runAction();\n },\n },\n action.name,\n );\n}\n\nfunction displayErrorForAction(action: TableAction, error: any, toaster: any) {\n const message =\n getMessageForError(error) ?? action.errorMessage ?? \"Action failed\";\n toaster.show({\n message,\n intent: \"danger\",\n });\n}\n\n/** Action button that opens a popover for pre-run configuration. */\nfunction ActionButtonWithForm<T, S>({\n action,\n runAction,\n isDisabled,\n}: {\n action: TableAction<T, S>;\n runAction: (configState?: S) => void;\n isDisabled: boolean;\n}) {\n const [configState, setConfigState] = useState<S>(\n action.defaultState ?? (null as S),\n );\n const [isOpen, setIsOpen] = useState(false);\n\n let ready = true;\n if (action.isReady != null) {\n ready = action.isReady(configState);\n }\n\n return h(\n PopoverNext,\n {\n isOpen,\n onClose: () => setIsOpen(false),\n content: h(\"div.action-popover-content\", [\n h.if(action.description != null)(\"p.description\", action.description),\n h(action.detailsForm, {\n state: configState,\n setState: setConfigState,\n }),\n h(\n Button,\n {\n className: \"run-button\",\n intent: action.intent ?? \"primary\",\n icon: \"play\",\n disabled: !ready,\n fill: true,\n onClick() {\n runAction(configState);\n setIsOpen(false);\n },\n },\n \"Run\",\n ),\n ]),\n placement: \"bottom-start\",\n enforceFocus: false,\n autoFocus: false,\n },\n h(\n Button,\n {\n icon: action.icon,\n intent: action.intent,\n disabled: isDisabled,\n onClick: () => setIsOpen(!isOpen),\n },\n action.name,\n ),\n );\n}\n"],"names":["selection","useSelector","useMemo","getSelectionCardinality","RegionCardinality","mergeColumnActions","getApplicableActions","h","ButtonGroup","buildActionContext","useStoreAPI","useToaster","useCallback","Button","useState","PopoverNext"],"mappings":"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"}
1
+ {"version":3,"file":"toolbar.cjs","sources":["../../src/actions/toolbar.ts"],"sourcesContent":["import { Button, ButtonGroup, PopoverNext } from \"@blueprintjs/core\";\nimport { useCallback, useMemo, useState } from \"react\";\nimport h from \"./toolbar.module.sass\";\nimport { useSelector, useStoreAPI } from \"../provider\";\nimport {\n buildActionContext,\n getApplicableActions,\n getSelectionCardinality,\n mergeColumnActions,\n} from \"./selection\";\nimport type { TableAction, TableActionContext } from \"./types\";\nimport { RegionCardinality } from \"@blueprintjs/table\";\nimport { useToaster } from \"../notifications.ts\";\nimport { DataSheetStore } from \"../types.ts\";\nimport { ColumnSpec } from \"../utils\";\n\n/** A short title describing the current selection (its shape), shown as the\n * toolbar's leading label — no icon. */\nfunction selectionTitle<T>(ctx: TableActionContext<T>): string | null {\n const sh = ctx.selectionShape;\n switch (sh.cardinality) {\n case RegionCardinality.FULL_COLUMNS: {\n if (ctx.columnKey != null) {\n const col = ctx.columnSpec.find((c) => c.key === ctx.columnKey);\n return col?.name ?? \"Column\";\n }\n return `${sh.columns} columns`;\n }\n case RegionCardinality.FULL_ROWS:\n return ctx.rowIndex != null ? \"1 row\" : `${sh.rows} rows`;\n case RegionCardinality.CELLS:\n return ctx.cell != null ? \"Cell\" : `${sh.columns}×${sh.rows} cells`;\n case RegionCardinality.FULL_TABLE:\n return null;\n default:\n return null;\n }\n}\n\n/** Toolbar that renders the actions/controls applicable to the current\n * selection cardinality (modal by selection) and edit mode. Actions with a\n * `render` show their live control; others show a button (with an optional\n * `detailsForm` popover). Column-specific actions from `ColumnSpec.actions`\n * are merged when their columns are selected. A capsule on the left shows the\n * current selection polarity. */\nexport function ActionsToolbar<T>({\n actions,\n tableName,\n}: {\n actions: TableAction<T>[];\n tableName?: string;\n}) {\n const selection = useSelector((state) => state.selection);\n const editable = useSelector((state) => state.editable);\n const columnSpec = useSelector((state) => state.columnSpec);\n const storeAPI = useStoreAPI();\n\n const cardinality = useMemo(\n () => getSelectionCardinality(selection) ?? RegionCardinality.FULL_TABLE,\n [selection],\n );\n\n // Merge global actions with column-specific actions from the selection\n const allActions = useMemo(\n () => mergeColumnActions(actions, columnSpec, selection),\n [actions, columnSpec, selection],\n );\n\n const applicableActions = useMemo(\n () => getApplicableActions(allActions, cardinality, editable),\n [allActions, cardinality, editable],\n );\n\n // Context for `render`-style controls (they subscribe to the store\n // themselves; this resolves the selected column/rows).\n const ctx = buildActionContext(\n storeAPI.getState(),\n storeAPI.setState,\n ) as TableActionContext<T>;\n\n // The toolbar is for actions that AREN'T keyboard-accessible: any action\n // with a `hotkey` (copy/cut/paste, etc.) is reachable from the keyboard and\n // is omitted here (it still works via its shortcut). Then refine by selection\n // shape beyond cardinality (e.g. single column only).\n const shownActions = applicableActions.filter(\n (action) => action.hotkey == null && (action.appliesTo?.(ctx) ?? true),\n );\n\n const toolbarIsShown = useMemo(\n () => hasAnyDisplayableActions(actions, columnSpec),\n [actions, columnSpec],\n );\n\n if (!toolbarIsShown) {\n return null;\n }\n\n // The toolbar is always mounted if actions are available, so it can't flicker\n // in/out as the selection or action set changes — the container is stable;\n // only its contents (title + buttons) change. Avoids layout jank.\n const title = selectionTitle(ctx) ?? tableName ?? \"Table\";\n\n return h(\"div.actions-toolbar\", [\n h(\"span.toolbar-title\", { key: \"title\" }, title),\n h(\n ButtonGroup,\n { key: \"actions\", minimal: true },\n shownActions.map((action) =>\n h(ActionButton, { key: action.id, action, ctx }),\n ),\n ),\n ]);\n}\n\nfunction getMessageForError(e: any) {\n if (e instanceof Error) return e.message;\n if (typeof e === \"string\") return e;\n if (e instanceof Object) return JSON.stringify(e);\n return null;\n}\n\nfunction isActionDisabled(action: TableAction, state: any): boolean {\n if (typeof action.disabled === \"boolean\") return action.disabled;\n if (typeof action.disabled === \"function\") {\n return action.disabled(state);\n }\n return false;\n}\n\nexport function runActionWrapper<T>(\n action: TableAction<T>,\n state: DataSheetStore<any>,\n setState: (state: Partial<DataSheetStore<any>>) => void,\n toaster: any,\n configState: any = undefined,\n) {\n const ctx = buildActionContext(state, setState) as TableActionContext<T>;\n if (action.disabled instanceof Function) {\n if (action.disabled(ctx)) {\n return;\n }\n } else if (action.disabled) {\n return;\n }\n try {\n const res = action.run?.(ctx, configState);\n if (res instanceof Promise) {\n res\n .then(() => {})\n .catch((e) => {\n displayErrorForAction(action, e, toaster);\n });\n }\n } catch (e) {\n displayErrorForAction(action, e, toaster);\n }\n}\n\n/** Dispatcher: a live control (`action.render`) or a run/detailsForm button.\n * Kept hook-free so the two paths don't share a hook order. */\nfunction ActionButton<T>({\n action,\n ctx,\n}: {\n action: TableAction<T>;\n ctx: TableActionContext<T>;\n}) {\n if (action.render != null) {\n return action.render(ctx) as any;\n }\n return h(RunActionButton, { action });\n}\n\n/** A run/detailsForm action rendered as a button. */\nfunction RunActionButton<T>({ action }: { action: TableAction<T> }) {\n const storeAPI = useStoreAPI();\n const toaster = useToaster();\n\n // Reactive disabled check — re-renders when relevant state changes\n const isDisabled = useSelector((state) => {\n return isActionDisabled(action, state);\n });\n\n const runAction = useCallback(\n (configState?: any) => {\n runActionWrapper(\n action,\n storeAPI.getState(),\n storeAPI.setState,\n toaster,\n configState,\n );\n },\n [storeAPI, action, toaster],\n );\n\n if (action.detailsForm != null) {\n return h(ActionButtonWithForm, { action, runAction, isDisabled });\n }\n\n return h(\n Button,\n {\n icon: action.icon,\n intent: action.intent,\n disabled: isDisabled,\n onClick() {\n runAction();\n },\n },\n action.name,\n );\n}\n\nfunction displayErrorForAction(action: TableAction, error: any, toaster: any) {\n const message =\n getMessageForError(error) ?? action.errorMessage ?? \"Action failed\";\n toaster.show({\n message,\n intent: \"danger\",\n });\n}\n\n/** Action button that opens a popover for pre-run configuration. */\nfunction ActionButtonWithForm<T, S>({\n action,\n runAction,\n isDisabled,\n}: {\n action: TableAction<T, S>;\n runAction: (configState?: S) => void;\n isDisabled: boolean;\n}) {\n const [configState, setConfigState] = useState<S>(\n action.defaultState ?? (null as S),\n );\n const [isOpen, setIsOpen] = useState(false);\n\n let ready = true;\n if (action.isReady != null) {\n ready = action.isReady(configState);\n }\n\n return h(\n PopoverNext,\n {\n isOpen,\n onClose: () => setIsOpen(false),\n content: h(\"div.action-popover-content\", [\n h.if(action.description != null)(\"p.description\", action.description),\n h(action.detailsForm, {\n state: configState,\n setState: setConfigState,\n }),\n h(\n Button,\n {\n className: \"run-button\",\n intent: action.intent ?? \"primary\",\n icon: \"play\",\n disabled: !ready,\n fill: true,\n onClick() {\n runAction(configState);\n setIsOpen(false);\n },\n },\n \"Run\",\n ),\n ]),\n placement: \"bottom-start\",\n enforceFocus: false,\n autoFocus: false,\n },\n h(\n Button,\n {\n icon: action.icon,\n intent: action.intent,\n disabled: isDisabled,\n onClick: () => setIsOpen(!isOpen),\n },\n action.name,\n ),\n );\n}\n\nfunction hasAnyDisplayableActions(\n actions: TableAction[],\n columnSpec: ColumnSpec[],\n) {\n /** Check whether there are any actions that can be displayed in the toolbar.\n * for the entire table. This is used to determine whether the toolbar should\n * be rendered. If any actions are available, the toolbar is rendered in ALL\n * selection modes to avoid flickering\n */\n const allActions = [\n ...actions,\n ...columnSpec.flatMap((c) => c.actions ?? []),\n ];\n\n if (allActions.length === 0) {\n return false;\n }\n // Check whether any action doesn't have hotkey and is not disabled\n return allActions.some(\n (action) => action.hotkey == null && !isActionDisabled(action, {}),\n );\n}\n"],"names":["RegionCardinality","selection","useSelector","useStoreAPI","useMemo","getSelectionCardinality","mergeColumnActions","getApplicableActions","buildActionContext","h","ButtonGroup","useToaster","useCallback","Button","useState","PopoverNext"],"mappings":";;;;;;;;;AAkBA,SAAS,eAAkB,KAA2C;AACpE,QAAM,KAAK,IAAI;AACf,UAAQ,GAAG,aAAA;AAAA,IACT,KAAKA,MAAAA,kBAAkB,cAAc;AACnC,UAAI,IAAI,aAAa,MAAM;AACzB,cAAM,MAAM,IAAI,WAAW,KAAK,CAAC,MAAM,EAAE,QAAQ,IAAI,SAAS;AAC9D,eAAO,KAAK,QAAQ;AAAA,MACtB;AACA,aAAO,GAAG,GAAG,OAAO;AAAA,IACtB;AAAA,IACA,KAAKA,MAAAA,kBAAkB;AACrB,aAAO,IAAI,YAAY,OAAO,UAAU,GAAG,GAAG,IAAI;AAAA,IACpD,KAAKA,MAAAA,kBAAkB;AACrB,aAAO,IAAI,QAAQ,OAAO,SAAS,GAAG,GAAG,OAAO,IAAI,GAAG,IAAI;AAAA,IAC7D,KAAKA,MAAAA,kBAAkB;AACrB,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EAAA;AAEb;AAQO,SAAS,eAAkB;AAAA,EAChC;AAAA,EACA;AACF,GAGG;AACD,QAAMC,cAAYC,SAAAA,YAAY,CAAC,UAAU,MAAM,SAAS;AACxD,QAAM,WAAWA,SAAAA,YAAY,CAAC,UAAU,MAAM,QAAQ;AACtD,QAAM,aAAaA,SAAAA,YAAY,CAAC,UAAU,MAAM,UAAU;AAC1D,QAAM,WAAWC,SAAAA,YAAA;AAEjB,QAAM,cAAcC,MAAAA;AAAAA,IAClB,MAAMC,kCAAwBJ,WAAS,KAAKD,MAAAA,kBAAkB;AAAA,IAC9D,CAACC,WAAS;AAAA,EAAA;AAIZ,QAAM,aAAaG,MAAAA;AAAAA,IACjB,MAAME,6BAAmB,SAAS,YAAYL,WAAS;AAAA,IACvD,CAAC,SAAS,YAAYA,WAAS;AAAA,EAAA;AAGjC,QAAM,oBAAoBG,MAAAA;AAAAA,IACxB,MAAMG,+BAAqB,YAAY,aAAa,QAAQ;AAAA,IAC5D,CAAC,YAAY,aAAa,QAAQ;AAAA,EAAA;AAKpC,QAAM,MAAMC,UAAAA;AAAAA,IACV,SAAS,SAAA;AAAA,IACT,SAAS;AAAA,EAAA;AAOX,QAAM,eAAe,kBAAkB;AAAA,IACrC,CAAC,WAAW,OAAO,UAAU,SAAS,OAAO,YAAY,GAAG,KAAK;AAAA,EAAA;AAGnE,QAAM,iBAAiBJ,MAAAA;AAAAA,IACrB,MAAM,yBAAyB,SAAS,UAAU;AAAA,IAClD,CAAC,SAAS,UAAU;AAAA,EAAA;AAGtB,MAAI,CAAC,gBAAgB;AACnB,WAAO;AAAA,EACT;AAKA,QAAM,QAAQ,eAAe,GAAG,KAAK,aAAa;AAElD,SAAOK,eAAAA,QAAE,uBAAuB;AAAA,IAC9BA,eAAAA,QAAE,sBAAsB,EAAE,KAAK,QAAA,GAAW,KAAK;AAAA,IAC/CA,eAAAA;AAAAA,MACEC,KAAAA;AAAAA,MACA,EAAE,KAAK,WAAW,SAAS,KAAA;AAAA,MAC3B,aAAa;AAAA,QAAI,CAAC,WAChBD,eAAAA,QAAE,cAAc,EAAE,KAAK,OAAO,IAAI,QAAQ,IAAA,CAAK;AAAA,MAAA;AAAA,IACjD;AAAA,EACF,CACD;AACH;AAEA,SAAS,mBAAmB,GAAQ;AAClC,MAAI,aAAa,MAAO,QAAO,EAAE;AACjC,MAAI,OAAO,MAAM,SAAU,QAAO;AAClC,MAAI,aAAa,OAAQ,QAAO,KAAK,UAAU,CAAC;AAChD,SAAO;AACT;AAEA,SAAS,iBAAiB,QAAqB,OAAqB;AAClE,MAAI,OAAO,OAAO,aAAa,kBAAkB,OAAO;AACxD,MAAI,OAAO,OAAO,aAAa,YAAY;AACzC,WAAO,OAAO,SAAS,KAAK;AAAA,EAC9B;AACA,SAAO;AACT;AAEO,SAAS,iBACd,QACA,OACA,UACA,SACA,cAAmB,QACnB;AACA,QAAM,MAAMD,UAAAA,mBAAmB,OAAO,QAAQ;AAC9C,MAAI,OAAO,oBAAoB,UAAU;AACvC,QAAI,OAAO,SAAS,GAAG,GAAG;AACxB;AAAA,IACF;AAAA,EACF,WAAW,OAAO,UAAU;AAC1B;AAAA,EACF;AACA,MAAI;AACF,UAAM,MAAM,OAAO,MAAM,KAAK,WAAW;AACzC,QAAI,eAAe,SAAS;AAC1B,UACG,KAAK,MAAM;AAAA,MAAC,CAAC,EACb,MAAM,CAAC,MAAM;AACZ,8BAAsB,QAAQ,GAAG,OAAO;AAAA,MAC1C,CAAC;AAAA,IACL;AAAA,EACF,SAAS,GAAG;AACV,0BAAsB,QAAQ,GAAG,OAAO;AAAA,EAC1C;AACF;AAIA,SAAS,aAAgB;AAAA,EACvB;AAAA,EACA;AACF,GAGG;AACD,MAAI,OAAO,UAAU,MAAM;AACzB,WAAO,OAAO,OAAO,GAAG;AAAA,EAC1B;AACA,SAAOC,uBAAE,iBAAiB,EAAE,QAAQ;AACtC;AAGA,SAAS,gBAAmB,EAAE,UAAsC;AAClE,QAAM,WAAWN,SAAAA,YAAA;AACjB,QAAM,UAAUQ,cAAAA,WAAA;AAGhB,QAAM,aAAaT,qBAAY,CAAC,UAAU;AACxC,WAAO,iBAAiB,QAAQ,KAAK;AAAA,EACvC,CAAC;AAED,QAAM,YAAYU,MAAAA;AAAAA,IAChB,CAAC,gBAAsB;AACrB;AAAA,QACE;AAAA,QACA,SAAS,SAAA;AAAA,QACT,SAAS;AAAA,QACT;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ;AAAA,IACA,CAAC,UAAU,QAAQ,OAAO;AAAA,EAAA;AAG5B,MAAI,OAAO,eAAe,MAAM;AAC9B,WAAOH,eAAAA,QAAE,sBAAsB,EAAE,QAAQ,WAAW,YAAY;AAAA,EAClE;AAEA,SAAOA,eAAAA;AAAAA,IACLI,KAAAA;AAAAA,IACA;AAAA,MACE,MAAM,OAAO;AAAA,MACb,QAAQ,OAAO;AAAA,MACf,UAAU;AAAA,MACV,UAAU;AACR,kBAAA;AAAA,MACF;AAAA,IAAA;AAAA,IAEF,OAAO;AAAA,EAAA;AAEX;AAEA,SAAS,sBAAsB,QAAqB,OAAY,SAAc;AAC5E,QAAM,UACJ,mBAAmB,KAAK,KAAK,OAAO,gBAAgB;AACtD,UAAQ,KAAK;AAAA,IACX;AAAA,IACA,QAAQ;AAAA,EAAA,CACT;AACH;AAGA,SAAS,qBAA2B;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,QAAM,CAAC,aAAa,cAAc,IAAIC,MAAAA;AAAAA,IACpC,OAAO,gBAAiB;AAAA,EAAA;AAE1B,QAAM,CAAC,QAAQ,SAAS,IAAIA,MAAAA,SAAS,KAAK;AAE1C,MAAI,QAAQ;AACZ,MAAI,OAAO,WAAW,MAAM;AAC1B,YAAQ,OAAO,QAAQ,WAAW;AAAA,EACpC;AAEA,SAAOL,eAAAA;AAAAA,IACLM,KAAAA;AAAAA,IACA;AAAA,MACE;AAAA,MACA,SAAS,MAAM,UAAU,KAAK;AAAA,MAC9B,SAASN,eAAAA,QAAE,8BAA8B;AAAA,QACvCA,uBAAE,GAAG,OAAO,eAAe,IAAI,EAAE,iBAAiB,OAAO,WAAW;AAAA,QACpEA,eAAAA,QAAE,OAAO,aAAa;AAAA,UACpB,OAAO;AAAA,UACP,UAAU;AAAA,QAAA,CACX;AAAA,QACDA,eAAAA;AAAAA,UACEI,KAAAA;AAAAA,UACA;AAAA,YACE,WAAW;AAAA,YACX,QAAQ,OAAO,UAAU;AAAA,YACzB,MAAM;AAAA,YACN,UAAU,CAAC;AAAA,YACX,MAAM;AAAA,YACN,UAAU;AACR,wBAAU,WAAW;AACrB,wBAAU,KAAK;AAAA,YACjB;AAAA,UAAA;AAAA,UAEF;AAAA,QAAA;AAAA,MACF,CACD;AAAA,MACD,WAAW;AAAA,MACX,cAAc;AAAA,MACd,WAAW;AAAA,IAAA;AAAA,IAEbJ,eAAAA;AAAAA,MACEI,KAAAA;AAAAA,MACA;AAAA,QACE,MAAM,OAAO;AAAA,QACb,QAAQ,OAAO;AAAA,QACf,UAAU;AAAA,QACV,SAAS,MAAM,UAAU,CAAC,MAAM;AAAA,MAAA;AAAA,MAElC,OAAO;AAAA,IAAA;AAAA,EACT;AAEJ;AAEA,SAAS,yBACP,SACA,YACA;AAMA,QAAM,aAAa;AAAA,IACjB,GAAG;AAAA,IACH,GAAG,WAAW,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA,CAAE;AAAA,EAAA;AAG9C,MAAI,WAAW,WAAW,GAAG;AAC3B,WAAO;AAAA,EACT;AAEA,SAAO,WAAW;AAAA,IAChB,CAAC,WAAW,OAAO,UAAU,QAAQ,CAAC,iBAAiB,QAAQ,CAAA,CAAE;AAAA,EAAA;AAErE;;;"}
@@ -1,10 +1,13 @@
1
1
  import { TableAction } from './types';
2
2
  import { DataSheetStore } from '../types.ts';
3
- /** Toolbar that renders applicable table actions based on the
4
- * current selection cardinality and edit mode.
5
- * Automatically merges column-specific actions from `ColumnSpec.actions`
6
- * when the corresponding columns are in the selection. */
7
- export declare function ActionsToolbar<T>({ actions }: {
3
+ /** Toolbar that renders the actions/controls applicable to the current
4
+ * selection cardinality (modal by selection) and edit mode. Actions with a
5
+ * `render` show their live control; others show a button (with an optional
6
+ * `detailsForm` popover). Column-specific actions from `ColumnSpec.actions`
7
+ * are merged when their columns are selected. A capsule on the left shows the
8
+ * current selection polarity. */
9
+ export declare function ActionsToolbar<T>({ actions, tableName, }: {
8
10
  actions: TableAction<T>[];
9
- }): import('react').ReactElement<import('react').FunctionComponentElement<import('@blueprintjs/core').ButtonGroupProps>, string | import('react').JSXElementConstructor<any>> | null;
11
+ tableName?: string;
12
+ }): import('react').DOMElement<import('react').DOMAttributes<Element>, Element> | null;
10
13
  export declare function runActionWrapper<T>(action: TableAction<T>, state: DataSheetStore<any>, setState: (state: Partial<DataSheetStore<any>>) => void, toaster: any, configState?: any): void;
@@ -5,10 +5,34 @@ import { useSelector, useStoreAPI } from "../provider.js";
5
5
  import { getSelectionCardinality, mergeColumnActions, getApplicableActions, buildActionContext } from "./selection.js";
6
6
  import { RegionCardinality } from "@blueprintjs/table";
7
7
  import { useToaster } from "../notifications.js";
8
- function ActionsToolbar({ actions }) {
8
+ function selectionTitle(ctx) {
9
+ const sh = ctx.selectionShape;
10
+ switch (sh.cardinality) {
11
+ case RegionCardinality.FULL_COLUMNS: {
12
+ if (ctx.columnKey != null) {
13
+ const col = ctx.columnSpec.find((c) => c.key === ctx.columnKey);
14
+ return col?.name ?? "Column";
15
+ }
16
+ return `${sh.columns} columns`;
17
+ }
18
+ case RegionCardinality.FULL_ROWS:
19
+ return ctx.rowIndex != null ? "1 row" : `${sh.rows} rows`;
20
+ case RegionCardinality.CELLS:
21
+ return ctx.cell != null ? "Cell" : `${sh.columns}×${sh.rows} cells`;
22
+ case RegionCardinality.FULL_TABLE:
23
+ return null;
24
+ default:
25
+ return null;
26
+ }
27
+ }
28
+ function ActionsToolbar({
29
+ actions,
30
+ tableName
31
+ }) {
9
32
  const selection = useSelector((state) => state.selection);
10
33
  const editable = useSelector((state) => state.editable);
11
34
  const columnSpec = useSelector((state) => state.columnSpec);
35
+ const storeAPI = useStoreAPI();
12
36
  const cardinality = useMemo(
13
37
  () => getSelectionCardinality(selection) ?? RegionCardinality.FULL_TABLE,
14
38
  [selection]
@@ -21,17 +45,31 @@ function ActionsToolbar({ actions }) {
21
45
  () => getApplicableActions(allActions, cardinality, editable),
22
46
  [allActions, cardinality, editable]
23
47
  );
24
- if (applicableActions.length === 0) return null;
25
- return h(
26
- "div.actions-toolbar",
48
+ const ctx = buildActionContext(
49
+ storeAPI.getState(),
50
+ storeAPI.setState
51
+ );
52
+ const shownActions = applicableActions.filter(
53
+ (action) => action.hotkey == null && (action.appliesTo?.(ctx) ?? true)
54
+ );
55
+ const toolbarIsShown = useMemo(
56
+ () => hasAnyDisplayableActions(actions, columnSpec),
57
+ [actions, columnSpec]
58
+ );
59
+ if (!toolbarIsShown) {
60
+ return null;
61
+ }
62
+ const title = selectionTitle(ctx) ?? tableName ?? "Table";
63
+ return h("div.actions-toolbar", [
64
+ h("span.toolbar-title", { key: "title" }, title),
27
65
  h(
28
66
  ButtonGroup,
29
- { minimal: true },
30
- applicableActions.map(
31
- (action) => h(ActionButton, { key: action.id, action })
67
+ { key: "actions", minimal: true },
68
+ shownActions.map(
69
+ (action) => h(ActionButton, { key: action.id, action, ctx })
32
70
  )
33
71
  )
34
- );
72
+ ]);
35
73
  }
36
74
  function getMessageForError(e) {
37
75
  if (e instanceof Error) return e.message;
@@ -56,7 +94,7 @@ function runActionWrapper(action, state, setState, toaster, configState = void 0
56
94
  return;
57
95
  }
58
96
  try {
59
- const res = action.run(ctx, configState);
97
+ const res = action.run?.(ctx, configState);
60
98
  if (res instanceof Promise) {
61
99
  res.then(() => {
62
100
  }).catch((e) => {
@@ -67,7 +105,16 @@ function runActionWrapper(action, state, setState, toaster, configState = void 0
67
105
  displayErrorForAction(action, e, toaster);
68
106
  }
69
107
  }
70
- function ActionButton({ action }) {
108
+ function ActionButton({
109
+ action,
110
+ ctx
111
+ }) {
112
+ if (action.render != null) {
113
+ return action.render(ctx);
114
+ }
115
+ return h(RunActionButton, { action });
116
+ }
117
+ function RunActionButton({ action }) {
71
118
  const storeAPI = useStoreAPI();
72
119
  const toaster = useToaster();
73
120
  const isDisabled = useSelector((state) => {
@@ -164,6 +211,18 @@ function ActionButtonWithForm({
164
211
  )
165
212
  );
166
213
  }
214
+ function hasAnyDisplayableActions(actions, columnSpec) {
215
+ const allActions = [
216
+ ...actions,
217
+ ...columnSpec.flatMap((c) => c.actions ?? [])
218
+ ];
219
+ if (allActions.length === 0) {
220
+ return false;
221
+ }
222
+ return allActions.some(
223
+ (action) => action.hotkey == null && !isActionDisabled(action, {})
224
+ );
225
+ }
167
226
  export {
168
227
  ActionsToolbar,
169
228
  runActionWrapper
@@ -1 +1 @@
1
- {"version":3,"file":"toolbar.js","sources":["../../src/actions/toolbar.ts"],"sourcesContent":["import { Button, ButtonGroup, PopoverNext } from \"@blueprintjs/core\";\nimport { useCallback, useMemo, useState } from \"react\";\nimport h from \"./toolbar.module.sass\";\nimport { useSelector, useStoreAPI } from \"../provider\";\nimport {\n buildActionContext,\n getApplicableActions,\n getSelectionCardinality,\n mergeColumnActions,\n} from \"./selection\";\nimport type { TableAction, TableActionContext } from \"./types\";\nimport { RegionCardinality } from \"@blueprintjs/table\";\nimport { useToaster } from \"../notifications.ts\";\nimport { DataSheetStore } from \"../types.ts\";\n\n/** Toolbar that renders applicable table actions based on the\n * current selection cardinality and edit mode.\n * Automatically merges column-specific actions from `ColumnSpec.actions`\n * when the corresponding columns are in the selection. */\nexport function ActionsToolbar<T>({ actions }: { actions: TableAction<T>[] }) {\n const selection = useSelector((state) => state.selection);\n const editable = useSelector((state) => state.editable);\n const columnSpec = useSelector((state) => state.columnSpec);\n\n const cardinality = useMemo(\n () => getSelectionCardinality(selection) ?? RegionCardinality.FULL_TABLE,\n [selection],\n );\n\n // Merge global actions with column-specific actions from the selection\n const allActions = useMemo(\n () => mergeColumnActions(actions, columnSpec, selection),\n [actions, columnSpec, selection],\n );\n\n const applicableActions = useMemo(\n () => getApplicableActions(allActions, cardinality, editable),\n [allActions, cardinality, editable],\n );\n\n if (applicableActions.length === 0) return null;\n\n return h(\n \"div.actions-toolbar\",\n h(\n ButtonGroup,\n { minimal: true },\n applicableActions.map((action) =>\n h(ActionButton, { key: action.id, action }),\n ),\n ),\n );\n}\n\nfunction getMessageForError(e: any) {\n if (e instanceof Error) return e.message;\n if (typeof e === \"string\") return e;\n if (e instanceof Object) return JSON.stringify(e);\n return null;\n}\n\nfunction isActionDisabled(action: TableAction, state: any): boolean {\n if (typeof action.disabled === \"boolean\") return action.disabled;\n if (typeof action.disabled === \"function\") {\n return action.disabled(state);\n }\n return false;\n}\n\nexport function runActionWrapper<T>(\n action: TableAction<T>,\n state: DataSheetStore<any>,\n setState: (state: Partial<DataSheetStore<any>>) => void,\n toaster: any,\n configState: any = undefined,\n) {\n const ctx = buildActionContext(state, setState) as TableActionContext<T>;\n if (action.disabled instanceof Function) {\n if (action.disabled(ctx)) {\n return;\n }\n } else if (action.disabled) {\n return;\n }\n try {\n const res = action.run(ctx, configState);\n if (res instanceof Promise) {\n res\n .then(() => {})\n .catch((e) => {\n displayErrorForAction(action, e, toaster);\n });\n }\n } catch (e) {\n displayErrorForAction(action, e, toaster);\n }\n}\n\n/** A single action button. Handles both simple actions (direct click)\n * and actions with a `detailsForm` (popover with config + run). */\nfunction ActionButton<T>({ action }: { action: TableAction<T> }) {\n const storeAPI = useStoreAPI();\n const toaster = useToaster();\n\n // Reactive disabled check — re-renders when relevant state changes\n const isDisabled = useSelector((state) => {\n return isActionDisabled(action, state);\n });\n\n const runAction = useCallback(\n (configState?: any) => {\n runActionWrapper(\n action,\n storeAPI.getState(),\n storeAPI.setState,\n toaster,\n configState,\n );\n },\n [storeAPI, action, toaster],\n );\n\n if (action.detailsForm != null) {\n return h(ActionButtonWithForm, { action, runAction, isDisabled });\n }\n\n return h(\n Button,\n {\n icon: action.icon,\n intent: action.intent,\n disabled: isDisabled,\n onClick() {\n runAction();\n },\n },\n action.name,\n );\n}\n\nfunction displayErrorForAction(action: TableAction, error: any, toaster: any) {\n const message =\n getMessageForError(error) ?? action.errorMessage ?? \"Action failed\";\n toaster.show({\n message,\n intent: \"danger\",\n });\n}\n\n/** Action button that opens a popover for pre-run configuration. */\nfunction ActionButtonWithForm<T, S>({\n action,\n runAction,\n isDisabled,\n}: {\n action: TableAction<T, S>;\n runAction: (configState?: S) => void;\n isDisabled: boolean;\n}) {\n const [configState, setConfigState] = useState<S>(\n action.defaultState ?? (null as S),\n );\n const [isOpen, setIsOpen] = useState(false);\n\n let ready = true;\n if (action.isReady != null) {\n ready = action.isReady(configState);\n }\n\n return h(\n PopoverNext,\n {\n isOpen,\n onClose: () => setIsOpen(false),\n content: h(\"div.action-popover-content\", [\n h.if(action.description != null)(\"p.description\", action.description),\n h(action.detailsForm, {\n state: configState,\n setState: setConfigState,\n }),\n h(\n Button,\n {\n className: \"run-button\",\n intent: action.intent ?? \"primary\",\n icon: \"play\",\n disabled: !ready,\n fill: true,\n onClick() {\n runAction(configState);\n setIsOpen(false);\n },\n },\n \"Run\",\n ),\n ]),\n placement: \"bottom-start\",\n enforceFocus: false,\n autoFocus: false,\n },\n h(\n Button,\n {\n icon: action.icon,\n intent: action.intent,\n disabled: isDisabled,\n onClick: () => setIsOpen(!isOpen),\n },\n action.name,\n ),\n );\n}\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"toolbar.js","sources":["../../src/actions/toolbar.ts"],"sourcesContent":["import { Button, ButtonGroup, PopoverNext } from \"@blueprintjs/core\";\nimport { useCallback, useMemo, useState } from \"react\";\nimport h from \"./toolbar.module.sass\";\nimport { useSelector, useStoreAPI } from \"../provider\";\nimport {\n buildActionContext,\n getApplicableActions,\n getSelectionCardinality,\n mergeColumnActions,\n} from \"./selection\";\nimport type { TableAction, TableActionContext } from \"./types\";\nimport { RegionCardinality } from \"@blueprintjs/table\";\nimport { useToaster } from \"../notifications.ts\";\nimport { DataSheetStore } from \"../types.ts\";\nimport { ColumnSpec } from \"../utils\";\n\n/** A short title describing the current selection (its shape), shown as the\n * toolbar's leading label — no icon. */\nfunction selectionTitle<T>(ctx: TableActionContext<T>): string | null {\n const sh = ctx.selectionShape;\n switch (sh.cardinality) {\n case RegionCardinality.FULL_COLUMNS: {\n if (ctx.columnKey != null) {\n const col = ctx.columnSpec.find((c) => c.key === ctx.columnKey);\n return col?.name ?? \"Column\";\n }\n return `${sh.columns} columns`;\n }\n case RegionCardinality.FULL_ROWS:\n return ctx.rowIndex != null ? \"1 row\" : `${sh.rows} rows`;\n case RegionCardinality.CELLS:\n return ctx.cell != null ? \"Cell\" : `${sh.columns}×${sh.rows} cells`;\n case RegionCardinality.FULL_TABLE:\n return null;\n default:\n return null;\n }\n}\n\n/** Toolbar that renders the actions/controls applicable to the current\n * selection cardinality (modal by selection) and edit mode. Actions with a\n * `render` show their live control; others show a button (with an optional\n * `detailsForm` popover). Column-specific actions from `ColumnSpec.actions`\n * are merged when their columns are selected. A capsule on the left shows the\n * current selection polarity. */\nexport function ActionsToolbar<T>({\n actions,\n tableName,\n}: {\n actions: TableAction<T>[];\n tableName?: string;\n}) {\n const selection = useSelector((state) => state.selection);\n const editable = useSelector((state) => state.editable);\n const columnSpec = useSelector((state) => state.columnSpec);\n const storeAPI = useStoreAPI();\n\n const cardinality = useMemo(\n () => getSelectionCardinality(selection) ?? RegionCardinality.FULL_TABLE,\n [selection],\n );\n\n // Merge global actions with column-specific actions from the selection\n const allActions = useMemo(\n () => mergeColumnActions(actions, columnSpec, selection),\n [actions, columnSpec, selection],\n );\n\n const applicableActions = useMemo(\n () => getApplicableActions(allActions, cardinality, editable),\n [allActions, cardinality, editable],\n );\n\n // Context for `render`-style controls (they subscribe to the store\n // themselves; this resolves the selected column/rows).\n const ctx = buildActionContext(\n storeAPI.getState(),\n storeAPI.setState,\n ) as TableActionContext<T>;\n\n // The toolbar is for actions that AREN'T keyboard-accessible: any action\n // with a `hotkey` (copy/cut/paste, etc.) is reachable from the keyboard and\n // is omitted here (it still works via its shortcut). Then refine by selection\n // shape beyond cardinality (e.g. single column only).\n const shownActions = applicableActions.filter(\n (action) => action.hotkey == null && (action.appliesTo?.(ctx) ?? true),\n );\n\n const toolbarIsShown = useMemo(\n () => hasAnyDisplayableActions(actions, columnSpec),\n [actions, columnSpec],\n );\n\n if (!toolbarIsShown) {\n return null;\n }\n\n // The toolbar is always mounted if actions are available, so it can't flicker\n // in/out as the selection or action set changes — the container is stable;\n // only its contents (title + buttons) change. Avoids layout jank.\n const title = selectionTitle(ctx) ?? tableName ?? \"Table\";\n\n return h(\"div.actions-toolbar\", [\n h(\"span.toolbar-title\", { key: \"title\" }, title),\n h(\n ButtonGroup,\n { key: \"actions\", minimal: true },\n shownActions.map((action) =>\n h(ActionButton, { key: action.id, action, ctx }),\n ),\n ),\n ]);\n}\n\nfunction getMessageForError(e: any) {\n if (e instanceof Error) return e.message;\n if (typeof e === \"string\") return e;\n if (e instanceof Object) return JSON.stringify(e);\n return null;\n}\n\nfunction isActionDisabled(action: TableAction, state: any): boolean {\n if (typeof action.disabled === \"boolean\") return action.disabled;\n if (typeof action.disabled === \"function\") {\n return action.disabled(state);\n }\n return false;\n}\n\nexport function runActionWrapper<T>(\n action: TableAction<T>,\n state: DataSheetStore<any>,\n setState: (state: Partial<DataSheetStore<any>>) => void,\n toaster: any,\n configState: any = undefined,\n) {\n const ctx = buildActionContext(state, setState) as TableActionContext<T>;\n if (action.disabled instanceof Function) {\n if (action.disabled(ctx)) {\n return;\n }\n } else if (action.disabled) {\n return;\n }\n try {\n const res = action.run?.(ctx, configState);\n if (res instanceof Promise) {\n res\n .then(() => {})\n .catch((e) => {\n displayErrorForAction(action, e, toaster);\n });\n }\n } catch (e) {\n displayErrorForAction(action, e, toaster);\n }\n}\n\n/** Dispatcher: a live control (`action.render`) or a run/detailsForm button.\n * Kept hook-free so the two paths don't share a hook order. */\nfunction ActionButton<T>({\n action,\n ctx,\n}: {\n action: TableAction<T>;\n ctx: TableActionContext<T>;\n}) {\n if (action.render != null) {\n return action.render(ctx) as any;\n }\n return h(RunActionButton, { action });\n}\n\n/** A run/detailsForm action rendered as a button. */\nfunction RunActionButton<T>({ action }: { action: TableAction<T> }) {\n const storeAPI = useStoreAPI();\n const toaster = useToaster();\n\n // Reactive disabled check — re-renders when relevant state changes\n const isDisabled = useSelector((state) => {\n return isActionDisabled(action, state);\n });\n\n const runAction = useCallback(\n (configState?: any) => {\n runActionWrapper(\n action,\n storeAPI.getState(),\n storeAPI.setState,\n toaster,\n configState,\n );\n },\n [storeAPI, action, toaster],\n );\n\n if (action.detailsForm != null) {\n return h(ActionButtonWithForm, { action, runAction, isDisabled });\n }\n\n return h(\n Button,\n {\n icon: action.icon,\n intent: action.intent,\n disabled: isDisabled,\n onClick() {\n runAction();\n },\n },\n action.name,\n );\n}\n\nfunction displayErrorForAction(action: TableAction, error: any, toaster: any) {\n const message =\n getMessageForError(error) ?? action.errorMessage ?? \"Action failed\";\n toaster.show({\n message,\n intent: \"danger\",\n });\n}\n\n/** Action button that opens a popover for pre-run configuration. */\nfunction ActionButtonWithForm<T, S>({\n action,\n runAction,\n isDisabled,\n}: {\n action: TableAction<T, S>;\n runAction: (configState?: S) => void;\n isDisabled: boolean;\n}) {\n const [configState, setConfigState] = useState<S>(\n action.defaultState ?? (null as S),\n );\n const [isOpen, setIsOpen] = useState(false);\n\n let ready = true;\n if (action.isReady != null) {\n ready = action.isReady(configState);\n }\n\n return h(\n PopoverNext,\n {\n isOpen,\n onClose: () => setIsOpen(false),\n content: h(\"div.action-popover-content\", [\n h.if(action.description != null)(\"p.description\", action.description),\n h(action.detailsForm, {\n state: configState,\n setState: setConfigState,\n }),\n h(\n Button,\n {\n className: \"run-button\",\n intent: action.intent ?? \"primary\",\n icon: \"play\",\n disabled: !ready,\n fill: true,\n onClick() {\n runAction(configState);\n setIsOpen(false);\n },\n },\n \"Run\",\n ),\n ]),\n placement: \"bottom-start\",\n enforceFocus: false,\n autoFocus: false,\n },\n h(\n Button,\n {\n icon: action.icon,\n intent: action.intent,\n disabled: isDisabled,\n onClick: () => setIsOpen(!isOpen),\n },\n action.name,\n ),\n );\n}\n\nfunction hasAnyDisplayableActions(\n actions: TableAction[],\n columnSpec: ColumnSpec[],\n) {\n /** Check whether there are any actions that can be displayed in the toolbar.\n * for the entire table. This is used to determine whether the toolbar should\n * be rendered. If any actions are available, the toolbar is rendered in ALL\n * selection modes to avoid flickering\n */\n const allActions = [\n ...actions,\n ...columnSpec.flatMap((c) => c.actions ?? []),\n ];\n\n if (allActions.length === 0) {\n return false;\n }\n // Check whether any action doesn't have hotkey and is not disabled\n return allActions.some(\n (action) => action.hotkey == null && !isActionDisabled(action, {}),\n );\n}\n"],"names":[],"mappings":"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"}
@@ -3,20 +3,25 @@ Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toString
3
3
  const h$1 = require("@macrostrat/hyper");
4
4
  const _interopDefault = (e) => e && e.__esModule ? e : { default: e };
5
5
  const h__default = /* @__PURE__ */ _interopDefault(h$1);
6
- const spacer = "_spacer_ja9qu_9";
7
- const description = "_description_ja9qu_17";
6
+ const spacer = "_spacer_hs7ht_17";
7
+ const description = "_description_hs7ht_25";
8
+ const group = "_group_hs7ht_45";
8
9
  const styles = {
9
- "actions-toolbar": "_actions-toolbar_ja9qu_1",
10
+ "actions-toolbar": "_actions-toolbar_hs7ht_1",
11
+ "toolbar-title": "_toolbar-title_hs7ht_11",
10
12
  spacer,
11
- "action-popover-content": "_action-popover-content_ja9qu_13",
12
- "filter-config": "_filter-config_ja9qu_13",
13
+ "action-popover-content": "_action-popover-content_hs7ht_21",
14
+ "filter-config": "_filter-config_hs7ht_21",
13
15
  description,
14
- "run-button": "_run-button_ja9qu_23",
15
- "filter-bar": "_filter-bar_ja9qu_28"
16
+ "run-button": "_run-button_hs7ht_31",
17
+ "filter-bar": "_filter-bar_hs7ht_36",
18
+ group,
19
+ "filter-window": "_filter-window_hs7ht_51"
16
20
  };
17
21
  let h = h__default.default.styled(styles);
18
22
  Object.assign(h, styles);
19
23
  exports.default = h;
20
24
  exports.description = description;
25
+ exports.group = group;
21
26
  exports.spacer = spacer;
22
27
  //# sourceMappingURL=toolbar.module.sass.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"toolbar.module.sass.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;"}
1
+ {"version":3,"file":"toolbar.module.sass.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;"}
@@ -1,20 +1,25 @@
1
1
  import h$1 from "@macrostrat/hyper";
2
- const spacer = "_spacer_ja9qu_9";
3
- const description = "_description_ja9qu_17";
2
+ const spacer = "_spacer_hs7ht_17";
3
+ const description = "_description_hs7ht_25";
4
+ const group = "_group_hs7ht_45";
4
5
  const styles = {
5
- "actions-toolbar": "_actions-toolbar_ja9qu_1",
6
+ "actions-toolbar": "_actions-toolbar_hs7ht_1",
7
+ "toolbar-title": "_toolbar-title_hs7ht_11",
6
8
  spacer,
7
- "action-popover-content": "_action-popover-content_ja9qu_13",
8
- "filter-config": "_filter-config_ja9qu_13",
9
+ "action-popover-content": "_action-popover-content_hs7ht_21",
10
+ "filter-config": "_filter-config_hs7ht_21",
9
11
  description,
10
- "run-button": "_run-button_ja9qu_23",
11
- "filter-bar": "_filter-bar_ja9qu_28"
12
+ "run-button": "_run-button_hs7ht_31",
13
+ "filter-bar": "_filter-bar_hs7ht_36",
14
+ group,
15
+ "filter-window": "_filter-window_hs7ht_51"
12
16
  };
13
17
  let h = h$1.styled(styles);
14
18
  Object.assign(h, styles);
15
19
  export {
16
20
  h as default,
17
21
  description,
22
+ group,
18
23
  spacer
19
24
  };
20
25
  //# sourceMappingURL=toolbar.module.sass.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"toolbar.module.sass.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;"}
1
+ {"version":3,"file":"toolbar.module.sass.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;"}
@@ -1,14 +1,24 @@
1
1
  import { IconName, Intent } from '@blueprintjs/core';
2
2
  import { Region, RegionCardinality } from '@blueprintjs/table';
3
- import { ComponentType } from 'react';
3
+ import { ComponentType, ReactNode } from 'react';
4
4
  import { ColumnSpec } from '../utils';
5
5
  import { ClipboardProxy, TableElementStatus } from '../types.ts';
6
6
  /** Selection cardinality including the case of no active selection */
7
7
  export type SelectionCardinality = RegionCardinality | "none";
8
+ /** The concrete *shape* of the current selection — richer than cardinality
9
+ * alone. The "single X" cases are exposed as resolved identity fields on the
10
+ * action context (`columnKey`, `rowIndex`, `cell`); this carries the counts. */
11
+ export interface SelectionShape {
12
+ cardinality: SelectionCardinality;
13
+ /** Number of columns the selection spans (0 when not column-scoped). */
14
+ columns: number;
15
+ /** Number of rows the selection spans (0 when not row-scoped). */
16
+ rows: number;
17
+ }
8
18
  /** A single cell edit, used with `editCells` for batch updates. */
9
19
  export interface CellEdit {
10
20
  rowIndex: number;
11
- columnKey: string;
21
+ column: string;
12
22
  value: any;
13
23
  }
14
24
  /** A column filter that can be activated to hide non-matching rows.
@@ -37,6 +47,10 @@ export interface TableFilter<T = any, S = any> {
37
47
  state: S;
38
48
  setState(state: S): void;
39
49
  }>;
50
+ /** Summarize the current filter state for display on the active-filter tag
51
+ * (e.g. the range `0–250` or the search term). Keep it short — the tag also
52
+ * shows the filter name. Return `null` to show just the name. */
53
+ describeState?: (state: S) => import('react').ReactNode;
40
54
  /** Row predicate: return `true` if the row should be visible.
41
55
  * Receives the merged row (updatedData overlaid on data). */
42
56
  predicate(row: T, state: S): boolean;
@@ -55,6 +69,23 @@ export interface TableActionContext<T = any> {
55
69
  selection: Region[];
56
70
  /** Derived cardinality of the current selection */
57
71
  selectionCardinality: SelectionCardinality;
72
+ /** Concrete shape of the current selection (cardinality + column/row counts). */
73
+ selectionShape: SelectionShape;
74
+ /** The single selected column's key when exactly one column is scoped
75
+ * (a single full column, or cells within one column); otherwise `null`. */
76
+ columnKey: string | null;
77
+ /** The single selected data-row index when exactly one row is scoped;
78
+ * otherwise `null`. */
79
+ rowIndex: number | null;
80
+ /** The single selected cell (data-row index + column key) when exactly one
81
+ * cell is selected; otherwise `null`. Presence of these resolved fields is
82
+ * how actions discriminate selection shape — e.g. `appliesTo: ctx =>
83
+ * ctx.cell != null` for a single-cell control, or `ctx.columnKey != null`
84
+ * within a `FULL_COLUMNS` target for a single-column control. */
85
+ cell: {
86
+ rowIndex: number;
87
+ columnKey: string;
88
+ } | null;
58
89
  /** The table's base data */
59
90
  data: T[];
60
91
  /** Sparse overlay of edited data */
@@ -65,6 +96,8 @@ export interface TableActionContext<T = any> {
65
96
  columnSpec: ColumnSpec[];
66
97
  /** Whether the table is in edit mode */
67
98
  editable: boolean;
99
+ /** Whether row deletion is available (false when the provider can't delete). */
100
+ canDeleteRows: boolean;
68
101
  /** Row indices covered by the current selection */
69
102
  getSelectedRowIndices(): number[];
70
103
  /** Column keys covered by the current selection */
@@ -115,6 +148,11 @@ export interface TableAction<T = any, S = null> {
115
148
  * matches any of these cardinalities. Use `"none"` for actions that
116
149
  * should be available even with no active selection. */
117
150
  targets: SelectionCardinality[];
151
+ /** Optional refinement beyond `targets`, inspecting the resolved selection
152
+ * identity. Return `false` to hide the action for a given shape — e.g. sort
153
+ * and filter return `ctx.columnKey != null` (within their `FULL_COLUMNS`
154
+ * target), so they appear only for a single column. */
155
+ appliesTo?: (context: TableActionContext<T>) => boolean;
118
156
  /** Whether this action requires the table to be in edit mode.
119
157
  * Defaults to `true`. Set to `false` for read-only actions
120
158
  * (e.g., "open URL", "copy to clipboard"). */
@@ -133,10 +171,17 @@ export interface TableAction<T = any, S = null> {
133
171
  }>;
134
172
  /** Check if the action is ready to run given its configuration state */
135
173
  isReady?: (state: S) => boolean;
174
+ /** For live/stateful controls (a column sort or filter widget, say): render
175
+ * bespoke UI for the current context instead of the default action button.
176
+ * When present, the toolbar renders this and ignores `detailsForm` (and
177
+ * `run`, unless the control itself invokes it). This is how sort/filter/group
178
+ * are expressed as `FULL_COLUMNS`-scoped controls in the one action system. */
179
+ render?: (context: TableActionContext<T>) => ReactNode;
136
180
  /** Execute the action. May be synchronous (local state manipulation)
137
181
  * or asynchronous (backend fulfillment). For lazy-loaded tables,
138
- * async actions are required when targeting non-loaded cells. */
139
- run(context: TableActionContext<T>, state?: S): void | Promise<void>;
182
+ * async actions are required when targeting non-loaded cells.
183
+ * Optional for `render`-only controls. */
184
+ run?(context: TableActionContext<T>, state?: S): void | Promise<void>;
140
185
  successMessage?: string;
141
186
  errorMessage?: string;
142
187
  hotkey?: string;