@sheetxl/io-xlsx 0.8.0-beta.7 → 1.0.0

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 (215) hide show
  1. package/LICENSE.md +8 -7
  2. package/browser/esm/7rZlWcm56hn3Jmnk.mjs +7021 -0
  3. package/browser/esm/AZus_5slvoIVhf1u.mjs +10323 -0
  4. package/browser/esm/B9QfzGvsvg-V3utu.mjs +4632 -0
  5. package/browser/esm/{CX3yVwe-BnhCk4FY.mjs → BIR_Si489gIkGOnc.mjs} +194 -144
  6. package/browser/esm/BJFvc-i40R4rPZ5y.mjs +2433 -0
  7. package/browser/esm/{CGXxwkCRWLc0gcRQ.mjs → BX8Ebx4NC5zp7_3J.mjs} +3 -3
  8. package/browser/esm/{B4eKxNwxJjHLN126.mjs → Bnxw38IvtA04zXEE.mjs} +2 -2
  9. package/browser/esm/{DwcLXqv8-6Tl1zLO.mjs → CfVhYH77KdrR3fEK.mjs} +3 -3
  10. package/browser/esm/index.mjs +3 -4
  11. package/browser/esm/jIQks3Crw6jehdDU.mjs +2474 -0
  12. package/browser/esm/{DUi-V-E_AJwTIqlO.mjs → qc9hnuR2z-whY8YO.mjs} +3 -3
  13. package/browser/esm/wZGpmkMUubNjClhG.mjs +104 -0
  14. package/licenses/dependencies.txt +2 -2
  15. package/node/esm/{C51yFT2l-6il_xXO.mjs → BNLHWJHyy5eB0P_4.mjs} +2 -2
  16. package/node/esm/CVtsY2F9A9NzEGLk.mjs +2478 -0
  17. package/node/esm/CoeQ0LO-nNXiowwv.mjs +7284 -0
  18. package/node/esm/CxY3iIYLXVhCebeV.mjs +4746 -0
  19. package/node/esm/D2CZy9TQM9h2uqBh.mjs +2562 -0
  20. package/node/esm/{CMq7eF1vxibUumqT.mjs → Dm0hvKcR4xb0TV_N.mjs} +3 -3
  21. package/node/esm/_IA1gQ-zFQYQSZSs.mjs +6957 -0
  22. package/node/esm/index.mjs +65 -28
  23. package/node/esm/{DLBm8l0jyL2fVlxg.mjs → zZFe3mW0xjmobowq.mjs} +3 -3
  24. package/package.json +9 -10
  25. package/types/src/AutoFilterRules.d.ts +85 -22
  26. package/types/src/ConditionalFormatRules.d.ts +2 -2
  27. package/types/src/DataTableFormula.d.ts +26 -0
  28. package/types/src/DataValidationRules.d.ts +0 -5
  29. package/types/src/DefinedNameAttributes.d.ts +8 -0
  30. package/types/src/ExcelCalcStamp.d.ts +0 -36
  31. package/types/src/ExcelCompat.d.ts +15 -143
  32. package/types/src/ExcelFunctionFacts.d.ts +0 -272
  33. package/types/src/ExcelReservedNames.d.ts +0 -65
  34. package/types/src/KnownFonts.d.ts +37 -0
  35. package/types/src/LegacyFormula.d.ts +1 -46
  36. package/types/src/OOXMLExtensions.d.ts +30 -2
  37. package/types/src/PageLayoutAttributes.d.ts +8 -0
  38. package/types/src/Plugin.d.ts +15 -3
  39. package/types/src/ProtectionAttributes.d.ts +2 -2
  40. package/types/src/SheetKinds.d.ts +42 -0
  41. package/types/src/SheetViewAttributes.d.ts +4 -0
  42. package/types/src/SortExtent.d.ts +16 -0
  43. package/types/src/SourcePackage.d.ts +0 -44
  44. package/types/src/SparklineGroups.d.ts +52 -0
  45. package/types/src/Types.d.ts +13 -3
  46. package/types/src/XlsxHeader.d.ts +19 -0
  47. package/types/src/chart/ChartExXml.d.ts +38 -0
  48. package/types/src/chart/ChartPartXml.d.ts +47 -0
  49. package/types/src/chart/ChartSpaceXml.d.ts +37 -0
  50. package/types/src/chart/_XmlTree.d.ts +34 -0
  51. package/types/src/chart/_chartCodecs.d.ts +12 -0
  52. package/types/src/chart/_chartExCodecs.d.ts +7 -0
  53. package/types/src/chart/_chartExFold.d.ts +14 -0
  54. package/types/src/chart/_chartExMarkup.d.ts +236 -0
  55. package/types/src/chart/_chartExStyle.d.ts +13 -0
  56. package/types/src/chart/_codec.d.ts +78 -0
  57. package/types/src/chart/_drawingml.d.ts +10 -0
  58. package/types/src/chart/_xml.d.ts +70 -0
  59. package/types/src/pivot/PivotArea.d.ts +20 -0
  60. package/types/src/pivot/PivotCacheRead.d.ts +30 -0
  61. package/types/src/pivot/PivotCacheWrite.d.ts +23 -0
  62. package/types/src/pivot/PivotFilters.d.ts +29 -0
  63. package/types/src/pivot/PivotFormats.d.ts +60 -0
  64. package/types/src/pivot/PivotTableRead.d.ts +44 -0
  65. package/types/src/pivot/PivotTableWrite.d.ts +13 -0
  66. package/types/src/pivot/_PivotCacheXml.d.ts +48 -0
  67. package/types/src/pivot/_PivotTableXml.d.ts +23 -0
  68. package/types/src/reader/CellControls.d.ts +18 -0
  69. package/types/src/reader/DocumentPropertiesRead.d.ts +16 -0
  70. package/types/src/reader/DummyFunctionUnwrap.d.ts +43 -23
  71. package/types/src/reader/HeaderStyles.d.ts +15 -0
  72. package/types/src/reader/IsoDateCell.d.ts +20 -0
  73. package/types/src/reader/LibreOfficeDataTable.d.ts +12 -0
  74. package/types/src/reader/PivotButtons.d.ts +14 -0
  75. package/types/src/reader/PivotCellFormats.d.ts +22 -0
  76. package/types/src/reader/SlicerJoin.d.ts +26 -0
  77. package/types/src/reader/ZipReader.d.ts +1 -1
  78. package/types/src/reader/_SlicerRecord.d.ts +59 -0
  79. package/types/src/reader/dom/CustGeomUtils.d.ts +7 -0
  80. package/types/src/reader/dom/DOMTransformer.d.ts +2 -2
  81. package/types/src/reader/domVisitors/AppPropertiesVisitor.d.ts +13 -1
  82. package/types/src/reader/domVisitors/AutoFilterVisitor.d.ts +8 -3
  83. package/types/src/reader/domVisitors/ColorContainerVisitor.d.ts +15 -2
  84. package/types/src/reader/domVisitors/CommentVisitor.d.ts +2 -2
  85. package/types/src/reader/domVisitors/DrawingCxnSpVisitor.d.ts +1 -0
  86. package/types/src/reader/domVisitors/DrawingElementVisitor.d.ts +30 -1
  87. package/types/src/reader/domVisitors/DrawingGraphicFrameVisitor.d.ts +9 -0
  88. package/types/src/reader/domVisitors/DrawingGrpSpVisitor.d.ts +14 -2
  89. package/types/src/reader/domVisitors/DrawingPicVisitor.d.ts +30 -2
  90. package/types/src/reader/domVisitors/DrawingSpVisitor.d.ts +20 -1
  91. package/types/src/reader/domVisitors/DrawingVisitor.d.ts +10 -0
  92. package/types/src/reader/domVisitors/ExternalLinkVisitor.d.ts +1 -11
  93. package/types/src/reader/domVisitors/FeaturePropertyBagVisitor.d.ts +18 -0
  94. package/types/src/reader/domVisitors/FmtSchemeVisitor.d.ts +0 -11
  95. package/types/src/reader/domVisitors/FontSchemeVisitor.d.ts +3 -2
  96. package/types/src/reader/domVisitors/FormControlPrVisitor.d.ts +9 -0
  97. package/types/src/reader/domVisitors/ObjectDefaultsVisitor.d.ts +11 -0
  98. package/types/src/reader/domVisitors/ShapeTextVisitor.d.ts +44 -0
  99. package/types/src/reader/domVisitors/SheetColorContainerVisitor.d.ts +2 -2
  100. package/types/src/reader/domVisitors/SheetStyleVisitor.d.ts +26 -5
  101. package/types/src/reader/domVisitors/SlicerCacheDefinitionVisitor.d.ts +11 -2
  102. package/types/src/reader/domVisitors/SlicersVisitor.d.ts +9 -3
  103. package/types/src/reader/domVisitors/SortStateVisitor.d.ts +2 -2
  104. package/types/src/reader/domVisitors/TextPropertiesVisitor.d.ts +13 -1
  105. package/types/src/reader/domVisitors/ThreadedCommentsVisitor.d.ts +2 -2
  106. package/types/src/reader/domVisitors/TimelinesVisitor.d.ts +13 -0
  107. package/types/src/reader/domVisitors/WorkbookVisitor.d.ts +0 -9
  108. package/types/src/reader/domVisitors/_Dxfs.d.ts +10 -0
  109. package/types/src/reader/domVisitors/index.d.ts +10 -36
  110. package/types/src/reader/saxVisitors/ContentTypesVisitor.d.ts +1 -0
  111. package/types/src/reader/saxVisitors/SharedStringsVisitor.d.ts +31 -6
  112. package/types/src/reader/saxVisitors/WorksheetVisitor.d.ts +26 -8
  113. package/types/src/richValue/ErrorRichValueHandler.d.ts +22 -0
  114. package/types/src/richValue/IRichValueHandler.d.ts +109 -0
  115. package/types/src/richValue/LocalImageRichValueHandler.d.ts +18 -0
  116. package/types/src/richValue/RichDataParts.d.ts +69 -0
  117. package/types/src/richValue/RichRecordWriter.d.ts +61 -0
  118. package/types/src/richValue/RichValueHandlers.d.ts +25 -0
  119. package/types/src/richValue/RichValueResolver.d.ts +54 -0
  120. package/types/src/richValue/WebImageRichValueHandler.d.ts +37 -0
  121. package/types/src/richValue/index.d.ts +7 -0
  122. package/types/src/utils/DrawingMLText.d.ts +39 -0
  123. package/types/src/utils/FormControls.d.ts +170 -0
  124. package/types/src/utils/SharedNames.d.ts +13 -0
  125. package/types/src/utils/SpreadsheetFont.d.ts +38 -0
  126. package/types/src/utils/VmlNoteShapes.d.ts +25 -32
  127. package/types/src/utils/VmlNoteStyle.d.ts +25 -0
  128. package/types/src/utils/VmlPrefixes.d.ts +24 -0
  129. package/types/src/vba/VBAProject.d.ts +0 -19
  130. package/types/src/writer/EvaluationSheet.d.ts +5 -0
  131. package/types/src/writer/builder/Emitter.d.ts +5 -0
  132. package/types/src/writer/builder/OpcXmlUtils.d.ts +0 -8
  133. package/types/src/writer/builder/PackageBuilder.d.ts +4 -41
  134. package/types/src/writer/builder/Types.d.ts +28 -28
  135. package/types/src/writer/emitters/CommentsEmitter.d.ts +3 -3
  136. package/types/src/writer/emitters/DrawingEmitter.d.ts +2 -2
  137. package/types/src/writer/emitters/ExternalLinkEmitter.d.ts +0 -11
  138. package/types/src/writer/emitters/FeaturePropertyBagEmitter.d.ts +8 -0
  139. package/types/src/writer/emitters/LegacyDrawingEmitter.d.ts +4 -4
  140. package/types/src/writer/emitters/PivotTableEmitter.d.ts +30 -1
  141. package/types/src/writer/emitters/PropsCoreEmitter.d.ts +7 -2
  142. package/types/src/writer/emitters/PropsCustomEmitter.d.ts +15 -0
  143. package/types/src/writer/emitters/RichValuePartsEmitters.d.ts +36 -0
  144. package/types/src/writer/emitters/RichValueRelEmitter.d.ts +12 -0
  145. package/types/src/writer/emitters/RichValueStructureEmitter.d.ts +4 -3
  146. package/types/src/writer/emitters/RichValueTypesEmitter.d.ts +3 -2
  147. package/types/src/writer/emitters/RichValueWebImageEmitter.d.ts +24 -0
  148. package/types/src/writer/emitters/SharedStringsEmitter.d.ts +6 -3
  149. package/types/src/writer/emitters/SlicerEmitter.d.ts +132 -0
  150. package/types/src/writer/emitters/StylesEmitter.d.ts +35 -2
  151. package/types/src/writer/emitters/TableEmitter.d.ts +14 -0
  152. package/types/src/writer/emitters/WorkbookEmitter.d.ts +24 -2
  153. package/types/src/writer/emitters/WorksheetEmitter.d.ts +4 -3
  154. package/types/src/writer/utils/AutoFilter.d.ts +3 -3
  155. package/types/src/writer/utils/CellControlComplements.d.ts +29 -0
  156. package/types/src/writer/utils/CustGeomUtils.d.ts +5 -0
  157. package/types/src/writer/utils/DateSystem.d.ts +6 -0
  158. package/types/src/writer/utils/DefaultRows.d.ts +22 -0
  159. package/types/src/writer/utils/DrawMLUtils.d.ts +42 -3
  160. package/types/src/writer/utils/DummyFunction.d.ts +0 -25
  161. package/types/src/writer/utils/DxfCollector.d.ts +14 -11
  162. package/types/src/writer/utils/PrstGeomUtils.d.ts +14 -0
  163. package/types/src/writer/utils/RichValueCollector.d.ts +81 -129
  164. package/types/src/writer/utils/SheetStyleLayout.d.ts +86 -0
  165. package/types/src/writer/utils/TextUtils.d.ts +26 -2
  166. package/types/src/writer/utils/UnsupportedFunctions.d.ts +2 -2
  167. package/types/src/writer/utils/XfVariants.d.ts +61 -0
  168. package/browser/cjs/17tMBnuyu4YIxixh.cjs +0 -1
  169. package/browser/cjs/B6sirGz6w-Bm7Ofo.cjs +0 -1
  170. package/browser/cjs/B7_pDFYCVzt-3hUs.cjs +0 -1
  171. package/browser/cjs/BxU-OlZIQViQl7gX.cjs +0 -1
  172. package/browser/cjs/CDs8etXnw0kbBKKv.cjs +0 -1
  173. package/browser/cjs/CIpMN7SDVREKQUQE.cjs +0 -6
  174. package/browser/cjs/CycnxkfuKrDdwoJN.cjs +0 -5
  175. package/browser/cjs/D3EWCPfCu-qMOIGd.cjs +0 -1
  176. package/browser/cjs/DHKWtqZ0vQfXrbq1.cjs +0 -2
  177. package/browser/cjs/MqKQ_B5qRARrRbO4.cjs +0 -24
  178. package/browser/cjs/index.cjs +0 -1
  179. package/browser/cjs/xQ6-wbTw5UzZUM1Y.cjs +0 -1
  180. package/browser/esm/9n64lXAgZUe3aThr.mjs +0 -159
  181. package/browser/esm/BsNoW41d6hdpxTTS.mjs +0 -67
  182. package/browser/esm/BvAptAMpZVyBCx6-.mjs +0 -2402
  183. package/browser/esm/CjKioy-GzeSf08f8.mjs +0 -3326
  184. package/browser/esm/cJxidonaVNZHAXiZ.mjs +0 -4532
  185. package/browser/esm/dsVZVtt5w_yLb967.mjs +0 -5300
  186. package/node/esm/BRQYaMYO4UfhjJHw.mjs +0 -170
  187. package/node/esm/BlbtH3EvAf3K4foF.mjs +0 -2450
  188. package/node/esm/DhSPOg9wN0kD87Tb.mjs +0 -3051
  189. package/node/esm/KeV-N47eTyh5YE70.mjs +0 -4642
  190. package/node/esm/s_yVG0m9KB14YKeN.mjs +0 -3412
  191. package/types/src/legacyChart/OOXMLMappings.d.ts +0 -8
  192. package/types/src/legacyChart/OOXMLUtils.d.ts +0 -78
  193. package/types/src/legacyChart/ToOOXMLConverter.d.ts +0 -30
  194. package/types/src/reader/domVisitors/AxisVisitor.d.ts +0 -12
  195. package/types/src/reader/domVisitors/BarChartTypeVisitor.d.ts +0 -6
  196. package/types/src/reader/domVisitors/ChartSpaceVisitor.d.ts +0 -6
  197. package/types/src/reader/domVisitors/ChartTypeVisitor.d.ts +0 -7
  198. package/types/src/reader/domVisitors/ChartVisitor.d.ts +0 -7
  199. package/types/src/reader/domVisitors/DataLabelsVisitor.d.ts +0 -8
  200. package/types/src/reader/domVisitors/DataPointVisitor.d.ts +0 -6
  201. package/types/src/reader/domVisitors/HyperlinkVisitor.d.ts +0 -6
  202. package/types/src/reader/domVisitors/LayoutVisitor.d.ts +0 -5
  203. package/types/src/reader/domVisitors/LegendEntryVisitor.d.ts +0 -5
  204. package/types/src/reader/domVisitors/LegendVisitor.d.ts +0 -5
  205. package/types/src/reader/domVisitors/MarkerVisitor.d.ts +0 -5
  206. package/types/src/reader/domVisitors/NegativeShapeVisitor.d.ts +0 -6
  207. package/types/src/reader/domVisitors/PlotAreaVisitor.d.ts +0 -5
  208. package/types/src/reader/domVisitors/RichValueDataVisitor.d.ts +0 -7
  209. package/types/src/reader/domVisitors/RichValueStructureVisitor.d.ts +0 -6
  210. package/types/src/reader/domVisitors/SeriesVisitor.d.ts +0 -8
  211. package/types/src/reader/domVisitors/TitleVisitor.d.ts +0 -9
  212. package/types/src/writer/emitters/ChartColorsEmitter.d.ts +0 -7
  213. package/types/src/writer/emitters/ChartEmitter.d.ts +0 -14
  214. package/types/src/writer/emitters/ChartStyleEmitter.d.ts +0 -46
  215. package/types/src/writer/utils/HiddenFormulaXfs.d.ts +0 -28
@@ -1,41 +1,3 @@
1
- /**
2
- * Every per-function Excel fact this package holds, in ONE map keyed by the upper-cased function
3
- * name — the single place to see everything measured about a function. The spelling dialect
4
- * (`LegacyFormula.ts`) and the implicit-intersection semantics (`ExcelCompat.ts`) both read it
5
- * through the narrow accessors at the bottom; call sites keep asking concern-specific questions
6
- * and never reach into rows.
7
- *
8
- * ### Everything measured; rows OVERRIDE declarations
9
- *
10
- * Every fact below is a MEASURED Excel fact, probe-regenerable from
11
- * `spreadsheetbench/formula-tests/` (`probe-param-intersect{,2,3}.ps1` — 1,212 parameter slots
12
- * over 497 functions through COM `.Formula`/`.Formula2`; `probe-return-arrayness{,2,3}.ps1` — 508
13
- * returns; `probe-intersect-oracle.ps1` — the 89-row site battery; `probe-slot-class-intersect*.ps1`
14
- * — the array scope; `probe-xlfn-prefixes.ps1` / `probe-excel-knows-name.ps1` — the spellings;
15
- * `probe-volatile-ca.ps1` — `ca="1"`). The registry's declarations state what a BODY needs and
16
- * serve as the DEFAULT; wherever Excel measurably disagrees, the row here wins (CALC-ISSUES item
17
- * 44: "use the measured list, not a derived predicate"). Re-run the probes when adding a function
18
- * — no test can detect a new function Excel happens to disagree with.
19
- * `scripts/excel-function-facts-lint.mjs` joins the committed probe json against this map and
20
- * fails on disagreement, which is what lets the rows stay hand-authored.
21
- *
22
- * ### Absence keeps its meaning, per FIELD
23
- *
24
- * Each field carries its own default for a row that does not declare it (spelled out on the
25
- * field), and those defaults are NOT the same: absent `prefix` means "written bare", absent
26
- * `arrayScope` means "INHERITS the enclosing scope". Getting a default wrong here is silent and
27
- * produces wrong numbers, not errors. The one fact a row's EXISTENCE itself carries: every name
28
- * here is an Excel-side name, and — unless flagged {@link ExcelFunctionFact.unimplemented} — an
29
- * Excel built-in our registry implements, i.e. `_xleta.`-eligible.
30
- *
31
- * ### Slot addressing
32
- *
33
- * Slot fields key parameter positions by the FLATTENED declaration-slot index: the fixed (prefix)
34
- * parameters in order, then the slots of the repeating cycle. `SUMIFS(sumRange, [criteriaRange,
35
- * criteria]…)` is slots 0/1/2 and argument `i ≥ 1` binds to slot `1 + (i − 1) % 2` — every
36
- * criteria pair answers like the first, and insertion stays per-ARGUMENT (two ranges on one slot
37
- * get two `@`, measured F1/F3 of `probe-collecting-slot.ps1`).
38
- */
39
1
  /** Future-function prefix. */
40
2
  export declare const XLFN = "_xlfn.";
41
3
  /**
@@ -49,101 +11,8 @@ export declare const XLWS = "_xlfn._xlws.";
49
11
  * see each field for what its absence means.
50
12
  */
51
13
  export interface ExcelFunctionFact {
52
- /**
53
- * The row exists only for its on-disk SPELLING — our registry implements no function of this
54
- * name, so a bare token can only be a defined-name reference and never takes `_xleta.`. Three
55
- * kinds of member, and only the first is a backlog:
56
- *
57
- * 1. Excel-side functions we do not YET implement — each a candidate, as `ECMA.CEILING` was
58
- * until it graduated (2026-08-15) and the flag came off.
59
- * 2. Documented spellings for surfaces that are not worksheet functions we would ever
60
- * implement: `COPILOT`, `PY` and the `PYTHON_*` trio, `PQSOURCE`, `QUERYSTRING`, `LONGTEXT`.
61
- * These are in the map because MS-XLSX documents the marker (see {@link prefix}) and a file
62
- * carrying one must round-trip; the flag is what stops the ROW — which has to exist for the
63
- * spelling — from also claiming we implement it. Nothing here will ever graduate.
64
- * 3. The operator wrapper spellings only this package writes.
65
- *
66
- * ABSENT (on a row): the name is an Excel built-in our registry implements, and a bare
67
- * (parenthesis-less) use of it writes `_xleta.` — the eta-reduction bit. MEASURED, not derived
68
- * (DESIGN-FORMULA-DIALECT.md: "Excel prefixes what EXCEL considers built-in", not what our
69
- * registry does — a SheetXL-only built-in stays bare, which round-trips more honestly than
70
- * `_xleta.OURFN`; those names have NO row at all). Membership was seeded from the audit-1
71
- * registry dump (`spreadsheetbench/formula-tests/sheetxl-function-names.json`) filtered by the
72
- * measured Excel-knows oracle (`probe-excel-knows-name{,2,3}.ps1/.json`, Excel 16.0: enter
73
- * `=NAME()`; an arity refusal or any non-`#NAME?` value proves Excel has it). Slot behavioral
74
- * verified by `probe-xleta.ps1` / `probe-xleta-lambda-slots.ps1`. Round 3 of the oracle
75
- * (2026-08-15, build 20228) covered this flag's own members: `ECMA.CEILING`/`PQSOURCE`/
76
- * `SINGLE`/`ANCHORARRAY` are known; `LONGTEXT`/`PYTHON_*`/`QUERYSTRING` answer a plain
77
- * `#NAME?` (feature-gated — a negative is build-relative). `COPILOT`/`PY` hang COM entry on
78
- * their connected-experience init and can never go in an automated sweep, but typing them by
79
- * hand answers both: `COPILOT` is `#NAME?` like the rest, while `PY` resolves and refuses on
80
- * ENTITLEMENT (a subscription-tier prompt, not name resolution) — so `PY` is a name this build
81
- * HAS, and only its license is missing.
82
- *
83
- * The one distinction the bit cannot carry — a user-defined name that SHADOWS a built-in
84
- * spelling stays bare — is derived from the workbook's defined-names collection by the caller
85
- * (see `createLegacyWriteTransform`).
86
- */
87
14
  unimplemented?: true;
88
- /**
89
- * The on-disk prefix ({@link XLFN} or {@link XLWS}) — functions added in Excel 2010+ that need
90
- * the marker for backward compatibility, plus the operator spellings only this package writes.
91
- *
92
- * ABSENT: the name is written bare. Excel then reads a bare FUTURE name as a call to a defined
93
- * name that does not exist — `#NAME?`, for a function Excel actually has.
94
- *
95
- * ### Two authorities, and which one wins
96
- *
97
- * A prefixed row is here because a probe MEASURED the spelling, or because MS-XLSX §2.2.2
98
- * DOCUMENTS it — `future-function-list` / `worksheet-only-function-list`, at
99
- * {@link https://learn.microsoft.com/en-us/openspecs/office_standards/ms-xlsx/3d025add-118d-4413-9856-ab65712ec1b0}.
100
- *
101
- * The documented list is taken WHOLE, all of it or none of it: all 155 names it spells have a
102
- * row (joined 2026-08-15), and the 143 inside its `_xlfn.` group plus the 3 `_xlws.` names all
103
- * carry the marker — the 9 outside the group are the split measured below. A documented
104
- * spelling we omit is not a missing feature, it is a formula we silently rewrite into `#NAME?`
105
- * on save, so the bar for a ROW is "Excel writes this name", never "we implement it" — the
106
- * ones we do not implement are marked {@link unimplemented} and carry the spelling alone.
107
- *
108
- * What the list cannot reach is why measurement exists beside it. It omits `TEXTJOIN`,
109
- * `CONCAT`, `IFS`, `SWITCH`, `MAXIFS`, `MINIFS`, `XMATCH` and `ENCODEURL` — 2016/2019-era
110
- * functions Excel really does prefix, and precisely the roster `probe-xlfn-prefixes.ps1` was
111
- * pointed at — plus everything shipped since (`GROUPBY`, `PIVOTBY`, `REGEX*`, `TRIMRANGE`,
112
- * `PERCENTOF`, and the connected text pair `TRANSLATE`/`DETECTLANGUAGE`, measured in round 3
113
- * after both sat here BARE — the spelling nothing in the five joins had ever covered).
114
- * Measurement OVERRIDES the document: the probe enters the formula via
115
- * `Formula2`, saves, and reads the raw `<f>` back, separating "Excel has it and prefixes it"
116
- * from "this build never heard of it" by also recording the VALUE — an unknown name is `#NAME?`
117
- * and nothing else is, and a build that lacks a name still writes `_xlfn.` on it.
118
- *
119
- * ### The nine outside the group — measured, and it SPLITS
120
- *
121
- * The grammar closes its `("_xlfn." (…))` group before `ECMA.CEILING` / `ISO.CEILING` /
122
- * `NETWORKDAYS.INTL` / `WORKDAY.INTL` / `FORECAST.LINEAR` / the `FORECAST.ETS*` trio /
123
- * `FORECAST.ETS.STAT`, and `future-function-call` on the same page is spelled the same way —
124
- * read literally, all nine are written BARE. Round 2 (`probe-xlfn-prefixes2.ps1/.json`,
125
- * 2026-08-15, build 20228) measured them and Excel does BOTH: the four ceiling/workday names
126
- * really are bare, and all five `FORECAST.*` really do take `_xlfn.`. So no reading of the
127
- * grouping was ever going to be right, and the four bare rows were wrong here from the 2026-02
128
- * transcription until this measurement — we had been writing `_xlfn.NETWORKDAYS.INTL` for a
129
- * name Excel writes plain. (Only the WRITE direction moved: the reader strips every leading
130
- * marker unconditionally, so files carrying the old spelling still load.)
131
- */
132
15
  prefix?: string;
133
- /**
134
- * `'never'`: Excel NEVER intersects into this function, at any argument — the item-44 origin
135
- * term.
136
- *
137
- * Measured 2026-08-12 (`probe-param-intersect.ps1`, verdicts re-joined against the CURRENT
138
- * declarations 2026-08-12 — the join is what keeps the rows honest when a declaration changes
139
- * shape). Every marked function has at least one single-value slot the declaration rule would
140
- * insert into, and Excel inserts into none of them: `=EDATE(D1:D5,1)` stays plain and answers
141
- * `#VALUE!`, so inserting would turn Excel's error into a date — over-insertion is corruption,
142
- * not cosmetics.
143
- *
144
- * ABSENT: the declaration decides slot by slot (with {@link slotNever}/{@link slotAlways}
145
- * overrides).
146
- */
147
16
  intersect?: 'never';
148
17
  /**
149
18
  * Per-SLOT suppressions — the function intersects normally at other slots and never at these
@@ -163,132 +32,10 @@ export interface ExcelFunctionFact {
163
32
  * answers `1`. See {@link valueReturn} for the half of that story Excel does not share with us.
164
33
  */
165
34
  slotNever?: readonly number[];
166
- /**
167
- * Per-SLOT forces — range-ACCEPTING slots Excel nonetheless intersects into ("consumed whole"),
168
- * keyed by flattened slot index.
169
- *
170
- * `TRANSPOSE.array` is the one permanent member: a site the body consumes entire
171
- * (`=SUM(TRANSPOSE(A1:A5))` stores as `=SUM(TRANSPOSE(@A1:A5))`, battery A109/A103), and it can
172
- * never lift — the place `site` and `lift` provably come apart. The other members are item 45's
173
- * residue — see the section prose at their rows.
174
- *
175
- * The `*IFS` criteria entries are GONE (2026-08-13), which is the "data, not API" lifecycle
176
- * completing: those five slots now declare `AcceptError<Scalar>` and the ENGINE lifts them, so
177
- * the plain declaration rule answers "site" on its own and the overrides became deletions. The
178
- * retype was not cosmetic — the hand-rolled broadcast in `aggregateIFS` CLAMPED a short criteria
179
- * vector where Excel pads `#N/A`, so `=SUMIFS(D1:D5,D1:D5,H1:H3,D1:D5,I1:I2)` answered
180
- * `140|50|50` against Excel's `140|50|0` (`probe-ifs-broadcast{,2}.ps1`).
181
- */
182
35
  slotAlways?: readonly number[];
183
- /**
184
- * Excel treats the return as ARRAY where the declaration honestly says otherwise — audit 1's
185
- * residue (`probe-return-arrayness{,2}.ps1`).
186
- *
187
- * The selectors are the finding: `IFS`/`SWITCH`/`REDUCE` forward a branch and are marked while
188
- * `IF`/`CHOOSE`/`LET` forward a branch identically and stay plain — so "polymorphic returns are
189
- * arrays" is FALSE; it is a per-function fact in Excel's own signature table, and a table is the
190
- * only honest place for it.
191
- */
192
36
  arrayReturn?: true;
193
- /**
194
- * PROMISES a single value and can hand back a range anyway — rule 3's inner half
195
- * (`probe-call-wrap.ps1` F-block). The declared scalar return must not be believed by
196
- * `_isRangeValued`; the arguments decide instead.
197
- *
198
- * A call is wrapped only when it promises one value and its arguments break the promise. With
199
- * one consumer (`SUM`) and eight inner calls, exactly two wrap:
200
- *
201
- * ```text
202
- * wrapped IFERROR, IFNA declared return: a VALUE, forwarded fallback
203
- * not wrapped IF, CHOOSE, SWITCH, IFS `any` -> not a promise, so it passes through
204
- * not wrapped TRANSPOSE, SEQUENCE an ARRAY return
205
- * not wrapped OFFSET a REFERENCE return
206
- * ```
207
- *
208
- * Why a fact and not the declaration: the two error handlers declare `Scalar` (they promise a
209
- * value, and that promise is load-bearing — it is what refuses `=COLUMN(IFERROR(1,2))` at entry
210
- * as Excel does, INFORMATION.json item 39) while their `valueIfError` BRANCH forwards whatever
211
- * it was given. Nothing in a declaration says "promises a value it cannot always deliver", and
212
- * the one place that needs to know is here. Complementary to {@link arrayReturn}, never
213
- * overlapping: that bit says "really an array", this one says "a value on paper only".
214
- */
215
37
  valueReturn?: true;
216
- /**
217
- * Reads a reference PER CELL — the result is ranged exactly when the argument at this slot is,
218
- * even though the declared return is a single value (CALC-ISSUES item 46). The value is the
219
- * slot the result's extent follows.
220
- *
221
- * These never intersect their reference (nothing collapses the argument) and then hand back one
222
- * value per cell of it, so the mark lands at the ROOT and nowhere else — Excel stores
223
- * `=@COLUMN(D1:D5)`, `=@ROW(D1:D5)`, `=@ISFORMULA(D1:D5)`, `=@FORMULATEXT(D1:D5)`. Neither the
224
- * declaration nor the other facts here can reach this: it is a property of the RESULT that only
225
- * the argument decides.
226
- *
227
- * Measured as the four surviving root-bit rows of `probe-param-intersect.ps1` (of its eight, the
228
- * `IFERROR`/`IFNA` pair closed with rule 3 and both `XLOOKUP` rows with its `IReferenceRange`
229
- * declaration). **Membership is not derivable** — that sweep holds 23 reference-typed (`r:"p"`,
230
- * depth 0) slots and Excel marks the root on 10 of them at identical declared shapes: the
231
- * readers here plus `CELL` (already an {@link arrayReturn} row) and the array/reference returns
232
- * `OFFSET`/`DROP`/`GROUPBY`/`PIVOTBY` (already answered by their return type), while the
233
- * aggregators over the very same shape stay plain (`SUBTOTAL`, `SUMIF`/`COUNTIF`/`AVERAGEIF`
234
- * ranges, `AREAS`, `PHONETIC`). Readers mark, aggregators do not, and no declaration says which.
235
- *
236
- * **The rule is the ARGUMENT's rangedness, not the result's realized extent** — measured on both
237
- * sides, not chosen (`probe-item46-readers2.ps1`). `COLUMN` is the case that separates them,
238
- * since `COLUMN(D1:D5)` over one column evaluates to the single number 4:
239
- *
240
- * ```text
241
- * C1 =SUM(COLUMN(D1:D5)) -> =SUM(@COLUMN(D1:D5)) wrapped, though the result is 1x1
242
- * D1 =COLUMN(D1:D5) modern saves as <c cm="1"><f t="array" ref="A10"> marked, though 1x1
243
- * C5 =SUM(ISFORMULA(F1)) -> unchanged a 1x1 ARGUMENT ranges nothing
244
- * ```
245
- *
246
- * So capability, on the read side AND the write side — in-family with `=SEQUENCE(1)`, which
247
- * Excel also marks at 1×1 (battery A32). That keeps the read insertion and the `cm` writer on
248
- * the ONE rule they are meant to share, and makes our marking canonical rather than merely
249
- * value-identical.
250
- *
251
- * A reader also participates in RULE 3: `=SUM(ROW(D1:D5))` stores as `=SUM(@ROW(D1:D5))` even
252
- * though `SUM` accepts ranges — the collector's tolerance for a reference does not extend to a
253
- * computed array. See `_isValueReturnCall`.
254
- *
255
- * SHAPE, separately (`probe-item46-readers.ps1` block A): `ISFORMULA` and `FORMULATEXT` really
256
- * do hand back one value per cell (both spill 5×1 over a 5-row reference), `ROW` follows the row
257
- * axis and `COLUMN` the column axis, and `CELL` — an {@link arrayReturn} row — does NOT lift at
258
- * all. The `@` alone never proved any of that, which is why it was measured separately.
259
- */
260
38
  readsPerCell?: number;
261
- /**
262
- * The ARRAY SCOPE — the one fact here that is not a property of a single node, THREE-VALUED:
263
- *
264
- * - `'opens'` — the function's range-accepting slots array-evaluate their subtree; the scope
265
- * turns ON beneath them.
266
- * - `'consumer'` | `'lazy'` — the function turns an inherited scope OFF, for itself and
267
- * everything below. The two spellings clear identically; they are kept apart because their
268
- * REASONS are unrelated (a reference collector vs a lazy forwarder — see the section prose at
269
- * their rows), and the reason is what makes the rows readable.
270
- * - ABSENT — the function INHERITS the enclosing scope unchanged. The common case and the
271
- * load-bearing one: a nested `ABS` must leave the scope exactly as it found it.
272
- *
273
- * Everything else in this file is a depth-1 fact about one slot. This is a flag pushed DOWN the
274
- * walk: inside an array-evaluated slot Excel inserts no interior `@`, however scalar the slots
275
- * beneath it are. `=SUMPRODUCT(ABS(B2:B22))` is what needs it — Excel array-evaluates that
276
- * argument and answers `945252`, while the depth-1 rules see `ABS`'s scalar `number` slot
277
- * holding a range, call it a site, and produce `=SUMPRODUCT(ABS(@B2:B22))` — one row, `45003`.
278
- * A wrong NUMBER from a formula that reads as if nothing happened to it.
279
- *
280
- * Measured `probe-slot-class-intersect{,2,3}.ps1` (+ `.json`; 165 cases 2026-08-14, 122 more
281
- * 2026-08-15), then the FULL-ROSTER sweep `probe-slot-class-intersect4.ps1` (1,031 cases over
282
- * 509 functions, 2026-08-15 — every built-in probed in BOTH positions, `=F(…)` at the root and
283
- * `=SUMPRODUCT(F(…))` inside a measured opener, which is what separates opens / clears /
284
- * inherits; `gen-scope-audit.node.test.ts` derives the case list from the live registry).
285
- * Method throughout: a type-matched site candidate (`ABS(B2:B22)` / `UPPER(E2:E22)` /
286
- * `NOT(C2:C22)` — each a one-scalar-slot call over a range, which the `bare` control confirms
287
- * by taking an `@`) entered through legacy `.Formula` and read back through `.Formula2`, with a
288
- * root `@` stripped first so only INTERIOR insertion counts. REFUSED at entry (the `D*`
289
- * database family, `RANK`/`*IFS`/`COUNTBLANK` — Excel rejects a computed array there) is a
290
- * third outcome, not a verdict: those functions keep no row and stay on the default.
291
- */
292
39
  arrayScope?: 'opens' | 'consumer' | 'lazy';
293
40
  /**
294
41
  * Per-SLOT subtree clears — the scope survives the function itself but turns OFF inside these
@@ -312,25 +59,6 @@ export interface ExcelFunctionFact {
312
59
  * array slots and clear at these).
313
60
  */
314
61
  scopeClears?: readonly number[];
315
- /**
316
- * On Excel's volatile-function list — the WRITE-side source of `ca="1"`.
317
- *
318
- * Deliberately a COMPAT fact and not an engine property. Excel needs OFFSET/INDIRECT volatile
319
- * because it cannot statically track where they read; our engine registers the actual target as
320
- * a dynamic precedent at evaluation (`FormulaContext.getReference`), so it recalculates exactly
321
- * when the target changes and gains nothing from every-cycle recalc. But the FILE must still say
322
- * what Excel would say — Excel derives `ca` statically from the formula text, so a cell whose
323
- * formula calls any of these carries `ca="1"` however our engine schedules it. Functions that
324
- * really are runtime-volatile for us too (NOW/RAND/CELL/…) also reach `ca` through the live
325
- * volatile set; this fact is what keeps the flag on the ones that are not.
326
- *
327
- * Membership MEASURED over every `FormulaContext.getReference` consumer
328
- * (`probe-volatile-ca.ps1` + json, 2026-08-14). The measured NOs matter as much:
329
- * INDEX (value AND reference form — `=SUM(INDEX(..):B10)` stays plain), LOOKUP, XLOOKUP, and
330
- * the trim-ref OPERATORS `.:.`/`:.` — not volatile even though TRIMRANGE the function is.
331
- * Also measured there: current Excel adds `aca="1"` beside `ca` on volatile `t="array"` cells
332
- * (INDIRECT/CELL/TRIMRANGE/RANDARRAY), though corpus files from older producers omit it.
333
- */
334
62
  volatile?: true;
335
63
  }
336
64
  /**
@@ -1,67 +1,2 @@
1
- /**
2
- * Names Excel REFUSES in a worksheet formula, at every arity — the XLM macro-sheet heritage.
3
- *
4
- * Emitting one of these bare is not a `#NAME?`, it is an xlsx Excel will not open: the normal
5
- * load is refused outright, and a user who clicks through the repair prompt gets the workbook
6
- * back with the offending cell EMPTIED — formula and cached value both gone, and nothing marking
7
- * that anything was ever there. Measured with its repair outcome in
8
- * `spreadsheetbench/formula-tests/probe-reserved-name-load.ps1/.json`. The `_xlfn.` marker does
9
- * NOT rescue them.
10
- *
11
- * This is the third of the export hazards and the only one that is file-fatal. The other two:
12
- *
13
- * - `ExcelFunctionFact.unimplemented` — Excel has the name, we do not. Record its spelling so
14
- * the `_xlfn.` prefix survives the round trip.
15
- * - the deny-set (descriptor category `Sheets`/`SheetXL`, pinned by
16
- * `sdk/src/__tests__/calculation/excelSupported.parity.test.ts`) — we have the name, Excel does
17
- * not. Wrap it so the VALUE survives; bare would cost the user their answer.
18
- * - here — neither has it as a worksheet function AND Excel reserves the name. Wrap it so the
19
- * FILE survives.
20
- *
21
- * ### Provenance
22
- *
23
- * Candidates come from two sources: MS-XLSX §2.2.2 `command-list` + `ref-macro-function-call` +
24
- * `macro-function-call` (505 names), and Excel Online's own function-id enum
25
- * (`excel-online-ftab.txt`, 708 entries), which is the better authority — it is what Excel
26
- * RECOGNIZES rather than what Microsoft documented, and it carries names the productions never
27
- * list. `SERIES` is the one that matters here: the chart-series function, absent from every
28
- * MS-XLSX production and fatal in a worksheet cell.
29
- *
30
- * Membership in either source is NOT the verdict — `FILTER`, `IF` and `SORT` appear in them and
31
- * are ordinary worksheet functions — so every name was MEASURED by entry
32
- * (`probe-reserved-name-sweep.ps1/.json`, 2026-08-15, Excel 16.0 build 20228): 504 of the 1,238
33
- * candidates are refused at every arity from 0 to 12.
34
- *
35
- * Trying EVERY arity is what makes the reading clean. Excel arity-checks only a name it
36
- * recognizes, so an unknown name enters at arity 0 (it is read as a call to a defined name that
37
- * does not exist) while a real function enters at its own minimum — `XLOOKUP` at 3, `ACCRINT`
38
- * at 6, `ODDFPRICE` at 8. Refused at all of them means the NAME was rejected, not the argument
39
- * count. The range has to reach the largest mandatory arity in Excel or real functions look
40
- * reserved: a 0..4 range condemned `ACCRINT`, `PRICE`, `YIELD`, `DURATION`, `VDB` and the
41
- * `ODD*` family, which is why the probe now carries high-arity controls and fails outright if a
42
- * name our own registry implements measures reserved.
43
- *
44
- * ### What is deliberately NOT here
45
- *
46
- * A name we never emit BARE cannot be reached by this hazard, and listing it would do harm.
47
- * `ANCHORARRAY` and `PQSOURCE` are both refused bare, but `ExcelFunctionFacts` gives them an
48
- * `_xlfn.` prefix, so we write `_xlfn.PQSOURCE(…)` — the spelling Excel itself writes. Wrapping
49
- * them would replace a correct round trip with a dead `DUMMYFUNCTION` value, defeating the
50
- * `unimplemented` rows that exist to preserve exactly that. The rule: a measured refusal earns
51
- * a place here only if the facts map gives the name no prefix. Lint join 6 enforces it.
52
- *
53
- * Only `SPLIT` and `WAIT` are also in our own registry, and the deny-set already wraps both. The
54
- * rest matter because they reach `resolveUnsupported` as names we do not know, where the default
55
- * is to pass them through untouched.
56
- *
57
- * ### The one name here that measured WRITABLE
58
- *
59
- * `MSOCHECKS` enters at every arity on build 20228 — this Excel has forgotten it, so it behaves
60
- * like any other unknown name. It is listed anyway, against the measurement, because the two
61
- * errors are not symmetric: a build that still remembers the name makes it file-fatal, while a
62
- * false positive costs one dead formula in a name nobody types. `FILTER`, `IF` and `SORT` also
63
- * measured writable and are NOT listed — those are live worksheet functions, where wrapping
64
- * would break working formulas.
65
- */
66
1
  export declare const ExcelReservedNames: ReadonlySet<string>;
67
2
  //# sourceMappingURL=ExcelReservedNames.d.ts.map
@@ -0,0 +1,37 @@
1
+ import { IFontCollection } from '@sheetxl/sdk';
2
+ /** The `paramMap` key under which the styles part leaves what it read about its fonts. */
3
+ export declare const KNOWN_FONTS_PARAM = "knownFonts";
4
+ /** One face a workbook's fonts name. */
5
+ export interface KnownFontFace {
6
+ family: string;
7
+ bold: boolean;
8
+ italic: boolean;
9
+ }
10
+ /** What the styles part read: the flag, whether Normal's font is a theme font, and every face. */
11
+ export interface KnownFontsParam {
12
+ declared: boolean;
13
+ normalIsThemeFont: boolean;
14
+ faces: KnownFontFace[];
15
+ }
16
+ /** Whether `face` measures, now, from a table of its own. A face still loading is not known. */
17
+ export declare function isKnownFace(fonts: IFontCollection, face: KnownFontFace): boolean;
18
+ /**
19
+ * Whether `face` is a real font, one Excel would have: anything that resolves to more than a
20
+ * built-in generic table.
21
+ *
22
+ * @remarks
23
+ * Looser than {@link isKnownFace} on purpose. Reading, the question is whether Excel knew the font
24
+ * when it measured the stored heights, not whether we can measure it: Aptos resolves to a related
25
+ * family's table here (`classified`), but Excel, which ships it, measured the file with the real
26
+ * face. A font nobody has resolves to a generic table, and Excel re-fits those rows too.
27
+ */
28
+ export declare function isRecognizedFace(fonts: IFontCollection, face: KnownFontFace): boolean;
29
+ /** Whether every one of `faces` is recognized once its table has loaded. */
30
+ export declare function allFacesRecognized(faces: readonly KnownFontFace[]): Promise<boolean>;
31
+ /** The distinct faces of a list of font records, by family, weight and style. */
32
+ export declare function distinctFaces(fonts: readonly {
33
+ family?: string;
34
+ weight?: number;
35
+ style?: string;
36
+ }[]): KnownFontFace[];
37
+ //# sourceMappingURL=KnownFonts.d.ts.map
@@ -1,49 +1,8 @@
1
1
  import { ICalculation } from '@sheetxl/sdk';
2
2
  export { XLFN, XLWS } from './ExcelFunctionFacts';
3
- /**
4
- * The xlsx legacy-formula dialect — every version-compatibility SPELLING between the modern
5
- * (dynamic) formula language and what Excel stores on disk. Shared by the writer and the reader;
6
- * the round-trip tests in this package are the contract that the two halves stay in step.
7
- *
8
- * All of it is measured tables + structural rewrites (DESIGN-FORMULA-DIALECT.md):
9
- *
10
- * | construct | modern (tree) | on disk (xlsx) |
11
- * | --- | --- | --- |
12
- * | future functions | `XLOOKUP(...)` | `_xlfn.XLOOKUP(...)` |
13
- * | worksheet-only | `FILTER(...)` | `_xlfn._xlws.FILTER(...)` |
14
- * | spill anchor | postfix `#` | `_xlfn.ANCHORARRAY(ref)` |
15
- * | implicit intersection | prefix `@` | `_xlfn.SINGLE(ref)` (unless in a table reference) |
16
- * | structured this-row | `@col` in a table ref | `[#This Row],[col]` |
17
- * | trim-range | infix `.:.` / `.:` / `:.` | `_xlfn._TRO_ALL/_TRO_LEADING/_TRO_TRAILING(a:b)` |
18
- * | bare built-in | named `SUM` (unresolved) | `_xleta.SUM` — from the MEASURED `ExcelFunctionFacts` map |
19
- * | LET/LAMBDA parameter | named `x` | `_xlpm.x` — at the declaration AND at every use |
20
- * | long string literal | `"…"` over 255 characters | `_xlfn._LONGTEXT("…255…","…255…",…)` |
21
- *
22
- * MS-XLSX Extensions to Office Open XML section 2.2.2 Formula:
23
- * https://learn.microsoft.com/en-us/openspecs/office_standards/ms-xlsx/3d025add-118d-4413-9856-ab65712ec1b0
24
- */
25
- /**
26
- * The wrapper Excel spells a string literal longer than {@link LONGTEXT_CHUNK} characters with:
27
- * the literal cut into chunks of at most that many characters, each a string argument, in order.
28
- * Excel's formula grammar caps a literal at 255 characters; the model has no such cap and holds
29
- * the literal whole, so the wrapper exists only on disk.
30
- *
31
- * Measured (Excel 16.0, 2026-09-23, `probe-dv-launder.ps1`): a 996-character data-validation list
32
- * literal saved as `_xlfn._LONGTEXT("…","…","…","…")` with chunks of 255, 255, 255 and 231
33
- * characters (`__tests__/data/conditions/dv-limits.xlsx`). The chunk is counted on the literal's
34
- * characters, not its imaged form — how a doubled quote (`""`) counts toward the 255 is not yet
35
- * measured. Excel opens a bare over-long literal in a DV formula (same probe); whether it opens
36
- * one in a cell `<f>` is unmeasured, so the wrapper is written wherever Excel would write it.
37
- */
38
3
  export declare const LONGTEXT = "_LONGTEXT";
39
4
  /** The longest string literal Excel spells bare — see {@link LONGTEXT}. */
40
5
  export declare const LONGTEXT_CHUNK = 255;
41
- /**
42
- * Eta-reduced-lambda prefix — a BUILT-IN function referenced WITHOUT parentheses
43
- * (`=BYROW(A1:B3,SUM)`, and equally `=SUM(ABS)` or `=1+ABS`: Excel prefixes it wherever it
44
- * appears, not only in lambda-taking slots). A user-defined name (bound to LAMBDA) stays bare.
45
- * Measured: `spreadsheetbench/formula-tests/probe-xleta*.ps1`, `probe-bare-name.ps1`.
46
- */
47
6
  export declare const XLETA = "_xleta.";
48
7
  /**
49
8
  * Lambda-parameter prefix (`_xlpm.name`), stripped on read.
@@ -53,12 +12,8 @@ export declare const XLETA = "_xleta.";
53
12
  * cell holds a literal `#NAME?`. See {@link _prefixScopeParameters}.
54
13
  */
55
14
  export declare const XLPM = "_xlpm.";
56
- /**
57
- * Optional-parameter prefix (`_xlop.name`) — the DECLARATION spelling of `[b]`; every use of the
58
- * parameter stays `_xlpm.` (measured, application §2.6). Read restores the flag, not the brackets:
59
- * the display form re-images from `NamedRef.optional`.
60
- */
61
15
  export declare const XLOP = "_xlop.";
16
+ export declare const XLUDF = "_xludf.";
62
17
  /**
63
18
  * The write direction: modern (dynamic) tree → on-disk xlsx spellings, as an
64
19
  * {@link ICalculation.FormulaTransform} — the `write` half of the xlsx dialect (`ExcelCompat`).
@@ -33,10 +33,38 @@ export declare const EXT_URI_CONDITIONAL_FORMATTINGS = "{78C0D931-6437-407d-A8EE
33
33
  export declare const EXT_URI_CONDITIONAL_FORMATTINGS_LEGACY_TYPO = "{78C0D931-6839-4c89-B8D6-976A2CC4E5B4}";
34
34
  /** `x14:id` on a legacy `cfRule` — the GUID linking it to its x14 twin. */
35
35
  export declare const EXT_URI_CF_RULE_ID = "{B025F937-C7B1-47D3-B67F-A62EFF666E3E}";
36
- /** `x14:slicerList` on the worksheet. */
36
+ /** The x15 (Excel 2013) main namespace, declared on `<ext>` elements that carry x15 content. */
37
+ export declare const NS_X15 = "http://schemas.microsoft.com/office/spreadsheetml/2010/11/main";
38
+ /** `x14:slicerList` on the worksheet under the x14 ext uri: what Excel writes for a pivot slicer, and older Excel for any. */
37
39
  export declare const EXT_URI_SLICER_LIST = "{A8765BA9-456A-4dab-B4F3-ACF838C121DE}";
38
- /** `x15:slicerList` on the worksheet (slicers on data-model tables). */
40
+ /** `x14:slicerList` on the worksheet under the x15 ext uri: what current Excel writes for a table slicer. */
39
41
  export declare const EXT_URI_SLICER_LIST_X15 = "{3A4CF648-6AED-40f4-86FF-DC5316D8AED3}";
42
+ /** `x15:slicerCaches` on the workbook: the relationships to the table slicers' cache parts. */
43
+ export declare const EXT_URI_SLICER_CACHES_X15 = "{46BE6895-7355-4a93-B00E-2C351335B9C9}";
44
+ /** `x14:slicerCaches` on the workbook: the relationships to the pivot slicers' cache parts. */
45
+ export declare const EXT_URI_SLICER_CACHES_X14 = "{BBE1A952-AA13-448e-AADC-164F8A28A991}";
46
+ /** `xcalcf:calcFeatures` on the workbook: the calc features Excel compares against its own on open. */
47
+ export declare const EXT_URI_CALC_FEATURES = "{B58B0392-4F1F-4190-BB64-5DF3571DCE5F}";
48
+ /**
49
+ * `x15:timelineRefs` on the worksheet: the relationship to the sheet's timeline part. Spelled as
50
+ * Excel writes it: written uppercase, Excel does not see the timelines (measured 2026-10-24).
51
+ */
52
+ export declare const EXT_URI_TIMELINE_REFS = "{7E03D99C-DC04-49d9-9315-930204A7B6E9}";
53
+ /** `x15:timelineCacheRefs` on the workbook: the relationships to the timeline cache parts. */
54
+ export declare const EXT_URI_TIMELINE_CACHE_REFS = "{D0CA8CA8-9F24-4464-BF8E-62219DCF47F9}";
55
+ /** `x15:tableSlicerCache` in a slicer cache's `extLst`: the table and column a table slicer filters. */
56
+ export declare const EXT_URI_TABLE_SLICER_CACHE = "{2F2917AC-EB37-4324-AD4E-5DD8C200BD13}";
57
+ /**
58
+ * `xlrd2:filterColumn` on an autoFilter's `filterColumn` — a date-group filter as VBA/COM writes
59
+ * it. Excel's own dropdown writes the same groups in the main namespace; this is read, never
60
+ * written.
61
+ */
62
+ export declare const EXT_URI_FILTER_COLUMN = "{1AD28BCE-077C-4C59-8B6E-1921CE8616D4}";
63
+ /**
64
+ * `x14:sparklineGroups` on the worksheet: the sheet's sparkline groups. Spelled as Excel writes
65
+ * it: written uppercase, Excel keeps the content but does not load the groups (measured 2026-11-06).
66
+ */
67
+ export declare const EXT_URI_SPARKLINE_GROUPS = "{05C60535-1F16-4fd2-B633-F4F36F0B64E0}";
40
68
  /**
41
69
  * Ext uris the reader recognizes but does not read, with the feature name for the warning
42
70
  * (design §2.2 / plan Phase 5: skipped ext content warns, it never disappears silently).
@@ -0,0 +1,8 @@
1
+ import { IPageLayout } from '@sheetxl/sdk';
2
+ /** `pageSetup@cellComments` and the model's value for it. `none` is the model's default. */
3
+ export declare const CELL_COMMENTS: readonly [attribute: string, value: IPageLayout.PrintComments][];
4
+ /** `pageSetup@errors` and the model's value for it. `displayed` is the model's default. */
5
+ export declare const PRINT_ERRORS: readonly [attribute: string, value: IPageLayout.PrintErrorType][];
6
+ /** The headers and footers in `<headerFooter>`, in the schema's order. */
7
+ export declare const HEADER_FOOTER_ELEMENTS: readonly ["oddHeader", "oddFooter", "evenHeader", "evenFooter", "firstHeader", "firstFooter"];
8
+ //# sourceMappingURL=PageLayoutAttributes.d.ts.map
@@ -7,9 +7,9 @@ export declare const XLSX_FORMAT_KEY = "Excel";
7
7
  * The registry key for macro-enabled Excel (`.xlsm`).
8
8
  *
9
9
  * @remarks
10
- * A separate registered format, not a second extension on {@link XLSX_FORMAT_KEY}: `DESIGN-IO.md`
11
- * rejects one format owning several extensions precisely because the handler is never told which
12
- * one is being written, and macro-enabledness is exactly such a per-extension decision. Both keys
10
+ * A separate registered format, not a second extension on {@link XLSX_FORMAT_KEY}: a format's
11
+ * handler is never told which of its extensions is being written, and macro-enabledness is exactly
12
+ * such a per-extension decision. Both keys
13
13
  * share one reader and one writer; only the *write* side is opinionated (the same shape `.sxl` and
14
14
  * `.json` use).
15
15
  *
@@ -18,6 +18,18 @@ export declare const XLSX_FORMAT_KEY = "Excel";
18
18
  * under an `.xlsm` name.
19
19
  */
20
20
  export declare const XLSM_FORMAT_KEY = "ExcelMacro";
21
+ /**
22
+ * The registry key for an Excel template (`.xltx`). Like {@link XLSM_FORMAT_KEY}, a format of its
23
+ * own because being a template is a property of the file written, not of the workbook: only the
24
+ * workbook part's content type differs.
25
+ */
26
+ export declare const XLTX_FORMAT_KEY = "ExcelTemplate";
27
+ /**
28
+ * The registry key for a macro-enabled Excel template (`.xltm`).
29
+ */
30
+ export declare const XLTM_FORMAT_KEY = "ExcelMacroTemplate";
31
+ /** Every format key this package reads and writes, all with the one reader and writer. */
32
+ export declare const EXCEL_FORMAT_KEYS: readonly string[];
21
33
  /**
22
34
  * Registers all built-in read and write formats with the provided WorkbookIO registry.
23
35
  *
@@ -1,4 +1,4 @@
1
- import { ISheetProtection, IWorkbookProtection } from '@sheetxl/sdk';
1
+ import { IWorksheetProtection, IWorkbookProtection } from '@sheetxl/sdk';
2
2
  /**
3
3
  * One protection attribute at the xlsx boundary.
4
4
  *
@@ -19,7 +19,7 @@ export interface ProtectionAttribute<K extends string> {
19
19
  ooxmlDefault: boolean;
20
20
  }
21
21
  /** `CT_SheetProtection`, in schema order. `showFormulas` has no attribute (formats carry it). */
22
- export declare const SheetProtectionAttributes: readonly ProtectionAttribute<keyof ISheetProtection.JSON>[];
22
+ export declare const WorksheetProtectionAttributes: readonly ProtectionAttribute<keyof IWorksheetProtection.JSON>[];
23
23
  /**
24
24
  * `CT_WorkbookProtection`'s lock flags. `revision` belongs to shared workbooks: nothing sets it, so an
25
25
  * unset one writes nothing rather than locking revisions on every protected workbook.
@@ -0,0 +1,42 @@
1
+ import { IOpaqueSheet, IWorkbook, IWorksheet } from '@sheetxl/sdk';
2
+ /** What a part of one kind is written as. */
3
+ export interface SheetKindPart {
4
+ relType: string;
5
+ contentType: string;
6
+ folder: string;
7
+ }
8
+ export declare const WorksheetPart: SheetKindPart;
9
+ /** As Excel writes each kind. */
10
+ export declare const SheetKindParts: Readonly<Record<IOpaqueSheet.Kind, SheetKindPart>>;
11
+ /** The worksheet a sheet ref holds, or `undefined` when it holds another kind (or nothing). */
12
+ export declare const worksheetJSON: (ref: IWorkbook.SheetRefJSON | null | undefined) => IWorksheet.JSON | undefined;
13
+ /** The carried part a sheet ref holds, or `undefined` when it holds a worksheet. */
14
+ export declare const opaqueSheetJSON: (ref: IWorkbook.SheetRefJSON | null | undefined) => IOpaqueSheet.JSON | undefined;
15
+ /** The kind a workbook relationship names, or `null` for a worksheet or anything else. */
16
+ export declare const sheetKindFromRelType: (relType: string | null | undefined) => IOpaqueSheet.Kind | null;
17
+ /**
18
+ * The attributes of the part's `sheetPr/tabColor`, or `null` when it has none.
19
+ */
20
+ export declare const readTabColorAttributes: (xml: string) => Map<string, string> | null;
21
+ /**
22
+ * The part with its `sheetPr/tabColor` replaced by `tabColorXml` (a whole `<tabColor/>` element), or
23
+ * removed when that is `null`.
24
+ *
25
+ * @remarks
26
+ * `tabColor` is the first child of `sheetPr` in every kind's schema, and `sheetPr` the first child of
27
+ * the root, so that is where each goes when absent.
28
+ */
29
+ export declare const patchTabColor: (xml: string, tabColorXml: string | null) => string;
30
+ export declare const patchTabSelected: (xml: string, selected: boolean) => string;
31
+ export declare const macroSheetAsWorksheet: (xml: string) => string;
32
+ /**
33
+ * A macro sheet's part made independent of the workbook parts it cites by position: each shared
34
+ * string written inline, and the style, cell-metadata and value-metadata indexes dropped.
35
+ *
36
+ * @remarks
37
+ * The part is carried, but the workbook's shared strings and styles are rebuilt on every save, so a
38
+ * carried index would name another string or format, or none (a repair prompt). An inline string is
39
+ * the same text; a dropped style is the default format, which is lost.
40
+ */
41
+ export declare const detachMacroSheet: (xml: string, strings: readonly unknown[]) => string;
42
+ //# sourceMappingURL=SheetKinds.d.ts.map
@@ -0,0 +1,4 @@
1
+ import { IWorksheetView } from '@sheetxl/sdk';
2
+ /** The `sheetView` attribute that holds each view mode's own zoom. */
3
+ export declare const VIEW_MODE_ZOOM_ATTRIBUTES: readonly [mode: IWorksheetView.ViewMode, attribute: 'zoomScaleNormal' | 'zoomScaleSheetLayoutView' | 'zoomScalePageLayoutView'][];
4
+ //# sourceMappingURL=SheetViewAttributes.d.ts.map
@@ -0,0 +1,16 @@
1
+ import { IRange, ISort } from '@sheetxl/sdk';
2
+ /**
3
+ * A `sortState` or `sortCondition` ref as an {@link ISort.Extent} of the table or filter range it
4
+ * belongs to, and back. Excel records the range it last sorted, which need not be the table's
5
+ * (`ISort.JSON.extent`).
6
+ */
7
+ /** `ref`'s edges as offsets from `base`'s. */
8
+ export declare const toExtent: (base: IRange.Coords, ref: IRange.Coords) => ISort.Extent;
9
+ /** The range `extent` describes against `base`, or `null` when it would be empty or off the grid. */
10
+ export declare const fromExtent: (base: IRange.Coords, extent: ISort.Extent) => IRange.Coords | null;
11
+ /**
12
+ * A condition's extent, or `null` when its ref is just its column of the sort's range — the shape
13
+ * a sort made here writes, so it need not be carried.
14
+ */
15
+ export declare const conditionExtent: (base: IRange.Coords, sortRange: IRange.Coords, ref: IRange.Coords) => ISort.Extent | null;
16
+ //# sourceMappingURL=SortExtent.d.ts.map