ooxml-core 0.2.0 → 0.4.0

package/dist/xlsx/edit/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/xlsx/edit/view.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,cAAc,CAAC;AAEzD,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAgB3F;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAezF;AAID,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOpE;AAKD,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAYxE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAM3F"}

package/dist/xlsx/formula/array-context.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Whether a formula needs dynamic-array evaluation to keep its meaning: it returns several
+ * values, or applies an operator or a single-value parameter to a range or array outside the
+ * functions that take arrays natively (`SUM(A1:A3*B1:B3)`). Unparsable formulas report false.
+ */
+export declare function needsArrayEvaluation(formula: string): boolean;
+//# sourceMappingURL=array-context.d.ts.map

package/dist/xlsx/formula/array-context.d.ts.map

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

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

@@ -0,0 +1,108 @@
+import type { ErrorCode } from '../model.js';
+/** Thrown by {@link parseFormula} (and the tokenizer) for malformed formulas. */
+export declare class FormulaError extends Error {
+    /** Character offset in the formula where the problem was found. */
+    readonly position: number;
+    constructor(message: string, 
+    /** Character offset in the formula where the problem was found. */
+    position?: number);
+}
+/** One end of a reference. Whole-column refs have no row, whole-row refs no column. */
+export interface RefCorner {
+    row: number;
+    col: number;
+    rowAbs: boolean;
+    colAbs: boolean;
+}
+/** A parsed A1-style reference without its sheet prefix. */
+export interface RefSpec {
+    kind: 'cell' | 'area' | 'cols' | 'rows';
+    start: RefCorner;
+    /** Same as `start` for a single cell. */
+    end: RefCorner;
+}
+/** The sheet part of a reference: `Sheet1!`, `'My Sheet'!`, `Sheet1:Sheet3!`, `[1]Sheet1!`. */
+export interface SheetPrefix {
+    /** Raw prefix text including the trailing `!`, preserved when formulas are rewritten. */
+    text: string;
+    sheet: string;
+    /** Last sheet of a 3D reference. */
+    sheet2?: string;
+    /** External workbook index or name (`[1]`). */
+    book?: string;
+}
+export type StructuredSpecial = '#All' | '#Data' | '#Headers' | '#Totals' | '#This Row';
+/** A structured (table) reference such as `Table1[[#This Row],[Amount]]`. */
+export interface StructuredRef {
+    table?: string;
+    specials: StructuredSpecial[];
+    /** First (and last, for `[A]:[B]`) column name; absent means every column. */
+    column?: string;
+    column2?: string;
+}
+export type BinaryOperator = '+' | '-' | '*' | '/' | '^' | '&' | '=' | '<>' | '<' | '>' | '<=' | '>=' | ':' | ' ' | ',';
+/** The formula syntax tree produced by {@link parseFormula}. */
+export type FormulaAst = {
+    type: 'number';
+    value: number;
+} | {
+    type: 'string';
+    value: string;
+} | {
+    type: 'boolean';
+    value: boolean;
+} | {
+    type: 'error';
+    code: ErrorCode;
+} | {
+    type: 'ref';
+    prefix?: SheetPrefix;
+    /** Absent for `#REF!` (optionally sheet-qualified). */
+    ref?: RefSpec;
+    /** `A1#` spill reference. */
+    spill?: boolean;
+} | {
+    type: 'name';
+    prefix?: SheetPrefix;
+    name: string;
+} | {
+    type: 'structured';
+    ref: StructuredRef;
+    text: string;
+} | {
+    type: 'array';
+    rows: ArrayConstant[][];
+} | {
+    type: 'unary';
+    op: '-' | '+' | '@';
+    operand: FormulaAst;
+} | {
+    type: 'percent';
+    operand: FormulaAst;
+} | {
+    type: 'binary';
+    op: BinaryOperator;
+    left: FormulaAst;
+    right: FormulaAst;
+} | {
+    type: 'call';
+    /** Upper case, without `_xlfn.` / `_xlws.` prefixes. */
+    name: string;
+    /** As written. */
+    rawName: string;
+    args: FormulaAst[];
+} | {
+    type: 'invoke';
+    callee: FormulaAst;
+    args: FormulaAst[];
+} | {
+    type: 'missing';
+};
+export type ArrayConstant = number | string | boolean | {
+    error: ErrorCode;
+};
+/** Strips the storage prefixes Excel writes for newer functions (`_xlfn.`, `_xlws.`, `_xludf.`). */
+export declare function normalizeFunctionName(name: string): string;
+/** Strips the `_xlpm.` prefix Excel writes for LET and LAMBDA parameter names. */
+export declare function normalizeLocalName(name: string): string;
+//# sourceMappingURL=ast.d.ts.map

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

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

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

@@ -0,0 +1,13 @@
+import { type FormulaAst } from './ast.js';
+import type { CallContext, Frame } from './context.js';
+import { type FunctionSpec } from './functions/types.js';
+import { type Value } from './values.js';
+/** Evaluates a function call node. */
+export declare function callFunction(node: Extract<FormulaAst, {
+    type: 'call';
+}>, frame: Frame): Value;
+/** Calls a function implementation, lifting it over arrays passed to `value` parameters. */
+export declare function applyFunction(spec: FunctionSpec, args: Value[], ctx: CallContext): Value;
+/** Builds the context passed to function implementations. */
+export declare function createContext(frame: Frame): CallContext;
+//# sourceMappingURL=call.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/call.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAsB,MAAM,UAAU,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAW,MAAM,cAAc,CAAC;AAIhE,OAAO,EAAE,KAAK,YAAY,EAAa,MAAM,sBAAsB,CAAC;AAIpE,OAAO,EAQN,KAAK,KAAK,EACV,MAAM,aAAa,CAAC;AAWrB,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAoC7F;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,WAAW,GAAG,KAAK,CA2CxF;AASD,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CA8CvD"}

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

@@ -0,0 +1,22 @@
+import type { CellError } from '../model.js';
+import { type Scalar } from './values.js';
+/** A number as arithmetic sees it: blank is 0, TRUE is 1, numeric text converts. Throws on errors. */
+export declare function toNumber(value: Scalar): number;
+/** Text as `&` sees it: blank is empty, numbers use General formatting. Throws on errors. */
+export declare function toText(value: Scalar): string;
+/** A logical as IF sees it: numbers are non-zero, text must be TRUE or FALSE. Throws on errors. */
+export declare function toBool(value: Scalar): boolean;
+/** Throws when `value` is an error. */
+export declare function check(value: Scalar): Exclude<Scalar, CellError>;
+/** Compares numbers at Excel's 15-significant-digit precision. */
+export declare function compareNumbers(a: number, b: number): number;
+/** Case-insensitive text comparison. */
+export declare function compareText(a: string, b: string): number;
+/**
+ * Compares two non-error scalars like Excel's comparison operators: numbers sort before text,
+ * text before logicals; blank takes the other side's type (0, "", FALSE).
+ */
+export declare function compareScalars(a: Exclude<Scalar, CellError>, b: Exclude<Scalar, CellError>): number;
+/** A finite result, or `#NUM!`. */
+export declare function finite(value: number): number;
+//# sourceMappingURL=coerce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/coerce.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAA6B,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAErE,sGAAsG;AACtG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAU9C;AAED,6FAA6F;AAC7F,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED,mGAAmG;AACnG,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAW7C;AAED,uCAAuC;AACvC,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAG/D;AAKD,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC7B,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,EAC7B,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,GAC3B,MAAM,CAUR;AASD,mCAAmC;AACnC,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG5C"}

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

@@ -0,0 +1,74 @@
+import type { CellRange } from '../address.js';
+import type { Workbook } from '../model.js';
+import type { FormulaAst, FormulaError } from './ast.js';
+import type { Matrix, RefValue, Scalar, Scope, Value } from './values.js';
+/** What the evaluator needs from its environment; the calc engine implements it. */
+export interface EvalHost {
+    readonly workbook: Workbook;
+    /** A cell's value, computing a pending formula first. */
+    readCell(sheet: number, row: number, col: number): Scalar;
+    /** Visits stored cells with a non-null value inside a range, in row-major order. */
+    forEachStored(sheet: number, range: CellRange, visit: (value: Scalar, row: number, col: number) => void): void;
+    /** One past the last stored row and column of a sheet. */
+    bounds(sheet: number): {
+        rows: number;
+        cols: number;
+    };
+    /** The spill range anchored at a cell, if it currently spills. */
+    spillRange(sheet: number, row: number, col: number): CellRange | undefined;
+    /** The formula text of a cell, if it has one. */
+    cellFormula(sheet: number, row: number, col: number): string | undefined;
+    /** Parses with caching. */
+    parse(formula: string): FormulaAst | FormulaError;
+    now(): Date;
+    random(): number;
+}
+/** One evaluation: where the formula lives and which LET / LAMBDA variables are in scope. */
+export interface Frame {
+    readonly host: EvalHost;
+    readonly sheet: number;
+    readonly row: number;
+    readonly col: number;
+    readonly scope: Scope | undefined;
+    /** Defined-name nesting depth (guards against names that refer to themselves). */
+    readonly depth: number;
+    /** The root node, for Excel's final-result rounding of additions and subtractions. */
+    readonly root?: FormulaAst | undefined;
+    /**
+     * Pre-dynamic-array (legacy) evaluation: a multi-cell reference used where one value is
+     * expected (an operator operand, a `value` parameter, the final result) is reduced by implicit
+     * intersection. Arguments of `any` (array) parameters are evaluated without it, as in Excel.
+     */
+    readonly legacy?: boolean;
+}
+/** A lazily evaluated argument (IF, IFERROR, CHOOSE, LET, LAMBDA, ...). */
+export interface LazyArg {
+    readonly node: FormulaAst;
+    get(): Value;
+}
+/** What function implementations receive besides their arguments. */
+export interface CallContext {
+    readonly frame: Frame;
+    readonly workbook: Workbook;
+    readonly sheet: number;
+    readonly row: number;
+    readonly col: number;
+    readonly date1904: boolean;
+    /** A dense matrix of a value (refs are read cell by cell). Throws `#VALUE!` for unions. */
+    toMatrix(value: Value): Matrix;
+    /** A single value by implicit intersection. */
+    toScalar(value: Value): Scalar;
+    /**
+     * Visits the values of an argument: refs sparsely (stored cells only), arrays fully, and
+     * a scalar argument once with `kind` `direct`.
+     */
+    forEach(value: Value, visit: (value: Scalar, kind: 'direct' | 'ref' | 'array') => void): void;
+    readCell(sheet: number, row: number, col: number): Scalar;
+    /** Evaluates a node in this call's frame, optionally with extra variables. */
+    evaluate(node: FormulaAst, scope?: Scope): Value;
+    /** Calls a LAMBDA value. */
+    callLambda(fn: Value, args: Value[]): Value;
+    /** Resolves reference text (`A1`, `Sheet2!B2:C3`, a defined name) for INDIRECT. */
+    parseReference(text: string): RefValue | undefined;
+}
+//# sourceMappingURL=context.d.ts.map

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

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

package/dist/xlsx/formula/date-serial.d.ts

@@ -0,0 +1,26 @@
+export interface Ymd {
+    year: number;
+    month: number;
+    day: number;
+}
+/** The date system used by coercions inside the current evaluation. */
+export declare const currentDate1904: () => boolean;
+/** Runs `fn` with the given date system active for text-to-date coercion. */
+export declare function withDateSystem<T>(date1904: boolean, fn: () => T): T;
+/** The calendar date of the integer part of `serial`. */
+export declare function serialToYmd(serial: number, date1904?: boolean): Ymd;
+/**
+ * The serial of a calendar date, normalising month and day overflow like Excel's DATE (month 13
+ * is January of the next year, day 0 is the last day of the previous month). Returns `undefined`
+ * for dates before the epoch or after 9999-12-31.
+ */
+export declare function ymdToSerial(year: number, month: number, day: number, date1904?: boolean): number | undefined;
+/** Day of the week of a serial, 0 = Sunday (honours the 1900 bug: serial 1 is a Sunday). */
+export declare function weekdayOf(serial: number, date1904?: boolean): number;
+/** Whole seconds in the fractional part of a serial, rounded like Excel's HOUR/MINUTE/SECOND. */
+export declare function serialSeconds(serial: number): number;
+export declare const isLeapYear: (year: number) => boolean;
+export declare function daysInMonth(year: number, month: number): number;
+/** The serial for a JavaScript Date's local wall-clock time (for NOW and TODAY). */
+export declare function localDateToSerial(date: Date, date1904?: boolean): number;
+//# sourceMappingURL=date-serial.d.ts.map

package/dist/xlsx/formula/date-serial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-serial.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/date-serial.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACZ;AAID,uEAAuE;AACvE,eAAO,MAAM,eAAe,QAAO,OAAuB,CAAC;AAE3D,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQnE;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,UAAe,GAAG,GAAG,CAUxE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,QAAQ,UAAe,GACrB,MAAM,GAAG,SAAS,CAYpB;AAED,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,UAAe,GAAG,MAAM,CAKzE;AAED,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,OACe,CAAC;AAE1D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,UAAe,GAAG,MAAM,CAa7E"}

package/dist/xlsx/formula/engine-core.d.ts

@@ -0,0 +1,19 @@
+import type { Cell } from '../model.js';
+import type { FormulaAst } from './ast.js';
+import type { Frame } from './context.js';
+import { EngineHost } from './engine-host.js';
+import type { FormulaNode } from './graph.js';
+import { type Matrix, type Scalar } from './values.js';
+export declare abstract class EngineCore extends EngineHost {
+    protected releaseAllSpills(): void;
+    protected run(seeds: Set<FormulaNode>, everything: boolean): void;
+    /** Seeds plus every formula that (transitively) reads their cells or spill ranges. */
+    protected closure(seeds: Set<FormulaNode>): Set<FormulaNode>;
+    protected evaluateSet(dirty: Set<FormulaNode>): void;
+    protected markCycle(node: FormulaNode): void;
+    protected compute(node: FormulaNode): void;
+    protected store(node: FormulaNode, cell: Cell, result: Scalar | Matrix): void;
+    protected frameFor(sheet: number, row: number, col: number, root: FormulaAst | undefined, legacy?: boolean): Frame;
+    protected evaluateFormula(node: FormulaNode): Scalar | Matrix;
+}
+//# sourceMappingURL=engine-core.d.ts.map

package/dist/xlsx/formula/engine-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-core.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/engine-core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,OAAO,EAAoB,KAAK,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAIzE,8BAAsB,UAAW,SAAQ,UAAU;IAClD,SAAS,CAAC,gBAAgB,IAAI,IAAI;IASlC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAiBjE,sFAAsF;IACtF,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC;IAyB5D,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,IAAI;IAqCpD,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAO5C,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAkB1C,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAqB7E,SAAS,CAAC,QAAQ,CACjB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,MAAM,UAAQ,GACZ,KAAK;IAMR,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM;CAe7D"}

package/dist/xlsx/formula/engine-host.d.ts

@@ -0,0 +1,51 @@
+import { type CellRange } from '../address.js';
+import type { Cell, Workbook } from '../model.js';
+import { FormulaError, type FormulaAst } from './ast.js';
+import type { EvalHost } from './context.js';
+import type { CalcEngineOptions } from './engine-types.js';
+import { ColumnIndex, type FormulaNode, ReverseIndex } from './graph.js';
+import type { Area, Scalar } from './values.js';
+export declare abstract class EngineHost implements EvalHost {
+    readonly workbook: Workbook;
+    protected readonly options: CalcEngineOptions;
+    protected readonly nodes: Map<number, Map<number, FormulaNode>>;
+    protected readonly footprints: Set<FormulaNode>;
+    protected readonly astCache: Map<string, FormulaError | FormulaAst>;
+    protected readonly boundsCache: Map<number, {
+        rows: number;
+        cols: number;
+    }>;
+    protected readonly inProgress: Set<FormulaNode>;
+    protected cycles: Set<FormulaNode>;
+    protected dynamicCycleHits: Set<FormulaNode>;
+    protected pending: Set<FormulaNode> | undefined;
+    protected columnIndex: ColumnIndex | undefined;
+    protected reverseIndex: ReverseIndex | undefined;
+    protected footprintChanges: Area[];
+    protected built: boolean;
+    protected needsFull: boolean;
+    constructor(workbook: Workbook, options: CalcEngineOptions);
+    readCell(sheet: number, row: number, col: number): Scalar;
+    protected dynamicCycleHit: boolean;
+    protected ensureComputed(sheet: number, row: number, col: number, cell: Cell): void;
+    forEachStored(sheet: number, range: CellRange, visit: (value: Scalar, row: number, col: number) => void): void;
+    bounds(sheet: number): {
+        rows: number;
+        cols: number;
+    };
+    spillRange(sheet: number, row: number, col: number): CellRange | undefined;
+    cellFormula(sheet: number, row: number, col: number): string | undefined;
+    parse(formula: string): FormulaAst | FormulaError;
+    now(): Date;
+    random(): number;
+    protected build(): void;
+    protected createNode(sheet: number, row: number, col: number, cell: Cell, initial: boolean): FormulaNode;
+    protected removeNode(node: FormulaNode, changed: Area[]): void;
+    protected graphChanged(): void;
+    protected allNodes(): FormulaNode[];
+    protected columns(): ColumnIndex;
+    protected reverse(): ReverseIndex;
+    /** Evaluates a pending formula node now (defined by the engine). */
+    protected abstract compute(node: FormulaNode): void;
+}
+//# sourceMappingURL=engine-host.d.ts.map

package/dist/xlsx/formula/engine-host.d.ts.map

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

package/dist/xlsx/formula/engine-types.d.ts

@@ -0,0 +1,31 @@
+import type { CellRange } from '../address.js';
+import type { CellValue } from '../model.js';
+export interface CellPosition {
+    sheet: number;
+    row: number;
+    col: number;
+}
+export interface CalcEngine {
+    /** Evaluates every formula cell and sets `cell.value`. */
+    recalculateAll(): void;
+    /** Recalculates the formulas that depend on the changed cells (and volatile formulas). */
+    recalculateFrom(changes: CellPosition[]): void;
+    /** Evaluates an ad hoc formula at a position (status bar, conditional formats, validation). */
+    evaluate(formula: string, at: CellPosition): CellValue;
+    /** Forgets the dependency graph (after structural edits); the next recalculation rebuilds it. */
+    invalidate(): void;
+    /** Like `evaluate` but keeps array results (list validation sources, chart series). */
+    evaluateArray(formula: string, at: CellPosition): CellValue[][];
+    /** The current spill range anchored at a cell. */
+    spillRange(sheet: number, row: number, col: number): CellRange | undefined;
+    /** Formula cells found in circular references during the last recalculation. */
+    circularCells(): CellPosition[];
+}
+export interface CalcEngineOptions {
+    /** Clock for NOW and TODAY (tests). */
+    now?: () => Date;
+    /** Random source for RAND, RANDBETWEEN and RANDARRAY (tests). */
+    random?: () => number;
+}
+export declare const CIRCULAR_REFERENCE_WARNING = "The workbook contains circular references; the cells involved show 0.";
+//# sourceMappingURL=engine-types.d.ts.map

package/dist/xlsx/formula/engine-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-types.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/engine-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IAC1B,0DAA0D;IAC1D,cAAc,IAAI,IAAI,CAAC;IACvB,0FAA0F;IAC1F,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAC/C,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,GAAG,SAAS,CAAC;IACvD,iGAAiG;IACjG,UAAU,IAAI,IAAI,CAAC;IACnB,uFAAuF;IACvF,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,GAAG,SAAS,EAAE,EAAE,CAAC;IAChE,kDAAkD;IAClD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3E,gFAAgF;IAChF,aAAa,IAAI,YAAY,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IACjC,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,0BAA0B,0EACiC,CAAC"}

package/dist/xlsx/formula/engine-util.d.ts

@@ -0,0 +1,10 @@
+import type { CellRange } from '../address.js';
+import type { EvalHost } from './context.js';
+import { Matrix, type Scalar, type Value } from './values.js';
+/** The value a formula cell shows: one value, or an array to spill. Blanks become 0. */
+export declare function finalize(value: Value, host: EvalHost): Scalar | Matrix;
+export declare function clean(value: Scalar): Scalar;
+export declare const rangeHas: (range: CellRange, row: number, col: number) => boolean;
+export declare function sameRange(a: CellRange | undefined, b: CellRange | undefined): boolean;
+export declare function boundingBox(ranges: CellRange[]): CellRange;
+//# sourceMappingURL=engine-util.d.ts.map

package/dist/xlsx/formula/engine-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-util.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/engine-util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAIN,MAAM,EAEN,KAAK,MAAM,EACX,KAAK,KAAK,EACV,MAAM,aAAa,CAAC;AAErB,wFAAwF;AACxF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAetE;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO3C;AAED,eAAO,MAAM,QAAQ,GAAI,OAAO,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,OAC2B,CAAC;AAElG,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAQrF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,CAW1D"}

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

@@ -0,0 +1,6 @@
+import type { Workbook } from '../model.js';
+import type { CalcEngine, CalcEngineOptions } from './engine-types.js';
+export { type CalcEngine, type CalcEngineOptions, CIRCULAR_REFERENCE_WARNING, type CellPosition, } from './engine-types.js';
+/** Creates a calculation engine bound to a workbook. */
+export declare function createCalcEngine(workbook: Workbook, options?: CalcEngineOptions): CalcEngine;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/engine.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmB,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI7D,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAgB,MAAM,mBAAmB,CAAC;AAQrF,OAAO,EACN,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,0BAA0B,EAC1B,KAAK,YAAY,GACjB,MAAM,mBAAmB,CAAC;AA8H3B,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAEhG"}

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

@@ -0,0 +1,17 @@
+import type { DefinedName } from '../model.js';
+import { type FormulaAst } from './ast.js';
+import type { EvalHost, Frame } from './context.js';
+import { Matrix, type Scalar, type Scope, type Value } from './values.js';
+/** Evaluates `node`; references stay references (the caller decides how to read them). */
+export declare function evaluateNode(node: FormulaAst, frame: Frame): Value;
+/** Dereferences an operand: one cell becomes its value, larger ranges a matrix. */
+export declare function operand(value: Value, frame: Frame): Scalar | Matrix;
+/** The defined name visible from `sheet` (a sheet-local name wins over a global one). */
+export declare function findDefinedName(host: EvalHost, name: string, sheet: number, explicitSheet: boolean): DefinedName | undefined;
+/** Evaluates a defined name's formula, or `undefined` when there is no such name. */
+export declare function evaluateDefinedName(name: string, sheet: number, explicitSheet: boolean, frame: Frame): Value | undefined;
+/** Calls a LAMBDA closure with already evaluated arguments. */
+export declare function invokeLambda(callee: Value, args: Value[], frame: Frame): Value;
+/** Extends a scope with one variable. */
+export declare function extendScope(scope: Scope | undefined, name: string, value: Value): Scope;
+//# sourceMappingURL=evaluator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../../src/xlsx/formula/evaluator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAgB,KAAK,UAAU,EAAsB,MAAM,UAAU,CAAC;AAE7E,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAYpD,OAAO,EAMN,MAAM,EAEN,KAAK,MAAM,EACX,KAAK,KAAK,EACV,KAAK,KAAK,EACV,MAAM,aAAa,CAAC;AAIrB,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CA0ClE;AAED,mFAAmF;AACnF,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAkBnE;AAmBD,yFAAyF;AACzF,wBAAgB,eAAe,CAC9B,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,OAAO,GACpB,WAAW,GAAG,SAAS,CASzB;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,OAAO,EACtB,KAAK,EAAE,KAAK,GACV,KAAK,GAAG,SAAS,CAOnB;AAqBD,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAO9E;AAED,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAIvF"}

package/dist/xlsx/formula/functions/array-shape.d.ts

@@ -0,0 +1,3 @@
+import type { FunctionSpec } from './types.js';
+export declare const ARRAY_SHAPE_FUNCTIONS: FunctionSpec[];
+//# sourceMappingURL=array-shape.d.ts.map

package/dist/xlsx/formula/functions/array-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-shape.d.ts","sourceRoot":"","sources":["../../../../src/xlsx/formula/functions/array-shape.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA+F/C,eAAO,MAAM,qBAAqB,EAAE,YAAY,EAqI/C,CAAC"}

package/dist/xlsx/formula/functions/array.d.ts

@@ -0,0 +1,6 @@
+import { type Scalar } from '../values.js';
+import type { FunctionSpec } from './types.js';
+/** Sort order for SORT/SORTBY: numbers, text, logicals, errors; blanks always last. */
+export declare function sortCompare(a: Scalar, b: Scalar, descending: boolean): number;
+export declare const ARRAY_FUNCTIONS: FunctionSpec[];
+//# sourceMappingURL=array.d.ts.map

package/dist/xlsx/formula/functions/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../../src/xlsx/formula/functions/array.ts"],"names":[],"mappings":"AAEA,OAAO,EAA8B,KAAK,MAAM,EAAc,MAAM,cAAc,CAAC;AAGnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAQ7E;AAoHD,eAAO,MAAM,eAAe,EAAE,YAAY,EA+FzC,CAAC"}

package/dist/xlsx/formula/functions/criteria.d.ts

@@ -0,0 +1,22 @@
+import type { CallContext } from '../context.js';
+import { Matrix, type Scalar, type Value } from '../values.js';
+/**
+ * Reads several range arguments with one shape. With `sameShape`, every argument must have the
+ * first one's size (the IFS functions); otherwise later ranges are resized from their top-left
+ * cell (SUMIF's sum_range). Whole-column references are clipped to the used rows.
+ */
+export declare function shapedMatrices(ctx: CallContext, values: Value[], sameShape: boolean): Matrix[];
+/**
+ * For `(range, criteria)` pairs, the values of `target` (or of the first range) at positions
+ * where every criterion holds.
+ */
+export declare function matchingValues(ctx: CallContext, pairs: {
+    range: Value;
+    criteria: Value;
+}[], target: Value | undefined, sameShape: boolean): Scalar[];
+/** Splits trailing `(range, criteria)` argument pairs. */
+export declare function criteriaPairs(args: Value[], from: number): {
+    range: Value;
+    criteria: Value;
+}[];
+//# sourceMappingURL=criteria.d.ts.map

package/dist/xlsx/formula/functions/criteria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria.d.ts","sourceRoot":"","sources":["../../../../src/xlsx/formula/functions/criteria.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAa,MAAM,EAAY,KAAK,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAKpF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,EAAE,CA8C9F;AAeD;;;GAGG;AACH,wBAAgB,cAAc,CAC7B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAA;CAAE,EAAE,EAC1C,MAAM,EAAE,KAAK,GAAG,SAAS,EACzB,SAAS,EAAE,OAAO,GAChB,MAAM,EAAE,CAqBV;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAA;CAAE,EAAE,CAO9F"}

package/dist/xlsx/formula/functions/date-calc.d.ts

@@ -0,0 +1,14 @@
+import type { CallContext } from '../context.js';
+import { type Value } from '../values.js';
+/** A date serial argument: numbers and date text, truncated; negative or too large is #NUM!. */
+export declare function serialArg(value: Value | undefined): number;
+export declare function dateSerial(year: number, month: number, day: number, ctx: CallContext): number;
+export declare function addMonths(serial: number, months: number, ctx: CallContext, endOfMonth: boolean): number;
+/** WEEKDAY's numbering: returns 1-based (or 0-based for type 3) day number. */
+export declare function weekday(serial: number, type: number, ctx: CallContext): number;
+export declare function isoWeek(serial: number, ctx: CallContext): number;
+export declare function weekNum(serial: number, type: number, ctx: CallContext): number;
+export declare function datedif(start: number, end: number, unit: string, ctx: CallContext): number;
+export declare function days360(start: number, end: number, european: boolean, ctx: CallContext): number;
+export declare function yearFrac(s: number, e: number, basis: number, ctx: CallContext): number;
+//# sourceMappingURL=date-calc.d.ts.map

package/dist/xlsx/formula/functions/date-calc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-calc.d.ts","sourceRoot":"","sources":["../../../../src/xlsx/formula/functions/date-calc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAa,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAKrD,gGAAgG;AAChG,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAI1D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAM7F;AAED,wBAAgB,SAAS,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE,OAAO,GACjB,MAAM,CAQR;AAED,+EAA+E;AAC/E,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAiB9E;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAOhE;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAmB9E;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAmC1F;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAgB/F;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAgCtF"}

package/dist/xlsx/formula/functions/datetime.d.ts

@@ -0,0 +1,3 @@
+import type { FunctionSpec } from './types.js';
+export declare const DATETIME_FUNCTIONS: FunctionSpec[];
+//# sourceMappingURL=datetime.d.ts.map

package/dist/xlsx/formula/functions/datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../../../../src/xlsx/formula/functions/datetime.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAe/C,eAAO,MAAM,kBAAkB,EAAE,YAAY,EA6M5C,CAAC"}

package/dist/xlsx/formula/functions/depreciation.d.ts

@@ -0,0 +1,4 @@
+import type { FunctionSpec } from './types.js';
+/** Depreciation, rate conversion and price-format functions. */
+export declare const DEPRECIATION_FUNCTIONS: FunctionSpec[];
+//# sourceMappingURL=depreciation.d.ts.map

package/dist/xlsx/formula/functions/depreciation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"depreciation.d.ts","sourceRoot":"","sources":["../../../../src/xlsx/formula/functions/depreciation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,EAAE,YAAY,EAmLhD,CAAC"}

package/dist/xlsx/formula/functions/dist-core.d.ts

@@ -0,0 +1,22 @@
+/** Regularized lower incomplete gamma P(a, x). */
+export declare function gammaP(a: number, x: number): number;
+export declare function betaCf(a: number, b: number, x: number): number;
+/** Regularized incomplete beta I_x(a, b). */
+export declare function betaI(x: number, a: number, b: number): number;
+export declare const erf: (x: number) => number;
+export declare const normCdf: (z: number) => number;
+export declare const normPdf: (z: number) => number;
+/** Inverse standard normal CDF (Acklam's approximation refined by one Halley step). */
+export declare function normInv(p: number): number;
+/** Inverts a monotonic increasing CDF on (lo, hi) by bisection. */
+export declare function invert(cdf: (x: number) => number, p: number, lo: number, hi: number): number;
+export declare const tCdf: (t: number, df: number) => number;
+export declare const tPdf: (t: number, df: number) => number;
+export declare const chiCdf: (x: number, df: number) => number;
+export declare const positive: (...values: (number | undefined)[]) => void;
+export declare const probability: (p: number) => void;
+export declare function binomPmf(k: number, n: number, p: number): number;
+export declare function binomDist(k: number, n: number, p: number, cumulative: number): number;
+export declare function poisson(k: number, mean: number, cumulative: number): number;
+export declare const normDist: (x: number, m: number, s: number, cumulative: number) => number;
+//# sourceMappingURL=dist-core.d.ts.map

package/dist/xlsx/formula/functions/dist-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dist-core.d.ts","sourceRoot":"","sources":["../../../../src/xlsx/formula/functions/dist-core.ts"],"names":[],"mappings":"AAOA,kDAAkD;AAClD,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAgCnD;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA6B9D;AAED,6CAA6C;AAC7C,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,KAAG,MAA4D,CAAC;AAC7F,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,KAAG,MAAyC,CAAC;AAC9E,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,KAAG,MAAyD,CAAC;AAE9F,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CA2CzC;AAED,mEAAmE;AACnE,wBAAgB,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAW5F;AAED,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,EAAE,IAAI,MAAM,KAAG,MAI5C,CAAC;AACF,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,EAAE,IAAI,MAAM,KAAG,MAM3C,CAAC;AACH,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,EAAE,IAAI,MAAM,KAAG,MAA+B,CAAC;AAE/E,eAAO,MAAM,QAAQ,GAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,KAAG,IAE5D,CAAC;AACF,eAAO,MAAM,WAAW,GAAI,GAAG,MAAM,KAAG,IAEvC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAQrF;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK3E;AAED,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,YAAY,MAAM,KAAG,MAI9E,CAAC"}

package/dist/xlsx/formula/functions/distributions-more.d.ts

@@ -0,0 +1,4 @@
+import type { FunctionSpec } from './types.js';
+/** Student's t, chi-squared, beta and discrete distributions. */
+export declare const DISTRIBUTION_MORE: FunctionSpec[];
+//# sourceMappingURL=distributions-more.d.ts.map

package/dist/xlsx/formula/functions/distributions-more.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distributions-more.d.ts","sourceRoot":"","sources":["../../../../src/xlsx/formula/functions/distributions-more.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,EAAE,YAAY,EAkM3C,CAAC"}

package/dist/xlsx/formula/functions/distributions.d.ts

@@ -0,0 +1,3 @@
+import type { FunctionSpec } from './types.js';
+export declare const DISTRIBUTION_FUNCTIONS: FunctionSpec[];
+//# sourceMappingURL=distributions.d.ts.map

package/dist/xlsx/formula/functions/distributions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distributions.d.ts","sourceRoot":"","sources":["../../../../src/xlsx/formula/functions/distributions.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,eAAO,MAAM,sBAAsB,EAAE,YAAY,EAiPhD,CAAC"}

package/dist/xlsx/formula/functions/engineering.d.ts

@@ -0,0 +1,3 @@
+import type { FunctionSpec } from './types.js';
+export declare const ENGINEERING_FUNCTIONS: FunctionSpec[];
+//# sourceMappingURL=engineering.d.ts.map

package/dist/xlsx/formula/functions/engineering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineering.d.ts","sourceRoot":"","sources":["../../../../src/xlsx/formula/functions/engineering.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAqF/C,eAAO,MAAM,qBAAqB,EAAE,YAAY,EAoH/C,CAAC"}