@veltra/sheet 2.0.1 → 2.1.1

package/dist/core/formula/functions.js

@@ -1,209 +0,0 @@
-import { formulaError, isFormulaError } from "./errors.js";
-import { coerceToBoolean, coerceToNumber, coerceToText } from "./evaluator.js";
-//#region src/core/formula/functions.ts
-const registry = /* @__PURE__ */ new Map();
-/** 注册函数（名称大小写不敏感；同名覆盖，供扩展/自定义函数） */
-function registerFormulaFunction(name, def) {
-	registry.set(name.toUpperCase(), def);
-}
-/** 查询函数（大小写不敏感） */
-function getFormulaFunction(name) {
-	return registry.get(name.toUpperCase());
-}
-/** 求值器回调：名称解析 + 参数个数校验 + 按 kind 分发 */
-function invokeFormulaFunction(name, nodes, evalNode) {
-	const def = getFormulaFunction(name);
-	if (!def) return formulaError("#NAME?");
-	if (def.minArgs !== void 0 && nodes.length < def.minArgs) return formulaError("#VALUE!");
-	if (def.maxArgs !== void 0 && nodes.length > def.maxArgs) return formulaError("#VALUE!");
-	if (def.kind === "lazy") return def.impl(nodes, evalNode);
-	return def.impl(nodes.map(evalNode));
-}
-function flattenArgs(args) {
-	const out = [];
-	for (const arg of args) if (Array.isArray(arg)) for (const value of arg) out.push({
-		value,
-		fromRange: true
-	});
-	else out.push({
-		value: arg,
-		fromRange: false
-	});
-	return out;
-}
-/** 收集数字：区域内只取数字格；直接参数强转（非法/错误 → 传播） */
-function collectNumbers(args) {
-	const numbers = [];
-	for (const { value, fromRange } of flattenArgs(args)) {
-		if (isFormulaError(value)) return value;
-		if (fromRange) {
-			if (typeof value === "number") numbers.push(value);
-			continue;
-		}
-		const n = coerceToNumber(value);
-		if (isFormulaError(n)) return n;
-		numbers.push(n);
-	}
-	return numbers;
-}
-/** 收集布尔：区域内只取布尔格；直接参数强转（非法文本/错误 → 传播）；空值跳过 */
-function collectBooleans(args) {
-	const booleans = [];
-	for (const { value, fromRange } of flattenArgs(args)) {
-		if (isFormulaError(value)) return value;
-		if (fromRange) {
-			if (typeof value === "boolean") booleans.push(value);
-			continue;
-		}
-		if (value === null) continue;
-		const b = coerceToBoolean(value);
-		if (isFormulaError(b)) return b;
-		booleans.push(b);
-	}
-	return booleans;
-}
-registerFormulaFunction("SUM", {
-	minArgs: 1,
-	impl(args) {
-		const numbers = collectNumbers(args);
-		if (isFormulaError(numbers)) return numbers;
-		let sum = 0;
-		for (const n of numbers) sum += n;
-		return sum;
-	}
-});
-registerFormulaFunction("AVERAGE", {
-	minArgs: 1,
-	impl(args) {
-		const numbers = collectNumbers(args);
-		if (isFormulaError(numbers)) return numbers;
-		if (numbers.length === 0) return formulaError("#DIV/0!");
-		let sum = 0;
-		for (const n of numbers) sum += n;
-		return sum / numbers.length;
-	}
-});
-registerFormulaFunction("MAX", {
-	minArgs: 1,
-	impl(args) {
-		const numbers = collectNumbers(args);
-		if (isFormulaError(numbers)) return numbers;
-		return numbers.length === 0 ? 0 : Math.max(...numbers);
-	}
-});
-registerFormulaFunction("MIN", {
-	minArgs: 1,
-	impl(args) {
-		const numbers = collectNumbers(args);
-		if (isFormulaError(numbers)) return numbers;
-		return numbers.length === 0 ? 0 : Math.min(...numbers);
-	}
-});
-registerFormulaFunction("COUNT", {
-	minArgs: 1,
-	impl(args) {
-		let count = 0;
-		for (const { value, fromRange } of flattenArgs(args)) {
-			if (isFormulaError(value)) return value;
-			if (fromRange) {
-				if (typeof value === "number") count++;
-				continue;
-			}
-			if (!isFormulaError(coerceToNumber(value))) count++;
-		}
-		return count;
-	}
-});
-registerFormulaFunction("COUNTA", {
-	minArgs: 1,
-	impl(args) {
-		let count = 0;
-		for (const { value, fromRange } of flattenArgs(args)) {
-			if (!fromRange && isFormulaError(value)) return value;
-			if (value === null) continue;
-			count++;
-		}
-		return count;
-	}
-});
-registerFormulaFunction("IF", {
-	kind: "lazy",
-	minArgs: 2,
-	maxArgs: 3,
-	impl(nodes, evalNode) {
-		const cond = coerceToBoolean(evalNode(nodes[0]));
-		if (isFormulaError(cond)) return cond;
-		if (cond) return evalNode(nodes[1]);
-		return nodes[2] ? evalNode(nodes[2]) : false;
-	}
-});
-registerFormulaFunction("AND", {
-	minArgs: 1,
-	impl(args) {
-		const booleans = collectBooleans(args);
-		if (isFormulaError(booleans)) return booleans;
-		if (booleans.length === 0) return formulaError("#VALUE!");
-		return booleans.every(Boolean);
-	}
-});
-registerFormulaFunction("OR", {
-	minArgs: 1,
-	impl(args) {
-		const booleans = collectBooleans(args);
-		if (isFormulaError(booleans)) return booleans;
-		if (booleans.length === 0) return formulaError("#VALUE!");
-		return booleans.some(Boolean);
-	}
-});
-registerFormulaFunction("NOT", {
-	minArgs: 1,
-	maxArgs: 1,
-	impl(args) {
-		const b = coerceToBoolean(args[0]);
-		if (isFormulaError(b)) return b;
-		return !b;
-	}
-});
-registerFormulaFunction("ROUND", {
-	minArgs: 2,
-	maxArgs: 2,
-	impl(args) {
-		const n = coerceToNumber(args[0]);
-		if (isFormulaError(n)) return n;
-		const d = coerceToNumber(args[1]);
-		if (isFormulaError(d)) return d;
-		const factor = 10 ** Math.trunc(d);
-		if (!Number.isFinite(factor)) return n;
-		if (factor === 0) return 0;
-		const shifted = n * factor;
-		return Math.sign(shifted) * Math.round(Math.abs(shifted) + 1e-12) / factor;
-	}
-});
-registerFormulaFunction("ABS", {
-	minArgs: 1,
-	maxArgs: 1,
-	impl(args) {
-		const n = coerceToNumber(args[0]);
-		if (isFormulaError(n)) return n;
-		return Math.abs(n);
-	}
-});
-registerFormulaFunction("CONCATENATE", {
-	minArgs: 1,
-	impl(args) {
-		let text = "";
-		for (const arg of args) {
-			const values = Array.isArray(arg) ? arg : [arg];
-			for (const value of values) {
-				const piece = coerceToText(value);
-				if (isFormulaError(piece)) return piece;
-				text += piece;
-			}
-		}
-		return text;
-	}
-});
-//#endregion
-export { getFormulaFunction, invokeFormulaFunction, registerFormulaFunction };
-
-//# sourceMappingURL=functions.js.map

package/dist/core/formula/functions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"functions.js","names":[],"sources":["../../../src/core/formula/functions.ts"],"sourcesContent":["import type { AstNode } from './ast'\nimport { formulaError, isFormulaError, type FormulaError } from './errors'\nimport {\n  coerceToBoolean,\n  coerceToNumber,\n  coerceToText,\n  type EvalValue,\n  type ScalarValue\n} from './evaluator'\n\n/**\n * 函数注册表（可扩展）+ 基础函数集。\n *\n * 参数形态约定：区域引用求值为数组（只含稀疏存在的格），直接参数为标量。\n * 聚合函数据此区分 Excel 语义：区域内的文本/布尔被忽略，直接参数则强转（非法 → #VALUE!）。\n * lazy 函数自行求值参数（IF 的短路分支，未选分支的副作用/错误不产生）。\n */\n\nexport type FormulaFunction =\n  | { kind?: 'normal'; minArgs?: number; maxArgs?: number; impl: (args: EvalValue[]) => EvalValue }\n  | {\n      kind: 'lazy'\n      minArgs?: number\n      maxArgs?: number\n      impl: (nodes: AstNode[], evalNode: (node: AstNode) => EvalValue) => EvalValue\n    }\n\nconst registry = new Map<string, FormulaFunction>()\n\n/** 注册函数（名称大小写不敏感；同名覆盖，供扩展/自定义函数） */\nexport function registerFormulaFunction(name: string, def: FormulaFunction): void {\n  registry.set(name.toUpperCase(), def)\n}\n\n/** 查询函数（大小写不敏感） */\nexport function getFormulaFunction(name: string): FormulaFunction | undefined {\n  return registry.get(name.toUpperCase())\n}\n\n/** 求值器回调：名称解析 + 参数个数校验 + 按 kind 分发 */\nexport function invokeFormulaFunction(\n  name: string,\n  nodes: AstNode[],\n  evalNode: (node: AstNode) => EvalValue\n): EvalValue {\n  const def = getFormulaFunction(name)\n  if (!def) return formulaError('#NAME?')\n  if (def.minArgs !== undefined && nodes.length < def.minArgs) return formulaError('#VALUE!')\n  if (def.maxArgs !== undefined && nodes.length > def.maxArgs) return formulaError('#VALUE!')\n  if (def.kind === 'lazy') return def.impl(nodes, evalNode)\n  return def.impl(nodes.map(evalNode))\n}\n\n// ─── 内部工具 ────────────────────────────────────────────────\n\ninterface FlatArg {\n  value: ScalarValue | FormulaError\n  /** 来自区域展开（区别于直接参数：区域内文本/布尔被聚合函数忽略） */\n  fromRange: boolean\n}\n\nfunction flattenArgs(args: EvalValue[]): FlatArg[] {\n  const out: FlatArg[] = []\n  for (const arg of args) {\n    if (Array.isArray(arg)) {\n      for (const value of arg) out.push({ value, fromRange: true })\n    } else {\n      out.push({ value: arg, fromRange: false })\n    }\n  }\n  return out\n}\n\n/** 收集数字：区域内只取数字格；直接参数强转（非法/错误 → 传播） */\nfunction collectNumbers(args: EvalValue[]): number[] | FormulaError {\n  const numbers: number[] = []\n  for (const { value, fromRange } of flattenArgs(args)) {\n    if (isFormulaError(value)) return value\n    if (fromRange) {\n      if (typeof value === 'number') numbers.push(value)\n      continue\n    }\n    const n = coerceToNumber(value)\n    if (isFormulaError(n)) return n\n    numbers.push(n)\n  }\n  return numbers\n}\n\n/** 收集布尔：区域内只取布尔格；直接参数强转（非法文本/错误 → 传播）；空值跳过 */\nfunction collectBooleans(args: EvalValue[]): boolean[] | FormulaError {\n  const booleans: boolean[] = []\n  for (const { value, fromRange } of flattenArgs(args)) {\n    if (isFormulaError(value)) return value\n    if (fromRange) {\n      if (typeof value === 'boolean') booleans.push(value)\n      continue\n    }\n    if (value === null) continue\n    const b = coerceToBoolean(value)\n    if (isFormulaError(b)) return b\n    booleans.push(b)\n  }\n  return booleans\n}\n\n// ─── 基础函数集 ─────────────────────────────────────────────\n\nregisterFormulaFunction('SUM', {\n  minArgs: 1,\n  impl(args) {\n    const numbers = collectNumbers(args)\n    if (isFormulaError(numbers)) return numbers\n    let sum = 0\n    for (const n of numbers) sum += n\n    return sum\n  }\n})\n\nregisterFormulaFunction('AVERAGE', {\n  minArgs: 1,\n  impl(args) {\n    const numbers = collectNumbers(args)\n    if (isFormulaError(numbers)) return numbers\n    if (numbers.length === 0) return formulaError('#DIV/0!')\n    let sum = 0\n    for (const n of numbers) sum += n\n    return sum / numbers.length\n  }\n})\n\nregisterFormulaFunction('MAX', {\n  minArgs: 1,\n  impl(args) {\n    const numbers = collectNumbers(args)\n    if (isFormulaError(numbers)) return numbers\n    return numbers.length === 0 ? 0 : Math.max(...numbers)\n  }\n})\n\nregisterFormulaFunction('MIN', {\n  minArgs: 1,\n  impl(args) {\n    const numbers = collectNumbers(args)\n    if (isFormulaError(numbers)) return numbers\n    return numbers.length === 0 ? 0 : Math.min(...numbers)\n  }\n})\n\nregisterFormulaFunction('COUNT', {\n  minArgs: 1,\n  impl(args) {\n    let count = 0\n    for (const { value, fromRange } of flattenArgs(args)) {\n      if (isFormulaError(value)) return value\n      if (fromRange) {\n        if (typeof value === 'number') count++\n        continue\n      }\n      // 直接参数：可强转为数字即计数（含 TRUE/FALSE、数字文本）\n      if (!isFormulaError(coerceToNumber(value))) count++\n    }\n    return count\n  }\n})\n\nregisterFormulaFunction('COUNTA', {\n  minArgs: 1,\n  impl(args) {\n    let count = 0\n    for (const { value, fromRange } of flattenArgs(args)) {\n      // 直接错误参数传播；区域内的错误格照常计数\n      if (!fromRange && isFormulaError(value)) return value\n      if (value === null) continue\n      count++\n    }\n    return count\n  }\n})\n\nregisterFormulaFunction('IF', {\n  kind: 'lazy',\n  minArgs: 2,\n  maxArgs: 3,\n  impl(nodes, evalNode) {\n    const cond = coerceToBoolean(evalNode(nodes[0]!))\n    if (isFormulaError(cond)) return cond\n    if (cond) return evalNode(nodes[1]!)\n    return nodes[2] ? evalNode(nodes[2]) : false\n  }\n})\n\nregisterFormulaFunction('AND', {\n  minArgs: 1,\n  impl(args) {\n    const booleans = collectBooleans(args)\n    if (isFormulaError(booleans)) return booleans\n    if (booleans.length === 0) return formulaError('#VALUE!')\n    return booleans.every(Boolean)\n  }\n})\n\nregisterFormulaFunction('OR', {\n  minArgs: 1,\n  impl(args) {\n    const booleans = collectBooleans(args)\n    if (isFormulaError(booleans)) return booleans\n    if (booleans.length === 0) return formulaError('#VALUE!')\n    return booleans.some(Boolean)\n  }\n})\n\nregisterFormulaFunction('NOT', {\n  minArgs: 1,\n  maxArgs: 1,\n  impl(args) {\n    const b = coerceToBoolean(args[0]!)\n    if (isFormulaError(b)) return b\n    return !b\n  }\n})\n\nregisterFormulaFunction('ROUND', {\n  minArgs: 2,\n  maxArgs: 2,\n  impl(args) {\n    const n = coerceToNumber(args[0]!)\n    if (isFormulaError(n)) return n\n    const d = coerceToNumber(args[1]!)\n    if (isFormulaError(d)) return d\n    const factor = 10 ** Math.trunc(d)\n    // 位数超出 double 精度时四舍五入是恒等/归零\n    if (!Number.isFinite(factor)) return n\n    if (factor === 0) return 0\n    // 远离零方向取整；1e-12 补偿浮点表示误差（如 2.675 存为 2.67499…）\n    const shifted = n * factor\n    const rounded = Math.sign(shifted) * Math.round(Math.abs(shifted) + 1e-12)\n    return rounded / factor\n  }\n})\n\nregisterFormulaFunction('ABS', {\n  minArgs: 1,\n  maxArgs: 1,\n  impl(args) {\n    const n = coerceToNumber(args[0]!)\n    if (isFormulaError(n)) return n\n    return Math.abs(n)\n  }\n})\n\nregisterFormulaFunction('CONCATENATE', {\n  minArgs: 1,\n  impl(args) {\n    let text = ''\n    for (const arg of args) {\n      const values = Array.isArray(arg) ? arg : [arg]\n      for (const value of values) {\n        const piece = coerceToText(value)\n        if (isFormulaError(piece)) return piece\n        text += piece\n      }\n    }\n    return text\n  }\n})\n"],"mappings":"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"}

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

@@ -1,7 +0,0 @@
-import { AstNode } from "./ast.js";
-//#region src/core/formula/parser.d.ts
-/** 解析公式文本（不含 '='）→ AST；非法输入抛 FormulaParseError */
-declare function parseFormula(text: string): AstNode;
-//#endregion
-export { parseFormula };
-//# sourceMappingURL=parser.d.ts.map

package/dist/core/formula/parser.js

@@ -1,208 +0,0 @@
-import { createRange, parseAddress } from "../address.js";
-import { FormulaParseError, tokenizeFormula } from "./tokenizer.js";
-//#region src/core/formula/parser.ts
-/**
-* Pratt parser：token 序列 → AST。
-*
-* 优先级（同 Excel，低到高）：比较运算 < `&` < `+ -` < `* /` < 一元 `+ -` < `^`（右结合）< `%`。
-* 一元运算紧于幂次是 Excel 的特有行为：-2^2 = (-2)^2 = 4。
-* 引用消歧：ident 后随 `(` → 函数调用；后随 `!` → 表名前缀；匹配单元格形态 → 引用；
-* TRUE/FALSE → 布尔字面量；其余 → 未知名称节点（求值 #NAME?）。
-*/
-/** 中缀运算符绑定力 [左, 右]；右结合运算符右绑定力 = 左 - 1 */
-const INFIX_BP = {
-	"=": [1, 1],
-	"<>": [1, 1],
-	"<": [1, 1],
-	"<=": [1, 1],
-	">": [1, 1],
-	">=": [1, 1],
-	"&": [2, 2],
-	"+": [3, 3],
-	"-": [3, 3],
-	"*": [4, 4],
-	"/": [4, 4],
-	"^": [6, 5]
-};
-/** 百分号后缀绑定力（最高） */
-const PERCENT_BP = 7;
-/** 一元 +/- 操作数的绑定力：紧于 ^（6），松于 %（7） */
-const UNARY_OPERAND_BP = 6;
-/** 单元格引用形态（列限 3 字母；超出按未知名称处理，如 Sheet2） */
-const CELL_REF_RE = /^\$?[A-Za-z]{1,3}\$?[1-9]\d*$/;
-var Parser = class {
-	tokens;
-	pos = 0;
-	constructor(tokens) {
-		this.tokens = tokens;
-	}
-	parse() {
-		const node = this.parseExpression(0);
-		if (this.pos < this.tokens.length) throw new FormulaParseError(`意外的多余输入: ${describeToken(this.tokens[this.pos])}`);
-		return node;
-	}
-	peek() {
-		return this.tokens[this.pos];
-	}
-	next() {
-		return this.tokens[this.pos++];
-	}
-	peekOp(op) {
-		const token = this.peek();
-		return token?.type === "op" && token.op === op;
-	}
-	expectOp(op) {
-		if (!this.peekOp(op)) throw new FormulaParseError(`期望 "${op}"，得到 ${describeToken(this.peek())}`);
-		this.pos++;
-	}
-	parseExpression(minBp) {
-		let left = this.parsePrimary();
-		for (;;) {
-			const token = this.peek();
-			if (token?.type !== "op") break;
-			if (token.op === "%") {
-				if (PERCENT_BP <= minBp) break;
-				this.pos++;
-				left = {
-					kind: "percent",
-					operand: left
-				};
-				continue;
-			}
-			const bp = INFIX_BP[token.op];
-			if (!bp || bp[0] <= minBp) break;
-			this.pos++;
-			const right = this.parseExpression(bp[1]);
-			left = {
-				kind: "binary",
-				op: token.op,
-				left,
-				right
-			};
-		}
-		return left;
-	}
-	parsePrimary() {
-		const token = this.next();
-		if (!token) throw new FormulaParseError("表达式不完整");
-		if (token.type === "number") return {
-			kind: "number",
-			value: token.value
-		};
-		if (token.type === "string") return {
-			kind: "string",
-			value: token.value
-		};
-		if (token.type === "quoted-name") {
-			this.expectOp("!");
-			return this.parseCellRefOrRange(token.name);
-		}
-		if (token.type === "ident") {
-			const name = token.name;
-			if (this.peekOp("(")) return this.parseCall(name);
-			if (this.peekOp("!")) {
-				this.pos++;
-				return this.parseCellRefOrRange(name);
-			}
-			const addr = parseCellRef(name);
-			if (addr) return this.parseRangeTail({
-				sheet: void 0,
-				addr
-			});
-			if (name.toUpperCase() === "TRUE") return {
-				kind: "boolean",
-				value: true
-			};
-			if (name.toUpperCase() === "FALSE") return {
-				kind: "boolean",
-				value: false
-			};
-			return {
-				kind: "name",
-				name
-			};
-		}
-		if (token.type === "op") {
-			if (token.op === "(") {
-				const inner = this.parseExpression(0);
-				this.expectOp(")");
-				return inner;
-			}
-			if (token.op === "-" || token.op === "+") return {
-				kind: "unary",
-				op: token.op,
-				operand: this.parseExpression(UNARY_OPERAND_BP)
-			};
-		}
-		throw new FormulaParseError(`意外的 ${describeToken(token)}`);
-	}
-	/** 函数调用：ident 已消费，当前 token 为 '(' */
-	parseCall(name) {
-		this.pos++;
-		const args = [];
-		if (!this.peekOp(")")) for (;;) {
-			args.push(this.parseExpression(0));
-			if (this.peekOp(",")) {
-				this.pos++;
-				continue;
-			}
-			break;
-		}
-		this.expectOp(")");
-		return {
-			kind: "call",
-			name,
-			args
-		};
-	}
-	/** 表名前缀（Sheet2! / 'My Sheet'!）之后的单元格或区域引用 */
-	parseCellRefOrRange(sheet) {
-		const token = this.next();
-		const addr = token?.type === "ident" ? parseCellRef(token.name) : null;
-		if (!addr) throw new FormulaParseError(`表名 "${sheet}" 后应为单元格引用，得到 ${describeToken(token)}`);
-		return this.parseRangeTail({
-			sheet,
-			addr
-		});
-	}
-	/** 单元格引用之后的可选区域后缀（:B9） */
-	parseRangeTail(ref) {
-		if (!this.peekOp(":")) return {
-			kind: "cell",
-			sheet: ref.sheet,
-			addr: ref.addr
-		};
-		this.pos++;
-		const token = this.next();
-		const end = token?.type === "ident" ? parseCellRef(token.name) : null;
-		if (!end) throw new FormulaParseError(`区域 ":" 后应为单元格引用，得到 ${describeToken(token)}`);
-		return {
-			kind: "range",
-			sheet: ref.sheet,
-			range: createRange(ref.addr, end)
-		};
-	}
-};
-/** 按单元格引用形态解析（列限 3 字母）；不匹配返回 null */
-function parseCellRef(name) {
-	if (!CELL_REF_RE.test(name)) return null;
-	return parseAddress(name);
-}
-function describeToken(token) {
-	if (!token) return "输入末尾";
-	switch (token.type) {
-		case "number": return `数字 ${token.value}`;
-		case "string": return `字符串 "${token.value}"`;
-		case "ident": return `名称 "${token.name}"`;
-		case "quoted-name": return `表名 '${token.name}'`;
-		case "op": return `"${token.op}"`;
-	}
-}
-/** 解析公式文本（不含 '='）→ AST；非法输入抛 FormulaParseError */
-function parseFormula(text) {
-	return new Parser(tokenizeFormula(text)).parse();
-}
-//#endregion
-export { parseFormula };
-
-//# sourceMappingURL=parser.js.map

package/dist/core/formula/parser.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parser.js","names":[],"sources":["../../../src/core/formula/parser.ts"],"sourcesContent":["import { createRange, parseAddress, type CellAddress } from '../address'\nimport type { AstNode, BinaryOperator } from './ast'\nimport { FormulaParseError, tokenizeFormula, type FormulaToken } from './tokenizer'\n\n/**\n * Pratt parser：token 序列 → AST。\n *\n * 优先级（同 Excel，低到高）：比较运算 < `&` < `+ -` < `* /` < 一元 `+ -` < `^`（右结合）< `%`。\n * 一元运算紧于幂次是 Excel 的特有行为：-2^2 = (-2)^2 = 4。\n * 引用消歧：ident 后随 `(` → 函数调用；后随 `!` → 表名前缀；匹配单元格形态 → 引用；\n * TRUE/FALSE → 布尔字面量；其余 → 未知名称节点（求值 #NAME?）。\n */\n\n/** 中缀运算符绑定力 [左, 右]；右结合运算符右绑定力 = 左 - 1 */\nconst INFIX_BP: Record<string, readonly [number, number]> = {\n  '=': [1, 1],\n  '<>': [1, 1],\n  '<': [1, 1],\n  '<=': [1, 1],\n  '>': [1, 1],\n  '>=': [1, 1],\n  '&': [2, 2],\n  '+': [3, 3],\n  '-': [3, 3],\n  '*': [4, 4],\n  '/': [4, 4],\n  '^': [6, 5]\n}\n/** 百分号后缀绑定力（最高） */\nconst PERCENT_BP = 7\n/** 一元 +/- 操作数的绑定力：紧于 ^（6），松于 %（7） */\nconst UNARY_OPERAND_BP = 6\n\n/** 单元格引用形态（列限 3 字母；超出按未知名称处理，如 Sheet2） */\nconst CELL_REF_RE = /^\\$?[A-Za-z]{1,3}\\$?[1-9]\\d*$/\n\nclass Parser {\n  private pos = 0\n\n  constructor(private readonly tokens: FormulaToken[]) {}\n\n  parse(): AstNode {\n    const node = this.parseExpression(0)\n    if (this.pos < this.tokens.length) {\n      throw new FormulaParseError(`意外的多余输入: ${describeToken(this.tokens[this.pos]!)}`)\n    }\n    return node\n  }\n\n  private peek(): FormulaToken | undefined {\n    return this.tokens[this.pos]\n  }\n\n  private next(): FormulaToken | undefined {\n    return this.tokens[this.pos++]\n  }\n\n  private peekOp(op: string): boolean {\n    const token = this.peek()\n    return token?.type === 'op' && token.op === op\n  }\n\n  private expectOp(op: string): void {\n    if (!this.peekOp(op)) {\n      throw new FormulaParseError(`期望 \"${op}\"，得到 ${describeToken(this.peek())}`)\n    }\n    this.pos++\n  }\n\n  private parseExpression(minBp: number): AstNode {\n    let left = this.parsePrimary()\n    for (;;) {\n      const token = this.peek()\n      if (token?.type !== 'op') break\n      // 百分号后缀\n      if (token.op === '%') {\n        if (PERCENT_BP <= minBp) break\n        this.pos++\n        left = { kind: 'percent', operand: left }\n        continue\n      }\n      const bp = INFIX_BP[token.op]\n      if (!bp || bp[0] <= minBp) break\n      this.pos++\n      const right = this.parseExpression(bp[1])\n      left = { kind: 'binary', op: token.op as BinaryOperator, left, right }\n    }\n    return left\n  }\n\n  private parsePrimary(): AstNode {\n    const token = this.next()\n    if (!token) throw new FormulaParseError('表达式不完整')\n\n    if (token.type === 'number') return { kind: 'number', value: token.value }\n    if (token.type === 'string') return { kind: 'string', value: token.value }\n\n    if (token.type === 'quoted-name') {\n      // 带引号表名只能作为跨表引用前缀\n      this.expectOp('!')\n      return this.parseCellRefOrRange(token.name)\n    }\n\n    if (token.type === 'ident') {\n      const name = token.name\n      if (this.peekOp('(')) return this.parseCall(name)\n      if (this.peekOp('!')) {\n        this.pos++\n        return this.parseCellRefOrRange(name)\n      }\n      const addr = parseCellRef(name)\n      if (addr) return this.parseRangeTail({ sheet: undefined, addr })\n      if (name.toUpperCase() === 'TRUE') return { kind: 'boolean', value: true }\n      if (name.toUpperCase() === 'FALSE') return { kind: 'boolean', value: false }\n      return { kind: 'name', name }\n    }\n\n    // 运算符位置：括号 / 一元 +-\n    if (token.type === 'op') {\n      if (token.op === '(') {\n        const inner = this.parseExpression(0)\n        this.expectOp(')')\n        return inner\n      }\n      if (token.op === '-' || token.op === '+') {\n        return { kind: 'unary', op: token.op, operand: this.parseExpression(UNARY_OPERAND_BP) }\n      }\n    }\n    throw new FormulaParseError(`意外的 ${describeToken(token)}`)\n  }\n\n  /** 函数调用：ident 已消费，当前 token 为 '(' */\n  private parseCall(name: string): AstNode {\n    this.pos++ // 消费 '('\n    const args: AstNode[] = []\n    if (!this.peekOp(')')) {\n      for (;;) {\n        args.push(this.parseExpression(0))\n        if (this.peekOp(',')) {\n          this.pos++\n          continue\n        }\n        break\n      }\n    }\n    this.expectOp(')')\n    return { kind: 'call', name, args }\n  }\n\n  /** 表名前缀（Sheet2! / 'My Sheet'!）之后的单元格或区域引用 */\n  private parseCellRefOrRange(sheet: string): AstNode {\n    const token = this.next()\n    const addr = token?.type === 'ident' ? parseCellRef(token.name) : null\n    if (!addr) {\n      throw new FormulaParseError(`表名 \"${sheet}\" 后应为单元格引用，得到 ${describeToken(token)}`)\n    }\n    return this.parseRangeTail({ sheet, addr })\n  }\n\n  /** 单元格引用之后的可选区域后缀（:B9） */\n  private parseRangeTail(ref: { sheet: string | undefined; addr: CellAddress }): AstNode {\n    if (!this.peekOp(':')) return { kind: 'cell', sheet: ref.sheet, addr: ref.addr }\n    this.pos++\n    const token = this.next()\n    const end = token?.type === 'ident' ? parseCellRef(token.name) : null\n    if (!end) {\n      throw new FormulaParseError(`区域 \":\" 后应为单元格引用，得到 ${describeToken(token)}`)\n    }\n    return { kind: 'range', sheet: ref.sheet, range: createRange(ref.addr, end) }\n  }\n}\n\n/** 按单元格引用形态解析（列限 3 字母）；不匹配返回 null */\nfunction parseCellRef(name: string): CellAddress | null {\n  if (!CELL_REF_RE.test(name)) return null\n  return parseAddress(name)\n}\n\nfunction describeToken(token: FormulaToken | undefined): string {\n  if (!token) return '输入末尾'\n  switch (token.type) {\n    case 'number':\n      return `数字 ${token.value}`\n    case 'string':\n      return `字符串 \"${token.value}\"`\n    case 'ident':\n      return `名称 \"${token.name}\"`\n    case 'quoted-name':\n      return `表名 '${token.name}'`\n    case 'op':\n      return `\"${token.op}\"`\n  }\n}\n\n/** 解析公式文本（不含 '='）→ AST；非法输入抛 FormulaParseError */\nexport function parseFormula(text: string): AstNode {\n  return new Parser(tokenizeFormula(text)).parse()\n}\n"],"mappings":"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"}

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

@@ -1,37 +0,0 @@
-//#region src/core/formula/tokenizer.d.ts
-/**
- * 公式分词器：数字 / 字符串 / 布尔 / 标识符（函数名、引用、表名）/ 带引号表名 / 运算符。
- *
- * 不做语义消歧：`A1`（引用）、`SUM`（函数名）、`Sheet2`（表名）统一产出 ident，
- * 由 parser 依据后随 token（`(` / `!` / `:` / 运算位）判定。
- */
-/** 解析失败异常（Sheet 层捕获 → 单元格记为 #ERROR!） */
-declare class FormulaParseError extends Error {
-  constructor(message: string);
-}
-type FormulaOperator = '+' | '-' | '*' | '/' | '^' | '&' | '%' | '(' | ')' | ',' | '!' | ':' | '=' | '<>' | '<' | '<=' | '>' | '>=';
-type FormulaToken = {
-  type: 'number';
-  value: number;
-} | {
-  type: 'string';
-  value: string;
-} |
-/** 标识符：函数名 / 单元格引用形态 / 裸表名（含 $ 绝对引用写法）；TRUE/FALSE 由 parser 归约为布尔 */
-{
-  type: 'ident';
-  name: string;
-} |
-/** 带单引号的表名（'' 转义为字面单引号） */
-{
-  type: 'quoted-name';
-  name: string;
-} | {
-  type: 'op';
-  op: FormulaOperator;
-};
-/** 公式文本（不含 '='）→ token 序列；非法输入抛 FormulaParseError */
-declare function tokenizeFormula(text: string): FormulaToken[];
-//#endregion
-export { FormulaOperator, FormulaParseError, FormulaToken, tokenizeFormula };
-//# sourceMappingURL=tokenizer.d.ts.map

package/dist/core/formula/tokenizer.js

@@ -1,146 +0,0 @@
-//#region src/core/formula/tokenizer.ts
-/**
-* 公式分词器：数字 / 字符串 / 布尔 / 标识符（函数名、引用、表名）/ 带引号表名 / 运算符。
-*
-* 不做语义消歧：`A1`（引用）、`SUM`（函数名）、`Sheet2`（表名）统一产出 ident，
-* 由 parser 依据后随 token（`(` / `!` / `:` / 运算位）判定。
-*/
-/** 解析失败异常（Sheet 层捕获 → 单元格记为 #ERROR!） */
-var FormulaParseError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "FormulaParseError";
-	}
-};
-const NUMBER_RE = /^(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?/;
-/** 标识符首字符：字母 / _ / $ / 非 ASCII（中文表名等） */
-function isIdentStart(ch) {
-	return /[A-Za-z_$]/.test(ch) || ch.charCodeAt(0) >= 128;
-}
-/** 标识符后续字符：首字符集 + 数字 + . */
-function isIdentPart(ch) {
-	return /[A-Za-z0-9_.$]/.test(ch) || ch.charCodeAt(0) >= 128;
-}
-const TWO_CHAR_OPS = [
-	"<>",
-	"<=",
-	">="
-];
-const ONE_CHAR_OPS = [
-	"+",
-	"-",
-	"*",
-	"/",
-	"^",
-	"&",
-	"%",
-	"(",
-	")",
-	",",
-	"!",
-	":",
-	"=",
-	"<",
-	">"
-];
-/** 公式文本（不含 '='）→ token 序列；非法输入抛 FormulaParseError */
-function tokenizeFormula(text) {
-	const tokens = [];
-	let i = 0;
-	while (i < text.length) {
-		const ch = text[i];
-		if (ch === " " || ch === "	" || ch === "\n" || ch === "\r") {
-			i++;
-			continue;
-		}
-		if (ch >= "0" && ch <= "9" || ch === "." && text[i + 1] >= "0" && text[i + 1] <= "9") {
-			const match = NUMBER_RE.exec(text.slice(i));
-			if (!match) throw new FormulaParseError(`非法数字（位置 ${i + 1}）`);
-			tokens.push({
-				type: "number",
-				value: Number.parseFloat(match[0])
-			});
-			i += match[0].length;
-			continue;
-		}
-		if (ch === "\"") {
-			let value = "";
-			let j = i + 1;
-			for (;;) {
-				if (j >= text.length) throw new FormulaParseError("字符串缺少结束引号");
-				if (text[j] === "\"") {
-					if (text[j + 1] === "\"") {
-						value += "\"";
-						j += 2;
-						continue;
-					}
-					break;
-				}
-				value += text[j];
-				j++;
-			}
-			tokens.push({
-				type: "string",
-				value
-			});
-			i = j + 1;
-			continue;
-		}
-		if (ch === "'") {
-			let name = "";
-			let j = i + 1;
-			for (;;) {
-				if (j >= text.length) throw new FormulaParseError("表名缺少结束引号");
-				if (text[j] === "'") {
-					if (text[j + 1] === "'") {
-						name += "'";
-						j += 2;
-						continue;
-					}
-					break;
-				}
-				name += text[j];
-				j++;
-			}
-			tokens.push({
-				type: "quoted-name",
-				name
-			});
-			i = j + 1;
-			continue;
-		}
-		if (isIdentStart(ch)) {
-			let j = i + 1;
-			while (j < text.length && isIdentPart(text[j])) j++;
-			tokens.push({
-				type: "ident",
-				name: text.slice(i, j)
-			});
-			i = j;
-			continue;
-		}
-		const two = text.slice(i, i + 2);
-		if (TWO_CHAR_OPS.includes(two)) {
-			tokens.push({
-				type: "op",
-				op: two
-			});
-			i += 2;
-			continue;
-		}
-		if (ONE_CHAR_OPS.includes(ch)) {
-			tokens.push({
-				type: "op",
-				op: ch
-			});
-			i++;
-			continue;
-		}
-		throw new FormulaParseError(`无法识别的字符 "${ch}"（位置 ${i + 1}）`);
-	}
-	return tokens;
-}
-//#endregion
-export { FormulaParseError, tokenizeFormula };
-
-//# sourceMappingURL=tokenizer.js.map

package/dist/core/formula/tokenizer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tokenizer.js","names":[],"sources":["../../../src/core/formula/tokenizer.ts"],"sourcesContent":["/**\n * 公式分词器：数字 / 字符串 / 布尔 / 标识符（函数名、引用、表名）/ 带引号表名 / 运算符。\n *\n * 不做语义消歧：`A1`（引用）、`SUM`（函数名）、`Sheet2`（表名）统一产出 ident，\n * 由 parser 依据后随 token（`(` / `!` / `:` / 运算位）判定。\n */\n\n/** 解析失败异常（Sheet 层捕获 → 单元格记为 #ERROR!） */\nexport class FormulaParseError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'FormulaParseError'\n  }\n}\n\nexport type FormulaOperator =\n  | '+'\n  | '-'\n  | '*'\n  | '/'\n  | '^'\n  | '&'\n  | '%'\n  | '('\n  | ')'\n  | ','\n  | '!'\n  | ':'\n  | '='\n  | '<>'\n  | '<'\n  | '<='\n  | '>'\n  | '>='\n\nexport type FormulaToken =\n  | { type: 'number'; value: number }\n  | { type: 'string'; value: string }\n  /** 标识符：函数名 / 单元格引用形态 / 裸表名（含 $ 绝对引用写法）；TRUE/FALSE 由 parser 归约为布尔 */\n  | { type: 'ident'; name: string }\n  /** 带单引号的表名（'' 转义为字面单引号） */\n  | { type: 'quoted-name'; name: string }\n  | { type: 'op'; op: FormulaOperator }\n\nconst NUMBER_RE = /^(\\d+\\.?\\d*|\\.\\d+)([eE][+-]?\\d+)?/\n\n/** 标识符首字符：字母 / _ / $ / 非 ASCII（中文表名等） */\nfunction isIdentStart(ch: string): boolean {\n  return /[A-Za-z_$]/.test(ch) || ch.charCodeAt(0) >= 0x80\n}\n\n/** 标识符后续字符：首字符集 + 数字 + . */\nfunction isIdentPart(ch: string): boolean {\n  return /[A-Za-z0-9_.$]/.test(ch) || ch.charCodeAt(0) >= 0x80\n}\n\nconst TWO_CHAR_OPS = ['<>', '<=', '>='] as const\nconst ONE_CHAR_OPS = [\n  '+',\n  '-',\n  '*',\n  '/',\n  '^',\n  '&',\n  '%',\n  '(',\n  ')',\n  ',',\n  '!',\n  ':',\n  '=',\n  '<',\n  '>'\n] as const\n\n/** 公式文本（不含 '='）→ token 序列；非法输入抛 FormulaParseError */\nexport function tokenizeFormula(text: string): FormulaToken[] {\n  const tokens: FormulaToken[] = []\n  let i = 0\n  while (i < text.length) {\n    const ch = text[i]!\n    // 空白忽略（不支持 Excel 的空格交集运算符）\n    if (ch === ' ' || ch === '\\t' || ch === '\\n' || ch === '\\r') {\n      i++\n      continue\n    }\n    // 数字\n    if ((ch >= '0' && ch <= '9') || (ch === '.' && text[i + 1]! >= '0' && text[i + 1]! <= '9')) {\n      const match = NUMBER_RE.exec(text.slice(i))\n      if (!match) throw new FormulaParseError(`非法数字（位置 ${i + 1}）`)\n      tokens.push({ type: 'number', value: Number.parseFloat(match[0]) })\n      i += match[0].length\n      continue\n    }\n    // 字符串字面量（\"...\"，\"\" 转义）\n    if (ch === '\"') {\n      let value = ''\n      let j = i + 1\n      for (;;) {\n        if (j >= text.length) throw new FormulaParseError('字符串缺少结束引号')\n        if (text[j] === '\"') {\n          if (text[j + 1] === '\"') {\n            value += '\"'\n            j += 2\n            continue\n          }\n          break\n        }\n        value += text[j]\n        j++\n      }\n      tokens.push({ type: 'string', value })\n      i = j + 1\n      continue\n    }\n    // 带引号表名（'...'，'' 转义）\n    if (ch === \"'\") {\n      let name = ''\n      let j = i + 1\n      for (;;) {\n        if (j >= text.length) throw new FormulaParseError('表名缺少结束引号')\n        if (text[j] === \"'\") {\n          if (text[j + 1] === \"'\") {\n            name += \"'\"\n            j += 2\n            continue\n          }\n          break\n        }\n        name += text[j]\n        j++\n      }\n      tokens.push({ type: 'quoted-name', name })\n      i = j + 1\n      continue\n    }\n    // 标识符（函数名 / 引用 / 裸表名）\n    if (isIdentStart(ch)) {\n      let j = i + 1\n      while (j < text.length && isIdentPart(text[j]!)) j++\n      tokens.push({ type: 'ident', name: text.slice(i, j) })\n      i = j\n      continue\n    }\n    // 双字符运算符优先\n    const two = text.slice(i, i + 2)\n    if ((TWO_CHAR_OPS as readonly string[]).includes(two)) {\n      tokens.push({ type: 'op', op: two as FormulaOperator })\n      i += 2\n      continue\n    }\n    if ((ONE_CHAR_OPS as readonly string[]).includes(ch)) {\n      tokens.push({ type: 'op', op: ch as FormulaOperator })\n      i++\n      continue\n    }\n    throw new FormulaParseError(`无法识别的字符 \"${ch}\"（位置 ${i + 1}）`)\n  }\n  return tokens\n}\n"],"mappings":";;;;;;;;AAQA,IAAa,oBAAb,cAAuC,MAAM;CAC3C,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;AA+BA,MAAM,YAAY;;AAGlB,SAAS,aAAa,IAAqB;CACzC,OAAO,aAAa,KAAK,EAAE,KAAK,GAAG,WAAW,CAAC,KAAK;AACtD;;AAGA,SAAS,YAAY,IAAqB;CACxC,OAAO,iBAAiB,KAAK,EAAE,KAAK,GAAG,WAAW,CAAC,KAAK;AAC1D;AAEA,MAAM,eAAe;CAAC;CAAM;CAAM;AAAI;AACtC,MAAM,eAAe;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;AAGA,SAAgB,gBAAgB,MAA8B;CAC5D,MAAM,SAAyB,CAAC;CAChC,IAAI,IAAI;CACR,OAAO,IAAI,KAAK,QAAQ;EACtB,MAAM,KAAK,KAAK;EAEhB,IAAI,OAAO,OAAO,OAAO,OAAQ,OAAO,QAAQ,OAAO,MAAM;GAC3D;GACA;EACF;EAEA,IAAK,MAAM,OAAO,MAAM,OAAS,OAAO,OAAO,KAAK,IAAI,MAAO,OAAO,KAAK,IAAI,MAAO,KAAM;GAC1F,MAAM,QAAQ,UAAU,KAAK,KAAK,MAAM,CAAC,CAAC;GAC1C,IAAI,CAAC,OAAO,MAAM,IAAI,kBAAkB,WAAW,IAAI,EAAE,EAAE;GAC3D,OAAO,KAAK;IAAE,MAAM;IAAU,OAAO,OAAO,WAAW,MAAM,EAAE;GAAE,CAAC;GAClE,KAAK,MAAM,EAAE,CAAC;GACd;EACF;EAEA,IAAI,OAAO,MAAK;GACd,IAAI,QAAQ;GACZ,IAAI,IAAI,IAAI;GACZ,SAAS;IACP,IAAI,KAAK,KAAK,QAAQ,MAAM,IAAI,kBAAkB,WAAW;IAC7D,IAAI,KAAK,OAAO,MAAK;KACnB,IAAI,KAAK,IAAI,OAAO,MAAK;MACvB,SAAS;MACT,KAAK;MACL;KACF;KACA;IACF;IACA,SAAS,KAAK;IACd;GACF;GACA,OAAO,KAAK;IAAE,MAAM;IAAU;GAAM,CAAC;GACrC,IAAI,IAAI;GACR;EACF;EAEA,IAAI,OAAO,KAAK;GACd,IAAI,OAAO;GACX,IAAI,IAAI,IAAI;GACZ,SAAS;IACP,IAAI,KAAK,KAAK,QAAQ,MAAM,IAAI,kBAAkB,UAAU;IAC5D,IAAI,KAAK,OAAO,KAAK;KACnB,IAAI,KAAK,IAAI,OAAO,KAAK;MACvB,QAAQ;MACR,KAAK;MACL;KACF;KACA;IACF;IACA,QAAQ,KAAK;IACb;GACF;GACA,OAAO,KAAK;IAAE,MAAM;IAAe;GAAK,CAAC;GACzC,IAAI,IAAI;GACR;EACF;EAEA,IAAI,aAAa,EAAE,GAAG;GACpB,IAAI,IAAI,IAAI;GACZ,OAAO,IAAI,KAAK,UAAU,YAAY,KAAK,EAAG,GAAG;GACjD,OAAO,KAAK;IAAE,MAAM;IAAS,MAAM,KAAK,MAAM,GAAG,CAAC;GAAE,CAAC;GACrD,IAAI;GACJ;EACF;EAEA,MAAM,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;EAC/B,IAAK,aAAmC,SAAS,GAAG,GAAG;GACrD,OAAO,KAAK;IAAE,MAAM;IAAM,IAAI;GAAuB,CAAC;GACtD,KAAK;GACL;EACF;EACA,IAAK,aAAmC,SAAS,EAAE,GAAG;GACpD,OAAO,KAAK;IAAE,MAAM;IAAM,IAAI;GAAsB,CAAC;GACrD;GACA;EACF;EACA,MAAM,IAAI,kBAAkB,YAAY,GAAG,OAAO,IAAI,EAAE,EAAE;CAC5D;CACA,OAAO;AACT"}