@sheetxl/studio-mui 0.8.0-beta.2 → 0.8.0-beta.21

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 (299) hide show
  1. package/LICENSE.md +17 -7
  2. package/browser/esm/{xGJU5xUJx3HF317Q.mjs → -z5Wfuc02L-6kq1M.mjs} +14 -13
  3. package/browser/esm/0NmmzX7YcGCZAfjR.mjs +392 -0
  4. package/browser/esm/{BlZiWp3SB3wH5O38.mjs → 19wMLMJtWK0oeEVt.mjs} +4 -4
  5. package/browser/esm/3FkSn_nCNgxZsgIL.mjs +335 -0
  6. package/browser/esm/4V2MEotoMq61137z.mjs +412 -0
  7. package/browser/esm/ATq4TDNCeji9EzyV.mjs +141 -0
  8. package/browser/esm/B5WTcQ5DGtwQ0jkI.mjs +442 -0
  9. package/browser/esm/BB_QvUAlMtL59z9o.mjs +294 -0
  10. package/browser/esm/BCBAzHaXN9AV8sab.mjs +2699 -0
  11. package/browser/esm/BEf9LRQrSZ8r-xAT.mjs +8547 -0
  12. package/browser/esm/BRnkoDWmbvG8C1_N.mjs +68 -0
  13. package/browser/esm/{Dv3hSCyjvwo6GcH1.mjs → BTmU9XLPvYrHSqNS.mjs} +4 -4
  14. package/browser/esm/BbJU08YmJt-_qBF6.mjs +94 -0
  15. package/browser/esm/Bi0lTIkuP-DeqJcH.mjs +516 -0
  16. package/browser/esm/BloQOjPg78u-EF02.mjs +1288 -0
  17. package/browser/esm/BqbKAlU_mHU6NhT9.mjs +13 -0
  18. package/browser/esm/BseH-4GXYtDqvoqT.mjs +77 -0
  19. package/browser/esm/Bv82Dlpi9aSgFTW7.mjs +103 -0
  20. package/browser/esm/{C5-J1xiO3O1-qaaP.mjs → BzqmYkLttNHqg63Q.mjs} +83 -95
  21. package/browser/esm/C1XWND0Zi7LMcsm_.mjs +633 -0
  22. package/browser/esm/C2RXFrmqZeD3QqPh.mjs +975 -0
  23. package/browser/esm/CFBHs4m2-BlqZkEr.mjs +267 -0
  24. package/browser/esm/CL-QL6Z7zajam81k.mjs +225 -0
  25. package/browser/esm/CNcmM3o7opgAuBgV.mjs +14 -0
  26. package/browser/esm/{B1YOQZHyO_dmHUN4.mjs → COetbYqMtkntH82m.mjs} +2 -2
  27. package/browser/esm/{_v6Wbw_y3QgJy3qY.mjs → CQUfTuoSCwqQ0IMS.mjs} +2 -2
  28. package/browser/esm/CS3J1M5x0VrJ3ndM.mjs +973 -0
  29. package/browser/esm/CSc97nFWptJgbzHm.mjs +360 -0
  30. package/browser/esm/CTBTpY09hkS1rzas.mjs +517 -0
  31. package/browser/esm/{CppDmJ4ckCH3alQf.mjs → C_Gs7_-MyIUFd3GO.mjs} +156 -109
  32. package/browser/esm/{DSGFnb1gYyL22p0t.mjs → CgaSjzrOnWuwOhIc.mjs} +20 -18
  33. package/browser/esm/CmFDMGxQc2IWNQrh.mjs +831 -0
  34. package/browser/esm/Cn9HHObOgyeO5n59.mjs +252 -0
  35. package/browser/esm/D56YnBeIxJlew7m_.mjs +235 -0
  36. package/browser/esm/D6K4M0lTty-YfNwL.mjs +318 -0
  37. package/browser/esm/DBiaGhkvzLnkUxgI.mjs +197 -0
  38. package/browser/esm/{CNLLwRPWnd4PJgPO.mjs → DDraGX98UQjilEmH.mjs} +5 -5
  39. package/browser/esm/DI2OTnABUBEmEaqR.mjs +424 -0
  40. package/browser/esm/DP7rdmsD5vllWV3a.mjs +14 -0
  41. package/browser/esm/DR9p8nTF7Ac49NOk.mjs +161 -0
  42. package/browser/esm/Dhw4RvCFZ7-lER3m.mjs +31 -0
  43. package/browser/esm/{DE7MVTTfExTzvyMW.mjs → DlXxfHGCzQyswKls.mjs} +33 -31
  44. package/browser/esm/DqZOeLxpTB81KRea.mjs +8 -0
  45. package/browser/esm/{Bo74PCF42KVYJF0j.mjs → Drf5SnYtXPKJrneG.mjs} +4 -4
  46. package/browser/esm/DsJPi1PsaB1T96tB.mjs +106 -0
  47. package/browser/esm/Dtnkv-g21i8s_DmS.mjs +87 -0
  48. package/browser/esm/DypNzviXLejO7EFy.mjs +94 -0
  49. package/browser/esm/JbP9J8Lps9opfBEE.mjs +1550 -0
  50. package/browser/esm/{D7fA9EyCNSzQMgxg.mjs → MvwrF55lxVF8jCRR.mjs} +2 -2
  51. package/browser/esm/R475WpaxeXiWizBi.mjs +225 -0
  52. package/browser/esm/XHu8ZHNIkE6wwhdW.mjs +119 -0
  53. package/browser/esm/{C2Eke_9Dj_m6mtMj.mjs → XpFIJoW5f7WrDl7A.mjs} +47 -48
  54. package/browser/esm/_ufgBrmZqc27mJTC.mjs +242 -0
  55. package/browser/esm/iOjNj5iTG7nRxxjs.mjs +386 -0
  56. package/browser/esm/{DIGlcemS7napWyKW.mjs → iXPWuBCZoCbVaYmX.mjs} +8 -6
  57. package/browser/esm/index.mjs +1908 -289
  58. package/browser/esm/n8uT2YLiULcikick.mjs +414 -0
  59. package/browser/esm/oFMJAOPBUVDkFSdk.mjs +72 -0
  60. package/browser/esm/pCVoTlBjzq5Y0YwO.mjs +490 -0
  61. package/browser/esm/{iM5uEM9H4e8HGt5y.mjs → prIPxnV06vnSprPI.mjs} +3 -3
  62. package/licenses/dependencies.txt +113 -366
  63. package/node/esm/4dZy4IT0suoxZvbK.mjs +294 -0
  64. package/node/esm/{DVaQ6xIbKQgBk0uw.mjs → 66U7xo0GBu80pE9I.mjs} +70 -71
  65. package/node/esm/9Kq__XyQDKWxOU37.mjs +224 -0
  66. package/node/esm/{DvMAUBSQsZmIsRxi.mjs → B5izshUZ2MRDNb5s.mjs} +2 -2
  67. package/node/esm/{DAji2BXelmIUxioS.mjs → BCUH7DA5M8FLcqxw.mjs} +23 -23
  68. package/node/esm/BORgnY9dptVfd8wC.mjs +267 -0
  69. package/node/esm/BUqtenzZROfaeBgh.mjs +516 -0
  70. package/node/esm/{BJi0FlhIqCMEwROu.mjs → BYf9hvHJuKJNqqZO.mjs} +190 -141
  71. package/node/esm/B_07uId4kB51FCtK.mjs +972 -0
  72. package/node/esm/Bb5tJ1TuwZePhOI_.mjs +94 -0
  73. package/node/esm/BePpjuTMltMTtgmp.mjs +73 -0
  74. package/node/esm/Bsug_5tyxbKlPnjZ.mjs +425 -0
  75. package/node/esm/{CCWQ116Z67Kz78Uo.mjs → Bv3K0CqiXzYTm7CK.mjs} +33 -31
  76. package/node/esm/C75b6boqKp33EdpB.mjs +77 -0
  77. package/node/esm/CAr94CzmtttReoYz.mjs +975 -0
  78. package/node/esm/{DN-bhyNbuBbNB0Ky.mjs → CEQmZUAgMA3rIxe_.mjs} +3 -3
  79. package/node/esm/CRkzp1_dyeM1KUud.mjs +94 -0
  80. package/node/esm/{cJDXopFIX6f3_oi3.mjs → CaMuiNImC2zQQykf.mjs} +2 -2
  81. package/node/esm/CiIW_yB_qnJV5RUA.mjs +1283 -0
  82. package/node/esm/{C0M1VbsIRuRauUI-.mjs → CnPQj9mRZUhQycvE.mjs} +85 -97
  83. package/node/esm/Cv-r7t8eamR5ZFiz.mjs +197 -0
  84. package/node/esm/CyOrPZTUqjp45ABy.mjs +106 -0
  85. package/node/esm/D4ZsBsKhm6gdi5wO.mjs +519 -0
  86. package/node/esm/DB0nWZ9I881Gdoeo.mjs +142 -0
  87. package/node/esm/DJi__4aWX4wwGjnt.mjs +385 -0
  88. package/node/esm/DMqVb7WqCzqQX3wx.mjs +141 -0
  89. package/node/esm/D_3Mcts9e87EORIi.mjs +1838 -0
  90. package/node/esm/{BMoRatciTqOi1HkT.mjs → DoRaGvL9s79NZAYU.mjs} +21 -21
  91. package/node/esm/DpHH7fvV8jCBbKt5.mjs +412 -0
  92. package/node/esm/DxoOobdO06D16DYc.mjs +118 -0
  93. package/node/esm/{BoDCV8cDmFVAYtaW.mjs → Dz9GxMRQzPtOpqNo.mjs} +2 -2
  94. package/node/esm/Iji4gCNbD66TvfOS.mjs +391 -0
  95. package/node/esm/RqUCi1IOUIuPSFCu.mjs +14 -0
  96. package/node/esm/S1sK514tY4D0vLiA.mjs +638 -0
  97. package/node/esm/SNaalbjzQGIMnqPC.mjs +319 -0
  98. package/node/esm/{DVshSSmP5QZU7GoY.mjs → b32Mry1LI41o7I1O.mjs} +29 -29
  99. package/node/esm/b_lG4702kLpmFvGb.mjs +489 -0
  100. package/node/esm/cQkfTTXKtrzzwTj_.mjs +242 -0
  101. package/node/esm/index.mjs +10368 -8704
  102. package/node/esm/sKtXhZg7VoFWiL32.mjs +68 -0
  103. package/package.json +16 -19
  104. package/resources/contents.json +6 -0
  105. package/resources/locales/contents.json +14 -0
  106. package/resources/locales/de/groups.cmd.json +61 -10
  107. package/resources/locales/de/ui.msg.json +293 -17
  108. package/resources/locales/de/workbookAnomalies.cmd.json +14 -0
  109. package/resources/locales/en/groups.cmd.json +71 -11
  110. package/resources/locales/en/ui.msg.json +298 -17
  111. package/resources/locales/en/workbookAnomalies.cmd.json +14 -0
  112. package/types/src/anchorItems/AnchorItemsDescriptor.d.ts +10 -4
  113. package/types/src/anomalies/AnomaliesCommands.d.ts +8 -0
  114. package/types/src/anomalies/AnomaliesMessages.d.ts +30 -0
  115. package/types/src/anomalies/AnomaliesPlugin.d.ts +12 -0
  116. package/types/src/anomalies/AnomaliesTaskPane.d.ts +17 -0
  117. package/types/src/anomalies/_source.d.ts +7 -0
  118. package/types/src/anomalies/index.d.ts +3 -0
  119. package/types/src/border/BorderPopupButton.d.ts +1 -1
  120. package/types/src/border/BorderTemplateIcon.d.ts +6 -1
  121. package/types/src/chart/ChartFormatPanel.d.ts +20 -0
  122. package/types/src/chart/ChartPlugin.d.ts +6 -0
  123. package/types/src/chart/index.d.ts +3 -0
  124. package/types/src/color/ColorPopupButton.d.ts +1 -1
  125. package/types/src/command/AccountingStyleCommandButton.d.ts +1 -1
  126. package/types/src/command/ColorCommandButton.d.ts +5 -0
  127. package/types/src/command/DocThemeCommandButton.d.ts +1 -1
  128. package/types/src/command/FontFamilyCommandButton.d.ts +1 -1
  129. package/types/src/command/FontSizeCommandButton.d.ts +1 -1
  130. package/types/src/command/InsertCellControlCommandButton.d.ts +17 -0
  131. package/types/src/command/LanguageCommandButton.d.ts +1 -1
  132. package/types/src/command/LocaleCommandButton.d.ts +1 -1
  133. package/types/src/command/PresetCellStylesCommandButton.d.ts +3 -3
  134. package/types/src/command/PresetPivotStylesCommandButton.d.ts +17 -0
  135. package/types/src/command/SheetZoomCommandButton.d.ts +4 -3
  136. package/types/src/command/index.d.ts +2 -0
  137. package/types/src/comments/CommentCard.d.ts +41 -0
  138. package/types/src/comments/CommentsPlugin.d.ts +6 -0
  139. package/types/src/comments/CommentsTaskPane.d.ts +23 -0
  140. package/types/src/comments/index.d.ts +4 -0
  141. package/types/src/conditionalFormat/ConditionalFormatPlugin.d.ts +1 -1
  142. package/types/src/conditionalFormat/ConditionalFormatStylePicker.d.ts +4 -4
  143. package/types/src/conditionalFormat/IconPickerPopupButton.d.ts +3 -3
  144. package/types/src/conditionalFormat/IconSetRulePanel.d.ts +1 -1
  145. package/types/src/conditions/BetweenOption.d.ts +5 -0
  146. package/types/src/conditions/CombinatorOption.d.ts +7 -0
  147. package/types/src/conditions/ConditionEditor.d.ts +55 -3
  148. package/types/src/conditions/ConditionUtils.d.ts +34 -6
  149. package/types/src/conditions/ExpressionOption.d.ts +6 -0
  150. package/types/src/conditions/MembershipOption.d.ts +67 -0
  151. package/types/src/conditions/OperatorAndParamEditor.d.ts +36 -1
  152. package/types/src/conditions/OperatorSelectPopupButton.d.ts +1 -1
  153. package/types/src/conditions/ScalarOption.d.ts +19 -0
  154. package/types/src/conditions/SelectorSelect.d.ts +16 -7
  155. package/types/src/conditions/index.d.ts +1 -1
  156. package/types/src/conditions/useFormulaOption.d.ts +2 -2
  157. package/types/src/dataValidation/DataValidationEditorPanel.d.ts +9 -5
  158. package/types/src/dataValidation/DataValidationIcon.d.ts +1 -1
  159. package/types/src/dataValidation/DataValidationPlugin.d.ts +1 -1
  160. package/types/src/dialog/HyperlinkDialog.d.ts +15 -0
  161. package/types/src/dialog/OutlineSettingsDialog.d.ts +12 -0
  162. package/types/src/dialog/PivotTableNewDialog.d.ts +11 -0
  163. package/types/src/dialog/SparklineEditDialog.d.ts +10 -0
  164. package/types/src/dialog/SparklineNewDialog.d.ts +23 -0
  165. package/types/src/dialog/WorkbookStatisticsDialog.d.ts +1 -1
  166. package/types/src/dialog/_ShortcutSearch.d.ts +26 -0
  167. package/types/src/dialog/index.d.ts +0 -1
  168. package/types/src/externalLink/ExternalLinkSettingsTab.d.ts +1 -1
  169. package/types/src/externalLink/ExternalLinksPlugin.d.ts +1 -1
  170. package/types/src/fill/GradientEditor.d.ts +15 -13
  171. package/types/src/fill/GradientStopsBar.d.ts +43 -0
  172. package/types/src/fill/PatternPopupButton.d.ts +1 -1
  173. package/types/src/fill/index.d.ts +1 -0
  174. package/types/src/filter/ColumnMenu.d.ts +31 -1
  175. package/types/src/filter/PivotMenu.d.ts +31 -0
  176. package/types/src/filter/index.d.ts +1 -1
  177. package/types/src/form/FormulaField.d.ts +10 -4
  178. package/types/src/form/InputField.d.ts +5 -5
  179. package/types/src/format/AlignmentPanel.d.ts +1 -2
  180. package/types/src/format/BorderPreview.d.ts +33 -16
  181. package/types/src/format/FillPanel.d.ts +42 -2
  182. package/types/src/format/FormatPanelParts.d.ts +3 -1
  183. package/types/src/format/FormatPlugin.d.ts +1 -6
  184. package/types/src/format/LinePanel.d.ts +53 -0
  185. package/types/src/format/LinePreviews.d.ts +71 -0
  186. package/types/src/format/index.d.ts +1 -0
  187. package/types/src/format/useFormatSelection.d.ts +7 -6
  188. package/types/src/formulaBar/IFormulaBar.d.ts +32 -3
  189. package/types/src/formulaBar/MobileFormulaBar.d.ts +42 -0
  190. package/types/src/formulaBar/MobileInputToolbar.d.ts +43 -0
  191. package/types/src/formulaBar/index.d.ts +3 -0
  192. package/types/src/formulaBar/useFormulaBarSession.d.ts +68 -0
  193. package/types/src/index.d.ts +19 -5
  194. package/types/src/itemsPanel/EditorCommit.d.ts +32 -0
  195. package/types/src/itemsPanel/EditorPanel.d.ts +1 -2
  196. package/types/src/itemsPanel/ItemCard.d.ts +50 -7
  197. package/types/src/itemsPanel/ItemsDescriptor.d.ts +13 -0
  198. package/types/src/itemsPanel/ItemsPanel.d.ts +5 -0
  199. package/types/src/itemsPanel/ItemsSearchField.d.ts +17 -0
  200. package/types/src/itemsPanel/index.d.ts +2 -0
  201. package/types/src/named/NamedDetailsPanel.d.ts +2 -2
  202. package/types/src/named/NamedPlugin.d.ts +1 -1
  203. package/types/src/picture/PicturePlugin.d.ts +6 -0
  204. package/types/src/picture/index.d.ts +2 -0
  205. package/types/src/pivot/PivotChipMenu.d.ts +10 -0
  206. package/types/src/pivot/PivotPlugin.d.ts +3 -0
  207. package/types/src/pivot/PivotStyleCanvasPreview.d.ts +23 -0
  208. package/types/src/pivot/PivotTableHeader.d.ts +12 -0
  209. package/types/src/pivot/PivotValueSettingsDialog.d.ts +15 -0
  210. package/types/src/pivot/_pivotSource.d.ts +7 -0
  211. package/types/src/presence/PresenceOverlay.d.ts +14 -0
  212. package/types/src/presence/PresencePlugin.d.ts +31 -0
  213. package/types/src/presence/PresenceStrip.d.ts +22 -0
  214. package/types/src/presence/PresenceTaskPane.d.ts +13 -0
  215. package/types/src/presence/Timeline.d.ts +29 -0
  216. package/types/src/presence/index.d.ts +5 -0
  217. package/types/src/protection/ProtectedCellsPanel.d.ts +3 -3
  218. package/types/src/protection/ProtectionPlugin.d.ts +1 -1
  219. package/types/src/protection/{SheetProtectionPanel.d.ts → WorksheetProtectionPanel.d.ts} +6 -6
  220. package/types/src/protection/index.d.ts +1 -1
  221. package/types/src/shape/ShapeFormatPanel.d.ts +11 -0
  222. package/types/src/shape/ShapeGalleryCommandButton.d.ts +18 -0
  223. package/types/src/shape/ShapePlugin.d.ts +8 -0
  224. package/types/src/shape/index.d.ts +3 -0
  225. package/types/src/slicer/InsertSlicerCommandButton.d.ts +13 -0
  226. package/types/src/slicer/PresetSlicerStylesCommandButton.d.ts +12 -0
  227. package/types/src/slicer/SlicerPlugin.d.ts +6 -0
  228. package/types/src/slicer/index.d.ts +3 -0
  229. package/types/src/statusBar/PendingStatus.d.ts +19 -0
  230. package/types/src/statusBar/SheetZoomScale.d.ts +6 -0
  231. package/types/src/statusBar/index.d.ts +1 -0
  232. package/types/src/studio/CommandsWrapper.d.ts +2 -0
  233. package/types/src/studio/StudioCommandProvider.d.ts +7 -0
  234. package/types/src/studio/StudioCommands.d.ts +2 -2
  235. package/types/src/studio/StudioProps.d.ts +50 -22
  236. package/types/src/studio/StudioSplitPane.d.ts +1 -1
  237. package/types/src/studio/formulaBarPlacement.d.ts +35 -0
  238. package/types/src/studio/useStudioApp.d.ts +27 -26
  239. package/types/src/table/TablePlugin.d.ts +1 -1
  240. package/types/src/table/_drawStyleSwatch.d.ts +25 -0
  241. package/types/src/template/TemplateDialog.d.ts +1 -1
  242. package/types/src/template/TemplatePanel.d.ts +5 -1
  243. package/types/src/template/TemplateSearchField.d.ts +17 -1
  244. package/types/src/template/categoryColor.d.ts +8 -0
  245. package/types/src/template/useTemplateCatalog.d.ts +7 -5
  246. package/types/src/theme/ThemeSelectPopupButton.d.ts +1 -1
  247. package/types/src/toolbar/WorkbookToolbars.d.ts +2 -2
  248. package/types/src/workbook/DefaultRenderers.d.ts +45 -15
  249. package/types/src/workbook/OutlineButtons.d.ts +11 -0
  250. package/types/src/workbook/WorkbookContextMenu.d.ts +4 -0
  251. package/types/src/workbook/WorkbookElement.d.ts +5 -4
  252. package/types/src/workbook/WorkbookStrip.d.ts +8 -7
  253. package/types/src/workbook/index.d.ts +1 -1
  254. package/browser/cjs/3k_KqDFr-AybPztc.cjs +0 -5
  255. package/browser/cjs/3uprnzi2l0iT17Dg.cjs +0 -1
  256. package/browser/cjs/B9GcCj7sj8XdjPZF.cjs +0 -1
  257. package/browser/cjs/BGvoJjUs21bbuE1i.cjs +0 -1
  258. package/browser/cjs/BHb7TnK1NmimV4OX.cjs +0 -1
  259. package/browser/cjs/BJ-wdkCaXqJaejKf.cjs +0 -1
  260. package/browser/cjs/BNqyPYRxYISp-uEg.cjs +0 -1
  261. package/browser/cjs/BQJKf40kttQWOzLw.cjs +0 -20
  262. package/browser/cjs/BTZ5uzK0wHzpiZGC.cjs +0 -1
  263. package/browser/cjs/BXkdjAb4jpTr412c.cjs +0 -1
  264. package/browser/cjs/Bc-YisjBtD56vBAW.cjs +0 -1
  265. package/browser/cjs/Bo9Kx3L_XQkGPBJ5.cjs +0 -1
  266. package/browser/cjs/C97KHSuikAbr1qVM.cjs +0 -1
  267. package/browser/cjs/CPSc2VSYZeZ1B9mi.cjs +0 -1
  268. package/browser/cjs/CPcBvw4ZPwHVTUZF.cjs +0 -1
  269. package/browser/cjs/CdDYyAfccXme8w6m.cjs +0 -1
  270. package/browser/cjs/CuqM721PsKey3yMP.cjs +0 -1
  271. package/browser/cjs/Cy_XmYq6BsWmCXkk.cjs +0 -3
  272. package/browser/cjs/D948H7ell-f87BX3.cjs +0 -1
  273. package/browser/cjs/Dy6O3OWbDBKIj_Ak.cjs +0 -8
  274. package/browser/cjs/KZvriGbhEOVkQD0b.cjs +0 -1
  275. package/browser/cjs/M0_dvdYwhikqP9kg.cjs +0 -2
  276. package/browser/cjs/QI6GKw7uo1f8gY8C.cjs +0 -1
  277. package/browser/cjs/eCw4rAEIYE3BftpG.cjs +0 -1
  278. package/browser/cjs/iMWEL01eC83oU-YY.cjs +0 -1
  279. package/browser/cjs/index.cjs +0 -2
  280. package/browser/cjs/rCZbExyf1Q3aHloQ.cjs +0 -13
  281. package/browser/esm/894KM-_Oc5cB6ExA.mjs +0 -97
  282. package/browser/esm/BQSamOMBAoFdQdJe.mjs +0 -12903
  283. package/browser/esm/CIbDvsCeLOFHzzId.mjs +0 -152
  284. package/browser/esm/CyHNVjgkMYZYlJpY.mjs +0 -5315
  285. package/browser/esm/D8VPmFDvXDE778_x.mjs +0 -222
  286. package/browser/esm/DEEnXLhYlUARg6MU.mjs +0 -410
  287. package/browser/esm/DN4cwAPYCrtR4gS9.mjs +0 -236
  288. package/browser/esm/DlEshYp6NPfHxFvI.mjs +0 -115
  289. package/browser/esm/GmQ9XFFY3hi1L_Ej.mjs +0 -1150
  290. package/browser/esm/z3zkU7Jf3WJ2_Z_P.mjs +0 -52
  291. package/node/esm/BI8XFczUY--Db2n3.mjs +0 -98
  292. package/node/esm/BgxeTfCn3jZHGwd7.mjs +0 -414
  293. package/node/esm/C_oV7ldFStOF_fAd.mjs +0 -115
  294. package/node/esm/Dbv0IltYad9SQrj3.mjs +0 -236
  295. package/node/esm/OmUP1AfaJcOxWQAg.mjs +0 -4462
  296. package/types/src/conditions/DateTimeOption.d.ts +0 -43
  297. package/types/src/conditions/ListSourceOption.d.ts +0 -31
  298. package/types/src/dialog/CommentsDialog.d.ts +0 -11
  299. package/types/src/filter/FilterList.d.ts +0 -31
@@ -26,14 +26,14 @@ export interface InputFieldProps extends FormControlProps {
26
26
  * (Enter/Tab/Escape), the adornment ✓/✗, `apiRef.current.commit()`, or blur to another field.
27
27
  * `args.reason` distinguishes accept from cancel (a cancel delivers the reverted session baseline).
28
28
  * Not fired on an accept while the text is invalid — the error stays shown instead.
29
- *
30
- * Wiring this is also what shows the modal ✓/✗ adornment pair.
31
29
  */
32
30
  onDone?: (value: string, args: EditDoneArgs) => void;
33
31
  /**
34
32
  * `'done'` suppresses the live {@link onChangeInput} notifications entirely (validation still runs —
35
- * error state stays live — but the host hears only {@link onDone}) and makes Enter the field's own
36
- * commit point rather than a key the host form gets to see. Default `'live'`.
33
+ * error state stays live — but the host hears only {@link onDone}), makes Enter the field's own
34
+ * commit point rather than a key the host form gets to see, and shows the ✓/✗ while the text differs
35
+ * from the committed value.
36
+ * Default `'live'`.
37
37
  */
38
38
  changeOn?: 'live' | 'done';
39
39
  /**
@@ -91,7 +91,7 @@ export interface InputFieldProps extends FormControlProps {
91
91
  * Translate at display (`t(key)` passes a non-key through unchanged).
92
92
  */
93
93
  onChangeError?: (error: string | null) => void;
94
- /** Hide the adornment cluster (the ✓/✗ pair shown while engaged in modal mode). */
94
+ /** Hide the adornment cluster (the ✓/✗ pair shown while editing in `'done'` mode). */
95
95
  hideAdornment?: boolean;
96
96
  /**
97
97
  * Attributes for the INNER `<input>` — `type`, `min`/`max`/`step`, `inputMode`, a class of the
@@ -1,4 +1,3 @@
1
- import { default as React } from 'react';
2
1
  import { FormatPanelProps } from './FormatPanelParts';
3
2
  /**
4
3
  * The **Alignment** tab of the format pane: where text sits in the cell, how it behaves when it
@@ -10,5 +9,5 @@ import { FormatPanelProps } from './FormatPanelParts';
10
9
  * button, because both read the same command state. Only the two numeric fields (indent, custom
11
10
  * angle) write the model directly: a spinner is a poor fit for a command's fire-once shape.
12
11
  */
13
- export declare const AlignmentPanel: React.MemoExoticComponent<(props: FormatPanelProps) => React.JSX.Element>;
12
+ export declare const AlignmentPanel: import('react').MemoExoticComponent<(props: FormatPanelProps) => import("react").JSX.Element>;
14
13
  //# sourceMappingURL=AlignmentPanel.d.ts.map
@@ -2,16 +2,17 @@ import { default as React } from 'react';
2
2
  import { IBorders } from '@sheetxl/sdk';
3
3
  import { TranslateFn } from '@sheetxl/utils-react';
4
4
  /**
5
- * The edges the diagram lets you click — the six that a block of cells can draw.
5
+ * The lines the diagram lets you click — the six that run along a block's cell boundaries.
6
6
  *
7
7
  * @remarks
8
- * The diagonals are not here: they would run corner to corner through both inner rules, and
9
- * nearest-edge picking cannot separate three lines that all cross the same point.
8
+ * The diagonals are not here: they cross the inner rules, and nearest-line picking cannot separate
9
+ * lines that cross at the same point. They are aimed at by the block's outer corners instead (see
10
+ * {@link edgesAt}).
10
11
  *
11
12
  * The order is the tie-break for a pointer sitting exactly where two lines cross, so the OUTER
12
13
  * edges come first — a click on the left edge at its midpoint is aimed at the block's outline, not
13
- * at the inner rule that happens to end there — and the dead center of the diagram, where only the
14
- * two inner rules meet, belongs to the inside-horizontal one.
14
+ * at the inner rule that happens to end there. The crossing of the two inner rules is not a tie at
15
+ * all: it is its own target (see {@link edgesAt}).
15
16
  */
16
17
  export declare const PREVIEW_EDGES: readonly IBorders.Edge[];
17
18
  /** The strokes currently drawn on a block, by edge. An absent entry means "no line here". */
@@ -19,7 +20,8 @@ export type BorderEdges = Partial<Record<IBorders.Edge, IBorders.StrokePropertie
19
20
  /** Localized name for a border edge; literal `t()` pairs keep the extractor able to see them. */
20
21
  export declare function edgeLabel(t: TranslateFn, edge: IBorders.Edge): string;
21
22
  /**
22
- * The edge a pointer is aimed at, or `null` for none.
23
+ * The edges a pointer is aimed at: one line, both inner rules at their crossing, a diagonal at a
24
+ * corner, or none.
23
25
  *
24
26
  * @param x Pointer position relative to the diagram's top-left corner, in CSS px.
25
27
  * @param y Pointer position relative to the diagram's top-left corner, in CSS px.
@@ -29,15 +31,24 @@ export declare function edgeLabel(t: TranslateFn, edge: IBorders.Edge): string;
29
31
  * with no inside, and an edge that cannot be drawn must not swallow a click aimed past it.
30
32
  *
31
33
  * @remarks
32
- * Nearest line wins, which is the only rule that stays honest where two of them cross. Fixed
33
- * rectangles cannot be: the inside-horizontal and inside-vertical zones necessarily overlap in the
34
- * middle, whichever paints later takes the whole square, and clicking the horizontal rule anywhere
35
- * near the center of the diagram toggles the vertical one instead.
34
+ * Nearest line wins, which is the only rule that stays honest where an inner rule meets the
35
+ * outline. Fixed rectangles cannot be: their zones overlap, and whichever paints later takes the
36
+ * whole square.
37
+ *
38
+ * The middle is the exception. Where the two inner rules cross, the pointer is within reach of
39
+ * both and a pixel either way would flip between them, so that square is neither: it aims at the
40
+ * pair, which is the 'Inside' border. Only when both can be drawn — with one inner rule there is
41
+ * no crossing, and the middle is just that rule.
42
+ *
43
+ * The outer corners are the diagonals. A square on each corner, the size of the crossing's and
44
+ * centered on the corner's crop marks, aims at the diagonal that starts there: top-left and
45
+ * bottom-right are `diagonalDown`, top-right and bottom-left `diagonalUp`. The outline is two
46
+ * lines meeting there, so like the crossing the corner is neither of them.
36
47
  *
37
48
  * Exported because this is the part worth testing directly — jsdom lays nothing out, so a mounted
38
49
  * diagram cannot be asked where its lines are.
39
50
  */
40
- export declare function edgeAt(x: number, y: number, width: number, height: number, isAvailable: (edge: IBorders.Edge) => boolean): IBorders.Edge | null;
51
+ export declare function edgesAt(x: number, y: number, width: number, height: number, isAvailable: (edge: IBorders.Edge) => boolean): readonly IBorders.Edge[];
41
52
  export interface BorderPreviewProps extends React.HTMLAttributes<HTMLDivElement> {
42
53
  /**
43
54
  * What is drawn on each edge of the selected block right now.
@@ -51,8 +62,13 @@ export interface BorderPreviewProps extends React.HTMLAttributes<HTMLDivElement>
51
62
  edges: BorderEdges;
52
63
  /** Mints the per-cell border the renderer draws. */
53
64
  createBorder: (properties: Partial<IBorders.Properties>) => IBorders | null;
54
- /** Toggle one edge with the panel's active pen. */
55
- onToggleEdge: (edge: IBorders.Edge) => void;
65
+ /**
66
+ * Toggle edges with the panel's active pen, as one edit.
67
+ *
68
+ * @remarks
69
+ * One edge for a line; both inner rules for the middle of the diagram, where they cross.
70
+ */
71
+ onToggleEdges: (edges: readonly IBorders.Edge[]) => void;
56
72
  /**
57
73
  * Edges this selection cannot draw — the inner rules, on a selection with no inside.
58
74
  *
@@ -73,9 +89,10 @@ export interface BorderPreviewProps extends React.HTMLAttributes<HTMLDivElement>
73
89
  * half of what a border edit is about. The lines are a real {@link StaticBorderRenderer} fed the
74
90
  * selection's own strokes, so what you click is what the grid will draw.
75
91
  *
76
- * Aiming is by DISTANCE rather than by zone (see {@link edgeAt}), and the feedback is the edge
77
- * itself: hovering lights the line a click would toggle, along its whole length. Shading a
78
- * quadrant says "somewhere around here"; a lit line says which line.
92
+ * Aiming is by DISTANCE rather than by zone (see {@link edgesAt}), and the feedback is the edge
93
+ * itself: hovering lights the line a click would toggle, along its whole length — both inner
94
+ * rules, over their crossing. Shading a quadrant says "somewhere around here"; a lit line says
95
+ * which line.
79
96
  */
80
97
  export declare const BorderPreview: {
81
98
  (props: BorderPreviewProps): React.ReactElement;
@@ -1,5 +1,45 @@
1
1
  import { default as React } from 'react';
2
- import { FormatPanelProps } from './FormatPanelParts';
2
+ import { IFill, IColor, ICell, IStyleCollection } from '@sheetxl/sdk';
3
+ import { FormatSelection } from './useFormatSelection';
4
+ /**
5
+ * What the Fill panel needs: one fill to show and one place to write a fill. A cell selection and a
6
+ * shape both answer it, which is how the same panel serves Format Cells and Format Shape.
7
+ */
8
+ export interface FillSelection {
9
+ /** The fill the controls show, resolved: the anchor cell's, or the shape's. */
10
+ fill: IFill;
11
+ /** The workbook's style collection — theme swatches and recent colors for the pickers. */
12
+ styles: IStyleCollection;
13
+ /** Theme color resolution for the color pickers. */
14
+ schemeLookup: IColor.SchemeLookup;
15
+ /** Whether the GRID renders dark (not the app chrome) — swatches follow the grid. */
16
+ darkMode: boolean;
17
+ /** True when the fill cannot be changed (a protected sheet). */
18
+ disabled: boolean;
19
+ /** Mints a detached cell for the pattern swatches (theme colors resolve against the workbook). */
20
+ createCell: (update: ICell.Update) => ICell | null;
21
+ /**
22
+ * Writes a fill as one undoable step.
23
+ *
24
+ * @param fill The fill, or fill properties that merge into what is there.
25
+ * @param description A `messageKey('op.…')` naming the step in the undo history.
26
+ */
27
+ applyFill: (fill: IFill.Update, description?: string) => void;
28
+ }
29
+ /** The cell selection's fill: the anchor cell's, written to every selected range. */
30
+ export declare const fillSelectionOf: (selection: FormatSelection) => FillSelection;
31
+ export interface FillPanelProps extends React.HTMLAttributes<HTMLDivElement> {
32
+ /** The fill the panel reads and writes. */
33
+ selection: FillSelection;
34
+ /** Force every control off, on top of the selection's own {@link FillSelection.disabled}. */
35
+ disabled?: boolean;
36
+ /**
37
+ * The most stops the gradient editor will author. The model and the xlsx file take any number
38
+ * (Excel draws them all; only its own dialog stops at two colors), so none is imposed here.
39
+ * @defaultValue the editor's own, see {@link GradientEditorProps.maxStops}
40
+ */
41
+ maxGradientStops?: number;
42
+ }
3
43
  /**
4
44
  * The **Fill** tab of the format pane — the one tab Excel Online does not have.
5
45
  *
@@ -21,5 +61,5 @@ import { FormatPanelProps } from './FormatPanelParts';
21
61
  * command is still consulted for the picker's cross-surface memory (last-used color, recent
22
62
  * colors), just not for the value.
23
63
  */
24
- export declare const FillPanel: React.MemoExoticComponent<(props: FormatPanelProps) => React.JSX.Element>;
64
+ export declare const FillPanel: React.MemoExoticComponent<(props: FillPanelProps) => React.JSX.Element>;
25
65
  //# sourceMappingURL=FillPanel.d.ts.map
@@ -34,6 +34,8 @@ export interface FormatNumberFieldProps {
34
34
  max: number;
35
35
  /** The spinner's increment. Default `1`. */
36
36
  step?: number;
37
+ /** Accept fractions (a line width in points). Default: whole numbers only. */
38
+ decimals?: boolean;
37
39
  /** Width in px. These sit in rows beside buttons, not in a form column. */
38
40
  width: number;
39
41
  disabled?: boolean;
@@ -41,7 +43,7 @@ export interface FormatNumberFieldProps {
41
43
  onChange: (value: number) => void;
42
44
  }
43
45
  /**
44
- * A whole-number field for the format pane: an {@link InputField} with a numeric input, no helper
46
+ * A number field for the format pane: an {@link InputField} with a numeric input, no helper
45
47
  * line, and a commit on Enter.
46
48
  *
47
49
  * @remarks
@@ -1,11 +1,6 @@
1
- /**
2
- * The key the format pane registers under — what `activateTaskPane` and the `formatCells` command
3
- * address it by.
4
- */
5
- export declare const FORMAT_TASK_PANE_KEY = "formatCells";
6
1
  /**
7
2
  * Registers the Format Cells task pane. Called from the studio bootstrap alongside the other
8
3
  * built-in panes.
9
4
  */
10
- export declare const FormatPlugin: () => void;
5
+ export declare const FormatPlugin: () => (() => void);
11
6
  //# sourceMappingURL=FormatPlugin.d.ts.map
@@ -0,0 +1,53 @@
1
+ import { default as React } from 'react';
2
+ import { IStroke, IColor, IStyleCollection } from '@sheetxl/sdk';
3
+ /**
4
+ * What the Line panel needs: one line to show and one place to write a line.
5
+ */
6
+ export interface LineSelection {
7
+ /** The line the controls show, resolved: what the shape states over its theme style. */
8
+ stroke: IStroke;
9
+ /**
10
+ * What the shape states of its line itself, or `null` for nothing. The color picker shows the
11
+ * **Automatic** swatch when the color is the theme's rather than stated.
12
+ */
13
+ stated: IStroke.JSON | null;
14
+ /** The color the line takes when none is stated — the picker's **Automatic** swatch. */
15
+ autoColor: IColor;
16
+ /** The workbook's style collection — theme swatches and recent colors for the picker. */
17
+ styles: IStyleCollection;
18
+ /** Theme color resolution for the color picker. */
19
+ schemeLookup: IColor.SchemeLookup;
20
+ /** Whether the GRID renders dark (not the app chrome) — swatches follow the grid. */
21
+ darkMode: boolean;
22
+ /** True when the line cannot be changed (a protected sheet). */
23
+ disabled: boolean;
24
+ /**
25
+ * Writes a line as one undoable step.
26
+ *
27
+ * @param stroke Line properties that merge into what is stated, or `null` for the theme's line.
28
+ * @param description A `messageKey('op.…')` naming the step in the undo history.
29
+ */
30
+ applyStroke: (stroke: IStroke.Modifiers | null, description?: string) => void;
31
+ }
32
+ export interface LinePanelProps extends React.HTMLAttributes<HTMLDivElement> {
33
+ /** The line the panel reads and writes. */
34
+ selection: LineSelection;
35
+ /** Force every control off, on top of the selection's own {@link LineSelection.disabled}. */
36
+ disabled?: boolean;
37
+ }
38
+ /**
39
+ * The **Line** section of Format Shape: whether a line is drawn, and its color, width, dash,
40
+ * arrowheads, caps and joins, applying live.
41
+ *
42
+ * @remarks
43
+ * Excel shows the controls only while a line is drawn; so does this. The dash and the arrowheads
44
+ * are picked from previews drawn in the line's color, the way the border style picker offers its
45
+ * strokes, which is what lets the begin arrow, the dash and the end arrow sit on one row. An arrow
46
+ * is one button, as a border is: the types in its list, each type's sizes in a submenu.
47
+ *
48
+ * The color picker's **Automatic** swatch is the theme style's color, which is what a line that
49
+ * states a width alone draws with, so picking it hands the color back rather than writing the
50
+ * theme's value down.
51
+ */
52
+ export declare const LinePanel: React.MemoExoticComponent<(props: LinePanelProps) => React.JSX.Element>;
53
+ //# sourceMappingURL=LinePanel.d.ts.map
@@ -0,0 +1,71 @@
1
+ import { default as React } from 'react';
2
+ import { IStroke, IColor } from '@sheetxl/sdk';
3
+ /** The previews' length, in px. */
4
+ export declare const PREVIEW_LENGTH = 60;
5
+ export interface DashIconProps {
6
+ dash: IStroke.DashStyle | number[];
7
+ color: IColor | null;
8
+ darkMode?: boolean;
9
+ }
10
+ /** A line drawn with a dash, in the line's color: what a dash looks like. */
11
+ export declare const DashIcon: React.MemoExoticComponent<(props: DashIconProps) => React.ReactElement>;
12
+ /** An arrowhead preview's length: the largest head plus a stub of line, about a square. */
13
+ export declare const END_PREVIEW_LENGTH = 20;
14
+ export interface LineEndIconProps {
15
+ end: IStroke.LineEnd;
16
+ /** Drawn at the start of the line (pointing left) rather than its end. */
17
+ atStart?: boolean;
18
+ color: IColor | null;
19
+ darkMode?: boolean;
20
+ }
21
+ /** A stub of line with one end drawn: what an arrowhead of a type and size looks like. */
22
+ export declare const LineEndIcon: React.MemoExoticComponent<(props: LineEndIconProps) => React.ReactElement>;
23
+ export interface LineEndPopupButtonProps {
24
+ end: IStroke.LineEnd;
25
+ /** The start of the line (pointing left) rather than its end. */
26
+ atStart?: boolean;
27
+ color: IColor | null;
28
+ darkMode?: boolean;
29
+ /** The types offered, in order; the first is none. */
30
+ types: readonly IStroke.LineEndType[];
31
+ /** The sizes offered, in order. */
32
+ sizes: readonly IStroke.LineEndSize[];
33
+ /** Localized names by type, and by size. */
34
+ typeLabels: Record<string, string>;
35
+ sizeLabels: Record<string, string>;
36
+ /** The size submenu's tooltip: `${width}: Small · ${length}: Large`. */
37
+ widthLabel: string;
38
+ lengthLabel: string;
39
+ tooltip?: string;
40
+ disabled?: boolean;
41
+ onSelect: (end: IStroke.LineEnd | null) => void;
42
+ }
43
+ /**
44
+ * One button for a line end, the way the border button is one button for a border: a preview of
45
+ * the end as it is, opening the list of arrowhead types, each of which opens its sizes. Clicking a
46
+ * type takes it at the current size; a size takes both.
47
+ */
48
+ export declare const LineEndPopupButton: (props: LineEndPopupButtonProps) => React.ReactElement;
49
+ export interface PreviewOption<V extends string> {
50
+ value: V;
51
+ /** Named in the tooltip; the icon is what shows. */
52
+ label: string;
53
+ icon: React.ReactNode;
54
+ }
55
+ export interface PreviewPopupButtonProps<V extends string> {
56
+ value: V;
57
+ options: readonly PreviewOption<V>[];
58
+ onSelect: (value: V) => void;
59
+ /** Lay the options out in a grid of this many columns; a list otherwise. */
60
+ columns?: number;
61
+ tooltip?: string;
62
+ disabled?: boolean;
63
+ /** What the button shows in place of the chosen option's icon. */
64
+ icon?: React.ReactNode;
65
+ }
66
+ /**
67
+ * A button showing a preview of what is chosen, opening a list (or grid) of previews to choose
68
+ * from: the way the border style picker offers its strokes.
69
+ */
70
+ export declare const PreviewPopupButton: <V extends string>(props: PreviewPopupButtonProps<V>) => React.ReactElement;
71
+ //# sourceMappingURL=LinePreviews.d.ts.map
@@ -6,6 +6,7 @@ export * from './NumberFormatPanel';
6
6
  export * from './AlignmentPanel';
7
7
  export * from './FontPanel';
8
8
  export * from './FillPanel';
9
+ export * from './LinePanel';
9
10
  export * from './BorderPanel';
10
11
  export * from './BorderPreview';
11
12
  export * from './FormatTaskPane';
@@ -1,4 +1,4 @@
1
- import { IBorders, IWorkbook, ISheet, ICell, IStyle, IStyleCollection, IColor } from '@sheetxl/sdk';
1
+ import { IBorders, IWorksheet, ICell, ICellRange, ICellStyle, IStyleCollection, IColor } from '@sheetxl/sdk';
2
2
  /**
3
3
  * Everything the format panels need from the workbook, resolved from the live selection.
4
4
  *
@@ -9,14 +9,14 @@ import { IBorders, IWorkbook, ISheet, ICell, IStyle, IStyleCollection, IColor }
9
9
  */
10
10
  export interface FormatSelection {
11
11
  /** The sheet the selection lives on. */
12
- sheet: ISheet;
12
+ sheet: IWorksheet;
13
13
  /**
14
14
  * The ANCHOR cell — the one the panels read their control values from, and the one the preview
15
15
  * shows. A multi-cell selection has one style per cell; Excel reads the anchor too.
16
16
  */
17
17
  cell: ICell;
18
18
  /** {@link cell}'s resolved style. */
19
- style: IStyle;
19
+ style: ICellStyle;
20
20
  /** The workbook's style collection — theme swatches and recent colors for the pickers. */
21
21
  styles: IStyleCollection;
22
22
  /** Theme color resolution for the color pickers. */
@@ -40,6 +40,7 @@ export interface FormatSelection {
40
40
  *
41
41
  * @param update The style delta, or a SEQUENCE of them applied in order.
42
42
  * @param description A `messageKey('op.…')` naming the step in the undo history.
43
+ * @param autoFit How the selection is fit afterwards, when the default style fit is not it.
43
44
  *
44
45
  * @remarks
45
46
  * A sequence is how a caller expresses REPLACE rather than merge. A style delta merges into
@@ -47,7 +48,7 @@ export interface FormatSelection {
47
48
  * one standing — there is no value for "no color" to write. Erasing the edge first and drawing
48
49
  * it second says the whole thing, and the batch keeps it one step in the undo history.
49
50
  */
50
- applyStyle: (update: IStyle.Update | readonly IStyle.Update[], description?: string) => void;
51
+ applyStyle: (update: ICellStyle.Update | readonly ICellStyle.Update[], description?: string, autoFit?: ICellRange.AutoFitOptions) => void;
51
52
  /** Mints a detached cell for the previews (theme + named styles resolve against the workbook). */
52
53
  createCell: (update: ICell.Update) => ICell | null;
53
54
  /** Mints a detached border for the border diagram, the way the border picker's context does. */
@@ -84,9 +85,9 @@ export interface FormatSelection {
84
85
  hasInnerVertical: boolean;
85
86
  }
86
87
  /**
87
- * Binds the format panels to the workbook's live selection: re-renders on a selection change and on
88
+ * Binds the format panels to a worksheet's live selection: re-renders on a selection change and on
88
89
  * any style change (Excel-style live apply — the pane has no OK button, so what it shows must follow
89
90
  * what it just wrote).
90
91
  */
91
- export declare const useFormatSelection: (workbook: IWorkbook) => FormatSelection;
92
+ export declare const useFormatSelection: (sheet: IWorksheet) => FormatSelection;
92
93
  //# sourceMappingURL=useFormatSelection.d.ts.map
@@ -1,7 +1,12 @@
1
1
  import { default as React } from 'react';
2
2
  import { IWorkbook } from '@sheetxl/sdk';
3
+ import { RenderSlotFn } from '@sheetxl/utils-react';
3
4
  import { SheetEditable } from '@sheetxl/react';
4
5
  import { NamedCollectionEditorProps, INamedCollectionEditorElement } from '../named';
6
+ /**
7
+ * Where a formula bar sits in the studio: above the grid, or below it directly above the status bar.
8
+ */
9
+ export type FormulaBarPlacement = 'top' | 'bottom';
5
10
  export interface FormulaBarProps extends React.HTMLAttributes<HTMLDivElement> {
6
11
  /**
7
12
  * The workbook that is used for the range.use
@@ -22,9 +27,10 @@ export interface FormulaBarProps extends React.HTMLAttributes<HTMLDivElement> {
22
27
  */
23
28
  propsNamedCollectionEditor?: NamedCollectionEditorProps;
24
29
  /**
25
- * Override the default NamedCollectionEditor
30
+ * Override the default NamedCollectionEditor. Pass `props.ref` on to the
31
+ * {@link INamedCollectionEditorElement}.
26
32
  */
27
- renderNamedCollectionEditor?: (props: NamedCollectionEditorProps, ref: React.Ref<INamedCollectionEditorElement>) => React.ReactElement;
33
+ renderNamedCollectionEditor?: RenderSlotFn<NamedCollectionEditorProps>;
28
34
  /**
29
35
  * Disabled the ui.
30
36
  */
@@ -36,19 +42,42 @@ export interface FormulaBarProps extends React.HTMLAttributes<HTMLDivElement> {
36
42
  * @defaultValue true
37
43
  */
38
44
  showCalculateNow?: boolean;
45
+ /**
46
+ * Which edge of the grid the bar sits on. A bar below the grid grows upward when expanded and
47
+ * marks focus along its top edge.
48
+ *
49
+ * @defaultValue 'top'
50
+ */
51
+ placement?: FormulaBarPlacement;
52
+ /**
53
+ * Whether a bar at the bottom edits on top of the virtual keyboard. The bar stays in place, read
54
+ * only, and the field moves to a bar that rides the keyboard while it is up. `false` keeps the field
55
+ * in place (for a host that manages the keyboard itself). Ignored at the top.
56
+ *
57
+ * @defaultValue true
58
+ */
59
+ floatOnKeyboard?: boolean;
39
60
  /**
40
61
  * Ref for the FormulaBar element.
41
62
  */
42
63
  ref?: React.Ref<IFormulaBarElement>;
43
64
  }
44
65
  export interface FormulaBarAttributes {
45
- isFormulaBarElement: () => true;
46
66
  getNamedCollectionEditorElement: () => INamedCollectionEditorElement | null;
47
67
  /**
48
68
  * The shared cell editor the formula bar drives, or `null` if none. The same instance
49
69
  * the grid uses.
50
70
  */
51
71
  getEditable: () => SheetEditable | null;
72
+ /**
73
+ * Whether focus is in the bar, including a part of it that rides the virtual keyboard outside the
74
+ * bar's element.
75
+ */
76
+ isFocusWithin: () => boolean;
77
+ /**
78
+ * For runtime introspection
79
+ */
80
+ isFormulaBarElement: () => true;
52
81
  }
53
82
  /**
54
83
  * Type returned via ref property.
@@ -0,0 +1,42 @@
1
+ import { default as React } from 'react';
2
+ import { FormulaBarProps, IFormulaBarElement } from './IFormulaBar';
3
+ export interface MobileFormulaBarProps extends FormulaBarProps {
4
+ /**
5
+ * If cancel and commit buttons are shown on the input toolbar. The studio's status bar shows both
6
+ * during an edit, so a host without that status bar can turn these on.
7
+ */
8
+ showCancelCommit?: boolean;
9
+ }
10
+ /**
11
+ * The formula bar for a touch-only device: the same input the in-grid editor renders, in a box
12
+ * built for the bottom of a phone screen, with a row of entry buttons under it.
13
+ *
14
+ * @remarks
15
+ * The bar is `fx` and the editor, with the expand chevron inside the field at its right edge.
16
+ * Under it, the {@link MobileInputToolbar}: the letters, numbers and date inputs, Tab, Enter, and
17
+ * (with {@link MobileFormulaBarProps.showCancelCommit}) cancel / commit. There is no name box and no
18
+ * Calculate Now button; the commands behind them stay reachable elsewhere.
19
+ *
20
+ * **On the keyboard.** With `floatOnKeyboard` (the default) the bar edits on top of the virtual
21
+ * keyboard, as a phone app's does. The bar in place shows the active cell, read only; the editor is a
22
+ * second copy of the bar in a {@link KeyboardAccessory} that rides the keyboard while the field has
23
+ * focus or the sheet is in keyboard mode. A tap on the bar in place focuses that field (the keyboard
24
+ * rises only for a focus inside a tap); its buttons act on it. As the copy on the keyboard shows, the
25
+ * bar in place fades out and keeps its room, so the bar looks to have moved and the sheet's tabs stay
26
+ * put. The keyboard going away (the back gesture, the hide key) returns focus to the bar in place.
27
+ * Neither copy ever resizes the studio or scrolls the page. Without `floatOnKeyboard` the field is in
28
+ * place, and expanding grows it upward into the grid.
29
+ *
30
+ * It drives the same shared {@link SheetEditable} as the grid through {@link useFormulaBarSession}:
31
+ * a tap on the field starts the edit on the active cell, and a tap on a cell while editing inserts a
32
+ * reference, exactly as the desktop bar does. Enter and Tab (the toolbar's, the keyboard's) commit
33
+ * and move the active cell, leaving the bar idle.
34
+ *
35
+ * The virtual keyboard is the sheet's (see `useVirtualKeyboard`): the bar asks for its keyboard
36
+ * type, its letters and numbers buttons set it, and the bar registers itself as the editor a key typed
37
+ * into the grid opens in while the keyboard is up. In keyboard mode, focus that returns to the grid
38
+ * after an entry lands on the grid's typing input, so the keyboard stays for the next cell. Cancel and
39
+ * commit are the edit's ways out (`exitEditMode`), which end keyboard mode, so the keyboard goes down.
40
+ */
41
+ export declare const MobileFormulaBar: React.NamedExoticComponent<Omit<MobileFormulaBarProps, "ref"> & React.RefAttributes<IFormulaBarElement>>;
42
+ //# sourceMappingURL=MobileFormulaBar.d.ts.map
@@ -0,0 +1,43 @@
1
+ import { default as React } from 'react';
2
+ import { VirtualKeyboardInputMode } from '@sheetxl/utils-react';
3
+ /** The native keyboard the input asks for: letters, or the number pad. */
4
+ export type MobileInputMode = 'text' | 'decimal';
5
+ export interface MobileInputToolbarProps {
6
+ /** Whether an edit session is live; cancel and commit are disabled otherwise. */
7
+ isEditing: boolean;
8
+ /** The bar cannot edit (protected cell, read-only workbook). */
9
+ disabled: boolean;
10
+ /** Whether the input's virtual keyboard is up. */
11
+ keyboardShown: boolean;
12
+ /** The keyboard the input currently asks for. */
13
+ inputMode: VirtualKeyboardInputMode;
14
+ /** Open the letters or the number keyboard on the field. */
15
+ onInputMode: (mode: MobileInputMode) => void;
16
+ /** Open the date picker; the picked date goes into the field. */
17
+ onDate: () => void;
18
+ /** Commit and move the active cell right, then keep typing. */
19
+ onTab: () => void;
20
+ /** Commit and move the active cell down, then keep typing. */
21
+ onEnter: () => void;
22
+ /**
23
+ * Whether cancel and commit are on the toolbar. The studio's status bar carries both for any
24
+ * edit, so they are off unless a host without one asks.
25
+ */
26
+ showCancelCommit?: boolean;
27
+ /** Discard the edit. */
28
+ onCancel: () => void;
29
+ /** Keep the edit and stop. */
30
+ onCommit: () => void;
31
+ }
32
+ /**
33
+ * The row of entry buttons under the phone's formula bar, on the same surface as the studio
34
+ * toolbar: the three inputs (letters, numbers, date) at the left, then Tab and Enter, and cancel /
35
+ * commit at the right when {@link MobileInputToolbarProps.showCancelCommit} asks for them.
36
+ *
37
+ * @remarks
38
+ * Presentation only. The host owns the textarea and the session, so every action is a callback it
39
+ * runs inside the gesture, which is what lets the browser raise or switch the keyboard. Each input
40
+ * button opens its input: tapping one is never a no-op, whether or not a keyboard is already up.
41
+ */
42
+ export declare const MobileInputToolbar: React.MemoExoticComponent<(props: MobileInputToolbarProps) => React.ReactElement>;
43
+ //# sourceMappingURL=MobileInputToolbar.d.ts.map
@@ -1,3 +1,6 @@
1
1
  export type * from './IFormulaBar';
2
2
  export * from './FormulaBar';
3
+ export * from './MobileFormulaBar';
4
+ export * from './MobileInputToolbar';
5
+ export * from './useFormulaBarSession';
3
6
  //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,68 @@
1
+ import { default as React } from 'react';
2
+ import { IWorkbook, IWorksheet, ICell } from '@sheetxl/sdk';
3
+ import { CommandScopeSpec } from '@sheetxl/utils-react';
4
+ import { SheetEditable } from '@sheetxl/react';
5
+ /** The logical editor id both formula bar hosts park on the session (see `EditSession.setActiveEditorId`). */
6
+ export declare const FORMULA_BAR_EDITOR_ID = "formula-bar";
7
+ export interface FormulaBarSessionOptions {
8
+ /** The workbook whose active cell the bar follows. */
9
+ workbook: IWorkbook;
10
+ /** The shared cell editor; the bar is display-only without one. */
11
+ editable: SheetEditable | undefined;
12
+ /** A host-level disable, on top of cell protection and a read-only workbook. */
13
+ disabled?: boolean;
14
+ /**
15
+ * The line rhythm the host's editor box snaps to, in px. Handed to the input so a rendered line
16
+ * and a host row are the same height.
17
+ */
18
+ lineHeight: number;
19
+ /** The virtual keyboard a touch host asks for. */
20
+ inputMode?: React.TextareaHTMLAttributes<HTMLTextAreaElement>['inputMode'];
21
+ /** The action label of the virtual keyboard's Enter key. */
22
+ enterKeyHint?: React.TextareaHTMLAttributes<HTMLTextAreaElement>['enterKeyHint'];
23
+ /** Which side of the caret the function hint opens on; `'above'` for a bar at the bottom. */
24
+ hintPlacement?: 'below' | 'above';
25
+ }
26
+ export interface FormulaBarSession {
27
+ /**
28
+ * The selected worksheet, or `null` while the active tab is a sheet of another kind. The bar is
29
+ * then disabled and shows no cell.
30
+ */
31
+ sheet: IWorksheet | null;
32
+ /** The active cell's coordinates on {@link FormulaBarSession.sheet}. */
33
+ activeCoords: ICell.Coords;
34
+ /** The bar cannot start an edit: the host said so, the cell is protected or the workbook is read-only. */
35
+ disabled: boolean;
36
+ /** The live edit session, or `null` while idle. */
37
+ session: ReturnType<SheetEditable['getSession']>;
38
+ /** Whether an edit session is live. */
39
+ isEditing: boolean;
40
+ /** Cancel the live session. Does not move focus. */
41
+ cancel: () => void;
42
+ /** Commit the live session. Does not move focus. */
43
+ commit: () => void;
44
+ /**
45
+ * The `formula:editor` command scope, for the host's `CommandScopeProvider`. `null` without an
46
+ * editable.
47
+ */
48
+ editorSpec: CommandScopeSpec | null;
49
+ /**
50
+ * The editor element: the shared `EditorDiv` + cell input bound to the active cell and restyled as
51
+ * chrome text. The host places it in its own box. `null` without an editable.
52
+ */
53
+ cellEditor: React.ReactElement | null;
54
+ }
55
+ /**
56
+ * Everything a formula bar host shares with the other hosts: which cell the bar shows, whether it
57
+ * may edit, the live session on the shared editable, and the editor element itself.
58
+ *
59
+ * @remarks
60
+ * A formula bar host is a box around the same input the in-grid editor renders, driving the same
61
+ * `SheetEditable`, so typing in either place is one edit. The hosts differ in chrome (a name box, a
62
+ * resize grip, how the ✕ / ✓ / fx buttons sit), not in behavior; this hook is the behavior.
63
+ *
64
+ * Ending a session from here does not return focus to the grid. That spans the bar and the grid,
65
+ * which only the studio owns (see the editable-session focus-restore effect in EagerStudio).
66
+ */
67
+ export declare const useFormulaBarSession: (options: FormulaBarSessionOptions) => FormulaBarSession;
68
+ //# sourceMappingURL=useFormulaBarSession.d.ts.map