ooxml-core 0.9.0 → 0.11.0

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

@@ -1,4 +1,5 @@
-import { type CellRange } from '../address.js';
+import type { CellRange } from '../address.js';
+import type { CellError } from '../model.js';
 import { type FormulaAst } from './ast.js';
 import type { EvalHost } from './context.js';
 import { type Area } from './values.js';
@@ -9,8 +10,15 @@ export interface FormulaNode {
     col: number;
     formula: string;
     ast: FormulaAst | undefined;
-    /** Static precedents. */
+    /** Static precedents: evaluation order and cycle detection follow these. */
     deps: Area[];
+    /**
+     * Areas read only through reference arguments (OFFSET's base, INDEX's array, ROW's
+     * reference) or spanned by `:` between computed references. They only drive incremental
+     * recalculation: the cells actually read are computed on demand, so `=OFFSET(B2,-1,0)+1` in
+     * B2 is not a circular reference (a real loop is still found while evaluating).
+     */
+    dynamicDeps: Area[];
     volatile: boolean;
     /** Uses a function this engine does not implement. */
     unsupported: boolean;
@@ -24,27 +32,14 @@ export interface FormulaNode {
     spill?: CellRange;
     /** Where the formula would spill if it were not blocked. */
     blockedSpill?: CellRange;
+    /** The error shown for a formula that cannot be parsed for a reason other than syntax. */
+    parseError?: CellError;
 }
 /** Static precedents of a formula plus whether it is volatile or uses unknown functions. */
 export declare function analyze(ast: FormulaAst, host: EvalHost, sheet: number, row: number, col: number): {
     deps: Area[];
+    dynamicDeps: Area[];
     volatile: boolean;
     unsupported: boolean;
 };
-/** Formula nodes by sheet and column, rows sorted, for "which formulas are inside this range". */
-export declare class ColumnIndex {
-    private readonly sheets;
-    constructor(nodes: Iterable<FormulaNode>);
-    nodesIn(area: Area, out: FormulaNode[]): void;
-}
-/** Which formulas read a cell: single-cell deps by key, ranges bucketed by column. */
-export declare class ReverseIndex {
-    private readonly cells;
-    private readonly columns;
-    private readonly wide;
-    constructor(nodes: Iterable<FormulaNode>);
-    private add;
-    /** Formulas whose precedents intersect `range` on `sheet`. */
-    dependents(sheet: number, range: CellRange, out: Set<FormulaNode>): void;
-}
 //# sourceMappingURL=graph.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/graph.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,SAAS,EAAiC,MAAM,eAAe,CAAC;AACvF,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAI7C,OAAO,EAAE,KAAK,IAAI,EAAY,MAAM,aAAa,CAAC;AAElD,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,UAAU,GAAG,SAAS,CAAC;IAC5B,yBAAyB;IACzB,IAAI,EAAE,IAAI,EAAE,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,WAAW,EAAE,OAAO,CAAC;IACrB,gFAAgF;IAChF,UAAU,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,kGAAkG;IAClG,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,SAAS,CAAC;CACzB;AA4GD,4FAA4F;AAC5F,wBAAgB,OAAO,CACtB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACT;IAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAa3D;AAED,kGAAkG;AAClG,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;gBAE5D,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC;IAYxC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,IAAI;CA4B7C;AAID,sFAAsF;AACtF,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiD;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGpB;IACJ,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgE;gBAEzE,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC;IAIxC,OAAO,CAAC,GAAG;IA2BX,8DAA8D;IAC9D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,IAAI;CA4CxE"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/graph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAI7C,OAAO,EAAE,KAAK,IAAI,EAAY,MAAM,aAAa,CAAC;AAElD,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,UAAU,GAAG,SAAS,CAAC;IAC5B,4EAA4E;IAC5E,IAAI,EAAE,IAAI,EAAE,CAAC;IACb;;;;;OAKG;IACH,WAAW,EAAE,IAAI,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,WAAW,EAAE,OAAO,CAAC;IACrB,gFAAgF;IAChF,UAAU,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,kGAAkG;IAClG,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,SAAS,CAAC;CACvB;AAqKD,4FAA4F;AAC5F,wBAAgB,OAAO,CACtB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACT;IAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAoBhF"}

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

@@ -1,5 +1,7 @@
 import { Matrix, type Scalar } from './values.js';
 export type ScalarOp = (a: Scalar, b: Scalar) => Scalar;
+/** `(-8)^(1/3)` is -2 in Excel: odd roots of negative numbers are allowed (POWER shares it). */
+export declare function power(base: number, exponent: number): number;
 /** Excel sets a final addition or subtraction that cancels to within 15 digits to exactly 0. */
 export declare function snapToZero(result: number, a: number, b: number): number;
 /** Applies a binary operator to two scalars. */
@@ -8,6 +10,13 @@ export declare function scalarBinary(op: string, x: Scalar, y: Scalar, snap?: bo
 export declare function scalarUnary(op: '-' | '%', x: Scalar): Scalar;
 /** The element of a broadcast operand at a position (size-1 dimensions repeat; outside is #N/A). */
 export declare function pick(m: Matrix, row: number, col: number): Scalar;
+/**
+ * The elementwise result over broadcast operands, `at(r, c)` giving one element. When an operand
+ * is padded (a whole-column read), only the block the operands store is computed and the rest
+ * becomes padding holding the value of one tail element, as long as every operand is uniform
+ * there; otherwise the full result is built (within the array size limits).
+ */
+export declare function broadcastShape(operands: Matrix[], at: (r: number, c: number) => Scalar): Matrix;
 /** Broadcasts a binary scalar function over matrices like Excel's array arithmetic. */
 export declare function broadcast2(a: Scalar | Matrix, b: Scalar | Matrix, fn: ScalarOp): Scalar | Matrix;
 /** Maps a unary scalar function over a matrix. */

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

@@ -1 +1 @@
-{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/operators.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6B,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE7E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AA0BxD,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGvE;AA0DD,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,UAAQ,GAAG,MAAM,CAMnF;AAED,+BAA+B;AAC/B,wBAAgB,WAAW,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAO5D;AAED,oGAAoG;AACpG,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAOhG;AAED,kDAAkD;AAClD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,MAAM,CAEzF"}
+{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/operators.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6B,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE7E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAWxD,gGAAgG;AAChG,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGvE;AA0DD,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,UAAQ,GAAG,MAAM,CAMnF;AAED,+BAA+B;AAC/B,wBAAgB,WAAW,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAO5D;AAED,oGAAoG;AACpG,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAwB/F;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAKhG;AAED,kDAAkD;AAClD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,MAAM,CAEzF"}

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

@@ -1,4 +1,6 @@
 import { type FormulaAst } from './ast.js';
+/** Excel allows 64 nested function calls; deeper formulas show #VALUE! here. */
+export declare const MAX_FUNCTION_NESTING = 64;
 /** Parses a formula (without, or with, its leading `=`) into a syntax tree. Throws FormulaError. */
 export declare function parseFormula(formula: string): FormulaAst;
 //# sourceMappingURL=parser.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAIN,KAAK,UAAU,EAEf,MAAM,UAAU,CAAC;AAkClB,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAoBxD"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAIN,KAAK,UAAU,EAEf,MAAM,UAAU,CAAC;AAclB,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AA2BvC,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAoBxD"}

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

@@ -25,7 +25,10 @@ export declare function rangeOperator(left: Value, right: Value): Value;
 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`). */
+/**
+ * Reads an area into a matrix (blank cells are `null`). Large areas read only the sheet's used
+ * part and pad the rest with blanks, so whole-column references keep their full size.
+ */
 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;

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

@@ -1 +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"}
+{"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,EAGN,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;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAgB/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/text-number.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"text-number.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/text-number.ts"],"names":[],"mappings":"AAsGA;;;;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/transform.d.ts.map

@@ -1 +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"}
+{"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;AA6ED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAiC3F;AAaD,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

@@ -17,15 +17,55 @@ export declare const ERR: {
     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). */
+/** Excel's longest array side: SEQUENCE(1048577) and SEQUENCE(1,1048577) are `#VALUE!`. */
+export declare const MAX_ARRAY_SIDE = 1048576;
+/**
+ * The most cells one array may hold, so no formula can exhaust memory (Excel gives up somewhere
+ * past 40 million with "out of resources"; this engine stops at 16 million with `#NUM!`).
+ */
+export declare const MAX_ARRAY_CELLS = 16777216;
+/** `#VALUE!` past the longest side, `#NUM!` past the cell budget. */
+export declare function checkArraySize(rows: number, cols: number): void;
+/** The part of a padded matrix outside its stored block: every such cell holds `fill`. */
+interface Padding {
+    rows: number;
+    cols: number;
+    fill: Scalar;
+}
+/**
+ * A two-dimensional array of values (array constants, array results, dereferenced ranges). A
+ * padded matrix stores only a top-left block and reports a larger size whose remaining cells all
+ * hold one value: whole-column references read that way, so `ROWS(A:A*1)` is 1048576 and
+ * `SUMPRODUCT(--(A:A=""))` counts every blank row without materialising a million cells.
+ */
 export declare class Matrix {
-    readonly data: Scalar[][];
-    constructor(data: Scalar[][]);
+    private readonly dense;
+    private readonly padding;
+    /** The full rows of a padded matrix, built once when `data` is first asked for. */
+    private materialized;
+    constructor(data: Scalar[][], padding?: Padding);
+    /** A padded matrix (or a plain one when `rows` x `cols` is no larger than the block). */
+    static padded(block: Matrix, rows: number, cols: number, fill: Scalar): Matrix;
+    /** Every row, materialising a padded matrix (bounded by `MAX_ARRAY_CELLS`). */
+    get data(): Scalar[][];
     get rows(): number;
     get cols(): number;
+    /** Whether some cells are implied by the padding rather than stored. */
+    get isPadded(): boolean;
+    /** Rows and columns of the stored block. */
+    get blockRows(): number;
+    get blockCols(): number;
+    /** The value of every cell outside the stored block. */
+    get fill(): Scalar;
     get(row: number, col: number): Scalar;
+    /** Only the stored block of a padded matrix (what a spilling formula shows). */
+    block(): Matrix;
     static build(rows: number, cols: number, fill: (row: number, col: number) => Scalar): Matrix;
     map(fn: (value: Scalar, row: number, col: number) => Scalar): Matrix;
+    /** Maps every value; a padded matrix maps its block and its fill once. */
+    mapValues(fn: (value: Scalar) => Scalar): Matrix;
+    /** Visits every value in row-major order without materialising a padded matrix. */
+    forEachValue(visit: (value: Scalar) => void): void;
     /** Every element in row-major order. */
     flat(): Scalar[];
 }
@@ -60,4 +100,5 @@ export declare class ErrorSignal {
 /** 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;
+export {};
 //# sourceMappingURL=values.d.ts.map

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

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