ooxml-core 0.3.0 → 0.5.0

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"}