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

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 (195) hide show
  1. package/browser/cjs/3k_KqDFr-AybPztc.cjs +5 -0
  2. package/browser/cjs/{zQsyZpeXAvcVXJMs.cjs → 3uprnzi2l0iT17Dg.cjs} +1 -1
  3. package/browser/cjs/B9GcCj7sj8XdjPZF.cjs +1 -0
  4. package/browser/cjs/{CJLwX_A3y3TQUmzj.cjs → BGvoJjUs21bbuE1i.cjs} +1 -1
  5. package/browser/cjs/{CYxc8vnRi8dNpDPk.cjs → BHb7TnK1NmimV4OX.cjs} +1 -1
  6. package/browser/cjs/BJ-wdkCaXqJaejKf.cjs +1 -0
  7. package/browser/cjs/BQMCM3iFn4MNWAkB.cjs +1 -0
  8. package/browser/cjs/BXkdjAb4jpTr412c.cjs +1 -0
  9. package/browser/cjs/Bc-YisjBtD56vBAW.cjs +1 -0
  10. package/browser/cjs/Bi26L7L89ZK_y5Pk.cjs +1 -0
  11. package/browser/cjs/CucKgy044KxMHXrx.cjs +13 -0
  12. package/browser/cjs/Cy_XmYq6BsWmCXkk.cjs +3 -0
  13. package/browser/cjs/Dq9lIOzvxW3EKYkD.cjs +8 -0
  14. package/browser/cjs/M0_dvdYwhikqP9kg.cjs +2 -0
  15. package/browser/cjs/QI6GKw7uo1f8gY8C.cjs +1 -0
  16. package/browser/cjs/eCw4rAEIYE3BftpG.cjs +1 -0
  17. package/browser/cjs/iFPhqab5w95hHEsT.cjs +1 -0
  18. package/browser/cjs/index.cjs +2 -2
  19. package/browser/esm/{zWTZ8BvT4hjgC2ua.mjs → 5g7MBAjbFzuopMX2.mjs} +2 -2
  20. package/browser/esm/B1W2xsRdzsYUrUHN.mjs +12903 -0
  21. package/browser/esm/{UJOXCQv6KrG1gY3l.mjs → B4D1LSp8TE_B0AMm.mjs} +8 -16
  22. package/browser/esm/{Bz5LiUe3SZ8g42Ia.mjs → B52mSQ33rrDgVfpp.mjs} +1 -1
  23. package/browser/esm/{DNDrQKMTzKzNMjl-.mjs → BPrlXHjf0rCkbBBI.mjs} +1 -1
  24. package/browser/esm/BZd916TsMZ7YvxWP.mjs +293 -0
  25. package/browser/esm/{Cd6n1XUgF0VItpkH.mjs → BaEXUwMO4qxI8cAG.mjs} +1 -1
  26. package/browser/esm/{CDU0rqpLNVtMLI-f.mjs → BbIR6fcRDFkeZXY0.mjs} +1 -1
  27. package/browser/esm/{CVBub6pgTsJzCc5m.mjs → BmThVkDnqURs7csb.mjs} +2100 -2214
  28. package/browser/esm/{CVfuCNRpODUw04IH.mjs → Bz1JPslneg_PywLn.mjs} +1 -1
  29. package/browser/esm/{rU8xNPVQtDSnujM-.mjs → CBtvZnCU5MNRuW6b.mjs} +3 -3
  30. package/browser/esm/CWSv0l0QyooaSl9L.mjs +268 -0
  31. package/browser/esm/{BUGepznywvV0tUjW.mjs → Cq9FaaUpYJPogPlO.mjs} +2 -2
  32. package/browser/esm/{3ydDykDMtDYbfVVn.mjs → D0TdGLsNoKJ8y8nS.mjs} +113 -111
  33. package/browser/esm/{CBU3LgLYmqtQjJbu.mjs → D5VhIdFEqZBP23Ch.mjs} +1 -1
  34. package/browser/esm/{BoLxSRdEWt-Yg2RI.mjs → DAmyMhko6L63rwJo.mjs} +130 -103
  35. package/browser/esm/{Cj2pgCNqBCGl4rTX.mjs → DKyW2a-ZhqkFjZvH.mjs} +569 -540
  36. package/browser/esm/DSAOtFgAoMMKXSJb.mjs +152 -0
  37. package/browser/esm/De_bbgjFGMBk8KXa.mjs +117 -0
  38. package/browser/esm/Dkw9Yr0Bp5RI5pRw.mjs +222 -0
  39. package/browser/esm/MplcRTnOYfsuQGe3.mjs +410 -0
  40. package/browser/esm/{DMLXV4EKl1NCp_jk.mjs → U9pABiBV0P__iZJE.mjs} +3 -3
  41. package/browser/esm/{ChwS_ougBsogOEsP.mjs → _7FBRywOYc4gCFK2.mjs} +2 -2
  42. package/browser/esm/cLX3kRi9vDkGiZwr.mjs +115 -0
  43. package/browser/esm/index.mjs +466 -135
  44. package/browser/esm/{BZBJG2tDdD3-VujP.mjs → krJU2tCMk9QwcRcw.mjs} +195 -174
  45. package/licenses/dependencies.txt +73 -73
  46. package/node/esm/BSj2vMFtYCJk4miD.mjs +4462 -0
  47. package/node/esm/{BwZcoHDBmLPIVOT5.mjs → Byoa9Sx18Y73xJBM.mjs} +1 -1
  48. package/node/esm/{C-boHCnJditFzng3.mjs → C0yEFO9L8odxQW-z.mjs} +32 -40
  49. package/node/esm/{CHi3AuWEwEPOg9IZ.mjs → C6ookLy8qjozoGUP.mjs} +1 -1
  50. package/node/esm/{DXZrzWee8K5FPOW1.mjs → CF-mBw8E2TnnbVJp.mjs} +2 -2
  51. package/node/esm/CQtseVjtpzUKq41p.mjs +294 -0
  52. package/node/esm/{BhqI3pQFkV8K_612.mjs → C_xnlCmxuBdmK2nV.mjs} +1 -1
  53. package/node/esm/CvZ05tWUwCH6MJas.mjs +268 -0
  54. package/node/esm/{yCHAZKxJR7qY_ySy.mjs → D1uCpJvXqZ16A3-X.mjs} +143 -141
  55. package/node/esm/{DM7K7-284z-PczVz.mjs → DbzH9CwsCrtCs4Ug.mjs} +1 -1
  56. package/node/esm/{Qpuqm6xBr_da38Ht.mjs → DdBJbvx8UwH8CmkE.mjs} +163 -135
  57. package/node/esm/DlNtuQ_K-rgj0iJU.mjs +116 -0
  58. package/node/esm/Dsc5FSbIPxmlRzwV.mjs +414 -0
  59. package/node/esm/index.mjs +7716 -4114
  60. package/node/esm/k8Q5jiL-22BAHe4i.mjs +115 -0
  61. package/node/esm/{CUMKTjYv6VTkcWYi.mjs → oLdQArapyVclkMMy.mjs} +1 -1
  62. package/node/esm/{BA7VzUQ2sKRLTZ5c.mjs → pZBq3MVKHmZiBS8U.mjs} +1 -1
  63. package/package.json +9 -9
  64. package/resources/locales/de/groups.cmd.json +24 -6
  65. package/resources/locales/de/studio.cmd.json +18 -1
  66. package/resources/locales/de/ui.msg.json +251 -30
  67. package/resources/locales/en/groups.cmd.json +24 -6
  68. package/resources/locales/en/studio.cmd.json +18 -1
  69. package/resources/locales/en/ui.msg.json +202 -30
  70. package/types/src/anchorItems/AnchorItemsDescriptor.d.ts +11 -1
  71. package/types/src/anchorItems/AnchorItemsPanel.d.ts +14 -0
  72. package/types/src/anchorItems/AnchoredRangeField.d.ts +40 -0
  73. package/types/src/anchorItems/index.d.ts +1 -0
  74. package/types/src/border/BorderPopupButton.d.ts +6 -6
  75. package/types/src/border/BorderStylePopupButton.d.ts +3 -3
  76. package/types/src/border/BorderTemplateIcon.d.ts +24 -0
  77. package/types/src/border/index.d.ts +1 -0
  78. package/types/src/color/ColorPanel.d.ts +8 -2
  79. package/types/src/color/ColorPopupButton.d.ts +2 -1
  80. package/types/src/command/NumberFormatQuickButtons.d.ts +32 -0
  81. package/types/src/conditions/BetweenOption.d.ts +1 -1
  82. package/types/src/conditions/ConditionEditor.d.ts +6 -1
  83. package/types/src/conditions/ConditionUtils.d.ts +31 -0
  84. package/types/src/conditions/DateTimeOption.d.ts +4 -4
  85. package/types/src/conditions/ExpressionOption.d.ts +6 -6
  86. package/types/src/conditions/ListSourceOption.d.ts +31 -0
  87. package/types/src/conditions/ScalarOption.d.ts +6 -6
  88. package/types/src/conditions/index.d.ts +1 -1
  89. package/types/src/conditions/useFormulaOption.d.ts +54 -0
  90. package/types/src/dataValidation/DataValidationDetailsPanel.d.ts +7 -1
  91. package/types/src/dataValidation/DataValidationDetailsTaskPane.d.ts +3 -2
  92. package/types/src/dataValidation/DataValidationEditorPanel.d.ts +9 -2
  93. package/types/src/dataValidation/DataValidationIcon.d.ts +22 -0
  94. package/types/src/dataValidation/DataValidationTitle.d.ts +13 -0
  95. package/types/src/dialog/FillSeriesDialog.d.ts +16 -0
  96. package/types/src/dialog/TableNewDialog.d.ts +1 -4
  97. package/types/src/dialog/index.d.ts +0 -1
  98. package/types/src/externalLink/ExternalLinkCardBody.d.ts +9 -0
  99. package/types/src/externalLink/ExternalLinkChip.d.ts +18 -0
  100. package/types/src/externalLink/ExternalLinkLocation.d.ts +18 -0
  101. package/types/src/externalLink/ExternalLinkSettingsTab.d.ts +18 -0
  102. package/types/src/externalLink/ExternalLinksPanel.d.ts +11 -0
  103. package/types/src/externalLink/ExternalLinksPlugin.d.ts +5 -0
  104. package/types/src/externalLink/ExternalLinksTaskPane.d.ts +19 -0
  105. package/types/src/externalLink/index.d.ts +8 -0
  106. package/types/src/fill/GradientEditor.d.ts +39 -0
  107. package/types/src/fill/PatternPopupButton.d.ts +26 -0
  108. package/types/src/fill/PatternSwatch.d.ts +53 -0
  109. package/types/src/fill/index.d.ts +4 -0
  110. package/types/src/filter/FilterList.d.ts +9 -6
  111. package/types/src/form/FormulaField.d.ts +25 -2
  112. package/types/src/form/InputField.d.ts +30 -0
  113. package/types/src/format/AlignmentPanel.d.ts +14 -0
  114. package/types/src/format/BorderPanel.d.ts +22 -0
  115. package/types/src/format/BorderPreview.d.ts +84 -0
  116. package/types/src/format/FillPanel.d.ts +25 -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 +83 -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/NumberFormatOption.d.ts +43 -0
  123. package/types/src/{numberFormat → format}/NumberFormatPanel.d.ts +20 -0
  124. package/types/src/format/index.d.ts +13 -0
  125. package/types/src/format/useFormatSelection.d.ts +92 -0
  126. package/types/src/index.d.ts +3 -1
  127. package/types/src/itemsPanel/EditorPanel.d.ts +5 -1
  128. package/types/src/itemsPanel/ItemCard.d.ts +10 -1
  129. package/types/src/itemsPanel/ItemsDescriptor.d.ts +55 -19
  130. package/types/src/itemsPanel/ItemsPanel.d.ts +9 -0
  131. package/types/src/named/NamedDetailsPanel.d.ts +9 -2
  132. package/types/src/named/NamedDetailsTaskPane.d.ts +3 -2
  133. package/types/src/named/NamedEditorPanel.d.ts +1 -1
  134. package/types/src/named/NamedExpressionField.d.ts +32 -0
  135. package/types/src/named/NamedKindChip.d.ts +38 -0
  136. package/types/src/protectedRange/ProtectedRangeDetailsPanel.d.ts +6 -0
  137. package/types/src/protectedRange/ProtectedRangeDraft.d.ts +22 -0
  138. package/types/src/protectedRange/ProtectedRangeEditorPanel.d.ts +0 -14
  139. package/types/src/protectedRange/index.d.ts +2 -1
  140. package/types/src/protection/ManageProtectionTaskPane.d.ts +29 -0
  141. package/types/src/protection/PasswordDialog.d.ts +32 -0
  142. package/types/src/protection/PasswordField.d.ts +35 -0
  143. package/types/src/protection/ProtectedCellsPanel.d.ts +20 -0
  144. package/types/src/protection/ProtectionPlugin.d.ts +11 -0
  145. package/types/src/protection/SheetProtectionPanel.d.ts +35 -0
  146. package/types/src/protection/WorkbookProtectionPanel.d.ts +34 -15
  147. package/types/src/protection/WorkbookProtectionTab.d.ts +22 -0
  148. package/types/src/protection/index.d.ts +7 -1
  149. package/types/src/studio/CommandsWrapper.d.ts +3 -0
  150. package/types/src/studio/EagerStudio.d.ts +14 -1
  151. package/types/src/studio/StudioCommandProvider.d.ts +3 -0
  152. package/types/src/studio/StudioCommands.d.ts +38 -2
  153. package/types/src/studio/StudioProps.d.ts +41 -0
  154. package/types/src/studio/splitStudioProps.d.ts +7 -0
  155. package/types/src/studio/useStudioApp.d.ts +20 -1
  156. package/types/src/template/TemplateCommands.d.ts +29 -0
  157. package/types/src/template/TemplateDialog.d.ts +19 -0
  158. package/types/src/template/TemplatePanel.d.ts +50 -0
  159. package/types/src/template/TemplateSearchField.d.ts +13 -0
  160. package/types/src/template/WelcomeDialog.d.ts +29 -0
  161. package/types/src/template/index.d.ts +3 -0
  162. package/types/src/template/useTemplateCatalog.d.ts +69 -0
  163. package/types/src/workbook/DefaultRenderers.d.ts +2 -0
  164. package/types/src/workbook/FillMenu.d.ts +21 -0
  165. package/types/src/workbook/index.d.ts +1 -0
  166. package/browser/cjs/B_D3JKseVvpRyX-E.cjs +0 -1
  167. package/browser/cjs/BeKpqOx8It0RD0Rf.cjs +0 -2
  168. package/browser/cjs/Bj-EvSYeDfqmU0V6.cjs +0 -2
  169. package/browser/cjs/Bte6P3MhSjajJmmY.cjs +0 -7
  170. package/browser/cjs/CZm1jVZaHQ246prW.cjs +0 -1
  171. package/browser/cjs/Cm1APq2MraYNNhyI.cjs +0 -1
  172. package/browser/cjs/DO8V31Z1ewgMA1di.cjs +0 -5
  173. package/browser/cjs/Djsiad0Qha1Y-YaS.cjs +0 -1
  174. package/browser/cjs/IASAYG6qgv7lJY7y.cjs +0 -1
  175. package/browser/cjs/UnMhi28mbvLiOXQe.cjs +0 -1
  176. package/browser/cjs/Vbigo0kFP3PFfmeA.cjs +0 -1
  177. package/browser/cjs/w2GjebPlOFv3pCbm.cjs +0 -1
  178. package/browser/cjs/z0rB4fK6X1M6PpVD.cjs +0 -11
  179. package/browser/esm/BuY3uV47Bwbqpasq.mjs +0 -219
  180. package/browser/esm/CAs1MWvJTcRfJy26.mjs +0 -217
  181. package/browser/esm/C_XvSsQ9BVdHffCO.mjs +0 -47
  182. package/browser/esm/FT29q8yNwsEpVZjt.mjs +0 -9257
  183. package/browser/esm/Hb1rlHT4tE5hLcjM.mjs +0 -82
  184. package/browser/esm/s46El7mT6oKLSnYB.mjs +0 -411
  185. package/node/esm/9FY82fj1R1c-AczW.mjs +0 -47
  186. package/node/esm/DxXM8qHi0Oz4Zovl.mjs +0 -4575
  187. package/node/esm/sQt2wWGTRLzqeJdG.mjs +0 -82
  188. package/types/src/conditionalFormat/ConditionalFormatRangeField.d.ts +0 -32
  189. package/types/src/conditions/InSetOption.d.ts +0 -37
  190. package/types/src/dialog/NumberFormatDialog.d.ts +0 -12
  191. package/types/src/numberFormat/NumberFormatTaskPane.d.ts +0 -12
  192. package/types/src/numberFormat/index.d.ts +0 -8
  193. package/types/src/protectedRange/ProtectedRangeDetailsTaskPane.d.ts +0 -3
  194. package/types/src/protectedRange/ProtectedRangePlugin.d.ts +0 -2
  195. package/types/src/protection/WorkbookProtectionDialog.d.ts +0 -23
@@ -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
@@ -18,7 +18,7 @@ export interface BetweenProps extends BoxProps {
18
18
  * Component for editing between option (between two values).
19
19
  *
20
20
  * @remarks
21
- * Each bound is a literal or a `=`-prefixed formula, independently — Excel's own between boxes —
21
+ * Each bound is a literal or a formula, independently — Excel's own between boxes —
22
22
  * so both sides take the literal-or-formula field ({@link ScalarOption}).
23
23
  */
24
24
  export declare const BetweenOption: import('react').NamedExoticComponent<BetweenProps>;
@@ -1,5 +1,5 @@
1
1
  import { default as React } from 'react';
2
- import { ICondition } from '@sheetxl/sdk';
2
+ import { ICondition, ICellRanges } from '@sheetxl/sdk';
3
3
  export interface ConditionEditorProps extends React.HTMLAttributes<HTMLDivElement> {
4
4
  /**
5
5
  * The condition.
@@ -36,6 +36,11 @@ export interface ConditionEditorProps extends React.HTMLAttributes<HTMLDivElemen
36
36
  * The list of selectors to show. Defaults to all built-in selectors.
37
37
  */
38
38
  selectors?: ICondition.ISelector[];
39
+ /**
40
+ * The cells the condition covers, so a selector's default can fit them (a List seeded with the
41
+ * values already there). See {@link ICondition.ISelector.getDefaultCondition}.
42
+ */
43
+ ranges?: ICellRanges | null;
39
44
  }
40
45
  /**
41
46
  * Reusable condition editor with a type selector (single) and a recursive operator+param editor.
@@ -68,6 +68,37 @@ export declare const buildOperatorMenuItems: (operators: ICondition.IOperator[],
68
68
  * @param operators The full list of available operators at this level (used to find the first leaf).
69
69
  */
70
70
  export declare const buildDefaultParam: (newOperator: ICondition.IOperator, operators: ICondition.IOperator[], selector?: ICondition.ISelector | null) => any;
71
+ /**
72
+ * An operator and its param, as the editor holds them.
73
+ */
74
+ export interface OperatorParam {
75
+ operator: string;
76
+ param: any;
77
+ }
78
+ export interface SelectorChange {
79
+ /** The selector being left. */
80
+ from: ICondition.ISelector | null;
81
+ /** The selector chosen. */
82
+ to: ICondition.ISelector | null;
83
+ /** What the condition holds now. */
84
+ current: OperatorParam | null;
85
+ /** What this edit last held under `to`, if it was visited before. */
86
+ remembered?: OperatorParam | null;
87
+ /** Every operator on offer, before filtering by selector. */
88
+ operators: ICondition.IOperator[];
89
+ /** Passed to {@link ICondition.ISelector.getDefaultCondition}. */
90
+ context?: ICondition.DefaultConditionContext;
91
+ }
92
+ /**
93
+ * The operator and param a condition holds once its selector changes.
94
+ *
95
+ * @remarks
96
+ * In order: what this edit last held under the new selector (so switching away and back loses
97
+ * nothing); else the current operator when it still applies (its param rebuilt if the value type
98
+ * changed); else the new selector's default. Only a selector with no default and no applicable
99
+ * operator yields `null`, the empty "add condition" state.
100
+ */
101
+ export declare const resolveSelectorChange: (change: SelectorChange) => OperatorParam | null;
71
102
  export declare const SxListSubheader: {
72
103
  userSelect: string;
73
104
  lineHeight: string;
@@ -1,5 +1,6 @@
1
1
  import { default as React } from 'react';
2
2
  import { BoxProps } from '@mui/material';
3
+ import { ICalculation } from '@sheetxl/sdk';
3
4
  export type DateTimeOptionType = 'date' | 'time' | 'dateTime';
4
5
  export interface DateTimeOptionProps extends BoxProps {
5
6
  /**
@@ -11,14 +12,13 @@ export interface DateTimeOptionProps extends BoxProps {
11
12
  */
12
13
  type?: DateTimeOptionType;
13
14
  /**
14
- * The date+time value to edit — a serial, or (for the comparison operators) a `=`-prefixed
15
- * formula string.
15
+ * The date+time value to edit — a serial, or (for the comparison operators) a formula.
16
16
  */
17
- option: number | string | null;
17
+ option: number | string | ICalculation.IFormula | null;
18
18
  /**
19
19
  * Called when either the date or time part changes.
20
20
  */
21
- onOptionChange: (option: number | string | null) => void;
21
+ onOptionChange: (option: number | string | ICalculation.IFormula | null) => void;
22
22
  /**
23
23
  * Whether the operand may be a formula (the comparison operators' Scalar-param convention).
24
24
  * A string option then renders in the literal-or-formula field instead of the pickers — an
@@ -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,8 @@ 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
+ * What is typed goes out as a formula compiled in the editing locale, so the condition stores it
23
+ * canonical. An in-progress (momentarily invalid) formula still carries the user's keystrokes.
24
24
  */
25
25
  export declare const ExpressionOption: import('react').NamedExoticComponent<ExpressionOptionProps>;
26
26
  //# sourceMappingURL=ExpressionOption.d.ts.map
@@ -0,0 +1,31 @@
1
+ import { ICondition } from '@sheetxl/sdk';
2
+ import { FormulaFieldProps } from '../form';
3
+ export interface ListSourceOptionProps extends Omit<FormulaFieldProps, 'value' | 'onChange'> {
4
+ /**
5
+ * The list's param: `items` is a literal (`'"Yes,No"'`), a source formula, or an array.
6
+ */
7
+ option: ICondition.InSetOption | null;
8
+ /**
9
+ * Receives the param as edited. Not called while the text has an error the param cannot hold.
10
+ */
11
+ onOptionChange: (option: ICondition.InSetOption) => void;
12
+ /**
13
+ * If true, makes the editor read-only.
14
+ */
15
+ readOnly?: boolean;
16
+ }
17
+ /**
18
+ * Param editor for a List's source (DESIGN-DV §3.6): ONE field, the leading `=` deciding between a
19
+ * literal list and a reference or formula, and beside it the dropdown the cell will offer.
20
+ *
21
+ * @remarks
22
+ * A literal is typed with the editing locale's list separator (`Yes; No` under de) and stored with
23
+ * the file's `,`, items kept as typed. An item holding `,` cannot be stored and is the field's error.
24
+ * A source is a single range: a pick replaces rather than adds, and a union is the field's error.
25
+ *
26
+ * The dropdown lists what the ACTIVE cell would offer, through the grid's own picker panel, so a
27
+ * relative source previews the row the user is on. It is shown only for a rule that lists items
28
+ * (a data validation's editor provides them through {@link FormulaFrameContext}).
29
+ */
30
+ export declare const ListSourceOption: import('react').NamedExoticComponent<ListSourceOptionProps>;
31
+ //# sourceMappingURL=ListSourceOption.d.ts.map
@@ -1,14 +1,14 @@
1
- import { Scalar } from '@sheetxl/sdk';
1
+ import { Scalar, ICalculation } from '@sheetxl/sdk';
2
2
  import { FormulaFieldProps } from '../form';
3
3
  export interface ScalarOptionProps extends Omit<FormulaFieldProps, 'value' | 'onChange'> {
4
4
  /**
5
- * The option to edit — a literal (number, text, boolean), or a `=`-prefixed formula.
5
+ * The option to edit — a literal (number, text, boolean), or a formula.
6
6
  */
7
- option: Scalar;
7
+ option: Scalar | ICalculation.IFormula;
8
8
  /**
9
9
  * The callback function to handle changes in the option.
10
10
  */
11
- onOptionChange: (option: Scalar) => void;
11
+ onOptionChange: (option: Scalar | ICalculation.IFormula) => void;
12
12
  /**
13
13
  * If true, makes the editor read-only.
14
14
  */
@@ -21,8 +21,8 @@ export interface ScalarOptionProps extends Omit<FormulaFieldProps, 'value' | 'on
21
21
  * restating it would let the two disagree.
22
22
  *
23
23
  * @remarks
24
- * An imported operand like `=$A$1` arrives as a string param; a number input rendered it blank
25
- * and destroyed it on the first keystroke. Here it reads back exactly as stored, with the formula
24
+ * An imported operand like `=$A$1` arrives as a formula param; a number input rendered it blank
25
+ * and destroyed it on the first keystroke. Here it reads back as a formula, with the formula
26
26
  * editor's reference picking and token coloring once the `=` is typed.
27
27
  */
28
28
  export declare const ScalarOption: import('react').NamedExoticComponent<ScalarOptionProps>;
@@ -1,7 +1,7 @@
1
1
  export * from './StringOption';
2
2
  export * from './NumberOption';
3
3
  export * from './ScalarOption';
4
- export * from './InSetOption';
4
+ export * from './ListSourceOption';
5
5
  export * from './AverageOption';
6
6
  export * from './TimePeriodOption';
7
7
  export * from './TopNOption';
@@ -0,0 +1,54 @@
1
+ import { IRange, ICalculation, ICellRanges, IDataValidation, ISheet } from '@sheetxl/sdk';
2
+ /**
3
+ * The rule being edited, as the fields inside its editor need it. A conditional format or a data
4
+ * validation satisfies this as it is.
5
+ *
6
+ * @remarks
7
+ * A rule stores its formulas as they read at its anchor, the top-left of its ranges, but a user
8
+ * types and reads them as they read at the ACTIVE cell, as in Excel's CF and DV dialogs. Without
9
+ * a frame (no provider) the fields read and write the stored text unchanged.
10
+ */
11
+ export interface FormulaFrame {
12
+ /** The cells the rule covers, read at each conversion so an edited range is honored. */
13
+ getRanges(): ICellRanges;
14
+ /** The items the rule lists at a cell, for a rule that offers a list (a data validation). */
15
+ getListItemsAt?(rowIndex: number, columnIndex: number): Promise<readonly IDataValidation.ListItem[]>;
16
+ }
17
+ /** See {@link FormulaFrame}. */
18
+ export declare const FormulaFrameContext: import('react').Context<FormulaFrame | null>;
19
+ /** The cell a rule's formulas are typed and shown at. */
20
+ export declare const activeCellOf: (sheet: ISheet) => IRange.CellCoords;
21
+ /**
22
+ * Converts between a condition's formula param and the text a field edits.
23
+ */
24
+ export interface FormulaOptionText {
25
+ /**
26
+ * The formula as the field shows it, without a leading `=`.
27
+ */
28
+ display(formula: ICalculation.IFormula): string;
29
+ /**
30
+ * What was typed, as the param: a formula compiled in the editing locale, or the text itself when
31
+ * there is no sheet to compile against.
32
+ */
33
+ compile(text: string): ICalculation.IFormula | string;
34
+ /**
35
+ * The field's home: the rule's sheet at the active cell, the frame {@link display} and
36
+ * {@link compile} read in. A pick on that sheet writes bare, one elsewhere qualified.
37
+ */
38
+ home: Partial<IRange.CellCoords> | undefined;
39
+ }
40
+ /**
41
+ * The field side of a condition's formula param.
42
+ *
43
+ * @remarks
44
+ * Typed text is compiled by the editing compiler, so the condition stores it canonical whatever
45
+ * language and separators it was typed in, and it is shown back in the editing form. While the user
46
+ * types, the field keeps their own text for as long as the param still means the same formula —
47
+ * re-imaging it on every keystroke would reformat it under the caret.
48
+ *
49
+ * Inside a {@link FormulaFrameContext}, relative references are typed and shown as they read at the
50
+ * active cell and stored as they read at the rule's anchor. A reference that would land above or
51
+ * left of the anchor cannot be stored, and becomes `#REF!`.
52
+ */
53
+ export declare const useFormulaOption: () => FormulaOptionText;
54
+ //# sourceMappingURL=useFormulaOption.d.ts.map
@@ -1,5 +1,6 @@
1
1
  import { default as React } from 'react';
2
- import { IWorkbook, IDataValidation } from '@sheetxl/sdk';
2
+ import { IDataValidation, IWorkbook } from '@sheetxl/sdk';
3
+ import { ItemsPaneArgs } from '@sheetxl/react';
3
4
  import { AnchorItemsDescriptor } from '../anchorItems';
4
5
  /**
5
6
  * Binds data validations to the generic {@link AnchorItemsPanel}.
@@ -7,6 +8,11 @@ import { AnchorItemsDescriptor } from '../anchorItems';
7
8
  export declare const DataValidationItemsDescriptor: AnchorItemsDescriptor<IDataValidation>;
8
9
  export interface DataValidationDetailsPanelProps extends React.HTMLAttributes<HTMLDivElement> {
9
10
  workbook: IWorkbook;
11
+ /**
12
+ * The task pane's activation argument. A `draft` in it opens the pane editing a new validation
13
+ * seeded from those properties, as the Data ▸ Data Validation presets do.
14
+ */
15
+ args?: ItemsPaneArgs<IDataValidation.Properties>;
10
16
  }
11
17
  /**
12
18
  * The data-validation task pane: the generic anchored-items list driven by
@@ -1,3 +1,4 @@
1
- import { TaskPaneProps } from '@sheetxl/react';
2
- export declare const DataValidationDetailsTaskPane: (props: TaskPaneProps) => import("react").JSX.Element;
1
+ import { IDataValidation } from '@sheetxl/sdk';
2
+ import { TaskPaneProps, ItemsPaneArgs } from '@sheetxl/react';
3
+ export declare const DataValidationDetailsTaskPane: (props: TaskPaneProps<any, ItemsPaneArgs<IDataValidation.Properties>>) => import("react").JSX.Element;
3
4
  //# sourceMappingURL=DataValidationDetailsTaskPane.d.ts.map
@@ -1,3 +1,4 @@
1
+ import { default as React } from 'react';
1
2
  import { IDataValidation } from '@sheetxl/sdk';
2
3
  export interface DataValidationEditorPanelProps {
3
4
  /**
@@ -6,7 +7,13 @@ export interface DataValidationEditorPanelProps {
6
7
  dataValidation: IDataValidation;
7
8
  }
8
9
  /**
9
- * Editor panel component for configuring data validation rule settings.
10
+ * Editor for one data validation: the card's header, then everything the rule does, top to
11
+ * bottom (DESIGN-DV §3.5). The condition, through the editor conditional formats and filters use;
12
+ * the input message; the error alert; and, for a rule that offers a list, its in-cell dropdown.
13
+ *
14
+ * @remarks
15
+ * One scrolling editor rather than Excel's three tabs: the parts all apply at once, and tabs would
16
+ * hide two of them.
10
17
  */
11
- export declare const DataValidationEditorPanel: import('react').NamedExoticComponent<DataValidationEditorPanelProps>;
18
+ export declare const DataValidationEditorPanel: React.NamedExoticComponent<DataValidationEditorPanelProps>;
12
19
  //# sourceMappingURL=DataValidationEditorPanel.d.ts.map
@@ -0,0 +1,22 @@
1
+ import { IDataValidation } from '@sheetxl/sdk';
2
+ /**
3
+ * The glyph a validation's Allow type is shown with: "Any value", each selector, or "Custom".
4
+ */
5
+ export declare const dataValidationIconKey: (item: IDataValidation) => string;
6
+ export interface DataValidationIconProps {
7
+ dataValidation: IDataValidation;
8
+ /**
9
+ * Chip height in px, as `RulePreview`'s.
10
+ * @defaultValue 28
11
+ */
12
+ size?: number;
13
+ }
14
+ /**
15
+ * The leading glyph of a validation's card and editor header.
16
+ *
17
+ * @remarks
18
+ * Drawn in the same chip, at the same footprint, as a conditional format's `RulePreview`, so the
19
+ * two panes' cards and headers line up. A glyph is chrome, not a cell, so the chip is not `sheet`.
20
+ */
21
+ export declare const DataValidationIcon: import('react').NamedExoticComponent<DataValidationIconProps>;
22
+ //# sourceMappingURL=DataValidationIcon.d.ts.map
@@ -0,0 +1,13 @@
1
+ import { IDataValidation } from '@sheetxl/sdk';
2
+ /**
3
+ * What a validation checks, in one line: "Whole Number: Between 1 and 10", "List: Yes, No, Maybe
4
+ * +2", "List from $A$1:$A$5", "Custom: =ISNUMBER(A1)", or "Any value" for a prompt-only rule.
5
+ *
6
+ * @remarks
7
+ * Shared so the card's title and the editor's header say the same thing about the same rule. Every
8
+ * comparison is the condition's own description, as a conditional format's title is; only the
9
+ * shapes a condition cannot describe well (a list source, a custom formula, no condition) are
10
+ * spelled here.
11
+ */
12
+ export declare const dataValidationTitle: (item: IDataValidation, t: (key: string, options?: any) => string) => string;
13
+ //# sourceMappingURL=DataValidationTitle.d.ts.map
@@ -0,0 +1,16 @@
1
+ import { default as React } from 'react';
2
+ import { CommandContext } from '@sheetxl/react';
3
+ import { InputDialogProps } from '@sheetxl/utils-mui';
4
+ export interface FillSeriesDialogProps extends InputDialogProps<CommandContext.FillSeriesOptions, CommandContext.FillSeries> {
5
+ }
6
+ /**
7
+ * Excel's `Series…` — the fill types, the step and stop values, and which way the series runs.
8
+ *
9
+ * @remarks
10
+ * Two things Excel leaves you to guess at are shown here instead: WHICH cells the series is read
11
+ * from (its dialog always seeds from the first cell and never says so; ours takes the leading
12
+ * contentful run, so it matters more), and what the current settings would actually produce.
13
+ */
14
+ export declare const FillSeriesDialog: React.NamedExoticComponent<FillSeriesDialogProps>;
15
+ export default FillSeriesDialog;
16
+ //# sourceMappingURL=FillSeriesDialog.d.ts.map
@@ -4,10 +4,7 @@ import { InputDialogProps } from '@sheetxl/utils-mui';
4
4
  export interface TableNewDialogProps extends InputDialogProps<CommandContext.NewTable, CommandContext.Table> {
5
5
  }
6
6
  /**
7
- * TODO - get cancel to actually work
8
- * TODO - get range to actually work
9
- * TODO - default has header
10
- * TODO - spacing is poor
7
+ * Used when creating a new table within the workbook.
11
8
  */
12
9
  export declare const TableNewDialog: React.NamedExoticComponent<TableNewDialogProps>;
13
10
  export default TableNewDialog;
@@ -1,5 +1,4 @@
1
1
  export * from './FindReplaceWindow';
2
- export * from './NumberFormatDialog';
3
2
  export * from './SortDialog';
4
3
  export * from './HyperlinkDialog';
5
4
  export * from './CommentsDialog';
@@ -0,0 +1,9 @@
1
+ import { default as React } from 'react';
2
+ import { IExternalBook } from '@sheetxl/sdk';
3
+ import { ItemBodyProps } from '../itemsPanel';
4
+ /**
5
+ * What is known about one linked book beyond where it is: which of its sheets this workbook holds
6
+ * values for, and how many formulas would change if the link were broken.
7
+ */
8
+ export declare const ExternalLinkCardBody: React.FC<ItemBodyProps<IExternalBook>>;
9
+ //# sourceMappingURL=ExternalLinkCardBody.d.ts.map
@@ -0,0 +1,18 @@
1
+ import { default as React } from 'react';
2
+ export interface ExternalLinkChipProps extends React.HTMLAttributes<HTMLElement> {
3
+ /**
4
+ * Chip height in px.
5
+ * @defaultValue 28
6
+ */
7
+ size?: number;
8
+ }
9
+ /**
10
+ * The glyph that leads a linked book's card.
11
+ *
12
+ * @remarks
13
+ * One kind, so one glyph — a link has no `NamedKind` to distinguish. Drawn in the same chip at the
14
+ * same footprint as a name's and a conditional format's: the three sit in the same task pane, and a
15
+ * reader moving between them should find the leading visual in the same place at the same size.
16
+ */
17
+ export declare const ExternalLinkChip: React.NamedExoticComponent<ExternalLinkChipProps>;
18
+ //# sourceMappingURL=ExternalLinkChip.d.ts.map
@@ -0,0 +1,18 @@
1
+ import { default as React } from 'react';
2
+ import { IExternalBook } from '@sheetxl/sdk';
3
+ import { ItemBodyProps } from '../itemsPanel';
4
+ /**
5
+ * Where the linked file is — the card's bold label, under the icon and title.
6
+ *
7
+ * @remarks
8
+ * Elides in the MIDDLE rather than at the end: a path's two informative ends are the drive/host and
9
+ * the file name, and a tail ellipsis eats the half that says which file this is. Done by splitting
10
+ * at the last separator and letting only the head shrink, so it costs no measurement — the tail is
11
+ * `flex: 0 0 auto` and the head carries the ellipsis.
12
+ *
13
+ * Renders nothing when no source carries a directory. The title already says the file name, and
14
+ * repeating it as a path that is not one helps nobody (a book may record only a bare relative name
15
+ * — see {@link externalBookLocation}).
16
+ */
17
+ export declare const ExternalLinkLocation: React.FC<ItemBodyProps<IExternalBook>>;
18
+ //# sourceMappingURL=ExternalLinkLocation.d.ts.map
@@ -0,0 +1,18 @@
1
+ import { default as React } from 'react';
2
+ import { IWorkbook } from '@sheetxl/sdk';
3
+ export interface ExternalLinkSettingsTabProps extends React.HTMLAttributes<HTMLDivElement> {
4
+ workbook: IWorkbook;
5
+ }
6
+ /**
7
+ * The **Settings** tab: what should happen to the cached values when this workbook is opened.
8
+ *
9
+ * @remarks
10
+ * Carried, not obeyed — SheetXL always reads the cache and never refreshes a link, so the setting
11
+ * is for the applications that do (DESIGN-EXTERNAL-LINKS phase E). It is still worth writing: a
12
+ * workbook that arrives with `never` must leave with it.
13
+ *
14
+ * A workbook whose source said nothing shows `userSet`, which is how Excel reads an absent
15
+ * attribute. Opening the tab writes nothing; only a click does.
16
+ */
17
+ export declare const ExternalLinkSettingsTab: React.NamedExoticComponent<ExternalLinkSettingsTabProps & React.RefAttributes<HTMLDivElement>>;
18
+ //# sourceMappingURL=ExternalLinkSettingsTab.d.ts.map
@@ -0,0 +1,11 @@
1
+ import { default as React } from 'react';
2
+ import { IWorkbook } from '@sheetxl/sdk';
3
+ export interface ExternalLinksPanelProps extends React.HTMLAttributes<HTMLDivElement> {
4
+ workbook: IWorkbook;
5
+ }
6
+ /**
7
+ * The **Links** tab: every workbook this one links to, what of each is cached, and how many
8
+ * formulas cite it — with Break link per row, and Refresh all and Break all above them.
9
+ */
10
+ export declare const ExternalLinksPanel: React.NamedExoticComponent<ExternalLinksPanelProps & React.RefAttributes<HTMLDivElement>>;
11
+ //# sourceMappingURL=ExternalLinksPanel.d.ts.map
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Registers the **Workbook Links** pane, which `manageExternalLinks` opens.
3
+ */
4
+ export declare const ExternalLinksPlugin: () => void;
5
+ //# sourceMappingURL=ExternalLinksPlugin.d.ts.map
@@ -0,0 +1,19 @@
1
+ import { default as React } from 'react';
2
+ import { IWorkbook } from '@sheetxl/sdk';
3
+ import { TaskPaneProps, ExternalLinksPaneArgs } from '@sheetxl/react';
4
+ export interface ExternalLinksTaskPaneProps extends TaskPaneProps<IWorkbook, ExternalLinksPaneArgs> {
5
+ /** The tab shown when the pane opens with no `args`. @defaultValue `'links'` */
6
+ defaultTab?: ExternalLinksPaneArgs.Tab;
7
+ }
8
+ /**
9
+ * **Workbook Links** — every workbook this one links to, and what should happen to their cached
10
+ * values when it is opened, as two tabs of one pane.
11
+ *
12
+ * @remarks
13
+ * Same shape as Manage Protection, and for the same reason: the Links list is a full-height items
14
+ * panel with its own scroll, and stacking a settings block under it would put two scrolling
15
+ * regions in one column.
16
+ */
17
+ export declare const ExternalLinksTaskPane: React.MemoExoticComponent<(props: ExternalLinksTaskPaneProps) => React.JSX.Element | null>;
18
+ export default ExternalLinksTaskPane;
19
+ //# sourceMappingURL=ExternalLinksTaskPane.d.ts.map
@@ -0,0 +1,8 @@
1
+ export * from './ExternalLinkCardBody';
2
+ export * from './ExternalLinkChip';
3
+ export * from './ExternalLinkLocation';
4
+ export * from './ExternalLinkSettingsTab';
5
+ export * from './ExternalLinksPanel';
6
+ export * from './ExternalLinksTaskPane';
7
+ export * from './ExternalLinksPlugin';
8
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,39 @@
1
+ import { default as React } from 'react';
2
+ import { IFill, IColor } from '@sheetxl/sdk';
3
+ /** A gradient stop in the shape the editor manipulates — always with an explicit offset. */
4
+ export interface GradientStopValue {
5
+ /** `0…1` along the gradient. Explicit, because a defaulted offset does not survive to CSS. */
6
+ offset: number;
7
+ color: IColor.Serializable;
8
+ }
9
+ export interface GradientValue {
10
+ gradientType: IFill.GradientType;
11
+ /** Degrees, `0…359`. Only meaningful for a linear gradient. */
12
+ angle: number;
13
+ stops: GradientStopValue[];
14
+ }
15
+ export interface GradientEditorProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
16
+ value: GradientValue;
17
+ onChange: (value: GradientValue) => void;
18
+ /** Theme color resolution for the stop pickers. */
19
+ schemeLookup?: IColor.SchemeLookup;
20
+ recentColors?: readonly IColor[] | (() => readonly IColor[]);
21
+ darkMode?: boolean;
22
+ disabled?: boolean;
23
+ }
24
+ /**
25
+ * The gradient editor behind the Fill tab's Gradient mode.
26
+ *
27
+ * @remarks
28
+ * Excel's Fill Effects offers exactly two colors, six shading styles and three variants of each —
29
+ * a fixed menu because its file format is all it can express. This authors the model directly
30
+ * instead: any number of stops at any offset, linear at any angle or radial. Everything it produces
31
+ * still round-trips (a two-stop linear gradient is what Excel's grid writes); the extra reach
32
+ * simply is not reachable from Excel's own dialog.
33
+ */
34
+ export declare const GradientEditor: React.MemoExoticComponent<(props: GradientEditorProps) => React.JSX.Element>;
35
+ /** Read the editor's shape out of a model gradient. */
36
+ export declare const toGradientValue: (fill: IFill.IGradient) => GradientValue;
37
+ /** What "switch this cell to a gradient" starts from — a plain white-to-black downward ramp. */
38
+ export declare const DEFAULT_GRADIENT: GradientValue;
39
+ //# sourceMappingURL=GradientEditor.d.ts.map
@@ -0,0 +1,26 @@
1
+ import { default as React } from 'react';
2
+ import { IFill, ICell, IColor } from '@sheetxl/sdk';
3
+ import { TranslateFn } from '@sheetxl/utils-react';
4
+ import { ExhibitPopupButtonProps } from '@sheetxl/utils-mui';
5
+ /**
6
+ * Localized name for a built-in pattern. A literal `t()` pair per pattern keeps the extractor
7
+ * seeing `key → english`; a computed key would be invisible to it.
8
+ */
9
+ export declare function patternLabel(t: TranslateFn, pattern: IFill.BuiltInSheetPattern): string;
10
+ export interface PatternPopupButtonProps extends Omit<ExhibitPopupButtonProps, 'icon' | 'createPopupPanel'> {
11
+ /** The currently applied tile. */
12
+ selectedPattern: IFill.BuiltInSheetPattern;
13
+ /** The tile's mark color, so the gallery previews the pattern the user will actually get. */
14
+ foreground?: IColor.Serializable | null;
15
+ /** The color behind the marks. */
16
+ background?: IColor.Serializable | null;
17
+ onSelectPattern?: (pattern: IFill.BuiltInSheetPattern) => void;
18
+ createCell: (update: ICell.Update) => ICell | null;
19
+ darkMode?: boolean;
20
+ }
21
+ /**
22
+ * The pattern gallery — Excel's Format Cells → Fill → Pattern Style grid, drawn from the model's
23
+ * own tiles and in the fill's own two colors.
24
+ */
25
+ export declare const PatternPopupButton: React.MemoExoticComponent<(props: PatternPopupButtonProps) => React.JSX.Element>;
26
+ //# sourceMappingURL=PatternPopupButton.d.ts.map