@sheetxl/react 0.7.26 → 0.7.28-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (257) hide show
  1. package/browser/cjs/Bo9Kx3L_XQkGPBJ5.cjs +1 -0
  2. package/browser/cjs/Pl04-kDEQSO8_qFU.cjs +156 -0
  3. package/browser/cjs/index.cjs +24 -24
  4. package/browser/esm/D_suN0U6XvrHxTak.mjs +6286 -0
  5. package/browser/esm/index.mjs +19258 -4911
  6. package/licenses/dependencies.txt +42 -214
  7. package/node/esm/CH084kteEgVy0a8H.mjs +9 -0
  8. package/node/esm/index.mjs +17035 -3691
  9. package/package.json +10 -11
  10. package/resources/contents.json +60 -0
  11. package/resources/locales/contents.json +114 -0
  12. package/resources/locales/de/clipboard.cmd.json +36 -0
  13. package/resources/locales/de/editor.cmd.json +128 -0
  14. package/resources/locales/de/movable.cmd.json +123 -0
  15. package/resources/locales/de/selection.cmd.json +373 -0
  16. package/resources/locales/de/sheet.cmd.json +1563 -0
  17. package/resources/locales/de/table.cmd.json +83 -0
  18. package/resources/locales/de/ui.msg.json +166 -0
  19. package/resources/locales/de/workbook.cmd.json +282 -0
  20. package/resources/locales/en/clipboard.cmd.json +36 -0
  21. package/resources/locales/en/editor.cmd.json +128 -0
  22. package/resources/locales/en/movable.cmd.json +123 -0
  23. package/resources/locales/en/selection.cmd.json +373 -0
  24. package/resources/locales/en/sheet.cmd.json +1563 -0
  25. package/resources/locales/en/table.cmd.json +83 -0
  26. package/resources/locales/en/ui.msg.json +166 -0
  27. package/resources/locales/en/workbook.cmd.json +282 -0
  28. package/types/index.d.ts +2 -1767
  29. package/types/src/border/StaticBorderRenderer.d.ts +32 -0
  30. package/types/src/border/StyledStrokePath.d.ts +14 -0
  31. package/types/src/border/index.d.ts +4 -0
  32. package/types/src/border/useBorders.d.ts +87 -0
  33. package/types/src/cell/ColumnButton.d.ts +45 -0
  34. package/types/src/cell/CornerTriangle.d.ts +27 -0
  35. package/types/src/cell/FormulaCellRenderer.d.ts +34 -0
  36. package/types/src/cell/SheetCellRenderer.d.ts +52 -0
  37. package/types/src/cell/SheetHeaderRenderer.d.ts +37 -0
  38. package/types/src/cell/index.d.ts +7 -0
  39. package/types/src/cell/useFormulaViewAnchor.d.ts +42 -0
  40. package/types/src/chart/ChartEditor.d.ts +17 -0
  41. package/types/src/chart/PresetChartTypeDescriptors.d.ts +35 -0
  42. package/types/src/chart/index.d.ts +3 -0
  43. package/types/src/chart/templates/area-stacked-percent-template.json.d.ts +10 -0
  44. package/types/src/chart/templates/area-stacked-template.json.d.ts +10 -0
  45. package/types/src/chart/templates/area-template.json.d.ts +9 -0
  46. package/types/src/chart/templates/bar-stacked-percent-template.json.d.ts +10 -0
  47. package/types/src/chart/templates/bar-stacked-template.json.d.ts +10 -0
  48. package/types/src/chart/templates/bar-template.json.d.ts +9 -0
  49. package/types/src/chart/templates/column-stacked-percent-template.json.d.ts +10 -0
  50. package/types/src/chart/templates/column-stacked-template.json.d.ts +10 -0
  51. package/types/src/chart/templates/column-template.json.d.ts +9 -0
  52. package/types/src/chart/templates/line-markers-template.json.d.ts +10 -0
  53. package/types/src/chart/templates/line-stacked-markers-template.json.d.ts +11 -0
  54. package/types/src/chart/templates/line-stacked-percent-markers-template.json.d.ts +11 -0
  55. package/types/src/chart/templates/line-stacked-percent-template.json.d.ts +10 -0
  56. package/types/src/chart/templates/line-stacked-template.json.d.ts +10 -0
  57. package/types/src/chart/templates/line-template.json.d.ts +9 -0
  58. package/types/src/chart/templates/pie-doughnut-template.json.d.ts +10 -0
  59. package/types/src/chart/templates/pie-template.json.d.ts +9 -0
  60. package/types/src/chart/templates/scatter-lines-markers-smooth-template.json.d.ts +10 -0
  61. package/types/src/chart/templates/scatter-lines-markers-template.json.d.ts +10 -0
  62. package/types/src/chart/templates/scatter-lines-smooth-template.json.d.ts +10 -0
  63. package/types/src/chart/templates/scatter-lines-template.json.d.ts +10 -0
  64. package/types/src/chart/templates/scatter-markers-template.json.d.ts +10 -0
  65. package/types/src/clipboard/ClipboardCommands.d.ts +68 -0
  66. package/types/src/clipboard/SheetClipboardLayer.d.ts +22 -0
  67. package/types/src/clipboard/index.d.ts +3 -0
  68. package/types/src/commands/Catalog.d.ts +8 -0
  69. package/types/src/commands/CommandRootProvider.d.ts +36 -0
  70. package/types/src/commands/InputClipboardCommands.d.ts +41 -0
  71. package/types/src/commands/InputClipboardInjector.d.ts +16 -0
  72. package/types/src/commands/MainFocusContext.d.ts +13 -0
  73. package/types/src/commands/PaneScopeProvider.d.ts +40 -0
  74. package/types/src/commands/createTransactionalMiddleware.d.ts +49 -0
  75. package/types/src/commands/index.d.ts +7 -0
  76. package/types/src/context/SheetContext.d.ts +18 -0
  77. package/types/src/context/WorkbookContext.d.ts +20 -0
  78. package/types/src/context/index.d.ts +3 -0
  79. package/types/src/editableLabel/EditableLabel.d.ts +28 -0
  80. package/types/src/editableLabel/index.d.ts +2 -0
  81. package/types/src/editor/EditorCommands.d.ts +98 -0
  82. package/types/src/editor/FunctionPreviewPanel.d.ts +166 -0
  83. package/types/src/editor/NamedHintPanel.d.ts +38 -0
  84. package/types/src/editor/NamedItemsPanel.d.ts +59 -0
  85. package/types/src/editor/SheetCellEditorLayer.d.ts +40 -0
  86. package/types/src/editor/SheetCellInput.d.ts +99 -0
  87. package/types/src/editor/SheetEditable.d.ts +53 -0
  88. package/types/src/editor/SheetReferenceHeaderLayer.d.ts +46 -0
  89. package/types/src/editor/SheetReferenceLayer.d.ts +55 -0
  90. package/types/src/editor/formulaCaret.d.ts +84 -0
  91. package/types/src/editor/formulaEval.d.ts +202 -0
  92. package/types/src/editor/formulaPresentation.d.ts +136 -0
  93. package/types/src/editor/formulaText.d.ts +80 -0
  94. package/types/src/editor/functionArgs.d.ts +111 -0
  95. package/types/src/editor/functionHint.d.ts +37 -0
  96. package/types/src/editor/index.d.ts +18 -0
  97. package/types/src/editor/referencePointNav.d.ts +39 -0
  98. package/types/src/editor/useFormulaHints.d.ts +126 -0
  99. package/types/src/editor/useFormulaInput.d.ts +326 -0
  100. package/types/src/editor/useProtectedEditNotice.d.ts +14 -0
  101. package/types/src/editor/useReferenceMode.d.ts +177 -0
  102. package/types/src/form/FormulaInput.d.ts +86 -0
  103. package/types/src/form/FormulaInputParts.d.ts +94 -0
  104. package/types/src/form/index.d.ts +5 -0
  105. package/types/src/form/useEditCommit.d.ts +174 -0
  106. package/types/src/form/useInputField.d.ts +86 -0
  107. package/types/src/frame/CommandContext.d.ts +179 -0
  108. package/types/src/frame/IFrame.d.ts +17 -0
  109. package/types/src/frame/index.d.ts +3 -0
  110. package/types/src/icons/LogoNoPaddingIcon.d.ts +3 -0
  111. package/types/src/icons/LogoTextNoPaddingIcon.d.ts +4 -0
  112. package/types/src/icons/WaterMark.d.ts +12 -0
  113. package/types/src/icons/chart/ChartAreaIcon.d.ts +5 -0
  114. package/types/src/icons/chart/ChartAreaStackedIcon.d.ts +5 -0
  115. package/types/src/icons/chart/ChartAreaStackedPercentIcon.d.ts +5 -0
  116. package/types/src/icons/chart/ChartBarIcon.d.ts +5 -0
  117. package/types/src/icons/chart/ChartBarStackedIcon.d.ts +5 -0
  118. package/types/src/icons/chart/ChartBarStackedPercentIcon.d.ts +5 -0
  119. package/types/src/icons/chart/ChartBubble3DIcon.d.ts +5 -0
  120. package/types/src/icons/chart/ChartBubbleIcon.d.ts +5 -0
  121. package/types/src/icons/chart/ChartColumnIcon.d.ts +5 -0
  122. package/types/src/icons/chart/ChartColumnStackedIcon.d.ts +5 -0
  123. package/types/src/icons/chart/ChartColumnStackedPercentIcon.d.ts +5 -0
  124. package/types/src/icons/chart/ChartLineIcon.d.ts +5 -0
  125. package/types/src/icons/chart/ChartLineMarkersIcon.d.ts +5 -0
  126. package/types/src/icons/chart/ChartLineStackedIcon.d.ts +5 -0
  127. package/types/src/icons/chart/ChartLineStackedMarkersIcon.d.ts +5 -0
  128. package/types/src/icons/chart/ChartLineStackedPercentIcon.d.ts +5 -0
  129. package/types/src/icons/chart/ChartLineStackedPercentMarkersIcon.d.ts +5 -0
  130. package/types/src/icons/chart/ChartPieDoughnutIcon.d.ts +5 -0
  131. package/types/src/icons/chart/ChartPieIcon.d.ts +5 -0
  132. package/types/src/icons/chart/ChartScatterLinesIcon.d.ts +5 -0
  133. package/types/src/icons/chart/ChartScatterLinesMarkersIcon.d.ts +5 -0
  134. package/types/src/icons/chart/ChartScatterLinesMarkersSmoothIcon.d.ts +5 -0
  135. package/types/src/icons/chart/ChartScatterLinesSmoothIcon.d.ts +5 -0
  136. package/types/src/icons/chart/ChartScatterMarkersIcon.d.ts +5 -0
  137. package/types/src/icons/chart/ChartWaterfallIcon.d.ts +5 -0
  138. package/types/src/icons/chart/ThemedChartIcon.d.ts +20 -0
  139. package/types/src/icons/chart/index.d.ts +50 -0
  140. package/types/src/icons/index.d.ts +4 -0
  141. package/types/src/index.d.ts +27 -0
  142. package/types/src/io/WorkbookIO.d.ts +50 -0
  143. package/types/src/io/index.d.ts +2 -0
  144. package/types/src/layer/BorderLayer.d.ts +14 -0
  145. package/types/src/layer/CellErrorLayer.d.ts +49 -0
  146. package/types/src/layer/CellFillLayer.d.ts +15 -0
  147. package/types/src/layer/ConditionalBarLayer.d.ts +41 -0
  148. package/types/src/layer/ConditionalIcons.d.ts +34 -0
  149. package/types/src/layer/ConditionalIconsLayer.d.ts +31 -0
  150. package/types/src/layer/ContextMenuLayer.d.ts +27 -0
  151. package/types/src/layer/HeaderResizerLayer.d.ts +28 -0
  152. package/types/src/layer/HeaderSelectionLayer.d.ts +89 -0
  153. package/types/src/layer/ResizeIndicator.d.ts +19 -0
  154. package/types/src/layer/SheetBackgroundLayer.d.ts +22 -0
  155. package/types/src/layer/SheetCellLayer.d.ts +49 -0
  156. package/types/src/layer/SheetColumnButtonLayer.d.ts +23 -0
  157. package/types/src/layer/SheetGridLineLayer.d.ts +22 -0
  158. package/types/src/layer/SheetHeaderCellLayer.d.ts +30 -0
  159. package/types/src/layer/SheetMovableLayer.d.ts +26 -0
  160. package/types/src/layer/SheetTableCommandLayer.d.ts +16 -0
  161. package/types/src/layer/SpillLayer.d.ts +22 -0
  162. package/types/src/layer/TableLayer.d.ts +22 -0
  163. package/types/src/layer/ValidationIndicatorLayer.d.ts +41 -0
  164. package/types/src/layer/index.d.ts +25 -0
  165. package/types/src/layer/resizeIndicatorState.d.ts +26 -0
  166. package/types/src/layer/useSheetFeatureRegions.d.ts +21 -0
  167. package/types/src/layer/useSheetVisibleCells.d.ts +60 -0
  168. package/types/src/layer/useSheetVisibleDecorations.d.ts +42 -0
  169. package/types/src/layer/useTableHeaderCells.d.ts +22 -0
  170. package/types/src/layer/useVisibleTables.d.ts +27 -0
  171. package/types/src/listener/index.d.ts +3 -0
  172. package/types/src/listener/useModelListener.d.ts +67 -0
  173. package/types/src/listener/useRangeListener.d.ts +15 -0
  174. package/types/src/movable/EmptyFrame.d.ts +16 -0
  175. package/types/src/movable/IMovableArea.d.ts +34 -0
  176. package/types/src/movable/MovableCommands.d.ts +22 -0
  177. package/types/src/movable/MovableFrame.d.ts +48 -0
  178. package/types/src/movable/MovableLayer.d.ts +77 -0
  179. package/types/src/movable/MoveableBundle.d.ts +4 -0
  180. package/types/src/movable/index.d.ts +4 -0
  181. package/types/src/picture/IPictureEditor.d.ts +39 -0
  182. package/types/src/picture/PictureEditor.d.ts +4 -0
  183. package/types/src/picture/index.d.ts +3 -0
  184. package/types/src/selection/SelectionCommands.d.ts +23 -0
  185. package/types/src/selection/SheetSelection.d.ts +53 -0
  186. package/types/src/selection/SheetSelectionLayer.d.ts +30 -0
  187. package/types/src/selection/index.d.ts +4 -0
  188. package/types/src/shape/ShapeEditor.d.ts +16 -0
  189. package/types/src/shape/index.d.ts +2 -0
  190. package/types/src/sheet/ConditionalFormatPresets.d.ts +56 -0
  191. package/types/src/sheet/ISheetElement.d.ts +233 -0
  192. package/types/src/sheet/ISheetHeaderElement.d.ts +138 -0
  193. package/types/src/sheet/NotImplemented.d.ts +3 -0
  194. package/types/src/sheet/SheetCommandProvider.d.ts +57 -0
  195. package/types/src/sheet/SheetCommands.d.ts +75 -0
  196. package/types/src/sheet/SheetElement.d.ts +15 -0
  197. package/types/src/sheet/SheetHeaderElement.d.ts +4 -0
  198. package/types/src/sheet/SheetScrollbar.d.ts +28 -0
  199. package/types/src/sheet/TopLeftCorner.d.ts +17 -0
  200. package/types/src/sheet/index.d.ts +7 -0
  201. package/types/src/slicer/SlicerEditor.d.ts +16 -0
  202. package/types/src/slicer/index.d.ts +2 -0
  203. package/types/src/tabStrip/SheetTab.d.ts +41 -0
  204. package/types/src/tabStrip/Sortable.d.ts +66 -0
  205. package/types/src/tabStrip/Tab.d.ts +19 -0
  206. package/types/src/tabStrip/TabStrip.d.ts +41 -0
  207. package/types/src/tabStrip/TabStripItem.d.ts +36 -0
  208. package/types/src/tabStrip/TabStripRow.d.ts +9 -0
  209. package/types/src/tabStrip/index.d.ts +7 -0
  210. package/types/src/table/TableCommands.d.ts +16 -0
  211. package/types/src/taskPane/ITaskPane.d.ts +72 -0
  212. package/types/src/taskPane/TaskPaneArea.d.ts +144 -0
  213. package/types/src/taskPane/TaskPaneFrame.d.ts +48 -0
  214. package/types/src/taskPane/TaskPaneRegistry.d.ts +108 -0
  215. package/types/src/taskPane/TaskPaneStrip.d.ts +33 -0
  216. package/types/src/taskPane/TaskPaneTitle.d.ts +24 -0
  217. package/types/src/taskPane/index.d.ts +7 -0
  218. package/types/src/taskPane/useTaskPane.d.ts +29 -0
  219. package/types/src/theme/DocThemesContext.d.ts +3 -0
  220. package/types/src/theme/DocThemesProvider.d.ts +15 -0
  221. package/types/src/theme/ThemeState.d.ts +19 -0
  222. package/types/src/theme/buildDocThemeCSS.d.ts +16 -0
  223. package/types/src/theme/buildOOXMLThemeCSS.d.ts +13 -0
  224. package/types/src/theme/createCSSSystemLookup.d.ts +51 -0
  225. package/types/src/theme/index.d.ts +11 -0
  226. package/types/src/theme/useAppColorScheme.d.ts +15 -0
  227. package/types/src/theme/useDocThemes.d.ts +3 -0
  228. package/types/src/theme/useGridColorScheme.d.ts +20 -0
  229. package/types/src/theme/useSystemColors.d.ts +44 -0
  230. package/types/src/undo/UndoCommands.d.ts +28 -0
  231. package/types/src/undo/UndoManagerContext.d.ts +14 -0
  232. package/types/src/undo/index.d.ts +3 -0
  233. package/types/src/workbook/DefaultRenderers.d.ts +14 -0
  234. package/types/src/workbook/GlobalWorkbookElement.d.ts +10 -0
  235. package/types/src/workbook/IWorkbookElement.d.ts +178 -0
  236. package/types/src/workbook/WindowChrome.d.ts +61 -0
  237. package/types/src/workbook/WorkbookCommandContributor.d.ts +24 -0
  238. package/types/src/workbook/WorkbookCommands.d.ts +97 -0
  239. package/types/src/workbook/WorkbookElement.d.ts +9 -0
  240. package/types/src/workbook/WorkbookStrip.d.ts +73 -0
  241. package/types/src/workbook/index.d.ts +17 -0
  242. package/types/src/workbook/resolveWorkbookInput.d.ts +27 -0
  243. package/types/src/workbook/useResolvedWorkbook.d.ts +31 -0
  244. package/types/src/workbook/useWindowChrome.d.ts +24 -0
  245. package/types/src/workbook/useWorkbookApp.d.ts +47 -0
  246. package/types/src/workbook/useWorkbookEncrypted.d.ts +15 -0
  247. package/types/src/workbook/useWorkbookFormat.d.ts +18 -0
  248. package/types/src/workbook/useWorkbookName.d.ts +13 -0
  249. package/types/src/workbook/useWorkbookSaveState.d.ts +29 -0
  250. package/browser/cjs/BmyiATwwabIijIcx.cjs +0 -16
  251. package/browser/cjs/gi7H7UxDWl1xhmpB.cjs +0 -7
  252. package/browser/cjs/riAg15J7Fxjibjpd.cjs +0 -161
  253. package/browser/esm/BLxDzg_nC0uvkabr.mjs +0 -1377
  254. package/browser/esm/CL0VCEG7SV6dsMf0.mjs +0 -3905
  255. package/browser/esm/CwNJi9uj-WfxZwSI.mjs +0 -394
  256. package/node/assets/style.css +0 -1
  257. package/node/esm/CX0U5emV8bnYBcK6.mjs +0 -11
@@ -0,0 +1,10 @@
1
+ declare const _default: {
2
+ "types": {
3
+ "0": {
4
+ "type": "scatter",
5
+ "scatterStyle": "lineMarker"
6
+ }
7
+ }
8
+ };
9
+
10
+ export default _default;
@@ -0,0 +1,10 @@
1
+ declare const _default: {
2
+ "types": {
3
+ "0": {
4
+ "type": "scatter",
5
+ "scatterStyle": "smooth"
6
+ }
7
+ }
8
+ };
9
+
10
+ export default _default;
@@ -0,0 +1,10 @@
1
+ declare const _default: {
2
+ "types": {
3
+ "0": {
4
+ "type": "scatter",
5
+ "scatterStyle": "line"
6
+ }
7
+ }
8
+ };
9
+
10
+ export default _default;
@@ -0,0 +1,10 @@
1
+ declare const _default: {
2
+ "types": {
3
+ "0": {
4
+ "type": "scatter",
5
+ "scatterStyle": "marker"
6
+ }
7
+ }
8
+ };
9
+
10
+ export default _default;
@@ -0,0 +1,68 @@
1
+ import { EditModeHandler, ReferenceableClipboard, RemoveListener } from '@sheetxl/utils';
2
+ import { ICellRange, ISheet } from '@sheetxl/sdk';
3
+ import { Command, IReactNotifier } from '@sheetxl/utils-react';
4
+ export interface SheetPasteOptions extends ReferenceableClipboard.PasteOptions, ICellRange.CopyOptions {
5
+ }
6
+ /** Minimal shape of the global clipboard handle — the `useGlobalClipboard` singleton, threaded in. */
7
+ interface GlobalClipboardLike {
8
+ getClipboard(): ReferenceableClipboard;
9
+ }
10
+ /**
11
+ * Options for {@link contributeClipboardCommands}.
12
+ */
13
+ export interface ContributeClipboardCommandsOptions {
14
+ /** Busy + error UI for the copy/paste flows. */
15
+ notifier?: IReactNotifier;
16
+ /**
17
+ * The app-wide **edit-mode bus** (`useEditMode()` handler). Copy/cut publish the marching-ants mode
18
+ * onto it (the {@link SheetClipboardLayer} view reads it back); paste clears it; format-painter
19
+ * toggles it. **Required** — the marquee and format-painter can't work without it.
20
+ */
21
+ editModeHandler: EditModeHandler;
22
+ /**
23
+ * The global clipboard handle (`useGlobalClipboard()`). Copy writes references here; paste reads them.
24
+ * The insert-copied-cells path in `contributeSheetCommands` reads the *same* handle, so a copy through
25
+ * this contributor makes "insert copied cells" light up.
26
+ */
27
+ globalClipboard: GlobalClipboardLike;
28
+ /**
29
+ * The focus/paste target element (the grid stage). Copy/paste guard on it and refocus it after paste.
30
+ * Points at the pane stage.
31
+ */
32
+ element?: () => HTMLElement | null;
33
+ /** Notified when the clipboard reference changes (`null` = cleared). */
34
+ onClipboardUpdate?: (reference: ReferenceableClipboard.ReferenceItem | null) => void;
35
+ /** Notified after a paste completes. */
36
+ onPaste?: (reference: ReferenceableClipboard.ReferenceItem, args: SheetPasteOptions) => void;
37
+ }
38
+ /**
39
+ * The clipboard contributor — the generic copy/paste infra **and** the sheet-aware pastes, folded
40
+ * into ONE plain-function contributor: a focused input/editor is a command target with default
41
+ * clipboard behavior — one concern.
42
+ *
43
+ * Follows the contributor template: a plain function (not a hook) taking the {@link Command.CommandContribution}
44
+ * (authoring facet) + the `sheet`, returning **only its own external-subscription disposer** (the
45
+ * clipboard + sheet-protection listeners). The owner removes the commands (`contribution.remove()`).
46
+ *
47
+ * Contributes onto the **sheet scope**:
48
+ * - `cut` / `copy` / `paste` (the generic copy/paste flow);
49
+ * - `pasteValues` / `pasteFormats` / `pasteFormulas` / `pasteTranspose` / `pasteLinks` (content-typed
50
+ * pastes);
51
+ * - `formatPainterToggle` — which is just a `copy` published with a `formatPainter` edit mode, so it
52
+ * belongs where the copy handler lives (this unblocks the sheet's `formatPainterToggle`).
53
+ *
54
+ * The **marching-ants view** is a separate command-free component ({@link SheetClipboardLayer}); it
55
+ * and this contributor communicate only through the edit-mode bus (`editModeHandler`) + the global
56
+ * clipboard — the same decoupling the selection layer/contributor split uses via `ISelection`.
57
+ *
58
+ * **Standalone:** this module owns *everything* about its commands — definitions, behavior, enablement
59
+ * (protection-disable), and the marquee view — with **no dependency on SheetCommands** (it reads only the
60
+ * generic `ISheet` model). It's the shape a third-party clipboard would take: sheet knows nothing about it.
61
+ */
62
+ /** The single `data` bundle {@link contributeClipboardCommands} takes (the `DynamicCommandContributor` shape). */
63
+ export interface ClipboardCommandData extends ContributeClipboardCommandsOptions {
64
+ sheet: ISheet;
65
+ }
66
+ export declare function contributeClipboardCommands(contribution: Command.CommandContribution, data: ClipboardCommandData): RemoveListener;
67
+ export {};
68
+ //# sourceMappingURL=ClipboardCommands.d.ts.map
@@ -0,0 +1,22 @@
1
+ import { default as React } from 'react';
2
+ import { ISheet } from '@sheetxl/sdk';
3
+ import { LayerProps } from '@sheetxl/grid-react';
4
+ export interface SheetClipboardLayerProps extends LayerProps {
5
+ sheet: ISheet;
6
+ /** Class for the marquee visuals (devtools identification). */
7
+ className?: string;
8
+ }
9
+ /**
10
+ * The **clipboard pane layer** — the exact analog of `SheetSelectionLayer`: it renders its **draw** (the
11
+ * copy/cut/format-painter marching-ants marquee) **and** its **commands** — a `clipboard` scope joined to the
12
+ * pane's z-stack above selection via a declarative {@link Command.CommandScopeProvider}, onto which
13
+ * {@link contributeClipboardCommands} contributes copy/paste/format-painter. Commands live with their
14
+ * layer, contributed the same way a third-party plugin would.
15
+ *
16
+ * @remarks
17
+ * The draw reads the app-wide edit-mode bus (`useEditMode`) — the same bus the commands publish to on
18
+ * copy/cut — and marquees the source range (which rides on `editMode.args.reference`, so it reads
19
+ * synchronously without an async clipboard round-trip). Mounted per-pane.
20
+ */
21
+ export declare const SheetClipboardLayer: React.FC<SheetClipboardLayerProps>;
22
+ //# sourceMappingURL=SheetClipboardLayer.d.ts.map
@@ -0,0 +1,3 @@
1
+ export * from './ClipboardCommands';
2
+ export * from './SheetClipboardLayer';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Register the `@sheetxl/react` command catalogs (all locales, from the manifest) into the shared
3
+ * registry. Idempotent — invoked at module scope from the entry providers (a used call, so bundlers
4
+ * retain it). Kicks off loading the active/default locale so chrome arrives without an explicit host
5
+ * prefetch; the reveal-gate should still await `prefetch()` for a guaranteed no-flash first paint.
6
+ */
7
+ export declare function registerReactCommandCatalogs(): void;
8
+ //# sourceMappingURL=Catalog.d.ts.map
@@ -0,0 +1,36 @@
1
+ import { ReactNode } from 'react';
2
+ import { Command } from '@sheetxl/utils-react';
3
+ /**
4
+ * Establishes the **shared command root** (registry + `app` scope + the one studio focus tracker +
5
+ * the one studio resolver with its synthetic key seam) for one mounted app. The per-workbook
6
+ * (`WorkbookElement`) and per-sheet ({@link SheetCommandProvider}) providers `createChild` their
7
+ * instance scopes off the ambient scope this publishes.
8
+ *
9
+ * **Provide-or-inherit** (the {@link SurfaceStateProvider} idiom): if an ancestor already established a
10
+ * root, an ambient command scope exists — so this is a pass-through, and a studio establishes ONE root
11
+ * that both its chrome (toolbar / formula bar) and its `WorkbookElement`(s) share, while a bare
12
+ * chromeless `WorkbookElement` that finds none establishes its own. Two `WorkbookElement`s under one
13
+ * studio therefore share one registry + `root` and each owns a distinct `workbook` instance — the
14
+ * substrate for the pending-workbook swap.
15
+ *
16
+ * It owns only *instance-independent* infrastructure. The catalog (chrome) is seeded by each feature
17
+ * provider into the shared registry (idempotent by contributor identity), and all model-closured behavior
18
+ * lives on the per-workbook / per-sheet instances below.
19
+ */
20
+ export interface CommandRootProviderProps {
21
+ /**
22
+ * The studio tracker's initial anchor (see {@link Command.FocusActivation}'s constructor). Typically a
23
+ * **{@link Command.DefaultAnchorProvider provider}** (a function) that returns the loaded grid's
24
+ * would-focus pane element — invoked pre-reveal so the toolbar paints enabled without the grid stealing
25
+ * real focus, AND re-invoked when a resize destroys the anchored pane (the destruction fallback). A
26
+ * one-shot `Promise`/value is also accepted (seeds once, no recall). Captured at mount; real focus
27
+ * advances the anchor thereafter.
28
+ */
29
+ initialAnchor?: Command.FocusActivationInitial;
30
+ children: ReactNode;
31
+ }
32
+ export declare const CommandRootProvider: {
33
+ ({ initialAnchor, children }: CommandRootProviderProps): ReactNode;
34
+ displayName: string;
35
+ };
36
+ //# sourceMappingURL=CommandRootProvider.d.ts.map
@@ -0,0 +1,41 @@
1
+ import { ReferenceableClipboard } from '@sheetxl/utils';
2
+ import { Command, ReactUtils } from '@sheetxl/utils-react';
3
+ /**
4
+ * Whether `el` is a DOM text-editable — a text `<input>`, a `<textarea>`, or a `contenteditable`.
5
+ *
6
+ * @remarks Re-exported at its original path; the definition lives in `@sheetxl/utils-react` so the
7
+ * command layer and the keystroke layer share one answer to "is this a text editable".
8
+ */
9
+ export declare const isEditable: typeof ReactUtils.isEditable;
10
+ /** Minimal shape of the global clipboard handle (`useGlobalClipboard()`), threaded in. */
11
+ interface GlobalClipboardLike {
12
+ getClipboard(): ReferenceableClipboard;
13
+ }
14
+ export interface InputClipboardInjectorOptions {
15
+ /** The app clipboard singleton — copy/cut `writeText` here, paste `readText`s here (NOT `execCommand`). */
16
+ clipboard: GlobalClipboardLike;
17
+ /** Keys to answer; defaults to `copy`/`cut`/`paste`/`selectAll`. */
18
+ keys?: readonly string[];
19
+ }
20
+ /**
21
+ * The **input-clipboard** resolve injector — `copy` / `cut` / `paste` / `selectAll` acting on the
22
+ * **focused DOM editable** (a text input / textarea / contenteditable), for
23
+ * {@link Command.CommandResolver.addResolveInjector}. Given `(key, element)` at resolve time it returns
24
+ * a leaf contribution (callback only) **iff** `element` is an editable and `key` is in the set —
25
+ * otherwise `undefined`, so the grid's cell copy resolves normally.
26
+ *
27
+ * Because the injected contribution is the **most-specific** (leaf), a focused input's `copy`
28
+ * out-resolves the grid clipboard (fixing "editing a formula, Copy grabs the cells"), and a region
29
+ * whose tree has no `copy` at all (the script editor) gains one (fixing "Copy disabled there") — both
30
+ * with no scope-tree surgery, and identically for the button and keystroke paths (both funnel through
31
+ * `resolve`). See design/COMMAND-INPUT-CLIPBOARD-PLAN.md.
32
+ *
33
+ * **Clipboard data flows through our own clipboard** (`writeText`/`readText`), not `execCommand('copy')`
34
+ * — so an input copy participates in the same clipboard the grid reads. `execCommand` is used **only**
35
+ * as the local text-edit primitive for paste-insert / cut-delete (it mutates the focused editable at the
36
+ * caret *and* fires a native `input` event, so a controlled React input picks up the change), with a
37
+ * `setRangeText` fallback.
38
+ */
39
+ export declare function createInputClipboardInjector(options: InputClipboardInjectorOptions): Command.ResolveInjector;
40
+ export {};
41
+ //# sourceMappingURL=InputClipboardCommands.d.ts.map
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Registers the {@link createInputClipboardInjector input-clipboard} resolve injector on the
3
+ * **nearest** `CommandResolver` for its lifetime. Render it once inside each `CommandAnchorProvider`
4
+ * whose resolver should answer `copy`/`cut`/`paste`/`selectAll` on a focused text input — the sheet
5
+ * bridge's app + pane resolvers, and the script editor's own resolver (so its Copy button, which has no
6
+ * `copy` in the scripting tree, resolves one).
7
+ *
8
+ * Renders nothing. The injector is created once (stable identity → registered once) and reads the live
9
+ * clipboard singleton through a ref, so a `setClipboard` still lands. No-op until a resolver is present.
10
+ * See design/COMMAND-INPUT-CLIPBOARD-PLAN.md.
11
+ */
12
+ export declare const InputClipboardInjector: {
13
+ (): null;
14
+ displayName: string;
15
+ };
16
+ //# sourceMappingURL=InputClipboardInjector.d.ts.map
@@ -0,0 +1,13 @@
1
+ import { Command } from '@sheetxl/utils-react';
2
+ /**
3
+ * Exposes the **main** command resolver's {@link Command.FocusActivation} tracker (created by the
4
+ * command root, attached to the app root) down the tree, so a nested region — the grid panes, or a
5
+ * feature-region bridge (e.g. the script editor) — records itself in the shared region map it reads. A
6
+ * region source is an {@link Command.ActivationTracker} (a pane's `LayerActivation`, i.e. its z-stack, read
7
+ * live) or a bare scope. That's how the toolbar's anchor follows focus *into* the active region and
8
+ * resolves from that region's stack top.
9
+ */
10
+ export declare const MainFocusContext: import('react').Context<Command.FocusActivation | null>;
11
+ /** The app-root region tracker of the main resolver, or `null` outside the sheet bridge. */
12
+ export declare function useMainFocus(): Command.FocusActivation | null;
13
+ //# sourceMappingURL=MainFocusContext.d.ts.map
@@ -0,0 +1,40 @@
1
+ import { ReactNode } from 'react';
2
+ import { IGridPane } from '@sheetxl/grid-react';
3
+ /**
4
+ * **Per-pane command layer stack** (the `GridSurface.wrapPane` seam).
5
+ *
6
+ * Each pane gets a **base** scope (`pane:<anchor>`, child of the sheet scope) plus a
7
+ * {@link Command.LayerActivation} — its **z-ordered command-parent chain**. The per-pane layer components
8
+ * (selection, clipboard, the cell editor) each `register` their own scope into that chain at their layer's
9
+ * real visual z (via a declarative `CommandScopeProvider spec order`), so `getAnchor()` is the stack top and a key resolves
10
+ * top→down the z-stack then pane → sheet → app.
11
+ *
12
+ * **The grid owns no resolver** (design/COMMAND-DESIGN.md §"Layered resolver"). This provider does exactly
13
+ * one thing: it records `Stage element → this pane's LayerActivation` in the tree's shared region index —
14
+ * so the **studio** focus tracker anchors at the focused pane's *live* stack top (the `LayerActivation` is
15
+ * an `AnchorSource`, read live via `getAnchor()`; mechanism 2). The `Stage` is the layers' DOM *parent*,
16
+ * but the anchor is the deepest layer — that inversion is why the pane maps its Stage to the chain, not to
17
+ * the base. A pane pushes nothing into any tracker: the tracker's cold-start value is the consumer's
18
+ * one-shot INITIAL anchor (the studio resolves it with the loaded grid's center pane, pre-reveal), which
19
+ * resolves back through this same index like a real focus would.
20
+ *
21
+ * **Key delivery is the studio's synthetic key seam, not a per-pane terminal.** A grid keydown is a synthetic
22
+ * React event on the Stage; the Stage fans it across its z-ordered responder chain (a layer consumes by
23
+ * `stopPropagation`), and whatever **no layer consumed** keeps bubbling up the React tree to the app-root seam
24
+ * (`CommandRootProvider`'s `CommandAnchorProvider keyBindings='synthetic'`), which hands it to the one
25
+ * **studio resolver** at the *same* focus-within anchor. So there is a **single** resolver-delivery
26
+ * seam — the pane no longer mounts its own terminal key tap (design/COMMAND-DESIGN.md §"Reduce the two
27
+ * key-dispatch seams to one"). The Stage responder chain still runs (layers need z-ordered first crack); only
28
+ * the redundant resolver hand-off at the bottom of it is gone.
29
+ *
30
+ * Rendered once per pane (≤4 with freeze) — the per-pane duplication is by design (each pane's layers read
31
+ * their own pane).
32
+ */
33
+ export declare const PaneScopeProvider: {
34
+ ({ pane, children }: {
35
+ pane: IGridPane;
36
+ children: ReactNode;
37
+ }): ReactNode;
38
+ displayName: string;
39
+ };
40
+ //# sourceMappingURL=PaneScopeProvider.d.ts.map
@@ -0,0 +1,49 @@
1
+ import { UndoManager } from '@sheetxl/utils';
2
+ import { ITransaction } from '@sheetxl/sdk';
3
+ import { Command, IReactNotifier } from '@sheetxl/utils-react';
4
+ /**
5
+ * Options for {@link createTransactionalMiddleware}.
6
+ */
7
+ export interface TransactionalMiddlewareOptions {
8
+ /**
9
+ * The model's transaction boundary — the command's work runs inside `transaction.doBatch(...)` so it
10
+ * groups into a single undo entry.
11
+ */
12
+ transaction: ITransaction.ITransactional;
13
+ /** Busy spinner + error reporting. Omit for a headless host. */
14
+ notifier?: IReactNotifier;
15
+ /**
16
+ * The undo manager the {@link transaction} records into. When present, a repeatable command sets a
17
+ * **repeatable operation** here after it runs, so `redo()` (our undo port wires Ctrl+Y / F4) repeats
18
+ * it once the redo stack is empty — Excel's "repeat last action". Omit to disable repeat.
19
+ */
20
+ manager?: UndoManager;
21
+ /**
22
+ * Whether a command participates in repeat. Default: repeatable unless tagged `'noRepeat'`.
23
+ */
24
+ isRepeatable?: (command: Command.ResolvedCommand<any, any, any>) => boolean;
25
+ }
26
+ /**
27
+ * The **shared transactional command wrapper** — one `CommandMiddleware` every feature reuses via
28
+ * `contribution.use(...)` (sheet, movable, …) instead of re-implementing (or copying) it. Each
29
+ * wrapped callback stays **pure**; the middleware adds, uniformly:
30
+ *
31
+ * - **batch** — runs the work in `transaction.doBatch(..., label)` so it's one undo entry;
32
+ * - **busy** — `notifier.showBusy(label)` for the duration;
33
+ * - **error** — a thrown error is reported via `notifier.showError` (a *falsy* throw = user cancel ⇒ swallowed);
34
+ * - **repeatable** — after success, sets `manager.setRepeatableOperation` so F4 / redo-when-empty
35
+ * **re-dispatches the same command + args** (`command.execute(args)`), which reads **live** selection,
36
+ * so the action re-applies to the *current* target. Repeat-after-repeat works (re-executing re-arms it).
37
+ * - **serialized** — wrapped commands run **one at a time** (chained on `tail`). `transaction.doBatch`
38
+ * opens a transaction *synchronously* but commits on the callback's *promise*, so two overlapping async
39
+ * commands interleave on the store's shared LIFO stack and corrupt it ("Transaction stack out of sync"
40
+ * → "Transaction already closed") — e.g. holding a key that repeats. Chaining makes each command fully
41
+ * commit before the next opens.
42
+ *
43
+ * A command opts out of the whole wrapper with the tag `'noTransaction'` (e.g. dialogs / navigation that
44
+ * shouldn't batch), or out of just repeat with `'noRepeat'`. A `noTransaction` command is **not queued** —
45
+ * it doesn't open our transaction, and serializing a transient op (zoom / selection) behind a slow
46
+ * mutation would just add lag.
47
+ */
48
+ export declare function createTransactionalMiddleware(options: TransactionalMiddlewareOptions): Command.CommandMiddleware<any, any, any>;
49
+ //# sourceMappingURL=createTransactionalMiddleware.d.ts.map
@@ -0,0 +1,7 @@
1
+ export * from './createTransactionalMiddleware';
2
+ export * from './InputClipboardCommands';
3
+ export * from './InputClipboardInjector';
4
+ export * from './MainFocusContext';
5
+ export * from './PaneScopeProvider';
6
+ export * from './CommandRootProvider';
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,18 @@
1
+ import { default as React, ReactNode } from 'react';
2
+ import { ISheet } from '@sheetxl/sdk';
3
+ export type SheetProviderProps = {
4
+ sheet: ISheet | null;
5
+ children: ReactNode;
6
+ };
7
+ /**
8
+ * Provides a sheet to descendants.
9
+ *
10
+ * Notes:
11
+ * - Prefer passing the sheet object as a stable reference from the host.
12
+ */
13
+ export declare function SheetProvider(props: SheetProviderProps): React.JSX.Element;
14
+ /**
15
+ * Hook consumers call to access the current sheet.
16
+ */
17
+ export declare function useSheet(): ISheet | null;
18
+ //# sourceMappingURL=SheetContext.d.ts.map
@@ -0,0 +1,20 @@
1
+ import { default as React, ReactNode } from 'react';
2
+ import { IWorkbook } from '@sheetxl/sdk';
3
+ export type WorkbookProviderProps = {
4
+ workbook: IWorkbook;
5
+ children: ReactNode;
6
+ };
7
+ /**
8
+ * Provides a workbook to descendants.
9
+ *
10
+ * Notes:
11
+ * - Prefer passing the workbook object as a stable reference from the host.
12
+ * - This auto registers a Sheet provider as well.
13
+ */
14
+ export declare function WorkbookProvider(props: WorkbookProviderProps): React.JSX.Element;
15
+ /**
16
+ * Hook consumers call to access the current workbook.
17
+ * Throws if used outside a provider (fast failure, good DX).
18
+ */
19
+ export declare function useWorkbook(): IWorkbook | null;
20
+ //# sourceMappingURL=WorkbookContext.d.ts.map
@@ -0,0 +1,3 @@
1
+ export * from './WorkbookContext';
2
+ export * from './SheetContext';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,28 @@
1
+ import { default as React } from 'react';
2
+ export interface EditableLabelAttributes {
3
+ startEdit(): void;
4
+ cancel(): void;
5
+ }
6
+ /**
7
+ * Type returned via ref property
8
+ */
9
+ export interface IEditableLabelElement extends HTMLDivElement, EditableLabelAttributes {
10
+ }
11
+ export interface EditableLabelProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onSubmit" | "onChange"> {
12
+ value?: string;
13
+ styleHover?: React.CSSProperties;
14
+ dragging?: boolean;
15
+ disabled?: boolean;
16
+ readOnly?: boolean;
17
+ maxLength?: number;
18
+ onChange?: (value: string) => void;
19
+ onSubmit?: (value: string) => boolean | void;
20
+ onCancel?: () => void;
21
+ renderInput?: (props: any) => React.ReactElement<HTMLInputElement>;
22
+ /**
23
+ * Reference to the HTMLInputElement (or other) used for editing
24
+ */
25
+ ref?: React.Ref<IEditableLabelElement>;
26
+ }
27
+ export declare const EditableLabel: React.NamedExoticComponent<Omit<EditableLabelProps, "ref"> & React.RefAttributes<IEditableLabelElement>>;
28
+ //# sourceMappingURL=EditableLabel.d.ts.map
@@ -0,0 +1,2 @@
1
+ export * from './EditableLabel';
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,98 @@
1
+ import { RemoveListener } from '@sheetxl/utils';
2
+ import { ISheet } from '@sheetxl/sdk';
3
+ import { Command } from '@sheetxl/utils-react';
4
+ import { IEditable, EditorMode, EditorTextSelection } from '@sheetxl/grid-react';
5
+ /**
6
+ * Which flavor an insert command applies — the same command key, resolved by the winning scope:
7
+ * - `'startEdit'` — **sheet** flavor: begin a fresh edit seeded with the text when NOT editing.
8
+ * - `'caret'` — **editor** override: insert at the focused editor's caret while editing.
9
+ */
10
+ export type InsertFlavor = 'startEdit' | 'caret';
11
+ /** Options for {@link insertEditText}. */
12
+ export interface InsertEditTextOptions {
13
+ /** Editor mode to (re)enter. @defaultValue `'edit'` */
14
+ mode?: EditorMode;
15
+ /** Initial text selection to apply on a fresh `startEdit` (e.g. select the auto-range inside `=SUM(…)`). */
16
+ initialSelection?: EditorTextSelection | null;
17
+ }
18
+ /**
19
+ * **Sheet flavor** — *begin* a fresh edit on the active cell seeded with `text` (drives the
20
+ * {@link IEditable} model's `startEdit`, NOT any editor view). This is what a **sheet** command does when
21
+ * NOT editing (`insertCurrentTime`, `insertFunction`, …): there is no editor yet, so it starts one.
22
+ */
23
+ export declare function startEditWith(editable: IEditable<any, any, any>, text: string, options?: InsertEditTextOptions): void;
24
+ /**
25
+ * **Editor flavor** — insert `text` at the **focused editor's caret** in the CURRENT session
26
+ * (`session.getActiveEditor().insertText`). This is the **editor override** a focused editor contributes
27
+ * for the same keys; caret ops are per-editor (two editors on one cell share the value, not the caret).
28
+ * Returns `false` (a no-op) when no edit session is active — the caller falls back to {@link startEditWith}.
29
+ */
30
+ export declare function insertAtCaret(editable: IEditable<any, any, any>, text: string): boolean;
31
+ /**
32
+ * Fused convenience: caret if editing, else start an edit. Prefer {@link startEditWith} (sheet flavor)
33
+ * or {@link insertAtCaret} (editor override) directly so the flavor is chosen by the resolving scope,
34
+ * not a runtime session check; this is kept while the sheet/editor split is wired through.
35
+ */
36
+ export declare function insertEditText(editable: IEditable<any, any, any>, text: string, options?: InsertEditTextOptions): void;
37
+ /**
38
+ * The **insert** commands' BEHAVIOR — `insertCurrentTime` / `insertCurrentDate` / `insertValueAbove` +
39
+ * the `insertFunctionSum`/`Average`/`Count`/`Max`/`Min` **AutoSum** family. Each computes some text and either
40
+ * **begins an edit** with it (`flavor: 'startEdit'`, the sheet's version when NOT editing) or **inserts it at
41
+ * the caret** (`flavor: 'caret'`, the focused editor's override while editing). Same command keys, resolved by
42
+ * whichever scope wins — the `sheet` contributes `'startEdit'`, the focused editor contributes `'caret'`. All
43
+ * are tagged `noTransaction` (they only seed the edit text; the model mutation commits later in the edit's own
44
+ * transaction), so the sheet scope's transactional middleware never wraps them. The command chrome lives in
45
+ * the catalog under BOTH the `sheet` and `editor` scopes (`sheet.cmd.en.json` / `editor.cmd.en.json`).
46
+ *
47
+ * The fx **picker** (`insertFunction`, with its `searchByCategory` context) is NOT here — it inserts any
48
+ * function (incl. workbook-defined custom ones), so it is a `workbook` command
49
+ * (see `contributeWorkbookCommands`). Still deferred: `insertFunctionDialog` — the "More Functions…"
50
+ * modal is not yet implemented.
51
+ */
52
+ /** The single `data` bundle {@link contributeInsertCommands} takes (the `DynamicCommandContributor` shape). */
53
+ export interface InsertCommandData {
54
+ editable: IEditable<any, any, any>;
55
+ sheet: ISheet;
56
+ /** `'startEdit'` begins an edit (the sheet's version when NOT editing); `'caret'` inserts at the focused editor's caret. */
57
+ flavor: InsertFlavor;
58
+ }
59
+ export declare function contributeInsertCommands(contribution: Command.CommandContribution, data: InsertCommandData): RemoveListener;
60
+ /**
61
+ * The **while-editing** edit-session commands' BEHAVIOR — `relativeReferencesToggle` (F4) and
62
+ * `toggleEditorFocus`. Unlike the insert commands ({@link contributeInsertCommands}), these only mean anything *during* an
63
+ * active edit, so the caller (the focused editor input, `SheetCellInput`, via {@link contributeEditorCommands})
64
+ * contributes them **only while it is focused** and removes them on blur — the one place in the system where
65
+ * focus/blur drives command *contribution* rather than just enablement. The catalog **chrome** (incl. the F4
66
+ * shortcut) lives in `editor.cmd.en.json`; the caller contributes only the **behavior**, gated on focus, so
67
+ * the active binding appears and disappears with the edit. That's why an idle editor owns no working F4 and
68
+ * it cedes to `redo`: there's no behavior bound, no dispatcher special-casing.
69
+ */
70
+ /** The single `data` bundle {@link contributeWhileEditingCommands} takes (the `DynamicCommandContributor` shape). */
71
+ export interface WhileEditingCommandData {
72
+ editable: IEditable<any, any, any>;
73
+ }
74
+ export declare function contributeWhileEditingCommands(contribution: Command.CommandContribution, data: WhileEditingCommandData): RemoveListener;
75
+ /**
76
+ * The **focused editor's** behavior — everything a focus-registered `editor` scope contributes:
77
+ * - the insert commands as **caret overrides** (`contributeInsertCommands(..., 'caret')`) — so while editing,
78
+ * date/time/value-above/insert-function insert at *this editor's* caret, overriding the sheet's begin-edit
79
+ * version;
80
+ * - the **while-editing** commands (F4 / toggleEditorFocus).
81
+ *
82
+ * The registration (WHERE this scope lives) is the host's job — a pane layer for the inline editor, a
83
+ * focus region for the FormulaBar — but the behavior is identical, so both call this. Returns a combined
84
+ * disposer.
85
+ */
86
+ /** The single `data` bundle {@link contributeEditorCommands} takes (the `DynamicCommandContributor` shape). */
87
+ export interface EditorCommandData {
88
+ editable: IEditable<any, any, any>;
89
+ sheet: ISheet;
90
+ /**
91
+ * Contribute the edit-session commands only while an edit is **active** (a session exists). An idle editor
92
+ * owns no F4 / no caret overrides, so they cede to `redo` / the sheet's begin-edit flavor. The host passes
93
+ * its live session state (`!!editable.getSession()`); the provider re-runs on the flip. @defaultValue `true`
94
+ */
95
+ active?: boolean;
96
+ }
97
+ export declare function contributeEditorCommands(contribution: Command.CommandContribution, data: EditorCommandData): RemoveListener;
98
+ //# sourceMappingURL=EditorCommands.d.ts.map