@sheetxl/react 0.8.0-beta.2 → 0.8.0-beta.20

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 (405) hide show
  1. package/LICENSE.md +8 -7
  2. package/browser/esm/B06WJCAWTIB7QYlK.mjs +45 -0
  3. package/browser/esm/B8_6V0LUnuA1dLW6.mjs +20 -0
  4. package/browser/esm/BFjx8_H3wUxrWDq9.mjs +60 -0
  5. package/browser/esm/BGcs5WWx5PpaiJo4.mjs +36 -0
  6. package/browser/esm/BcC6S9k7zkHfCNRX.mjs +42 -0
  7. package/browser/esm/BkBxhk45Iln3h-sG.mjs +67 -0
  8. package/browser/esm/BzZ2vOT8CNsqcL8P.mjs +79 -0
  9. package/browser/esm/C1Qp40Kq88D9nzcX.mjs +19 -0
  10. package/browser/esm/C5RaHvks1HTBfWcr.mjs +14092 -0
  11. package/browser/esm/CM9e6dbkYbw56iFf.mjs +401 -0
  12. package/browser/esm/COn0z_IT5hyEPNfV.mjs +8 -0
  13. package/browser/esm/CPjk4grd05Rp-e3V.mjs +9560 -0
  14. package/browser/esm/CU67T36gmVTq9ZwH.mjs +31 -0
  15. package/browser/esm/CUPlUCBX7owYqDq5.mjs +78 -0
  16. package/browser/esm/Ca_Ki0Si5ozlm1sl.mjs +197 -0
  17. package/browser/esm/CckrsFaUWle82oNL.mjs +63 -0
  18. package/browser/esm/Ch5X-uGft55TOqxa.mjs +262 -0
  19. package/browser/esm/CtbJ8PCap2NGxlu0.mjs +32 -0
  20. package/browser/esm/Cwye4MAU1-EF7Xlv.mjs +341 -0
  21. package/browser/esm/DcEGutcM_5gl0fZm.mjs +145 -0
  22. package/browser/esm/DeOhqQroIiAic6-j.mjs +2706 -0
  23. package/browser/esm/Dkw3FFdQKXZQrkFv.mjs +303 -0
  24. package/browser/esm/QJPDAP6UIHTbY1fM.mjs +134 -0
  25. package/browser/esm/SESUB_fypyWmhCWm.mjs +323 -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 +22345 -13175
  30. package/browser/esm/note.mjs +112 -0
  31. package/browser/esm/picture.mjs +7 -0
  32. package/browser/esm/qeb-_mAjUAWD7bo4.mjs +128 -0
  33. package/browser/esm/shape.mjs +7 -0
  34. package/browser/esm/slicer.mjs +277 -0
  35. package/licenses/dependencies.txt +284 -565
  36. package/node/esm/77PQMLXXAN7fjBHS.mjs +8 -0
  37. package/node/esm/7_AWLfp_6MpYBpiV.mjs +32 -0
  38. package/node/esm/BOAB33GIG2M2CWMr.mjs +80 -0
  39. package/node/esm/BbnUYxeK64Fq92Lo.mjs +406 -0
  40. package/node/esm/C7wmHIY8RLeNSX3T.mjs +35 -0
  41. package/node/esm/C9Yq98-vMDznppO2.mjs +134 -0
  42. package/node/esm/CBHY_xaB7ke3yH-f.mjs +66 -0
  43. package/node/esm/CER7_OJffhze14wR.mjs +20 -0
  44. package/node/esm/CWOKAmLpdinc-0TK.mjs +263 -0
  45. package/node/esm/CqnJ_hGK1txHO0j9.mjs +328 -0
  46. package/node/esm/D63HF8XToGXrf7ds.mjs +45 -0
  47. package/node/esm/DmPmSA-2Aha-_6qu.mjs +198 -0
  48. package/node/esm/DrFBSp6XMEAjkdoG.mjs +1697 -0
  49. package/node/esm/DytW9LaLlJGM-6m6.mjs +2706 -0
  50. package/node/esm/Ef8HHL90yLZgk3Gf.mjs +146 -0
  51. package/node/esm/G9tXP39ldfioRVhL.mjs +68 -0
  52. package/node/esm/Jy5x43_CAF31L14-.mjs +37 -0
  53. package/node/esm/Nn0yfoegNHIym4QM.mjs +63 -0
  54. package/node/esm/UBas29HOMjk4p5jo.mjs +19 -0
  55. package/node/esm/c1FOnFN_eCD6KR4l.mjs +80 -0
  56. package/node/esm/chart.mjs +41 -0
  57. package/node/esm/control.mjs +217 -0
  58. package/node/esm/gfwmGAXGhq9IIu1U.mjs +128 -0
  59. package/node/esm/group.mjs +123 -0
  60. package/node/esm/index.mjs +19282 -9996
  61. package/node/esm/note.mjs +113 -0
  62. package/node/esm/picture.mjs +305 -0
  63. package/node/esm/shape.mjs +342 -0
  64. package/node/esm/slicer.mjs +279 -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 +314 -27
  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 +367 -3
  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 +328 -29
  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 +369 -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 +6 -0
  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 +6 -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 +60 -19
  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 +94 -0
  159. package/types/src/comment/CommentUtils.d.ts +43 -0
  160. package/types/src/comment/NoteEditor.d.ts +20 -0
  161. package/types/src/comment/index.d.ts +5 -0
  162. package/types/src/comment/useCommentThread.d.ts +37 -0
  163. package/types/src/comment/useSheetComments.d.ts +28 -0
  164. package/types/src/conditionalFormat/ConditionalFormatPresets.d.ts +6 -6
  165. package/types/src/context/WorksheetContext.d.ts +18 -0
  166. package/types/src/context/index.d.ts +1 -1
  167. package/types/src/control/FormControlRenderers.d.ts +22 -0
  168. package/types/src/editableLabel/EditableLabel.d.ts +3 -1
  169. package/types/src/editor/EditorCommands.d.ts +3 -3
  170. package/types/src/editor/FunctionPreviewPanel.d.ts +1 -1
  171. package/types/src/editor/SheetCellEditorLayer.d.ts +2 -10
  172. package/types/src/editor/SheetCellEditorStartLayer.d.ts +61 -0
  173. package/types/src/editor/SheetCellInput.d.ts +14 -0
  174. package/types/src/editor/SheetEditable.d.ts +6 -6
  175. package/types/src/editor/SheetReferenceHeaderLayer.d.ts +1 -1
  176. package/types/src/editor/SheetReferenceLayer.d.ts +4 -4
  177. package/types/src/editor/VirtualKeyboardLayer.d.ts +50 -0
  178. package/types/src/editor/formulaAnchor.d.ts +12 -0
  179. package/types/src/editor/index.d.ts +3 -0
  180. package/types/src/editor/pickedReference.d.ts +3 -3
  181. package/types/src/editor/useEditRejectedNotice.d.ts +3 -3
  182. package/types/src/editor/useFormulaHints.d.ts +3 -3
  183. package/types/src/editor/useFormulaInput.d.ts +15 -3
  184. package/types/src/editor/validationAlert.d.ts +24 -0
  185. package/types/src/form/FormulaInput.d.ts +5 -2
  186. package/types/src/form/useEditCommit.d.ts +23 -3
  187. package/types/src/form/useInputField.d.ts +2 -3
  188. package/types/src/frame/CommandContext.d.ts +101 -3
  189. package/types/src/group/GroupEditor.d.ts +25 -0
  190. package/types/src/index.d.ts +12 -1
  191. package/types/src/layer/BorderLayer.d.ts +5 -2
  192. package/types/src/layer/CellErrorLayer.d.ts +18 -7
  193. package/types/src/layer/CellFillLayer.d.ts +2 -2
  194. package/types/src/layer/CellIndicatorLayer.d.ts +31 -0
  195. package/types/src/layer/CellInsertLayer.d.ts +71 -0
  196. package/types/src/layer/CircularIndicatorLayer.d.ts +3 -3
  197. package/types/src/layer/CommentCardLayer.d.ts +43 -0
  198. package/types/src/layer/CommentsLayer.d.ts +35 -0
  199. package/types/src/layer/ConditionalBarLayer.d.ts +2 -2
  200. package/types/src/layer/ConditionalIcons.d.ts +4 -4
  201. package/types/src/layer/ConditionalIconsLayer.d.ts +2 -2
  202. package/types/src/layer/ContextMenuLayer.d.ts +2 -2
  203. package/types/src/layer/FreezeDragLines.d.ts +17 -0
  204. package/types/src/layer/GridFreezeLayer.d.ts +11 -0
  205. package/types/src/layer/HeaderFreezeLayer.d.ts +12 -0
  206. package/types/src/layer/HeaderResizerLayer.d.ts +2 -1
  207. package/types/src/layer/HeaderSelectionLayer.d.ts +4 -4
  208. package/types/src/layer/HyperlinkLayer.d.ts +116 -0
  209. package/types/src/layer/MovableKindScope.d.ts +17 -0
  210. package/types/src/layer/PivotLayer.d.ts +47 -0
  211. package/types/src/layer/PivotToolbar.d.ts +29 -0
  212. package/types/src/layer/ProtectionLayer.d.ts +4 -5
  213. package/types/src/layer/RangeToolbar.d.ts +75 -0
  214. package/types/src/layer/ResizeIndicator.d.ts +11 -10
  215. package/types/src/layer/ResizeTooltip.d.ts +13 -0
  216. package/types/src/layer/SheetBackgroundLayer.d.ts +3 -3
  217. package/types/src/layer/SheetCellLayer.d.ts +15 -8
  218. package/types/src/layer/SheetColumnButtonLayer.d.ts +2 -2
  219. package/types/src/layer/SheetGridLineLayer.d.ts +25 -15
  220. package/types/src/layer/SheetHeaderCellLayer.d.ts +10 -1
  221. package/types/src/layer/SheetLayers.d.ts +171 -0
  222. package/types/src/layer/SheetMovableLayer.d.ts +4 -3
  223. package/types/src/layer/SheetOutlineLayer.d.ts +40 -0
  224. package/types/src/layer/SheetPivotCommandLayer.d.ts +13 -0
  225. package/types/src/layer/SheetSparklineCommandLayer.d.ts +14 -0
  226. package/types/src/layer/SheetTableCommandLayer.d.ts +2 -2
  227. package/types/src/layer/SparklineLayer.d.ts +32 -0
  228. package/types/src/layer/SpillLayer.d.ts +2 -2
  229. package/types/src/layer/TableLayer.d.ts +6 -5
  230. package/types/src/layer/TableToolbar.d.ts +23 -0
  231. package/types/src/layer/ValidationDropdownLayer.d.ts +2 -2
  232. package/types/src/layer/ValidationIndicatorLayer.d.ts +2 -2
  233. package/types/src/layer/ValidationPromptLayer.d.ts +47 -16
  234. package/types/src/layer/_sheetBorders.d.ts +6 -0
  235. package/types/src/layer/_tableColor.d.ts +6 -0
  236. package/types/src/layer/_visibleCellFeatures.d.ts +11 -0
  237. package/types/src/layer/cellTip.d.ts +13 -0
  238. package/types/src/layer/freezeDragState.d.ts +21 -0
  239. package/types/src/layer/index.d.ts +17 -0
  240. package/types/src/layer/resizeIndicatorState.d.ts +3 -1
  241. package/types/src/layer/useFreezeDrag.d.ts +22 -0
  242. package/types/src/layer/useNormalBorderLines.d.ts +15 -0
  243. package/types/src/layer/useSheetFeatureRegions.d.ts +2 -2
  244. package/types/src/layer/useSheetVisibleCells.d.ts +5 -6
  245. package/types/src/layer/useSheetVisibleDecorations.d.ts +2 -2
  246. package/types/src/layer/useTableHeaderCells.d.ts +2 -2
  247. package/types/src/layer/useValidationPicker.d.ts +3 -3
  248. package/types/src/layer/useVisibleTables.d.ts +2 -2
  249. package/types/src/layer/validationMark.d.ts +3 -3
  250. package/types/src/listener/index.d.ts +5 -0
  251. package/types/src/listener/useCell.d.ts +29 -0
  252. package/types/src/listener/useCellRange.d.ts +23 -0
  253. package/types/src/listener/useCellValue.d.ts +26 -0
  254. package/types/src/listener/useModelListener.d.ts +8 -8
  255. package/types/src/listener/useRangeListener.d.ts +13 -7
  256. package/types/src/listener/useRangeSnapshot.d.ts +35 -0
  257. package/types/src/listener/useTable.d.ts +26 -0
  258. package/types/src/movable/ConnectionSites.d.ts +18 -0
  259. package/types/src/movable/DefaultMovable.d.ts +8 -0
  260. package/types/src/movable/IMovableArea.d.ts +56 -0
  261. package/types/src/movable/MovableAdornment.d.ts +26 -0
  262. package/types/src/movable/MovableCommandGroups.d.ts +22 -0
  263. package/types/src/movable/MovableCommands.d.ts +8 -3
  264. package/types/src/movable/MovableControl.d.ts +80 -0
  265. package/types/src/movable/MovableEdit.d.ts +22 -0
  266. package/types/src/movable/MovableFrame.d.ts +18 -14
  267. package/types/src/movable/MovableLayer.d.ts +30 -5
  268. package/types/src/movable/MovableRenderers.d.ts +210 -0
  269. package/types/src/movable/PlaceholderFrames.d.ts +11 -0
  270. package/types/src/movable/RotateHandle.d.ts +37 -0
  271. package/types/src/movable/TextBox.d.ts +34 -0
  272. package/types/src/movable/connect.d.ts +16 -0
  273. package/types/src/movable/framePlacement.d.ts +72 -0
  274. package/types/src/movable/geometry.d.ts +61 -0
  275. package/types/src/movable/index.d.ts +11 -0
  276. package/types/src/movable/pressTarget.d.ts +20 -0
  277. package/types/src/movable/useFramePreview.d.ts +17 -0
  278. package/types/src/picker/cellPickerOpen.d.ts +3 -3
  279. package/types/src/picker/useCellPicker.d.ts +7 -5
  280. package/types/src/picture/PictureCommands.d.ts +20 -0
  281. package/types/src/picture/PictureKind.d.ts +7 -0
  282. package/types/src/picture/_pictureHyperlink.d.ts +13 -0
  283. package/types/src/picture/index.d.ts +0 -1
  284. package/types/src/picture/pictureCrop.d.ts +32 -0
  285. package/types/src/pivot/PivotAreas.d.ts +16 -0
  286. package/types/src/pivot/PivotChip.d.ts +33 -0
  287. package/types/src/pivot/PivotChipMenu.d.ts +74 -0
  288. package/types/src/pivot/PivotCommands.d.ts +24 -0
  289. package/types/src/pivot/PivotFieldList.d.ts +14 -0
  290. package/types/src/pivot/PivotFields.d.ts +47 -0
  291. package/types/src/pivot/PivotFieldsModel.d.ts +143 -0
  292. package/types/src/pivot/PivotTablePane.d.ts +47 -0
  293. package/types/src/pivot/_PivotFieldsContext.d.ts +41 -0
  294. package/types/src/pivot/_pivotNew.d.ts +12 -0
  295. package/types/src/pivot/_pivotRegion.d.ts +14 -0
  296. package/types/src/pivot/index.d.ts +9 -0
  297. package/types/src/pivot/usePivotFields.d.ts +17 -0
  298. package/types/src/presence/PresenceCommands.d.ts +35 -0
  299. package/types/src/presence/PresenceHost.d.ts +58 -0
  300. package/types/src/presence/PresenceMessages.d.ts +42 -0
  301. package/types/src/presence/PresenceStore.d.ts +165 -0
  302. package/types/src/presence/PresenceTypes.d.ts +78 -0
  303. package/types/src/presence/index.d.ts +7 -0
  304. package/types/src/presence/usePresence.d.ts +20 -0
  305. package/types/src/richText/RichTextEditor.d.ts +41 -0
  306. package/types/src/richText/index.d.ts +2 -0
  307. package/types/src/selection/SelectionCommands.d.ts +2 -2
  308. package/types/src/selection/SheetSelectionLayer.d.ts +6 -12
  309. package/types/src/shape/ConnectorControl.d.ts +46 -0
  310. package/types/src/shape/ShapeCommands.d.ts +11 -0
  311. package/types/src/shape/ShapeControl.d.ts +8 -0
  312. package/types/src/shape/ShapeEditor.d.ts +15 -2
  313. package/types/src/shape/ShapeGallery.d.ts +31 -0
  314. package/types/src/shape/ShapeHandles.d.ts +28 -0
  315. package/types/src/shape/ShapeKind.d.ts +7 -0
  316. package/types/src/shape/ShapeSVG.d.ts +22 -0
  317. package/types/src/shape/ShapeText.d.ts +17 -0
  318. package/types/src/shape/icons/ShapeIcons.d.ts +16 -0
  319. package/types/src/shape/icons/_ShapeIconPack.d.ts +4 -0
  320. package/types/src/shape/index.d.ts +3 -1
  321. package/types/src/shape/shapeFrame.d.ts +50 -0
  322. package/types/src/shape/shapeStyle.d.ts +82 -0
  323. package/types/src/sheet/ISheetHeaderElement.d.ts +3 -3
  324. package/types/src/sheet/{ISheetElement.d.ts → IWorksheetElement.d.ts} +111 -81
  325. package/types/src/sheet/OpaqueSheetElement.d.ts +21 -0
  326. package/types/src/sheet/SheetCommandProvider.d.ts +14 -6
  327. package/types/src/sheet/SheetCommands.d.ts +20 -5
  328. package/types/src/sheet/SheetKindIcon.d.ts +14 -0
  329. package/types/src/sheet/SheetOutlineElement.d.ts +70 -0
  330. package/types/src/sheet/SheetPanels.d.ts +11 -0
  331. package/types/src/sheet/SheetScrollbar.d.ts +4 -13
  332. package/types/src/sheet/TopLeftCorner.d.ts +2 -2
  333. package/types/src/sheet/WorksheetElement.d.ts +12 -0
  334. package/types/src/sheet/_freezeAt.d.ts +10 -0
  335. package/types/src/sheet/_hyperlinkEdit.d.ts +7 -0
  336. package/types/src/sheet/_useHeaderMetrics.d.ts +11 -0
  337. package/types/src/sheet/circularReferences.d.ts +4 -4
  338. package/types/src/sheet/index.d.ts +5 -2
  339. package/types/src/sheet/useCycleHighlight.d.ts +2 -2
  340. package/types/src/slicer/SlicerCommands.d.ts +10 -0
  341. package/types/src/slicer/SlicerEditor.d.ts +8 -2
  342. package/types/src/slicer/SlicerKind.d.ts +7 -0
  343. package/types/src/slicer/SlicerStylePreview.d.ts +18 -0
  344. package/types/src/slicer/index.d.ts +2 -1
  345. package/types/src/slicer/slicerStyles.d.ts +32 -0
  346. package/types/src/sparkline/PictureCache.d.ts +37 -0
  347. package/types/src/sparkline/SparklineCommands.d.ts +23 -0
  348. package/types/src/sparkline/SparklinePictures.d.ts +7 -0
  349. package/types/src/sparkline/paint/_drawing.d.ts +24 -0
  350. package/types/src/sparkline/paint/echarts.d.ts +8 -0
  351. package/types/src/sparkline/paint/index.d.ts +8 -0
  352. package/types/src/tabStrip/SheetTab.d.ts +1 -1
  353. package/types/src/tabStrip/Sortable.d.ts +5 -5
  354. package/types/src/tabStrip/TabStrip.d.ts +13 -6
  355. package/types/src/tabStrip/TabStripItem.d.ts +15 -13
  356. package/types/src/table/TableCommands.d.ts +2 -2
  357. package/types/src/taskPane/CellControlPane.d.ts +15 -0
  358. package/types/src/taskPane/MovablePane.d.ts +15 -0
  359. package/types/src/taskPane/TaskPaneArea.d.ts +7 -0
  360. package/types/src/taskPane/TaskPaneFrame.d.ts +4 -4
  361. package/types/src/taskPane/TaskPaneKeys.d.ts +38 -0
  362. package/types/src/taskPane/TaskPaneRegistry.d.ts +32 -12
  363. package/types/src/taskPane/_paneReasons.d.ts +7 -0
  364. package/types/src/taskPane/index.d.ts +3 -0
  365. package/types/src/taskPane/useTaskPane.d.ts +6 -3
  366. package/types/src/theme/ThemeState.d.ts +15 -2
  367. package/types/src/theme/buildDocThemeCSS.d.ts +4 -1
  368. package/types/src/theme/buildOOXMLThemeCSS.d.ts +2 -2
  369. package/types/src/theme/useGridColorScheme.d.ts +3 -3
  370. package/types/src/theme/useSystemColors.d.ts +2 -2
  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 +108 -23
  374. package/types/src/workbook/WorkbookCommands.d.ts +8 -3
  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 -41
  379. package/browser/esm/Dsn3z1hmkv-bWGVr.mjs +0 -6286
  380. package/node/esm/CyU4sKDpHyc6kF7j.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/SheetElement.d.ts +0 -15
@@ -1,14 +1,21 @@
1
1
  import { default as React } from 'react';
2
- import { Scalar } from '@sheetxl/sdk';
2
+ import { Scalar, IFilter } from '@sheetxl/sdk';
3
3
  import { CheckboxListProps } from '@sheetxl/grid-react';
4
4
  /** One value the checklist offers. */
5
5
  export interface ValueChecklistItem {
6
- /** The value as shown, and the identity a check is kept by. */
6
+ /** The value as shown, and the identity a check is kept by unless `key` says otherwise. */
7
7
  text: string;
8
+ /**
9
+ * The identity a check is kept by, when two rows may show the same text (by value, the number
10
+ * `1` and the text `'1`). Defaults to `text`.
11
+ */
12
+ key?: string;
8
13
  /** The value the text stands for, when a host needs it back (a filter writes it). */
9
14
  value?: Scalar;
10
15
  /** How many cells hold it, when the host knows. */
11
16
  count?: number;
17
+ /** The `(Blank)` row: a blank is a value, listed last, and shown apart from the texts. */
18
+ blank?: boolean;
12
19
  }
13
20
  /**
14
21
  * Props for {@link ValueChecklist}.
@@ -16,30 +23,52 @@ export interface ValueChecklistItem {
16
23
  export interface ValueChecklistProps {
17
24
  /** The values, in the order shown. */
18
25
  items: readonly ValueChecklistItem[];
19
- /** The checked values, by `text`. */
26
+ /**
27
+ * The date tree over the leading items, as `IFilter.getItems` answers it: one level per entry,
28
+ * each the runs of items its nodes span. Listed as Excel's tree: a row per node with a
29
+ * disclosure, the deepest level's nodes as the leaves, and the items past the tree flat under
30
+ * it. While a search is typed the dates list flat by their text.
31
+ */
32
+ dates?: readonly IFilter.DateLevel[];
33
+ /** The checked values, by their key (`text` unless an item gives a `key`). */
20
34
  checked: ReadonlySet<string>;
21
35
  /**
22
36
  * `texts` were set to `checked` — one on a click, the highlighted rows on Space, every row in
23
- * view on Select All. Rows out of the view (narrowed away by the search) are never named, so
24
- * they keep their state.
37
+ * view on Select All, every item of a node on its row. Rows out of the view (narrowed away by
38
+ * the search) are never named, so they keep their state.
25
39
  */
26
40
  onCheckedChange: (texts: readonly string[], checked: boolean) => void;
27
- /** Whether a `(Blanks)` row is offered, first in the list. */
28
- hasBlanks?: boolean;
29
- /** Whether the blanks row is checked. */
30
- blanksChecked?: boolean;
31
- /** The blanks row was set. Select All names it through this, not through `onCheckedChange`. */
32
- onBlanksChange?: (checked: boolean) => void;
33
- /** The host stopped listing values at its cap: a notice says so under the list. */
41
+ /**
42
+ * Whether the items are the texts cells show (a spreadsheet's list) or their values. In value
43
+ * mode rows align by type, numbers to the right, so `1` and the text `'1` read apart.
44
+ *
45
+ * @defaultValue `true`
46
+ */
47
+ byDisplay?: boolean;
48
+ /** Offered as a "By value" option under the search field's glyph when given. */
49
+ onByDisplayChange?: (byDisplay: boolean) => void;
50
+ /**
51
+ * The typed text is to join the values. Given, the search line offers an Add while the text
52
+ * is not already a value, and Enter adds it.
53
+ */
54
+ onAdd?: (text: string) => void;
55
+ /** The host stopped listing values at its cap: the count says so, the reason in its tooltip. */
34
56
  truncated?: boolean;
35
57
  /** A search field above the list. @defaultValue true */
36
58
  search?: boolean;
37
- /** Enter in the search field: the host applies. */
59
+ /** Enter in the search field, with nothing to add: the host applies. */
38
60
  onApply?: () => void;
39
61
  /** Escape with no search text to clear: the host closes. */
40
62
  onClose?: () => void;
41
- /** Take the focus on mount (the search field, or the list without one). @defaultValue true */
63
+ /** Take the focus on mount. @defaultValue true */
42
64
  autoFocus?: boolean;
65
+ /**
66
+ * Where the focus lands on mount: the list, so the arrows, Space and Enter work at once and a
67
+ * typed character moves to the search field; or the search field.
68
+ *
69
+ * @defaultValue 'list'
70
+ */
71
+ focusOn?: 'list' | 'search';
43
72
  /** See `CheckboxListProps.renderCheckbox`: a styled control (MUI) in place of the native one. */
44
73
  renderCheckbox?: CheckboxListProps['renderCheckbox'];
45
74
  /** Render a value row's label. @defaultValue the text */
@@ -54,15 +83,27 @@ export interface ValueChecklistProps {
54
83
  viewport?: CheckboxListProps['viewport'];
55
84
  }
56
85
  /**
57
- * A searchable **checklist of values** with a tri-state Select All, a `(Blanks)` row and a count
58
- * line — the filter dropdown's Values body, and any other "which of these" choice.
86
+ * A searchable **checklist of values** under a tri-state Select All — the filter dropdown's
87
+ * Values body, and any other "which of these" choice.
59
88
  *
60
89
  * @remarks
90
+ * The list holds values and nothing else. Over them, pinned above the scroll, is the root: one
91
+ * tri-state checkbox for every row in view, labeled by the count of checked values over the
92
+ * values in view. Add, for a host that takes typed values, sits after the search field. A blank
93
+ * is a value: a host that has one lists it last as its `blank` row, which the root and the count
94
+ * cover like any other.
95
+ *
61
96
  * Reads no cells: the host supplies the items and owns the checked set (by text). The search
62
- * narrows the VIEW only: Select All acts on the rows in view, rows narrowed away keep their state,
97
+ * narrows the VIEW only: the root acts on the rows in view, rows narrowed away keep their state,
63
98
  * and what the host applies is the whole set (Sheets' rule, not Excel's replace-with-results).
64
- * The search field keeps the focus; Up/Down move the list's highlight, Space toggles the
65
- * highlighted rows, Enter applies, Escape clears the search and then closes.
99
+ * The list has the focus on open: Up/Down move its highlight, Space toggles the highlighted rows,
100
+ * Enter applies, Tab leaves it, and a typed character moves to the search field. From the field
101
+ * the same keys reach the list, Enter applies, and Escape clears the search and then closes.
102
+ *
103
+ * With `dates`, the leading items are listed as a tree (Excel's year › month › day): a node's
104
+ * checkbox is the state of its items, its row toggles them all, and its disclosure (or Left and
105
+ * Right on the highlighted row, with nothing typed) folds it. Collapsing hides the member rows
106
+ * from the view; they keep their state.
66
107
  *
67
108
  * The root wears the grid's surface and mode, so the list looks like the cells it stands for even
68
109
  * inside chrome of another color.
@@ -1,5 +1,5 @@
1
1
  import { EditModeHandler, ReferenceableClipboard, RemoveListener } from '@sheetxl/utils';
2
- import { ICellRange, ISheet } from '@sheetxl/sdk';
2
+ import { ICellRange, IWorksheet } from '@sheetxl/sdk';
3
3
  import { Command, IReactNotifier } from '@sheetxl/utils-react';
4
4
  export interface SheetPasteOptions extends ReferenceableClipboard.PasteOptions, ICellRange.CopyOptions {
5
5
  }
@@ -57,11 +57,11 @@ export interface ContributeClipboardCommandsOptions {
57
57
  *
58
58
  * **Standalone:** this module owns *everything* about its commands — definitions, behavior, enablement
59
59
  * (protection-disable), and the marquee view — with **no dependency on SheetCommands** (it reads only the
60
- * generic `ISheet` model). It's the shape a third-party clipboard would take: sheet knows nothing about it.
60
+ * generic `IWorksheet` model). It's the shape a third-party clipboard would take: sheet knows nothing about it.
61
61
  */
62
62
  /** The single `data` bundle {@link contributeClipboardCommands} takes (the `DynamicCommandContributor` shape). */
63
63
  export interface ClipboardCommandData extends ContributeClipboardCommandsOptions {
64
- sheet: ISheet;
64
+ sheet: IWorksheet;
65
65
  }
66
66
  export declare function contributeClipboardCommands(contribution: Command.CommandContribution, data: ClipboardCommandData): RemoveListener;
67
67
  export {};
@@ -1,8 +1,8 @@
1
1
  import { default as React } from 'react';
2
- import { ISheet } from '@sheetxl/sdk';
2
+ import { IWorksheet } from '@sheetxl/sdk';
3
3
  import { LayerProps } from '@sheetxl/grid-react';
4
4
  export interface SheetClipboardLayerProps extends LayerProps {
5
- sheet: ISheet;
5
+ sheet: IWorksheet;
6
6
  /** Class for the marquee visuals (devtools identification). */
7
7
  className?: string;
8
8
  }
@@ -0,0 +1,19 @@
1
+ import { Command } from '@sheetxl/utils-react';
2
+ /**
3
+ * Key of the **main toolbar strip**: the registered entry whose members are the ordered ribbon tabs.
4
+ * A contextual tab contributes into it (`contributions: { [WORKBOOK_TOOLBARS_KEY]: { order } }`) and
5
+ * is shown with {@link contributeContextualToolbar}.
6
+ */
7
+ export declare const WORKBOOK_TOOLBARS_KEY = "workbookToolbars";
8
+ /**
9
+ * Registers `entry` in the default button registry for as long as at least one caller holds it, and
10
+ * returns the release. Several holders of the same key (several panes showing one table, a transient
11
+ * re-mount) share one registration; the last release unregisters it. Calling a release more than once
12
+ * is a no-op.
13
+ *
14
+ * Use this for a contextual tab and for any group only that tab references.
15
+ */
16
+ export declare function contributeContextualToolbar(entry: Command.CommandButtonEntry & {
17
+ key: string;
18
+ }): () => void;
19
+ //# sourceMappingURL=ContextualToolbar.d.ts.map
@@ -23,12 +23,15 @@ export interface TransactionalMiddlewareOptions {
23
23
  */
24
24
  isRepeatable?: (command: Command.ResolvedCommand<any, any, any>) => boolean;
25
25
  }
26
+ /** The commit meta entry naming the command that made the commit. */
27
+ export declare const COMMAND_META_KEY = "command";
26
28
  /**
27
29
  * The **shared transactional command wrapper** — one `CommandMiddleware` every feature reuses via
28
30
  * `contribution.use(...)` (sheet, movable, …) instead of re-implementing (or copying) it. Each
29
31
  * wrapped callback stays **pure**; the middleware adds, uniformly:
30
32
  *
31
- * - **batch** — runs the work in `transaction.doBatch(..., label)` so it's one undo entry;
33
+ * - **batch** — runs the work in `transaction.doBatch(..., label)` so it's one undo entry, recording
34
+ * the command's key in the commit's meta (`command`) so a view of the history can show its icon;
32
35
  * - **busy** — `notifier.showBusy(label)` for the duration;
33
36
  * - **error** — a thrown error is reported via `notifier.showError` (a *falsy* throw = user cancel ⇒ swallowed);
34
37
  * - **repeatable** — after success, sets `manager.setRepeatableOperation` so F4 / redo-when-empty
@@ -1,4 +1,5 @@
1
1
  export * from './createTransactionalMiddleware';
2
+ export * from './ContextualToolbar';
2
3
  export * from './InputClipboardCommands';
3
4
  export * from './InputClipboardInjector';
4
5
  export * from './MainFocusContext';
@@ -0,0 +1,94 @@
1
+ import { CellCoords } from '@sheetxl/utils';
2
+ import { IComment, IWorksheet } from '@sheetxl/sdk';
3
+ /**
4
+ * What a comments task pane is asked to open on — `activateTaskPane('comments', { args })`.
5
+ */
6
+ export interface CommentsPaneArgs {
7
+ /**
8
+ * Scroll to this thread and put the caret in its reply box.
9
+ */
10
+ focus?: IComment;
11
+ /**
12
+ * Open a draft on the active cell. Nothing is written until it is posted.
13
+ */
14
+ insert?: boolean;
15
+ }
16
+ /**
17
+ * What a comment card is rendered from.
18
+ */
19
+ export interface CommentCardRenderProps {
20
+ /** The sheet the card's cell is on. */
21
+ sheet: IWorksheet;
22
+ /** The cell the card belongs to. */
23
+ coords: CellCoords;
24
+ /** The thread on the cell, or `null` for a draft: a comment that has not been posted. */
25
+ comment: IComment | null;
26
+ /**
27
+ * A new value each time a command asks for the card, whose text then takes the caret; `0` when
28
+ * none has.
29
+ */
30
+ focusRequest: number;
31
+ /** Dismisses the card; a draft that was not posted is dropped. */
32
+ onClose: () => void;
33
+ }
34
+ /**
35
+ * A cell whose comment card is asked to stay beside it with the caret in its text: a draft when the
36
+ * cell has no thread, the thread's reply box when it has one.
37
+ */
38
+ export interface CommentCardRequest extends CellCoords {
39
+ /**
40
+ * A new value each time the card's text is asked to take the caret; `0` when the card is only
41
+ * asked to stay.
42
+ */
43
+ focusRequest: number;
44
+ }
45
+ /**
46
+ * Options for {@link requestCommentCard}.
47
+ */
48
+ export interface RequestCommentCardOptions {
49
+ /**
50
+ * Whether the card's text takes the caret.
51
+ * @defaultValue true
52
+ */
53
+ autoFocus?: boolean;
54
+ }
55
+ /**
56
+ * Asks for the comment card of a cell: a draft when the cell has no thread, its thread otherwise.
57
+ *
58
+ * @remarks
59
+ * This is how a command reaches a card it cannot see. The card floats beside the cell until the
60
+ * request is {@link clearCommentCard | cleared}, which the layer drawing it does when the selection
61
+ * leaves the cell. A draft writes nothing until it is posted.
62
+ */
63
+ export declare const requestCommentCard: (sheet: IWorksheet, coords: CellCoords, options?: RequestCommentCardOptions) => void;
64
+ /**
65
+ * Takes back a {@link requestCommentCard | request}; a draft that was not posted is dropped.
66
+ */
67
+ export declare const clearCommentCard: (sheet: IWorksheet) => void;
68
+ /**
69
+ * The cell whose card is asked for on the sheet, or `null` for none.
70
+ */
71
+ export declare const getCommentCardRequest: (sheet: IWorksheet) => CommentCardRequest | null;
72
+ /**
73
+ * Whether anything draws the sheet's comment cards. A command falls back to the comments task pane
74
+ * when nothing does.
75
+ */
76
+ export declare const hasCommentCard: (sheet: IWorksheet) => boolean;
77
+ /**
78
+ * Listens for the sheet's card request changing. Whatever draws the cards listens; the returned
79
+ * function stops listening.
80
+ */
81
+ export declare const addCommentCardListener: (sheet: IWorksheet, listener: () => void) => (() => void);
82
+ /**
83
+ * The cell a draft is open on: a requested card whose cell has no comment yet. `null` for none.
84
+ *
85
+ * @remarks
86
+ * For what marks the cell while its comment is being written. Following this does not count as
87
+ * drawing the cards, so {@link hasCommentCard} is unchanged by it.
88
+ */
89
+ export declare const useCommentDraftCell: (sheet: IWorksheet) => CommentCardRequest | null;
90
+ /**
91
+ * {@link getCommentCardRequest}, kept current.
92
+ */
93
+ export declare const useCommentCardRequest: (sheet: IWorksheet) => CommentCardRequest | null;
94
+ //# sourceMappingURL=CommentCardRequest.d.ts.map
@@ -0,0 +1,43 @@
1
+ import { CellCoords } from '@sheetxl/utils';
2
+ import { IComment } from '@sheetxl/sdk';
3
+ /**
4
+ * The cell a comment is on, as plain coordinates.
5
+ *
6
+ * @remarks
7
+ * A comment's own range is anchored (`$B$2`); selecting or comparing cells wants the plain cell.
8
+ */
9
+ export declare const getCommentCoords: (comment: IComment) => CellCoords;
10
+ /**
11
+ * Orders comments as they are read on the sheet: by row, then by column.
12
+ */
13
+ export declare const compareComments: (a: IComment, b: IComment) => number;
14
+ /**
15
+ * The initials shown in a person's avatar: the first letter of the first and of the last word of
16
+ * their name, or of the one word it has.
17
+ */
18
+ export declare const getPersonInitials: (displayName: string | null | undefined) => string;
19
+ /**
20
+ * Options for {@link formatCommentTime}.
21
+ */
22
+ export interface FormatCommentTimeOptions {
23
+ /** The moment the time is relative to. Defaults to now. */
24
+ now?: Date;
25
+ /** A BCP 47 language tag. Defaults to the runtime's. */
26
+ locale?: string;
27
+ }
28
+ /**
29
+ * When a comment was written, as a card shows it.
30
+ */
31
+ export interface CommentTime {
32
+ /** How long ago, in words: `2 hours ago`, `yesterday`. */
33
+ relative: string;
34
+ /** The full date and time, for a tooltip. */
35
+ absolute: string;
36
+ }
37
+ /**
38
+ * Formats when a comment was written: relative for the card, absolute for its tooltip.
39
+ *
40
+ * @returns `null` for no date, which is what a note converted to a comment has.
41
+ */
42
+ export declare const formatCommentTime: (date: Date | null | undefined, options?: FormatCommentTimeOptions) => CommentTime | null;
43
+ //# sourceMappingURL=CommentUtils.d.ts.map
@@ -0,0 +1,20 @@
1
+ import { default as React } from 'react';
2
+ import { IComment } from '@sheetxl/sdk';
3
+ import { MovableElementProps } from '../movable';
4
+ export interface NoteEditorAttributes {
5
+ isNoteEditor: () => true;
6
+ }
7
+ export interface INoteEditorElement extends HTMLDivElement, NoteEditorAttributes {
8
+ }
9
+ export interface NoteEditorProps extends MovableElementProps {
10
+ /**
11
+ * The note whose box this draws.
12
+ */
13
+ note: IComment;
14
+ ref?: React.Ref<INoteEditorElement>;
15
+ }
16
+ /**
17
+ * Draws a note in its box: the text with its formatting runs, edited in place.
18
+ */
19
+ export declare const NoteEditor: React.NamedExoticComponent<Omit<NoteEditorProps, "ref"> & React.RefAttributes<INoteEditorElement>>;
20
+ //# sourceMappingURL=NoteEditor.d.ts.map
@@ -0,0 +1,5 @@
1
+ export * from './CommentUtils';
2
+ export * from './CommentCardRequest';
3
+ export * from './useSheetComments';
4
+ export * from './useCommentThread';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,37 @@
1
+ import { IComment, IPerson } from '@sheetxl/sdk';
2
+ /**
3
+ * One thread as a card shows it: the comment's current values, read once per change.
4
+ */
5
+ export interface CommentThread {
6
+ /** The comment's text. */
7
+ content: string;
8
+ /** Who wrote it, or `null` if the workbook does not know them. */
9
+ author: IPerson | null;
10
+ /** When it was written, or `null` if it carries no date. */
11
+ date: Date | null;
12
+ /** Whether the thread is resolved. */
13
+ resolved: boolean;
14
+ /** The replies, oldest first. */
15
+ replies: IComment.IReply[];
16
+ /** `true` once the comment has been deleted; the other values are then empty. */
17
+ deleted: boolean;
18
+ }
19
+ /**
20
+ * A comment's thread, kept current: its text, author, replies and resolved state.
21
+ *
22
+ * @param comment The comment, or `null` for none (a draft that has not been posted).
23
+ * @returns The thread, or `null` when there is no comment.
24
+ *
25
+ * @remarks
26
+ * The object keeps its identity until the comment's content, replies or resolved state changes,
27
+ * or the comment is deleted.
28
+ *
29
+ * @example
30
+ * ```tsx
31
+ * const thread = useCommentThread(comment);
32
+ * if (!thread || thread.deleted) return null;
33
+ * return <p>{thread.author?.getDisplayName()}: {thread.content} ({thread.replies.length} replies)</p>;
34
+ * ```
35
+ */
36
+ export declare const useCommentThread: (comment: IComment | null) => CommentThread | null;
37
+ //# sourceMappingURL=useCommentThread.d.ts.map
@@ -0,0 +1,28 @@
1
+ import { IComment, IWorksheet } from '@sheetxl/sdk';
2
+ /**
3
+ * Options for {@link useSheetComments}.
4
+ */
5
+ export interface UseSheetCommentsOptions {
6
+ /**
7
+ * Only threads with this resolved state. Omit for every thread.
8
+ */
9
+ resolved?: boolean;
10
+ }
11
+ /**
12
+ * The threaded comments on a sheet, in reading order, kept current.
13
+ *
14
+ * @param sheet The sheet, or `null` for none.
15
+ * @param options {@link UseSheetCommentsOptions}
16
+ *
17
+ * @remarks
18
+ * Notes are not threads and are left out. The array keeps its identity until a comment on the
19
+ * sheet is added, removed, moved, edited, replied to or resolved.
20
+ *
21
+ * @example
22
+ * ```tsx
23
+ * const open = useSheetComments(sheet, { resolved: false });
24
+ * return <ul>{open.map((comment) => <li key={comment.getId()}>{comment.getContent()}</li>)}</ul>;
25
+ * ```
26
+ */
27
+ export declare const useSheetComments: (sheet: IWorksheet | null, options?: UseSheetCommentsOptions) => IComment[];
28
+ //# sourceMappingURL=useSheetComments.d.ts.map
@@ -1,4 +1,4 @@
1
- import { IConditionalFormat, IStyle } from '@sheetxl/sdk';
1
+ import { IConditionalFormat, ICellStyle } from '@sheetxl/sdk';
2
2
  /**
3
3
  * Shared authoring presets for the conditional-format editor.
4
4
  *
@@ -13,7 +13,7 @@ import { IConditionalFormat, IStyle } from '@sheetxl/sdk';
13
13
  export interface StylePreset {
14
14
  /** Stable identifier; UI layers key their localized tooltip off it. */
15
15
  key: string;
16
- style: IStyle.Properties;
16
+ style: ICellStyle.Properties;
17
17
  }
18
18
  export declare const STYLE_PRESETS: readonly StylePreset[];
19
19
  /**
@@ -42,7 +42,7 @@ export declare const defaultIconSet: () => IConditionalFormat.IconSet;
42
42
  export interface IconSetGalleryBlock {
43
43
  key: 'directional' | 'shapes' | 'indicators' | 'ratings';
44
44
  /** Each row is a pair of sets; the right seat may be empty. */
45
- rows: readonly (readonly [IStyle.IconSet, IStyle.IconSet | null])[];
45
+ rows: readonly (readonly [ICellStyle.IconSet, ICellStyle.IconSet | null])[];
46
46
  }
47
47
  /**
48
48
  * Every set the gallery offers, laid out the way Excel Online's own gallery is — two sets to a
@@ -64,13 +64,13 @@ export declare const ICON_SET_GALLERY_BLOCKS: readonly IconSetGalleryBlock[];
64
64
  */
65
65
  export declare const iconSetSize: (set: string) => number;
66
66
  /** A ready-to-apply rule for a built-in set — the set at Excel's default even banding. */
67
- export declare const iconSetPreset: (set: IStyle.IconSet) => IConditionalFormat.IconSet;
67
+ export declare const iconSetPreset: (set: ICellStyle.IconSet) => IConditionalFormat.IconSet;
68
68
  /**
69
69
  * The per-band override that draws nothing — Excel's "No Cell Icon", spelled the way its x14
70
70
  * writer spells it.
71
71
  */
72
72
  export declare const NO_CELL_ICON: Readonly<{
73
- set: IStyle.IconSet;
73
+ set: ICellStyle.IconSet;
74
74
  id: number;
75
75
  }>;
76
76
  /**
@@ -87,7 +87,7 @@ export declare const NO_CELL_ICON: Readonly<{
87
87
  * @param icon The icon to draw there, or `null` to restore the band's own.
88
88
  */
89
89
  export declare const withIconOverride: (scale: IConditionalFormat.IconSet, band: number, icon: {
90
- set: IStyle.IconSet;
90
+ set: ICellStyle.IconSet;
91
91
  id: number;
92
92
  } | null) => IConditionalFormat.IconSet;
93
93
  //# sourceMappingURL=ConditionalFormatPresets.d.ts.map
@@ -0,0 +1,18 @@
1
+ import { default as React, ReactNode } from 'react';
2
+ import { IWorksheet } from '@sheetxl/sdk';
3
+ export type WorksheetProviderProps = {
4
+ sheet: IWorksheet | null;
5
+ children: ReactNode;
6
+ };
7
+ /**
8
+ * Provides a sheet to descendants.
9
+ *
10
+ * Notes:
11
+ * - Prefer passing the sheet object as a stable reference from the host.
12
+ */
13
+ export declare function WorksheetProvider(props: WorksheetProviderProps): React.JSX.Element;
14
+ /**
15
+ * Hook consumers call to access the current sheet.
16
+ */
17
+ export declare function useWorksheet(): IWorksheet | null;
18
+ //# sourceMappingURL=WorksheetContext.d.ts.map
@@ -1,3 +1,3 @@
1
1
  export * from './WorkbookContext';
2
- export * from './SheetContext';
2
+ export * from './WorksheetContext';
3
3
  //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,22 @@
1
+ import { default as React } from 'react';
2
+ import { MovableRendererProps } from '../movable';
3
+ export declare const ButtonRenderer: React.ComponentType<MovableRendererProps>;
4
+ export declare const CheckBoxRenderer: React.ComponentType<MovableRendererProps>;
5
+ export declare const OptionButtonRenderer: React.ComponentType<MovableRendererProps>;
6
+ /**
7
+ * The browser's own slider, lying the way the shape does. A vertical one runs downward, its
8
+ * minimum at the top, as Excel's scroll bar does.
9
+ */
10
+ export declare const ScrollBarRenderer: React.ComponentType<MovableRendererProps>;
11
+ /**
12
+ * A spinner is its two buttons and nothing else; the number it holds is in its linked cell. The
13
+ * browser's own buttons, as the button control's are.
14
+ */
15
+ export declare const SpinnerRenderer: React.ComponentType<MovableRendererProps>;
16
+ export declare const DropDownRenderer: React.ComponentType<MovableRendererProps>;
17
+ export declare const ListBoxRenderer: React.ComponentType<MovableRendererProps>;
18
+ export declare const GroupBoxRenderer: React.ComponentType<MovableRendererProps>;
19
+ export declare const LabelRenderer: React.ComponentType<MovableRendererProps>;
20
+ /** A kind with no look of its own: a neutral frame with its name. */
21
+ export declare const UnmodeledControlRenderer: React.ComponentType<MovableRendererProps>;
22
+ //# sourceMappingURL=FormControlRenderers.d.ts.map
@@ -1,4 +1,5 @@
1
1
  import { default as React } from 'react';
2
+ import { RenderSlotFn } from '@sheetxl/utils-react';
2
3
  export interface EditableLabelAttributes {
3
4
  startEdit(): void;
4
5
  cancel(): void;
@@ -18,7 +19,8 @@ export interface EditableLabelProps extends Omit<React.HTMLAttributes<HTMLDivEle
18
19
  onChange?: (value: string) => void;
19
20
  onSubmit?: (value: string) => boolean | void;
20
21
  onCancel?: () => void;
21
- renderInput?: (props: any) => React.ReactElement<HTMLInputElement>;
22
+ /** Render the input shown while editing. Spread the props on an `<input>`. */
23
+ renderInput?: RenderSlotFn<React.InputHTMLAttributes<HTMLInputElement>>;
22
24
  /**
23
25
  * Reference to the HTMLInputElement (or other) used for editing
24
26
  */
@@ -1,5 +1,5 @@
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 { IEditable, EditorMode, EditorTextSelection } from '@sheetxl/grid-react';
5
5
  /**
@@ -52,7 +52,7 @@ export declare function insertEditText(editable: IEditable<any, any, any>, text:
52
52
  /** The single `data` bundle {@link contributeInsertCommands} takes (the `DynamicCommandContributor` shape). */
53
53
  export interface InsertCommandData {
54
54
  editable: IEditable<any, any, any>;
55
- sheet: ISheet;
55
+ sheet: IWorksheet;
56
56
  /** `'startEdit'` begins an edit (the sheet's version when NOT editing); `'caret'` inserts at the focused editor's caret. */
57
57
  flavor: InsertFlavor;
58
58
  }
@@ -86,7 +86,7 @@ export declare function contributeWhileEditingCommands(contribution: Command.Com
86
86
  /** The single `data` bundle {@link contributeEditorCommands} takes (the `DynamicCommandContributor` shape). */
87
87
  export interface EditorCommandData {
88
88
  editable: IEditable<any, any, any>;
89
- sheet: ISheet;
89
+ sheet: IWorksheet;
90
90
  /**
91
91
  * Contribute the edit-session commands only while an edit is **active** (a session exists). An idle editor
92
92
  * owns no F4 / no caret overrides, so they cede to `redo` / the sheet's begin-edit flavor. The host passes
@@ -171,7 +171,7 @@ export interface FunctionPreviewPanelProps {
171
171
  * @remarks
172
172
  * This is the "B" half of the formula-editor hint UI (the autocomplete *list* is "A"). Presentational
173
173
  * and props-driven — the editor owns the caret → hint derivation and passes it down. The expand/collapse
174
- * state persists (via {@link usePersistenceState}); close is delegated via
174
+ * state persists (via {@link usePersistentState}); close is delegated via
175
175
  * {@link FunctionPreviewPanelProps.onClose}. No **Example** is shown: `IDescriptor` has no function-level
176
176
  * example and we won't fabricate one. The active-argument emphasis is driven by `hint.argIndex`. Nothing
177
177
  * here mutates the edit.
@@ -1,8 +1,7 @@
1
1
  import { default as React } from 'react';
2
- import { ISheet } from '@sheetxl/sdk';
2
+ import { IWorksheet } from '@sheetxl/sdk';
3
3
  import { EditorAlignment, VirtualDivProps } from '@sheetxl/grid-react';
4
4
  import { SheetEditable } from './SheetEditable';
5
- import { EditRejectedNotice } from './useEditRejectedNotice';
6
5
  /**
7
6
  * Props for {@link SheetCellEditorLayer}.
8
7
  *
@@ -15,7 +14,7 @@ export interface SheetCellEditorLayerProps extends VirtualDivProps {
15
14
  */
16
15
  zIndex?: number;
17
16
  /** The sheet — its selection drives the input's leave-key nav, its active cell the edit-session commands. */
18
- sheet: ISheet;
17
+ sheet: IWorksheet;
19
18
  /** The editable (UI model) — anchor + the single current edit. Shared with peers (the formula bar). */
20
19
  editable: SheetEditable;
21
20
  /**
@@ -29,13 +28,6 @@ export interface SheetCellEditorLayerProps extends VirtualDivProps {
29
28
  * default, which follows the edited cell's rendered alignment (formulas always grow to the right).
30
29
  */
31
30
  alignment?: EditorAlignment;
32
- /**
33
- * Notified when a start-edit attempt is rejected (`startEdit` returned `false` — a non-editable
34
- * cell). The host that mounts one layer per pane (`SheetElement`) passes a SHARED callback
35
- * ({@link useEditRejectedNotice}) so all panes form one notice scope; it receives the rejected cell.
36
- * @defaultValue this layer's own {@link useEditRejectedNotice}
37
- */
38
- onEditRejected?: EditRejectedNotice;
39
31
  }
40
32
  export declare function SheetCellEditorLayer(props: SheetCellEditorLayerProps): React.ReactElement;
41
33
  export declare namespace SheetCellEditorLayer {