@sheetxl/io-xlsx 0.7.23-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.md +11 -0
- package/README.md +23 -0
- package/browser/cjs/5QaWZ2tRVhz1rf3W.cjs +1 -0
- package/browser/cjs/B6sirGz6w-Bm7Ofo.cjs +1 -0
- package/browser/cjs/B7_pDFYCVzt-3hUs.cjs +1 -0
- package/browser/cjs/BE7AtU1GCShmJ8Yu.cjs +1 -0
- package/browser/cjs/CIpMN7SDVREKQUQE.cjs +6 -0
- package/browser/cjs/Chkqh5BZ-MJjAcPF.cjs +5 -0
- package/browser/cjs/D-8WoJkvdPf-79sB.cjs +2 -0
- package/browser/cjs/D5Y4KQhKdukOkjvA.cjs +2 -0
- package/browser/cjs/DWkuoJSgvcXJTdN1.cjs +1 -0
- package/browser/cjs/index.cjs +1 -0
- package/browser/cjs/sEmMmxaNBSY_o-Zb.cjs +1 -0
- package/browser/cjs/xQ6-wbTw5UzZUM1Y.cjs +1 -0
- package/browser/esm/B20zuEvdeypuSU5s.mjs +3851 -0
- package/browser/esm/BVAAJynubTdvPOQA.mjs +24 -0
- package/browser/esm/CLo2oPoIised6GbD.mjs +3617 -0
- package/browser/esm/COSdjubnJ_UgB-Gr.mjs +111 -0
- package/browser/esm/CS1t46OUALKkZxTa.mjs +494 -0
- package/browser/esm/CS8eRkAhoCN8KdGO.mjs +52 -0
- package/browser/esm/CcXnQZ4Fk_nkbq2G.mjs +99 -0
- package/browser/esm/Ch5gA6g56cOtRvJA.mjs +2193 -0
- package/browser/esm/DRuB-nlH4kq_OQJ5.mjs +196 -0
- package/browser/esm/DoKP-E832M9vPWgU.mjs +4675 -0
- package/browser/esm/XoDWB6uCJVrra-pE.mjs +2623 -0
- package/browser/esm/index.mjs +8 -0
- package/licenses/dependencies.txt +60 -0
- package/node/esm/B3Hb3GSFs_FIoXoI.mjs +209 -0
- package/node/esm/BqwG-e5ddQ45fg8w.mjs +2702 -0
- package/node/esm/C81WoKHbCRwhcHWd.mjs +2413 -0
- package/node/esm/CIzCy_gyysEIa_HI.mjs +3700 -0
- package/node/esm/CL8002u21KKQkkL0.mjs +108 -0
- package/node/esm/DF893ovKIDS88O7b.mjs +2237 -0
- package/node/esm/DTuPlHBTHnbLGvxd.mjs +504 -0
- package/node/esm/DVJuJqAXDwgA-ge8.mjs +118 -0
- package/node/esm/index.mjs +52 -0
- package/package.json +55 -0
- package/types/index.d.ts +2 -0
- package/types/src/ConditionalFormatRules.d.ts +86 -0
- package/types/src/ConditionalFormatRules.d.ts.map +1 -0
- package/types/src/DataValidationRules.d.ts +59 -0
- package/types/src/DataValidationRules.d.ts.map +1 -0
- package/types/src/ExcelCompat.d.ts +142 -0
- package/types/src/ExcelCompat.d.ts.map +1 -0
- package/types/src/ExcelFunctionFacts.d.ts +375 -0
- package/types/src/ExcelFunctionFacts.d.ts.map +1 -0
- package/types/src/ExcelReservedNames.d.ts +67 -0
- package/types/src/ExcelReservedNames.d.ts.map +1 -0
- package/types/src/LegacyFormula.d.ts +74 -0
- package/types/src/LegacyFormula.d.ts.map +1 -0
- package/types/src/OOXMLEscape.d.ts +28 -0
- package/types/src/OOXMLEscape.d.ts.map +1 -0
- package/types/src/OOXMLExtensions.d.ts +53 -0
- package/types/src/OOXMLExtensions.d.ts.map +1 -0
- package/types/src/OperandLiterals.d.ts +34 -0
- package/types/src/OperandLiterals.d.ts.map +1 -0
- package/types/src/Plugin.d.ts +16 -0
- package/types/src/Plugin.d.ts.map +1 -0
- package/types/src/SourcePackage.d.ts +76 -0
- package/types/src/SourcePackage.d.ts.map +1 -0
- package/types/src/Types.d.ts +44 -0
- package/types/src/Types.d.ts.map +1 -0
- package/types/src/cfb/CompoundFileReader.d.ts +73 -0
- package/types/src/cfb/CompoundFileReader.d.ts.map +1 -0
- package/types/src/cfb/CompoundFileWriter.d.ts +57 -0
- package/types/src/cfb/CompoundFileWriter.d.ts.map +1 -0
- package/types/src/cfb/index.d.ts +3 -0
- package/types/src/cfb/index.d.ts.map +1 -0
- package/types/src/index.d.ts +3 -0
- package/types/src/index.d.ts.map +1 -0
- package/types/src/legacyChart/OOXMLMappings.d.ts +8 -0
- package/types/src/legacyChart/OOXMLMappings.d.ts.map +1 -0
- package/types/src/legacyChart/OOXMLUtils.d.ts +78 -0
- package/types/src/legacyChart/OOXMLUtils.d.ts.map +1 -0
- package/types/src/legacyChart/ToOOXMLConverter.d.ts +30 -0
- package/types/src/legacyChart/ToOOXMLConverter.d.ts.map +1 -0
- package/types/src/offcrypto/AgileCrypto.d.ts +85 -0
- package/types/src/offcrypto/AgileCrypto.d.ts.map +1 -0
- package/types/src/offcrypto/EncryptionInfo.d.ts +109 -0
- package/types/src/offcrypto/EncryptionInfo.d.ts.map +1 -0
- package/types/src/offcrypto/LazyOffCryptoEncryption.d.ts +18 -0
- package/types/src/offcrypto/LazyOffCryptoEncryption.d.ts.map +1 -0
- package/types/src/offcrypto/OffCryptoEncryption.d.ts +15 -0
- package/types/src/offcrypto/OffCryptoEncryption.d.ts.map +1 -0
- package/types/src/offcrypto/index.d.ts +5 -0
- package/types/src/offcrypto/index.d.ts.map +1 -0
- package/types/src/reader/DummyFunctionUnwrap.d.ts +58 -0
- package/types/src/reader/DummyFunctionUnwrap.d.ts.map +1 -0
- package/types/src/reader/ReaderProfiler.d.ts +45 -0
- package/types/src/reader/ReaderProfiler.d.ts.map +1 -0
- package/types/src/reader/ReaderUtils.d.ts +66 -0
- package/types/src/reader/ReaderUtils.d.ts.map +1 -0
- package/types/src/reader/XLSXReader.d.ts +11 -0
- package/types/src/reader/XLSXReader.d.ts.map +1 -0
- package/types/src/reader/ZipReader.d.ts +62 -0
- package/types/src/reader/ZipReader.d.ts.map +1 -0
- package/types/src/reader/dom/DOMTransformer.d.ts +22 -0
- package/types/src/reader/dom/DOMTransformer.d.ts.map +1 -0
- package/types/src/reader/dom/DefaultVisitor.d.ts +8 -0
- package/types/src/reader/dom/DefaultVisitor.d.ts.map +1 -0
- package/types/src/reader/dom/ExecutionContext.d.ts +78 -0
- package/types/src/reader/dom/ExecutionContext.d.ts.map +1 -0
- package/types/src/reader/dom/NumberUtils.d.ts +17 -0
- package/types/src/reader/dom/NumberUtils.d.ts.map +1 -0
- package/types/src/reader/dom/Types.d.ts +27 -0
- package/types/src/reader/dom/Types.d.ts.map +1 -0
- package/types/src/reader/dom/VisitContext.d.ts +10 -0
- package/types/src/reader/dom/VisitContext.d.ts.map +1 -0
- package/types/src/reader/dom/Visitor.d.ts +23 -0
- package/types/src/reader/dom/Visitor.d.ts.map +1 -0
- package/types/src/reader/dom/VisitorUtils.d.ts +16 -0
- package/types/src/reader/dom/VisitorUtils.d.ts.map +1 -0
- package/types/src/reader/dom/index.d.ts +7 -0
- package/types/src/reader/dom/index.d.ts.map +1 -0
- package/types/src/reader/domVisitors/AppPropertiesVisitor.d.ts +11 -0
- package/types/src/reader/domVisitors/AppPropertiesVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/AutoFilterVisitor.d.ts +25 -0
- package/types/src/reader/domVisitors/AutoFilterVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/AxisVisitor.d.ts +12 -0
- package/types/src/reader/domVisitors/AxisVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/BarChartTypeVisitor.d.ts +6 -0
- package/types/src/reader/domVisitors/BarChartTypeVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/ChartSpaceVisitor.d.ts +6 -0
- package/types/src/reader/domVisitors/ChartSpaceVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/ChartTypeVisitor.d.ts +7 -0
- package/types/src/reader/domVisitors/ChartTypeVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/ChartVisitor.d.ts +7 -0
- package/types/src/reader/domVisitors/ChartVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/ClrSchemeVisitor.d.ts +7 -0
- package/types/src/reader/domVisitors/ClrSchemeVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/ColorContainerVisitor.d.ts +37 -0
- package/types/src/reader/domVisitors/ColorContainerVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/CommentVisitor.d.ts +6 -0
- package/types/src/reader/domVisitors/CommentVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/CommentsVisitor.d.ts +7 -0
- package/types/src/reader/domVisitors/CommentsVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/CorePropertiesVisitor.d.ts +11 -0
- package/types/src/reader/domVisitors/CorePropertiesVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/DataLabelsVisitor.d.ts +8 -0
- package/types/src/reader/domVisitors/DataLabelsVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/DataPointVisitor.d.ts +6 -0
- package/types/src/reader/domVisitors/DataPointVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/DrawingAnchorVisitor.d.ts +8 -0
- package/types/src/reader/domVisitors/DrawingAnchorVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/DrawingCxnSpVisitor.d.ts +7 -0
- package/types/src/reader/domVisitors/DrawingCxnSpVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/DrawingElementVisitor.d.ts +6 -0
- package/types/src/reader/domVisitors/DrawingElementVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/DrawingGraphicFrameVisitor.d.ts +7 -0
- package/types/src/reader/domVisitors/DrawingGraphicFrameVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/DrawingGrpSpVisitor.d.ts +7 -0
- package/types/src/reader/domVisitors/DrawingGrpSpVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/DrawingPicVisitor.d.ts +7 -0
- package/types/src/reader/domVisitors/DrawingPicVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/DrawingSpVisitor.d.ts +7 -0
- package/types/src/reader/domVisitors/DrawingSpVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/DrawingVisitor.d.ts +5 -0
- package/types/src/reader/domVisitors/DrawingVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/ExternalLinkVisitor.d.ts +32 -0
- package/types/src/reader/domVisitors/ExternalLinkVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/FmtSchemeVisitor.d.ts +22 -0
- package/types/src/reader/domVisitors/FmtSchemeVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/FontSchemeVisitor.d.ts +7 -0
- package/types/src/reader/domVisitors/FontSchemeVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/HyperlinkVisitor.d.ts +6 -0
- package/types/src/reader/domVisitors/HyperlinkVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/LayoutVisitor.d.ts +5 -0
- package/types/src/reader/domVisitors/LayoutVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/LegendEntryVisitor.d.ts +5 -0
- package/types/src/reader/domVisitors/LegendEntryVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/LegendVisitor.d.ts +5 -0
- package/types/src/reader/domVisitors/LegendVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/MarkerVisitor.d.ts +5 -0
- package/types/src/reader/domVisitors/MarkerVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/MetadataVisitor.d.ts +104 -0
- package/types/src/reader/domVisitors/MetadataVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/NegativeShapeVisitor.d.ts +6 -0
- package/types/src/reader/domVisitors/NegativeShapeVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/OOXMLVisitorUtils.d.ts +3 -0
- package/types/src/reader/domVisitors/OOXMLVisitorUtils.d.ts.map +1 -0
- package/types/src/reader/domVisitors/PersonListVisitor.d.ts +5 -0
- package/types/src/reader/domVisitors/PersonListVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/PlotAreaVisitor.d.ts +5 -0
- package/types/src/reader/domVisitors/PlotAreaVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/PresetTableStylesVisitor.d.ts +8 -0
- package/types/src/reader/domVisitors/PresetTableStylesVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/RelsVisitor.d.ts +9 -0
- package/types/src/reader/domVisitors/RelsVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/RichValueDataVisitor.d.ts +7 -0
- package/types/src/reader/domVisitors/RichValueDataVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/RichValueStructureVisitor.d.ts +6 -0
- package/types/src/reader/domVisitors/RichValueStructureVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/SeriesVisitor.d.ts +8 -0
- package/types/src/reader/domVisitors/SeriesVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/ShapePropertiesVisitor.d.ts +6 -0
- package/types/src/reader/domVisitors/ShapePropertiesVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/SheetColorContainerVisitor.d.ts +28 -0
- package/types/src/reader/domVisitors/SheetColorContainerVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/SheetStyleVisitor.d.ts +20 -0
- package/types/src/reader/domVisitors/SheetStyleVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/SlicerCacheDefinitionVisitor.d.ts +6 -0
- package/types/src/reader/domVisitors/SlicerCacheDefinitionVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/SlicersVisitor.d.ts +7 -0
- package/types/src/reader/domVisitors/SlicersVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/SortStateVisitor.d.ts +8 -0
- package/types/src/reader/domVisitors/SortStateVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/TableVisitor.d.ts +10 -0
- package/types/src/reader/domVisitors/TableVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/TableX14Visitor.d.ts +6 -0
- package/types/src/reader/domVisitors/TableX14Visitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/TextPropertiesVisitor.d.ts +11 -0
- package/types/src/reader/domVisitors/TextPropertiesVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/ThemeVisitor.d.ts +6 -0
- package/types/src/reader/domVisitors/ThemeVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/ThreadedCommentVisitor.d.ts +9 -0
- package/types/src/reader/domVisitors/ThreadedCommentVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/ThreadedCommentsVisitor.d.ts +6 -0
- package/types/src/reader/domVisitors/ThreadedCommentsVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/TitleVisitor.d.ts +9 -0
- package/types/src/reader/domVisitors/TitleVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/WorkbookVisitor.d.ts +30 -0
- package/types/src/reader/domVisitors/WorkbookVisitor.d.ts.map +1 -0
- package/types/src/reader/domVisitors/index.d.ts +101 -0
- package/types/src/reader/domVisitors/index.d.ts.map +1 -0
- package/types/src/reader/sax/SaxParser.d.ts +34 -0
- package/types/src/reader/sax/SaxParser.d.ts.map +1 -0
- package/types/src/reader/sax/SaxVisitor.d.ts +59 -0
- package/types/src/reader/sax/SaxVisitor.d.ts.map +1 -0
- package/types/src/reader/sax/Saxes.d.ts +641 -0
- package/types/src/reader/sax/Saxes.d.ts.map +1 -0
- package/types/src/reader/sax/index.d.ts +3 -0
- package/types/src/reader/sax/index.d.ts.map +1 -0
- package/types/src/reader/sax/xmlchars/xml/1.0/ed4.d.ts +32 -0
- package/types/src/reader/sax/xmlchars/xml/1.0/ed4.d.ts.map +1 -0
- package/types/src/reader/sax/xmlchars/xml/1.0/ed5.d.ts +52 -0
- package/types/src/reader/sax/xmlchars/xml/1.0/ed5.d.ts.map +1 -0
- package/types/src/reader/sax/xmlchars/xml/1.1/ed2.d.ts +74 -0
- package/types/src/reader/sax/xmlchars/xml/1.1/ed2.d.ts.map +1 -0
- package/types/src/reader/sax/xmlchars/xmlns/1.0/ed3.d.ts +29 -0
- package/types/src/reader/sax/xmlchars/xmlns/1.0/ed3.d.ts.map +1 -0
- package/types/src/reader/saxVisitors/ContentTypesVisitor.d.ts +54 -0
- package/types/src/reader/saxVisitors/ContentTypesVisitor.d.ts.map +1 -0
- package/types/src/reader/saxVisitors/SharedStringsVisitor.d.ts +22 -0
- package/types/src/reader/saxVisitors/SharedStringsVisitor.d.ts.map +1 -0
- package/types/src/reader/saxVisitors/WorksheetVisitor.d.ts +25 -0
- package/types/src/reader/saxVisitors/WorksheetVisitor.d.ts.map +1 -0
- package/types/src/vba/CompoundDocumentCompression.d.ts +37 -0
- package/types/src/vba/CompoundDocumentCompression.d.ts.map +1 -0
- package/types/src/vba/VBAProject.d.ts +47 -0
- package/types/src/vba/VBAProject.d.ts.map +1 -0
- package/types/src/vba/index.d.ts +3 -0
- package/types/src/vba/index.d.ts.map +1 -0
- package/types/src/writer/XLSXWriter.d.ts +4 -0
- package/types/src/writer/XLSXWriter.d.ts.map +1 -0
- package/types/src/writer/builder/ContentTypes.d.ts +18 -0
- package/types/src/writer/builder/ContentTypes.d.ts.map +1 -0
- package/types/src/writer/builder/Emitter.d.ts +25 -0
- package/types/src/writer/builder/Emitter.d.ts.map +1 -0
- package/types/src/writer/builder/EmitterRegistry.d.ts +29 -0
- package/types/src/writer/builder/EmitterRegistry.d.ts.map +1 -0
- package/types/src/writer/builder/OpcXmlUtils.d.ts +26 -0
- package/types/src/writer/builder/OpcXmlUtils.d.ts.map +1 -0
- package/types/src/writer/builder/PackageBuilder.d.ts +148 -0
- package/types/src/writer/builder/PackageBuilder.d.ts.map +1 -0
- package/types/src/writer/builder/PartWriter.d.ts +24 -0
- package/types/src/writer/builder/PartWriter.d.ts.map +1 -0
- package/types/src/writer/builder/RelationshipSet.d.ts +18 -0
- package/types/src/writer/builder/RelationshipSet.d.ts.map +1 -0
- package/types/src/writer/builder/Types.d.ts +311 -0
- package/types/src/writer/builder/Types.d.ts.map +1 -0
- package/types/src/writer/builder/Utils.d.ts +63 -0
- package/types/src/writer/builder/Utils.d.ts.map +1 -0
- package/types/src/writer/builder/XmlWriter.d.ts +3 -0
- package/types/src/writer/builder/XmlWriter.d.ts.map +1 -0
- package/types/src/writer/builder/ZipBackend.d.ts +21 -0
- package/types/src/writer/builder/ZipBackend.d.ts.map +1 -0
- package/types/src/writer/builder/_Types.d.ts +102 -0
- package/types/src/writer/builder/_Types.d.ts.map +1 -0
- package/types/src/writer/builder/index.d.ts +6 -0
- package/types/src/writer/builder/index.d.ts.map +1 -0
- package/types/src/writer/emitters/ChartColorsEmitter.d.ts +7 -0
- package/types/src/writer/emitters/ChartColorsEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/ChartEmitter.d.ts +14 -0
- package/types/src/writer/emitters/ChartEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/ChartStyleEmitter.d.ts +46 -0
- package/types/src/writer/emitters/ChartStyleEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/DrawingEmitter.d.ts +15 -0
- package/types/src/writer/emitters/DrawingEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/MetadataEmitter.d.ts +8 -0
- package/types/src/writer/emitters/MetadataEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/PropsAppEmitter.d.ts +12 -0
- package/types/src/writer/emitters/PropsAppEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/PropsCoreEmitter.d.ts +7 -0
- package/types/src/writer/emitters/PropsCoreEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/RichValueEmitter.d.ts +8 -0
- package/types/src/writer/emitters/RichValueEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/RichValueStructureEmitter.d.ts +28 -0
- package/types/src/writer/emitters/RichValueStructureEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/RichValueTypesEmitter.d.ts +10 -0
- package/types/src/writer/emitters/RichValueTypesEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/SharedStringsEmitter.d.ts +13 -0
- package/types/src/writer/emitters/SharedStringsEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/StylesEmitter.d.ts +17 -0
- package/types/src/writer/emitters/StylesEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/TableEmitter.d.ts +14 -0
- package/types/src/writer/emitters/TableEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/ThemeEmitter.d.ts +16 -0
- package/types/src/writer/emitters/ThemeEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/WorkbookEmitter.d.ts +11 -0
- package/types/src/writer/emitters/WorkbookEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/WorksheetEmitter.d.ts +18 -0
- package/types/src/writer/emitters/WorksheetEmitter.d.ts.map +1 -0
- package/types/src/writer/emitters/index.d.ts +3 -0
- package/types/src/writer/emitters/index.d.ts.map +1 -0
- package/types/src/writer/utils/AutoFilter.d.ts +15 -0
- package/types/src/writer/utils/AutoFilter.d.ts.map +1 -0
- package/types/src/writer/utils/ColorUtils.d.ts +46 -0
- package/types/src/writer/utils/ColorUtils.d.ts.map +1 -0
- package/types/src/writer/utils/DrawMLUtils.d.ts +26 -0
- package/types/src/writer/utils/DrawMLUtils.d.ts.map +1 -0
- package/types/src/writer/utils/DummyFunction.d.ts +66 -0
- package/types/src/writer/utils/DummyFunction.d.ts.map +1 -0
- package/types/src/writer/utils/DxfCollector.d.ts +22 -0
- package/types/src/writer/utils/DxfCollector.d.ts.map +1 -0
- package/types/src/writer/utils/ExtLstUtils.d.ts +3 -0
- package/types/src/writer/utils/ExtLstUtils.d.ts.map +1 -0
- package/types/src/writer/utils/IDUtils.d.ts +2 -0
- package/types/src/writer/utils/IDUtils.d.ts.map +1 -0
- package/types/src/writer/utils/MetadataCollector.d.ts +146 -0
- package/types/src/writer/utils/MetadataCollector.d.ts.map +1 -0
- package/types/src/writer/utils/ProtectionUtils.d.ts +3 -0
- package/types/src/writer/utils/ProtectionUtils.d.ts.map +1 -0
- package/types/src/writer/utils/RichValueCollector.d.ts +200 -0
- package/types/src/writer/utils/RichValueCollector.d.ts.map +1 -0
- package/types/src/writer/utils/TextUtils.d.ts +8 -0
- package/types/src/writer/utils/TextUtils.d.ts.map +1 -0
- package/types/src/writer/utils/UnsupportedFunctions.d.ts +19 -0
- package/types/src/writer/utils/UnsupportedFunctions.d.ts.map +1 -0
- package/types/src/writer/utils/VersionUtils.d.ts +26 -0
- package/types/src/writer/utils/VersionUtils.d.ts.map +1 -0
|
@@ -0,0 +1,375 @@
|
|
|
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
|
+
/** Future-function prefix. */
|
|
40
|
+
export declare const XLFN = "_xlfn.";
|
|
41
|
+
/**
|
|
42
|
+
* Worksheet-only function prefix (always written doubled, `_xlfn._xlws.`) — usable in cells but
|
|
43
|
+
* not in defined names, conditional formatting, or data validation. In Excel 2019 these were
|
|
44
|
+
* written as `_xlfn._xlws.`, but modern Excel allows just `_xlws.`?
|
|
45
|
+
*/
|
|
46
|
+
export declare const XLWS = "_xlfn._xlws.";
|
|
47
|
+
/**
|
|
48
|
+
* One function's facts. Every field is OPTIONAL and every absence keeps the old table's default —
|
|
49
|
+
* see each field for what its absence means.
|
|
50
|
+
*/
|
|
51
|
+
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
|
+
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
|
+
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
|
+
intersect?: 'never';
|
|
148
|
+
/**
|
|
149
|
+
* Per-SLOT suppressions — the function intersects normally at other slots and never at these
|
|
150
|
+
* (the item-44 per-slot residue), keyed by flattened slot index.
|
|
151
|
+
*
|
|
152
|
+
* Same sweep and join as {@link intersect}. Each row is the measured `.Formula`→`.Formula2`
|
|
153
|
+
* readback: `=TEXTJOIN(D1:D5,A1,A1)` comes back UNTOUCHED while `=TEXTJOIN(A1,@D1:D5,A1)` gains
|
|
154
|
+
* its `@`. `XLOOKUP` slot 3 (`if_not_found`) is suppressed on the ARGUMENT and the range then
|
|
155
|
+
* survives to the ROOT, which is exactly what Excel stores (`=@XLOOKUP(A1,A1,A1,D1:D5)`) — the
|
|
156
|
+
* root rule reaches it through `_foldReferenceExtent`.
|
|
157
|
+
*
|
|
158
|
+
* NO ENTRY IS NEEDED for `IFERROR`/`IFNA` slot 1, though Excel never intersects it
|
|
159
|
+
* (`=@IFERROR(A1,D1:D5)` wraps the CALL instead). The declaration carries it: `valueIfError` is
|
|
160
|
+
* a forwarded BRANCH (`AcceptError<any>`), so it accepts a range and the default rule already
|
|
161
|
+
* answers "not a site". It sat here as a pending suppression only while the parameter was
|
|
162
|
+
* mis-declared `Scalar` — which was also answering `5` for `=SUM(IFERROR(1,A1:A5))` where Excel
|
|
163
|
+
* answers `1`. See {@link valueReturn} for the half of that story Excel does not share with us.
|
|
164
|
+
*/
|
|
165
|
+
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
|
+
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
|
+
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
|
+
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
|
+
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
|
+
arrayScope?: 'opens' | 'consumer' | 'lazy';
|
|
293
|
+
/**
|
|
294
|
+
* Per-SLOT subtree clears — the scope survives the function itself but turns OFF inside these
|
|
295
|
+
* argument subtrees, keyed by flattened slot index. The round-4 finding that made clearing
|
|
296
|
+
* per-slot: one verdict per function cannot say both of
|
|
297
|
+
*
|
|
298
|
+
* ```text
|
|
299
|
+
* =SUMPRODUCT(CHOOSE(A1:A3,1,2,3)) stays plain the scope still governs CHOOSE's OWN
|
|
300
|
+
* slot sites (battery S11)
|
|
301
|
+
* =SUMPRODUCT(CHOOSE(ABS(B2:B22),1,2)) ABS(@B2:B22) …but does NOT continue into a deeper
|
|
302
|
+
* subtree (round 4)
|
|
303
|
+
* ```
|
|
304
|
+
*
|
|
305
|
+
* so this fact clears the scope for the SLOT'S SUBTREE while the function's own argument
|
|
306
|
+
* positions stay governed by the scope it inherited. A whole-function `'consumer'`/`'lazy'`
|
|
307
|
+
* row also turns the scope off for the function's own sites (`TRANSPOSE`'s forced site fires
|
|
308
|
+
* under `SUMPRODUCT` — battery S10; `IFERROR`'s value slot takes its `@` — S9); this per-slot
|
|
309
|
+
* fact does not (`MATCH`'s forced `lookupValue` site stays suppressed under a scope, measured).
|
|
310
|
+
*
|
|
311
|
+
* Beats {@link arrayScope}`: 'opens'` for the named slot (`XLOOKUP`/`REDUCE` open at their
|
|
312
|
+
* array slots and clear at these).
|
|
313
|
+
*/
|
|
314
|
+
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
|
+
volatile?: true;
|
|
335
|
+
}
|
|
336
|
+
/**
|
|
337
|
+
* The map itself — every name exactly once, grouped by the family that explains it (a function
|
|
338
|
+
* with facts from several families is homed with the family whose prose carries its story, its
|
|
339
|
+
* other facts inline). Membership within a section is alphabetical.
|
|
340
|
+
*/
|
|
341
|
+
export declare const ExcelFunctionFacts: ReadonlyMap<string, ExcelFunctionFact>;
|
|
342
|
+
/** The row itself — for the drift lint and diagnostics, not for call sites. */
|
|
343
|
+
export declare const getExcelFunctionFact: (name: string) => ExcelFunctionFact | undefined;
|
|
344
|
+
/**
|
|
345
|
+
* Is `name` (upper-cased) an Excel built-in our registry implements — i.e. does a bare use of it
|
|
346
|
+
* write `_xleta.`? A row that is not {@link ExcelFunctionFact.unimplemented}.
|
|
347
|
+
*/
|
|
348
|
+
export declare const isExcelBuiltIn: (name: string) => boolean;
|
|
349
|
+
/** The on-disk write prefix for `name` (upper-cased), or `undefined` to write it bare. */
|
|
350
|
+
export declare const getLegacyPrefix: (name: string) => string | undefined;
|
|
351
|
+
/** Does Excel never intersect into `name` at ANY argument (item 44)? */
|
|
352
|
+
export declare const excelNeverIntersects: (name: string) => boolean;
|
|
353
|
+
/** Is `slot` (flattened) a measured per-slot suppression of `name`? */
|
|
354
|
+
export declare const excelNeverIntersectsAt: (name: string, slot: number) => boolean;
|
|
355
|
+
/** Is `slot` (flattened) a measured forced site of `name` ("consumed whole")? */
|
|
356
|
+
export declare const excelAlwaysIntersectsAt: (name: string, slot: number) => boolean;
|
|
357
|
+
/** Does Excel treat `name`'s return as an ARRAY despite its declaration? */
|
|
358
|
+
export declare const isExcelArrayReturn: (name: string) => boolean;
|
|
359
|
+
/** Does `name` promise a single value it cannot always deliver (rule 3's inner half)? */
|
|
360
|
+
export declare const isExcelValueReturn: (name: string) => boolean;
|
|
361
|
+
/** The slot whose reference `name` reads per cell (item 46), or `undefined` for none. */
|
|
362
|
+
export declare const excelReadsPerCellSlot: (name: string) => number | undefined;
|
|
363
|
+
/** Do `name`'s range-accepting slots open an array scope over their subtree? */
|
|
364
|
+
export declare const excelOpensArrayScope: (name: string) => boolean;
|
|
365
|
+
/**
|
|
366
|
+
* Does `name` clear an inherited array scope (a `'consumer'` or `'lazy'` row — the two are
|
|
367
|
+
* separate spellings because their REASONS are unrelated, and identical only in effect)?
|
|
368
|
+
* Everything that neither opens nor clears inherits.
|
|
369
|
+
*/
|
|
370
|
+
export declare const excelClearsArrayScope: (name: string) => boolean;
|
|
371
|
+
/** Does `slot` (flattened) of `name` clear the scope for its SUBTREE only ({@link ExcelFunctionFact.scopeClears})? */
|
|
372
|
+
export declare const excelScopeClearsAt: (name: string, slot: number) => boolean;
|
|
373
|
+
/** Is `name` on Excel's volatile-function list (the `ca="1"` source)? */
|
|
374
|
+
export declare const isExcelVolatile: (name: string) => boolean;
|
|
375
|
+
//# sourceMappingURL=ExcelFunctionFacts.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ExcelFunctionFacts.d.ts","sourceRoot":"","sources":["../../../src/ExcelFunctionFacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,8BAA8B;AAC9B,eAAO,MAAM,IAAI,WAAW,CAAC;AAE7B;;;;GAIG;AACH,eAAO,MAAM,IAAI,iBAAiB,CAAC;AAEnC;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IAC3C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAmuBpE,CAAC;AAOH,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,iBAAiB,GAAG,SAC1C,CAAC;AAE/B;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,OAG7C,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SAClB,CAAC;AAEvC,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,OACC,CAAC;AAEtD,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,OACF,CAAC;AAEnE,iFAAiF;AACjF,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,OACF,CAAC;AAEpE,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,OACE,CAAC;AAErD,yFAAyF;AACzF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,OACE,CAAC;AAErD,yFAAyF;AACzF,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SAClB,CAAC;AAE7C,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,OACE,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,OAGpD,CAAC;AAEF,sHAAsH;AACtH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,OACI,CAAC;AAErE,yEAAyE;AACzE,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,OACE,CAAC"}
|
|
@@ -0,0 +1,67 @@
|
|
|
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
|
+
export declare const ExcelReservedNames: ReadonlySet<string>;
|
|
67
|
+
//# sourceMappingURL=ExcelReservedNames.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ExcelReservedNames.d.ts","sourceRoot":"","sources":["../../../src/ExcelReservedNames.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CA2FjD,CAAC"}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import { ICalculation } from '@sheetxl/sdk';
|
|
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
|
+
*
|
|
21
|
+
* MS-XLSX Extensions to Office Open XML section 2.2.2 Formula:
|
|
22
|
+
* https://learn.microsoft.com/en-us/openspecs/office_standards/ms-xlsx/3d025add-118d-4413-9856-ab65712ec1b0
|
|
23
|
+
*/
|
|
24
|
+
/**
|
|
25
|
+
* Eta-reduced-lambda prefix — a BUILT-IN function referenced WITHOUT parentheses
|
|
26
|
+
* (`=BYROW(A1:B3,SUM)`, and equally `=SUM(ABS)` or `=1+ABS`: Excel prefixes it wherever it
|
|
27
|
+
* appears, not only in lambda-taking slots). A user-defined name (bound to LAMBDA) stays bare.
|
|
28
|
+
* Measured: `spreadsheetbench/formula-tests/probe-xleta*.ps1`, `probe-bare-name.ps1`.
|
|
29
|
+
*/
|
|
30
|
+
export declare const XLETA = "_xleta.";
|
|
31
|
+
/**
|
|
32
|
+
* Lambda-parameter prefix (`_xlpm.name`), stripped on read.
|
|
33
|
+
*
|
|
34
|
+
* Not cosmetic: a BARE parameter name is a syntax violation in that position, not an unknown
|
|
35
|
+
* name, and Excel REFUSES TO OPEN a workbook that contains one — repair prompt, and the repaired
|
|
36
|
+
* cell holds a literal `#NAME?`. See {@link _prefixScopeParameters}.
|
|
37
|
+
*/
|
|
38
|
+
export declare const XLPM = "_xlpm.";
|
|
39
|
+
/**
|
|
40
|
+
* Optional-parameter prefix (`_xlop.name`) — the DECLARATION spelling of `[b]`; every use of the
|
|
41
|
+
* parameter stays `_xlpm.` (measured, application §2.6). Read restores the flag, not the brackets:
|
|
42
|
+
* the display form re-images from `NamedRef.optional`.
|
|
43
|
+
*/
|
|
44
|
+
export declare const XLOP = "_xlop.";
|
|
45
|
+
/**
|
|
46
|
+
* The write direction: modern (dynamic) tree → on-disk xlsx spellings, as an
|
|
47
|
+
* {@link ICalculation.FormulaTransform} handed to `toJSON({ formulaTransform })`.
|
|
48
|
+
*
|
|
49
|
+
* @param definedNames Upper-cased spellings of the workbook's defined names. A bare name that
|
|
50
|
+
* resolves to a REAL defined name is a name, not an eta-reduced built-in, and stays bare.
|
|
51
|
+
*
|
|
52
|
+
* @remarks
|
|
53
|
+
* Pure syntax + the measured `ExcelFunctionFacts` rows — the transform never consults the calc
|
|
54
|
+
* engine. It
|
|
55
|
+
* runs once per formula block on the compiled AST; formulas with nothing legacy in them return
|
|
56
|
+
* every node untouched, which skips recompilation entirely.
|
|
57
|
+
*/
|
|
58
|
+
export declare function createLegacyWriteTransform(definedNames?: ReadonlySet<string>): ICalculation.FormulaTransform;
|
|
59
|
+
/**
|
|
60
|
+
* The read direction: on-disk xlsx spellings → the modern (dynamic) tree, applied by the reader
|
|
61
|
+
* at parse time (`IWorkbook.ConstructorOptions.formulaTransform`).
|
|
62
|
+
*
|
|
63
|
+
* @remarks
|
|
64
|
+
* The mirror of {@link createLegacyWriteTransform}: strip `_xlfn._xlws.` BEFORE `_xlfn.`;
|
|
65
|
+
* unwrap `SINGLE`/`ANCHORARRAY`/`_TRO_*` to their operators (matched on the bare name whether
|
|
66
|
+
* or not a prefix was present — parity with the tolerance the parser used to have); strip
|
|
67
|
+
* `_xleta.`/`_xlpm.` from names. `[#This Row]` → `@` needs nothing here — that spelling is
|
|
68
|
+
* valid TYPED input and the SDK normalizes it for every dialect.
|
|
69
|
+
*
|
|
70
|
+
* Load-path only: typed text never gets this pass, so `=_xlfn.SUM(A1)` typed is an unknown
|
|
71
|
+
* name — as in Excel.
|
|
72
|
+
*/
|
|
73
|
+
export declare function createLegacyReadTransform(): ICalculation.FormulaTransform;
|
|
74
|
+
//# sourceMappingURL=LegacyFormula.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"LegacyFormula.d.ts","sourceRoot":"","sources":["../../../src/LegacyFormula.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAMlD;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,KAAK,YAAY,CAAC;AAE/B;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,WAAW,CAAC;AAE7B;;;;GAIG;AACH,eAAO,MAAM,IAAI,WAAW,CAAC;AAE7B;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACjC,YAAY,CAAC,gBAAgB,CAsD/B;AA6JD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,IAAI,YAAY,CAAC,gBAAgB,CA0CzE"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* OOXML `_xHHHH_` escaping for worksheet/shared string text (ECMA-376 §22.9.2.19,
|
|
3
|
+
* ST_Xstring). Excel stores control characters that XML cannot carry as `_xHHHH_`
|
|
4
|
+
* and protects a literal `_xHHHH_` in cell text by escaping its leading underscore
|
|
5
|
+
* as `_x005F_`.
|
|
6
|
+
*
|
|
7
|
+
* Encode and decode MUST agree on what a sequence is — lowercase `x`, hex digits in
|
|
8
|
+
* either case — or a literal the encoder fails to protect is decoded into a control
|
|
9
|
+
* character on the next read. Both regexes below are the single source of that
|
|
10
|
+
* agreement; keep them in sync.
|
|
11
|
+
*/
|
|
12
|
+
/**
|
|
13
|
+
* Decode OOXML `_xHHHH_` escape sequences. A single left-to-right pass is correct:
|
|
14
|
+
* Excel escapes a literal `_x0041_` as `_x005F_x0041_`, and decoding `_x005F_`
|
|
15
|
+
* to `_` leaves the literal `_x0041_` untouched (replaced output is not rescanned).
|
|
16
|
+
*/
|
|
17
|
+
export declare const decodeEscapes: (text: string) => string;
|
|
18
|
+
/**
|
|
19
|
+
* Encode a string for persistence: escape existing literal `_xHHHH_` sequences,
|
|
20
|
+
* then encode the control characters XML cannot carry.
|
|
21
|
+
*/
|
|
22
|
+
export declare const encodeEscapes: (str: string) => string;
|
|
23
|
+
/** Padded values need `xml:space="preserve"` or a conformant reader may drop the padding. */
|
|
24
|
+
export declare const RegExLeadingTrailingSpace: RegExp;
|
|
25
|
+
export declare const AttribsPreserveSpace: {
|
|
26
|
+
'xml:space': string;
|
|
27
|
+
};
|
|
28
|
+
//# sourceMappingURL=OOXMLEscape.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"OOXMLEscape.d.ts","sourceRoot":"","sources":["../../../src/OOXMLEscape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAK5C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,MAY3C,CAAC;AA2BF,6FAA6F;AAC7F,eAAO,MAAM,yBAAyB,EAAE,MAAkB,CAAC;AAE3D,eAAO,MAAM,oBAAoB;;CAA8B,CAAC"}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* OOXML extension-list plumbing shared by the reader and the writer.
|
|
3
|
+
*
|
|
4
|
+
* @remarks
|
|
5
|
+
* An `<ext>` element's content is identified by its `uri` attribute — a GUID Microsoft assigns per
|
|
6
|
+
* feature — not by its namespace prefix. Prefixes (`x14:`, `xm:`) are conventional but arbitrary,
|
|
7
|
+
* so the uri is the only prefix-independent discriminator, and it is what Excel itself dispatches
|
|
8
|
+
* on. The reader scopes its visitor dispatch per uri (see `SaxVisitor.scope`); the writer emits the
|
|
9
|
+
* uris verbatim.
|
|
10
|
+
*
|
|
11
|
+
* Lookups are case-insensitive: GUID casing varies by producer.
|
|
12
|
+
*/
|
|
13
|
+
/** The x14 (Excel 2010) main namespace, declared on `<ext>` elements that carry x14 content. */
|
|
14
|
+
export declare const NS_X14 = "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main";
|
|
15
|
+
/** The `xm` namespace — cross-part formula (`xm:f`) and sqref (`xm:sqref`) elements. */
|
|
16
|
+
export declare const NS_XM = "http://schemas.microsoft.com/office/excel/2006/main";
|
|
17
|
+
/** `x14:dataValidations` on the worksheet — validations whose formulas leave the sheet. */
|
|
18
|
+
export declare const EXT_URI_DATA_VALIDATIONS = "{CCE6A557-97BC-4b89-ADB6-D9C93CAAB3DF}";
|
|
19
|
+
/**
|
|
20
|
+
* `x14:conditionalFormattings` on the worksheet — dataBar extensions, custom icons, new rule types.
|
|
21
|
+
*
|
|
22
|
+
* @remarks
|
|
23
|
+
* Confirmed against an Excel-authored fixture (`cf-databar.xlsx`, 2026-08-16). Excel's twin-link
|
|
24
|
+
* matching keys on this uri: content under a different uri is still *imported* (as unlinked
|
|
25
|
+
* x14-only rules) but the legacy `x14:id` marriage is dropped on resave.
|
|
26
|
+
*/
|
|
27
|
+
export declare const EXT_URI_CONDITIONAL_FORMATTINGS = "{78C0D931-6437-407d-A8EE-F0AAD7539E65}";
|
|
28
|
+
/**
|
|
29
|
+
* A wrong spelling of {@link EXT_URI_CONDITIONAL_FORMATTINGS} this writer emitted briefly
|
|
30
|
+
* (2026-08-16, pre-launder). Never in a release, but Excel resaves of those files exist and Excel
|
|
31
|
+
* echoes the uri back — so the reader accepts it as an alias. Never written.
|
|
32
|
+
*/
|
|
33
|
+
export declare const EXT_URI_CONDITIONAL_FORMATTINGS_LEGACY_TYPO = "{78C0D931-6839-4c89-B8D6-976A2CC4E5B4}";
|
|
34
|
+
/** `x14:id` on a legacy `cfRule` — the GUID linking it to its x14 twin. */
|
|
35
|
+
export declare const EXT_URI_CF_RULE_ID = "{B025F937-C7B1-47D3-B67F-A62EFF666E3E}";
|
|
36
|
+
/** `x14:slicerList` on the worksheet. */
|
|
37
|
+
export declare const EXT_URI_SLICER_LIST = "{A8765BA9-456A-4dab-B4F3-ACF838C121DE}";
|
|
38
|
+
/** `x15:slicerList` on the worksheet (slicers on data-model tables). */
|
|
39
|
+
export declare const EXT_URI_SLICER_LIST_X15 = "{3A4CF648-6AED-40f4-86FF-DC5316D8AED3}";
|
|
40
|
+
/**
|
|
41
|
+
* Ext uris the reader recognizes but does not read, with the feature name for the warning
|
|
42
|
+
* (design §2.2 / plan Phase 5: skipped ext content warns, it never disappears silently).
|
|
43
|
+
*/
|
|
44
|
+
export declare const SKIPPED_EXT_URIS: Record<string, string>;
|
|
45
|
+
/**
|
|
46
|
+
* Ext uris skipped without a warning — presentation hints with no user data to lose.
|
|
47
|
+
*/
|
|
48
|
+
export declare const SILENT_EXT_URIS: Set<string>;
|
|
49
|
+
/** Case-insensitive key for the tables above. */
|
|
50
|
+
export declare function normalizeExtUri(uri: string | null | undefined): string;
|
|
51
|
+
/** A fresh `{GUID}` in Excel's brace-wrapped uppercase spelling, for `x14:id` twin linkage. */
|
|
52
|
+
export declare function newExtGuid(uuidV4: () => string): string;
|
|
53
|
+
//# sourceMappingURL=OOXMLExtensions.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"OOXMLExtensions.d.ts","sourceRoot":"","sources":["../../../src/OOXMLExtensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,gGAAgG;AAChG,eAAO,MAAM,MAAM,kEAAkE,CAAC;AAEtF,wFAAwF;AACxF,eAAO,MAAM,KAAK,wDAAwD,CAAC;AAE3E,2FAA2F;AAC3F,eAAO,MAAM,wBAAwB,2CAA2C,CAAC;AAEjF;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,2CAA2C,CAAC;AAExF;;;;GAIG;AACH,eAAO,MAAM,2CAA2C,2CAA2C,CAAC;AAEpG,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,2CAA2C,CAAC;AAE3E,yCAAyC;AACzC,eAAO,MAAM,mBAAmB,2CAA2C,CAAC;AAE5E,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,2CAA2C,CAAC;AAEhF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,aAE1B,CAAC;AAEH,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEtE;AAED,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,MAAM,GAAG,MAAM,CAEvD"}
|