@sheetxl/react 0.7.21 → 0.7.23-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (456) hide show
  1. package/browser/cjs/Bo9Kx3L_XQkGPBJ5.cjs +1 -0
  2. package/browser/cjs/Pl04-kDEQSO8_qFU.cjs +156 -0
  3. package/browser/cjs/index.cjs +24 -24
  4. package/browser/esm/E9rKWgbrtweBguqR.mjs +6286 -0
  5. package/browser/esm/index.mjs +19252 -4914
  6. package/licenses/dependencies.txt +42 -214
  7. package/node/esm/CmChqiPvaotX5mCV.mjs +9 -0
  8. package/node/esm/index.mjs +17028 -3694
  9. package/package.json +10 -11
  10. package/resources/contents.json +60 -0
  11. package/resources/locales/contents.json +114 -0
  12. package/resources/locales/de/clipboard.cmd.json +36 -0
  13. package/resources/locales/de/editor.cmd.json +128 -0
  14. package/resources/locales/de/movable.cmd.json +123 -0
  15. package/resources/locales/de/selection.cmd.json +373 -0
  16. package/resources/locales/de/sheet.cmd.json +1563 -0
  17. package/resources/locales/de/table.cmd.json +83 -0
  18. package/resources/locales/de/ui.msg.json +166 -0
  19. package/resources/locales/de/workbook.cmd.json +282 -0
  20. package/resources/locales/en/clipboard.cmd.json +36 -0
  21. package/resources/locales/en/editor.cmd.json +128 -0
  22. package/resources/locales/en/movable.cmd.json +123 -0
  23. package/resources/locales/en/selection.cmd.json +373 -0
  24. package/resources/locales/en/sheet.cmd.json +1563 -0
  25. package/resources/locales/en/table.cmd.json +83 -0
  26. package/resources/locales/en/ui.msg.json +166 -0
  27. package/resources/locales/en/workbook.cmd.json +282 -0
  28. package/types/index.d.ts +2 -1815
  29. package/types/src/border/StaticBorderRenderer.d.ts +32 -0
  30. package/types/src/border/StaticBorderRenderer.d.ts.map +1 -0
  31. package/types/src/border/StyledStrokePath.d.ts +14 -0
  32. package/types/src/border/StyledStrokePath.d.ts.map +1 -0
  33. package/types/src/border/index.d.ts +4 -0
  34. package/types/src/border/index.d.ts.map +1 -0
  35. package/types/src/border/useBorders.d.ts +87 -0
  36. package/types/src/border/useBorders.d.ts.map +1 -0
  37. package/types/src/cell/ColumnButton.d.ts +45 -0
  38. package/types/src/cell/ColumnButton.d.ts.map +1 -0
  39. package/types/src/cell/CornerTriangle.d.ts +27 -0
  40. package/types/src/cell/CornerTriangle.d.ts.map +1 -0
  41. package/types/src/cell/FormulaCellRenderer.d.ts +34 -0
  42. package/types/src/cell/FormulaCellRenderer.d.ts.map +1 -0
  43. package/types/src/cell/SheetCellRenderer.d.ts +52 -0
  44. package/types/src/cell/SheetCellRenderer.d.ts.map +1 -0
  45. package/types/src/cell/SheetHeaderRenderer.d.ts +37 -0
  46. package/types/src/cell/SheetHeaderRenderer.d.ts.map +1 -0
  47. package/types/src/cell/index.d.ts +7 -0
  48. package/types/src/cell/index.d.ts.map +1 -0
  49. package/types/src/cell/useFormulaViewAnchor.d.ts +42 -0
  50. package/types/src/cell/useFormulaViewAnchor.d.ts.map +1 -0
  51. package/types/src/chart/ChartEditor.d.ts +17 -0
  52. package/types/src/chart/ChartEditor.d.ts.map +1 -0
  53. package/types/src/chart/PresetChartTypeDescriptors.d.ts +35 -0
  54. package/types/src/chart/PresetChartTypeDescriptors.d.ts.map +1 -0
  55. package/types/src/chart/index.d.ts +3 -0
  56. package/types/src/chart/index.d.ts.map +1 -0
  57. package/types/src/chart/templates/area-stacked-percent-template.json.d.ts +10 -0
  58. package/types/src/chart/templates/area-stacked-template.json.d.ts +10 -0
  59. package/types/src/chart/templates/area-template.json.d.ts +9 -0
  60. package/types/src/chart/templates/bar-stacked-percent-template.json.d.ts +10 -0
  61. package/types/src/chart/templates/bar-stacked-template.json.d.ts +10 -0
  62. package/types/src/chart/templates/bar-template.json.d.ts +9 -0
  63. package/types/src/chart/templates/column-stacked-percent-template.json.d.ts +10 -0
  64. package/types/src/chart/templates/column-stacked-template.json.d.ts +10 -0
  65. package/types/src/chart/templates/column-template.json.d.ts +9 -0
  66. package/types/src/chart/templates/line-markers-template.json.d.ts +10 -0
  67. package/types/src/chart/templates/line-stacked-markers-template.json.d.ts +11 -0
  68. package/types/src/chart/templates/line-stacked-percent-markers-template.json.d.ts +11 -0
  69. package/types/src/chart/templates/line-stacked-percent-template.json.d.ts +10 -0
  70. package/types/src/chart/templates/line-stacked-template.json.d.ts +10 -0
  71. package/types/src/chart/templates/line-template.json.d.ts +9 -0
  72. package/types/src/chart/templates/pie-doughnut-template.json.d.ts +10 -0
  73. package/types/src/chart/templates/pie-template.json.d.ts +9 -0
  74. package/types/src/chart/templates/scatter-lines-markers-smooth-template.json.d.ts +10 -0
  75. package/types/src/chart/templates/scatter-lines-markers-template.json.d.ts +10 -0
  76. package/types/src/chart/templates/scatter-lines-smooth-template.json.d.ts +10 -0
  77. package/types/src/chart/templates/scatter-lines-template.json.d.ts +10 -0
  78. package/types/src/chart/templates/scatter-markers-template.json.d.ts +10 -0
  79. package/types/src/clipboard/ClipboardCommands.d.ts +68 -0
  80. package/types/src/clipboard/ClipboardCommands.d.ts.map +1 -0
  81. package/types/src/clipboard/SheetClipboardLayer.d.ts +22 -0
  82. package/types/src/clipboard/SheetClipboardLayer.d.ts.map +1 -0
  83. package/types/src/clipboard/index.d.ts +3 -0
  84. package/types/src/clipboard/index.d.ts.map +1 -0
  85. package/types/src/commands/Catalog.d.ts +8 -0
  86. package/types/src/commands/Catalog.d.ts.map +1 -0
  87. package/types/src/commands/CommandRootProvider.d.ts +36 -0
  88. package/types/src/commands/CommandRootProvider.d.ts.map +1 -0
  89. package/types/src/commands/InputClipboardCommands.d.ts +41 -0
  90. package/types/src/commands/InputClipboardCommands.d.ts.map +1 -0
  91. package/types/src/commands/InputClipboardInjector.d.ts +16 -0
  92. package/types/src/commands/InputClipboardInjector.d.ts.map +1 -0
  93. package/types/src/commands/MainFocusContext.d.ts +13 -0
  94. package/types/src/commands/MainFocusContext.d.ts.map +1 -0
  95. package/types/src/commands/PaneScopeProvider.d.ts +40 -0
  96. package/types/src/commands/PaneScopeProvider.d.ts.map +1 -0
  97. package/types/src/commands/createTransactionalMiddleware.d.ts +49 -0
  98. package/types/src/commands/createTransactionalMiddleware.d.ts.map +1 -0
  99. package/types/src/commands/index.d.ts +7 -0
  100. package/types/src/commands/index.d.ts.map +1 -0
  101. package/types/src/context/SheetContext.d.ts +18 -0
  102. package/types/src/context/SheetContext.d.ts.map +1 -0
  103. package/types/src/context/WorkbookContext.d.ts +20 -0
  104. package/types/src/context/WorkbookContext.d.ts.map +1 -0
  105. package/types/src/context/index.d.ts +3 -0
  106. package/types/src/context/index.d.ts.map +1 -0
  107. package/types/src/editableLabel/EditableLabel.d.ts +28 -0
  108. package/types/src/editableLabel/EditableLabel.d.ts.map +1 -0
  109. package/types/src/editableLabel/index.d.ts +2 -0
  110. package/types/src/editableLabel/index.d.ts.map +1 -0
  111. package/types/src/editor/EditorCommands.d.ts +98 -0
  112. package/types/src/editor/EditorCommands.d.ts.map +1 -0
  113. package/types/src/editor/FunctionPreviewPanel.d.ts +166 -0
  114. package/types/src/editor/FunctionPreviewPanel.d.ts.map +1 -0
  115. package/types/src/editor/NamedHintPanel.d.ts +38 -0
  116. package/types/src/editor/NamedHintPanel.d.ts.map +1 -0
  117. package/types/src/editor/NamedItemsPanel.d.ts +59 -0
  118. package/types/src/editor/NamedItemsPanel.d.ts.map +1 -0
  119. package/types/src/editor/SheetCellEditorLayer.d.ts +40 -0
  120. package/types/src/editor/SheetCellEditorLayer.d.ts.map +1 -0
  121. package/types/src/editor/SheetCellInput.d.ts +99 -0
  122. package/types/src/editor/SheetCellInput.d.ts.map +1 -0
  123. package/types/src/editor/SheetEditable.d.ts +53 -0
  124. package/types/src/editor/SheetEditable.d.ts.map +1 -0
  125. package/types/src/editor/SheetReferenceHeaderLayer.d.ts +46 -0
  126. package/types/src/editor/SheetReferenceHeaderLayer.d.ts.map +1 -0
  127. package/types/src/editor/SheetReferenceLayer.d.ts +55 -0
  128. package/types/src/editor/SheetReferenceLayer.d.ts.map +1 -0
  129. package/types/src/editor/formulaCaret.d.ts +84 -0
  130. package/types/src/editor/formulaCaret.d.ts.map +1 -0
  131. package/types/src/editor/formulaEval.d.ts +202 -0
  132. package/types/src/editor/formulaEval.d.ts.map +1 -0
  133. package/types/src/editor/formulaPresentation.d.ts +136 -0
  134. package/types/src/editor/formulaPresentation.d.ts.map +1 -0
  135. package/types/src/editor/formulaText.d.ts +80 -0
  136. package/types/src/editor/formulaText.d.ts.map +1 -0
  137. package/types/src/editor/functionArgs.d.ts +111 -0
  138. package/types/src/editor/functionArgs.d.ts.map +1 -0
  139. package/types/src/editor/functionHint.d.ts +37 -0
  140. package/types/src/editor/functionHint.d.ts.map +1 -0
  141. package/types/src/editor/index.d.ts +18 -0
  142. package/types/src/editor/index.d.ts.map +1 -0
  143. package/types/src/editor/referencePointNav.d.ts +39 -0
  144. package/types/src/editor/referencePointNav.d.ts.map +1 -0
  145. package/types/src/editor/useFormulaHints.d.ts +126 -0
  146. package/types/src/editor/useFormulaHints.d.ts.map +1 -0
  147. package/types/src/editor/useFormulaInput.d.ts +326 -0
  148. package/types/src/editor/useFormulaInput.d.ts.map +1 -0
  149. package/types/src/editor/useProtectedEditNotice.d.ts +14 -0
  150. package/types/src/editor/useProtectedEditNotice.d.ts.map +1 -0
  151. package/types/src/editor/useReferenceMode.d.ts +177 -0
  152. package/types/src/editor/useReferenceMode.d.ts.map +1 -0
  153. package/types/src/form/FormulaInput.d.ts +86 -0
  154. package/types/src/form/FormulaInput.d.ts.map +1 -0
  155. package/types/src/form/FormulaInputParts.d.ts +94 -0
  156. package/types/src/form/FormulaInputParts.d.ts.map +1 -0
  157. package/types/src/form/index.d.ts +5 -0
  158. package/types/src/form/index.d.ts.map +1 -0
  159. package/types/src/form/useEditCommit.d.ts +174 -0
  160. package/types/src/form/useEditCommit.d.ts.map +1 -0
  161. package/types/src/form/useInputField.d.ts +86 -0
  162. package/types/src/form/useInputField.d.ts.map +1 -0
  163. package/types/src/frame/CommandContext.d.ts +179 -0
  164. package/types/src/frame/CommandContext.d.ts.map +1 -0
  165. package/types/src/frame/IFrame.d.ts +17 -0
  166. package/types/src/frame/IFrame.d.ts.map +1 -0
  167. package/types/src/frame/index.d.ts +3 -0
  168. package/types/src/frame/index.d.ts.map +1 -0
  169. package/types/src/icons/LogoNoPaddingIcon.d.ts +3 -0
  170. package/types/src/icons/LogoNoPaddingIcon.d.ts.map +1 -0
  171. package/types/src/icons/LogoTextNoPaddingIcon.d.ts +4 -0
  172. package/types/src/icons/LogoTextNoPaddingIcon.d.ts.map +1 -0
  173. package/types/src/icons/WaterMark.d.ts +12 -0
  174. package/types/src/icons/WaterMark.d.ts.map +1 -0
  175. package/types/src/icons/chart/ChartAreaIcon.d.ts +5 -0
  176. package/types/src/icons/chart/ChartAreaIcon.d.ts.map +1 -0
  177. package/types/src/icons/chart/ChartAreaStackedIcon.d.ts +5 -0
  178. package/types/src/icons/chart/ChartAreaStackedIcon.d.ts.map +1 -0
  179. package/types/src/icons/chart/ChartAreaStackedPercentIcon.d.ts +5 -0
  180. package/types/src/icons/chart/ChartAreaStackedPercentIcon.d.ts.map +1 -0
  181. package/types/src/icons/chart/ChartBarIcon.d.ts +5 -0
  182. package/types/src/icons/chart/ChartBarIcon.d.ts.map +1 -0
  183. package/types/src/icons/chart/ChartBarStackedIcon.d.ts +5 -0
  184. package/types/src/icons/chart/ChartBarStackedIcon.d.ts.map +1 -0
  185. package/types/src/icons/chart/ChartBarStackedPercentIcon.d.ts +5 -0
  186. package/types/src/icons/chart/ChartBarStackedPercentIcon.d.ts.map +1 -0
  187. package/types/src/icons/chart/ChartBubble3DIcon.d.ts +5 -0
  188. package/types/src/icons/chart/ChartBubble3DIcon.d.ts.map +1 -0
  189. package/types/src/icons/chart/ChartBubbleIcon.d.ts +5 -0
  190. package/types/src/icons/chart/ChartBubbleIcon.d.ts.map +1 -0
  191. package/types/src/icons/chart/ChartColumnIcon.d.ts +5 -0
  192. package/types/src/icons/chart/ChartColumnIcon.d.ts.map +1 -0
  193. package/types/src/icons/chart/ChartColumnStackedIcon.d.ts +5 -0
  194. package/types/src/icons/chart/ChartColumnStackedIcon.d.ts.map +1 -0
  195. package/types/src/icons/chart/ChartColumnStackedPercentIcon.d.ts +5 -0
  196. package/types/src/icons/chart/ChartColumnStackedPercentIcon.d.ts.map +1 -0
  197. package/types/src/icons/chart/ChartLineIcon.d.ts +5 -0
  198. package/types/src/icons/chart/ChartLineIcon.d.ts.map +1 -0
  199. package/types/src/icons/chart/ChartLineMarkersIcon.d.ts +5 -0
  200. package/types/src/icons/chart/ChartLineMarkersIcon.d.ts.map +1 -0
  201. package/types/src/icons/chart/ChartLineStackedIcon.d.ts +5 -0
  202. package/types/src/icons/chart/ChartLineStackedIcon.d.ts.map +1 -0
  203. package/types/src/icons/chart/ChartLineStackedMarkersIcon.d.ts +5 -0
  204. package/types/src/icons/chart/ChartLineStackedMarkersIcon.d.ts.map +1 -0
  205. package/types/src/icons/chart/ChartLineStackedPercentIcon.d.ts +5 -0
  206. package/types/src/icons/chart/ChartLineStackedPercentIcon.d.ts.map +1 -0
  207. package/types/src/icons/chart/ChartLineStackedPercentMarkersIcon.d.ts +5 -0
  208. package/types/src/icons/chart/ChartLineStackedPercentMarkersIcon.d.ts.map +1 -0
  209. package/types/src/icons/chart/ChartPieDoughnutIcon.d.ts +5 -0
  210. package/types/src/icons/chart/ChartPieDoughnutIcon.d.ts.map +1 -0
  211. package/types/src/icons/chart/ChartPieIcon.d.ts +5 -0
  212. package/types/src/icons/chart/ChartPieIcon.d.ts.map +1 -0
  213. package/types/src/icons/chart/ChartScatterLinesIcon.d.ts +5 -0
  214. package/types/src/icons/chart/ChartScatterLinesIcon.d.ts.map +1 -0
  215. package/types/src/icons/chart/ChartScatterLinesMarkersIcon.d.ts +5 -0
  216. package/types/src/icons/chart/ChartScatterLinesMarkersIcon.d.ts.map +1 -0
  217. package/types/src/icons/chart/ChartScatterLinesMarkersSmoothIcon.d.ts +5 -0
  218. package/types/src/icons/chart/ChartScatterLinesMarkersSmoothIcon.d.ts.map +1 -0
  219. package/types/src/icons/chart/ChartScatterLinesSmoothIcon.d.ts +5 -0
  220. package/types/src/icons/chart/ChartScatterLinesSmoothIcon.d.ts.map +1 -0
  221. package/types/src/icons/chart/ChartScatterMarkersIcon.d.ts +5 -0
  222. package/types/src/icons/chart/ChartScatterMarkersIcon.d.ts.map +1 -0
  223. package/types/src/icons/chart/ChartWaterfallIcon.d.ts +5 -0
  224. package/types/src/icons/chart/ChartWaterfallIcon.d.ts.map +1 -0
  225. package/types/src/icons/chart/ThemedChartIcon.d.ts +20 -0
  226. package/types/src/icons/chart/ThemedChartIcon.d.ts.map +1 -0
  227. package/types/src/icons/chart/index.d.ts +50 -0
  228. package/types/src/icons/chart/index.d.ts.map +1 -0
  229. package/types/src/icons/index.d.ts +4 -0
  230. package/types/src/icons/index.d.ts.map +1 -0
  231. package/types/src/index.d.ts +27 -0
  232. package/types/src/index.d.ts.map +1 -0
  233. package/types/src/io/WorkbookIO.d.ts +50 -0
  234. package/types/src/io/WorkbookIO.d.ts.map +1 -0
  235. package/types/src/io/index.d.ts +2 -0
  236. package/types/src/io/index.d.ts.map +1 -0
  237. package/types/src/layer/BorderLayer.d.ts +14 -0
  238. package/types/src/layer/BorderLayer.d.ts.map +1 -0
  239. package/types/src/layer/CellErrorLayer.d.ts +49 -0
  240. package/types/src/layer/CellErrorLayer.d.ts.map +1 -0
  241. package/types/src/layer/CellFillLayer.d.ts +15 -0
  242. package/types/src/layer/CellFillLayer.d.ts.map +1 -0
  243. package/types/src/layer/ConditionalBarLayer.d.ts +41 -0
  244. package/types/src/layer/ConditionalBarLayer.d.ts.map +1 -0
  245. package/types/src/layer/ConditionalIcons.d.ts +34 -0
  246. package/types/src/layer/ConditionalIcons.d.ts.map +1 -0
  247. package/types/src/layer/ConditionalIconsLayer.d.ts +31 -0
  248. package/types/src/layer/ConditionalIconsLayer.d.ts.map +1 -0
  249. package/types/src/layer/ContextMenuLayer.d.ts +27 -0
  250. package/types/src/layer/ContextMenuLayer.d.ts.map +1 -0
  251. package/types/src/layer/HeaderResizerLayer.d.ts +28 -0
  252. package/types/src/layer/HeaderResizerLayer.d.ts.map +1 -0
  253. package/types/src/layer/HeaderSelectionLayer.d.ts +89 -0
  254. package/types/src/layer/HeaderSelectionLayer.d.ts.map +1 -0
  255. package/types/src/layer/ResizeIndicator.d.ts +19 -0
  256. package/types/src/layer/ResizeIndicator.d.ts.map +1 -0
  257. package/types/src/layer/SheetBackgroundLayer.d.ts +22 -0
  258. package/types/src/layer/SheetBackgroundLayer.d.ts.map +1 -0
  259. package/types/src/layer/SheetCellLayer.d.ts +49 -0
  260. package/types/src/layer/SheetCellLayer.d.ts.map +1 -0
  261. package/types/src/layer/SheetColumnButtonLayer.d.ts +23 -0
  262. package/types/src/layer/SheetColumnButtonLayer.d.ts.map +1 -0
  263. package/types/src/layer/SheetGridLineLayer.d.ts +22 -0
  264. package/types/src/layer/SheetGridLineLayer.d.ts.map +1 -0
  265. package/types/src/layer/SheetHeaderCellLayer.d.ts +30 -0
  266. package/types/src/layer/SheetHeaderCellLayer.d.ts.map +1 -0
  267. package/types/src/layer/SheetMovableLayer.d.ts +26 -0
  268. package/types/src/layer/SheetMovableLayer.d.ts.map +1 -0
  269. package/types/src/layer/SheetTableCommandLayer.d.ts +16 -0
  270. package/types/src/layer/SheetTableCommandLayer.d.ts.map +1 -0
  271. package/types/src/layer/SpillLayer.d.ts +22 -0
  272. package/types/src/layer/SpillLayer.d.ts.map +1 -0
  273. package/types/src/layer/TableLayer.d.ts +22 -0
  274. package/types/src/layer/TableLayer.d.ts.map +1 -0
  275. package/types/src/layer/ValidationIndicatorLayer.d.ts +41 -0
  276. package/types/src/layer/ValidationIndicatorLayer.d.ts.map +1 -0
  277. package/types/src/layer/index.d.ts +25 -0
  278. package/types/src/layer/index.d.ts.map +1 -0
  279. package/types/src/layer/resizeIndicatorState.d.ts +26 -0
  280. package/types/src/layer/resizeIndicatorState.d.ts.map +1 -0
  281. package/types/src/layer/useSheetFeatureRegions.d.ts +21 -0
  282. package/types/src/layer/useSheetFeatureRegions.d.ts.map +1 -0
  283. package/types/src/layer/useSheetVisibleCells.d.ts +60 -0
  284. package/types/src/layer/useSheetVisibleCells.d.ts.map +1 -0
  285. package/types/src/layer/useSheetVisibleDecorations.d.ts +42 -0
  286. package/types/src/layer/useSheetVisibleDecorations.d.ts.map +1 -0
  287. package/types/src/layer/useTableHeaderCells.d.ts +22 -0
  288. package/types/src/layer/useTableHeaderCells.d.ts.map +1 -0
  289. package/types/src/layer/useVisibleTables.d.ts +27 -0
  290. package/types/src/layer/useVisibleTables.d.ts.map +1 -0
  291. package/types/src/listener/index.d.ts +3 -0
  292. package/types/src/listener/index.d.ts.map +1 -0
  293. package/types/src/listener/useModelListener.d.ts +67 -0
  294. package/types/src/listener/useModelListener.d.ts.map +1 -0
  295. package/types/src/listener/useRangeListener.d.ts +15 -0
  296. package/types/src/listener/useRangeListener.d.ts.map +1 -0
  297. package/types/src/movable/EmptyFrame.d.ts +16 -0
  298. package/types/src/movable/EmptyFrame.d.ts.map +1 -0
  299. package/types/src/movable/IMovableArea.d.ts +34 -0
  300. package/types/src/movable/IMovableArea.d.ts.map +1 -0
  301. package/types/src/movable/MovableCommands.d.ts +22 -0
  302. package/types/src/movable/MovableCommands.d.ts.map +1 -0
  303. package/types/src/movable/MovableFrame.d.ts +48 -0
  304. package/types/src/movable/MovableFrame.d.ts.map +1 -0
  305. package/types/src/movable/MovableLayer.d.ts +77 -0
  306. package/types/src/movable/MovableLayer.d.ts.map +1 -0
  307. package/types/src/movable/MoveableBundle.d.ts +4 -0
  308. package/types/src/movable/MoveableBundle.d.ts.map +1 -0
  309. package/types/src/movable/index.d.ts +4 -0
  310. package/types/src/movable/index.d.ts.map +1 -0
  311. package/types/src/picture/IPictureEditor.d.ts +39 -0
  312. package/types/src/picture/IPictureEditor.d.ts.map +1 -0
  313. package/types/src/picture/PictureEditor.d.ts +4 -0
  314. package/types/src/picture/PictureEditor.d.ts.map +1 -0
  315. package/types/src/picture/index.d.ts +3 -0
  316. package/types/src/picture/index.d.ts.map +1 -0
  317. package/types/src/selection/SelectionCommands.d.ts +23 -0
  318. package/types/src/selection/SelectionCommands.d.ts.map +1 -0
  319. package/types/src/selection/SheetSelection.d.ts +53 -0
  320. package/types/src/selection/SheetSelection.d.ts.map +1 -0
  321. package/types/src/selection/SheetSelectionLayer.d.ts +30 -0
  322. package/types/src/selection/SheetSelectionLayer.d.ts.map +1 -0
  323. package/types/src/selection/index.d.ts +4 -0
  324. package/types/src/selection/index.d.ts.map +1 -0
  325. package/types/src/shape/ShapeEditor.d.ts +16 -0
  326. package/types/src/shape/ShapeEditor.d.ts.map +1 -0
  327. package/types/src/shape/index.d.ts +2 -0
  328. package/types/src/shape/index.d.ts.map +1 -0
  329. package/types/src/sheet/ConditionalFormatPresets.d.ts +56 -0
  330. package/types/src/sheet/ConditionalFormatPresets.d.ts.map +1 -0
  331. package/types/src/sheet/ISheetElement.d.ts +233 -0
  332. package/types/src/sheet/ISheetElement.d.ts.map +1 -0
  333. package/types/src/sheet/ISheetHeaderElement.d.ts +138 -0
  334. package/types/src/sheet/ISheetHeaderElement.d.ts.map +1 -0
  335. package/types/src/sheet/NotImplemented.d.ts +3 -0
  336. package/types/src/sheet/NotImplemented.d.ts.map +1 -0
  337. package/types/src/sheet/SheetCommandProvider.d.ts +57 -0
  338. package/types/src/sheet/SheetCommandProvider.d.ts.map +1 -0
  339. package/types/src/sheet/SheetCommands.d.ts +75 -0
  340. package/types/src/sheet/SheetCommands.d.ts.map +1 -0
  341. package/types/src/sheet/SheetElement.d.ts +15 -0
  342. package/types/src/sheet/SheetElement.d.ts.map +1 -0
  343. package/types/src/sheet/SheetHeaderElement.d.ts +4 -0
  344. package/types/src/sheet/SheetHeaderElement.d.ts.map +1 -0
  345. package/types/src/sheet/SheetScrollbar.d.ts +28 -0
  346. package/types/src/sheet/SheetScrollbar.d.ts.map +1 -0
  347. package/types/src/sheet/TopLeftCorner.d.ts +17 -0
  348. package/types/src/sheet/TopLeftCorner.d.ts.map +1 -0
  349. package/types/src/sheet/index.d.ts +7 -0
  350. package/types/src/sheet/index.d.ts.map +1 -0
  351. package/types/src/slicer/SlicerEditor.d.ts +16 -0
  352. package/types/src/slicer/SlicerEditor.d.ts.map +1 -0
  353. package/types/src/slicer/index.d.ts +2 -0
  354. package/types/src/slicer/index.d.ts.map +1 -0
  355. package/types/src/tabStrip/SheetTab.d.ts +41 -0
  356. package/types/src/tabStrip/SheetTab.d.ts.map +1 -0
  357. package/types/src/tabStrip/Sortable.d.ts +66 -0
  358. package/types/src/tabStrip/Sortable.d.ts.map +1 -0
  359. package/types/src/tabStrip/Tab.d.ts +19 -0
  360. package/types/src/tabStrip/Tab.d.ts.map +1 -0
  361. package/types/src/tabStrip/TabStrip.d.ts +41 -0
  362. package/types/src/tabStrip/TabStrip.d.ts.map +1 -0
  363. package/types/src/tabStrip/TabStripItem.d.ts +36 -0
  364. package/types/src/tabStrip/TabStripItem.d.ts.map +1 -0
  365. package/types/src/tabStrip/TabStripRow.d.ts +9 -0
  366. package/types/src/tabStrip/TabStripRow.d.ts.map +1 -0
  367. package/types/src/tabStrip/index.d.ts +7 -0
  368. package/types/src/tabStrip/index.d.ts.map +1 -0
  369. package/types/src/table/TableCommands.d.ts +16 -0
  370. package/types/src/table/TableCommands.d.ts.map +1 -0
  371. package/types/src/taskPane/ITaskPane.d.ts +72 -0
  372. package/types/src/taskPane/ITaskPane.d.ts.map +1 -0
  373. package/types/src/taskPane/TaskPaneArea.d.ts +144 -0
  374. package/types/src/taskPane/TaskPaneArea.d.ts.map +1 -0
  375. package/types/src/taskPane/TaskPaneFrame.d.ts +48 -0
  376. package/types/src/taskPane/TaskPaneFrame.d.ts.map +1 -0
  377. package/types/src/taskPane/TaskPaneRegistry.d.ts +108 -0
  378. package/types/src/taskPane/TaskPaneRegistry.d.ts.map +1 -0
  379. package/types/src/taskPane/TaskPaneStrip.d.ts +33 -0
  380. package/types/src/taskPane/TaskPaneStrip.d.ts.map +1 -0
  381. package/types/src/taskPane/TaskPaneTitle.d.ts +24 -0
  382. package/types/src/taskPane/TaskPaneTitle.d.ts.map +1 -0
  383. package/types/src/taskPane/index.d.ts +7 -0
  384. package/types/src/taskPane/index.d.ts.map +1 -0
  385. package/types/src/taskPane/useTaskPane.d.ts +29 -0
  386. package/types/src/taskPane/useTaskPane.d.ts.map +1 -0
  387. package/types/src/theme/DocThemesContext.d.ts +3 -0
  388. package/types/src/theme/DocThemesContext.d.ts.map +1 -0
  389. package/types/src/theme/DocThemesProvider.d.ts +15 -0
  390. package/types/src/theme/DocThemesProvider.d.ts.map +1 -0
  391. package/types/src/theme/ThemeState.d.ts +19 -0
  392. package/types/src/theme/ThemeState.d.ts.map +1 -0
  393. package/types/src/theme/buildDocThemeCSS.d.ts +16 -0
  394. package/types/src/theme/buildDocThemeCSS.d.ts.map +1 -0
  395. package/types/src/theme/buildOOXMLThemeCSS.d.ts +13 -0
  396. package/types/src/theme/buildOOXMLThemeCSS.d.ts.map +1 -0
  397. package/types/src/theme/createCSSSystemLookup.d.ts +51 -0
  398. package/types/src/theme/createCSSSystemLookup.d.ts.map +1 -0
  399. package/types/src/theme/index.d.ts +11 -0
  400. package/types/src/theme/index.d.ts.map +1 -0
  401. package/types/src/theme/useAppColorScheme.d.ts +15 -0
  402. package/types/src/theme/useAppColorScheme.d.ts.map +1 -0
  403. package/types/src/theme/useDocThemes.d.ts +3 -0
  404. package/types/src/theme/useDocThemes.d.ts.map +1 -0
  405. package/types/src/theme/useGridColorScheme.d.ts +20 -0
  406. package/types/src/theme/useGridColorScheme.d.ts.map +1 -0
  407. package/types/src/theme/useSystemColors.d.ts +44 -0
  408. package/types/src/theme/useSystemColors.d.ts.map +1 -0
  409. package/types/src/undo/UndoCommands.d.ts +28 -0
  410. package/types/src/undo/UndoCommands.d.ts.map +1 -0
  411. package/types/src/undo/UndoManagerContext.d.ts +14 -0
  412. package/types/src/undo/UndoManagerContext.d.ts.map +1 -0
  413. package/types/src/undo/index.d.ts +3 -0
  414. package/types/src/undo/index.d.ts.map +1 -0
  415. package/types/src/workbook/DefaultRenderers.d.ts +14 -0
  416. package/types/src/workbook/DefaultRenderers.d.ts.map +1 -0
  417. package/types/src/workbook/GlobalWorkbookElement.d.ts +10 -0
  418. package/types/src/workbook/GlobalWorkbookElement.d.ts.map +1 -0
  419. package/types/src/workbook/IWorkbookElement.d.ts +178 -0
  420. package/types/src/workbook/IWorkbookElement.d.ts.map +1 -0
  421. package/types/src/workbook/WindowChrome.d.ts +61 -0
  422. package/types/src/workbook/WindowChrome.d.ts.map +1 -0
  423. package/types/src/workbook/WorkbookCommandContributor.d.ts +24 -0
  424. package/types/src/workbook/WorkbookCommandContributor.d.ts.map +1 -0
  425. package/types/src/workbook/WorkbookCommands.d.ts +97 -0
  426. package/types/src/workbook/WorkbookCommands.d.ts.map +1 -0
  427. package/types/src/workbook/WorkbookElement.d.ts +9 -0
  428. package/types/src/workbook/WorkbookElement.d.ts.map +1 -0
  429. package/types/src/workbook/WorkbookStrip.d.ts +73 -0
  430. package/types/src/workbook/WorkbookStrip.d.ts.map +1 -0
  431. package/types/src/workbook/index.d.ts +17 -0
  432. package/types/src/workbook/index.d.ts.map +1 -0
  433. package/types/src/workbook/resolveWorkbookInput.d.ts +27 -0
  434. package/types/src/workbook/resolveWorkbookInput.d.ts.map +1 -0
  435. package/types/src/workbook/useResolvedWorkbook.d.ts +31 -0
  436. package/types/src/workbook/useResolvedWorkbook.d.ts.map +1 -0
  437. package/types/src/workbook/useWindowChrome.d.ts +24 -0
  438. package/types/src/workbook/useWindowChrome.d.ts.map +1 -0
  439. package/types/src/workbook/useWorkbookApp.d.ts +47 -0
  440. package/types/src/workbook/useWorkbookApp.d.ts.map +1 -0
  441. package/types/src/workbook/useWorkbookEncrypted.d.ts +15 -0
  442. package/types/src/workbook/useWorkbookEncrypted.d.ts.map +1 -0
  443. package/types/src/workbook/useWorkbookFormat.d.ts +18 -0
  444. package/types/src/workbook/useWorkbookFormat.d.ts.map +1 -0
  445. package/types/src/workbook/useWorkbookName.d.ts +13 -0
  446. package/types/src/workbook/useWorkbookName.d.ts.map +1 -0
  447. package/types/src/workbook/useWorkbookSaveState.d.ts +29 -0
  448. package/types/src/workbook/useWorkbookSaveState.d.ts.map +1 -0
  449. package/browser/cjs/Be13sRyTTTUvNIit.cjs +0 -161
  450. package/browser/cjs/KLgpeikeRSDp4tUK.cjs +0 -16
  451. package/browser/cjs/n4OQZCE7fVxRfX1r.cjs +0 -7
  452. package/browser/esm/ClLcB3xHul5RfTMr.mjs +0 -1377
  453. package/browser/esm/EUZRpu3SnHayUDBu.mjs +0 -3905
  454. package/browser/esm/Mz1Nj2KbO5FcE969.mjs +0 -394
  455. package/node/assets/style.css +0 -1
  456. package/node/esm/sKvpUJVdmYl8r9f6.mjs +0 -11
@@ -0,0 +1 @@
1
+ {"version":3,"file":"WorkbookStrip.d.ts","sourceRoot":"","sources":["../../../../src/workbook/WorkbookStrip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,OAAO,EAAE,KAAK,SAAS,EAAyC,MAAM,cAAc,CAAC;AAErF,OAAO,EAA8C,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAI1G,OAAO,EAAqC,KAAK,aAAa,EAAoB,MAAM,aAAa,CAAC;AAItG;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC9E;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,kBAAkB,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACnD;;OAEG;IACH,YAAY,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,KAAK,CAAC,YAAY,CAAC;IAC9D;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEjF;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,iBAAiB,KAAK,KAAK,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IACpF,qBAAqB,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,iBAAiB,KAAK,KAAK,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAClF,sBAAsB,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,iBAAiB,KAAK,KAAK,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;CACpF;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAeD,eAAO,MAAM,aAAa,wFAgOvB,CAAC"}
@@ -0,0 +1,17 @@
1
+ export type * from './IWorkbookElement';
2
+ export * from './WorkbookElement';
3
+ export * from './WorkbookStrip';
4
+ export * from './DefaultRenderers';
5
+ export * from './GlobalWorkbookElement';
6
+ export * from './WorkbookCommands';
7
+ export * from './WorkbookCommandContributor';
8
+ export * from './useWorkbookSaveState';
9
+ export * from './useWorkbookName';
10
+ export * from './useWorkbookEncrypted';
11
+ export * from './useWorkbookFormat';
12
+ export * from './resolveWorkbookInput';
13
+ export * from './useResolvedWorkbook';
14
+ export * from './WindowChrome';
15
+ export * from './useWindowChrome';
16
+ export * from './useWorkbookApp';
17
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/workbook/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,oBAAoB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}
@@ -0,0 +1,27 @@
1
+ import { IWorkbook, IWorkbookIO } from '@sheetxl/sdk';
2
+ /**
3
+ * The accepted workbook input: a live model, a promise for one, or read options to create one.
4
+ * A read-produced workbook carries its {@link IWorkbookIO.Origin} itself (see
5
+ * {@link IWorkbook.getOrigin}) — there is no separate pairing to thread.
6
+ */
7
+ export type WorkbookInput = IWorkbook | Promise<IWorkbook> | IWorkbookIO.ReadOptions;
8
+ export interface ResolveWorkbookOptions {
9
+ /** IO used to read {@link IWorkbookIO.ReadOptions}. Defaults to the shared {@link WorkbookIO}. */
10
+ io?: IWorkbookIO;
11
+ /** Theme applied to a freshly-created default workbook (empty/absent input). */
12
+ defaultTheme?: IWorkbook.ConstructorOptions['theme'];
13
+ }
14
+ /**
15
+ * Normalize a {@link WorkbookInput} (or absent/empty input) into an {@link IWorkbook}.
16
+ *
17
+ * - a {@link Workbook} instance is used directly
18
+ * - `null` / an empty options object → a fresh default workbook (unbound origin)
19
+ * - a promise is awaited (and may itself resolve to read options)
20
+ * - {@link IWorkbookIO.ReadOptions} (a `source`) is read via the `io`; the workbook carries the
21
+ * origin minted by the read
22
+ *
23
+ * Throws if a source cannot be read (so a caller can surface an error state rather than a `null`
24
+ * workbook — note {@link IWorkbookIO.read} resolves `null` on failure).
25
+ */
26
+ export declare const resolveWorkbookInput: (input: WorkbookInput | null | undefined, options?: ResolveWorkbookOptions) => Promise<IWorkbook>;
27
+ //# sourceMappingURL=resolveWorkbookInput.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolveWorkbookInput.d.ts","sourceRoot":"","sources":["../../../../src/workbook/resolveWorkbookInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAM1E;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,OAAO,CAAC,SAAS,CAAC,GAClB,WAAW,CAAC,WAAW,CAAC;AAE5B,MAAM,WAAW,sBAAsB;IACrC,kGAAkG;IAClG,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB,gFAAgF;IAChF,YAAY,CAAC,EAAE,SAAS,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;CACtD;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,aAAa,GAAG,IAAI,GAAG,SAAS,EACvC,UAAS,sBAA2B,KACnC,OAAO,CAAC,SAAS,CAiBnB,CAAC"}
@@ -0,0 +1,31 @@
1
+ import { IWorkbook } from '@sheetxl/sdk';
2
+ import { WorkbookInput, ResolveWorkbookOptions } from './resolveWorkbookInput';
3
+ /** The workbook-resolution lifecycle state returned by {@link useResolvedWorkbook}. */
4
+ export type ResolvedWorkbookState = {
5
+ status: 'loading';
6
+ } | {
7
+ status: 'loaded';
8
+ workbook: IWorkbook;
9
+ } | {
10
+ status: 'error';
11
+ error: unknown;
12
+ };
13
+ export interface UseResolvedWorkbookOptions extends ResolveWorkbookOptions {
14
+ /**
15
+ * Change this to force a re-resolve of the same `input` (e.g. a retry / reload). The `input`
16
+ * identity is the primary trigger; `reloadKey` is an explicit additional one.
17
+ */
18
+ reloadKey?: unknown;
19
+ }
20
+ /**
21
+ * Resolve a {@link WorkbookInput} (instance / promise / read options / empty) into React state, with
22
+ * a cancellation guard so a superseded input can't overwrite a newer one (stale-load race). On a
23
+ * reload it keeps the previously loaded workbook visible until the new one resolves.
24
+ *
25
+ * @remarks
26
+ * `io` / `defaultTheme` are resolve-time config (read live), NOT reactive triggers — only `input`
27
+ * (and an explicit {@link UseResolvedWorkbookOptions.reloadKey}) re-resolve, so a changing theme/io
28
+ * identity never forces a re-read of the same source.
29
+ */
30
+ export declare const useResolvedWorkbook: (input: WorkbookInput | null | undefined, options?: UseResolvedWorkbookOptions) => ResolvedWorkbookState;
31
+ //# sourceMappingURL=useResolvedWorkbook.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useResolvedWorkbook.d.ts","sourceRoot":"","sources":["../../../../src/workbook/useResolvedWorkbook.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EACiB,KAAK,aAAa,EAAE,KAAK,sBAAsB,EACtE,MAAM,wBAAwB,CAAC;AAEhC,uFAAuF;AACvF,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAExC,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACxE;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,aAAa,GAAG,IAAI,GAAG,SAAS,EACvC,UAAS,0BAA+B,KACvC,qBAgCF,CAAC"}
@@ -0,0 +1,24 @@
1
+ import { WindowChromeOptions } from './WindowChrome';
2
+ /**
3
+ * Opt-in single-per-window app chrome for a workbook: document/tab title (with an unsaved marker),
4
+ * an unsaved-changes close prompt, and a browser keyboard guard. A thin React wrapper over
5
+ * {@link WindowChrome}.
6
+ *
7
+ * @param name The workbook display name to reflect, or `null` (see `useWorkbookName`).
8
+ * @param isDirty Whether there are unsaved changes (see `useWorkbookSaveState`).
9
+ * @param options Behavior options (title / close prompt / keyboard guard).
10
+ *
11
+ * @remarks
12
+ * For apps that own the whole window — NOT for embedding `Studio` as a widget (which must not touch
13
+ * the window title / `beforeunload` of its host). Each concern (title / close / keyboard) defaults
14
+ * on and can be disabled individually via {@link WindowChromeOptions}.
15
+ *
16
+ * @example
17
+ * ```tsx
18
+ * const name = useWorkbookName(workbook);
19
+ * const { isDirty } = useWorkbookSaveState(workbook, WorkbookIO);
20
+ * useWindowChrome(name, isDirty);
21
+ * ```
22
+ */
23
+ export declare const useWindowChrome: (name: string | null, isDirty: boolean, options?: WindowChromeOptions) => void;
24
+ //# sourceMappingURL=useWindowChrome.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useWindowChrome.d.ts","sourceRoot":"","sources":["../../../../src/workbook/useWindowChrome.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,MAAM,GAAG,IAAI,EACnB,SAAS,OAAO,EAChB,UAAS,mBAAwB,KAChC,IAiBF,CAAC"}
@@ -0,0 +1,47 @@
1
+ import { IWorkbook, IWorkbookIO } from '@sheetxl/sdk';
2
+ import { WindowChromeOptions } from './WindowChrome';
3
+ export interface WorkbookAppOptions extends WindowChromeOptions {
4
+ /**
5
+ * What to open. A live {@link IWorkbook} / `Promise` for one is used directly; a
6
+ * {@link IWorkbookIO.ReadOptions} (or a `source` string) is read via {@link WorkbookAppOptions.io}.
7
+ * If omitted, the `?source` (and `?title`) URL query is used (see {@link WorkbookAppOptions.fromUrl});
8
+ * with no source at all, a blank workbook is created.
9
+ */
10
+ source?: IWorkbook | Promise<IWorkbook> | IWorkbookIO.ReadOptions | string;
11
+ /**
12
+ * IO used to read a source AND as the save commit-source for the dirty marker. Defaults to the
13
+ * shared {@link WorkbookIO} (the same instance Studio's file commands use, so the dirty state
14
+ * matches) — most apps don't need to pass this.
15
+ */
16
+ io?: IWorkbookIO;
17
+ /**
18
+ * When no explicit {@link WorkbookAppOptions.source} is given, read `?source` / `?title` from the
19
+ * URL.
20
+ *
21
+ * @defaultValue true
22
+ */
23
+ fromUrl?: boolean;
24
+ /** Theme for a freshly-created blank workbook (no source). */
25
+ defaultTheme?: IWorkbook.ConstructorOptions['theme'];
26
+ }
27
+ /**
28
+ * Single-call setup for a single-per-window workbook app: resolves the workbook ONCE (an explicit
29
+ * source, the `?source` URL query, or a blank workbook) and manages the window chrome (document/tab
30
+ * title with an unsaved marker, an unsaved-changes close prompt, and a browser keyboard guard).
31
+ *
32
+ * @returns the workbook (an `IWorkbook` or a `Promise<IWorkbook>`) to hand to the view
33
+ * ({@link @sheetxl/react!WorkbookElement} or `Studio`). The view awaits the **same** promise, so the
34
+ * workbook loads once and the chrome + the view observe the same instance.
35
+ *
36
+ * @remarks
37
+ * For apps that own the whole window — NOT for embedding a workbook as a widget. Read failures
38
+ * reject the returned promise (so the view's error panel shows) rather than yielding a null workbook.
39
+ *
40
+ * @example
41
+ * ```tsx
42
+ * const workbook = useWorkbookApp(); // reads ?source, else a blank workbook
43
+ * return <Studio workbook={workbook} />; // or <WorkbookElement workbook={workbook} />
44
+ * ```
45
+ */
46
+ export declare const useWorkbookApp: (options?: WorkbookAppOptions) => IWorkbook | Promise<IWorkbook>;
47
+ //# sourceMappingURL=useWorkbookApp.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useWorkbookApp.d.ts","sourceRoot":"","sources":["../../../../src/workbook/useWorkbookApp.ts"],"names":[],"mappings":"AAIA,OAAO,EAA4B,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAM1F,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAM1D,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC,WAAW,GAAG,MAAM,CAAC;IAC3E;;;;OAIG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,SAAS,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;CACtD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc,GAAI,UAAS,kBAAuB,KAAG,SAAS,GAAG,OAAO,CAAC,SAAS,CA0D9F,CAAC"}
@@ -0,0 +1,15 @@
1
+ import { IWorkbook } from '@sheetxl/sdk';
2
+ /**
3
+ * Tracks whether a workbook is — or, once saved, *will be* — encrypted, as React state.
4
+ *
5
+ * @param workbook The workbook to track, or `null`.
6
+ * @returns `true` when the file is encrypted or a password has been set for it.
7
+ *
8
+ * @remarks
9
+ * Reads `Origin.isEncrypted()`, which covers both: a read or a completed write records what is on
10
+ * disk, and `Origin.setPassword` records the intent immediately — the same latitude
11
+ * `Origin.setName` has. One source, one `onChange` to follow, so a lock appears the moment a
12
+ * password is set rather than only after the save that applies it.
13
+ */
14
+ export declare const useWorkbookEncrypted: (workbook: IWorkbook | null) => boolean;
15
+ //# sourceMappingURL=useWorkbookEncrypted.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useWorkbookEncrypted.d.ts","sourceRoot":"","sources":["../../../../src/workbook/useWorkbookEncrypted.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,SAAS,GAAG,IAAI,KAAG,OAkBjE,CAAC"}
@@ -0,0 +1,18 @@
1
+ import { IWorkbook } from '@sheetxl/sdk';
2
+ /**
3
+ * Tracks the format a workbook is bound to (`Origin.getFormat()`) as React state.
4
+ *
5
+ * @param workbook The workbook to track, or `null`.
6
+ * @returns The resolved format key (e.g. `'SheetXL'`), the path's extension when no key has been
7
+ * resolved yet, or `null` for an unbound workbook.
8
+ *
9
+ * @remarks
10
+ * A format KEY, not a full format type — resolving one to the other needs the registry
11
+ * (`getWriteFormats({ search: key })`), which is async and a concern of whoever is asking.
12
+ *
13
+ * Follows the handle's `onChange`, so chrome that names the current format (a Save As menu, a
14
+ * status bar) updates the moment a Save As re-targets the workbook rather than going stale until
15
+ * the next mount.
16
+ */
17
+ export declare const useWorkbookFormat: (workbook: IWorkbook | null) => string | null;
18
+ //# sourceMappingURL=useWorkbookFormat.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useWorkbookFormat.d.ts","sourceRoot":"","sources":["../../../../src/workbook/useWorkbookFormat.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,SAAS,GAAG,IAAI,KAAG,MAAM,GAAG,IAkBvE,CAAC"}
@@ -0,0 +1,13 @@
1
+ import { IWorkbook } from '@sheetxl/sdk';
2
+ /**
3
+ * Tracks a workbook's name (`getName()`) as React state, updating on {@link IWorkbook.IListeners.onNameChange}.
4
+ *
5
+ * @param workbook The workbook to track, or `null`.
6
+ * @returns The current workbook name, or `null` when there is no workbook / no name.
7
+ *
8
+ * @remarks
9
+ * A small model observer so the title shown by chrome (a tab title, the Studio title bar, etc.)
10
+ * follows the workbook's name reactively rather than reading it once.
11
+ */
12
+ export declare const useWorkbookName: (workbook: IWorkbook | null) => string | null;
13
+ //# sourceMappingURL=useWorkbookName.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useWorkbookName.d.ts","sourceRoot":"","sources":["../../../../src/workbook/useWorkbookName.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,SAAS,GAAG,IAAI,KAAG,MAAM,GAAG,IAerE,CAAC"}
@@ -0,0 +1,29 @@
1
+ import { IWorkbook, ITransaction, TransactionSaveStateManager } from '@sheetxl/sdk';
2
+ /**
3
+ * The result of {@link useWorkbookSaveState}.
4
+ */
5
+ export interface WorkbookSaveState {
6
+ /**
7
+ * `true` when the workbook has unsaved changes (its current commit differs from the last saved).
8
+ */
9
+ isDirty: boolean;
10
+ /**
11
+ * The underlying manager, or `null` until a workbook is set. Use {@link TransactionSaveStateManager.isDirty}
12
+ * for a live (non-render) read, e.g. inside a command handler.
13
+ */
14
+ saveState: TransactionSaveStateManager | null;
15
+ }
16
+ /**
17
+ * Tracks a workbook's dirty (unsaved-changes) state as React state.
18
+ *
19
+ * @param workbook The workbook to track, or `null`.
20
+ * @param commitSource A source of durable-commit notifications (e.g. `WorkbookIO`) so a successful
21
+ * save marks the workbook clean automatically.
22
+ *
23
+ * @remarks
24
+ * Owns a {@link TransactionSaveStateManager} for the life of the workbook and closes it on
25
+ * change/unmount. The "saved baseline" is whatever the `commitSource` reports as durably committed;
26
+ * without one, dirtiness is measured relative to the workbook's initial commit.
27
+ */
28
+ export declare const useWorkbookSaveState: (workbook: IWorkbook | null, commitSource?: ITransaction.ICommitSource) => WorkbookSaveState;
29
+ //# sourceMappingURL=useWorkbookSaveState.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useWorkbookSaveState.d.ts","sourceRoot":"","sources":["../../../../src/workbook/useWorkbookSaveState.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,2BAA2B,EAC/D,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,SAAS,EAAE,2BAA2B,GAAG,IAAI,CAAC;CAC/C;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,SAAS,GAAG,IAAI,EAC1B,eAAe,YAAY,CAAC,aAAa,KACxC,iBAyBF,CAAC"}