@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
@@ -1,7 +1,8 @@
1
1
  import { default as React } from 'react';
2
2
  import { CellCoords, RangeCoords } from '@sheetxl/utils';
3
- import { ISheet, IDataValidation } from '@sheetxl/sdk';
4
- import { LayerProps } from '@sheetxl/grid-react';
3
+ import { IDataValidation, IWorksheet } from '@sheetxl/sdk';
4
+ import { IEditable, LayerProps } from '@sheetxl/grid-react';
5
+ import { ValidationAlert } from '../editor/validationAlert';
5
6
  /** The prompt a cell shows: the rule's title and message, and the range it hangs under. */
6
7
  export interface ValidationPrompt {
7
8
  /** The cell, or the merge it anchors. */
@@ -15,32 +16,62 @@ export interface ValidationPrompt {
15
16
  }
16
17
  /**
17
18
  * The input prompt for the cell at `coords`: from the first covering rule, by priority, that shows
18
- * a prompt and has a title or a message to show. `null` when none does.
19
+ * a prompt and has a title or a message to show. `null` when none does, or when the sheet disables
20
+ * prompts.
19
21
  */
20
- export declare const findValidationPrompt: (sheet: ISheet, coords: CellCoords) => ValidationPrompt | null;
22
+ export declare const findValidationPrompt: (sheet: IWorksheet, coords: CellCoords) => ValidationPrompt | null;
21
23
  export interface ValidationPromptLayerProps extends Omit<LayerProps, 'children'> {
22
- /** Class for the floated prompt container. */
24
+ /** Class for the floated container. */
23
25
  className?: string;
24
- /** Style for the floated prompt container. */
26
+ /** Style for the floated container. */
25
27
  style?: React.CSSProperties;
26
- /** The sheet whose selection is followed. */
27
- sheet: ISheet;
28
- /** Gap (px) between the cell's bottom edge and the prompt. @defaultValue 4 */
28
+ /** The sheet whose selection is followed, and whose entries are checked. */
29
+ sheet: IWorksheet;
30
+ /**
31
+ * The editable entries are typed through. It tells an alert on an open edit, which stays while
32
+ * the edit does, from one left behind, which the next key or press clears.
33
+ */
34
+ editable?: IEditable<any, string, any> | null;
35
+ /** Gap (px) between the cell and the float, below it and past its right edge. @defaultValue 6 */
29
36
  offset?: number;
30
37
  /**
31
38
  * Render the prompt yourself. Spread `floatProps` on the returned element. Omit for the default
32
- * box: the title in bold over the message.
39
+ * box: the title in bold over the message; `null` for none.
40
+ */
41
+ renderPrompt?: ((props: ValidationPromptRenderProps) => React.ReactNode) | null;
42
+ /**
43
+ * Render the alert yourself. Spread `floatProps` on the returned element. Omit for the default
44
+ * card: the rule's alert title and message, and what to do next; `null` for none.
33
45
  */
34
- renderPrompt?: (prompt: ValidationPrompt, floatProps: React.HTMLAttributes<HTMLElement>) => React.ReactNode;
46
+ renderAlert?: ((props: ValidationAlertRenderProps) => React.ReactNode) | null;
47
+ }
48
+ /** What {@link ValidationPromptLayerProps.renderPrompt} is handed. */
49
+ export interface ValidationPromptRenderProps {
50
+ prompt: ValidationPrompt;
51
+ /** Spread on the returned element: its placement and pointer handling. */
52
+ floatProps: React.HTMLAttributes<HTMLElement>;
53
+ }
54
+ /** What {@link ValidationPromptLayerProps.renderAlert} is handed. */
55
+ export interface ValidationAlertRenderProps {
56
+ alert: ValidationAlert;
57
+ /** Spread on the returned element: its placement and pointer handling. */
58
+ floatProps: React.HTMLAttributes<HTMLElement>;
35
59
  }
36
60
  /**
37
- * The **input prompt** of a data validation — a {@link RangeFloatLayer} activated by the selection,
38
- * placed under the selected cell (or its merge), starting at its horizontal midpoint.
61
+ * The **input prompt** of a data validation, and the **alert** an entry raised in its place — one
62
+ * {@link RangeFloatLayer} at the cell-tip placement the error tips use: under the active cell (or
63
+ * its merge), starting just past its right edge.
39
64
  *
40
65
  * @remarks
41
- * Shows the title and message of the first covering rule that has a prompt to show
42
- * ({@link findValidationPrompt}). It stays while the cell is being edited, as Excel's does, and steps
43
- * aside while the list picker is open, since the two would drop under the same edge.
66
+ * At rest the float follows the selection and shows the title and message of the first covering
67
+ * rule that has a prompt to show ({@link findValidationPrompt}). It stays while the cell is being
68
+ * edited, as Excel's does, and steps aside while the list picker is open, since the picker drops
69
+ * under the same edge.
70
+ *
71
+ * An alert the entry check raised (`ValidationAlert`) takes the float over: Excel's alert dialog in
72
+ * tip form. A Stop keeps the edit open and the tip with it; a Warning's tip asks for Enter again; an
73
+ * Information entry is written and its tip stays until the next key or press. The prompt returns
74
+ * when the alert clears.
44
75
  */
45
76
  export declare const ValidationPromptLayer: React.MemoExoticComponent<(props: ValidationPromptLayerProps) => React.JSX.Element>;
46
77
  //# sourceMappingURL=ValidationPromptLayer.d.ts.map
@@ -0,0 +1,6 @@
1
+ import { IBorders, ICell, IRange } from '@sheetxl/sdk';
2
+ /** The borders a visible cell draws. */
3
+ export declare const getSheetBorderAt: (value: ICell, _index: number) => IBorders;
4
+ /** A merged cell's extrusion is its merge (merged cells never overflow); `null` when not merged. */
5
+ export declare const getSheetMergeAt: (value: ICell, _index: number) => IRange.Coords | null;
6
+ //# sourceMappingURL=_sheetBorders.d.ts.map
@@ -0,0 +1,6 @@
1
+ import { IWorksheet, ITable, IPivotTable, ITableStyle } from '@sheetxl/sdk';
2
+ /** A table style's theme color (header fill / whole-table top border) as CSS; `null` when it has none. */
3
+ export declare const tableStyleColor: (style: ITableStyle | null, sheet: IWorksheet) => string | null;
4
+ /** A table's or pivot table's theme color (header fill / whole-table top border) as CSS; grey when its style has none. */
5
+ export declare const tableLabelColor: (table: Pick<ITable, "getStyle"> | Pick<IPivotTable, "getStyle">, sheet: IWorksheet) => string;
6
+ //# sourceMappingURL=_tableColor.d.ts.map
@@ -0,0 +1,11 @@
1
+ import { ICellRange } from '@sheetxl/sdk';
2
+ /**
3
+ * Every feature a blank cell can be painted through, for the visible-cell scans.
4
+ *
5
+ * @remarks
6
+ * Naming them is what visits blanks at all. The list is the whole cell state, not what the layer
7
+ * draws: per-cell style resolution composes table and named styles through the full intersection,
8
+ * so a partial list breaks effective styles.
9
+ */
10
+ export declare const VisibleCellFeatures: readonly ICellRange.Feature[];
11
+ //# sourceMappingURL=_visibleCellFeatures.d.ts.map
@@ -0,0 +1,13 @@
1
+ import { RangeCoords } from '@sheetxl/utils';
2
+ import { GridPlacement, IGridPane } from '@sheetxl/grid-react';
3
+ /**
4
+ * Where a cell's tips hang: the input prompt, and the hover tip on an error, a warning or a failed
5
+ * validation alike. Below the cell, starting just past its right edge (under a dropdown button), so
6
+ * the cell and the one below it stay in view. Flip and shift apply as to any grid float.
7
+ */
8
+ export declare const CELL_TIP_PLACEMENT: GridPlacement;
9
+ /** Gap (px) between a cell and its tip, below it and past its right edge alike. */
10
+ export declare const CELL_TIP_GAP = 6;
11
+ /** The align offset that starts a tip `gap` past the right edge of `range`. */
12
+ export declare const cellTipAlignOffset: (pane: IGridPane, range: RangeCoords, gap?: number) => number;
13
+ //# sourceMappingURL=cellTip.d.ts.map
@@ -0,0 +1,21 @@
1
+ import { IRange } from '@sheetxl/sdk';
2
+ import { FreezeDragPosition } from '@sheetxl/grid-react';
3
+ /**
4
+ * The transient state of an in-progress freeze drag, published by the producer
5
+ * (the freeze grips, through {@link useFreezeDrag}) and read by {@link FreezeDragLines} in both the
6
+ * header and the main grid.
7
+ *
8
+ * It rides `useSurfaceState` under {@link freezeDragKey}. `null` means no freeze drag is active for that
9
+ * axis.
10
+ */
11
+ export type FreezeDragState = FreezeDragPosition;
12
+ /**
13
+ * The `useSurfaceState` key for the freeze drag, namespaced by axis.
14
+ */
15
+ export declare const freezeDragKey: (axis: IRange.Axis) => string;
16
+ /**
17
+ * The `useSurfaceState` key for whether an axis's freeze grip is active (hovered or dragging) — the sheet
18
+ * highlights its freeze line while it is. A boolean; `false` when never written.
19
+ */
20
+ export declare const freezeActiveKey: (axis: IRange.Axis) => string;
21
+ //# sourceMappingURL=freezeDragState.d.ts.map
@@ -4,29 +4,44 @@ export * from './useSheetFeatureRegions';
4
4
  export * from './useSheetVisibleDecorations';
5
5
  export * from './CellFillLayer';
6
6
  export * from './CellErrorLayer';
7
+ export * from './HyperlinkLayer';
7
8
  export * from './BorderLayer';
8
9
  export * from './SheetCellLayer';
9
10
  export * from './SheetColumnButtonLayer';
11
+ export * from './PivotLayer';
12
+ export * from './PivotToolbar';
10
13
  export * from './SheetGridLineLayer';
11
14
  export * from './SheetBackgroundLayer';
12
15
  export * from './SheetHeaderCellLayer';
16
+ export * from './SheetOutlineLayer';
13
17
  export * from './SheetMovableLayer';
14
18
  export * from './TableLayer';
19
+ export * from './TableToolbar';
15
20
  export * from './SheetTableCommandLayer';
21
+ export * from './SheetSparklineCommandLayer';
22
+ export * from './SheetPivotCommandLayer';
16
23
  export * from './SpillLayer';
17
24
  export * from './ConditionalIcons';
18
25
  export * from './ConditionalBarLayer';
19
26
  export * from './ConditionalIconsLayer';
27
+ export * from './SparklineLayer';
20
28
  export * from './ValidationIndicatorLayer';
21
29
  export * from './ValidationDropdownLayer';
22
30
  export * from './ValidationPromptLayer';
23
31
  export * from './useValidationPicker';
24
32
  export * from './CircularIndicatorLayer';
33
+ export * from './CellIndicatorLayer';
25
34
  export * from './CommentsLayer';
26
35
  export * from './CommentCardLayer';
36
+ export * from './SheetLayers';
37
+ export * from './CellInsertLayer';
27
38
  export * from './ProtectionLayer';
28
39
  export * from './HeaderSelectionLayer';
29
40
  export * from './HeaderResizerLayer';
30
41
  export * from './ResizeIndicator';
42
+ export * from './HeaderFreezeLayer';
43
+ export * from './GridFreezeLayer';
44
+ export * from './FreezeDragLines';
45
+ export * from './freezeDragState';
31
46
  export * from './ContextMenuLayer';
32
47
  //# sourceMappingURL=index.d.ts.map
@@ -12,7 +12,9 @@ export interface ResizeIndicatorState {
12
12
  /** The index of the header (column or row) being resized. */
13
13
  index: number;
14
14
  /**
15
- * Live size (px) of the header during the gesture — `prevSize` at start, the dragged size while moving.
15
+ * Live size of the header during the gesture, in on-screen (zoomed) pixels — `prevSize` at start, the
16
+ * dragged size while moving. The model has not announced the new size yet, so the overlay draws the
17
+ * header's far edge from this rather than from the grid's metrics.
16
18
  * `0` ⇒ the header is (being) hidden (draw a single collapsed line, tooltip reads "Hidden").
17
19
  * `null` ⇒ draw the guide-lines only, with no size tooltip (e.g. a press-and-hold before any drag).
18
20
  */
@@ -0,0 +1,22 @@
1
+ import { IWorksheet, IRange } from '@sheetxl/sdk';
2
+ import { FreezeDragPosition } from '@sheetxl/grid-react';
3
+ export interface FreezeDrag {
4
+ disabled: boolean;
5
+ /** Whether a grip on this axis (header or body) is hovered or dragging. */
6
+ isActive: boolean;
7
+ onFreezeDragStart: (position: FreezeDragPosition) => void;
8
+ onFreezeDrag: (position: FreezeDragPosition) => void;
9
+ onFreezeDragEnd: (position: FreezeDragPosition) => void;
10
+ onFreezeDragCancel: () => void;
11
+ onActiveChange: (active: boolean) => void;
12
+ }
13
+ /**
14
+ * Wires a freeze grip on one axis to the sheet: publishes the drag for {@link FreezeDragLines}, commits the
15
+ * drop through `freezePanesAt`, and works out whether a drag is allowed right now.
16
+ *
17
+ * @remarks
18
+ * The drag is allowed only when the scrolling area starts exactly at the freeze — otherwise the frozen
19
+ * and scrolling areas are not contiguous and a drop could not land where it was let go.
20
+ */
21
+ export declare const useFreezeDrag: (sheet: IWorksheet, axis: IRange.Axis) => FreezeDrag;
22
+ //# sourceMappingURL=useFreezeDrag.d.ts.map
@@ -0,0 +1,15 @@
1
+ import { IWorksheet } from '@sheetxl/sdk';
2
+ import { BorderNormalLine } from '../border';
3
+ /**
4
+ * The Normal style's border as one line per axis — a border on every cell, blank ones included.
5
+ *
6
+ * @remarks
7
+ * A boundary is the trailing edge of one cell and the leading edge of the next; the Normal style's
8
+ * two edges meet there and the one Excel draws wins. `null` on an axis with no Normal border.
9
+ * Identity is stable while the resolved style is. The caller re-renders on `onStyleChange`.
10
+ */
11
+ export declare const useNormalBorderLines: (sheet: IWorksheet) => {
12
+ rows: BorderNormalLine | null;
13
+ columns: BorderNormalLine | null;
14
+ };
15
+ //# sourceMappingURL=useNormalBorderLines.d.ts.map
@@ -1,4 +1,4 @@
1
- import { ICellRange, ICellRegion, IRange, ISheet } from '@sheetxl/sdk';
1
+ import { ICellRange, ICellRegion, IRange, IWorksheet } from '@sheetxl/sdk';
2
2
  import { IGridPane } from '@sheetxl/grid-react';
3
3
  export interface SheetFeatureRegions {
4
4
  /** The viewport's regions for the feature — engine-merged blocks, ready to place. */
@@ -17,5 +17,5 @@ export interface SheetFeatureRegions {
17
17
  * {@link useSheetVisibleCells}'s shape — per-pane, cached by range key, token-invalidated — so
18
18
  * layers can swap sources without changing their contract.
19
19
  */
20
- export declare const useSheetFeatureRegions: (sheet: ISheet, feature: ICellRange.Feature) => SheetFeatureRegions;
20
+ export declare const useSheetFeatureRegions: (sheet: IWorksheet, feature: ICellRange.Feature) => SheetFeatureRegions;
21
21
  //# sourceMappingURL=useSheetFeatureRegions.d.ts.map
@@ -1,4 +1,4 @@
1
- import { ISheet, ICell, IRange } from '@sheetxl/sdk';
1
+ import { IWorksheet, ICell, IRange } from '@sheetxl/sdk';
2
2
  import { IGridPane } from '@sheetxl/grid-react';
3
3
  export type SheetVisibleCell = {
4
4
  cell: ICell.Coords;
@@ -8,12 +8,12 @@ export type SheetVisibleCell = {
8
8
  /**
9
9
  * What the scan should treat as "worth rendering". Each layer passes ONLY the flags its own output
10
10
  * depends on — a flag change busts this hook's scan cache + token, so an unused flag would rebuild
11
- * the caller for nothing (e.g. gridlines must not rebuild on a show-zeros toggle).
11
+ * the caller for nothing (e.g. a layer that ignores zeros must not rebuild on a show-zeros toggle).
12
12
  */
13
13
  export interface SheetVisibleCellsOptions {
14
14
  /**
15
15
  * Formula view: formula-only cells render (even valueless), and text-overflow extrusions are
16
- * disabled (formulas never overflow-paint). Affects cells AND gridlines (extrusions break lines).
16
+ * disabled (formulas never overflow-paint). Affects the cells and their extrusions.
17
17
  * @defaultValue false
18
18
  */
19
19
  showFormulas?: boolean;
@@ -53,8 +53,7 @@ export interface SheetVisibleCells {
53
53
  * source flags change (e.g. `useModelSync(sheetView, ['onZoomScaleChange'])` — the view's setters all
54
54
  * funnel through `_notifyAll`, which fires that event). Each caller (one per layer per pane) gets its
55
55
  * OWN cache + subscription — the layers are deliberately decoupled, so a value edit re-renders only the
56
- * layer(s) that asked, never the grid above them. Used by {@link SheetCellLayer} and
57
- * {@link SheetGridLineLayer}.
56
+ * layer(s) that asked, never the grid above them. Used by {@link SheetCellLayer}.
58
57
  */
59
- export declare const useSheetVisibleCells: (sheet: ISheet, options?: SheetVisibleCellsOptions) => SheetVisibleCells;
58
+ export declare const useSheetVisibleCells: (sheet: IWorksheet, options?: SheetVisibleCellsOptions) => SheetVisibleCells;
60
59
  //# sourceMappingURL=useSheetVisibleCells.d.ts.map
@@ -1,4 +1,4 @@
1
- import { ISheet, ICell, IRange, IConditionalFormat } from '@sheetxl/sdk';
1
+ import { IWorksheet, ICell, IRange, IConditionalFormat } from '@sheetxl/sdk';
2
2
  import { IGridPane } from '@sheetxl/grid-react';
3
3
  /** One visible cell a conditional-format rule DRAWS in. */
4
4
  export interface SheetDecoratedCell {
@@ -38,5 +38,5 @@ export interface SheetVisibleDecorations {
38
38
  * (`onConditionalFormatsChange`), or a value moves within a rule's range — which can restripe every
39
39
  * cell the rule covers, not just the edited one, because the domain is range-wide.
40
40
  */
41
- export declare const useSheetVisibleDecorations: (sheet: ISheet, kind: SheetDecorationKind) => SheetVisibleDecorations;
41
+ export declare const useSheetVisibleDecorations: (sheet: IWorksheet, kind: SheetDecorationKind) => SheetVisibleDecorations;
42
42
  //# sourceMappingURL=useSheetVisibleDecorations.d.ts.map
@@ -1,4 +1,4 @@
1
- import { ISheet } from '@sheetxl/sdk';
1
+ import { IWorksheet } from '@sheetxl/sdk';
2
2
  import { SheetVisibleCells } from './useSheetVisibleCells';
3
3
  /**
4
4
  * The "which cells host a column (filter/sort) button" source for a single pane, plus
@@ -18,5 +18,5 @@ import { SheetVisibleCells } from './useSheetVisibleCells';
18
18
  * table add/remove/auto-table/layout/undo (sheet events) and hidden-button / show-headers / column
19
19
  * add-remove / resize (which fire `onAnyChange` on the TABLE, so we subscribe to each table too).
20
20
  */
21
- export declare const useTableHeaderCells: (sheet: ISheet) => SheetVisibleCells;
21
+ export declare const useTableHeaderCells: (sheet: IWorksheet) => SheetVisibleCells;
22
22
  //# sourceMappingURL=useTableHeaderCells.d.ts.map
@@ -1,5 +1,5 @@
1
1
  import { CellCoords } from '@sheetxl/utils';
2
- import { ISheet, IDataValidation } from '@sheetxl/sdk';
2
+ import { IWorksheet, IDataValidation } from '@sheetxl/sdk';
3
3
  import { GridAnchor, IEditable } from '@sheetxl/grid-react';
4
4
  import { CellPicker } from '../picker';
5
5
  /**
@@ -8,7 +8,7 @@ import { CellPicker } from '../picker';
8
8
  */
9
9
  export interface ValidationPickerOptions {
10
10
  /** The sheet the chosen value is written to. */
11
- sheet: ISheet;
11
+ sheet: IWorksheet;
12
12
  /**
13
13
  * The editable the pick is entered through — the same path as typing the item's text, so the value
14
14
  * coerces and formats as a typed one does. `null` offers nothing.
@@ -48,7 +48,7 @@ export declare const resolveListPickerItems: (rules: readonly IDataValidation[],
48
48
  *
49
49
  * @remarks
50
50
  * No search field: a validation list is a short set of choices, and narrowing it belongs to the cell
51
- * editor's typing (DESIGN-DV §3.7).
51
+ * editor's typing.
52
52
  */
53
53
  export declare const useValidationPicker: (options: ValidationPickerOptions) => CellPicker;
54
54
  //# sourceMappingURL=useValidationPicker.d.ts.map
@@ -1,4 +1,4 @@
1
- import { ISheet, ITable } from '@sheetxl/sdk';
1
+ import { IWorksheet, ITable } from '@sheetxl/sdk';
2
2
  export interface VisibleTables {
3
3
  /** The tables intersecting this pane's visible range (empty array — stable identity — when none). */
4
4
  visibleTables: readonly ITable[];
@@ -23,5 +23,5 @@ export interface VisibleTables {
23
23
  * PLUS each visible table's `onAnyChange` — table mutations (hidden-button toggle, show-headers, column
24
24
  * add/remove, resize) fire on the TABLE, not the sheet.
25
25
  */
26
- export declare const useVisibleTables: (sheet: ISheet) => VisibleTables;
26
+ export declare const useVisibleTables: (sheet: IWorksheet) => VisibleTables;
27
27
  //# sourceMappingURL=useVisibleTables.d.ts.map
@@ -1,5 +1,5 @@
1
1
  import { CellCoords, RangeCoords } from '@sheetxl/utils';
2
- import { IDataValidation, ISheet } from '@sheetxl/sdk';
2
+ import { IDataValidation, IWorksheet } from '@sheetxl/sdk';
3
3
  import { VisibleCell } from '@sheetxl/grid-react';
4
4
  /**
5
5
  * How a cell's value fails its data validations: `'failed'` when every failing rule raises no
@@ -38,7 +38,7 @@ export declare const resolveValidationMark: (rules: readonly IDataValidation[],
38
38
  * Only cells holding a value are visited, unless a rule has Ignore blank off: an empty cell can fail
39
39
  * that one, so the window's empty cells are visited too — bounded by the window, as painting is.
40
40
  */
41
- export declare const findVisibleValidationMarks: (sheet: ISheet, coords: RangeCoords) => VisibleCell[];
41
+ export declare const findVisibleValidationMarks: (sheet: IWorksheet, coords: RangeCoords) => VisibleCell[];
42
42
  /**
43
43
  * What the hover tip over a cell's invalid-value mark says.
44
44
  */
@@ -55,7 +55,7 @@ export interface ValidationTip {
55
55
  * (Show Invalid off), the value passes, or the cell is the active one and its input prompt is
56
56
  * already saying what it wants.
57
57
  */
58
- export declare const findValidationTip: (sheet: ISheet, coords: CellCoords) => ValidationTip | null;
58
+ export declare const findValidationTip: (sheet: IWorksheet, coords: CellCoords) => ValidationTip | null;
59
59
  /** The color a mark is drawn in, per state: the theme's severity colors, neutral for no alert. */
60
60
  export declare const VALIDATION_MARK_COLORS: Record<ValidationMarkState, string>;
61
61
  /** The glyph for each state (the Base icon pack), the same the rule editor shows for a style. */
@@ -1,3 +1,8 @@
1
1
  export * from './useModelListener';
2
2
  export * from './useRangeListener';
3
+ export * from './useCellRange';
4
+ export * from './useCellValue';
5
+ export * from './useCell';
6
+ export type { CellRangeTarget, CellRangeHookOptions } from './useRangeSnapshot';
7
+ export * from './useTable';
3
8
  //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,29 @@
1
+ import { ICell, ICellRange } from '@sheetxl/sdk';
2
+ import { CellRangeTarget, CellRangeHookOptions } from './useRangeSnapshot';
3
+ /**
4
+ * Binds a single cell: returns a snapshot of it and an updater, and re-renders with a new snapshot when
5
+ * the cell changes.
6
+ *
7
+ * @param target The workbook or sheet to read from, or `null` while there is none.
8
+ * @param address The cell's address. A larger range binds its top-left cell.
9
+ * @param options Listener options, and an optional `onChange` that receives each change event.
10
+ * @returns The cell, or `null` while `target` is `null`, and an updater that does nothing until there
11
+ * is a target.
12
+ *
13
+ * @remarks
14
+ * The cell is a snapshot: it does not change after it is returned, so it is safe to compare or memoize
15
+ * on. Its formatted text, type, formula, and errors are all available alongside the value.
16
+ *
17
+ * The updater takes anything {@link ICellRange.updateCells} does: a value, a cell, or
18
+ * {@link ICell.Modifiers} such as `{ value, style }`. Text is parsed by default, so `'=SUM(A1:A3)'`
19
+ * becomes a formula; pass `{ textParser: false }` to store it as text. For a plain value, see
20
+ * {@link useCellValue}.
21
+ *
22
+ * @example
23
+ * ```tsx
24
+ * const [total] = useCell(sheet, 'D23');
25
+ * return <output>{total?.getText()}</output>;
26
+ * ```
27
+ */
28
+ export declare const useCell: (target: CellRangeTarget | null | undefined, address: ICellRange.Address, options?: CellRangeHookOptions) => [ICell | null, (update: ICell.Update, options?: ICellRange.UpdateCellsOptions) => void];
29
+ //# sourceMappingURL=useCell.d.ts.map
@@ -0,0 +1,23 @@
1
+ import { ICellRange } from '@sheetxl/sdk';
2
+ import { CellRangeTarget, CellRangeHookOptions } from './useRangeSnapshot';
3
+ /**
4
+ * Returns the range at `address` and re-renders whenever anything in it changes: values (including
5
+ * recalculated formula results), styles, or its address.
6
+ *
7
+ * @param target The workbook or sheet to read from, or `null` while there is none.
8
+ * @param address The range's address. An object address is compared by identity, so keep it stable.
9
+ * @param options Listener options, and an optional `onChange` that receives each change event.
10
+ * @returns The range, or `null` while `target` is `null`.
11
+ *
12
+ * @remarks
13
+ * The returned range is the same object across renders; read from it during render. For a single
14
+ * value use {@link useCellValue}, and for a single cell's full state use {@link useCell}.
15
+ *
16
+ * @example
17
+ * ```tsx
18
+ * const items = useCellRange(sheet, 'A7:C18');
19
+ * const rows = items?.getValues() ?? [];
20
+ * ```
21
+ */
22
+ export declare const useCellRange: (target: CellRangeTarget | null | undefined, address: ICellRange.Address, options?: CellRangeHookOptions) => ICellRange | null;
23
+ //# sourceMappingURL=useCellRange.d.ts.map
@@ -0,0 +1,26 @@
1
+ import { ICellRange, Scalar } from '@sheetxl/sdk';
2
+ import { CellRangeTarget, CellRangeHookOptions } from './useRangeSnapshot';
3
+ /**
4
+ * Binds a cell's value like `useState`: returns the value and a setter, and re-renders when the value
5
+ * changes, whether from the setter, the grid, or a recalculation.
6
+ *
7
+ * @template T The expected value type. This is not checked or converted: an empty cell is `null`, and a
8
+ * cell can hold any type.
9
+ * @param target The workbook or sheet to read from, or `null` while there is none.
10
+ * @param address The cell's address. A larger range binds its top-left cell.
11
+ * @param options Listener options, and an optional `onChange` that receives each change event.
12
+ * @returns The value, or `null` while `target` is `null`, and a setter that does nothing until there
13
+ * is a target.
14
+ *
15
+ * @remarks
16
+ * The setter writes the value as-is: text is never parsed, so `'=1+1'` is stored as text rather than as
17
+ * a formula. To write formulas or styles, use {@link useCell}.
18
+ *
19
+ * @example
20
+ * ```tsx
21
+ * const [customer, setCustomer] = useCellValue<string>(sheet, 'A4');
22
+ * return <input value={customer ?? ''} onChange={(e) => setCustomer(e.target.value)} />;
23
+ * ```
24
+ */
25
+ export declare const useCellValue: <T extends Scalar = Scalar>(target: CellRangeTarget | null | undefined, address: ICellRange.Address, options?: CellRangeHookOptions) => [T | null, (value: T | null) => void];
26
+ //# sourceMappingURL=useCellValue.d.ts.map
@@ -25,8 +25,8 @@ export interface ModelListenerOptions extends Omit<IListener.Options, 'once'> {
25
25
  /**
26
26
  * React hook for subscribing to model-level events (workbooks, sheets, etc.).
27
27
  *
28
- * @template SOURCE - The model type (e.g., IWorkbook, ISheet)
29
- * @template EVENTS - The listener interface type (e.g., ISheet.IListeners)
28
+ * @template SOURCE - The model type (e.g., IWorkbook, IWorksheet)
29
+ * @template EVENTS - The listener interface type (e.g., IWorksheet.IListeners)
30
30
  *
31
31
  * @param source - The model instance to listen to, or `null` to listen to nothing
32
32
  * @param listeners - Object containing listener callbacks for various events
@@ -45,8 +45,8 @@ export interface ModelListenerOptions extends Omit<IListener.Options, 'once'> {
45
45
  *
46
46
  * @example
47
47
  * ```tsx
48
- * function SheetComponent({ sheet }: { sheet: ISheet }) {
49
- * useModelListener<ISheet, ISheet.IListeners>(sheet, {
48
+ * function SheetComponent({ sheet }: { sheet: IWorksheet }) {
49
+ * useModelListener<IWorksheet, IWorksheet.IListeners>(sheet, {
50
50
  * onSave(source, json) {
51
51
  * console.log('Sheet saved:', json);
52
52
  * },
@@ -1,15 +1,21 @@
1
1
  import { ICellRange } from '@sheetxl/sdk';
2
- export interface useRangeListenerOptions extends ICellRange.ListenerOptions {
3
- fireOnAddressChange: boolean;
4
- }
2
+ export type useRangeListenerOptions = ICellRange.ListenerOptions;
5
3
  export interface RangeContainer {
6
4
  getRange(address: ICellRange.Address, options?: ICellRange.GetRangeOptions): ICellRange;
7
5
  }
8
6
  /**
9
- * This hook delegates to the an model that contains a getRange(address) method.
7
+ * Listen to a range of `model` for as long as the component is mounted.
8
+ *
9
+ * @param model What the range is read from: a workbook or a sheet.
10
+ * @param address The range to listen to. Nothing is listened to while it is `null`.
11
+ * @param listener Called with each {@link ICellRange.Event}. The latest render's listener is the
12
+ * one called, so it may close over state without re-subscribing.
13
+ * @param options Which events to hear and how the range follows inserts and deletes
14
+ * ({@link ICellRange.ListenerOptions}). Read once per subscription.
10
15
  *
11
- * @param model
12
- * @param listener
16
+ * @remarks
17
+ * The subscription is renewed when `model` or `address` changes. Nothing is delivered for that
18
+ * renewal: the listener only hears what the range itself reports.
13
19
  */
14
- export declare const useRangeListener: (model: RangeContainer, address: ICellRange.Address, listener: ICellRange.Listener, options?: useRangeListenerOptions) => void;
20
+ export declare const useRangeListener: (model: RangeContainer | null | undefined, address: ICellRange.Address | null | undefined, listener: ICellRange.Listener, options?: useRangeListenerOptions) => void;
15
21
  //# sourceMappingURL=useRangeListener.d.ts.map
@@ -0,0 +1,35 @@
1
+ import { ICellRange, IWorkbook, IWorksheet } from '@sheetxl/sdk';
2
+ /**
3
+ * A workbook or a sheet: anything a range can be read from. A workbook address may be sheet-qualified
4
+ * (`'Invoice!A4'`); an unqualified one reads from the selected sheet.
5
+ */
6
+ export type CellRangeTarget = IWorkbook | IWorksheet;
7
+ /**
8
+ * Options shared by the cell-binding hooks.
9
+ */
10
+ export interface CellRangeHookOptions extends Omit<ICellRange.ListenerOptions, 'transactional'> {
11
+ /**
12
+ * Called with every change event the hook receives, before it re-renders.
13
+ *
14
+ * @remarks
15
+ * Uses the hook's own subscription. To receive events without re-rendering, use
16
+ * {@link useRangeListener} instead.
17
+ */
18
+ onChange?: ICellRange.Listener;
19
+ }
20
+ /**
21
+ * Resolves `address` against `target` and returns the range with a value read from it. Both are
22
+ * re-read only after the range reports a change, so they are stable between changes, as
23
+ * `useSyncExternalStore` requires.
24
+ *
25
+ * @param topLeft Narrow the range to its top-left cell.
26
+ *
27
+ * @remarks
28
+ * The range follows its cells: when rows or columns are inserted or deleted around it (or undone),
29
+ * the returned range is the one at the new address, so a write goes where the cells went.
30
+ */
31
+ export declare const useRangeSnapshot: <T>(target: CellRangeTarget | null | undefined, address: ICellRange.Address, topLeft: boolean, read: (range: ICellRange) => T, options?: CellRangeHookOptions) => {
32
+ range: ICellRange | null;
33
+ snapshot: T | null;
34
+ };
35
+ //# sourceMappingURL=useRangeSnapshot.d.ts.map
@@ -0,0 +1,26 @@
1
+ import { ITable } from '@sheetxl/sdk';
2
+ import { CellRangeTarget, CellRangeHookOptions } from './useRangeSnapshot';
3
+ /**
4
+ * Returns the table named `name` and re-renders when it changes: rows added or removed, its cells
5
+ * edited, or its settings changed.
6
+ *
7
+ * @param target The workbook or sheet to find the table in, or `null` while there is none. A workbook
8
+ * looks in each of its sheets.
9
+ * @param name The table's name.
10
+ * @param options Listener options for its cells, and an optional `onChange` that receives each change
11
+ * event in them.
12
+ * @returns The table, or `null` while `target` is `null` or has no table of that name.
13
+ *
14
+ * @remarks
15
+ * The returned table is the same object across renders; read from it during render, and change it
16
+ * through its own methods, such as {@link ITable.addRow} and {@link ITable.deleteRowsAt}.
17
+ *
18
+ * @example
19
+ * ```tsx
20
+ * const items = useTable(workbook, 'Items');
21
+ * const rows = items?.getDataRange().getValues() ?? [];
22
+ * return <button onClick={() => items?.addRow()}>Add</button>;
23
+ * ```
24
+ */
25
+ export declare const useTable: (target: CellRangeTarget | null | undefined, name: string, options?: CellRangeHookOptions) => ITable | null;
26
+ //# sourceMappingURL=useTable.d.ts.map
@@ -0,0 +1,18 @@
1
+ import { default as React } from 'react';
2
+ import { IMovableCollection } from '@sheetxl/sdk';
3
+ export interface ConnectionSitesProps {
4
+ /** The sheet's movables, every one of which may offer sites. */
5
+ movables: IMovableCollection;
6
+ /** The layer's extent, in pane px. */
7
+ width: number;
8
+ height: number;
9
+ }
10
+ /**
11
+ * The connection sites a dragged connector end may glue to, drawn over every movable on the
12
+ * sheet while an end is held (`movable-connect` surface state); the site the end would take is
13
+ * filled. Which movables offer sites, and where, is the model's (`IMovable.getConnectionSites`):
14
+ * a picture or a chart its four edges, a shape its geometry's, a group none. Drawn by the layer,
15
+ * not by each content's editor, so a content kind needs nothing of its own to be glued to.
16
+ */
17
+ export declare const ConnectionSites: React.FC<ConnectionSitesProps>;
18
+ //# sourceMappingURL=ConnectionSites.d.ts.map
@@ -0,0 +1,8 @@
1
+ import { default as React } from 'react';
2
+ import { MovableElementProps } from './IMovableArea';
3
+ /**
4
+ * Renders a movable with the renderer for its kind of content, or a placeholder for a kind with
5
+ * none. The default `renderMovable` of a sheet element.
6
+ */
7
+ export declare const defaultRenderMovable: (props: MovableElementProps) => React.ReactElement;
8
+ //# sourceMappingURL=DefaultMovable.d.ts.map