ooxml-core 0.17.0 → 0.18.0

package/dist/docx/document-stats.d.ts

@@ -0,0 +1,18 @@
+import type { DocumentModel } from './model.js';
+export interface DocumentStats {
+    paragraphs: number;
+    tables: number;
+    sections: number;
+    characters: number;
+    charactersWithSpaces: number;
+    comments: number;
+    revisions: number;
+}
+/** Facts for the File > Info page: counts of what the model holds, not layout results. */
+export declare function documentStats(model: DocumentModel): DocumentStats;
+/**
+ * The document as plain text for File > Export: one line per paragraph, table cells separated by
+ * tabs. Formatting, pictures and notes are not exported.
+ */
+export declare function plainText(model: DocumentModel): string;
+//# sourceMappingURL=document-stats.d.ts.map

package/dist/docx/document-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-stats.d.ts","sourceRoot":"","sources":["../../src/docx/document-stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,aAAa,EAAE,MAAM,YAAY,CAAC;AAGvD,MAAM,WAAW,aAAa;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CAClB;AAmBD,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAmBjE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAUtD"}

package/dist/docx/index.cjs

@@ -9631,6 +9631,38 @@ function resolveCellVisuals(table, cell, placement, styles) {
   return { borders, ...shadingFill ? { shadingFill } : {} };
 }
 
+// src/docx/document-stats.ts
+function visibleText(paragraph) {
+  return paragraph.runs.filter((run) => !run.fieldCode && !run.fieldChar).filter((run) => run.revision?.kind !== "delete" && run.revision?.kind !== "moveFrom").map((run) => run.text).join("");
+}
+function paragraphsOf3(blocks) {
+  return blocks.flatMap(
+    (block) => block.type === "paragraph" ? [block] : block.rows.flatMap((row) => row.flatMap((cell) => cell.paragraphs))
+  );
+}
+function documentStats(model) {
+  const paragraphs = paragraphsOf3(model.blocks);
+  const text = paragraphs.map(visibleText).join("");
+  const revisions = paragraphs.reduce(
+    (count, paragraph) => count + paragraph.runs.filter((run) => run.revision).length + (paragraph.markRevision ? 1 : 0),
+    0
+  );
+  return {
+    paragraphs: paragraphs.length,
+    tables: model.blocks.filter((block) => block.type === "table").length,
+    sections: model.sections?.length ?? 1,
+    characters: [...text.replace(/\s/g, "")].length,
+    charactersWithSpaces: [...text].length,
+    comments: model.comments?.length ?? 0,
+    revisions
+  };
+}
+function plainText2(model) {
+  return model.blocks.map(
+    (block) => block.type === "paragraph" ? visibleText(block) : block.rows.map((row) => row.map((cell) => cell.paragraphs.map(visibleText).join(" ")).join("	")).join("\n")
+  ).join("\n");
+}
+
 exports.DEFAULT_STYLES_XML = DEFAULT_STYLES_XML;
 exports.DEFAULT_TABLE_BORDERS = DEFAULT_TABLE_BORDERS;
 exports.DEFAULT_TOC_INSTRUCTION = DEFAULT_TOC_INSTRUCTION;
@@ -9764,6 +9796,7 @@ exports.defaultStyleCatalogs = defaultStyleCatalogs;
 exports.diagramColorTheme = diagramColorTheme;
 exports.diagramsIn = diagramsIn;
 exports.displayListLabel = displayListLabel;
+exports.documentStats = documentStats;
 exports.eighthPoints = eighthPoints;
 exports.eighthPointsFromPoints = eighthPointsFromPoints;
 exports.eighthPointsToPoints = eighthPointsToPoints;
@@ -9914,6 +9947,7 @@ exports.parseTheme = parseTheme;
 exports.parseTintShade = parseTintShade;
 exports.parseTwips = parseTwips;
 exports.parseUnsignedInteger = parseUnsignedInteger;
+exports.plainText = plainText2;
 exports.rejectAllRevisions = rejectAllRevisions;
 exports.rejectRevision = rejectRevision;
 exports.reportParseWarning = reportParseWarning;

package/dist/docx/index.d.ts

@@ -37,4 +37,5 @@ export type { ParagraphAlign, ParsedJustification } from './paragraph-alignment.
 export { withParseWarnings, enumValue, reportParseWarning } from './parse-diagnostics.js';
 export { PROPERTY_FIELDS, type DocumentProperties } from './core-properties.js';
 export { captionParagraphs, isCaptionOf, tableOfFiguresInstruction, tocCaptionLabel, } from './table-of-figures.js';
+export * from './document-stats.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/docx/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docx/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docx/index.ts"],"names":[],"mappings":"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"}

package/dist/docx/index.mjs

@@ -9625,4 +9625,36 @@ function resolveCellVisuals(table, cell, placement, styles) {
   return { borders, ...shadingFill ? { shadingFill } : {} };
 }
 
-export { DEFAULT_STYLES_XML, DEFAULT_TABLE_BORDERS, DEFAULT_TOC_INSTRUCTION, DIAGRAM_GRAPHIC_URI, DocxModelValidationError, EMPTY_FIGURES_TEXT, EMPTY_TOC_TEXT, EMU_PER_INCH, EMU_PER_PIXEL, EMU_PER_POINT, LIGATURE_VALUES, PIXELS_PER_INCH, PROPERTY_FIELDS, ST_AlgClass, ST_AlgType, ST_AnnotationVMerge, ST_Border, ST_BrClear, ST_BrType, ST_CalendarType, ST_CaptionPos, ST_ChapterSep, ST_CharacterSpacing, ST_CombineBrackets, ST_ConformanceClass, ST_CryptProv, ST_Direction, ST_DisplacedByCustomXml, ST_DocGrid, ST_DocPartBehavior, ST_DocPartGallery, ST_DocPartType, ST_DocProtect, ST_DropCap, ST_EdGrp, ST_EdnPos, ST_Em, ST_FFTextType, ST_FldCharType, ST_FontFamily, ST_FrameLayout, ST_FrameScrollbar, ST_FtnEdn, ST_FtnPos, ST_HAnchor, ST_HdrFtr, ST_HeightRule, ST_HexColorAuto, ST_HighlightColor, ST_Hint, ST_InfoTextType, ST_Jc, ST_JcTable, ST_LevelSuffix, ST_LineNumberRestart, ST_LineSpacingRule, ST_Lock, ST_MailMergeDest, ST_MailMergeDocType, ST_MailMergeOdsoFMDFieldType, ST_MailMergeSourceType, ST_Merge, ST_MultiLevelType, ST_NumberFormat, ST_ObjectDrawAspect, ST_ObjectUpdateMode, ST_OnOff1, ST_PTabAlignment, ST_PTabLeader, ST_PTabRelativeTo, ST_PageBorderDisplay, ST_PageBorderOffset, ST_PageBorderZOrder, ST_PageOrientation, ST_Pitch, ST_Proof, ST_ProofErr, ST_RelFromH, ST_RelFromV, ST_RestartNumber, ST_RubyAlign, ST_SchemeColorVal, ST_SdtDateMappingType, ST_SectionMark, ST_Shd, ST_StyleSort, ST_StyleType, ST_TabJc, ST_TabTlc, ST_TargetScreenSz, ST_TblLayoutType, ST_TblOverlap, ST_TblStyleOverrideType, ST_TblWidth, ST_TextAlignment, ST_TextDirection, ST_TextEffect, ST_TextboxTightWrap, ST_Theme, ST_ThemeColor, ST_TrueFalse, ST_TrueFalseBlank, ST_Underline, ST_VAnchor, ST_VerticalAlignRun, ST_VerticalJc, ST_View, ST_WmlColorSchemeIndex, ST_Wrap, ST_XAlign, ST_YAlign, ST_Zoom, TWIPS_PER_INCH, TWIPS_PER_POINT, WORD_HIGHLIGHT_TOKENS, WORD_UNDERLINE_TOKENS, acceptAllRevisions, acceptRevision, alignFromJustification, applyThemeShade, applyThemeTint, assertValidDocumentModel, buildTableOfContents, captionParagraphs, computeListLabels, createDocument, createListDefinition, dateFieldResult, datePicture, defaultStyleCatalogs, diagramColorTheme, diagramsIn, displayListLabel, eighthPoints, eighthPointsFromPoints, eighthPointsToPoints, emu, emuFromPixels, emuToPixels, ensureListDefinition, enumValue, fieldName, findRevision, findTableOfContents, formatListNumber, formatNoteNumber, formatWordDate, halfPoints, halfPointsFromPoints, halfPointsToPoints, headingLevel, headingListLevels, isCaptionOf, isHeadingListKind, isLigatures, isStAlgClass, isStAlgType, isStAnnotationVMerge, isStBorder, isStBrClear, isStBrType, isStCalendarType, isStCaptionPos, isStChapterSep, isStCharacterSpacing, isStCombineBrackets, isStConformanceClass, isStCryptProv, isStDirection, isStDisplacedByCustomXml, isStDocGrid, isStDocPartBehavior, isStDocPartGallery, isStDocPartType, isStDocProtect, isStDropCap, isStEdGrp, isStEdnPos, isStEm, isStFFTextType, isStFldCharType, isStFontFamily, isStFrameLayout, isStFrameScrollbar, isStFtnEdn, isStFtnPos, isStHAnchor, isStHdrFtr, isStHeightRule, isStHexColorAuto, isStHighlightColor, isStHint, isStInfoTextType, isStJc, isStJcTable, isStLevelSuffix, isStLineNumberRestart, isStLineSpacingRule, isStLock, isStMailMergeDest, isStMailMergeDocType, isStMailMergeOdsoFMDFieldType, isStMailMergeSourceType, isStMerge, isStMultiLevelType, isStNumberFormat, isStObjectDrawAspect, isStObjectUpdateMode, isStOnOff1, isStPTabAlignment, isStPTabLeader, isStPTabRelativeTo, isStPageBorderDisplay, isStPageBorderOffset, isStPageBorderZOrder, isStPageOrientation, isStPitch, isStProof, isStProofErr, isStRelFromH, isStRelFromV, isStRestartNumber, isStRubyAlign, isStSchemeColorVal, isStSdtDateMappingType, isStSectionMark, isStShd, isStStyleSort, isStStyleType, isStTabJc, isStTabTlc, isStTargetScreenSz, isStTblLayoutType, isStTblOverlap, isStTblStyleOverrideType, isStTblWidth, isStTextAlignment, isStTextDirection, isStTextEffect, isStTextboxTightWrap, isStTheme, isStThemeColor, isStTrueFalse, isStTrueFalseBlank, isStUnderline, isStVAnchor, isStVerticalAlignRun, isStVerticalJc, isStView, isStWmlColorSchemeIndex, isStWrap, isStXAlign, isStYAlign, isStZoom, isThemeColorToken, isValidLanguageTag, isWordHighlightToken, isWordUnderlineStyle, linkStylesToList, listRevisions, loadDocx, numberNotesInOrder, onOffAttribute, onOffElement, parseColorSchemeMapping, parseEighthPoints, parseHalfPoints, parseHexColor, parseInteger, parseJustification, parseNumberingCatalog, parseOnOff, parseParagraphStyleCatalog, parseRgbColor, parseRunStyleCatalog, parseSignedHalfPoints, parseSignedTwips, parseTableStyleCatalog, parseTextScale, parseTheme, parseTintShade, parseTwips, parseUnsignedInteger, rejectAllRevisions, rejectRevision, reportParseWarning, resolveCellVisuals, resolveDiagramColor, resolveNumberingLevel, resolveParagraphFormatting, resolveParagraphNumbering, resolveRunFormatting, resolveStyleNumbering, resolveTableStyleFormatting, resolveThemeColorReference, resolveThemeColorToken, roundEighthPoints, roundEmu, roundHalfPoints, roundSignedTwips, roundTwips, saveDocx, signedTwips, signedTwipsFromPixels, signedTwipsFromPoints, tableOfFiguresInstruction, tocBookmarks, tocCaptionLabel, tocEntries, tocHyperlinks, tocLevels, twips, twipsFromInches, twipsFromPixels, twipsFromPoints, twipsToInches, twipsToPixels, twipsToPoints, universalMeasureToTwips, updateTableOfContents, validateDocumentModel, withParseWarnings, withTocBookmarks };
+// src/docx/document-stats.ts
+function visibleText(paragraph) {
+  return paragraph.runs.filter((run) => !run.fieldCode && !run.fieldChar).filter((run) => run.revision?.kind !== "delete" && run.revision?.kind !== "moveFrom").map((run) => run.text).join("");
+}
+function paragraphsOf3(blocks) {
+  return blocks.flatMap(
+    (block) => block.type === "paragraph" ? [block] : block.rows.flatMap((row) => row.flatMap((cell) => cell.paragraphs))
+  );
+}
+function documentStats(model) {
+  const paragraphs = paragraphsOf3(model.blocks);
+  const text = paragraphs.map(visibleText).join("");
+  const revisions = paragraphs.reduce(
+    (count, paragraph) => count + paragraph.runs.filter((run) => run.revision).length + (paragraph.markRevision ? 1 : 0),
+    0
+  );
+  return {
+    paragraphs: paragraphs.length,
+    tables: model.blocks.filter((block) => block.type === "table").length,
+    sections: model.sections?.length ?? 1,
+    characters: [...text.replace(/\s/g, "")].length,
+    charactersWithSpaces: [...text].length,
+    comments: model.comments?.length ?? 0,
+    revisions
+  };
+}
+function plainText2(model) {
+  return model.blocks.map(
+    (block) => block.type === "paragraph" ? visibleText(block) : block.rows.map((row) => row.map((cell) => cell.paragraphs.map(visibleText).join(" ")).join("	")).join("\n")
+  ).join("\n");
+}
+
+export { DEFAULT_STYLES_XML, DEFAULT_TABLE_BORDERS, DEFAULT_TOC_INSTRUCTION, DIAGRAM_GRAPHIC_URI, DocxModelValidationError, EMPTY_FIGURES_TEXT, EMPTY_TOC_TEXT, EMU_PER_INCH, EMU_PER_PIXEL, EMU_PER_POINT, LIGATURE_VALUES, PIXELS_PER_INCH, PROPERTY_FIELDS, ST_AlgClass, ST_AlgType, ST_AnnotationVMerge, ST_Border, ST_BrClear, ST_BrType, ST_CalendarType, ST_CaptionPos, ST_ChapterSep, ST_CharacterSpacing, ST_CombineBrackets, ST_ConformanceClass, ST_CryptProv, ST_Direction, ST_DisplacedByCustomXml, ST_DocGrid, ST_DocPartBehavior, ST_DocPartGallery, ST_DocPartType, ST_DocProtect, ST_DropCap, ST_EdGrp, ST_EdnPos, ST_Em, ST_FFTextType, ST_FldCharType, ST_FontFamily, ST_FrameLayout, ST_FrameScrollbar, ST_FtnEdn, ST_FtnPos, ST_HAnchor, ST_HdrFtr, ST_HeightRule, ST_HexColorAuto, ST_HighlightColor, ST_Hint, ST_InfoTextType, ST_Jc, ST_JcTable, ST_LevelSuffix, ST_LineNumberRestart, ST_LineSpacingRule, ST_Lock, ST_MailMergeDest, ST_MailMergeDocType, ST_MailMergeOdsoFMDFieldType, ST_MailMergeSourceType, ST_Merge, ST_MultiLevelType, ST_NumberFormat, ST_ObjectDrawAspect, ST_ObjectUpdateMode, ST_OnOff1, ST_PTabAlignment, ST_PTabLeader, ST_PTabRelativeTo, ST_PageBorderDisplay, ST_PageBorderOffset, ST_PageBorderZOrder, ST_PageOrientation, ST_Pitch, ST_Proof, ST_ProofErr, ST_RelFromH, ST_RelFromV, ST_RestartNumber, ST_RubyAlign, ST_SchemeColorVal, ST_SdtDateMappingType, ST_SectionMark, ST_Shd, ST_StyleSort, ST_StyleType, ST_TabJc, ST_TabTlc, ST_TargetScreenSz, ST_TblLayoutType, ST_TblOverlap, ST_TblStyleOverrideType, ST_TblWidth, ST_TextAlignment, ST_TextDirection, ST_TextEffect, ST_TextboxTightWrap, ST_Theme, ST_ThemeColor, ST_TrueFalse, ST_TrueFalseBlank, ST_Underline, ST_VAnchor, ST_VerticalAlignRun, ST_VerticalJc, ST_View, ST_WmlColorSchemeIndex, ST_Wrap, ST_XAlign, ST_YAlign, ST_Zoom, TWIPS_PER_INCH, TWIPS_PER_POINT, WORD_HIGHLIGHT_TOKENS, WORD_UNDERLINE_TOKENS, acceptAllRevisions, acceptRevision, alignFromJustification, applyThemeShade, applyThemeTint, assertValidDocumentModel, buildTableOfContents, captionParagraphs, computeListLabels, createDocument, createListDefinition, dateFieldResult, datePicture, defaultStyleCatalogs, diagramColorTheme, diagramsIn, displayListLabel, documentStats, eighthPoints, eighthPointsFromPoints, eighthPointsToPoints, emu, emuFromPixels, emuToPixels, ensureListDefinition, enumValue, fieldName, findRevision, findTableOfContents, formatListNumber, formatNoteNumber, formatWordDate, halfPoints, halfPointsFromPoints, halfPointsToPoints, headingLevel, headingListLevels, isCaptionOf, isHeadingListKind, isLigatures, isStAlgClass, isStAlgType, isStAnnotationVMerge, isStBorder, isStBrClear, isStBrType, isStCalendarType, isStCaptionPos, isStChapterSep, isStCharacterSpacing, isStCombineBrackets, isStConformanceClass, isStCryptProv, isStDirection, isStDisplacedByCustomXml, isStDocGrid, isStDocPartBehavior, isStDocPartGallery, isStDocPartType, isStDocProtect, isStDropCap, isStEdGrp, isStEdnPos, isStEm, isStFFTextType, isStFldCharType, isStFontFamily, isStFrameLayout, isStFrameScrollbar, isStFtnEdn, isStFtnPos, isStHAnchor, isStHdrFtr, isStHeightRule, isStHexColorAuto, isStHighlightColor, isStHint, isStInfoTextType, isStJc, isStJcTable, isStLevelSuffix, isStLineNumberRestart, isStLineSpacingRule, isStLock, isStMailMergeDest, isStMailMergeDocType, isStMailMergeOdsoFMDFieldType, isStMailMergeSourceType, isStMerge, isStMultiLevelType, isStNumberFormat, isStObjectDrawAspect, isStObjectUpdateMode, isStOnOff1, isStPTabAlignment, isStPTabLeader, isStPTabRelativeTo, isStPageBorderDisplay, isStPageBorderOffset, isStPageBorderZOrder, isStPageOrientation, isStPitch, isStProof, isStProofErr, isStRelFromH, isStRelFromV, isStRestartNumber, isStRubyAlign, isStSchemeColorVal, isStSdtDateMappingType, isStSectionMark, isStShd, isStStyleSort, isStStyleType, isStTabJc, isStTabTlc, isStTargetScreenSz, isStTblLayoutType, isStTblOverlap, isStTblStyleOverrideType, isStTblWidth, isStTextAlignment, isStTextDirection, isStTextEffect, isStTextboxTightWrap, isStTheme, isStThemeColor, isStTrueFalse, isStTrueFalseBlank, isStUnderline, isStVAnchor, isStVerticalAlignRun, isStVerticalJc, isStView, isStWmlColorSchemeIndex, isStWrap, isStXAlign, isStYAlign, isStZoom, isThemeColorToken, isValidLanguageTag, isWordHighlightToken, isWordUnderlineStyle, linkStylesToList, listRevisions, loadDocx, numberNotesInOrder, onOffAttribute, onOffElement, parseColorSchemeMapping, parseEighthPoints, parseHalfPoints, parseHexColor, parseInteger, parseJustification, parseNumberingCatalog, parseOnOff, parseParagraphStyleCatalog, parseRgbColor, parseRunStyleCatalog, parseSignedHalfPoints, parseSignedTwips, parseTableStyleCatalog, parseTextScale, parseTheme, parseTintShade, parseTwips, parseUnsignedInteger, plainText2 as plainText, rejectAllRevisions, rejectRevision, reportParseWarning, resolveCellVisuals, resolveDiagramColor, resolveNumberingLevel, resolveParagraphFormatting, resolveParagraphNumbering, resolveRunFormatting, resolveStyleNumbering, resolveTableStyleFormatting, resolveThemeColorReference, resolveThemeColorToken, roundEighthPoints, roundEmu, roundHalfPoints, roundSignedTwips, roundTwips, saveDocx, signedTwips, signedTwipsFromPixels, signedTwipsFromPoints, tableOfFiguresInstruction, tocBookmarks, tocCaptionLabel, tocEntries, tocHyperlinks, tocLevels, twips, twipsFromInches, twipsFromPixels, twipsFromPoints, twipsToInches, twipsToPixels, twipsToPoints, universalMeasureToTwips, updateTableOfContents, validateDocumentModel, withParseWarnings, withTocBookmarks };

package/dist/xlsx/formula/editor-text.d.ts

@@ -0,0 +1,60 @@
+import { type CellRange } from '../address.js';
+import type { FunctionInfo } from './functions/types.js';
+/** Excel-like colours for references in a formula, in order of first appearance. */
+export declare const REFERENCE_COLORS: readonly ['#2a6ad8', '#d24726', '#7d3fbf', '#0f8a3b', '#c0399f', '#946d00', '#d1102b', '#00788a'];
+export declare const isFormulaText: (text: string) => boolean;
+export interface ColoredReference {
+    /** Offsets into the formula text (which includes '='). */
+    start: number;
+    end: number;
+    text: string;
+    color: string;
+    /** Same reference text shares a colour (and a colour index). */
+    index: number;
+}
+/** The references of a formula with their colours (offsets into `text`, which includes '='). */
+export declare function coloredReferences(text: string): ColoredReference[];
+/** Whether typing a reference at `caret` makes sense (point mode may start). */
+export declare function acceptsReference(text: string, caret: number): boolean;
+/** True when `caret` is inside a "string literal". */
+export declare function insideString(text: string, caret: number): boolean;
+export interface NameToken {
+    start: number;
+    prefix: string;
+}
+/** The function-name prefix ending at the caret (`=SU|` -> `SU`), for autocomplete. */
+export declare function nameAtCaret(text: string, caret: number): NameToken | undefined;
+/** Catalog functions starting with `prefix` (case-insensitive), at most `limit`. */
+export declare function functionMatches(prefix: string, limit?: number, catalog?: readonly FunctionInfo[]): FunctionInfo[];
+export interface CallContext {
+    name: string;
+    /** Zero-based argument the caret is in. */
+    argIndex: number;
+}
+/** The innermost function call around the caret (`=IF(A1>0,|` -> IF, argument 1). */
+export declare function callAtCaret(text: string, caret: number): CallContext | undefined;
+/** Splits `SUM(number1, [number2], ...)` into its parameter texts. */
+export declare function syntaxParams(syntax: string): {
+    name: string;
+    params: string[];
+};
+/** The parameter to highlight for an argument index (a trailing `...` repeats the last one). */
+export declare function activeParam(params: string[], argIndex: number): number;
+/** Replaces `text[start, end)` with `insert`; returns the new text and caret. */
+export declare function splice(text: string, start: number, end: number, insert: string): {
+    text: string;
+    caret: number;
+};
+/** The sheet name and range a reference token names (`'My sheet'!$A$1:B2`, `A:C`, `2:5`). */
+export declare function referenceTarget(text: string): {
+    sheet?: string;
+    range: CellRange;
+} | undefined;
+/** F4: cycles the absolute/relative form of the reference at the caret. */
+export declare function toggleAbsolute(text: string, caret: number): {
+    text: string;
+    caret: number;
+} | undefined;
+/** Excel's commit-time autocorrect: appends the closing parentheses a formula is missing. */
+export declare function closeParens(text: string): string;
+//# sourceMappingURL=editor-text.d.ts.map

package/dist/xlsx/formula/editor-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-text.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/editor-text.ts"],"names":[],"mappings":"AAGA,OAAO,EAA6C,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,YAC5B,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,CACA,CAAC;AAEX,eAAO,MAAM,aAAa,SAAU,MAAM,KAAG,OACA,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAChC,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;CACd;AAED,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAkBlE;AAKD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAOrE;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAIjE;AAED,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAS9E;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAC9B,MAAM,EAAE,MAAM,EACd,KAAK,SAAK,EACV,OAAO,GAAE,SAAS,YAAY,EAAqB,GACjD,YAAY,EAAE,CAShB;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAwBhF;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAO/E;AAED,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,iFAAiF;AACjF,wBAAgB,MAAM,CACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACZ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAEjC;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG,SAAS,CAsB9F;AAaD,2EAA2E;AAC3E,wBAAgB,cAAc,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAY7C;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUhD"}

package/dist/xlsx/formula/index.d.ts

@@ -11,4 +11,5 @@ export { deleteSheetInFormula, moveReferencesInFormula, type MoveSpec } from './
 export { renameTableInFormula } from './table-refs.js';
 export { structuredToA1, type StructuredTarget } from './structured-to-a1.js';
 export { needsArrayEvaluation } from './array-context.js';
+export * from './editor-text.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/xlsx/formula/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EACN,0BAA0B,EAC1B,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,YAAY,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,KAAK,aAAa,EAClB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,KAAK,SAAS,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EACN,0BAA0B,EAC1B,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,YAAY,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,KAAK,aAAa,EAClB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,KAAK,SAAS,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,cAAc,kBAAkB,CAAC"}

package/dist/xlsx/index.cjs

@@ -12893,6 +12893,163 @@ function needsArrayEvaluation(formula) {
   return result2.needs || result2.multi;
 }
 
+// src/xlsx/formula/editor-text.ts
+var REFERENCE_COLORS = [
+  "#2a6ad8",
+  "#d24726",
+  "#7d3fbf",
+  "#0f8a3b",
+  "#c0399f",
+  "#946d00",
+  "#d1102b",
+  "#00788a"
+];
+var isFormulaText = (text2) => text2.startsWith("=") || text2.startsWith("+");
+function coloredReferences(text2) {
+  if (!isFormulaText(text2)) return [];
+  const seen = /* @__PURE__ */ new Map();
+  return referenceSpans(text2.slice(1), "").map((span3) => {
+    const key = span3.text.replace(/\$/g, "").toUpperCase();
+    let index2 = seen.get(key);
+    if (index2 === void 0) {
+      index2 = seen.size;
+      seen.set(key, index2);
+    }
+    return {
+      start: span3.start + 1,
+      end: span3.end + 1,
+      text: span3.text,
+      index: index2,
+      color: REFERENCE_COLORS[index2 % REFERENCE_COLORS.length] ?? REFERENCE_COLORS[0]
+    };
+  });
+}
+var POINT_AFTER = /* @__PURE__ */ new Set(["=", "(", ",", "+", "-", "*", "/", "^", "&", "<", ">", ":", ";", "%"]);
+function acceptsReference(text2, caret) {
+  if (!isFormulaText(text2)) return false;
+  if (text2.slice(caret).trimStart() !== "" && !/^[\s),;&+\-*/^<>=]/.test(text2.slice(caret)))
+    return false;
+  const before = text2.slice(0, caret).trimEnd();
+  const last = before[before.length - 1];
+  return last !== void 0 && POINT_AFTER.has(last) && !insideString(text2, caret);
+}
+function insideString(text2, caret) {
+  let open = false;
+  for (let i = 0; i < caret && i < text2.length; i++) if (text2[i] === '"') open = !open;
+  return open;
+}
+function nameAtCaret(text2, caret) {
+  if (!isFormulaText(text2) || insideString(text2, caret)) return void 0;
+  const match2 = /[A-Za-z_][A-Za-z0-9_.]*$/.exec(text2.slice(0, caret));
+  if (!match2) return void 0;
+  const start = caret - match2[0].length;
+  const prev = text2[start - 1] ?? "";
+  if (start === 0 || /[A-Za-z0-9_$!'".:]/.test(prev)) return void 0;
+  if (/^[A-Za-z0-9_.]/.test(text2.slice(caret))) return void 0;
+  return { start, prefix: match2[0] };
+}
+function functionMatches(prefix, limit2 = 12, catalog = FUNCTION_CATALOG) {
+  const upper2 = prefix.toUpperCase();
+  if (!upper2) return [];
+  const out = [];
+  for (const info of catalog) {
+    if (info.name.startsWith(upper2)) out.push(info);
+    if (out.length >= limit2) break;
+  }
+  return out;
+}
+function callAtCaret(text2, caret) {
+  if (!isFormulaText(text2)) return void 0;
+  const stack2 = [];
+  let inString = false;
+  for (let i = 1; i < caret && i < text2.length; i++) {
+    const ch = text2[i];
+    if (ch === '"') inString = !inString;
+    if (inString) continue;
+    if (ch === "(") {
+      const name = /([A-Za-z_][A-Za-z0-9_.]*)\s*$/.exec(text2.slice(0, i))?.[1];
+      stack2.push({ name: (name ?? "").toUpperCase(), argIndex: 0 });
+    } else if (ch === ")") stack2.pop();
+    else if (ch === "," || ch === ";") {
+      const top = stack2[stack2.length - 1];
+      if (top) top.argIndex++;
+    } else if (ch === "{") stack2.push({ name: "", argIndex: 0 });
+    else if (ch === "}") stack2.pop();
+  }
+  for (let i = stack2.length - 1; i >= 0; i--) {
+    const entry = stack2[i];
+    if (entry?.name) return entry;
+    if (entry && !entry.name) return void 0;
+  }
+  return void 0;
+}
+function syntaxParams(syntax) {
+  const open = syntax.indexOf("(");
+  const close = syntax.lastIndexOf(")");
+  if (open < 0) return { name: syntax, params: [] };
+  const inner2 = syntax.slice(open + 1, close < 0 ? void 0 : close).trim();
+  const params = inner2 ? inner2.split(",").map((p) => p.trim()) : [];
+  return { name: syntax.slice(0, open), params };
+}
+function activeParam(params, argIndex) {
+  if (argIndex < params.length) {
+    if (params[argIndex] === "...") return Math.max(0, argIndex - 1);
+    return argIndex;
+  }
+  return params[params.length - 1] === "..." ? params.length - 2 : params.length - 1;
+}
+function splice(text2, start, end, insert) {
+  return { text: text2.slice(0, start) + insert + text2.slice(end), caret: start + insert.length };
+}
+function referenceTarget(text2) {
+  const bang = text2.lastIndexOf("!");
+  const sheet = bang >= 0 ? text2.slice(0, bang).replace(/^'|'$/g, "").replace(/''/g, "'") : void 0;
+  const body = text2.slice(bang + 1).replace(/\$/g, "").toUpperCase();
+  let range;
+  const cols = /^([A-Z]{1,3}):([A-Z]{1,3})$/.exec(body);
+  const rows = /^(\d+):(\d+)$/.exec(body);
+  if (cols) {
+    const a = columnIndex(cols[1] ?? "A");
+    const b = columnIndex(cols[2] ?? "A");
+    range = { start: { row: 0, col: Math.min(a, b) }, end: { row: MAX_ROW, col: Math.max(a, b) } };
+  } else if (rows) {
+    const a = Number(rows[1]) - 1;
+    const b = Number(rows[2]) - 1;
+    range = { start: { row: Math.min(a, b), col: 0 }, end: { row: Math.max(a, b), col: MAX_COL } };
+  } else range = parseRange(body);
+  if (!range) return void 0;
+  return sheet === void 0 ? { range } : { sheet, range };
+}
+var cycleCell = (cell) => {
+  const m = /^(\$?)([A-Za-z]{1,3})(\$?)(\d+)$/.exec(cell);
+  if (!m) return cell;
+  const [, c2, col, r, row2] = m;
+  if (!c2 && !r) return `$${col}$${row2}`;
+  if (c2 && r) return `${col}$${row2}`;
+  if (!c2 && r) return `$${col}${row2}`;
+  return `${col}${row2}`;
+};
+function toggleAbsolute(text2, caret) {
+  const ref = coloredReferences(text2).find((r) => caret >= r.start && caret <= r.end);
+  if (!ref) return void 0;
+  const bang = ref.text.lastIndexOf("!");
+  const prefix = ref.text.slice(0, bang + 1);
+  const body = ref.text.slice(bang + 1).split(":").map(cycleCell).join(":");
+  const next = splice(text2, ref.start, ref.end, prefix + body);
+  return next;
+}
+function closeParens(text2) {
+  if (!isFormulaText(text2)) return text2;
+  let depth = 0;
+  let inString = false;
+  for (const ch of text2) {
+    if (ch === '"') inString = !inString;
+    else if (!inString && ch === "(") depth++;
+    else if (!inString && ch === ")") depth = Math.max(0, depth - 1);
+  }
+  return depth > 0 && !inString ? text2 + ")".repeat(depth) : text2;
+}
+
 // src/opc/relationship-types.ts
 var BASE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
 var RELATIONSHIP_TYPES = {
@@ -26056,8 +26213,11 @@ exports.MAX_ROW = MAX_ROW;
 exports.MIN_TWO_CELL_PIXELS = MIN_TWO_CELL_PIXELS;
 exports.OVERFLOW_TEXT = OVERFLOW_TEXT;
 exports.PERCENT_SCALE = PERCENT_SCALE;
+exports.REFERENCE_COLORS = REFERENCE_COLORS;
 exports.THEME_SLOTS = THEME_SLOTS;
 exports.TIME_PERIODS = TIME_PERIODS;
+exports.acceptsReference = acceptsReference;
+exports.activeParam = activeParam;
 exports.addFuturePrefixes = addFuturePrefixes;
 exports.anchorKind = anchorKind;
 exports.anchorToPixelBox = anchorToPixelBox;
@@ -26073,6 +26233,7 @@ exports.bordersView = bordersView;
 exports.builtinCellStyle = builtinCellStyle;
 exports.builtinFormatId = builtinFormatId;
 exports.calcModeOf = calcModeOf;
+exports.callAtCaret = callAtCaret;
 exports.categoryTotals = categoryTotals;
 exports.cellError = cellError;
 exports.cellInputText = cellInputText;
@@ -26082,6 +26243,8 @@ exports.cellsFromText = cellsFromText;
 exports.charactersToColumnWidth = charactersToColumnWidth;
 exports.charactersToPixels = charactersToPixels;
 exports.chartView = chartView;
+exports.closeParens = closeParens;
+exports.coloredReferences = coloredReferences;
 exports.columnIndex = columnIndex;
 exports.columnLabel = columnLabel;
 exports.columnWidthToPixels = columnWidthToPixels;
@@ -26114,17 +26277,20 @@ exports.formatRange = formatRange;
 exports.formatRefSpec = formatRefSpec;
 exports.formatValue = formatValue;
 exports.formulaBarText = formulaBarText;
+exports.functionMatches = functionMatches;
 exports.generalAlignment = generalAlignment;
 exports.getCell = getCell;
 exports.getCellAt = getCellAt;
 exports.getValue = getValue;
 exports.hls240ToRgb = hls240ToRgb;
 exports.inTimePeriod = inTimePeriod;
+exports.insideString = insideString;
 exports.internStyle = internStyle;
 exports.isCellError = isCellError;
 exports.isDateFormat = isDateFormat;
 exports.isEmptyCell = isEmptyCell;
 exports.isErrorCode = isErrorCode;
+exports.isFormulaText = isFormulaText;
 exports.isOverflowTarget = isOverflowTarget;
 exports.isSpilledCell = isSpilledCell;
 exports.keyToAddress = keyToAddress;
@@ -26140,6 +26306,7 @@ exports.mixColors = mixColors;
 exports.modernPasswordHash = modernPasswordHash;
 exports.modulateLuminance = modulateLuminance;
 exports.moveReferencesInFormula = moveReferencesInFormula;
+exports.nameAtCaret = nameAtCaret;
 exports.navigate = navigate;
 exports.needsArrayEvaluation = needsArrayEvaluation;
 exports.newMediaPart = newMediaPart;
@@ -26175,6 +26342,7 @@ exports.rangeContains = rangeContains;
 exports.rangeSize = rangeSize;
 exports.rangesIntersect = rangesIntersect;
 exports.referenceSpans = referenceSpans;
+exports.referenceTarget = referenceTarget;
 exports.referencedRanges = referencedRanges;
 exports.renameSheetInFormula = renameSheetInFormula;
 exports.renameTableInFormula = renameTableInFormula;
@@ -26193,17 +26361,20 @@ exports.shiftFormula = shiftFormula;
 exports.shiftRange = shiftRange;
 exports.shiftSpan = shiftSpan;
 exports.spillAnchorOf = spillAnchorOf;
+exports.splice = splice;
 exports.stepDecimals = stepDecimals;
 exports.stripFuturePrefixes = stripFuturePrefixes;
 exports.structuredToA1 = structuredToA1;
 exports.styleAt = styleAt;
 exports.styleKey = styleKey;
 exports.subtractRange = subtractRange;
+exports.syntaxParams = syntaxParams;
 exports.themeColor = themeColor;
 exports.timePeriodFormula = timePeriodFormula;
 exports.toHexColor = toHexColor;
 exports.toHtml = toHtml;
 exports.toTsv = toTsv;
+exports.toggleAbsolute = toggleAbsolute;
 exports.tokenize = tokenize;
 exports.translateFormula = translateFormula;
 exports.translateReferences = translateReferences;

package/dist/xlsx/index.mjs

@@ -12887,6 +12887,163 @@ function needsArrayEvaluation(formula) {
   return result2.needs || result2.multi;
 }
 
+// src/xlsx/formula/editor-text.ts
+var REFERENCE_COLORS = [
+  "#2a6ad8",
+  "#d24726",
+  "#7d3fbf",
+  "#0f8a3b",
+  "#c0399f",
+  "#946d00",
+  "#d1102b",
+  "#00788a"
+];
+var isFormulaText = (text2) => text2.startsWith("=") || text2.startsWith("+");
+function coloredReferences(text2) {
+  if (!isFormulaText(text2)) return [];
+  const seen = /* @__PURE__ */ new Map();
+  return referenceSpans(text2.slice(1), "").map((span3) => {
+    const key = span3.text.replace(/\$/g, "").toUpperCase();
+    let index2 = seen.get(key);
+    if (index2 === void 0) {
+      index2 = seen.size;
+      seen.set(key, index2);
+    }
+    return {
+      start: span3.start + 1,
+      end: span3.end + 1,
+      text: span3.text,
+      index: index2,
+      color: REFERENCE_COLORS[index2 % REFERENCE_COLORS.length] ?? REFERENCE_COLORS[0]
+    };
+  });
+}
+var POINT_AFTER = /* @__PURE__ */ new Set(["=", "(", ",", "+", "-", "*", "/", "^", "&", "<", ">", ":", ";", "%"]);
+function acceptsReference(text2, caret) {
+  if (!isFormulaText(text2)) return false;
+  if (text2.slice(caret).trimStart() !== "" && !/^[\s),;&+\-*/^<>=]/.test(text2.slice(caret)))
+    return false;
+  const before = text2.slice(0, caret).trimEnd();
+  const last = before[before.length - 1];
+  return last !== void 0 && POINT_AFTER.has(last) && !insideString(text2, caret);
+}
+function insideString(text2, caret) {
+  let open = false;
+  for (let i = 0; i < caret && i < text2.length; i++) if (text2[i] === '"') open = !open;
+  return open;
+}
+function nameAtCaret(text2, caret) {
+  if (!isFormulaText(text2) || insideString(text2, caret)) return void 0;
+  const match2 = /[A-Za-z_][A-Za-z0-9_.]*$/.exec(text2.slice(0, caret));
+  if (!match2) return void 0;
+  const start = caret - match2[0].length;
+  const prev = text2[start - 1] ?? "";
+  if (start === 0 || /[A-Za-z0-9_$!'".:]/.test(prev)) return void 0;
+  if (/^[A-Za-z0-9_.]/.test(text2.slice(caret))) return void 0;
+  return { start, prefix: match2[0] };
+}
+function functionMatches(prefix, limit2 = 12, catalog = FUNCTION_CATALOG) {
+  const upper2 = prefix.toUpperCase();
+  if (!upper2) return [];
+  const out = [];
+  for (const info of catalog) {
+    if (info.name.startsWith(upper2)) out.push(info);
+    if (out.length >= limit2) break;
+  }
+  return out;
+}
+function callAtCaret(text2, caret) {
+  if (!isFormulaText(text2)) return void 0;
+  const stack2 = [];
+  let inString = false;
+  for (let i = 1; i < caret && i < text2.length; i++) {
+    const ch = text2[i];
+    if (ch === '"') inString = !inString;
+    if (inString) continue;
+    if (ch === "(") {
+      const name = /([A-Za-z_][A-Za-z0-9_.]*)\s*$/.exec(text2.slice(0, i))?.[1];
+      stack2.push({ name: (name ?? "").toUpperCase(), argIndex: 0 });
+    } else if (ch === ")") stack2.pop();
+    else if (ch === "," || ch === ";") {
+      const top = stack2[stack2.length - 1];
+      if (top) top.argIndex++;
+    } else if (ch === "{") stack2.push({ name: "", argIndex: 0 });
+    else if (ch === "}") stack2.pop();
+  }
+  for (let i = stack2.length - 1; i >= 0; i--) {
+    const entry = stack2[i];
+    if (entry?.name) return entry;
+    if (entry && !entry.name) return void 0;
+  }
+  return void 0;
+}
+function syntaxParams(syntax) {
+  const open = syntax.indexOf("(");
+  const close = syntax.lastIndexOf(")");
+  if (open < 0) return { name: syntax, params: [] };
+  const inner2 = syntax.slice(open + 1, close < 0 ? void 0 : close).trim();
+  const params = inner2 ? inner2.split(",").map((p) => p.trim()) : [];
+  return { name: syntax.slice(0, open), params };
+}
+function activeParam(params, argIndex) {
+  if (argIndex < params.length) {
+    if (params[argIndex] === "...") return Math.max(0, argIndex - 1);
+    return argIndex;
+  }
+  return params[params.length - 1] === "..." ? params.length - 2 : params.length - 1;
+}
+function splice(text2, start, end, insert) {
+  return { text: text2.slice(0, start) + insert + text2.slice(end), caret: start + insert.length };
+}
+function referenceTarget(text2) {
+  const bang = text2.lastIndexOf("!");
+  const sheet = bang >= 0 ? text2.slice(0, bang).replace(/^'|'$/g, "").replace(/''/g, "'") : void 0;
+  const body = text2.slice(bang + 1).replace(/\$/g, "").toUpperCase();
+  let range;
+  const cols = /^([A-Z]{1,3}):([A-Z]{1,3})$/.exec(body);
+  const rows = /^(\d+):(\d+)$/.exec(body);
+  if (cols) {
+    const a = columnIndex(cols[1] ?? "A");
+    const b = columnIndex(cols[2] ?? "A");
+    range = { start: { row: 0, col: Math.min(a, b) }, end: { row: MAX_ROW, col: Math.max(a, b) } };
+  } else if (rows) {
+    const a = Number(rows[1]) - 1;
+    const b = Number(rows[2]) - 1;
+    range = { start: { row: Math.min(a, b), col: 0 }, end: { row: Math.max(a, b), col: MAX_COL } };
+  } else range = parseRange(body);
+  if (!range) return void 0;
+  return sheet === void 0 ? { range } : { sheet, range };
+}
+var cycleCell = (cell) => {
+  const m = /^(\$?)([A-Za-z]{1,3})(\$?)(\d+)$/.exec(cell);
+  if (!m) return cell;
+  const [, c2, col, r, row2] = m;
+  if (!c2 && !r) return `$${col}$${row2}`;
+  if (c2 && r) return `${col}$${row2}`;
+  if (!c2 && r) return `$${col}${row2}`;
+  return `${col}${row2}`;
+};
+function toggleAbsolute(text2, caret) {
+  const ref = coloredReferences(text2).find((r) => caret >= r.start && caret <= r.end);
+  if (!ref) return void 0;
+  const bang = ref.text.lastIndexOf("!");
+  const prefix = ref.text.slice(0, bang + 1);
+  const body = ref.text.slice(bang + 1).split(":").map(cycleCell).join(":");
+  const next = splice(text2, ref.start, ref.end, prefix + body);
+  return next;
+}
+function closeParens(text2) {
+  if (!isFormulaText(text2)) return text2;
+  let depth = 0;
+  let inString = false;
+  for (const ch of text2) {
+    if (ch === '"') inString = !inString;
+    else if (!inString && ch === "(") depth++;
+    else if (!inString && ch === ")") depth = Math.max(0, depth - 1);
+  }
+  return depth > 0 && !inString ? text2 + ")".repeat(depth) : text2;
+}
+
 // src/opc/relationship-types.ts
 var BASE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
 var RELATIONSHIP_TYPES = {
@@ -26023,4 +26180,4 @@ function createRefEvaluator(workbook, calc, options = {}) {
   };
 }
 
-export { AxisMetrics, BORDER_STYLES, BUILTIN_CELL_STYLES, BUILTIN_NUMBER_FORMATS, CIRCULAR_REFERENCE_WARNING, COLUMN_PADDING_PX, DEFAULT_ANCHOR_EXTENT_EMU, DEFAULT_BASE_COL_WIDTH, DEFAULT_COL_WIDTH, DEFAULT_MAX_DIGIT_WIDTH, DEFAULT_ROW_HEIGHT, DEFAULT_THEME, DEFAULT_VALIDATION_MESSAGE, ERROR_CODES, FORMAT_PRESETS, FUNCTION_CATALOG, FormulaError, IMAGE_EXTENSIONS, INDENT_PX_PER_LEVEL, INDEXED_COLORS, MAX_COL, MAX_DATE_SERIAL, MAX_OUTLINE_LEVEL, MAX_ROW, MIN_TWO_CELL_PIXELS, OVERFLOW_TEXT, PERCENT_SCALE, THEME_SLOTS, TIME_PERIODS, addFuturePrefixes, anchorKind, anchorToPixelBox, applyBuiltinStyle, applyStylePatch, applyTint, approximateMeasure, autoFitColumnWidth, autoFitRowHeight, autoGrowRows, autoSeriesColor, bordersView, builtinCellStyle, builtinFormatId, calcModeOf, categoryTotals, cellError, cellInputText, cellKey, cellView, cellsFromText, charactersToColumnWidth, charactersToPixels, chartView, columnIndex, columnLabel, columnWidthToPixels, compareCellValues, compareValues, createCalcEngine, createConditionalFormatEvaluator, createEditSession, createGridMetrics, createRefEvaluator, createWorkbook, createWorksheet, currentRegion, dateToSerial, defaultCellStyle, defaultColumnPixels, deleteCell, deleteSheetInFormula, detectSeries, edgeView, effectiveStyleId, fillView, fontView, forEachCell, forEachCellInRange, formatAddress, formatAxisValue, formatGeneral, formatRange, formatRefSpec, formatValue, formulaBarText, generalAlignment, getCell, getCellAt, getValue, hls240ToRgb, inTimePeriod, internStyle, isCellError, isDateFormat, isEmptyCell, isErrorCode, isOverflowTarget, isSpilledCell, keyToAddress, legacyPasswordHash, lineHeightPoints, listValidationOptions, loadXlsx, mergeAt, mergeFont, mergeView, mergeWouldDiscard, mixColors, modernPasswordHash, modulateLuminance, moveReferencesInFormula, navigate, needsArrayEvaluation, newMediaPart, nextSheetId, nextSheetName, niceScale, normalizeRange, numberInputText, numberToText, overflowExtent, parseAddress, parseCellInput, parseFormula, parseHex, parseHtmlTable, parseNumberText, parseRange, parseTsv, patchStyle, percentile, pictureAnchorAt, pixelBoxToAnchor, pixelSizeToExtent, pixelsToCharacters, pixelsToColumnWidth, pixelsToPoints, pointsToPixels, presetEdges, putCell, queryPattern, quoteSheetName, rangeContains, rangeSize, rangesIntersect, referenceSpans, referencedRanges, renameSheetInFormula, renameTableInFormula, renderChartSvg, replaceText, resolveColor, rgbToHls240, rotationDegrees, rowsToRefit, saveXlsx, scaleColor, selectionStats, serialToDate, sheetByName, shiftFormula, shiftRange, shiftSpan, spillAnchorOf, stepDecimals, stripFuturePrefixes, structuredToA1, styleAt, styleKey, subtractRange, themeColor, timePeriodFormula, toHexColor, toHtml, toTsv, tokenize, translateFormula, translateReferences, uniqueHeaders, usedRange, validateCellInput, validateDefinedName, validateSheetName, validateTableName, validationAt, verifySheetPassword, verifySheetPasswordAsync, verifyWorkbookPassword, visibleCells, wrappedLineCount, zoomPercent };
+export { AxisMetrics, BORDER_STYLES, BUILTIN_CELL_STYLES, BUILTIN_NUMBER_FORMATS, CIRCULAR_REFERENCE_WARNING, COLUMN_PADDING_PX, DEFAULT_ANCHOR_EXTENT_EMU, DEFAULT_BASE_COL_WIDTH, DEFAULT_COL_WIDTH, DEFAULT_MAX_DIGIT_WIDTH, DEFAULT_ROW_HEIGHT, DEFAULT_THEME, DEFAULT_VALIDATION_MESSAGE, ERROR_CODES, FORMAT_PRESETS, FUNCTION_CATALOG, FormulaError, IMAGE_EXTENSIONS, INDENT_PX_PER_LEVEL, INDEXED_COLORS, MAX_COL, MAX_DATE_SERIAL, MAX_OUTLINE_LEVEL, MAX_ROW, MIN_TWO_CELL_PIXELS, OVERFLOW_TEXT, PERCENT_SCALE, REFERENCE_COLORS, THEME_SLOTS, TIME_PERIODS, acceptsReference, activeParam, addFuturePrefixes, anchorKind, anchorToPixelBox, applyBuiltinStyle, applyStylePatch, applyTint, approximateMeasure, autoFitColumnWidth, autoFitRowHeight, autoGrowRows, autoSeriesColor, bordersView, builtinCellStyle, builtinFormatId, calcModeOf, callAtCaret, categoryTotals, cellError, cellInputText, cellKey, cellView, cellsFromText, charactersToColumnWidth, charactersToPixels, chartView, closeParens, coloredReferences, columnIndex, columnLabel, columnWidthToPixels, compareCellValues, compareValues, createCalcEngine, createConditionalFormatEvaluator, createEditSession, createGridMetrics, createRefEvaluator, createWorkbook, createWorksheet, currentRegion, dateToSerial, defaultCellStyle, defaultColumnPixels, deleteCell, deleteSheetInFormula, detectSeries, edgeView, effectiveStyleId, fillView, fontView, forEachCell, forEachCellInRange, formatAddress, formatAxisValue, formatGeneral, formatRange, formatRefSpec, formatValue, formulaBarText, functionMatches, generalAlignment, getCell, getCellAt, getValue, hls240ToRgb, inTimePeriod, insideString, internStyle, isCellError, isDateFormat, isEmptyCell, isErrorCode, isFormulaText, isOverflowTarget, isSpilledCell, keyToAddress, legacyPasswordHash, lineHeightPoints, listValidationOptions, loadXlsx, mergeAt, mergeFont, mergeView, mergeWouldDiscard, mixColors, modernPasswordHash, modulateLuminance, moveReferencesInFormula, nameAtCaret, navigate, needsArrayEvaluation, newMediaPart, nextSheetId, nextSheetName, niceScale, normalizeRange, numberInputText, numberToText, overflowExtent, parseAddress, parseCellInput, parseFormula, parseHex, parseHtmlTable, parseNumberText, parseRange, parseTsv, patchStyle, percentile, pictureAnchorAt, pixelBoxToAnchor, pixelSizeToExtent, pixelsToCharacters, pixelsToColumnWidth, pixelsToPoints, pointsToPixels, presetEdges, putCell, queryPattern, quoteSheetName, rangeContains, rangeSize, rangesIntersect, referenceSpans, referenceTarget, referencedRanges, renameSheetInFormula, renameTableInFormula, renderChartSvg, replaceText, resolveColor, rgbToHls240, rotationDegrees, rowsToRefit, saveXlsx, scaleColor, selectionStats, serialToDate, sheetByName, shiftFormula, shiftRange, shiftSpan, spillAnchorOf, splice, stepDecimals, stripFuturePrefixes, structuredToA1, styleAt, styleKey, subtractRange, syntaxParams, themeColor, timePeriodFormula, toHexColor, toHtml, toTsv, toggleAbsolute, tokenize, translateFormula, translateReferences, uniqueHeaders, usedRange, validateCellInput, validateDefinedName, validateSheetName, validateTableName, validationAt, verifySheetPassword, verifySheetPasswordAsync, verifyWorkbookPassword, visibleCells, wrappedLineCount, zoomPercent };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ooxml-core",
-	"version": "0.17.0",
+	"version": "0.18.0",
 	"description": "Shared OOXML logic for the Word, PowerPoint and Excel viewers: everything except the UI",
 	"keywords": [
 		"charts",
@@ -204,6 +204,7 @@
 		"test:package": "node scripts/package-smoke.mjs",
 		"test:scripts": "node --test 'scripts/*.test.mjs'",
 		"check:changelog": "node scripts/check-changelog-sections.mjs",
+		"fleet": "node scripts/fleet.mjs",
 		"release:plan": "node scripts/release-plan.mjs",
 		"release:publish": "node scripts/publish-released.mjs",
 		"changelog:unreleased": "bunx git-cliff --config cliff.toml --tag-pattern \"^ooxml-core@\" --unreleased",