@sheetxl/react 0.8.0-beta.7 → 1.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 (406) hide show
  1. package/LICENSE.md +8 -7
  2. package/browser/esm/2YDUWXaXpl9cdsk7.mjs +8 -0
  3. package/browser/esm/64NfoZ1s7Oe3vdpX.mjs +60 -0
  4. package/browser/esm/BJDz5J4gFUEYi1Wz.mjs +36 -0
  5. package/browser/esm/B_CI6xMNropeWGgr.mjs +134 -0
  6. package/browser/esm/BgA4Cz8iMysciFOb.mjs +45 -0
  7. package/browser/esm/BkG6VuJDmu_hfIo6.mjs +31 -0
  8. package/browser/esm/BmO7yh4NjxeJylOD.mjs +14092 -0
  9. package/browser/esm/BwFFSeqtE3TIuvtc.mjs +341 -0
  10. package/browser/esm/CENTtj0PnF_tvpST.mjs +79 -0
  11. package/browser/esm/CVY0-_x6IgpdUVNp.mjs +264 -0
  12. package/browser/esm/CdyivRoMgPXvRiiE.mjs +197 -0
  13. package/browser/esm/CiylJlRA7mt8yjPD.mjs +128 -0
  14. package/browser/esm/D9CTIGFUbVGJkeVE.mjs +401 -0
  15. package/browser/esm/D9NgFucLwPgAQNgf.mjs +19 -0
  16. package/browser/esm/DdFOaG09eksHtKwT.mjs +145 -0
  17. package/browser/esm/DdHdNjRkzo1iShOo.mjs +78 -0
  18. package/browser/esm/DfIvpHB7HDdmIYNm.mjs +9560 -0
  19. package/browser/esm/DfNDtzixfTPjmoW_.mjs +32 -0
  20. package/browser/esm/Dtb9bOBjtPdUAr8x.mjs +20 -0
  21. package/browser/esm/Dz5pGpL4XWXVdntj.mjs +323 -0
  22. package/browser/esm/SJAlYSFKC-5yNZ-C.mjs +2706 -0
  23. package/browser/esm/chart.mjs +41 -0
  24. package/browser/esm/control.mjs +217 -0
  25. package/browser/esm/group.mjs +123 -0
  26. package/browser/esm/index.mjs +22289 -13986
  27. package/browser/esm/jHqSboF5oFvzSM7a.mjs +63 -0
  28. package/browser/esm/note.mjs +112 -0
  29. package/browser/esm/oljQE8EpIzoxUjUz.mjs +323 -0
  30. package/browser/esm/picture.mjs +7 -0
  31. package/browser/esm/shape.mjs +7 -0
  32. package/browser/esm/slicer.mjs +282 -0
  33. package/browser/esm/w8MsScJSe7QxP6jL.mjs +67 -0
  34. package/browser/esm/yRqWQRSVyiR1kYh8.mjs +42 -0
  35. package/licenses/dependencies.txt +284 -565
  36. package/node/esm/1XOgrNXKQF__O9SV.mjs +8 -0
  37. package/node/esm/Aw6aaKE_YOA1Vi_V.mjs +146 -0
  38. package/node/esm/B6Oqu2Gw1pwWPf_N.mjs +328 -0
  39. package/node/esm/BizlElAhqg_Bc624.mjs +198 -0
  40. package/node/esm/C06Y1xPsbxgn3YX7.mjs +128 -0
  41. package/node/esm/C2dHN_gvhBxlFFnJ.mjs +45 -0
  42. package/node/esm/C4_5UcCdys1hzt5E.mjs +68 -0
  43. package/node/esm/CIidiDtqyubz13ys.mjs +80 -0
  44. package/node/esm/CTFb8PjwC1q6yilw.mjs +80 -0
  45. package/node/esm/C_GJPG-BTFhta8GD.mjs +265 -0
  46. package/node/esm/CdTeYrDgGp-s-KNG.mjs +134 -0
  47. package/node/esm/CeMKhq6cSxfWzN5H.mjs +2706 -0
  48. package/node/esm/DJIBAu8bEDmlVjtD.mjs +20 -0
  49. package/node/esm/DUQ1PY9P63cTe_Es.mjs +37 -0
  50. package/node/esm/Db8NRp_kZ-FfkZaO.mjs +32 -0
  51. package/node/esm/Dl2kdvb4G_ddqeDN.mjs +19 -0
  52. package/node/esm/DlDr-o5nAZgPbn6R.mjs +1697 -0
  53. package/node/esm/DvRLP1lEBfwHBrEC.mjs +63 -0
  54. package/node/esm/JVlPlE1ys7DM3yCP.mjs +35 -0
  55. package/node/esm/NSddS40Vqf1xKdDd.mjs +406 -0
  56. package/node/esm/QqwCS9GFuDnQausz.mjs +66 -0
  57. package/node/esm/chart.mjs +41 -0
  58. package/node/esm/control.mjs +217 -0
  59. package/node/esm/group.mjs +123 -0
  60. package/node/esm/index.mjs +18027 -9614
  61. package/node/esm/note.mjs +113 -0
  62. package/node/esm/picture.mjs +326 -0
  63. package/node/esm/shape.mjs +342 -0
  64. package/node/esm/slicer.mjs +284 -0
  65. package/package.json +56 -15
  66. package/resources/contents.json +36 -0
  67. package/resources/locales/contents.json +84 -0
  68. package/resources/locales/de/chart.cmd.json +82 -0
  69. package/resources/locales/de/movable.cmd.json +68 -0
  70. package/resources/locales/de/picture.cmd.json +188 -0
  71. package/resources/locales/de/pivot.cmd.json +79 -0
  72. package/resources/locales/de/shape.cmd.json +17 -0
  73. package/resources/locales/de/sheet.cmd.json +270 -16
  74. package/resources/locales/de/slicer.cmd.json +17 -0
  75. package/resources/locales/de/sparkline.cmd.json +301 -0
  76. package/resources/locales/de/table.cmd.json +13 -2
  77. package/resources/locales/de/ui.msg.json +358 -2
  78. package/resources/locales/de/workbook.cmd.json +8 -1
  79. package/resources/locales/en/chart.cmd.json +82 -0
  80. package/resources/locales/en/movable.cmd.json +68 -0
  81. package/resources/locales/en/picture.cmd.json +188 -0
  82. package/resources/locales/en/pivot.cmd.json +79 -0
  83. package/resources/locales/en/shape.cmd.json +17 -0
  84. package/resources/locales/en/sheet.cmd.json +283 -17
  85. package/resources/locales/en/slicer.cmd.json +17 -0
  86. package/resources/locales/en/sparkline.cmd.json +301 -0
  87. package/resources/locales/en/table.cmd.json +13 -2
  88. package/resources/locales/en/ui.msg.json +360 -2
  89. package/resources/locales/en/workbook.cmd.json +8 -1
  90. package/types/chart.d.ts +2 -0
  91. package/types/control.d.ts +2 -0
  92. package/types/group.d.ts +2 -0
  93. package/types/note.d.ts +2 -0
  94. package/types/picture.d.ts +2 -0
  95. package/types/shape.d.ts +2 -0
  96. package/types/slicer.d.ts +2 -0
  97. package/types/src/annotation/RangeAnnotationLayer.d.ts +110 -0
  98. package/types/src/annotation/RangeAnnotationTag.d.ts +23 -0
  99. package/types/src/annotation/RangeAnnotations.d.ts +180 -0
  100. package/types/src/annotation/index.d.ts +4 -0
  101. package/types/src/autoFill/FillMenu.d.ts +2 -2
  102. package/types/src/autoFill/FillSeries.d.ts +2 -2
  103. package/types/src/border/StaticBorderRenderer.d.ts +18 -1
  104. package/types/src/border/useBorders.d.ts +95 -3
  105. package/types/src/cell/CellCheckboxRenderer.d.ts +20 -0
  106. package/types/src/cell/CellContent.d.ts +68 -0
  107. package/types/src/cell/CellControlContext.d.ts +37 -0
  108. package/types/src/cell/{FormulaCellRenderer.d.ts → CellFormulaRenderer.d.ts} +10 -7
  109. package/types/src/cell/CellImageRenderer.d.ts +11 -0
  110. package/types/src/cell/CellRenderers.d.ts +190 -0
  111. package/types/src/cell/{SheetCellRenderer.d.ts → CellTextRenderer.d.ts} +11 -8
  112. package/types/src/cell/ColumnButton.d.ts +3 -3
  113. package/types/src/cell/CornerTriangle.d.ts +2 -1
  114. package/types/src/cell/OutlineButton.d.ts +123 -0
  115. package/types/src/cell/PivotButton.d.ts +55 -0
  116. package/types/src/cell/SheetHeaderRenderer.d.ts +1 -1
  117. package/types/src/cell/StaticCellRenderer.d.ts +3 -3
  118. package/types/src/cell/_DropdownFace.d.ts +29 -0
  119. package/types/src/cell/index.d.ts +10 -2
  120. package/types/src/cell/useFormulaViewAnchor.d.ts +3 -3
  121. package/types/src/cell/useInsertableCellControls.d.ts +25 -0
  122. package/types/src/chart/ChartCommands.d.ts +15 -0
  123. package/types/src/chart/ChartEditor.d.ts +12 -2
  124. package/types/src/chart/ChartElement.d.ts +122 -0
  125. package/types/src/chart/ChartKind.d.ts +7 -0
  126. package/types/src/chart/PresetChartTypeDescriptors.d.ts +3 -1
  127. package/types/src/chart/index.d.ts +2 -1
  128. package/types/src/chart/paint/_fills.d.ts +24 -0
  129. package/types/src/chart/paint/_graphics.d.ts +38 -0
  130. package/types/src/chart/paint/_mode.d.ts +6 -0
  131. package/types/src/chart/paint/echarts.d.ts +33 -0
  132. package/types/src/chart/paint/index.d.ts +12 -0
  133. package/types/src/chart/paint/kinds/ChartPaintKind.d.ts +140 -0
  134. package/types/src/chart/paint/kinds/_Area.d.ts +3 -0
  135. package/types/src/chart/paint/kinds/_Bar.d.ts +3 -0
  136. package/types/src/chart/paint/kinds/_BoxWhisker.d.ts +3 -0
  137. package/types/src/chart/paint/kinds/_Bubble.d.ts +3 -0
  138. package/types/src/chart/paint/kinds/_Funnel.d.ts +3 -0
  139. package/types/src/chart/paint/kinds/_Histogram.d.ts +3 -0
  140. package/types/src/chart/paint/kinds/_Line.d.ts +10 -0
  141. package/types/src/chart/paint/kinds/_OfPie.d.ts +3 -0
  142. package/types/src/chart/paint/kinds/_Pie.d.ts +21 -0
  143. package/types/src/chart/paint/kinds/_Placeholder.d.ts +7 -0
  144. package/types/src/chart/paint/kinds/_Radar.d.ts +3 -0
  145. package/types/src/chart/paint/kinds/_Scatter.d.ts +3 -0
  146. package/types/src/chart/paint/kinds/_Sunburst.d.ts +3 -0
  147. package/types/src/chart/paint/kinds/_Surface.d.ts +3 -0
  148. package/types/src/chart/paint/kinds/_Treemap.d.ts +3 -0
  149. package/types/src/chart/paint/kinds/_Waterfall.d.ts +3 -0
  150. package/types/src/chart/paint/kinds/_builtIns.d.ts +3 -0
  151. package/types/src/chart/paint/toEChartsOption.d.ts +42 -0
  152. package/types/src/checklist/ValueChecklist.d.ts +59 -18
  153. package/types/src/clipboard/ClipboardCommands.d.ts +3 -3
  154. package/types/src/clipboard/SheetClipboardLayer.d.ts +2 -2
  155. package/types/src/commands/ContextualToolbar.d.ts +19 -0
  156. package/types/src/commands/createTransactionalMiddleware.d.ts +4 -1
  157. package/types/src/commands/index.d.ts +1 -0
  158. package/types/src/comment/CommentCardRequest.d.ts +9 -9
  159. package/types/src/comment/index.d.ts +0 -1
  160. package/types/src/comment/useSheetComments.d.ts +2 -2
  161. package/types/src/conditionalFormat/ConditionalFormatPresets.d.ts +6 -6
  162. package/types/src/context/WorksheetContext.d.ts +18 -0
  163. package/types/src/context/index.d.ts +1 -1
  164. package/types/src/control/FormControlRenderers.d.ts +22 -0
  165. package/types/src/editableLabel/EditableLabel.d.ts +3 -1
  166. package/types/src/editor/EditorCommands.d.ts +3 -3
  167. package/types/src/editor/SheetCellEditorLayer.d.ts +2 -7
  168. package/types/src/editor/SheetCellEditorStartLayer.d.ts +22 -5
  169. package/types/src/editor/SheetCellInput.d.ts +14 -0
  170. package/types/src/editor/SheetEditable.d.ts +6 -6
  171. package/types/src/editor/SheetReferenceHeaderLayer.d.ts +1 -1
  172. package/types/src/editor/SheetReferenceLayer.d.ts +4 -4
  173. package/types/src/editor/VirtualKeyboardLayer.d.ts +50 -0
  174. package/types/src/editor/formulaAnchor.d.ts +12 -0
  175. package/types/src/editor/formulaPresentation.d.ts +4 -3
  176. package/types/src/editor/index.d.ts +2 -0
  177. package/types/src/editor/pickedReference.d.ts +3 -3
  178. package/types/src/editor/useEditRejectedNotice.d.ts +3 -3
  179. package/types/src/editor/useFormulaHints.d.ts +3 -3
  180. package/types/src/editor/useFormulaInput.d.ts +6 -3
  181. package/types/src/editor/validationAlert.d.ts +24 -0
  182. package/types/src/form/FormulaInput.d.ts +5 -2
  183. package/types/src/form/useEditCommit.d.ts +23 -3
  184. package/types/src/form/useInputField.d.ts +2 -3
  185. package/types/src/frame/CommandContext.d.ts +101 -3
  186. package/types/src/group/GroupEditor.d.ts +25 -0
  187. package/types/src/index.d.ts +10 -1
  188. package/types/src/layer/BorderLayer.d.ts +5 -2
  189. package/types/src/layer/CellErrorLayer.d.ts +18 -7
  190. package/types/src/layer/CellFillLayer.d.ts +2 -2
  191. package/types/src/layer/CellIndicatorLayer.d.ts +31 -0
  192. package/types/src/layer/CellInsertLayer.d.ts +71 -0
  193. package/types/src/layer/CircularIndicatorLayer.d.ts +3 -3
  194. package/types/src/layer/CommentCardLayer.d.ts +7 -9
  195. package/types/src/layer/CommentsLayer.d.ts +2 -2
  196. package/types/src/layer/ConditionalBarLayer.d.ts +2 -2
  197. package/types/src/layer/ConditionalIcons.d.ts +4 -4
  198. package/types/src/layer/ConditionalIconsLayer.d.ts +2 -2
  199. package/types/src/layer/ContextMenuLayer.d.ts +2 -2
  200. package/types/src/layer/FreezeDragLines.d.ts +17 -0
  201. package/types/src/layer/GridFreezeLayer.d.ts +11 -0
  202. package/types/src/layer/HeaderFreezeLayer.d.ts +12 -0
  203. package/types/src/layer/HeaderResizerLayer.d.ts +2 -1
  204. package/types/src/layer/HeaderSelectionLayer.d.ts +4 -4
  205. package/types/src/layer/HyperlinkLayer.d.ts +116 -0
  206. package/types/src/layer/MovableKindScope.d.ts +17 -0
  207. package/types/src/layer/PivotLayer.d.ts +47 -0
  208. package/types/src/layer/PivotToolbar.d.ts +29 -0
  209. package/types/src/layer/ProtectionLayer.d.ts +4 -5
  210. package/types/src/layer/RangeToolbar.d.ts +75 -0
  211. package/types/src/layer/ResizeIndicator.d.ts +11 -10
  212. package/types/src/layer/ResizeTooltip.d.ts +13 -0
  213. package/types/src/layer/SheetBackgroundLayer.d.ts +3 -3
  214. package/types/src/layer/SheetCellLayer.d.ts +15 -8
  215. package/types/src/layer/SheetColumnButtonLayer.d.ts +2 -2
  216. package/types/src/layer/SheetGridLineLayer.d.ts +25 -15
  217. package/types/src/layer/SheetHeaderCellLayer.d.ts +10 -1
  218. package/types/src/layer/SheetLayers.d.ts +171 -0
  219. package/types/src/layer/SheetMovableLayer.d.ts +4 -3
  220. package/types/src/layer/SheetOutlineLayer.d.ts +40 -0
  221. package/types/src/layer/SheetPivotCommandLayer.d.ts +13 -0
  222. package/types/src/layer/SheetSparklineCommandLayer.d.ts +14 -0
  223. package/types/src/layer/SheetTableCommandLayer.d.ts +2 -2
  224. package/types/src/layer/SparklineLayer.d.ts +32 -0
  225. package/types/src/layer/SpillLayer.d.ts +2 -2
  226. package/types/src/layer/TableLayer.d.ts +6 -5
  227. package/types/src/layer/TableToolbar.d.ts +23 -0
  228. package/types/src/layer/ValidationDropdownLayer.d.ts +2 -2
  229. package/types/src/layer/ValidationIndicatorLayer.d.ts +2 -2
  230. package/types/src/layer/ValidationPromptLayer.d.ts +47 -16
  231. package/types/src/layer/_sheetBorders.d.ts +6 -0
  232. package/types/src/layer/_tableColor.d.ts +6 -0
  233. package/types/src/layer/_visibleCellFeatures.d.ts +11 -0
  234. package/types/src/layer/cellTip.d.ts +13 -0
  235. package/types/src/layer/freezeDragState.d.ts +21 -0
  236. package/types/src/layer/index.d.ts +15 -0
  237. package/types/src/layer/resizeIndicatorState.d.ts +3 -1
  238. package/types/src/layer/useFreezeDrag.d.ts +22 -0
  239. package/types/src/layer/useNormalBorderLines.d.ts +15 -0
  240. package/types/src/layer/useSheetFeatureRegions.d.ts +2 -2
  241. package/types/src/layer/useSheetVisibleCells.d.ts +5 -6
  242. package/types/src/layer/useSheetVisibleDecorations.d.ts +2 -2
  243. package/types/src/layer/useTableHeaderCells.d.ts +2 -2
  244. package/types/src/layer/useValidationPicker.d.ts +3 -3
  245. package/types/src/layer/useVisibleTables.d.ts +2 -2
  246. package/types/src/layer/validationMark.d.ts +3 -3
  247. package/types/src/listener/index.d.ts +5 -0
  248. package/types/src/listener/useCell.d.ts +29 -0
  249. package/types/src/listener/useCellRange.d.ts +23 -0
  250. package/types/src/listener/useCellValue.d.ts +26 -0
  251. package/types/src/listener/useModelListener.d.ts +4 -4
  252. package/types/src/listener/useRangeListener.d.ts +13 -7
  253. package/types/src/listener/useRangeSnapshot.d.ts +35 -0
  254. package/types/src/listener/useTable.d.ts +26 -0
  255. package/types/src/movable/ConnectionSites.d.ts +18 -0
  256. package/types/src/movable/DefaultMovable.d.ts +8 -0
  257. package/types/src/movable/IMovableArea.d.ts +38 -0
  258. package/types/src/movable/MovableAdornment.d.ts +26 -0
  259. package/types/src/movable/MovableCommandGroups.d.ts +22 -0
  260. package/types/src/movable/MovableCommands.d.ts +8 -3
  261. package/types/src/movable/MovableControl.d.ts +80 -0
  262. package/types/src/movable/MovableFrame.d.ts +18 -16
  263. package/types/src/movable/MovableLayer.d.ts +30 -5
  264. package/types/src/movable/MovableRenderers.d.ts +210 -0
  265. package/types/src/movable/PlaceholderFrames.d.ts +11 -0
  266. package/types/src/movable/RotateHandle.d.ts +37 -0
  267. package/types/src/movable/connect.d.ts +16 -0
  268. package/types/src/movable/framePlacement.d.ts +72 -0
  269. package/types/src/movable/geometry.d.ts +61 -0
  270. package/types/src/movable/index.d.ts +9 -0
  271. package/types/src/movable/pressTarget.d.ts +20 -0
  272. package/types/src/movable/useFramePreview.d.ts +17 -0
  273. package/types/src/picker/cellPickerOpen.d.ts +3 -3
  274. package/types/src/picker/useCellPicker.d.ts +7 -5
  275. package/types/src/picture/PictureCommands.d.ts +20 -0
  276. package/types/src/picture/PictureKind.d.ts +7 -0
  277. package/types/src/picture/_pictureHyperlink.d.ts +13 -0
  278. package/types/src/picture/index.d.ts +0 -1
  279. package/types/src/picture/pictureCrop.d.ts +32 -0
  280. package/types/src/pivot/PivotAreas.d.ts +16 -0
  281. package/types/src/pivot/PivotChip.d.ts +33 -0
  282. package/types/src/pivot/PivotChipMenu.d.ts +74 -0
  283. package/types/src/pivot/PivotCommands.d.ts +24 -0
  284. package/types/src/pivot/PivotFieldList.d.ts +14 -0
  285. package/types/src/pivot/PivotFields.d.ts +47 -0
  286. package/types/src/pivot/PivotFieldsModel.d.ts +143 -0
  287. package/types/src/pivot/PivotTablePane.d.ts +47 -0
  288. package/types/src/pivot/_PivotFieldsContext.d.ts +41 -0
  289. package/types/src/pivot/_pivotNew.d.ts +12 -0
  290. package/types/src/pivot/_pivotRegion.d.ts +14 -0
  291. package/types/src/pivot/index.d.ts +9 -0
  292. package/types/src/pivot/usePivotFields.d.ts +17 -0
  293. package/types/src/presence/PresenceCommands.d.ts +35 -0
  294. package/types/src/presence/PresenceHost.d.ts +58 -0
  295. package/types/src/presence/PresenceMessages.d.ts +42 -0
  296. package/types/src/presence/PresenceStore.d.ts +165 -0
  297. package/types/src/presence/PresenceTypes.d.ts +78 -0
  298. package/types/src/presence/index.d.ts +7 -0
  299. package/types/src/presence/usePresence.d.ts +20 -0
  300. package/types/src/richText/RichTextEditor.d.ts +2 -2
  301. package/types/src/selection/SelectionCommands.d.ts +2 -2
  302. package/types/src/selection/SheetSelectionLayer.d.ts +6 -12
  303. package/types/src/shape/ConnectorControl.d.ts +46 -0
  304. package/types/src/shape/ShapeCommands.d.ts +11 -0
  305. package/types/src/shape/ShapeControl.d.ts +8 -0
  306. package/types/src/shape/ShapeEditor.d.ts +15 -2
  307. package/types/src/shape/ShapeGallery.d.ts +31 -0
  308. package/types/src/shape/ShapeHandles.d.ts +28 -0
  309. package/types/src/shape/ShapeKind.d.ts +7 -0
  310. package/types/src/shape/ShapeSVG.d.ts +22 -0
  311. package/types/src/shape/ShapeText.d.ts +17 -0
  312. package/types/src/shape/icons/ShapeIcons.d.ts +16 -0
  313. package/types/src/shape/icons/_ShapeIconPack.d.ts +4 -0
  314. package/types/src/shape/index.d.ts +3 -1
  315. package/types/src/shape/shapeFrame.d.ts +50 -0
  316. package/types/src/shape/shapeStyle.d.ts +82 -0
  317. package/types/src/sheet/ISheetHeaderElement.d.ts +3 -3
  318. package/types/src/sheet/IWorksheetElement.d.ts +289 -0
  319. package/types/src/sheet/OpaqueSheetElement.d.ts +21 -0
  320. package/types/src/sheet/SheetCommandProvider.d.ts +14 -6
  321. package/types/src/sheet/SheetCommands.d.ts +18 -3
  322. package/types/src/sheet/SheetKindIcon.d.ts +14 -0
  323. package/types/src/sheet/SheetOutlineElement.d.ts +70 -0
  324. package/types/src/sheet/SheetPanels.d.ts +11 -0
  325. package/types/src/sheet/SheetScrollbar.d.ts +4 -13
  326. package/types/src/sheet/TopLeftCorner.d.ts +2 -2
  327. package/types/src/sheet/WorksheetElement.d.ts +12 -0
  328. package/types/src/sheet/_freezeAt.d.ts +10 -0
  329. package/types/src/sheet/_hyperlinkEdit.d.ts +7 -0
  330. package/types/src/sheet/_useHeaderMetrics.d.ts +11 -0
  331. package/types/src/sheet/circularReferences.d.ts +4 -4
  332. package/types/src/sheet/index.d.ts +5 -2
  333. package/types/src/sheet/useCycleHighlight.d.ts +2 -2
  334. package/types/src/slicer/SlicerCommands.d.ts +10 -0
  335. package/types/src/slicer/SlicerEditor.d.ts +8 -2
  336. package/types/src/slicer/SlicerKind.d.ts +7 -0
  337. package/types/src/slicer/SlicerStylePreview.d.ts +18 -0
  338. package/types/src/slicer/index.d.ts +2 -1
  339. package/types/src/slicer/slicerStyles.d.ts +32 -0
  340. package/types/src/sparkline/PictureCache.d.ts +37 -0
  341. package/types/src/sparkline/SparklineCommands.d.ts +23 -0
  342. package/types/src/sparkline/SparklinePictures.d.ts +7 -0
  343. package/types/src/sparkline/paint/_drawing.d.ts +24 -0
  344. package/types/src/sparkline/paint/echarts.d.ts +8 -0
  345. package/types/src/sparkline/paint/index.d.ts +8 -0
  346. package/types/src/tabStrip/SheetTab.d.ts +1 -1
  347. package/types/src/tabStrip/Sortable.d.ts +5 -5
  348. package/types/src/tabStrip/TabStrip.d.ts +13 -6
  349. package/types/src/tabStrip/TabStripItem.d.ts +15 -13
  350. package/types/src/table/TableCommands.d.ts +2 -2
  351. package/types/src/taskPane/CellControlPane.d.ts +15 -0
  352. package/types/src/taskPane/MovablePane.d.ts +15 -0
  353. package/types/src/taskPane/TaskPaneArea.d.ts +7 -0
  354. package/types/src/taskPane/TaskPaneFrame.d.ts +4 -4
  355. package/types/src/taskPane/TaskPaneKeys.d.ts +38 -0
  356. package/types/src/taskPane/TaskPaneRegistry.d.ts +32 -12
  357. package/types/src/taskPane/_paneReasons.d.ts +7 -0
  358. package/types/src/taskPane/index.d.ts +3 -0
  359. package/types/src/taskPane/useTaskPane.d.ts +6 -3
  360. package/types/src/theme/ExplicitTokens.d.ts +18 -0
  361. package/types/src/theme/GridColorSchemeContext.d.ts +8 -0
  362. package/types/src/theme/ThemeRootStyles.d.ts +31 -0
  363. package/types/src/theme/ThemeState.d.ts +2 -2
  364. package/types/src/theme/buildDocThemeCSS.d.ts +4 -1
  365. package/types/src/theme/buildOOXMLThemeCSS.d.ts +2 -2
  366. package/types/src/theme/buildTokensCSS.d.ts +15 -0
  367. package/types/src/theme/index.d.ts +2 -4
  368. package/types/src/theme/useAppColorScheme.d.ts +4 -1
  369. package/types/src/theme/useGridColorScheme.d.ts +9 -4
  370. package/types/src/theme/useSystemColors.d.ts +1 -15
  371. package/types/src/workbook/DefaultMovableRenderers.d.ts +20 -0
  372. package/types/src/workbook/DefaultRenderers.d.ts +5 -4
  373. package/types/src/workbook/IWorkbookElement.d.ts +176 -30
  374. package/types/src/workbook/WorkbookCommands.d.ts +6 -1
  375. package/types/src/workbook/WorkbookStrip.d.ts +14 -5
  376. package/browser/cjs/Bo9Kx3L_XQkGPBJ5.cjs +0 -1
  377. package/browser/cjs/Pl04-kDEQSO8_qFU.cjs +0 -156
  378. package/browser/cjs/index.cjs +0 -42
  379. package/browser/esm/CwXbsCWTrl3QB1t6.mjs +0 -6286
  380. package/node/esm/CZc8rKcLzArmqJz2.mjs +0 -9
  381. package/types/src/chart/templates/area-stacked-percent-template.json.d.ts +0 -10
  382. package/types/src/chart/templates/area-stacked-template.json.d.ts +0 -10
  383. package/types/src/chart/templates/area-template.json.d.ts +0 -9
  384. package/types/src/chart/templates/bar-stacked-percent-template.json.d.ts +0 -10
  385. package/types/src/chart/templates/bar-stacked-template.json.d.ts +0 -10
  386. package/types/src/chart/templates/bar-template.json.d.ts +0 -9
  387. package/types/src/chart/templates/column-stacked-percent-template.json.d.ts +0 -10
  388. package/types/src/chart/templates/column-stacked-template.json.d.ts +0 -10
  389. package/types/src/chart/templates/column-template.json.d.ts +0 -9
  390. package/types/src/chart/templates/line-markers-template.json.d.ts +0 -10
  391. package/types/src/chart/templates/line-stacked-markers-template.json.d.ts +0 -11
  392. package/types/src/chart/templates/line-stacked-percent-markers-template.json.d.ts +0 -11
  393. package/types/src/chart/templates/line-stacked-percent-template.json.d.ts +0 -10
  394. package/types/src/chart/templates/line-stacked-template.json.d.ts +0 -10
  395. package/types/src/chart/templates/line-template.json.d.ts +0 -9
  396. package/types/src/chart/templates/pie-doughnut-template.json.d.ts +0 -10
  397. package/types/src/chart/templates/pie-template.json.d.ts +0 -9
  398. package/types/src/chart/templates/scatter-lines-markers-smooth-template.json.d.ts +0 -10
  399. package/types/src/chart/templates/scatter-lines-markers-template.json.d.ts +0 -10
  400. package/types/src/chart/templates/scatter-lines-smooth-template.json.d.ts +0 -10
  401. package/types/src/chart/templates/scatter-lines-template.json.d.ts +0 -10
  402. package/types/src/chart/templates/scatter-markers-template.json.d.ts +0 -10
  403. package/types/src/context/SheetContext.d.ts +0 -18
  404. package/types/src/movable/MoveableBundle.d.ts +0 -4
  405. package/types/src/sheet/ISheetElement.d.ts +0 -258
  406. package/types/src/sheet/SheetElement.d.ts +0 -15
@@ -0,0 +1,50 @@
1
+ import { default as React } from 'react';
2
+ import { SheetEditable } from './SheetEditable';
3
+ /**
4
+ * Props for {@link VirtualKeyboardLayer}.
5
+ */
6
+ export interface VirtualKeyboardLayerProps {
7
+ /**
8
+ * The sheet's editable: an edit in progress is what a rising keyboard is for, and its anchor is the
9
+ * active cell kept in view above the keyboard.
10
+ */
11
+ editable: SheetEditable;
12
+ }
13
+ /**
14
+ * Keyboard mode for the sheet (see `useVirtualKeyboard`): while a virtual keyboard is up for typing
15
+ * into the sheet, focusing the sheet lands on an invisible input that holds the keyboard, so it stays
16
+ * up as the active cell moves.
17
+ *
18
+ * @remarks
19
+ * A virtual keyboard belongs to the focused text field, and the grid surface is not one. Each pane's
20
+ * layer hosts an input and registers it as the pane's focus target while in keyboard mode, asking for
21
+ * the keyboard's input mode. Keys typed there reach the {@link SheetCellEditorStartLayer} as keys
22
+ * aimed at the surface do; this layer starts no edits of its own.
23
+ *
24
+ * Per pane:
25
+ * - **A tap on the grid leaves keyboard mode**: the user has gone back to touching cells. With the
26
+ * store's `keepOnTap` it stays, as Excel keeps its keyboard: the tap does not move focus off the input.
27
+ * - **A focus that reaches the surface itself** in keyboard mode is passed on to the input.
28
+ * - **Leaving keyboard mode** with the input focused hands focus to the surface, lowering the keyboard.
29
+ *
30
+ * The primary pane's layer (the center pane, when there is one) also does the sheet's part, once:
31
+ * - **On and off with the keyboard.** A keyboard rising while the sheet is being edited (in the cell or
32
+ * a formula bar) enters keyboard mode; the keyboard going down (the system's back gesture, its own
33
+ * hide key) leaves it.
34
+ * - **Show.** Entering keyboard mode with focus outside any text field (a "show keyboard" button)
35
+ * focuses the pane, raising the keyboard.
36
+ * - **Done.** Taking a way out of the edit from chrome (the status bar's ✓ / ✕, see `exitEditMode`)
37
+ * leaves keyboard mode before the edit ends, so the focus returning to the grid lowers it.
38
+ * - **The active cell stays in view.** When the keyboard takes room from the grid, or a
39
+ * `KeyboardAccessory` (the formula bar riding the keyboard) settles over the active cell, the cell is
40
+ * scrolled back into view (unless the store's `disableScrollIntoView`).
41
+ *
42
+ * Mount it directly above the start layer, so a key typed into the input reaches the start layer's
43
+ * floor. It renders nothing where the keyboard store is not enabled (`isEnabled()`: a device with no
44
+ * virtual keyboard).
45
+ */
46
+ export declare function VirtualKeyboardLayer(props: VirtualKeyboardLayerProps): React.ReactElement | null;
47
+ export declare namespace VirtualKeyboardLayer {
48
+ var displayName: string;
49
+ }
50
+ //# sourceMappingURL=VirtualKeyboardLayer.d.ts.map
@@ -0,0 +1,12 @@
1
+ import { IWorkbook, IWorksheet } from '@sheetxl/sdk';
2
+ /**
3
+ * The worksheet an editor parses formula text against: the selected worksheet, or, while a sheet of
4
+ * another kind is the active tab, the first worksheet. `null` for a workbook with no worksheet.
5
+ *
6
+ * @remarks
7
+ * Only the parse is anchored here. A field that has a home passes it as the coords (`scope`), and a
8
+ * reference that names its sheet names it; what is left is text with no sheet of its own, which a
9
+ * chart sheet cannot be home to.
10
+ */
11
+ export declare const formulaAnchorSheet: (workbook: IWorkbook | null | undefined) => IWorksheet | null;
12
+ //# sourceMappingURL=formulaAnchor.d.ts.map
@@ -59,9 +59,10 @@ export declare const EVAL_RUN_STYLE: CSSProperties;
59
59
  */
60
60
  export declare const EVAL_RUN_OUTLINE_STYLE: CSSProperties;
61
61
  /**
62
- * The hue for a paren at `depth` (0 = outermost), cycling once the palette is exhausted.
63
- * Theme-adaptive: emits `light-dark(light, dark)` so the browser re-picks from the subtree's
64
- * `color-scheme` with no re-render — no `darkMode` flag needed (see `IColor.CSSMode`'s `'adaptive'`).
62
+ * The hue for a paren at `depth` (0 = outermost): the `color-bracket` token, cycling once the palette is
63
+ * exhausted. A pair shares one hue and nesting rotates it, so which `)` closes which `(` reads at a glance
64
+ * in a deep formula without moving the caret there. Not the `color-series` palette the references use:
65
+ * parens and references sit in the same line of text and have to stay tellable apart.
65
66
  */
66
67
  export declare const parenDepthColor: (depth: number) => string;
67
68
  /**
@@ -1,4 +1,5 @@
1
1
  export * from './SheetEditable';
2
+ export * from './validationAlert';
2
3
  export * from './formulaText';
3
4
  export * from './formulaEval';
4
5
  export * from './useReferenceMode';
@@ -15,6 +16,7 @@ export * from './EditorCommands';
15
16
  export * from './useEditRejectedNotice';
16
17
  export * from './SheetCellEditorLayer';
17
18
  export * from './SheetCellEditorStartLayer';
19
+ export * from './VirtualKeyboardLayer';
18
20
  export * from './SheetReferenceLayer';
19
21
  export * from './SheetReferenceHeaderLayer';
20
22
  //# sourceMappingURL=index.d.ts.map
@@ -1,5 +1,5 @@
1
1
  import { RangeCoords } from '@sheetxl/utils';
2
- import { ICalculation, ICell, IRange, ISheet } from '@sheetxl/sdk';
2
+ import { ICalculation, ICell, IRange, IWorksheet } from '@sheetxl/sdk';
3
3
  /**
4
4
  * The text a range picked on the grid writes into a formula edited at `cell` — shared by the cell
5
5
  * editor's two picker write-backs (re-scope and insert) so a pick writes the same text however it
@@ -42,7 +42,7 @@ export declare const namedReference: (cell: ICell, to: RangeCoords) => string |
42
42
  *
43
43
  * @param sheet Any sheet of the workbook — resolves `range.scope` (its own sheet when unscoped).
44
44
  */
45
- export declare const isSpillExtent: (sheet: ISheet, range: RangeCoords) => boolean;
45
+ export declare const isSpillExtent: (sheet: IWorksheet, range: RangeCoords) => boolean;
46
46
  /**
47
47
  * The spill reference (`D2#`) a picked range exactly is, or `null`.
48
48
  *
@@ -72,5 +72,5 @@ export declare const spillReference: (cell: ICell, to: RangeCoords, flags?: IRan
72
72
  * @param tokens The formula's tokens; the `#` anchor token carries its reference's `referenceIndex`.
73
73
  * @param ranges Index-aligned with `referenceIndex`. Returned as-is when nothing widens.
74
74
  */
75
- export declare const expandSpillAnchors: (sheet: ISheet, tokens: readonly ICalculation.FormulaToken[], ranges: (RangeCoords | null)[]) => (RangeCoords | null)[];
75
+ export declare const expandSpillAnchors: (sheet: IWorksheet, tokens: readonly ICalculation.FormulaToken[], ranges: (RangeCoords | null)[]) => (RangeCoords | null)[];
76
76
  //# sourceMappingURL=pickedReference.d.ts.map
@@ -1,5 +1,5 @@
1
1
  import { CellCoords } from '@sheetxl/utils';
2
- import { ISheet } from '@sheetxl/sdk';
2
+ import { IWorksheet } from '@sheetxl/sdk';
3
3
  /**
4
4
  * The callback a host invokes on each rejected edit attempt.
5
5
  *
@@ -24,9 +24,9 @@ export type EditRejectedNotice = (coords?: CellCoords | null, retry?: () => void
24
24
  *
25
25
  * Any other non-editable reason stays silent.
26
26
  *
27
- * One instance should serve one visit scope — `SheetElement` creates it and threads the callback to
27
+ * One instance should serve one visit scope — `WorksheetElement` creates it and threads the callback to
28
28
  * every consumer it hosts (its imperative `startEdit` and each pane's editor layer), so four frozen
29
29
  * panes never warn four times.
30
30
  */
31
- export declare const useEditRejectedNotice: (sheet: ISheet) => EditRejectedNotice;
31
+ export declare const useEditRejectedNotice: (sheet: IWorksheet) => EditRejectedNotice;
32
32
  //# sourceMappingURL=useEditRejectedNotice.d.ts.map
@@ -17,7 +17,7 @@ import { FormulaArgument } from './functionArgs';
17
17
  * localized name is what gets inserted, and that is correct: the editing compiler binds it back to
18
18
  * canonical and storage stays canonical. Capped at {@link MAX_FUNCTION_RESULTS} *before* the merge.
19
19
  * - **Names and tables** — one collection (a table is an `INamed` whose `getType()` is `'table'`).
20
- * Pass the SHEET's (`ISheet.getNames()`), which already holds exactly what a formula written there
20
+ * Pass the SHEET's (`IWorksheet.getNames()`), which already holds exactly what a formula written there
21
21
  * can refer to, shadowing resolved — the workbook's would offer other sheets' private names.
22
22
  * Deliberately NOT localized: a defined name is the user's own text, spelled the same in every
23
23
  * language. A name whose body is `LAMBDA(…)` is offered as `'lambda'`, completed like a function.
@@ -138,7 +138,7 @@ export interface UseFormulaHintsOptions {
138
138
  * then holds functions only, exactly as before.
139
139
  *
140
140
  * @remarks
141
- * Must be the SHEET's collection (`ISheet.getNames()`), not the workbook's: that one holds exactly
141
+ * Must be the SHEET's collection (`IWorksheet.getNames()`), not the workbook's: that one holds exactly
142
142
  * what a formula on that sheet can refer to, so no scoping is needed here. The workbook's would
143
143
  * offer another sheet's private names, which complete to expressions that do not resolve.
144
144
  */
@@ -195,7 +195,7 @@ export interface FormulaHintsApi {
195
195
  */
196
196
  getAnchorOffset(): number;
197
197
  /**
198
- * STABLE-identity panel renderer for `useFloatStack.createPopupPanel` — the autocomplete list when
198
+ * STABLE-identity panel renderer for `useFloatStack.renderPopupPanel` — the autocomplete list when
199
199
  * it has matches, else the signature preview. Returns `null` when there is nothing to show.
200
200
  */
201
201
  renderPanel(): React.ReactNode;
@@ -31,7 +31,8 @@ export type FormulaInputGrammar = 'formula' | 'reference';
31
31
  * - `'literal'` — the `=` DECIDES: text with a leading `=` is a formula (parsed, colored, validated),
32
32
  * text without one is a literal that is never parsed and never an error — Excel's own cellIs/DV
33
33
  * operand box. A committed string value displays verbatim; the `=` is the one discriminator, so
34
- * the field adds none and strips none.
34
+ * the field adds none and strips none. Pointing follows it too: the field arms for grid picks
35
+ * only while its text starts with `=`, so Escape back to a literal (or to nothing) disarms.
35
36
  */
36
37
  export type FormulaInputEquals = 'optional' | 'required' | 'bare' | 'literal';
37
38
  export declare const splitReferenceSegments: (text: string) => {
@@ -94,7 +95,8 @@ export interface UseFormulaInputOptions {
94
95
  * still runs — error state, picker sync), `'done'` makes Enter the FIELD's commit point rather than
95
96
  * a key the host form sees (the shared policy — see `useEditCommit`) — plus one grammar-specific
96
97
  * effect here: a `'done'` reference field drops to caret-edit while the user TYPES (a pick re-arms),
97
- * where a `'live'` one points for its whole engagement (the RefEdit contract).
98
+ * where a `'live'` one points for its whole engagement (the RefEdit contract). A field's ✓/✗
99
+ * adornments follow it too: `'done'` only.
98
100
  */
99
101
  changeOn?: 'live' | 'done';
100
102
  /**
@@ -262,7 +264,8 @@ export interface FormulaInputApi {
262
264
  * - `'formula'` — armed by CARET CONTEXT (the cell editor's model): an operand expected at the
263
265
  * caret, or the caret on a reference token. Elsewhere (a function name, a number) the caret does
264
266
  * text work — and the bus drops to `'show'`, so the references stay displayed (rectangles still
265
- * drag-to-re-scope) while fresh grid gestures don't splice into the middle of a token.
267
+ * drag-to-re-scope) while fresh grid gestures don't splice into the middle of a token. A
268
+ * `'literal'` field is armed only while its text starts with `=`: empty or bare, nothing points.
266
269
  */
267
270
  pointArmed: boolean;
268
271
  /** Arm/disarm picking without focus (the adornment toggle). */
@@ -0,0 +1,24 @@
1
+ import { CellCoords } from '@sheetxl/utils';
2
+ import { IWorksheet, IDataValidation } from '@sheetxl/sdk';
3
+ /**
4
+ * The alert a typed entry raised: the rule it failed, and the cell it was typed into.
5
+ */
6
+ export interface ValidationAlert {
7
+ /** The sheet the entry was typed on. */
8
+ sheet: IWorksheet;
9
+ /** The cell the entry was typed into, as the edit session names it: with its sheet scope. */
10
+ coords: CellCoords;
11
+ /** The text that was typed. A Warning accepts the same text entered again. */
12
+ dirty: string;
13
+ /** The rule that refused it. */
14
+ dataValidation: IDataValidation;
15
+ /** The rule's alert style. */
16
+ style: IDataValidation.AlertStyle;
17
+ }
18
+ /** Raise `alert`, or (`null`) clear the one showing. */
19
+ export declare const setValidationAlert: (alert: ValidationAlert | null) => void;
20
+ /** The alert showing, on any sheet. */
21
+ export declare const getValidationAlert: () => ValidationAlert | null;
22
+ /** The alert showing on `sheet` (reactive). */
23
+ export declare const useValidationAlert: (sheet: IWorksheet) => ValidationAlert | null;
24
+ //# sourceMappingURL=validationAlert.d.ts.map
@@ -26,13 +26,16 @@ export interface FormulaInputProps extends Omit<React.InputHTMLAttributes<HTMLIn
26
26
  onChangeText?: (text: string) => void;
27
27
  /** The commit channel. See `UseFormulaInputOptions.onDone`. */
28
28
  onDone?: (value: ICalculation.IFormula | null, args: ReferenceDoneArgs) => void;
29
- /** `'done'` suppresses the live notifications — the host hears only `onDone`. Default `'live'`. */
29
+ /**
30
+ * `'done'` suppresses the live notifications — the host hears only `onDone` — and shows the ✓/✗
31
+ * while the text differs from the committed value. Default `'live'`. See `UseFormulaInputOptions.changeOn`.
32
+ */
30
33
  changeOn?: 'live' | 'done';
31
34
  /** Resolution/picking context. Defaults to the enclosing `WorkbookContext`. */
32
35
  workbook?: IWorkbook | null;
33
36
  /** The headless field API, for host-driven commit points (a dialog's OK → `apiRef.current?.commit()`). */
34
37
  apiRef?: React.Ref<FormulaInputApi>;
35
- /** Hide the adornment cluster (✓/✗ while engaged in modal mode; the select-current action). */
38
+ /** Hide the adornment cluster (✓/✗ while editing in `'done'` mode; the select-current action). */
36
39
  hideAdornment?: boolean;
37
40
  /** Hide the error line under the field (hosts that surface `api.error` themselves). */
38
41
  hideError?: boolean;
@@ -51,7 +51,10 @@ export interface UseEditCommitOptions<V> {
51
51
  /**
52
52
  * `'done'` suppresses the live {@link onChange} notifications entirely (parsing still runs, so the
53
53
  * error state and the commit-channel value stay current) and makes Enter the field's OWN commit
54
- * point rather than a key the host form gets to see. Default `'live'`.
54
+ * point rather than a key the host form gets to see. A field's ✓/✗ adornments follow it: shown only
55
+ * in `'done'`, while the text differs from the committed value. Default `'live'`.
56
+ *
57
+ * It does not change when {@link onDone} fires — that is the same in both.
55
58
  */
56
59
  changeOn?: 'live' | 'done';
57
60
  /** The live PREVIEW channel — every valid text state. */
@@ -114,8 +117,17 @@ export interface EditCommitApi<V> {
114
117
  revertToCommitted(): void;
115
118
  /** Restore the session-start text (a cancel) and re-parse it. */
116
119
  revertToBaseline(): void;
117
- /** Adopt `next` as the committed text (an outside value change): clean, unerrored, revert target. */
118
- resetCommitted(next: string, value?: V | null): void;
120
+ /**
121
+ * Adopt `next` as the committed text (an outside value change): clean, unerrored, revert target.
122
+ *
123
+ * While the user is EDITING (a session open and touched) the text is theirs: `next` becomes the
124
+ * committed text but the display keeps what they typed, and the next accept shows `next` — see the
125
+ * module doc.
126
+ *
127
+ * @returns `false` when the display was left alone for that reason — its error state is still the
128
+ * typed text's, so the host must not overwrite it with `next`'s.
129
+ */
130
+ resetCommitted(next: string, value?: V | null): boolean;
119
131
  /** A session is starting: the CURRENT text becomes the cancel baseline. */
120
132
  beginSession(): void;
121
133
  /**
@@ -147,6 +159,9 @@ export interface EditCommitApi<V> {
147
159
  *
148
160
  * The rules it owns, once, for every field:
149
161
  *
162
+ * - **Two channels, one mode.** `onChange` is the value while it is edited; `onDone` is the edit
163
+ * ending. `changeOn` governs only the first (and who owns Enter): an edit ENDS the same way in
164
+ * both modes — Enter, Tab, a blur to another input, the ✓/✗, `commit()`/`cancel()`, Escape.
150
165
  * - **Two baselines.** `committedText` is the last ACCEPTED value; `baselineText` is the text when the
151
166
  * current session started. They differ because the live-change model applies every intermediate
152
167
  * change — "the value before" can then only mean before-the-session, not before-the-last-change.
@@ -161,6 +176,11 @@ export interface EditCommitApi<V> {
161
176
  * CANCELS instead of committing, so focus never advances carrying an error.
162
177
  * - **Invalid never commits** on any accept path; **blur commits only when dirty**; and a done key
163
178
  * plus the blur it causes are ONE gesture, delivered once (the one-shot guard).
179
+ * - **The text is the user's while they edit.** A live host echoes each change back as its value, and
180
+ * the echo is often the value NORMALIZED (`09` → `9`, `9/2` → `9/2/2026`). Rewriting the display
181
+ * with it would retype the field under the caret, so an outside value that lands mid-edit only
182
+ * becomes the committed text; the accept that ends the edit shows it. An untouched field follows
183
+ * outside changes at once.
164
184
  * - **The input owns its text keys.** Delete / caret motion / the native chords are consumed
165
185
  * ({@link EditCommitApi.handleTextKeys}) so they never reach the app's command dispatch.
166
186
  *
@@ -56,9 +56,8 @@ export interface InputFieldApi {
56
56
  /** `true` when the text differs from the committed value's text. */
57
57
  dirty: boolean;
58
58
  /**
59
- * `true` while an edit SESSION is open — for a plain field that means focused (or edited while
60
- * focus stayed after a commit), and it is what the modal ✓/✗ adornments key off. A done key ends
61
- * the session even though focus stays, exactly like the formula field's engagement.
59
+ * `true` while an edit SESSION is open — for a plain field, while it is focused. A done key ends the
60
+ * session and, focus staying, a fresh one starts — exactly like the formula field's engagement.
62
61
  */
63
62
  engaged: boolean;
64
63
  /** Restore the committed value's text (the field-level Escape). */
@@ -1,4 +1,5 @@
1
- import { IRange, ICell, ICellRanges, ICellRange, IColor, ITable, INamedCollection, IStyleCollection, IStyle, IBorders, ITheme, IThemeCollection, IFunction, IFunctionCollection, IWorkbook } from '@sheetxl/sdk';
1
+ import { IRange, ICell, ICellRanges, ICellRange, IColor, ITable, INamedCollection, IStyleCollection, ICellStyle, IBorders, ITheme, IThemeCollection, IFunction, IFunctionCollection, IWorkbook, ISlicer, IChart, IPivotTable, ISparklineGroup } from '@sheetxl/sdk';
2
+ import { PivotFieldsModel } from '../pivot/PivotFieldsModel';
2
3
  /**
3
4
  * For providing Adjustable Color Commands additional rendering capabilities.
4
5
  *
@@ -25,7 +26,7 @@ export interface Border {
25
26
  onBorderSelect: (border: Partial<IBorders.Properties>) => void;
26
27
  }
27
28
  export interface NamedStyle {
28
- readonly named: () => IStyle.INamed;
29
+ readonly named: () => ICellStyle.INamed;
29
30
  readonly styles: () => IStyleCollection;
30
31
  createCell: (update: ICell.Update) => ICell;
31
32
  }
@@ -46,6 +47,45 @@ export interface Table {
46
47
  */
47
48
  resolveRanges: (address: ICellRanges.Address) => ICellRanges;
48
49
  }
50
+ /** What the pivot table style gallery draws its previews with: the active pivot table and the workbook's styles. */
51
+ export interface Pivot {
52
+ /** `null` when the selection is in no pivot table. */
53
+ readonly pivot: () => IPivotTable | null;
54
+ readonly styles: () => IStyleCollection;
55
+ }
56
+ /** The pivot value settings window's value: one value of a pivot table, and what to change. */
57
+ export interface PivotValueSettings {
58
+ /** The value. The window starts from its settings, and reads its table's fields and their items. */
59
+ readonly value: IPivotTable.IDataField;
60
+ /** What the window hands back: the settings changed, the rest left out. */
61
+ readonly changes?: PivotFieldsModel.ValueSettings;
62
+ }
63
+ /** What a slicer-style gallery draws its previews with. */
64
+ export interface Slicer {
65
+ readonly slicer: () => ISlicer;
66
+ readonly styles: () => IStyleCollection;
67
+ }
68
+ /** What a chart's galleries (its type, its elements) read: the active chart. */
69
+ export interface Chart {
70
+ readonly chart: () => IChart;
71
+ }
72
+ /**
73
+ * What Insert Slicer offers: the fields a slicer can filter by, and the one the active cell is in,
74
+ * which a press filters by.
75
+ */
76
+ export interface InsertSlicer {
77
+ /** A table's column names, or a pivot table's field names, in order. */
78
+ readonly fields: () => readonly string[];
79
+ /** The field the active cell is in; `null` when it is in none, as on a pivot table's values. */
80
+ readonly anchor: () => string | null;
81
+ }
82
+ /** What Insert Slicer adds. Each omitted: the field the active cell is in, in the default slicer style. */
83
+ export interface InsertSlicerOptions {
84
+ /** One of {@link InsertSlicer.fields}. */
85
+ field?: string;
86
+ /** A slicer style's name. */
87
+ style?: string;
88
+ }
49
89
  export interface Theme {
50
90
  readonly theme: ITheme;
51
91
  readonly themes: IThemeCollection;
@@ -59,7 +99,7 @@ export interface NamedReference {
59
99
  }
60
100
  /**
61
101
  * Used for the workbook-statistics dialog — the dialog profiles the live workbook itself
62
- * (`IWorkbook.getStats` / `ISheet.getStats`), so the context is just the model getter.
102
+ * (`IWorkbook.getStats` / `IWorksheet.getStats`), so the context is just the model getter.
63
103
  */
64
104
  export interface WorkbookStatistics {
65
105
  getWorkbook: () => IWorkbook;
@@ -74,12 +114,70 @@ export interface ResizeHeaderContext {
74
114
  toUnits?(value: number): number;
75
115
  toPixels?(value: number): number;
76
116
  }
117
+ /**
118
+ * The one group a Show / Hide Detail command acts on, named by its summary header; without it the
119
+ * command acts on the selection.
120
+ */
121
+ export interface OutlineTarget {
122
+ axis: IRange.Axis;
123
+ /** The summary row or column, zero-based. */
124
+ index: number;
125
+ }
126
+ /** A gutter button's press: expand (`show`) or collapse the group whose summary this is. */
127
+ export interface OutlineToggle extends OutlineTarget {
128
+ show: boolean;
129
+ }
130
+ /** The level a level button shows: `level` on `axis`. */
131
+ export interface OutlineLevel {
132
+ axis: IRange.Axis;
133
+ level: number;
134
+ }
135
+ /** The outline settings window's value. */
136
+ export interface OutlineSettings {
137
+ /** Summary rows below their details (else above). */
138
+ summaryBelow: boolean;
139
+ /** Summary columns to the right of their details (else to the left). */
140
+ summaryRight: boolean;
141
+ /** Apply the automatic outline styles. */
142
+ automaticStyles: boolean;
143
+ }
77
144
  export interface NewTable {
78
145
  ranges: ICellRanges;
79
146
  hasHeader?: boolean;
80
147
  /** The table's name. When omitted the next free default name is used. */
81
148
  name?: string;
82
149
  }
150
+ /** What the Create Sparklines dialog makes, as `ICellRange.setSparkline` takes it. */
151
+ export interface NewSparklines {
152
+ /** The cells the sparklines draw: one area, on any sheet. */
153
+ data: ICellRanges | null;
154
+ /** The cells they draw in: one cell, or one row or one column of cells. */
155
+ location: ICellRanges | null;
156
+ type: ISparklineGroup.Type;
157
+ }
158
+ /** What the Edit Sparklines dialog changes, as `ISparklineGroup.setRanges` takes it. */
159
+ export interface EditSparklines {
160
+ /** The cells the sparklines draw: one or more areas, as `ISparklineGroup.getData` spells them. */
161
+ data: ICellRanges | string | null;
162
+ /** The cells they draw in: one or more areas, each a cell, a row or a column of cells. */
163
+ location: ICellRanges | null;
164
+ }
165
+ /** What the New PivotTable dialog makes, as `IPivotTableCollection.add` takes it. */
166
+ export interface NewPivotTable {
167
+ /** The cells to summarize: one range, or a table's or defined name's name. */
168
+ source: ICellRanges | string | null;
169
+ /** The table's top-left cell. */
170
+ location: ICellRanges | null;
171
+ /** The table's name. When omitted the next free default name is used. */
172
+ name?: string;
173
+ }
174
+ /** What the New PivotTable dialog asks of the workbook while it is open. */
175
+ export interface PivotTableTarget {
176
+ /** Throws for a name a new table cannot take on the sheet `location` is on. */
177
+ validateName(name: string, location: ICellRanges | null): void;
178
+ /** Why a new table cannot go at `location`, as a message key; `null` when it can. */
179
+ checkLocation(location: ICellRanges): string | null;
180
+ }
83
181
  export interface SelectedRange {
84
182
  range: ICellRange;
85
183
  cell?: ICell.Address;
@@ -0,0 +1,25 @@
1
+ import { default as React } from 'react';
2
+ import { IMovable } from '@sheetxl/sdk';
3
+ import { MovableElementProps } from '../movable';
4
+ export interface GroupEditorProps extends MovableElementProps {
5
+ /** The content of a movable that holds movables ({@link IMovable.getMovables}): a group. */
6
+ container: IMovable.IContent;
7
+ ref?: React.Ref<HTMLDivElement>;
8
+ }
9
+ /**
10
+ * Content that holds movables, in the sheet: a container that draws each member with the
11
+ * renderer of its own kind, where the member says it is drawn.
12
+ *
13
+ * @remarks
14
+ * A member answers its placement on the canvas, so the members are laid out in canvas pixels in
15
+ * one box whose transform takes the canvas back into the frame: it undoes the frame's turn and
16
+ * mirror about the frame's center. While the group itself is in a gesture, the same transform
17
+ * maps the committed frame onto the gesture's, so the members follow it before it commits (a plain
18
+ * stretch, without the quadrant rule, until the drop). A member's box carries its id, so a press
19
+ * on it reaches the member (Excel's two-step), and a member's own gesture draws its preview here.
20
+ * Nothing here is a hit target but what the members paint and, while the group is selected, its
21
+ * edge: a group paints nothing of its own, so its outline is where a press grabs the group itself
22
+ * rather than a member, as Excel drags a selected group by its frame.
23
+ */
24
+ export declare const GroupEditor: React.NamedExoticComponent<Omit<GroupEditorProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
25
+ //# sourceMappingURL=GroupEditor.d.ts.map
@@ -5,10 +5,12 @@ export * from './editor';
5
5
  export * from './selection';
6
6
  export * from './border';
7
7
  export * from './sheet';
8
+ export * from './annotation';
9
+ export * from './presence';
8
10
  export * from './picture';
11
+ export * from './slicer';
9
12
  export * from './shape';
10
13
  export * from './chart';
11
- export * from './slicer';
12
14
  export * from './comment';
13
15
  export * from './richText';
14
16
  export * from './movable';
@@ -17,12 +19,19 @@ export * from './editableLabel';
17
19
  export * from './tabStrip';
18
20
  export * from './icons';
19
21
  export * from './layer/ConditionalIcons';
22
+ export { SheetLayers, DefaultSheetLayersRegistry, useGridSurface, type SheetLayersProps, type SheetLayersFilter, type SheetSurface, type SheetLayersEntry, type ISheetLayersRegistry } from './layer/SheetLayers';
23
+ export * from './layer/CellInsertLayer';
24
+ export * from './layer/HyperlinkLayer';
25
+ export type { RangeToolbarRenderProps } from './layer/RangeToolbar';
26
+ export type { TableToolbarRenderProps } from './layer/TableToolbar';
27
+ export type { PivotToolbarRenderProps } from './layer/PivotToolbar';
20
28
  export * from './picker';
21
29
  export * from './checklist';
22
30
  export * from './conditionalFormat';
23
31
  export * from './autoFill';
24
32
  export * from './protection';
25
33
  export * from './externalLink';
34
+ export * from './pivot';
26
35
  export * from './clipboard';
27
36
  export * from './commands';
28
37
  export * from './undo';
@@ -1,14 +1,17 @@
1
- import { IRange, ISheet, ICell } from '@sheetxl/sdk';
1
+ import { IRange, IWorksheet, ICell } from '@sheetxl/sdk';
2
2
  import { LayerProps, IGridPane } from '@sheetxl/grid-react';
3
+ import { BordersCache } from '../border';
3
4
  export interface BorderLayerProps extends LayerProps {
4
5
  /** Class for the borders host box (devtools identification). */
5
6
  className?: string;
6
- sheet: ISheet;
7
+ sheet: IWorksheet;
7
8
  getVisibleCells: (pane: IGridPane) => {
8
9
  cell: ICell.Coords;
9
10
  value?: ICell;
10
11
  range?: IRange.Coords;
11
12
  }[];
13
+ /** Shared with the {@link SheetGridLineLayer} that draws the same cells. */
14
+ bordersCache?: BordersCache;
12
15
  }
13
16
  export declare const BorderLayer: import('react').NamedExoticComponent<BorderLayerProps & import('react').RefAttributes<HTMLDivElement>>;
14
17
  //# sourceMappingURL=BorderLayer.d.ts.map
@@ -1,6 +1,6 @@
1
1
  import { default as React } from 'react';
2
2
  import { RangeCoords } from '@sheetxl/utils';
3
- import { ICalculation, IRange, ISheet } from '@sheetxl/sdk';
3
+ import { ICalculation, IRange, IWorksheet } from '@sheetxl/sdk';
4
4
  import { StickyState, GridPlacement, LayerProps } from '@sheetxl/grid-react';
5
5
  import { ValidationMark } from './validationMark';
6
6
  /** The kind of annotation a cell carries (drives the default tip styling). */
@@ -11,6 +11,13 @@ export interface CellErrorTip {
11
11
  range: RangeCoords;
12
12
  /** `getErrors()` (preferred) or `getWarnings()` joined by newline. */
13
13
  message: string;
14
+ /**
15
+ * The error the cell shows (`#DIV/0!`, as displayed), when its value is one. `kind === 'error'` only;
16
+ * `message` is then the error's own message, empty when it carries none.
17
+ */
18
+ code?: string;
19
+ /** What that kind of error means, in general — not this cell's particulars. With {@link code}. */
20
+ description?: string;
14
21
  /** Which list the message came from. */
15
22
  kind: CellErrorKind;
16
23
  /** The resolved sticky state (e.g. `state.scrollIntoView()` to reveal the cell). */
@@ -37,12 +44,15 @@ export interface CellErrorLayerProps extends Omit<LayerProps, 'children'> {
37
44
  /** Class forwarded to the inner layer's host box (devtools identification). */
38
45
  className?: string;
39
46
  /** The sheet whose cells are probed for `getErrors()` / `getCircularReference()` / `getWarnings()`. */
40
- sheet: ISheet;
41
- /** Which side of the cell the tip attaches to. @defaultValue `{ side: 'r', align: 'start' }` */
47
+ sheet: IWorksheet;
48
+ /** Which side of the cell the tip attaches to. @defaultValue `{ side: 'b', align: 'start' }`, as the input prompt's */
42
49
  placement?: GridPlacement;
43
50
  /** Gap (px) between the cell edge and the tip. @defaultValue 6 */
44
51
  offset?: number;
45
- /** Offset (px) along the cell edge — only applies to `start` / `end` align (inset from the corner). @defaultValue 2 */
52
+ /**
53
+ * Offset (px) along the cell edge, from the corner `align` names. Omitted, the tip starts `offset`
54
+ * past the cell's right edge, as the input prompt does.
55
+ */
46
56
  alignOffset?: number;
47
57
  /** Dwell (ms) before the tip shows. @defaultValue 300 */
48
58
  openDelay?: number;
@@ -50,13 +60,14 @@ export interface CellErrorLayerProps extends Omit<LayerProps, 'children'> {
50
60
  closeDelay?: number;
51
61
  /**
52
62
  * Optional custom tip renderer. Spread `tipProps` (from context via `useSticky`, or reuse the
53
- * default) onto the returned element to keep the tip open while hovered. Omit for the default pill.
63
+ * default) onto the returned element to keep the tip open while hovered. Omit for the default card;
64
+ * `null` for none.
54
65
  */
55
- renderTip?: (tip: CellErrorTip) => React.ReactNode;
66
+ renderTip?: ((tip: CellErrorTip) => React.ReactNode) | null;
56
67
  }
57
68
  /**
58
69
  * A grid layer that shows a **hover tooltip on cells carrying errors / warnings**. A thin
59
- * {@link HoverTipLayer} whose probe asks the sheet — `getErrors()`, then
70
+ * {@link RangeTooltipLayer} whose probe asks the sheet — `getErrors()`, then
60
71
  * `getCircularReference()`, then the data validations the value fails, then `getWarnings()` — and
61
72
  * anchors on the cell's own range; the tip stays open while hovered. `getComments()` is not yet
62
73
  * wired (unimplemented in the model).
@@ -1,10 +1,10 @@
1
1
  import { default as React } from 'react';
2
- import { IRange, ISheet, ICell } from '@sheetxl/sdk';
2
+ import { IRange, IWorksheet, ICell } from '@sheetxl/sdk';
3
3
  import { IGridPane, LayerProps } from '@sheetxl/grid-react';
4
4
  export interface CellFillLayerProps extends LayerProps {
5
5
  /** Style for the fills host box. */
6
6
  style?: React.CSSProperties;
7
- sheet: ISheet;
7
+ sheet: IWorksheet;
8
8
  getVisibleCells: (pane: IGridPane) => {
9
9
  cell: ICell.Coords;
10
10
  value?: ICell;
@@ -0,0 +1,31 @@
1
+ import { default as React } from 'react';
2
+ import { IWorksheet } from '@sheetxl/sdk';
3
+ import { LayerProps } from '@sheetxl/grid-react';
4
+ export interface CellIndicatorLayerProps extends LayerProps {
5
+ /** Class for the layer (devtools identification). */
6
+ className?: string;
7
+ /** Style for the indicators host box. */
8
+ style?: React.CSSProperties;
9
+ /** The sheet whose cells are marked. */
10
+ sheet: IWorksheet;
11
+ /** Size (px, unzoomed) of the error triangle. @defaultValue 7 */
12
+ markSize?: number;
13
+ /** Height (px) of the pending bar. Not zoomed, like a gridline. @defaultValue 2 */
14
+ barHeight?: number;
15
+ }
16
+ /**
17
+ * The marks a cell's **result** earns: the error-checking triangle at the top left of a cell
18
+ * holding an error (or whose calculation failed), and the pending bar along the bottom of a cell
19
+ * whose result has not settled (`ICalculation.ResultStatus.Pending` / `Waiting`).
20
+ *
21
+ * @remarks
22
+ * A {@link CellTileDiv} over the cells in view, so the marks survive scroll and the cell renderer
23
+ * only paints text. The scan resolves only the calc state (and merges, for the box a mark sits
24
+ * in), never styles. `#BUSY!` and `#GETTING_DATA` take no triangle: they are placeholders for an
25
+ * answer still coming, not something to fix. A reference cycle has its own glyph (`CircularIndicatorLayer`); it takes the
26
+ * triangle only when iteration is off, when the cycle is an error (`ICell.getErrors`).
27
+ *
28
+ * Passive paint below the selection (`pointerEvents: none`).
29
+ */
30
+ export declare const CellIndicatorLayer: React.MemoExoticComponent<(props: CellIndicatorLayerProps) => React.JSX.Element | null>;
31
+ //# sourceMappingURL=CellIndicatorLayer.d.ts.map