@sheetxl/studio-mui 0.8.0-beta.1 → 0.8.0-beta.10

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 (243) hide show
  1. package/browser/esm/{Cd6n1XUgF0VItpkH.mjs → 5cbK03T_Oh3tNdR7.mjs} +7 -5
  2. package/browser/esm/{Bz5LiUe3SZ8g42Ia.mjs → 9eKCkvqpMQwqcXiw.mjs} +1 -1
  3. package/browser/esm/B1Yp_uy1vFHcJB3U.mjs +13 -0
  4. package/browser/esm/Biy7bhzzzPb5sfRN.mjs +152 -0
  5. package/browser/esm/Blaj2R5hYxtLAW__.mjs +117 -0
  6. package/browser/esm/{ChwS_ougBsogOEsP.mjs → ByeL_BZuJ2kl8gtf.mjs} +46 -47
  7. package/browser/esm/{BUGepznywvV0tUjW.mjs → C1Rp2hZrApo5MUc8.mjs} +2 -2
  8. package/browser/esm/{DMLXV4EKl1NCp_jk.mjs → CEvZe2cZK-voZTif.mjs} +5 -5
  9. package/browser/esm/{BZBJG2tDdD3-VujP.mjs → CIu1bjPJe_x31Oww.mjs} +195 -174
  10. package/browser/esm/COv-m-c2byCgvU3M.mjs +14861 -0
  11. package/browser/esm/CjznclrKqJRi7u9O.mjs +77 -0
  12. package/browser/esm/{Cj2pgCNqBCGl4rTX.mjs → CoSiOS-og0zFw4Ws.mjs} +587 -556
  13. package/browser/esm/{rU8xNPVQtDSnujM-.mjs → CtEFHbzYNvYjDYvi.mjs} +7 -7
  14. package/browser/esm/D6S8kVTzOjCn0-SK.mjs +627 -0
  15. package/browser/esm/{DNDrQKMTzKzNMjl-.mjs → D8al_cJ4U-NgzwoK.mjs} +1 -1
  16. package/browser/esm/DBtc4lku0uHVcqWn.mjs +71 -0
  17. package/browser/esm/{BoLxSRdEWt-Yg2RI.mjs → DHY19rkSiiRZxShC.mjs} +130 -103
  18. package/browser/esm/{zWTZ8BvT4hjgC2ua.mjs → DU3J8Gcf-WpBxNYg.mjs} +11 -10
  19. package/browser/esm/Die9NXVFveHvcCT-.mjs +4205 -0
  20. package/browser/esm/{CVfuCNRpODUw04IH.mjs → DmCQbW4zwkT_Rq88.mjs} +1 -1
  21. package/browser/esm/IQLeaAbtGTipUsOD.mjs +516 -0
  22. package/browser/esm/{3ydDykDMtDYbfVVn.mjs → X1Db3b_7b_7OuCk6.mjs} +178 -129
  23. package/browser/esm/fb126BNj3F8URR19.mjs +225 -0
  24. package/browser/esm/index.mjs +418 -135
  25. package/browser/esm/sFOAxZpxXo-qvDSp.mjs +293 -0
  26. package/browser/esm/sam1KGQZ59B_fADz.mjs +1941 -0
  27. package/browser/esm/xKiLJKiLxto8SayF.mjs +256 -0
  28. package/browser/esm/yZxC4qUENOlMhVUH.mjs +68 -0
  29. package/licenses/dependencies.txt +58 -311
  30. package/node/esm/B8SQfjKjzYHLxzZR.mjs +632 -0
  31. package/node/esm/{DM7K7-284z-PczVz.mjs → BYVLi0md4AYuDsB_.mjs} +1 -1
  32. package/node/esm/BYsG3KYVmxSe_CIQ.mjs +294 -0
  33. package/node/esm/BYwXhrEwkRAt9nJS.mjs +71 -0
  34. package/node/esm/B_jRGdwGFkudwmL-.mjs +68 -0
  35. package/node/esm/Bb1sLMqXWKjdve23.mjs +77 -0
  36. package/node/esm/{BwZcoHDBmLPIVOT5.mjs → BcwMb6CyVfvEwbHn.mjs} +69 -70
  37. package/node/esm/{BhqI3pQFkV8K_612.mjs → CKu1AtRgyltyEdEN.mjs} +1 -1
  38. package/node/esm/Cmt8Wv806N7NmE4Y.mjs +3344 -0
  39. package/node/esm/{DXZrzWee8K5FPOW1.mjs → D6oQL8knsPpgdXuk.mjs} +2 -2
  40. package/node/esm/{BA7VzUQ2sKRLTZ5c.mjs → D9rzScOA9pEYFrtz.mjs} +1 -1
  41. package/node/esm/DNSjK5DAH3M14Qbc.mjs +521 -0
  42. package/node/esm/{CUMKTjYv6VTkcWYi.mjs → DZzvTQxIKr9LbEsA.mjs} +1 -1
  43. package/node/esm/{Qpuqm6xBr_da38Ht.mjs → ETK6T6G0SIcFXDe5.mjs} +163 -135
  44. package/node/esm/ah3CUg4-VmNstGk_.mjs +256 -0
  45. package/node/esm/{CHi3AuWEwEPOg9IZ.mjs → ci8d-mF1H9wnYzix.mjs} +1 -1
  46. package/node/esm/cqzp431iNSLWictb.mjs +116 -0
  47. package/node/esm/index.mjs +14783 -6793
  48. package/package.json +15 -18
  49. package/resources/locales/de/groups.cmd.json +29 -16
  50. package/resources/locales/de/studio.cmd.json +18 -1
  51. package/resources/locales/de/ui.msg.json +350 -40
  52. package/resources/locales/en/groups.cmd.json +39 -17
  53. package/resources/locales/en/studio.cmd.json +18 -1
  54. package/resources/locales/en/ui.msg.json +306 -40
  55. package/types/src/anchorItems/AnchorItemsDescriptor.d.ts +17 -1
  56. package/types/src/anchorItems/AnchorItemsPanel.d.ts +14 -0
  57. package/types/src/anchorItems/AnchoredRangeField.d.ts +40 -0
  58. package/types/src/anchorItems/index.d.ts +1 -0
  59. package/types/src/border/BorderPopupButton.d.ts +6 -6
  60. package/types/src/border/BorderStylePopupButton.d.ts +3 -3
  61. package/types/src/border/BorderTemplateIcon.d.ts +24 -0
  62. package/types/src/border/index.d.ts +1 -0
  63. package/types/src/color/ColorPanel.d.ts +8 -2
  64. package/types/src/color/ColorPopupButton.d.ts +2 -1
  65. package/types/src/command/NumberFormatQuickButtons.d.ts +32 -0
  66. package/types/src/command/PresetCellStylesCommandButton.d.ts +3 -3
  67. package/types/src/command/SheetZoomCommandButton.d.ts +4 -3
  68. package/types/src/comments/CommentCard.d.ts +41 -0
  69. package/types/src/comments/CommentsPlugin.d.ts +6 -0
  70. package/types/src/comments/CommentsTaskPane.d.ts +23 -0
  71. package/types/src/comments/index.d.ts +4 -0
  72. package/types/src/conditionalFormat/ConditionalFormatStylePicker.d.ts +4 -4
  73. package/types/src/conditionalFormat/IconPickerPopupButton.d.ts +2 -2
  74. package/types/src/conditionalFormat/IconSetRulePanel.d.ts +1 -1
  75. package/types/src/conditions/BetweenOption.d.ts +6 -1
  76. package/types/src/conditions/CombinatorOption.d.ts +7 -0
  77. package/types/src/conditions/ConditionEditor.d.ts +61 -4
  78. package/types/src/conditions/ConditionUtils.d.ts +65 -6
  79. package/types/src/conditions/ExpressionOption.d.ts +12 -6
  80. package/types/src/conditions/MembershipOption.d.ts +67 -0
  81. package/types/src/conditions/OperatorAndParamEditor.d.ts +36 -1
  82. package/types/src/conditions/ScalarOption.d.ts +25 -6
  83. package/types/src/conditions/SelectorSelect.d.ts +16 -7
  84. package/types/src/conditions/index.d.ts +1 -1
  85. package/types/src/conditions/useFormulaOption.d.ts +54 -0
  86. package/types/src/dataValidation/DataValidationDetailsPanel.d.ts +7 -1
  87. package/types/src/dataValidation/DataValidationDetailsTaskPane.d.ts +3 -2
  88. package/types/src/dataValidation/DataValidationEditorPanel.d.ts +13 -2
  89. package/types/src/dataValidation/DataValidationIcon.d.ts +22 -0
  90. package/types/src/dataValidation/DataValidationTitle.d.ts +13 -0
  91. package/types/src/dialog/FillSeriesDialog.d.ts +16 -0
  92. package/types/src/dialog/OutlineSettingsDialog.d.ts +12 -0
  93. package/types/src/dialog/TableNewDialog.d.ts +1 -4
  94. package/types/src/dialog/_ShortcutSearch.d.ts +26 -0
  95. package/types/src/dialog/index.d.ts +0 -2
  96. package/types/src/externalLink/ExternalLinkCardBody.d.ts +9 -0
  97. package/types/src/externalLink/ExternalLinkChip.d.ts +18 -0
  98. package/types/src/externalLink/ExternalLinkLocation.d.ts +18 -0
  99. package/types/src/externalLink/ExternalLinkSettingsTab.d.ts +18 -0
  100. package/types/src/externalLink/ExternalLinksPanel.d.ts +11 -0
  101. package/types/src/externalLink/ExternalLinksPlugin.d.ts +5 -0
  102. package/types/src/externalLink/ExternalLinksTaskPane.d.ts +19 -0
  103. package/types/src/externalLink/index.d.ts +8 -0
  104. package/types/src/fill/GradientEditor.d.ts +41 -0
  105. package/types/src/fill/GradientStopsBar.d.ts +43 -0
  106. package/types/src/fill/PatternPopupButton.d.ts +26 -0
  107. package/types/src/fill/PatternSwatch.d.ts +53 -0
  108. package/types/src/fill/index.d.ts +5 -0
  109. package/types/src/filter/ColumnMenu.d.ts +31 -1
  110. package/types/src/filter/index.d.ts +0 -1
  111. package/types/src/form/FormulaField.d.ts +35 -6
  112. package/types/src/form/InputField.d.ts +35 -5
  113. package/types/src/format/AlignmentPanel.d.ts +13 -0
  114. package/types/src/format/BorderPanel.d.ts +22 -0
  115. package/types/src/format/BorderPreview.d.ts +94 -0
  116. package/types/src/format/FillPanel.d.ts +65 -0
  117. package/types/src/format/FontPanel.d.ts +12 -0
  118. package/types/src/format/FormatCellPreview.d.ts +35 -0
  119. package/types/src/format/FormatPanelParts.d.ts +85 -0
  120. package/types/src/format/FormatPlugin.d.ts +11 -0
  121. package/types/src/format/FormatTaskPane.d.ts +39 -0
  122. package/types/src/format/LinePanel.d.ts +53 -0
  123. package/types/src/format/LinePreviews.d.ts +71 -0
  124. package/types/src/format/NumberFormatOption.d.ts +43 -0
  125. package/types/src/{numberFormat → format}/NumberFormatPanel.d.ts +20 -0
  126. package/types/src/format/index.d.ts +14 -0
  127. package/types/src/format/useFormatSelection.d.ts +93 -0
  128. package/types/src/formulaBar/IFormulaBar.d.ts +11 -0
  129. package/types/src/formulaBar/MobileFormulaBar.d.ts +21 -0
  130. package/types/src/formulaBar/MobileInputToolbar.d.ts +37 -0
  131. package/types/src/formulaBar/index.d.ts +3 -0
  132. package/types/src/formulaBar/useFormulaBarSession.d.ts +65 -0
  133. package/types/src/index.d.ts +7 -1
  134. package/types/src/itemsPanel/EditorCommit.d.ts +32 -0
  135. package/types/src/itemsPanel/EditorPanel.d.ts +4 -1
  136. package/types/src/itemsPanel/ItemCard.d.ts +60 -8
  137. package/types/src/itemsPanel/ItemsDescriptor.d.ts +68 -19
  138. package/types/src/itemsPanel/ItemsPanel.d.ts +9 -0
  139. package/types/src/itemsPanel/ItemsSearchField.d.ts +17 -0
  140. package/types/src/itemsPanel/index.d.ts +2 -0
  141. package/types/src/named/NamedDetailsPanel.d.ts +9 -2
  142. package/types/src/named/NamedDetailsTaskPane.d.ts +3 -2
  143. package/types/src/named/NamedEditorPanel.d.ts +1 -1
  144. package/types/src/named/NamedExpressionField.d.ts +32 -0
  145. package/types/src/named/NamedKindChip.d.ts +38 -0
  146. package/types/src/picture/PicturePlugin.d.ts +6 -0
  147. package/types/src/picture/index.d.ts +2 -0
  148. package/types/src/protectedRange/ProtectedRangeDetailsPanel.d.ts +6 -0
  149. package/types/src/protectedRange/ProtectedRangeDraft.d.ts +22 -0
  150. package/types/src/protectedRange/ProtectedRangeEditorPanel.d.ts +0 -14
  151. package/types/src/protectedRange/index.d.ts +2 -1
  152. package/types/src/protection/ManageProtectionTaskPane.d.ts +29 -0
  153. package/types/src/protection/PasswordDialog.d.ts +32 -0
  154. package/types/src/protection/PasswordField.d.ts +35 -0
  155. package/types/src/protection/ProtectedCellsPanel.d.ts +20 -0
  156. package/types/src/protection/ProtectionPlugin.d.ts +11 -0
  157. package/types/src/protection/SheetProtectionPanel.d.ts +35 -0
  158. package/types/src/protection/WorkbookProtectionPanel.d.ts +34 -15
  159. package/types/src/protection/WorkbookProtectionTab.d.ts +22 -0
  160. package/types/src/protection/index.d.ts +7 -1
  161. package/types/src/shape/InsertShapeCommandButton.d.ts +20 -0
  162. package/types/src/shape/ShapeFormatPanel.d.ts +11 -0
  163. package/types/src/shape/ShapePlugin.d.ts +6 -0
  164. package/types/src/shape/index.d.ts +3 -0
  165. package/types/src/slicer/PresetSlicerStylesCommandButton.d.ts +18 -0
  166. package/types/src/slicer/SlicerPlugin.d.ts +6 -0
  167. package/types/src/slicer/index.d.ts +3 -0
  168. package/types/src/statusBar/SheetZoomScale.d.ts +6 -0
  169. package/types/src/studio/CommandsWrapper.d.ts +5 -0
  170. package/types/src/studio/EagerStudio.d.ts +14 -1
  171. package/types/src/studio/StudioCommandProvider.d.ts +10 -0
  172. package/types/src/studio/StudioCommands.d.ts +40 -4
  173. package/types/src/studio/StudioProps.d.ts +64 -2
  174. package/types/src/studio/StudioSplitPane.d.ts +1 -1
  175. package/types/src/studio/formulaBarPlacement.d.ts +35 -0
  176. package/types/src/studio/splitStudioProps.d.ts +7 -0
  177. package/types/src/studio/useStudioApp.d.ts +31 -18
  178. package/types/src/template/TemplateCommands.d.ts +29 -0
  179. package/types/src/template/TemplateDialog.d.ts +19 -0
  180. package/types/src/template/TemplatePanel.d.ts +50 -0
  181. package/types/src/template/TemplateSearchField.d.ts +29 -0
  182. package/types/src/template/WelcomeDialog.d.ts +29 -0
  183. package/types/src/template/categoryColor.d.ts +8 -0
  184. package/types/src/template/index.d.ts +3 -0
  185. package/types/src/template/useTemplateCatalog.d.ts +71 -0
  186. package/types/src/toolbar/WorkbookToolbars.d.ts +1 -1
  187. package/types/src/workbook/DefaultRenderers.d.ts +15 -1
  188. package/types/src/workbook/FillMenu.d.ts +21 -0
  189. package/types/src/workbook/OutlineButtons.d.ts +11 -0
  190. package/types/src/workbook/WorkbookElement.d.ts +1 -1
  191. package/types/src/workbook/index.d.ts +1 -0
  192. package/browser/cjs/BQJKf40kttQWOzLw.cjs +0 -20
  193. package/browser/cjs/BTZ5uzK0wHzpiZGC.cjs +0 -1
  194. package/browser/cjs/B_D3JKseVvpRyX-E.cjs +0 -1
  195. package/browser/cjs/BeKpqOx8It0RD0Rf.cjs +0 -2
  196. package/browser/cjs/Bj-EvSYeDfqmU0V6.cjs +0 -2
  197. package/browser/cjs/Bo9Kx3L_XQkGPBJ5.cjs +0 -1
  198. package/browser/cjs/Bte6P3MhSjajJmmY.cjs +0 -7
  199. package/browser/cjs/C97KHSuikAbr1qVM.cjs +0 -1
  200. package/browser/cjs/CJLwX_A3y3TQUmzj.cjs +0 -1
  201. package/browser/cjs/CPSc2VSYZeZ1B9mi.cjs +0 -1
  202. package/browser/cjs/CPcBvw4ZPwHVTUZF.cjs +0 -1
  203. package/browser/cjs/CYxc8vnRi8dNpDPk.cjs +0 -1
  204. package/browser/cjs/CZm1jVZaHQ246prW.cjs +0 -1
  205. package/browser/cjs/CdDYyAfccXme8w6m.cjs +0 -1
  206. package/browser/cjs/Cm1APq2MraYNNhyI.cjs +0 -1
  207. package/browser/cjs/DO8V31Z1ewgMA1di.cjs +0 -5
  208. package/browser/cjs/Djsiad0Qha1Y-YaS.cjs +0 -1
  209. package/browser/cjs/IASAYG6qgv7lJY7y.cjs +0 -1
  210. package/browser/cjs/KZvriGbhEOVkQD0b.cjs +0 -1
  211. package/browser/cjs/UnMhi28mbvLiOXQe.cjs +0 -1
  212. package/browser/cjs/Vbigo0kFP3PFfmeA.cjs +0 -1
  213. package/browser/cjs/iMWEL01eC83oU-YY.cjs +0 -1
  214. package/browser/cjs/index.cjs +0 -2
  215. package/browser/cjs/w2GjebPlOFv3pCbm.cjs +0 -1
  216. package/browser/cjs/z0rB4fK6X1M6PpVD.cjs +0 -11
  217. package/browser/cjs/zQsyZpeXAvcVXJMs.cjs +0 -1
  218. package/browser/esm/BuY3uV47Bwbqpasq.mjs +0 -219
  219. package/browser/esm/CAs1MWvJTcRfJy26.mjs +0 -217
  220. package/browser/esm/CBU3LgLYmqtQjJbu.mjs +0 -1150
  221. package/browser/esm/CDU0rqpLNVtMLI-f.mjs +0 -52
  222. package/browser/esm/CVBub6pgTsJzCc5m.mjs +0 -5429
  223. package/browser/esm/C_XvSsQ9BVdHffCO.mjs +0 -47
  224. package/browser/esm/FT29q8yNwsEpVZjt.mjs +0 -9257
  225. package/browser/esm/Hb1rlHT4tE5hLcjM.mjs +0 -82
  226. package/browser/esm/UJOXCQv6KrG1gY3l.mjs +0 -105
  227. package/browser/esm/s46El7mT6oKLSnYB.mjs +0 -411
  228. package/node/esm/9FY82fj1R1c-AczW.mjs +0 -47
  229. package/node/esm/C-boHCnJditFzng3.mjs +0 -106
  230. package/node/esm/DxXM8qHi0Oz4Zovl.mjs +0 -4575
  231. package/node/esm/sQt2wWGTRLzqeJdG.mjs +0 -82
  232. package/node/esm/yCHAZKxJR7qY_ySy.mjs +0 -470
  233. package/types/src/conditionalFormat/ConditionalFormatRangeField.d.ts +0 -32
  234. package/types/src/conditions/DateTimeOption.d.ts +0 -43
  235. package/types/src/conditions/InSetOption.d.ts +0 -37
  236. package/types/src/dialog/CommentsDialog.d.ts +0 -11
  237. package/types/src/dialog/NumberFormatDialog.d.ts +0 -12
  238. package/types/src/filter/FilterList.d.ts +0 -28
  239. package/types/src/numberFormat/NumberFormatTaskPane.d.ts +0 -12
  240. package/types/src/numberFormat/index.d.ts +0 -8
  241. package/types/src/protectedRange/ProtectedRangeDetailsTaskPane.d.ts +0 -3
  242. package/types/src/protectedRange/ProtectedRangePlugin.d.ts +0 -2
  243. package/types/src/protection/WorkbookProtectionDialog.d.ts +0 -23
@@ -1,12 +1,12 @@
1
1
  import { default as React } from 'react';
2
- import { IColor, IBorder } from '@sheetxl/sdk';
2
+ import { IColor, IBorders } from '@sheetxl/sdk';
3
3
  import { ExhibitPopupIconButtonProps } from '@sheetxl/utils-mui';
4
4
  export interface BorderPopupButtonProps extends Omit<ExhibitPopupIconButtonProps, "color" | "icon" | "createPopupPanel"> {
5
- selectedBorder: Partial<IBorder.Properties>;
5
+ selectedBorder: Partial<IBorders.Properties>;
6
6
  /**
7
7
  * Create a border.
8
8
  */
9
- createBorder: (props: Partial<IBorder.Properties>) => IBorder;
9
+ createBorder: (props: Partial<IBorders.Properties>) => IBorders;
10
10
  /**
11
11
  * For color picker.
12
12
  */
@@ -21,10 +21,10 @@ export interface BorderPopupButtonProps extends Omit<ExhibitPopupIconButtonProps
21
21
  /**
22
22
  * If no values are specified
23
23
  */
24
- autoStrokeStyle?: IBorder.StrokeStyle;
24
+ autoStrokeStyle?: IBorders.StrokeStyle;
25
25
  showStylingBefore?: boolean;
26
- onSelectBorder?: (border: Partial<IBorder.Properties> | null) => void;
27
- onPreviewBorder?: (border: Partial<IBorder.Properties> | null) => void;
26
+ onSelectBorder?: (border: Partial<IBorders.Properties> | null) => void;
27
+ onPreviewBorder?: (border: Partial<IBorders.Properties> | null) => void;
28
28
  }
29
29
  export declare const BorderPopupButton: React.NamedExoticComponent<Omit<BorderPopupButtonProps, "ref"> & React.RefAttributes<HTMLElement>>;
30
30
  //# sourceMappingURL=BorderPopupButton.d.ts.map
@@ -1,10 +1,10 @@
1
1
  import { default as React } from 'react';
2
- import { IBorder, IColor } from '@sheetxl/sdk';
2
+ import { IBorders, IColor } from '@sheetxl/sdk';
3
3
  import { PopupButtonType, ExhibitPopupButtonProps } from '@sheetxl/utils-mui';
4
4
  import { SvgIconProps } from '@mui/material';
5
5
  export interface BorderStylePopupButtonProps extends ExhibitPopupButtonProps {
6
- selectedStyle: IBorder.StrokeStyle;
7
- onSelectStyle?: (style: IBorder.StrokeStyle | null) => void;
6
+ selectedStyle: IBorders.StrokeStyle;
7
+ onSelectStyle?: (style: IBorders.StrokeStyle | null) => void;
8
8
  /**
9
9
  * Rendering styles
10
10
  * @defaultValue to Toolbar
@@ -0,0 +1,24 @@
1
+ import { default as React } from 'react';
2
+ import { IBorders } from '@sheetxl/sdk';
3
+ export interface BorderTemplateIconProps {
4
+ /**
5
+ * The border this icon stands for — the edges a click would draw, with the style and color it
6
+ * would draw them in. `null`, or an all-`None` border, is the empty grid.
7
+ */
8
+ border: Partial<IBorders.Properties> | null;
9
+ /** Mints the per-cell border the renderer draws. */
10
+ createBorder: (properties: Partial<IBorders.Properties>) => IBorders | null;
11
+ }
12
+ /**
13
+ * A border button's icon: a 5x5 grid of dots with the border itself drawn across it.
14
+ *
15
+ * @remarks
16
+ * The lines are a real {@link StaticBorderRenderer} fed the same strokes the click would write, so
17
+ * every one of these buttons previews its own edit — the current line style and color included.
18
+ * The dots are the cells, and they are drawn only where no line covers them.
19
+ */
20
+ export declare const BorderTemplateIcon: {
21
+ (props: BorderTemplateIconProps): React.ReactElement;
22
+ displayName: string;
23
+ };
24
+ //# sourceMappingURL=BorderTemplateIcon.d.ts.map
@@ -1,3 +1,4 @@
1
1
  export * from './BorderPopupButton';
2
2
  export * from './BorderStylePopupButton';
3
+ export * from './BorderTemplateIcon';
3
4
  //# sourceMappingURL=index.d.ts.map
@@ -17,7 +17,8 @@ export interface ColorPanelProps extends React.HTMLAttributes<HTMLElement> {
17
17
  */
18
18
  disableAlpha?: boolean;
19
19
  darkMode?: boolean;
20
- selectedColor: IColor;
20
+ /** `null` means no color of its own — the AUTO swatch is the selected one. */
21
+ selectedColor: IColor | null;
21
22
  previewColor?: IColor | null;
22
23
  onSelectColor?: (color: IColor | null, isCustom: boolean) => void;
23
24
  onPreviewColor?: (color: IColor | null) => void;
@@ -27,8 +28,13 @@ export interface ColorPanelProps extends React.HTMLAttributes<HTMLElement> {
27
28
  * If autoColor is set then a special Swatch is created that will
28
29
  * use this color. When it is selected or previewed the color
29
30
  * passed will be null any consumer will then know to use the auto color
31
+ *
32
+ * @remarks
33
+ * `null` means there is no automatic value to offer — distinct from omitting it, which lets a
34
+ * command's own context supply one. A picker that has already committed to a concrete fill has
35
+ * nothing sensible to put behind an "automatic" swatch.
30
36
  */
31
- autoColor?: IColor;
37
+ autoColor?: IColor | null;
32
38
  /**
33
39
  * If autoColor is specified then a label will be shown.
34
40
  * This is ignored if autoColor is not specified.
@@ -3,7 +3,8 @@ import { IColor } from '@sheetxl/sdk';
3
3
  import { PopupButtonType, ExhibitPopupIconButtonProps } from '@sheetxl/utils-mui';
4
4
  import { ColorPanelProps } from './ColorPanel';
5
5
  export interface ColorPopupButtonProps extends Omit<ExhibitPopupIconButtonProps, "color" | "createPopupPanel"> {
6
- selectedColor: IColor;
6
+ /** `null` means no color of its own — the AUTO swatch is the selected one. */
7
+ selectedColor: IColor | null;
7
8
  onSelectColor?: (color: IColor | null, isCustom: boolean) => void;
8
9
  onPreviewColor?: (color: IColor | null) => void;
9
10
  onPreviewColorImmediate?: (color: IColor | null) => void;
@@ -0,0 +1,32 @@
1
+ import { default as React } from 'react';
2
+ import { Theme, SxProps } from '@mui/material';
3
+ /**
4
+ * The registry key the number-format popup is registered under — and the scope its members' labels
5
+ * resolve against: `formatCells` reads as "More Number Formats…" there, "Format Cells" elsewhere,
6
+ * and the quick buttons below resolve their compact labels against it.
7
+ */
8
+ export declare const NUMBER_FORMAT_GROUP_KEY = "numberFormatOptions";
9
+ export interface NumberFormatQuickButtonsProps extends React.HTMLAttributes<HTMLDivElement> {
10
+ /**
11
+ * The render surface, for scoped command chrome (the compact labels).
12
+ * @defaultValue {@link NUMBER_FORMAT_GROUP_KEY}
13
+ */
14
+ groupKey?: string;
15
+ /** Force every button off, on top of each command's own state. */
16
+ disabled?: boolean;
17
+ /**
18
+ * MUI SX props {@link https://mui.com/system/getting-started/the-sx-prop/}
19
+ */
20
+ sx?: SxProps<Theme>;
21
+ }
22
+ /**
23
+ * The five one-click number formats — accounting, percent, comma, and the two decimal nudges.
24
+ *
25
+ * @remarks
26
+ * Shared by the toolbar's number-format popup and the format pane's Number tab, which are the same
27
+ * five commands either way. They act on the current selection through their commands rather than
28
+ * through a host's own value channel, so a host that edits something *other* than the selection
29
+ * (a dialog with its own target) should leave them out.
30
+ */
31
+ export declare const NumberFormatQuickButtons: React.NamedExoticComponent<NumberFormatQuickButtonsProps & React.RefAttributes<HTMLDivElement>>;
32
+ //# sourceMappingURL=NumberFormatQuickButtons.d.ts.map
@@ -1,10 +1,10 @@
1
1
  import { default as React } from 'react';
2
- import { IStyle } from '@sheetxl/sdk';
2
+ import { ICellStyle } from '@sheetxl/sdk';
3
3
  import { CommandPopupButtonProps } from '@sheetxl/utils-mui';
4
4
  export interface PresetCellStylesCommandButtonProps extends CommandPopupButtonProps {
5
5
  commandKey: string;
6
- selectedNamed?: IStyle.INamed;
7
- onSelectNamed?: (style: IStyle.INamed) => void;
6
+ selectedNamed?: ICellStyle.INamed;
7
+ onSelectNamed?: (style: ICellStyle.INamed) => void;
8
8
  usePreviewIcon?: boolean;
9
9
  }
10
10
  export declare const PresetCellStylesCommandButton: React.NamedExoticComponent<Omit<PresetCellStylesCommandButtonProps, "ref"> & React.RefAttributes<HTMLElement>>;
@@ -1,9 +1,10 @@
1
1
  import { default as React } from 'react';
2
2
  import { CommandPopupButtonProps } from '@sheetxl/utils-mui';
3
3
  /**
4
- * Zoom-level split button for the status bar. Like the `textRotateOptions` group: the popup lists the
5
- * preset levels + a custom input, while the quick button always executes `sheetZoom100` yet *displays*
6
- * the current zoom scale.
4
+ * Zoom-level split button, shared by the status bar and the View toolbar. Like the `textRotateOptions`
5
+ * group: the popup lists the preset levels + a custom input, while the quick button always executes
6
+ * `sheetZoom100` yet *displays* the current zoom scale. The percent text is styled as a toolbar label;
7
+ * a denser surface restyles it through the `zoom-percent` class and drops the outline (see `SheetZoomScale`).
7
8
  */
8
9
  export declare const SheetZoomCommandButton: React.NamedExoticComponent<Omit<CommandPopupButtonProps<any, any>, "ref"> & React.RefAttributes<HTMLElement>>;
9
10
  //# sourceMappingURL=SheetZoomCommandButton.d.ts.map
@@ -0,0 +1,41 @@
1
+ import { default as React } from 'react';
2
+ import { CellCoords } from '@sheetxl/utils';
3
+ import { IComment, ISheet } from '@sheetxl/sdk';
4
+ export interface CommentCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onSelect'> {
5
+ /** The sheet the card's cell is on. */
6
+ sheet: ISheet;
7
+ /** The cell the card belongs to. */
8
+ coords: CellCoords;
9
+ /** The thread, or `null` for a draft: nothing is written until it is posted. */
10
+ comment: IComment | null;
11
+ /**
12
+ * A new value each time the card's text should take the caret: the draft's field, or the reply
13
+ * box of a thread. `0` or omitted for never.
14
+ */
15
+ focusRequest?: number;
16
+ /** Marks the card as the one for the selected cell. */
17
+ highlighted?: boolean;
18
+ /** Draws the card raised, for one that floats over the grid. */
19
+ elevated?: boolean;
20
+ /**
21
+ * A click on the card's surface, anywhere that is not a control. Omit when there is nothing to
22
+ * select.
23
+ */
24
+ onSelect?: () => void;
25
+ /** The draft was cancelled. */
26
+ onClose?: () => void;
27
+ /** The draft was posted, as this comment. */
28
+ onPosted?: (comment: IComment) => void;
29
+ ref?: React.Ref<HTMLDivElement>;
30
+ }
31
+ /**
32
+ * One threaded comment as a card: each entry's initials, author, time and text, the replies, a
33
+ * reply box, and a menu to edit, resolve or delete. With no comment it is a draft, a field that
34
+ * writes nothing until it is posted.
35
+ *
36
+ * @remarks
37
+ * The same card is listed in the comments task pane and floats beside a cell. Editing an entry's
38
+ * text drops its mentions, as `IComment.setContent` says.
39
+ */
40
+ export declare const CommentCard: React.MemoExoticComponent<(props: CommentCardProps) => React.JSX.Element>;
41
+ //# sourceMappingURL=CommentCard.d.ts.map
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Registers the **Comments** pane, which `showCommentsPane` opens and `updateComments` writes in
3
+ * while it is showing.
4
+ */
5
+ export declare const CommentsPlugin: () => void;
6
+ //# sourceMappingURL=CommentsPlugin.d.ts.map
@@ -0,0 +1,23 @@
1
+ import { default as React } from 'react';
2
+ import { IWorkbook } from '@sheetxl/sdk';
3
+ import { CommentsPaneArgs, TaskPaneProps } from '@sheetxl/react';
4
+ /** Which threads the pane lists. */
5
+ export type CommentsFilter = 'all' | 'open' | 'resolved';
6
+ /** Persistence key for the filter the pane was last left on. */
7
+ export declare const COMMENTS_FILTER_KEY = "comments.filter";
8
+ export interface CommentsTaskPaneProps extends TaskPaneProps<IWorkbook, CommentsPaneArgs> {
9
+ /** The filter the pane opens with when none has been chosen before. @defaultValue `'all'` */
10
+ defaultFilter?: CommentsFilter;
11
+ }
12
+ /**
13
+ * **Comments** — every threaded comment on the active sheet, in cell order, each as a
14
+ * {@link CommentCard}.
15
+ *
16
+ * @remarks
17
+ * Clicking a card selects its cell, and selecting a cell scrolls to its card and marks it. A new
18
+ * comment is a draft card on the selected cell that writes nothing until it is posted. Notes are
19
+ * not listed: a note is edited in its box on the sheet.
20
+ */
21
+ export declare const CommentsTaskPane: React.MemoExoticComponent<(props: CommentsTaskPaneProps) => React.JSX.Element | null>;
22
+ export default CommentsTaskPane;
23
+ //# sourceMappingURL=CommentsTaskPane.d.ts.map
@@ -0,0 +1,4 @@
1
+ export * from './CommentCard';
2
+ export * from './CommentsTaskPane';
3
+ export * from './CommentsPlugin';
4
+ //# sourceMappingURL=index.d.ts.map
@@ -1,5 +1,5 @@
1
1
  import { default as React } from 'react';
2
- import { IStyle } from '@sheetxl/sdk';
2
+ import { ICellStyle } from '@sheetxl/sdk';
3
3
  export interface ConditionalFormatStylePickerProps extends React.HTMLAttributes<HTMLDivElement> {
4
4
  /**
5
5
  * The rule's dxf. A differential format — only the properties the user touched are present.
@@ -8,11 +8,11 @@ export interface ConditionalFormatStylePickerProps extends React.HTMLAttributes<
8
8
  * Named `format` (not `style`) because this interface extends the DOM attributes, where `style`
9
9
  * is already the CSS prop.
10
10
  */
11
- format: IStyle.Properties | null;
11
+ format: ICellStyle.Properties | null;
12
12
  /**
13
13
  * Called with the replacement dxf; `null` clears every override.
14
14
  */
15
- onFormatChange: (format: IStyle.Properties | null) => void;
15
+ onFormatChange: (format: ICellStyle.Properties | null) => void;
16
16
  readOnly?: boolean;
17
17
  }
18
18
  /**
@@ -24,7 +24,7 @@ export interface ConditionalFormatStylePickerProps extends React.HTMLAttributes<
24
24
  * offer, not a separate verb — and as a toolbar `✕` it read as *close*.
25
25
  *
26
26
  * @remarks
27
- * Reads and writes {@link IStyle.Properties} directly. Border is in the model but not in this
27
+ * Reads and writes {@link ICellStyle.Properties} directly. Border is in the model but not in this
28
28
  * toolbar (beyond the red-border preset); a full border editor belongs to the format dialog.
29
29
  *
30
30
  * There is no `AaBbCc` swatch here: the panel header and every rule card already paint the rule,
@@ -1,10 +1,10 @@
1
1
  import { default as React } from 'react';
2
- import { IStyle } from '@sheetxl/sdk';
2
+ import { ICellStyle } from '@sheetxl/sdk';
3
3
  import { ConditionalIconSpec } from '@sheetxl/react';
4
4
  import { ExhibitPopupIconButtonProps } from '@sheetxl/utils-mui';
5
5
  /** Where a band's icon comes from: a set and an index into it. */
6
6
  export type IconAddress = {
7
- set: IStyle.IconSet;
7
+ set: ICellStyle.IconSet;
8
8
  id: number;
9
9
  };
10
10
  export interface IconPickerPopupButtonProps extends Omit<ExhibitPopupIconButtonProps, 'icon' | 'createPopupPanel'> {
@@ -11,7 +11,7 @@ export interface IconSetRulePanelProps extends React.HTMLAttributes<HTMLDivEleme
11
11
  * none) and its threshold.
12
12
  *
13
13
  * @remarks
14
- * The gallery offers exactly the sets `IStyle.IconSet` names, so a rule authored here always
14
+ * The gallery offers exactly the sets `ICellStyle.IconSet` names, so a rule authored here always
15
15
  * round-trips — including the three Excel 2010 sets that can only be written into the x14
16
16
  * extension. A set name adopted from a file that is none of them is shown by name and left as it
17
17
  * is; picking any preset replaces it.
@@ -9,6 +9,11 @@ export interface BetweenProps extends BoxProps {
9
9
  * The callback function to handle changes in the between option.
10
10
  */
11
11
  onOptionChange: (option: ICondition.BetweenOption) => void;
12
+ /**
13
+ * The selector the bounds are compared under. A date or time selector has its bounds typed and
14
+ * shown as dates or times.
15
+ */
16
+ selector?: ICondition.ISelector | null;
12
17
  /**
13
18
  * If true, makes the editor read-only.
14
19
  */
@@ -18,7 +23,7 @@ export interface BetweenProps extends BoxProps {
18
23
  * Component for editing between option (between two values).
19
24
  *
20
25
  * @remarks
21
- * Each bound is a literal or a `=`-prefixed formula, independently — Excel's own between boxes —
26
+ * Each bound is a literal or a formula, independently — Excel's own between boxes —
22
27
  * so both sides take the literal-or-formula field ({@link ScalarOption}).
23
28
  */
24
29
  export declare const BetweenOption: import('react').NamedExoticComponent<BetweenProps>;
@@ -1,6 +1,7 @@
1
1
  import { default as React } from 'react';
2
2
  import { ICondition } from '@sheetxl/sdk';
3
3
  import { CombinatorInput } from './ConditionUtils';
4
+ import { MembershipItemsProvider, MembershipOptionProps } from './MembershipOption';
4
5
  export interface CombinatorOptionProps extends React.HTMLAttributes<HTMLDivElement> {
5
6
  /**
6
7
  * The combinator operator (and / or / not).
@@ -23,6 +24,12 @@ export interface CombinatorOptionProps extends React.HTMLAttributes<HTMLDivEleme
23
24
  * The selector (passed down to children).
24
25
  */
25
26
  selector: ICondition.ISelector | null;
27
+ /** The items provider for an `InSet` checklist, passed down to children. */
28
+ getItems?: MembershipItemsProvider;
29
+ /** Passed down to an `InSet` checklist. */
30
+ propsChecklist?: MembershipOptionProps['propsChecklist'];
31
+ /** The root condition's Ignore Blank, passed down to an `InSet` checklist. */
32
+ ignoreBlank?: boolean;
26
33
  /**
27
34
  * If true, makes the editor read-only.
28
35
  */
@@ -1,5 +1,18 @@
1
1
  import { default as React } from 'react';
2
- import { ICondition } from '@sheetxl/sdk';
2
+ import { SxProps, Theme } from '@mui/material';
3
+ import { ICondition, ICellRanges } from '@sheetxl/sdk';
4
+ import { RemoveButtonProps } from './OperatorAndParamEditor';
5
+ import { MembershipItemsProvider, MembershipOptionProps } from './MembershipOption';
6
+ /**
7
+ * The frame a host draws around a {@link ConditionEditor}: a rounded, faintly filled box the rule
8
+ * card sits in. The host adds its own padding (a pane's is wider than a menu's).
9
+ */
10
+ export declare const SxConditionEditorFrame: {
11
+ readonly backgroundColor: "action.hover";
12
+ readonly border: 1;
13
+ readonly borderColor: "divider";
14
+ readonly borderRadius: 1;
15
+ };
3
16
  export interface ConditionEditorProps extends React.HTMLAttributes<HTMLDivElement> {
4
17
  /**
5
18
  * The condition.
@@ -18,12 +31,19 @@ export interface ConditionEditorProps extends React.HTMLAttributes<HTMLDivElemen
18
31
  */
19
32
  selectorTitle?: string;
20
33
  /**
21
- * If 'true', shows the "Include Blanks".
34
+ * Whether the "Ignore Blank" checkbox is shown. It is the condition's `includeBlanks`: checked,
35
+ * a blank is never judged, under every host. A host whose list carries the `(Blank)` row may
36
+ * hide it.
22
37
  *
23
- * @remarks
24
- * @see {@link ICondition.isIncludeBlanks} for when this should be used.
38
+ * @defaultValue `true`
39
+ * @see {@link ICondition.isIncludeBlanks}
25
40
  */
26
41
  showIncludeBlanks?: boolean;
42
+ /**
43
+ * The host's own settings for the rule, shown on the Ignore Blank row after it: a validation's
44
+ * In-cell dropdown. Shown whether or not Ignore Blank is.
45
+ */
46
+ qualifiers?: React.ReactNode;
27
47
  /**
28
48
  * If true, makes the editor read-only.
29
49
  */
@@ -36,6 +56,43 @@ export interface ConditionEditorProps extends React.HTMLAttributes<HTMLDivElemen
36
56
  * The list of selectors to show. Defaults to all built-in selectors.
37
57
  */
38
58
  selectors?: ICondition.ISelector[];
59
+ /**
60
+ * The cells the condition covers, so a selector's default can fit them (a List seeded with the
61
+ * values already there). See {@link ICondition.ISelector.getDefaultCondition}.
62
+ */
63
+ ranges?: ICellRanges | null;
64
+ /**
65
+ * The items an `InSet` may be chosen from (a filter's column). With it `InSet` is offered and
66
+ * edited as a checklist of those items, whatever the selector.
67
+ */
68
+ getItems?: MembershipItemsProvider;
69
+ /** Passed to the `InSet` checklist. */
70
+ propsChecklist?: MembershipOptionProps['propsChecklist'];
71
+ /**
72
+ * Whether the type (selector) row is shown. A filter's column has one type, so its menu hides it.
73
+ *
74
+ * @defaultValue `true`
75
+ */
76
+ showSelector?: boolean;
77
+ /**
78
+ * The label of the root rule's operator select. "When" reads as a sentence under a selector
79
+ * row ("Allow … When …"); a host with no selector row may pass `''` for the bare select.
80
+ * Nested rules keep their own labels ("and", "or").
81
+ *
82
+ * @defaultValue "When"
83
+ */
84
+ operatorTitle?: string;
85
+ /**
86
+ * The button that takes the root rule out, in place of the X. What that means is the host's: a
87
+ * validation or format pane clears its rule (the X), a filter has nothing to clear and passes
88
+ * `null` for no button. See {@link RemoveButtonProps}. Nested rules keep their X.
89
+ */
90
+ renderRemove?: ((props: RemoveButtonProps) => React.ReactElement | null) | null;
91
+ /**
92
+ * The box's own styles. The editor draws no surface or padding of its own: a pane that wants
93
+ * it framed gives it the frame; a menu lays it against its own edges.
94
+ */
95
+ sx?: SxProps<Theme>;
39
96
  }
40
97
  /**
41
98
  * Reusable condition editor with a type selector (single) and a recursive operator+param editor.
@@ -16,6 +16,9 @@ export declare const transferInputKey: (from: object, to: object) => void;
16
16
  * Internal data shape for a single child inside a combinator (AND/OR/NOT).
17
17
  */
18
18
  export interface CombinatorInput {
19
+ /** The child's own selector, when it reads the value differently from its parent (a file's
20
+ * `notEqual` is `not(Display + equalTo)`). Absent, the parent's selector reads for it. */
21
+ selector?: string | null;
19
22
  operator: string;
20
23
  param: any;
21
24
  }
@@ -24,6 +27,28 @@ export interface CombinatorInput {
24
27
  * predicate. A caller that does want them (AutoFilter) passes its own `exclude`.
25
28
  */
26
29
  export declare const DEFAULT_EXCLUDED_OPERATORS: readonly string[];
30
+ /**
31
+ * Marks `operator` to be listed first among its kind: a host's own name for the test its users
32
+ * reach for (a filter's "Values").
33
+ */
34
+ export declare const pinFirst: <T extends ICondition.IOperator>(operator: T) => T;
35
+ /**
36
+ * Marks `operator` to be listed under `title`, a section ahead of Basic in the order the
37
+ * operators are given: a host's own grouping of the tests its users look for first (a filter
38
+ * column's Number / Text / Date Filters, in Excel's order).
39
+ */
40
+ export declare const groupFirst: <T extends ICondition.IOperator>(operator: T, title: string) => T;
41
+ /**
42
+ * Orders operators by title in `language`, the pinned ones first, then the grouped ones in the
43
+ * order given (a stable sort keeps it), then the rest.
44
+ */
45
+ export declare const compareOperators: (language?: string) => (a: ICondition.IOperator, b: ICondition.IOperator) => number;
46
+ /**
47
+ * Whether `operator` can be asked about `selector`'s reading: it takes the selector's type, or
48
+ * any type, or tests the cell rather than the reading (`blank`, which is settled before any
49
+ * selector). No selector reads for every operator.
50
+ */
51
+ export declare const operatorReadsUnder: (selector: ICondition.ISelector | null, operator: ICondition.IOperator) => boolean;
27
52
  /**
28
53
  * Filters operators by selector type.
29
54
  *
@@ -47,11 +72,12 @@ exclude?: readonly string[]) => ICondition.IOperator[];
47
72
  * (it would freeze at mount-time language), so the subscription is threaded in.
48
73
  *
49
74
  * @remarks
50
- * Both sections are sorted alphabetically **in the active language** — operator titles are localized,
51
- * so the collation has to follow the UI language rather than the host default.
52
- * If only one section has operators the header and divider for the empty section are omitted.
53
- * Works with both MUI `Select` (which accepts `ListSubheader` children natively)
54
- * and custom popup panels.
75
+ * A host's own sections ({@link groupFirst}) come first, in the order the operators are given.
76
+ * Both of the sections after them are sorted alphabetically **in the active language** — operator
77
+ * titles are localized, so the collation has to follow the UI language rather than the host
78
+ * default. If only one section has operators the header and divider for the empty section are
79
+ * omitted. Works with both MUI `Select` (which accepts `ListSubheader` children natively) and
80
+ * custom popup panels.
55
81
  */
56
82
  export declare const buildOperatorMenuItems: (operators: ICondition.IOperator[], renderItem: (operator: ICondition.IOperator) => React.ReactNode, t: TranslateFn, language?: string) => React.ReactNode[];
57
83
  /**
@@ -66,8 +92,41 @@ export declare const buildOperatorMenuItems: (operators: ICondition.IOperator[],
66
92
  *
67
93
  * @param newOperator The operator being added/switched to.
68
94
  * @param operators The full list of available operators at this level (used to find the first leaf).
95
+ * @param context What the condition will apply to, for a leaf operator that fits its default
96
+ * to it (a list starts from the values already in the cells).
97
+ */
98
+ export declare const buildDefaultParam: (newOperator: ICondition.IOperator, operators: ICondition.IOperator[], selector?: ICondition.ISelector | null, context?: ICondition.DefaultConditionContext) => any;
99
+ /**
100
+ * An operator and its param, as the editor holds them.
101
+ */
102
+ export interface OperatorParam {
103
+ operator: string;
104
+ param: any;
105
+ }
106
+ export interface SelectorChange {
107
+ /** The selector being left. */
108
+ from: ICondition.ISelector | null;
109
+ /** The selector chosen. */
110
+ to: ICondition.ISelector | null;
111
+ /** What the condition holds now. */
112
+ current: OperatorParam | null;
113
+ /** What this edit last held under `to`, if it was visited before. */
114
+ remembered?: OperatorParam | null;
115
+ /** Every operator on offer, before filtering by selector. */
116
+ operators: ICondition.IOperator[];
117
+ /** Passed to {@link ICondition.ISelector.getDefaultCondition}. */
118
+ context?: ICondition.DefaultConditionContext;
119
+ }
120
+ /**
121
+ * The operator and param a condition holds once its selector changes.
122
+ *
123
+ * @remarks
124
+ * In order: what this edit last held under the new selector (so switching away and back loses
125
+ * nothing); else the current operator when it still applies (its param rebuilt if the value type
126
+ * changed); else the new selector's default. Only a selector with no default and no applicable
127
+ * operator yields `null`, the empty "add condition" state.
69
128
  */
70
- export declare const buildDefaultParam: (newOperator: ICondition.IOperator, operators: ICondition.IOperator[], selector?: ICondition.ISelector | null) => any;
129
+ export declare const resolveSelectorChange: (change: SelectorChange) => OperatorParam | null;
71
130
  export declare const SxListSubheader: {
72
131
  userSelect: string;
73
132
  lineHeight: string;
@@ -1,13 +1,14 @@
1
+ import { ICalculation } from '@sheetxl/sdk';
1
2
  import { FormulaFieldProps } from '../form';
2
3
  export interface ExpressionOptionProps extends Omit<FormulaFieldProps, 'value' | 'onChange'> {
3
4
  /**
4
- * The option to edit — the formula text, persisted as authored.
5
+ * The option to edit — the formula, or its text.
5
6
  */
6
- option: string;
7
+ option: ICalculation.IFormula | string;
7
8
  /**
8
9
  * The callback function to handle changes in the option.
9
10
  */
10
- onOptionChange: (option: string) => void;
11
+ onOptionChange: (option: ICalculation.IFormula | string) => void;
11
12
  /**
12
13
  * If true, makes the editor read-only.
13
14
  */
@@ -18,9 +19,14 @@ export interface ExpressionOptionProps extends Omit<FormulaFieldProps, 'value' |
18
19
  * (reference picking, token coloring, error line), not a text box.
19
20
  *
20
21
  * @remarks
21
- * Persists the authored TEXT rather than a parsed value: an expression param is stored as a
22
- * string on the condition, and an in-progress (momentarily invalid) formula must not cost the
23
- * user their keystrokes.
22
+ * The `=` is required, as in Excel's own Formula box. Text without one is not a literal here (an
23
+ * expression has no literal reading) and is refused rather than promoted, so the one rule holds
24
+ * under every operator: `=` means formula, and a Formula condition is nothing but one. The param
25
+ * carries no `=` on the wire; the field shows it and takes it.
26
+ *
27
+ * What is typed goes out as a formula compiled in the editing locale, so the condition stores it
28
+ * canonical. An in-progress (momentarily invalid) formula still carries the user's keystrokes.
29
+ * Text with no `=` reaches nothing, and holds the editor's Save back with its error showing.
24
30
  */
25
31
  export declare const ExpressionOption: import('react').NamedExoticComponent<ExpressionOptionProps>;
26
32
  //# sourceMappingURL=ExpressionOption.d.ts.map