ooxml-core 0.2.0 → 0.4.0

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

@@ -0,0 +1,36 @@
+import { type CellRange } from '../address.js';
+import type { Table } from '../model.js';
+import type { FormulaAst, RefSpec, SheetPrefix, StructuredRef } from './ast.js';
+import type { EvalHost, Frame } from './context.js';
+import { type Area, Matrix, type Scalar, type Value } from './values.js';
+/** Sheet index for a name (case-insensitive), or -1. */
+export declare function sheetIndex(host: EvalHost, name: string): number;
+/** The sheets a prefix names (several for a 3D reference); `undefined` when one is missing. */
+export declare function prefixSheets(host: EvalHost, prefix: SheetPrefix | undefined, current: number): number[] | undefined;
+export declare const specRange: (spec: RefSpec) => CellRange;
+/** Evaluates a `ref` node to a reference value (or `#REF!`). */
+export declare function resolveRefNode(node: Extract<FormulaAst, {
+    type: 'ref';
+}>, frame: Frame): Value;
+/** Finds a table by name in any sheet, or the table containing a cell. */
+export declare function findTable(host: EvalHost, name: string | undefined, sheet: number, row: number, col: number): {
+    table: Table;
+    sheet: number;
+} | undefined;
+/** Resolves a structured reference to an area, or an error. */
+export declare function resolveStructured(ref: StructuredRef, frame: Frame): Value;
+/** `:` between two references: the bounding box. */
+export declare function rangeOperator(left: Value, right: Value): Value;
+/** The space operator: the cells common to both references, or `#NULL!`. */
+export declare function intersectOperator(left: Value, right: Value): Value;
+/** The comma operator inside parentheses: a multi-area reference. */
+export declare function unionOperator(left: Value, right: Value): Value;
+/** Reads an area into a dense matrix (blank cells are `null`). */
+export declare function areaToMatrix(host: EvalHost, area: Area): Matrix;
+/** A dense matrix for any value; unions and lambdas are `#VALUE!`. */
+export declare function toMatrix(host: EvalHost, value: Value): Matrix;
+/** A single value: refs by implicit intersection with the formula's cell, arrays by their first element. */
+export declare function implicitIntersection(value: Value, frame: Frame): Scalar;
+/** Whether an area covers whole columns or rows (for sparse iteration choices). */
+export declare const isHuge: (range: CellRange) => boolean;
+//# sourceMappingURL=references.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/references.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAoC,MAAM,eAAe,CAAC;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACN,KAAK,IAAI,EAIT,MAAM,EAEN,KAAK,MAAM,EACX,KAAK,KAAK,EACV,MAAM,aAAa,CAAC;AAErB,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,+FAA+F;AAC/F,wBAAgB,YAAY,CAC3B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,OAAO,EAAE,MAAM,GACb,MAAM,EAAE,GAAG,SAAS,CAWtB;AAED,eAAO,MAAM,SAAS,GAAI,MAAM,OAAO,KAAG,SAIvC,CAAC;AAEJ,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAW9F;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CACxB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACT;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAoB7C;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CA8CzE;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAuB9D;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAmBlE;AAED,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAG9D;AAMD,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAc/D;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAS7D;AAED,4GAA4G;AAC5G,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAkBvE;AAED,mFAAmF;AACnF,eAAO,MAAM,MAAM,GAAI,OAAO,SAAS,KAAG,OAC+C,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Tarjan's strongly connected components (iterative). Edges point from a formula to its
+ * precedents, so components come out in evaluation order (precedents first).
+ */
+export declare function stronglyConnected<T>(nodes: Iterable<T>, successors: (node: T) => readonly T[]): T[][];
+//# sourceMappingURL=scc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scc.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/scc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAClC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAClB,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC,EAAE,GACnC,CAAC,EAAE,EAAE,CAiDP"}

package/dist/xlsx/formula/sheet-scan.d.ts

@@ -0,0 +1,10 @@
+import type { CellRange } from '../address.js';
+import type { Cell, Worksheet } from '../model.js';
+/** Visits stored cells inside a range in row-major order, touching only cells that exist. */
+export declare function scanRange(sheet: Worksheet, range: CellRange, visit: (cell: Cell, row: number, col: number) => void): void;
+/** One past the last stored row and column. */
+export declare function sheetBounds(sheet: Worksheet): {
+    rows: number;
+    cols: number;
+};
+//# sourceMappingURL=sheet-scan.d.ts.map

package/dist/xlsx/formula/sheet-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet-scan.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/sheet-scan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnD,6FAA6F;AAC7F,wBAAgB,SAAS,CACxB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,GACnD,IAAI,CA4BN;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAS5E"}

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

@@ -0,0 +1,32 @@
+import { type CellAddress, type CellRange } from '../address.js';
+import type { Cell, Worksheet } from '../model.js';
+import type { Matrix } from './values.js';
+/** A cell whose value was written by a spilling formula anchored at `spillAnchor`. */
+export interface SpilledCell extends Cell {
+    /** The formula cell that owns this value (same sheet). */
+    spillAnchor: CellAddress;
+}
+/**
+ * Whether a cell's value is a dynamic-array spill result rather than user data. Writers should
+ * not persist such values as constants (the anchor's formula recreates them); a spilled cell may
+ * still carry its own style.
+ */
+export declare const isSpilledCell: (cell: Cell | undefined) => cell is SpilledCell;
+/** The anchor of a spilled cell, if it is one. */
+export declare const spillAnchorOf: (cell: Cell | undefined) => CellAddress | undefined;
+/** Removes the spill marker and value from a cell (deleting it when nothing else remains). */
+export declare function releaseSpilledCell(sheet: Worksheet, row: number, col: number): void;
+/** Clears the cells of a spill footprint that still belong to the anchor at (row, col). */
+export declare function clearFootprint(sheet: Worksheet, footprint: CellRange, row: number, col: number): void;
+/** The footprint an array result anchored at (row, col) needs, or undefined beyond the grid. */
+export declare function footprintFor(row: number, col: number, m: Matrix): CellRange | undefined;
+/**
+ * Whether a footprint is free: every other cell is empty, a spill value of this anchor, or a
+ * stale spill value whose anchor no longer claims it (`claims`). Merged cells block.
+ */
+export declare function footprintFree(sheet: Worksheet, footprint: CellRange, row: number, col: number, claims: (anchor: CellAddress, r: number, c: number) => boolean): boolean;
+/** Writes an array result into its footprint (the anchor cell gets the first element). */
+export declare function writeFootprint(sheet: Worksheet, footprint: CellRange, m: Matrix): void;
+/** Fills a CSE array-formula range (size-1 dimensions repeat, the rest is #N/A). */
+export declare function fillArrayRange(sheet: Worksheet, range: CellRange, m: Matrix): void;
+//# sourceMappingURL=spill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spill.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/spill.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAqC,MAAM,eAAe,CAAC;AAEpG,OAAO,KAAK,EAAE,IAAI,EAAa,SAAS,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,sFAAsF;AACtF,MAAM,WAAW,WAAY,SAAQ,IAAI;IACxC,0DAA0D;IAC1D,WAAW,EAAE,WAAW,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,IAAI,GAAG,SAAS,KAAG,IAAI,IAAI,WACnB,CAAC;AAE7C,kDAAkD;AAClD,eAAO,MAAM,aAAa,GAAI,MAAM,IAAI,GAAG,SAAS,KAAG,WAAW,GAAG,SACX,CAAC;AAE3D,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAOnF;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAC7B,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACT,IAAI,CAYN;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAIvF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,GAC5D,OAAO,CAoBT;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAmBtF;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAUlF"}

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

@@ -0,0 +1,10 @@
+import { type CellAddress } from '../address.js';
+import type { Cell, Worksheet } from '../model.js';
+import type { FormulaNode } from './graph.js';
+import { Matrix, type Scalar } from './values.js';
+/**
+ * Stores `result` for `node`: a CSE formula fills its array range, an array result spills into
+ * free neighbouring cells (or shows #SPILL!), anything else becomes the cell value.
+ */
+export declare function storeResult(sheet: Worksheet, node: FormulaNode, cell: Cell, result: Scalar | Matrix, claims: (anchor: CellAddress, row: number, col: number) => boolean): void;
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAoB,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQ9C,OAAO,EAAO,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,GAChE,IAAI,CAkCN"}

package/dist/xlsx/formula/structured-to-a1.d.ts

@@ -0,0 +1,18 @@
+import type { Table } from '../model.js';
+export interface StructuredTarget {
+    table: Table;
+    /** Name of the sheet holding the table. */
+    tableSheet: string;
+    /** Sheet of the formula being rewritten (adds a sheet prefix when it differs). */
+    formulaSheet: string;
+    /** Row of the formula cell, for `[@Col]` (`#This Row`) references. */
+    row?: number;
+    /** The formula lies inside the table, so bare `[Col]` references mean this table. */
+    inside?: boolean;
+}
+/**
+ * Replaces references to `target.table` (structured references and the bare table name) with
+ * absolute A1 references. Unparsable formulas are returned unchanged.
+ */
+export declare function structuredToA1(formula: string, target: StructuredTarget): string;
+//# sourceMappingURL=structured-to-a1.d.ts.map

package/dist/xlsx/formula/structured-to-a1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-to-a1.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/structured-to-a1.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAKzC,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AA0DD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA0BhF"}

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

@@ -0,0 +1,4 @@
+import { type StructuredRef } from './ast.js';
+/** Parses `Table1[...]` (or a bare `[...]` inside a table) into its parts. */
+export declare function parseStructured(text: string, tableName: string): StructuredRef;
+//# sourceMappingURL=structured.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structured.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/structured.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAA0B,MAAM,UAAU,CAAC;AAyCpF,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CA0C9E"}

package/dist/xlsx/formula/table-refs.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Renames table `oldName` (case-insensitive) to `newName` in structured references
+ * (`Old[Col]`, `Old[[#Totals],[Col]]`) and bare table names (`=SUM(Old)`). Sheet-qualified
+ * names and text inside strings are left alone. Unparsable formulas are returned unchanged.
+ */
+export declare function renameTableInFormula(formula: string, oldName: string, newName: string): string;
+//# sourceMappingURL=table-refs.d.ts.map

package/dist/xlsx/formula/table-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-refs.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/table-refs.ts"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAgB9F"}

package/dist/xlsx/formula/test-helpers.d.ts

@@ -0,0 +1,32 @@
+import type { CellValue, Workbook } from '../model.js';
+import { type CalcEngine } from './engine.js';
+export type CellSpec = CellValue | `=${string}`;
+/** A workbook from `{ 'A1': 1, 'Sheet2!B2': '=A1*2' }`; strings starting with `=` are formulas. */
+export declare function book(cells?: Record<string, CellSpec>, sheets?: string[]): Workbook;
+export declare function locate(wb: Workbook, key: string): {
+    sheet: number;
+    row: number;
+    col: number;
+};
+export declare function set(wb: Workbook, key: string, value: CellSpec): void;
+export declare function get(wb: Workbook, key: string): CellValue;
+/** Values of a range as rows. */
+export declare function grid(wb: Workbook, ref: string, sheetIndex?: number): CellValue[][];
+/** A deterministic engine (fixed clock 2026-10-03 12:00, seeded random). */
+export declare function engine(wb: Workbook): CalcEngine;
+/** Puts `formula` in Sheet1!AA1 of a workbook with `cells`, recalculates, and returns its value. */
+export declare function calc(formula: string, cells?: Record<string, CellSpec>): CellValue;
+/** Like {@link calc} but returns the spilled block (`rows` x `cols`) anchored at AA1. */
+export declare function calcArray(formula: string, cells?: Record<string, CellSpec>, rows?: number, cols?: number): CellValue[][];
+export declare const E: {
+    DIV0: import("../model.js").CellError;
+    VALUE: import("../model.js").CellError;
+    REF: import("../model.js").CellError;
+    NAME: import("../model.js").CellError;
+    NUM: import("../model.js").CellError;
+    NA: import("../model.js").CellError;
+    NULL: import("../model.js").CellError;
+    SPILL: import("../model.js").CellError;
+    CALC: import("../model.js").CellError;
+};
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/xlsx/formula/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/test-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,aAAa,CAAC;AAGhE,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,IAAI,MAAM,EAAE,CAAC;AAEhD,mGAAmG;AACnG,wBAAgB,IAAI,CACnB,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAM,EACpC,MAAM,GAAE,MAAM,EAAyB,GACrC,QAAQ,CAIV;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAO7F;AAED,wBAAgB,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAOpE;AAED,wBAAgB,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAIxD;AAED,iCAAiC;AACjC,wBAAgB,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,SAAI,GAAG,SAAS,EAAE,EAAE,CAY7E;AAED,4EAA4E;AAC5E,wBAAgB,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,UAAU,CAS/C;AAED,oGAAoG;AACpG,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAM,GAAG,SAAS,CAKrF;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CACxB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAM,EACpC,IAAI,SAAI,EACR,IAAI,SAAI,GACN,SAAS,EAAE,EAAE,CAYf;AAED,eAAO,MAAM,CAAC;;;;;;;;;;CAUb,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * The number a text converts to in arithmetic, or `undefined` when Excel would report `#VALUE!`.
+ * Accepts thousands separators, currency, percent, parentheses for negatives, fractions, and
+ * US-style dates and times.
+ */
+export declare function parseNumberText(input: string): number | undefined;
+/** Rounds to 15 significant digits, the precision Excel displays and compares with. */
+export declare function round15(value: number): number;
+/** Excel's General conversion of a number to text (as `&`, CONCAT and friends produce it). */
+export declare function numberToText(value: number): string;
+//# sourceMappingURL=text-number.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text-number.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/text-number.ts"],"names":[],"mappings":"AAkGA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA6CjE;AAED,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsBlD"}

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

@@ -0,0 +1,21 @@
+import { type RefSpec, type SheetPrefix } from './ast.js';
+export { numberLiteral, readReference } from './lexemes.js';
+export type TokenKind = 'number' | 'string' | 'bool' | 'error' | 'ref' | 'name' | 'func' | 'structured' | 'op' | 'open' | 'close' | 'comma' | 'semicolon' | 'lbrace' | 'rbrace' | 'ws';
+/** A lexical token. `text` is the exact source slice, so joining every token's text round-trips. */
+export interface Token {
+    kind: TokenKind;
+    text: string;
+    start: number;
+    /** Number value, unescaped string, boolean, error code, or name / function / table name. */
+    value?: number | string | boolean;
+    prefix?: SheetPrefix;
+    /** Parsed reference (`ref` tokens); absent for `#REF!`. */
+    ref?: RefSpec;
+    /** `A1#` spill reference. */
+    spill?: boolean;
+}
+/** Splits a formula (with or without its leading `=`) into tokens, whitespace included. */
+export declare function tokenize(formula: string): Token[];
+/** Reassembles tokens into formula text. */
+export declare const joinTokens: (tokens: readonly Token[]) => string;
+//# sourceMappingURL=tokenizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/tokenizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAaxE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,MAAM,SAAS,GAClB,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,OAAO,GACP,KAAK,GACL,MAAM,GACN,MAAM,GACN,YAAY,GACZ,IAAI,GACJ,MAAM,GACN,OAAO,GACP,OAAO,GACP,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,IAAI,CAAC;AAER,oGAAoG;AACpG,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,4FAA4F;IAC5F,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,2FAA2F;AAC3F,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,CAmGjD;AAyDD,4CAA4C;AAC5C,eAAO,MAAM,UAAU,GAAI,QAAQ,SAAS,KAAK,EAAE,KAAG,MAA4C,CAAC"}

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

@@ -0,0 +1,49 @@
+import { type CellRange } from '../address.js';
+import { type RefSpec, type SheetPrefix } from './ast.js';
+import { type Token } from './tokenizer.js';
+export interface ShiftSpec {
+    /** Sheet whose rows or columns are inserted or deleted. */
+    sheet: string;
+    axis: 'row' | 'col';
+    /** Zero-based first row or column affected. */
+    at: number;
+    /** Positive to insert, negative to delete. */
+    count: number;
+}
+export declare function safeTokens(formula: string): Token[] | undefined;
+/** Formats a reference spec (without sheet prefix). */
+export declare function formatRefSpec(spec: RefSpec): string;
+/** Moves relative references by (dRow, dCol), as copying or filling a formula does. Off-grid parts become #REF!. */
+export declare function translateFormula(formula: string, dRow: number, dCol: number): string;
+/**
+ * Adjusts references for inserted (`count` > 0) or deleted (`count` < 0) rows or columns on
+ * `spec.sheet`. References into deleted cells become `#REF!`.
+ */
+export declare function shiftFormula(formula: string, formulaSheet: string, spec: ShiftSpec): string;
+/** The text of a sheet prefix (`Sheet1!`, `'My Sheet'!`), quoted when needed. */
+export declare function prefixText(prefix: SheetPrefix): string;
+/** Rewrites sheet prefixes naming `oldName` (case-insensitive) to `newName`, quoting as needed. */
+export declare function renameSheetInFormula(formula: string, oldName: string, newName: string): string;
+/** The ranges a formula references directly (for coloured reference highlighting). */
+export declare function referencedRanges(formula: string, formulaSheet: string): {
+    sheet: string;
+    range: CellRange;
+}[];
+/** A reference token's position in formula text, for colouring references while editing. */
+export interface ReferenceSpan {
+    /** Character offsets into the formula exactly as passed (a leading `=` counts). */
+    start: number;
+    end: number;
+    /** The reference text including its sheet prefix (`'My Sheet'!A1:B2`). */
+    text: string;
+    /** The sheet it points at (`formulaSheet` when unqualified). */
+    sheet: string;
+    range: CellRange;
+}
+/**
+ * Every A1 reference in a formula with its character span (cells, areas, whole rows and
+ * columns, sheet-qualified ones). `#REF!`, 3D and external-workbook references are skipped;
+ * an unparsable formula yields no spans.
+ */
+export declare function referenceSpans(formula: string, formulaSheet: string): ReferenceSpan[];
+//# sourceMappingURL=transform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/transform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAiD,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAgC,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACxF,OAAO,EAAc,KAAK,KAAK,EAAY,MAAM,gBAAgB,CAAC;AAElE,MAAM,WAAW,SAAS;IACzB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,SAAS,CAO/D;AAQD,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAInD;AAeD,oHAAoH;AACpH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBpF;AAkCD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAgC3F;AAOD,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAMtD;AAED,mGAAmG;AACnG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAkB9F;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,EAAE,CAgBvC;AAED,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC7B,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,aAAa,EAAE,CAqBrF"}

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

@@ -0,0 +1,63 @@
+import type { CellRange } from '../address.js';
+import type { CellError, ErrorCode } from '../model.js';
+import type { FormulaAst } from './ast.js';
+/** A single value as formulas see it; `null` is an empty cell (or an omitted argument). */
+export type Scalar = number | string | boolean | CellError | null;
+/** The shared, frozen error value for `code`. */
+export declare function err(code: ErrorCode): CellError;
+export declare const ERR: {
+    readonly NULL: CellError;
+    readonly DIV0: CellError;
+    readonly VALUE: CellError;
+    readonly REF: CellError;
+    readonly NAME: CellError;
+    readonly NUM: CellError;
+    readonly NA: CellError;
+    readonly SPILL: CellError;
+    readonly CALC: CellError;
+};
+export declare const isError: (value: unknown) => value is CellError;
+/** A dense two-dimensional array of values (array constants, array results, dereferenced ranges). */
+export declare class Matrix {
+    readonly data: Scalar[][];
+    constructor(data: Scalar[][]);
+    get rows(): number;
+    get cols(): number;
+    get(row: number, col: number): Scalar;
+    static build(rows: number, cols: number, fill: (row: number, col: number) => Scalar): Matrix;
+    map(fn: (value: Scalar, row: number, col: number) => Scalar): Matrix;
+    /** Every element in row-major order. */
+    flat(): Scalar[];
+}
+/** One rectangular area of a reference. */
+export interface Area {
+    sheet: number;
+    range: CellRange;
+}
+/** A reference to one or more areas (a union when there are several). */
+export declare class RefValue {
+    readonly areas: readonly Area[];
+    constructor(areas: readonly Area[]);
+    get first(): Area | undefined;
+    /** Whether this is a single cell. */
+    isCell(): boolean;
+}
+/** Lexical variables of LET and LAMBDA, keyed by upper-case name. */
+export type Scope = ReadonlyMap<string, Value>;
+/** A LAMBDA closure. */
+export declare class LambdaValue {
+    readonly params: readonly string[];
+    readonly body: FormulaAst;
+    readonly scope: Scope | undefined;
+    constructor(params: readonly string[], body: FormulaAst, scope: Scope | undefined);
+}
+export type Value = Scalar | Matrix | RefValue | LambdaValue;
+/** Thrown inside function implementations to return an error value. */
+export declare class ErrorSignal {
+    readonly value: CellError;
+    constructor(value: CellError);
+}
+/** Throws the error value `value` (or the error with `code`). */
+export declare function fail(value: CellError | ErrorCode): never;
+export declare const isScalar: (value: Value) => value is Scalar;
+//# sourceMappingURL=values.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,2FAA2F;AAC3F,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;AAIlE,iDAAiD;AACjD,wBAAgB,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAO9C;AAED,eAAO,MAAM,GAAG;;;;;;;;;;CAUN,CAAC;AAEX,eAAO,MAAM,OAAO,wCAAc,CAAC;AAEnC,qGAAqG;AACrG,qBAAa,MAAM;IACN,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;gBAAhB,IAAI,EAAE,MAAM,EAAE,EAAE;IAErC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIrC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM;IAU5F,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM;IAIpE,wCAAwC;IACxC,IAAI,IAAI,MAAM,EAAE;CAGhB;AAED,2CAA2C;AAC3C,MAAM,WAAW,IAAI;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;CACjB;AAED,yEAAyE;AACzE,qBAAa,QAAQ;IACR,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE;gBAAtB,KAAK,EAAE,SAAS,IAAI,EAAE;IAE3C,IAAI,KAAK,IAAI,IAAI,GAAG,SAAS,CAE5B;IAED,qCAAqC;IACrC,MAAM,IAAI,OAAO;CASjB;AAED,qEAAqE;AACrE,MAAM,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE/C,wBAAwB;AACxB,qBAAa,WAAW;IAEtB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE;IAClC,QAAQ,CAAC,IAAI,EAAE,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS;gBAFxB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,KAAK,GAAG,SAAS;CAElC;AAED,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE7D,uEAAuE;AACvE,qBAAa,WAAW;IACX,QAAQ,CAAC,KAAK,EAAE,SAAS;gBAAhB,KAAK,EAAE,SAAS;CACrC;AAED,iEAAiE;AACjE,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,CAExD;AAED,eAAO,MAAM,QAAQ,GAAI,OAAO,KAAK,KAAG,KAAK,IAAI,MACuC,CAAC"}