@sheetxl/react 0.8.0-beta.9 → 1.0.2

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 (398) hide show
  1. package/LICENSE.md +8 -7
  2. package/browser/esm/5B9ljQwRo4GZv5e3.mjs +264 -0
  3. package/browser/esm/B7K16Rzv-QXeNhTf.mjs +197 -0
  4. package/browser/esm/BD3e6d1xxwWiZvhM.mjs +78 -0
  5. package/browser/esm/{Dk6274Lic6AOmEAq.mjs → BIlvSwHzLhtyrkCm.mjs} +84 -2
  6. package/browser/esm/BTkVpKUjjBXs7S4h.mjs +128 -0
  7. package/browser/esm/B_X-eExTurXNj2s6.mjs +134 -0
  8. package/browser/esm/BaXKIZ-EbNXalsn9.mjs +32 -0
  9. package/browser/esm/ByiwVTu3Ax65JzsV.mjs +36 -0
  10. package/browser/esm/CBwGe_8NQ_Zwkd9c.mjs +67 -0
  11. package/browser/esm/CLM5O7S-zDkLuyx4.mjs +323 -0
  12. package/browser/esm/CN3fS0Je4N_gmPLR.mjs +145 -0
  13. package/browser/esm/Cb3fQ74AG3ha3Lbb.mjs +31 -0
  14. package/browser/esm/CyK8M1od0A1rs3IZ.mjs +14092 -0
  15. package/browser/esm/D-wXCKrEuZsj9YPV.mjs +60 -0
  16. package/browser/esm/D3h177x5aS9wsvay.mjs +8 -0
  17. package/browser/esm/DIle1Uzx1TRzW_kQ.mjs +42 -0
  18. package/browser/esm/DLCK6iNnpw8XUOy8.mjs +79 -0
  19. package/browser/esm/DS_YUf92NUAjr5M9.mjs +9560 -0
  20. package/browser/esm/DYLAfjgirgwGJkJo.mjs +20 -0
  21. package/browser/esm/D_KHWbW4C9PQ7G8l.mjs +401 -0
  22. package/browser/esm/DclFKNTfrIjTUqZW.mjs +341 -0
  23. package/browser/esm/DeZNNHG8-BP0qop0.mjs +323 -0
  24. package/browser/esm/WUqAXqTxytEPWXNZ.mjs +63 -0
  25. package/browser/esm/Xab6qjmPHkjnBlcs.mjs +45 -0
  26. package/browser/esm/chart.mjs +41 -0
  27. package/browser/esm/control.mjs +217 -0
  28. package/browser/esm/group.mjs +123 -0
  29. package/browser/esm/index.mjs +21677 -15289
  30. package/browser/esm/note.mjs +112 -0
  31. package/browser/esm/picture.mjs +7 -0
  32. package/browser/esm/shape.mjs +7 -0
  33. package/browser/esm/slicer.mjs +282 -0
  34. package/browser/esm/xismu7oIPMRpfRZN.mjs +19 -0
  35. package/licenses/dependencies.txt +327 -53
  36. package/node/esm/3O4W5uO7Ei1RSamd.mjs +328 -0
  37. package/node/esm/BEmcxv9Cg5uinTCr.mjs +80 -0
  38. package/node/esm/BWuHuJ2nm8MKaUpL.mjs +1697 -0
  39. package/node/esm/Bb39ZMFsvPRb6_sU.mjs +20 -0
  40. package/node/esm/Btwf2pH6R5DrzLlO.mjs +32 -0
  41. package/node/esm/C3_B2QUtmUAAoAbQ.mjs +37 -0
  42. package/node/esm/CIHXrDGerZpH_kWI.mjs +19 -0
  43. package/node/esm/CbEtd-l94dqcicGz.mjs +66 -0
  44. package/node/esm/D06Yw2XsMkKhhpbZ.mjs +406 -0
  45. package/node/esm/D6pwBrfHwDwzCkt6.mjs +128 -0
  46. package/node/esm/DKBxWraRN4fQGsFy.mjs +63 -0
  47. package/node/esm/DPp00qgyktTqWeEp.mjs +68 -0
  48. package/node/esm/Ddz6TmyZPfCk-PXM.mjs +134 -0
  49. package/node/esm/Djwke9rsxOR1tTNb.mjs +8 -0
  50. package/node/esm/DmdPWNpf3d05AFgU.mjs +80 -0
  51. package/node/esm/DsUEK1CBM3dZfY2X.mjs +198 -0
  52. package/node/esm/{B-5p0wwNM6Y5jlI2.mjs → DsgT7qY3nHxDGSws.mjs} +84 -2
  53. package/node/esm/L7XZPzd6aXI7OzdI.mjs +146 -0
  54. package/node/esm/X9lgoicxH_z9hlaw.mjs +45 -0
  55. package/node/esm/chart.mjs +41 -0
  56. package/node/esm/control.mjs +217 -0
  57. package/node/esm/group.mjs +123 -0
  58. package/node/esm/index.mjs +16970 -10477
  59. package/node/esm/note.mjs +113 -0
  60. package/node/esm/oliuGGZGkPQdm6vE.mjs +35 -0
  61. package/node/esm/picture.mjs +326 -0
  62. package/node/esm/s7q4H_VlspTpP2kg.mjs +265 -0
  63. package/node/esm/shape.mjs +342 -0
  64. package/node/esm/slicer.mjs +284 -0
  65. package/package.json +56 -14
  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 +169 -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 +353 -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 +170 -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 +195 -3
  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 +4 -4
  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 +9 -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 +44 -15
  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 +8 -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 +74 -3
  186. package/types/src/group/GroupEditor.d.ts +25 -0
  187. package/types/src/index.d.ts +10 -2
  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 +1 -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 +3 -3
  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 +14 -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 +28 -0
  258. package/types/src/movable/MovableAdornment.d.ts +9 -3
  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 +49 -1
  262. package/types/src/movable/MovableFrame.d.ts +5 -1
  263. package/types/src/movable/MovableLayer.d.ts +30 -5
  264. package/types/src/movable/MovableRenderers.d.ts +166 -11
  265. package/types/src/movable/PlaceholderFrames.d.ts +11 -0
  266. package/types/src/movable/RotateHandle.d.ts +12 -4
  267. package/types/src/movable/connect.d.ts +16 -0
  268. package/types/src/movable/framePlacement.d.ts +44 -1
  269. package/types/src/movable/geometry.d.ts +13 -3
  270. package/types/src/movable/index.d.ts +8 -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 +2 -3
  307. package/types/src/shape/ShapeGallery.d.ts +21 -6
  308. package/types/src/shape/ShapeKind.d.ts +7 -0
  309. package/types/src/shape/ShapeSVG.d.ts +6 -8
  310. package/types/src/shape/index.d.ts +0 -1
  311. package/types/src/shape/shapeFrame.d.ts +46 -2
  312. package/types/src/shape/shapeStyle.d.ts +59 -8
  313. package/types/src/sheet/ISheetHeaderElement.d.ts +3 -3
  314. package/types/src/sheet/{ISheetElement.d.ts → IWorksheetElement.d.ts} +110 -86
  315. package/types/src/sheet/OpaqueSheetElement.d.ts +21 -0
  316. package/types/src/sheet/SheetCommandProvider.d.ts +14 -6
  317. package/types/src/sheet/SheetCommands.d.ts +18 -3
  318. package/types/src/sheet/SheetKindIcon.d.ts +14 -0
  319. package/types/src/sheet/SheetOutlineElement.d.ts +6 -6
  320. package/types/src/sheet/SheetPanels.d.ts +11 -0
  321. package/types/src/sheet/SheetScrollbar.d.ts +4 -13
  322. package/types/src/sheet/TopLeftCorner.d.ts +2 -2
  323. package/types/src/sheet/WorksheetElement.d.ts +12 -0
  324. package/types/src/sheet/_freezeAt.d.ts +10 -0
  325. package/types/src/sheet/_hyperlinkEdit.d.ts +7 -0
  326. package/types/src/sheet/_useHeaderMetrics.d.ts +11 -0
  327. package/types/src/sheet/circularReferences.d.ts +4 -4
  328. package/types/src/sheet/index.d.ts +5 -2
  329. package/types/src/sheet/useCycleHighlight.d.ts +2 -2
  330. package/types/src/slicer/SlicerCommands.d.ts +10 -0
  331. package/types/src/slicer/SlicerEditor.d.ts +8 -2
  332. package/types/src/slicer/SlicerKind.d.ts +7 -0
  333. package/types/src/slicer/SlicerStylePreview.d.ts +18 -0
  334. package/types/src/slicer/index.d.ts +2 -1
  335. package/types/src/slicer/slicerStyles.d.ts +32 -0
  336. package/types/src/sparkline/PictureCache.d.ts +37 -0
  337. package/types/src/sparkline/SparklineCommands.d.ts +23 -0
  338. package/types/src/sparkline/SparklinePictures.d.ts +7 -0
  339. package/types/src/sparkline/paint/_drawing.d.ts +24 -0
  340. package/types/src/sparkline/paint/echarts.d.ts +8 -0
  341. package/types/src/sparkline/paint/index.d.ts +8 -0
  342. package/types/src/tabStrip/SheetTab.d.ts +1 -1
  343. package/types/src/tabStrip/Sortable.d.ts +5 -5
  344. package/types/src/tabStrip/TabStrip.d.ts +13 -6
  345. package/types/src/tabStrip/TabStripItem.d.ts +15 -13
  346. package/types/src/table/TableCommands.d.ts +2 -2
  347. package/types/src/taskPane/CellControlPane.d.ts +15 -0
  348. package/types/src/taskPane/MovablePane.d.ts +15 -0
  349. package/types/src/taskPane/TaskPaneArea.d.ts +7 -0
  350. package/types/src/taskPane/TaskPaneFrame.d.ts +4 -4
  351. package/types/src/taskPane/TaskPaneKeys.d.ts +38 -0
  352. package/types/src/taskPane/TaskPaneRegistry.d.ts +32 -12
  353. package/types/src/taskPane/_paneReasons.d.ts +7 -0
  354. package/types/src/taskPane/index.d.ts +3 -0
  355. package/types/src/taskPane/useTaskPane.d.ts +6 -3
  356. package/types/src/theme/ExplicitTokens.d.ts +18 -0
  357. package/types/src/theme/GridColorSchemeContext.d.ts +8 -0
  358. package/types/src/theme/ThemeRootStyles.d.ts +31 -0
  359. package/types/src/theme/ThemeState.d.ts +2 -2
  360. package/types/src/theme/buildDocThemeCSS.d.ts +4 -1
  361. package/types/src/theme/buildOOXMLThemeCSS.d.ts +2 -2
  362. package/types/src/theme/buildTokensCSS.d.ts +15 -0
  363. package/types/src/theme/index.d.ts +2 -4
  364. package/types/src/theme/useAppColorScheme.d.ts +4 -1
  365. package/types/src/theme/useGridColorScheme.d.ts +9 -4
  366. package/types/src/theme/useSystemColors.d.ts +1 -15
  367. package/types/src/workbook/DefaultMovableRenderers.d.ts +19 -1
  368. package/types/src/workbook/DefaultRenderers.d.ts +5 -4
  369. package/types/src/workbook/IWorkbookElement.d.ts +176 -30
  370. package/types/src/workbook/WorkbookCommands.d.ts +6 -1
  371. package/types/src/workbook/WorkbookStrip.d.ts +14 -5
  372. package/browser/cjs/index.cjs +0 -43
  373. package/browser/cjs/xuAfpHmA2W4MFa_0.cjs +0 -1
  374. package/types/src/chart/templates/area-stacked-percent-template.json.d.ts +0 -10
  375. package/types/src/chart/templates/area-stacked-template.json.d.ts +0 -10
  376. package/types/src/chart/templates/area-template.json.d.ts +0 -9
  377. package/types/src/chart/templates/bar-stacked-percent-template.json.d.ts +0 -10
  378. package/types/src/chart/templates/bar-stacked-template.json.d.ts +0 -10
  379. package/types/src/chart/templates/bar-template.json.d.ts +0 -9
  380. package/types/src/chart/templates/column-stacked-percent-template.json.d.ts +0 -10
  381. package/types/src/chart/templates/column-stacked-template.json.d.ts +0 -10
  382. package/types/src/chart/templates/column-template.json.d.ts +0 -9
  383. package/types/src/chart/templates/line-markers-template.json.d.ts +0 -10
  384. package/types/src/chart/templates/line-stacked-markers-template.json.d.ts +0 -11
  385. package/types/src/chart/templates/line-stacked-percent-markers-template.json.d.ts +0 -11
  386. package/types/src/chart/templates/line-stacked-percent-template.json.d.ts +0 -10
  387. package/types/src/chart/templates/line-stacked-template.json.d.ts +0 -10
  388. package/types/src/chart/templates/line-template.json.d.ts +0 -9
  389. package/types/src/chart/templates/pie-doughnut-template.json.d.ts +0 -10
  390. package/types/src/chart/templates/pie-template.json.d.ts +0 -9
  391. package/types/src/chart/templates/scatter-lines-markers-smooth-template.json.d.ts +0 -10
  392. package/types/src/chart/templates/scatter-lines-markers-template.json.d.ts +0 -10
  393. package/types/src/chart/templates/scatter-lines-smooth-template.json.d.ts +0 -10
  394. package/types/src/chart/templates/scatter-lines-template.json.d.ts +0 -10
  395. package/types/src/chart/templates/scatter-markers-template.json.d.ts +0 -10
  396. package/types/src/context/SheetContext.d.ts +0 -18
  397. package/types/src/control/index.d.ts +0 -2
  398. package/types/src/sheet/SheetElement.d.ts +0 -15
@@ -0,0 +1,165 @@
1
+ import { IWorkbook } from '@sheetxl/sdk';
2
+ import { RangeAnnotation } from '../annotation';
3
+ import { PresenceHost } from './PresenceHost';
4
+ import { PresenceLogEntry, PresencePrompt, PresencePromptQuestion, PresencePromptQuestionAnswer, PresenceStatus } from './PresenceTypes';
5
+ /** Everything the views read, for the bound session. Immutable; a new object on every change. */
6
+ export interface PresenceSnapshot {
7
+ /** The session the views are showing. `null` before a workbook is bound. */
8
+ sessionId: string | null;
9
+ workbook: IWorkbook | null;
10
+ /** The name of the sheet in view — decides whether a prompt pins to its cells or centers. */
11
+ sheetInView: string | null;
12
+ /**
13
+ * Every finding for the session (all intents, open and stale), in review order. Only the session's
14
+ * own annotations: other writers' are not presence.
15
+ */
16
+ findings: readonly RangeAnnotation[];
17
+ /** The session's findings the navigator walks: open `finding` and `question`, in review order. */
18
+ navigable: readonly RangeAnnotation[];
19
+ /** The navigator's current finding, when it is one of the session's. */
20
+ current: RangeAnnotation | null;
21
+ /** Every finding the agent raised this session, open or dismissed, newest first. */
22
+ log: readonly PresenceLogEntry[];
23
+ /** The agent's `working` cursor (where it is about to write) while it is up. */
24
+ working: RangeAnnotation | null;
25
+ /** 1-based position of {@link current} in {@link navigable}; `0` when there is none. */
26
+ position: number;
27
+ /** The pending prompt, if the agent is waiting on the user. */
28
+ prompt: PresencePrompt | null;
29
+ /** The step of {@link prompt} on screen (0-based). */
30
+ promptStep: number;
31
+ /** The question on screen: `prompt.questions[promptStep]`. */
32
+ promptQuestion: PresencePromptQuestion | null;
33
+ /** What the user has chosen so far, by step; `undefined` for a step not yet answered. */
34
+ promptAnswers: readonly (PresencePromptQuestionAnswer | undefined)[];
35
+ /**
36
+ * Where the prompt's dialog opens: just below the first question's cells, in viewport pixels.
37
+ * `undefined` until a grid pane has measured them (or forever, when it cannot — then centered).
38
+ */
39
+ promptAnchor: {
40
+ x: number;
41
+ y: number;
42
+ } | undefined;
43
+ status: PresenceStatus;
44
+ /**
45
+ * The agent is waiting on the user — a prompt is pending. Distinct from findings: a prompt needs
46
+ * the user now, findings wait for them. Never counted together, and tool calls never count.
47
+ */
48
+ needsAttention: boolean;
49
+ }
50
+ /**
51
+ * Someone else working in the view: their findings, their working cursor, their prompt and status,
52
+ * for one session. The findings are the workbook's range annotations, written with the session as
53
+ * their `source`, fed by the host's `highlight` events and read back here so the views see one
54
+ * snapshot.
55
+ *
56
+ * @remarks
57
+ * Shows one session: the workbook passed to {@link bind}. A `highlight` for a session that is not
58
+ * bound yet is kept until it is (the workbook may still be loading); one for another session is
59
+ * dropped, since there is nothing to draw it on.
60
+ *
61
+ * The host hears about dismissals from the annotation store's events, so a dismissal from the
62
+ * grid's tag, from a list, or from a command reaches it the same way.
63
+ */
64
+ export declare class PresenceStore {
65
+ private readonly host;
66
+ private readonly _listeners;
67
+ private readonly _prompts;
68
+ private readonly _pendingHighlights;
69
+ private readonly _log;
70
+ private readonly _removeHost;
71
+ private _removeWorkbook;
72
+ private _removeAnnotations;
73
+ private _removeTransactions;
74
+ private _workbook;
75
+ private _sessionId;
76
+ private _sheetInView;
77
+ private _status;
78
+ private _snapshot;
79
+ /** While the store clears a session on its own account (a reset): nothing the user dismissed. */
80
+ private _resetting;
81
+ constructor(host: PresenceHost);
82
+ /**
83
+ * Show this workbook's session.
84
+ *
85
+ * @param sessionId - The id the host addresses this workbook by. Defaults to the workbook's own id.
86
+ */
87
+ bind(workbook: IWorkbook | null, sessionId?: string): void;
88
+ getSnapshot: () => PresenceSnapshot;
89
+ subscribe: (listener: () => void) => (() => void);
90
+ /**
91
+ * Move to the next finding (wrapping) and reveal it.
92
+ *
93
+ * @param fromId - Step from this finding instead of the current one — a chip's own arrows walk
94
+ * from that chip, wherever the user scrolled to.
95
+ */
96
+ next(fromId?: string): void;
97
+ /** Move to the previous finding (wrapping) and reveal it. See {@link next} for `fromId`. */
98
+ prev(fromId?: string): void;
99
+ /** Make a finding current and reveal it. A stale or unknown id does nothing; a `working` one is only revealed. */
100
+ goTo(id: string): void;
101
+ /** Bring an address into view without touching the selection. */
102
+ reveal(address: string): void;
103
+ /** Select an address — for a link to the cells the user clicks (the prompt's range). */
104
+ select(address: string): void;
105
+ /** Dismiss one finding. The cursor moves to the one that takes its place. */
106
+ dismiss(id: string): void;
107
+ dismissCurrent(): void;
108
+ /** Dismiss every `finding` and `question` finding in the bound session. */
109
+ dismissAll(): void;
110
+ /** Clear the agent's `working` cursor, as Esc does. Returns whether there was one. */
111
+ clearWorking(): boolean;
112
+ /**
113
+ * Answer the step on screen of the bound session's prompt. Answering here or in the grid is the
114
+ * same thing.
115
+ *
116
+ * @remarks
117
+ * A single-question prompt is sent at once. With several, the answer is recorded and the next
118
+ * step comes up; the answers go together on {@link submitPrompt}.
119
+ *
120
+ * @param optionId - The option chosen; omitted to acknowledge a step that has none.
121
+ */
122
+ choosePromptOption: (optionId?: string) => void;
123
+ /**
124
+ * Record the step on screen's answer in the user's own words ("Other"), as they type. It does not
125
+ * move on or send — the user may write several lines; {@link submitPrompt} sends. Blank text
126
+ * leaves the step unanswered.
127
+ */
128
+ setPromptOtherText: (text: string) => void;
129
+ private _answerStep;
130
+ /**
131
+ * Record where the prompt's first question is on screen, so its dialog can open there. Set once:
132
+ * the dialog opens where its question was, then stays wherever the user puts it.
133
+ */
134
+ setPromptAnchor: (promptId: string, anchor: {
135
+ x: number;
136
+ y: number;
137
+ }) => void;
138
+ /** Show another step of the bound session's prompt. Answers given stay until changed. */
139
+ promptGoToStep: (step: number) => void;
140
+ /** Send the prompt's answers. Only once every question has one. */
141
+ submitPrompt: () => void;
142
+ /** Dismiss the bound session's prompt. What was answered so far goes back with the `cancel`. */
143
+ cancelPrompt: () => void;
144
+ dispose(): void;
145
+ /**
146
+ * Tell the host what the user dismissed of the session's findings, however it was done. A `working`
147
+ * cursor is never reported: it goes on its own.
148
+ */
149
+ private _onAnnotationEvent;
150
+ private _onHostEvent;
151
+ private _reset;
152
+ /**
153
+ * Record findings as the agent raises them — whatever the user later does with them. Newest first
154
+ * (a walk keeps the agent's order within it); the log only grows. A `working` cursor is never logged.
155
+ */
156
+ private _addToLog;
157
+ private _pending;
158
+ private _setPending;
159
+ /** A question is asked AT its cells — bring them into view as the step appears. */
160
+ private _revealStep;
161
+ private _resolvePrompt;
162
+ private _setSheetInView;
163
+ private _changed;
164
+ }
165
+ //# sourceMappingURL=PresenceStore.d.ts.map
@@ -0,0 +1,78 @@
1
+ import { RangeAnnotation } from '../annotation';
2
+ /**
3
+ * What a highlight is for: the vocabulary of the MCP `highlight` tool.
4
+ *
5
+ * @remarks
6
+ * `working` is the agent's cursor: one range, where it is about to write. It is shown in the strip
7
+ * and as a box on the grid, never listed or logged, and gone on its own: replaced by the next
8
+ * `working` call, cleared by any commit or any other highlight, and by Esc. `finding` and `question`
9
+ * are things the agent wants the user to look at; they accumulate as walks and stay until the user
10
+ * dismisses them.
11
+ */
12
+ export type PresenceIntent = 'working' | 'finding' | 'question';
13
+ /**
14
+ * A finding as the history records it: a copy taken when the agent raised it. Whether it is still
15
+ * open is the live annotations' to say, not the log's; dismissing a finding is not an answer to it.
16
+ */
17
+ export interface PresenceLogEntry extends RangeAnnotation {
18
+ raisedAt: number;
19
+ }
20
+ /**
21
+ * What the agent is waiting on: one prompt's dialog. It holds one question or several, which the
22
+ * user answers one step at a time and which go back together.
23
+ */
24
+ export interface PresencePrompt {
25
+ /** The prompt's id; the answer is correlated by it. */
26
+ id: string;
27
+ /** In the order asked. Never empty. */
28
+ questions: PresencePromptQuestion[];
29
+ }
30
+ /** One step of a {@link PresencePrompt}. */
31
+ export interface PresencePromptQuestion {
32
+ /** What the answer goes back under. */
33
+ id: string;
34
+ /** A short name for the step's tab. */
35
+ header?: string;
36
+ message: string;
37
+ /** Empty for an acknowledge step. `description` is a second, quieter line under the label. */
38
+ options: {
39
+ id: string;
40
+ label: string;
41
+ description?: string;
42
+ }[];
43
+ /**
44
+ * The range the question is about, already resolved. `undefined` means a centered dialog:
45
+ * deliberately not the user's selection, which is theirs and almost never the subject.
46
+ */
47
+ range?: string;
48
+ }
49
+ /**
50
+ * One question's answer: the option chosen, or `text` when the user answered in their own words
51
+ * ("Other"). Neither is set for an acknowledged step.
52
+ */
53
+ export interface PresencePromptQuestionAnswer {
54
+ questionId: string;
55
+ optionId?: string;
56
+ text?: string;
57
+ }
58
+ /**
59
+ * The user's answer to a prompt, elicitation-shaped. Dismissal is a normal `cancel`, carrying the
60
+ * questions answered before it (possibly none).
61
+ */
62
+ export interface PresencePromptAnswer {
63
+ action: 'accept' | 'cancel';
64
+ /** In question order. */
65
+ answers: PresencePromptQuestionAnswer[];
66
+ }
67
+ /** Agent presence and activity, as the host reports it. */
68
+ export interface PresenceStatus {
69
+ /** An agent is attached (host-global, not per workbook). */
70
+ connected: boolean;
71
+ /** Bumps on each tool call against this workbook; a change is a pulse, never a count. */
72
+ activity: number;
73
+ /** A short label for the last tool call. */
74
+ lastActivity?: string;
75
+ /** Tool calls against this workbook this session, as the host counts them. */
76
+ meter?: number;
77
+ }
78
+ //# sourceMappingURL=PresenceTypes.d.ts.map
@@ -0,0 +1,7 @@
1
+ export * from './PresenceTypes';
2
+ export * from './PresenceHost';
3
+ export * from './PresenceStore';
4
+ export * from './PresenceMessages';
5
+ export * from './PresenceCommands';
6
+ export * from './usePresence';
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,20 @@
1
+ import { IWorkbook } from '@sheetxl/sdk';
2
+ import { PresenceSnapshot, PresenceStore } from './PresenceStore';
3
+ /** The store's current snapshot; re-renders on every change. */
4
+ export declare function usePresenceSnapshot(store: PresenceStore): PresenceSnapshot;
5
+ /** One entry of the commit log, as the pane lists it. */
6
+ export interface PresenceCommit {
7
+ id: string;
8
+ /** The label the user sees in the undo menu, already resolved. */
9
+ description: string | null;
10
+ timestamp: number;
11
+ }
12
+ /**
13
+ * The commits the agent made to this workbook, newest first, kept current as the log moves.
14
+ *
15
+ * @remarks
16
+ * Read from the live transaction log, filtered to `author: 'agent'`. A commit undone (or reverted)
17
+ * leaves the list because the log is walked from the current head.
18
+ */
19
+ export declare function usePresenceCommits(workbook: IWorkbook | null, limit?: number): PresenceCommit[];
20
+ //# sourceMappingURL=usePresence.d.ts.map
@@ -1,5 +1,5 @@
1
1
  import { default as React } from 'react';
2
- import { IRichText, IStyledFont } from '@sheetxl/sdk';
2
+ import { IRichText, IFontStyle } from '@sheetxl/sdk';
3
3
  /**
4
4
  * The contract of a rich text editor: text in, edited text out. A host may supply its own in place
5
5
  * of the default {@link RichTextEditor}.
@@ -26,7 +26,7 @@ export interface RichTextEditorProps extends Omit<React.HTMLAttributes<HTMLDivEl
26
26
  /**
27
27
  * The CSS for the font properties a run sets.
28
28
  */
29
- runStyle?: (font: IStyledFont.JSON) => React.CSSProperties | undefined;
29
+ runStyle?: (font: IFontStyle.JSON) => React.CSSProperties | undefined;
30
30
  ref?: React.Ref<HTMLDivElement>;
31
31
  }
32
32
  /**
@@ -1,12 +1,12 @@
1
1
  import { RemoveListener } from '@sheetxl/utils';
2
- import { ISheet } from '@sheetxl/sdk';
2
+ import { IWorksheet } from '@sheetxl/sdk';
3
3
  import { Command } from '@sheetxl/utils-react';
4
4
  import { SelectionNavigation } from '@sheetxl/grid-react';
5
5
  /** The single `data` bundle {@link contributeSelectionCommands} takes (the `DynamicCommandContributor` shape). */
6
6
  export interface SelectionCommandData {
7
7
  /** `null` on the first render — the layer's `SelectionNavigation` is produced by its child via a ref. */
8
8
  navigation: SelectionNavigation | null;
9
- sheet?: ISheet;
9
+ sheet?: IWorksheet;
10
10
  }
11
11
  /**
12
12
  * Contribute the selection **behavior** onto `contribution` (a per-pane layer scope's contribution), as thin
@@ -1,18 +1,13 @@
1
1
  import { default as React } from 'react';
2
- import { ISheet } from '@sheetxl/sdk';
3
- import { IShowToolTipProperties } from '@sheetxl/utils-react';
2
+ import { IWorksheet } from '@sheetxl/sdk';
4
3
  import { LayerProps } from '@sheetxl/grid-react';
5
4
  import { CommandContext } from '../frame';
6
5
  import { SheetLocation } from '../sheet';
7
6
  export interface SheetSelectionLayerProps extends LayerProps {
8
7
  /** The sheet whose `getSelection()` this layer drives. */
9
- sheet: ISheet;
8
+ sheet: IWorksheet;
10
9
  /** Whether this sheet/pane is the active one (gates move/fill interaction). */
11
10
  isActive?: boolean;
12
- /** Show a transient tooltip (the fill preview value). Threaded from `SheetElement`; no-op if omitted. */
13
- onShowTooltip?: (properties: IShowToolTipProperties) => void;
14
- /** Hide the tooltip. */
15
- onCloseTooltip?: () => void;
16
11
  /**
17
12
  * A right-button drag of the fill handle was released: show the fill menu at `location` and run
18
13
  * whatever `menu` entry is chosen. The menu is chrome, so the consumer renders it (MUI in the
@@ -25,16 +20,15 @@ export interface SheetSelectionLayerProps extends LayerProps {
25
20
  /**
26
21
  * Renders the generic grid-react {@link SelectionLayer} wired with the
27
22
  * sheet interaction config — a {@link SheetSelection} model, the **move grip** (`onMove`: move/copy/insert
28
- * with an overwrite-confirm), the **fill handle** (`onFill`: auto-fill, with a **preview tooltip**), the
29
- * drag **edit modes** (cursor/description while dragging the grip or fill), and the enable gating — and,
30
- * when a command scope is present, contributes the selection nav onto it (yielding the layer's keyboard).
23
+ * with an overwrite-confirm), the **fill handle** (`onFill`: auto-fill), the **gesture tips** (a
24
+ * drag-select's size, a move's destination, the value a fill would write), the drag **edit modes**
25
+ * (cursor/description while dragging the grip or fill), and the enable gating — and, when a command
26
+ * scope is present, contributes the selection nav onto it (yielding the layer's keyboard).
31
27
  *
32
28
  * @remarks
33
29
  * The *smart* selection logic (merge / hidden / contentful nav, bounds) lives in the model
34
30
  * ({@link SheetSelection} → `IRangeSelection`); this layer only wires the view-side interactions the model
35
31
  * doesn't own.
36
- * The fill preview tooltip is threaded via `onShowTooltip`/`onCloseTooltip` — a float
37
- * provider would eventually replace that prop-drilling.
38
32
  */
39
33
  export declare const SheetSelectionLayer: React.FC<SheetSelectionLayerProps>;
40
34
  //# sourceMappingURL=SheetSelectionLayer.d.ts.map
@@ -0,0 +1,46 @@
1
+ import { default as React } from 'react';
2
+ import { Point } from '@sheetxl/utils';
3
+ import { IMovable } from '@sheetxl/sdk';
4
+ import { ContentControlProps } from '../movable/MovableControl';
5
+ /** A movable the dragged end may glue to, where it is now. */
6
+ export interface Candidate {
7
+ movable: IMovable;
8
+ placement: IMovable.Placement;
9
+ }
10
+ /** The site a dragged end would glue to if released now. */
11
+ export interface Hit {
12
+ target: IMovable;
13
+ index: number;
14
+ x: number;
15
+ y: number;
16
+ }
17
+ /**
18
+ * The movables on the sheet a connector may glue to: every one but itself and the groups it is
19
+ * in. Which of them offer sites is the model's to say (a group and a connector offer none).
20
+ */
21
+ export declare const collectCandidates: (connector: IMovable) => Candidate[];
22
+ /**
23
+ * The site the end snaps to from `point`: the nearest site of a movable the point is on (inside
24
+ * its frame, grown by a margin), else the nearest site within reach; `null` for none.
25
+ */
26
+ export declare const snapToSite: (point: Point, candidates: readonly Candidate[], zoom: number) => Hit | null;
27
+ /**
28
+ * Where a dragged end goes when its direction from `from` is held to a multiple of `step` degrees:
29
+ * `to` projected onto the nearest allowed direction, so a level or upright line ends where the
30
+ * pointer is along it.
31
+ */
32
+ export declare const constrainAngle: (from: Point, to: Point, step?: number) => Point;
33
+ /**
34
+ * A selected connector's control: a round handle at each end in place of the outline and resize
35
+ * handles, as Excel draws it. Dragging one runs the line from the other end to the pointer, and
36
+ * glues it to a movable's connection site when released on one: every movable shows its sites
37
+ * while the end is held (the layer's `ConnectionSites`), and the site the end would take is
38
+ * marked. Shift holds a free end to steps of 15 degrees about the other end; a site still wins.
39
+ *
40
+ * @remarks
41
+ * An end is a corner of the connector's frame; the frame between the two ends is what the SDK's
42
+ * connector placement answers, so the drag previews through the layer's resize loop and commits
43
+ * the placement with the glued end in one step.
44
+ */
45
+ export declare const ConnectorControl: React.FC<ContentControlProps>;
46
+ //# sourceMappingURL=ConnectorControl.d.ts.map
@@ -0,0 +1,11 @@
1
+ import { Command } from '@sheetxl/utils-react';
2
+ import { MovableKindCommandData } from '../movable';
3
+ /**
4
+ * The shape kind's commands, for the active shape. Chrome is the `shape` catalog.
5
+ *
6
+ * `changeShape` takes what an Insert > Shapes gallery entry states (a preset name, or the entry's
7
+ * JSON) and makes the shape that preset, as Excel's Change Shape does. A line or connector has none:
8
+ * its preset is what joins its ends.
9
+ */
10
+ export declare const contributeShapeCommands: Command.DynamicCommandContributor<MovableKindCommandData>;
11
+ //# sourceMappingURL=ShapeCommands.d.ts.map
@@ -0,0 +1,8 @@
1
+ import { default as React } from 'react';
2
+ import { ContentControlProps } from '../movable/MovableControl';
3
+ /**
4
+ * The selection control of a shape: a connector gets its endpoint handles, every other shape the
5
+ * generic outline, resize and rotate handles.
6
+ */
7
+ export declare const ShapeControl: React.FC<ContentControlProps>;
8
+ //# sourceMappingURL=ShapeControl.d.ts.map
@@ -22,9 +22,8 @@ export interface ShapeEditorProps extends MovableElementProps {
22
22
  * @remarks
23
23
  * The frame owns position, size and zoom; the drawing is a `viewBox` of the movable's unzoomed
24
24
  * bounds stretched to fill it, so a resize re-evaluates the geometry (adjust values are ratios,
25
- * and the shape stretches as it does in Excel) and zoom thickens lines as Excel's does. A group
26
- * draws its members in one SVG, each in its own style. A custom geometry is evaluated like a
27
- * preset, from the definition the file states.
25
+ * and the shape stretches as it does in Excel) and zoom thickens lines as Excel's does. A custom
26
+ * geometry is evaluated like a preset, from the definition the file states.
28
27
  */
29
28
  export declare const ShapeEditor: React.NamedExoticComponent<Omit<ShapeEditorProps, "ref"> & React.RefAttributes<IShapeEditorElement>>;
30
29
  //# sourceMappingURL=ShapeEditor.d.ts.map
@@ -1,16 +1,31 @@
1
+ import { IShape } from '@sheetxl/sdk';
2
+ /** One entry of the Insert > Shapes gallery: what it is called and what it inserts. */
3
+ export interface ShapeGalleryEntry {
4
+ /** Unique in the gallery: the entry's icon is `shape:<key>`, and a host remembers it by this. */
5
+ key: string;
6
+ /** The message key of its name. */
7
+ label: string;
8
+ /** What the entry inserts, as `insertShape` takes it. */
9
+ json: IShape.JSON;
10
+ }
1
11
  /**
2
- * One section of the Insert > Shapes gallery: its heading and its presets in display order, each
3
- * with the message key of its name.
12
+ * One section of the Insert > Shapes gallery: its heading and its entries in display order.
4
13
  */
5
14
  export interface ShapeGalleryCategory {
6
15
  key: string;
7
16
  label: string;
8
- presets: readonly (readonly [preset: string, label: string])[];
17
+ entries: readonly ShapeGalleryEntry[];
9
18
  }
10
19
  /**
11
- * The Insert > Shapes gallery: Excel's sections, order and names. A curated subset of the presets
12
- * (Excel's gallery leaves out some, such as `gear6` and the action buttons); every preset still has
13
- * an icon in the `shape` pack.
20
+ * What a new shape of a preset states: only its intent, the preset (none for `rect`) and, for a
21
+ * line or connector, `type: 'connector'`. Fill, line and text come from the theme's shape style
22
+ * when it is written.
23
+ */
24
+ export declare const presetShapeJSON: (preset: string) => IShape.JSON;
25
+ /**
26
+ * The Insert > Shapes gallery: Excel's sections, order and names, then a section of the presets
27
+ * Excel's gallery leaves out (`funnel`, the tabs, the gears, the action buttons). Every entry has
28
+ * an icon in the `shape` pack, under its key.
14
29
  */
15
30
  export declare const ShapeGallery: readonly ShapeGalleryCategory[];
16
31
  //# sourceMappingURL=ShapeGallery.d.ts.map
@@ -0,0 +1,7 @@
1
+ import { MovableRendererModule } from '../movable/MovableRenderers';
2
+ /**
3
+ * The shape kind, as the renderer registry loads it: one module, so a failed fetch can be imported
4
+ * again whole.
5
+ */
6
+ export declare const ShapeKind: MovableRendererModule;
7
+ //# sourceMappingURL=ShapeKind.d.ts.map
@@ -1,24 +1,22 @@
1
1
  import { default as React } from 'react';
2
- import { IGeometry, IResource, IStyleCollection } from '@sheetxl/sdk';
2
+ import { IGeometry, IResource } from '@sheetxl/sdk';
3
3
  import { ResolvedShapeStyle } from './shapeStyle';
4
+ import { DeviceGrid } from './shapeFrame';
4
5
  /** `pointer-events` for a drawn part: hit where painted, or not at all while the frame is hidden. */
5
6
  export type PartHit = 'visiblePainted' | 'none';
6
7
  /** A URL an `<image>` can load a resource from: its external URI, or its bytes as a data URL. */
7
8
  export declare const resourceUrl: (resource: IResource) => Promise<string>;
8
9
  export interface ShapePathsProps {
9
10
  geometry: IGeometry;
10
- /** The shape's own style, for paths that belong to no group member. */
11
+ /** The shape's style. */
11
12
  style: ResolvedShapeStyle;
12
- /** What a group member's style and a picture's image resolve against. */
13
- styles: IStyleCollection | null;
14
- /** The images the shape's JSON names, by resource id (`IShape.getResource`). */
15
- getResource?: (resourceId: number) => IResource | null;
16
13
  zoom: number;
14
+ /** Where the frame lies on the device pixel grid, for the lines to land on it; `null` to draw as evaluated. */
15
+ grid?: DeviceGrid | null;
17
16
  hit: PartHit;
18
17
  }
19
18
  /**
20
- * Everything a geometry draws: a shape's paths in its style, or a group's members, each placed
21
- * and in its own style.
19
+ * Everything a geometry draws: the shape's paths in its style.
22
20
  */
23
21
  export declare const ShapePaths: React.FC<ShapePathsProps>;
24
22
  //# sourceMappingURL=ShapeSVG.d.ts.map
@@ -1,4 +1,3 @@
1
- export * from './ShapeEditor';
2
1
  export * from './ShapeGallery';
3
2
  export * from './ShapeText';
4
3
  export * from './icons/ShapeIcons';
@@ -1,6 +1,50 @@
1
+ import { Point } from '@sheetxl/utils';
1
2
  /**
2
3
  * A stroke width in shape px snapped to whole device pixels, never thinner than one: a 1 pt line
3
- * is 1 px at 100% and 3 px at 200%, as Excel draws it. Zero stays zero (no line).
4
+ * is 1 px at 100% and 3 px at 200%, as Excel draws it. A width of zero is Excel's hairline, one
5
+ * device pixel at any zoom; a line that is not drawn has no stroke color, not a width of zero.
4
6
  */
5
- export declare const snapStrokeWidth: (width: number, zoom: number) => number;
7
+ export declare const snapStrokeWidth: (width: number, zoom: number, dpr?: number) => number;
8
+ /**
9
+ * How a shape's drawing lies on the device pixel grid: what it takes to land a line on it. The
10
+ * drawing is in shape px, scaled by `zoom` into the view from the frame's corner, which is on a
11
+ * device pixel, and mirrored about the frame's center where flipped.
12
+ */
13
+ export interface DeviceGrid {
14
+ /** Device px per view px. */
15
+ dpr: number;
16
+ /** View px per shape px. */
17
+ zoom: number;
18
+ /** The frame, in shape px: what a mirrored drawing is measured from. */
19
+ width: number;
20
+ height: number;
21
+ flipH: boolean;
22
+ flipV: boolean;
23
+ }
24
+ /** Where a path's end moved when it was snapped: `by`, from `at` (shape px, before the snap). */
25
+ export interface SnappedEnd {
26
+ at: Point;
27
+ by: Point;
28
+ }
29
+ export interface SnappedPath {
30
+ d: string;
31
+ /** The ends of the path's subpaths, for what is drawn at them (a line end) to follow. */
32
+ ends: SnappedEnd[];
33
+ }
34
+ /**
35
+ * Path data with every level and upright straight line moved onto the device pixel grid, so a
36
+ * thin stroke along it is crisp rather than smeared over two rows of pixels, as a gridline is. A
37
+ * line's ends go with it, so the lines that meet it stay joined; a curve keeps its control points
38
+ * and bends by the fraction of a pixel its end moved. Slanted lines and curves are left alone.
39
+ *
40
+ * @param d SVG path data in shape px, as {@link IGeometry.forEachPath} gives it.
41
+ * @param strokeWidth The stroke's width in shape px, already snapped to whole device px.
42
+ */
43
+ export declare const snapPathToDevice: (d: string, grid: DeviceGrid, strokeWidth: number) => SnappedPath;
44
+ /**
45
+ * Path data moved to follow snapped line ends: each subpath by the move of the nearest end in
46
+ * `ends`, so a line end drawn as its own path (an arrowhead) stays on the line it was drawn for.
47
+ * Unchanged when no end moved.
48
+ */
49
+ export declare const followSnappedEnds: (d: string, ends: readonly SnappedEnd[]) => string;
6
50
  //# sourceMappingURL=shapeFrame.d.ts.map