@sheetxl/sdk 0.7.21 → 0.7.23-beta.2

package/types/src/calculation/NamedFormulaCollection.d.ts.map

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

package/types/src/calculation/TokenType.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Valid FormulaToken types.
+ */
+export declare const TokenType: {
+    /**
+     * The formula could not be tokenized at all. `value` holds the raw expression text. Signals to the
+     * UI that no token stream is available; distinct from `Error` which is a recognized Excel error value.
+     */
+    readonly Unparsed: "unparsed";
+    /**
+     * A parenthesized sub-expression, e.g. `(A1+B1)`.
+     */
+    readonly Paren: "paren";
+    /**
+     * A binary operator between two operands,
+     * e.g. `+`, `*`, `:`, `&`.
+     */
+    readonly Infix: "infix";
+    /**
+     * A unary operator before its operand,
+     * e.g. `-` (negation) or `@` (implicit intersection).
+     */
+    readonly Prefix: "prefix";
+    /**
+     * A unary operator after its operand,
+     * e.g. `%` (percent) or `#` (spill-range anchor).
+     */
+    readonly Postfix: "postfix";
+    /**
+     * A function call, e.g. `SUM(...)`. `value` is the function name.
+     */
+    readonly Function: "function";
+    /**
+     * Function application where the callee is an EXPRESSION rather than a name — an immediately
+     * invoked lambda, `LAMBDA(a,b,a+b)(1,2)`.
+     *
+     * `inputs[0]` is the callee; `inputs[1..]` are the arguments. `value` is `null` — unlike
+     * {@link Function} there is no name to carry.
+     *
+     * A `(` binds as a call ONLY when it touches the callee's last token: `LAMBDA(x,x+1) (3)` with a
+     * space is an implicit intersection, and Excel refuses it. See DESIGN-FORMULA-APPLICATION.md.
+     */
+    readonly Call: "call";
+    /**
+     * An error literal, e.g. `#DIV/0!` or `#REF!`.
+     */
+    readonly Error: "error";
+    /**
+     * A number literal, e.g. `3.14` or `2e10`.
+     */
+    readonly Number: "number";
+    /**
+     * The boolean literals `TRUE` and `FALSE`.
+     */
+    readonly Boolean: "boolean";
+    /**
+     * A double-quoted Excel string literal, e.g. `"hello"`.
+     */
+    readonly String: "string";
+    /**
+     * Separator token used between function arguments or array columns.
+     */
+    readonly Separator: "separator";
+    /**
+     * Root-level comma-separated list (e.g. named formula 'A1,A2')
+     */
+    readonly List: "list";
+    /**
+     * The `{` or `}` delimiter of a literal array.
+     */
+    readonly Type: "type";
+    /**
+     * A literal array constant, e.g. `{1,2;3,4}`.
+     */
+    readonly Array: "array";
+    /**
+     * One row inside a literal array, e.g. `{1,2;3,4}` has two rows.
+     */
+    readonly Row: "row";
+    /**
+     * A cell or range reference, e.g. `A1`, `$B$2`, `A1:B3`,
+     * or a cross-sheet reference.
+     */
+    readonly Cell: "cell";
+    /**
+     * A named formula reference, e.g. `TotalRevenue`.
+     */
+    readonly Named: "named";
+    /**
+     * Tokens related to structured reference parsing. (e.g. Table[])
+     *
+     */
+    readonly TableReference: "tableReference";
+    /**
+     * Tokens related to Table Specifiers. (e.g. #All, #Data, #Headers, #Totals, #This Row)
+     */
+    readonly TableSpecifier: "tableSpecifier";
+    /**
+     * Tokens related to column specifiers in structured references. (e.g. [Column1], Column1)
+     */
+    readonly TableColumn: "tableColumn";
+    /**
+     * External references. For example: [Book.xlsx]Sheet1!A1
+     */
+    readonly ExternalReference: "externalReference";
+    /**
+     * An omitted function argument, e.g. the middle argument of `=IF(A1,,0)`.
+     * Evaluates to `undefined`.
+     */
+    readonly Empty: "empty";
+    /**
+     * Whitespace.
+     */
+    readonly Whitespace: "whitespace";
+};
+export type TokenType = typeof TokenType[keyof typeof TokenType];
+//# sourceMappingURL=TokenType.d.ts.map

package/types/src/calculation/TokenType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenType.d.ts","sourceRoot":"","sources":["../../../../src/calculation/TokenType.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB;;;OAGG;;IAEH;;OAEG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;OAEG;;IAEH;;;;;;;;;OASG;;IAGH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAGH;;OAEG;;IAEH;;OAEG;;IAGH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAGH;;;OAGG;;IAEH;;OAEG;;IAEH;;;OAGG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAGH;;;OAGG;;IAEH;;OAEG;;CAEK,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC"}

package/types/src/calculation/Types.d.ts

@@ -0,0 +1,110 @@
+import { IRange, FormulaError } from '@sheetxl/primitives';
+/**
+ * A named formula reference — the `value` of a Named AST node. INTERNAL: stable ids are a
+ * calculation-private notion, so this type stays inside the package.
+ *
+ * @remarks
+ * `nameId` is the stable UUID after `linkSymbols` resolves the display name (or the display name
+ * itself when no registry is available, e.g. unit tests). `scope` is the sheet stableId of an
+ * explicit qualifier (`Sheet2!Total`) after linking — it stays the raw sheet NAME only when the
+ * sheet is unknown or no registry was used, so a rename re-images the qualifier rather than leaving
+ * dead text. Serializers must emit it (`sheetNameToString(scope) + '!'`) or the qualifier is
+ * silently stripped on re-imaging (the erroring `=Sheet1!1+1` that once round-tripped into a clean
+ * `=1+1`).
+ *
+ * The public counterpart is {@link ICalculation.NamedRef}, the `value` of a `named`
+ * {@link ICalculation.FormulaToken} — same split (name + sheet scope), but `name` is a display name,
+ * not an id. `generateFormulaTokens` projects this onto that, and `resolveTokenSymbols` swaps the id
+ * for the display name before any token reaches a consumer.
+ */
+export interface NamedReference {
+    /** Stable ID of the named formula, or display name before symbol linking. */
+    readonly nameId: string;
+    /** Sheet stableId of an explicit qualifier (a raw sheet name when unlinked/unknown). */
+    readonly scope?: string | null;
+    /**
+     * An optional LAMBDA parameter declaration arriving through a transform (`_xlop.b` on xlsx
+     * read) — a PRE-BIND marker only: `bindScopes` claims it into `binding.optional` at a LAMBDA
+     * declaration position, and it means nothing anywhere else. The typed spelling (`[b]`) never
+     * carries it — that parses as a bracketed shape the binder recognizes directly.
+     */
+    readonly optional?: boolean;
+}
+/**
+ * Pre-computed structured reference (table) query.
+ *
+ * @remarks
+ * All column/table identifiers are stable IDs produced by `linkSymbols`, so the query
+ * is valid even after formula rewriting.
+ */
+export interface StructuredReference {
+    /**
+     * Stable ID of the referenced table.
+     *
+     * @remarks
+     * Empty string for implicit self-references such as `[@Col]` or `[#All]`
+     * (no table name prefix in the formula).
+     */
+    tableId: string;
+    /**
+     * Section specifier for the table reference.
+     *
+     * | Value | Meaning |
+     * |-------|---------|
+     * | 0 | Data rows (default when no specifier) |
+     * | 1 | All rows (`#All`) |
+     * | 2 | Header row only (`#Headers`) |
+     * | 3 | Totals row only (`#Totals`) |
+     * | 4 | Headers + Data (`#Headers, #Data`) |
+     * | 5 | Totals + Data (`#Totals, #Data`) |
+     */
+    spec: number;
+    /**
+     * Stable ID of the first (or only) referenced column.
+     * `null` when the whole table section is referenced (no column selector).
+     */
+    columnFromId: string | null;
+    /**
+     * Stable ID of the last column in a column-range reference (e.g. `[Col1]:[Col3]`).
+     * `null` when not a column range.
+     */
+    columnToId: string | null;
+    /**
+     * `true` when the `@` (this-row / implicit intersection) qualifier was present, e.g. `[@Col]`.
+     */
+    isThisRow: boolean;
+    /** The scope id. */
+    scopeId?: string;
+}
+/**
+ * Union of all ReferenceCoord types.
+ *
+ * - `IRange.FixableCoords` — a range reference (or a degenerate 1×1 range: `colStart===colEnd`, which
+ *   PRESERVES the existing shape — a single-cell *range* `A1:A1` stays a range).
+ * - `IRange.FixableCellCoords` — a single *cell* reference (`colIndex`/`rowIndex`). Passing this REPLACES
+ *   the reference's shape: an existing range collapses to a lone cell (`A1:B2` → `A1`). This is how a
+ *   caller says "I mean a cell" without a side-channel flag — the type carries the intent.
+ * - `NamedReference` — a named formula reference (distinguish via `'nameId' in ref`)
+ * - `FormulaError.Ref` — a broken reference (`#REF!`)
+ * - `null` — no reference at this slot
+ */
+export type ReferenceCoords = IRange.FixableCoords | IRange.FixableCellCoords | NamedReference | FormulaError.Ref | null;
+/**
+ * Options for `IFormulaBlock.setReferenceAt`.
+ */
+export interface SetReferenceOptions {
+    /**
+     * The reference's own SHEET is what died, not just the cells it named — so the `#REF!` left
+     * behind is written BARE rather than qualified.
+     *
+     * @remarks
+     * Measured in Excel: a row/area delete leaves the qualified form (`Data!#REF!`), which is the
+     * breadcrumb naming whose cells went; deleting the sheet itself leaves a bare `#REF!`, since
+     * there is no longer a sheet to name. Only the caller knows which of the two it is performing —
+     * `CalcGrid.delete` is walking the precedents OF the grid it is about to drop, while every
+     * shift path is deleting rows within a sheet that survives. It cannot be inferred here: the
+     * sheet is still registered when this rewrite runs, so resolving the qualifier still succeeds.
+     */
+    scopeDeleted?: boolean;
+}
+//# sourceMappingURL=Types.d.ts.map

package/types/src/calculation/Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../../../src/calculation/Types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAErE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,iBAAiB,GAAG,cAAc,GAAG,YAAY,CAAC,GAAG,GAAG,IAAI,CAAC;AAEzH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/types/src/calculation/_CalculationMessages.d.ts

@@ -0,0 +1,3 @@
+export declare const ERROR_NOT_STARTED = "The calculation engine is not started. Call start() first.";
+export declare const ERROR_INITIALIZING = "The calculation engine is initializing. Please wait until it is ready.";
+//# sourceMappingURL=_CalculationMessages.d.ts.map

package/types/src/calculation/_CalculationMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_CalculationMessages.d.ts","sourceRoot":"","sources":["../../../../src/calculation/_CalculationMessages.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,iBAAiB,+DAA+D,CAAC;AAE9F,eAAO,MAAM,kBAAkB,2EAA2E,CAAC"}

package/types/src/calculation/builtInNames.d.ts

@@ -0,0 +1,2 @@
+export declare function getBuiltInFunctionNames(): Promise<readonly string[]>;
+//# sourceMappingURL=builtInNames.d.ts.map

package/types/src/calculation/builtInNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtInNames.d.ts","sourceRoot":"","sources":["../../../../src/calculation/builtInNames.ts"],"names":[],"mappings":"AAkBA,wBAAgB,uBAAuB,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAapE"}

package/types/src/calculation/compiler/ASTTypes.d.ts

@@ -0,0 +1,180 @@
+import { IRange, IFunction } from '@sheetxl/primitives';
+import { NamedReference } from '../Types';
+import { TokenType } from '../TokenType';
+/**
+ * Represents a node in the Abstract Syntax Tree (AST) of a formula.
+ */
+export interface ASTNode<T extends TokenType = TokenType, V = any> {
+    /**
+     * The type of AST node.
+     */
+    type: T;
+    /**
+     * Identifies the value at the AST node.
+     * (e.g. range, function name, operator, literal value, etc.)
+     */
+    value?: V;
+    /**
+     * A list of inputs (or child nodes) that contribute to the expression.
+     *
+     * @remarks
+     * Leaf nodes are built with an explicit `null` (serialization-stable); `undefined` also occurs.
+     */
+    inputs?: ASTNode[] | null;
+    /**
+     * The pre-resolve function
+     */
+    fn?: Function;
+    /**
+     * Any white space before the node.
+     */
+    wsBefore?: string;
+    /**
+     * Any white space after the node.
+     *
+     * @remarks
+     * This will only be populated for the root node.
+     */
+    wsAfter?: string;
+    /**
+     * Indicates the ids for evaluating this node.
+     * This is used incremental execution (tooltip)
+     *
+     * @see {@link ICalculation.FormulaToken.evalIndex}
+     */
+    evalIndex?: number;
+    /**
+     * For live editing. We may need to add original start/end offsets to align?
+     *
+     * @remarks
+     * If an image does not exist then should be created from the value. For example a cell reference that
+     * has been updated will not have an image.
+     */
+    image?: string;
+    /**
+     * If the node is a reference.
+     */
+    isReference?: boolean;
+    /**
+     * Indicates the index of the references from getReferences()
+     *
+     * @remarks
+     * * Multiple nodes may have the same reference index as these.
+     * * Used to color code references in the editor.
+     */
+    referenceIndex?: number;
+    /**
+     * If the node is a literal.
+     */
+    isLiteral?: boolean;
+    /**
+     * Set by the binder pass on a `named` node that participates in a `LET`/`LAMBDA` scope — the
+     * declaration itself, or a use its scope covers.
+     *
+     * @remarks
+     * A bound node is NOT a name: it mints no symbol, contributes no named-formula edge, is not a
+     * reference, and reads its value from its binding's register slot rather than from the name
+     * resolver. See `CompilerUtils.bindScopes`.
+     */
+    binding?: BindingRef;
+    /**
+     * Set by the binder pass on the `LET`/`LAMBDA` function node that OPENS a scope.
+     *
+     * @remarks
+     * Its presence is what makes the call an engine form rather than a call to the declaration
+     * carriers exported from `formulas` — see `FormulaBlock.evaluateAt`.
+     */
+    binder?: BinderScope;
+    /**
+     * Set by the binder pass on a BOUND use that is the direct argument of `ISOMITTED` — the one
+     * read site allowed to see the OMITTED sentinel raw (design §3.5). Every other frame read
+     * converts the sentinel to blank.
+     */
+    rawFrameRead?: boolean;
+    /**
+     * Set by the compiler on a `named` node INSIDE a `LAMBDA` body: resolved at apply time, not in
+     * the eager reference pass.
+     *
+     * @remarks
+     * Deferral is what permits recursion — a self-recursive named lambda's inner self-reference,
+     * resolved eagerly, would trip the `activeNames` cycle guard while the outer resolution is
+     * still on the stack. The node keeps its precedent slot (over-approximated precedents are the
+     * accepted cost — design §3.4); only the eager VALUE resolution is skipped.
+     */
+    deferredResolve?: boolean;
+    /**
+     * If ast had an error.
+     *
+     * @remarks
+     * This is different than a valid parsed error.
+     */
+    error?: boolean;
+}
+/**
+ * The binder-pass annotation on a `named` node inside a `LET`/`LAMBDA` scope.
+ */
+export interface BindingRef {
+    /**
+     * The binding's slot — an index into `CompiledFormula.bindings`, unique within one formula.
+     */
+    slot: number;
+    /**
+     * `true` on the DECLARATION position (`x` in `LET(x,1,x+1)`), absent on a use.
+     *
+     * @remarks
+     * A declaration is a binding position, not an expression: it evaluates to nothing and is never
+     * executed.
+     */
+    declaration?: boolean;
+    /**
+     * `true` on an OPTIONAL declaration — `[b]` in `LAMBDA(a,[b],a+1)` (application §2.6).
+     *
+     * @remarks
+     * Declarations only, LAMBDA only (optionals are trailing-only and LET refuses the brackets —
+     * {@link CompilerUtils.findBinderViolation | findBinderViolation} enforces both). Apply reads it
+     * through `LambdaParam.optional`: an absent or explicitly-skipped argument binds the OMITTED
+     * sentinel instead of being `#VALUE!`.
+     */
+    optional?: boolean;
+}
+/**
+ * The binder-pass annotation on a `LET`/`LAMBDA` function node.
+ */
+export interface BinderScope {
+    /** Which form opened the scope. */
+    kind: 'let' | 'lambda';
+    /** The slots this call declares, in declaration order. */
+    slots: readonly number[];
+}
+/**
+ * AST callback
+ */
+export interface ASTVisitor {
+    /**
+     * Called once for every node (depth-first).
+     *
+     * @remarks
+     * If a non-void value is returned the node will be replaced with it.
+     * Returning `undefined` leaves the node intact.
+     */
+    (node: ASTNode, parent: ASTNode | undefined, path: ASTNode[]): ASTNode | void;
+}
+export type CellNode = ASTNode<typeof TokenType.Cell, IRange.FixableCellCoords>;
+export interface NamedNode extends ASTNode<typeof TokenType.Named, NamedReference> {
+}
+export interface FunctionNode extends ASTNode<typeof TokenType.Function, any> {
+    /**
+     * Re use this as a cache for built-in static functions.
+     *
+     */
+    cacheFn?: IFunction;
+}
+export type ParenNode = ASTNode<typeof TokenType.Paren>;
+/**
+ * The result of parsing a formula. Contains the root of the AST and any parse errors.
+ */
+export interface ParseResult {
+    root: ASTNode;
+    errors: any[];
+}
+//# sourceMappingURL=ASTTypes.d.ts.map

package/types/src/calculation/compiler/ASTTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ASTTypes.d.ts","sourceRoot":"","sources":["../../../../../src/calculation/compiler/ASTTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGlE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,CAAC,GAAG,GAAG;IAC/D;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IACR;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,CAAC;IACV;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC1B;;OAEG;IAEH,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IACvB,0DAA0D;IAC1D,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC;CAC/E;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEhF,MAAM,WAAW,SAAU,SAAQ,OAAO,CAAC,OAAO,SAAS,CAAC,KAAK,EAAE,cAAc,CAAC;CAAG;AAGrF,MAAM,WAAW,YAAa,SAAQ,OAAO,CAAC,OAAO,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC;IAE3E;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CAErB;AAGD,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,GAAG,EAAE,CAAC;CACf"}

package/types/src/calculation/compiler/CompilerLocale.d.ts

@@ -0,0 +1,69 @@
+import { FormulaError } from '@sheetxl/primitives';
+import { LanguageTag } from '@sheetxl/utils';
+import { SRSpecifiers } from '../../i18n/LanguagePack';
+import { FormulaSeparators, CANONICAL_SEPARATORS } from './FormulaSeparators';
+export { type FormulaSeparators, CANONICAL_SEPARATORS };
+export { type SRSpecifiers };
+/**
+ * The single locale contract shared by every stage of the formula compiler — the lexer (which builds
+ * its token regexes from the raw word-lists), the parser actions (which map typed text → canonical
+ * AST values), and the emit path (which re-images canonical AST → display text).
+ *
+ * It supersedes the three ad-hoc shapes that said the same thing differently: the lexer's old
+ * `FormulaLexerOptions` string fields, the parser's loose `_booleanTrue`/`_separatorDecimal` plus its
+ * `parseErrorLocal` module global, and `TokenUtils.EmitLocale`. One object is now threaded everywhere.
+ *
+ * Two faces, deliberately:
+ *   • **raw data** (`separators`, `booleanTrue`/`booleanFalse`, `errorLiterals`/`errorRefs`,
+ *     `specifiers`) — consumed by the LEXER, which needs literal strings to compile regex alternates
+ *     (a callback can't build a regex); and
+ *   • **callbacks** (`parseBoolean`/`parseError`/…, `localizeBoolean`/`localizeError`/…) — consumed by
+ *     the PARSER (text → canonical) and the EMIT path (canonical → text).
+ *
+ * Storage stays canonical: every `parse*` ALWAYS accepts the canonical English spelling in addition to
+ * the localized one, and `localize*` for {@link CANONICAL_LOCALE} is the identity (English) form.
+ */
+export interface CompilerLocale {
+    /** The four formula separators (function/column/row/decimal). */
+    separators: FormulaSeparators;
+    /** The `TRUE` literal in this locale (canonical `TRUE` is always lexed too). */
+    booleanTrue: string;
+    /** The `FALSE` literal in this locale (canonical `FALSE` is always lexed too). */
+    booleanFalse: string;
+    /** Localized LITERAL error labels (`#WERT!`, …) to ADD alongside the always-lexed canonical set. */
+    errorLiterals: string[];
+    /** Localized REFERENCE error labels (`#BEZUG!`) — parse where a reference is expected. */
+    errorRefs: string[];
+    /** Localized SR specifier words; absent for a locale that does not translate them. */
+    specifiers?: SRSpecifiers;
+    /** `WAHR`/`TRUE` → `true`, `FALSCH`/`FALSE` → `false`, anything else → `undefined`. */
+    parseBoolean(image: string): boolean | undefined;
+    /** A typed error label (canonical or localized) → its canonical {@link FormulaError}, else `undefined`. */
+    parseError(image: string): FormulaError.Known | undefined;
+    /** A typed SR specifier (`[#Alle]`/`#Alle`/`All`) → its canonical key (`All`), else `undefined`. */
+    parseSpecifier?(image: string): string | undefined;
+    /** `true`/`false` → the locale's `WAHR`/`FALSCH`. */
+    localizeBoolean(value: boolean): string;
+    /** A canonical error → its localized label (`#WERT!`); canonical returns the English label. */
+    localizeError(error: FormulaError.Known): string;
+    /** A canonical SR specifier key (`All`) → its localized word (`Alle`); canonical returns English. */
+    localizeSpecifier?(canonical: string): string;
+}
+/**
+ * The canonical (storage / identity) locale: canonical separators, English `TRUE`/`FALSE`, no localized
+ * error or specifier alternates, and every `parse*`/`localize*` is the English identity. This is the
+ * default for the calc path and for any storage/API text, which is always canonical.
+ */
+export declare const CANONICAL_LOCALE: CompilerLocale;
+/**
+ * Build the {@link CompilerLocale} for a set of `separators` (Plane 1, from the workbook locale) and
+ * the active-or-`tag` spreadsheet-language pack (Plane 3). The pack is read ONCE here; the raw fields
+ * feed the lexer and the callbacks delegate to the tag-bound {@link LanguagePack} helpers, so this is
+ * the one place that knows how a pack maps onto the compiler. Both the editing compiler (parse) and
+ * the display emit path call it.
+ *
+ * @param separators The resolved formula separators. Defaults to canonical.
+ * @param tag The language tag, or `undefined` for the active language.
+ */
+export declare function createCompilerLocale(separators?: FormulaSeparators, tag?: LanguageTag): CompilerLocale;
+//# sourceMappingURL=CompilerLocale.d.ts.map

package/types/src/calculation/compiler/CompilerLocale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompilerLocale.d.ts","sourceRoot":"","sources":["../../../../../src/calculation/compiler/CompilerLocale.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EACL,KAAK,YAAY,EAElB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,KAAK,iBAAiB,EAAE,oBAAoB,EAC7C,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,KAAK,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;AACxD,OAAO,EAAE,KAAK,YAAY,EAAE,CAAC;AAoC7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,cAAc;IAE7B,iEAAiE;IACjE,UAAU,EAAE,iBAAiB,CAAC;IAC9B,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,oGAAoG;IACpG,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,0FAA0F;IAC1F,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,sFAAsF;IACtF,UAAU,CAAC,EAAE,YAAY,CAAC;IAG1B,uFAAuF;IACvF,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACjD,2GAA2G;IAC3G,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,KAAK,GAAG,SAAS,CAAC;IAC1D,oGAAoG;IACpG,cAAc,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAGnD,qDAAqD;IACrD,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxC,+FAA+F;IAC/F,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,GAAG,MAAM,CAAC;IACjD,qGAAqG;IACrG,iBAAiB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/C;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAiB9B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,GAAE,iBAAwC,EACpD,GAAG,CAAC,EAAE,WAAW,GAChB,cAAc,CAgChB"}