@veltra/sheet 2.0.1 → 2.1.1

package/dist/core/fill.js

@@ -1,320 +0,0 @@
-import { colIndexToName, colNameToIndex, createRange, iterateRange } from "./address.js";
-//#region src/core/fill.ts
-/**
-* 由源选区 + 拖拽后扩展选区 + 方向，计算需要填充的目标区（模型坐标）。
-* 算法对齐 VTable 官方 fill-handle 示例（扩展选区含源区，目标为扩展部分）。
-*/
-function computeFillTargetRange(source, direction, expanded) {
-	const src = createRange(source.start, source.end);
-	const exp = createRange(expanded.start, expanded.end);
-	if (direction === "bottom") {
-		if (exp.end.row <= src.end.row) return null;
-		return {
-			start: {
-				row: src.end.row + 1,
-				col: src.start.col
-			},
-			end: {
-				row: exp.end.row,
-				col: src.end.col
-			}
-		};
-	}
-	if (direction === "top") {
-		if (exp.start.row >= src.start.row) return null;
-		return {
-			start: {
-				row: exp.start.row,
-				col: src.start.col
-			},
-			end: {
-				row: src.start.row - 1,
-				col: src.end.col
-			}
-		};
-	}
-	if (direction === "right") {
-		if (exp.end.col <= src.end.col) return null;
-		return {
-			start: {
-				row: src.start.row,
-				col: src.end.col + 1
-			},
-			end: {
-				row: src.end.row,
-				col: exp.end.col
-			}
-		};
-	}
-	if (exp.start.col >= src.start.col) return null;
-	return {
-		start: {
-			row: src.start.row,
-			col: exp.start.col
-		},
-		end: {
-			row: src.end.row,
-			col: src.start.col - 1
-		}
-	};
-}
-/**
-* 生成填充写入项（tile / 数字日期等差 / 公式相对引用位移）。
-* 调用方一次 `sheet.setCells(items)` 即可（单 undo 单元）。
-*/
-function generateFill(options) {
-	const { source, target, direction, getCellData } = options;
-	const src = createRange(source.start, source.end);
-	const tgt = createRange(target.start, target.end);
-	const srcRows = src.end.row - src.start.row + 1;
-	const srcCols = src.end.col - src.start.col + 1;
-	const vertical = direction === "top" || direction === "bottom";
-	const seriesByLane = /* @__PURE__ */ new Map();
-	if (vertical) for (let col = src.start.col; col <= src.end.col; col++) {
-		const values = [];
-		let cellType;
-		let ok = true;
-		for (let row = src.start.row; row <= src.end.row; row++) {
-			const num = readSeriesNumber(getCellData({
-				row,
-				col
-			}));
-			if (num == null) {
-				ok = false;
-				break;
-			}
-			values.push(num.value);
-			cellType = num.t;
-		}
-		seriesByLane.set(col, ok ? makeSeriesInfo(values, cellType) : null);
-	}
-	else for (let row = src.start.row; row <= src.end.row; row++) {
-		const values = [];
-		let cellType;
-		let ok = true;
-		for (let col = src.start.col; col <= src.end.col; col++) {
-			const num = readSeriesNumber(getCellData({
-				row,
-				col
-			}));
-			if (num == null) {
-				ok = false;
-				break;
-			}
-			values.push(num.value);
-			cellType = num.t;
-		}
-		seriesByLane.set(row, ok ? makeSeriesInfo(values, cellType) : null);
-	}
-	const items = [];
-	for (const addr of iterateRange(tgt)) {
-		const rowOffset = positiveMod(addr.row - src.start.row, srcRows);
-		const colOffset = positiveMod(addr.col - src.start.col, srcCols);
-		const srcAddr = {
-			row: src.start.row + rowOffset,
-			col: src.start.col + colOffset
-		};
-		const srcData = getCellData(srcAddr);
-		if (srcData?.f != null && srcData.f !== "") {
-			const deltaRow = addr.row - srcAddr.row;
-			const deltaCol = addr.col - srcAddr.col;
-			items.push({
-				addr,
-				data: { f: shiftFormulaRefs(srcData.f, deltaRow, deltaCol) }
-			});
-			continue;
-		}
-		const lane = vertical ? srcAddr.col : srcAddr.row;
-		const series = seriesByLane.get(lane);
-		if (series) {
-			const index = vertical ? addr.row - src.start.row : addr.col - src.start.col;
-			const value = series.first + index * series.delta;
-			items.push({
-				addr,
-				data: {
-					v: value,
-					t: series.t ?? "n"
-				}
-			});
-			continue;
-		}
-		items.push({
-			addr,
-			data: cloneCellData(srcData)
-		});
-	}
-	return items;
-}
-function makeSeriesInfo(values, t) {
-	const first = values[0];
-	if (values.length === 1) return {
-		first,
-		delta: 1,
-		t
-	};
-	return {
-		first,
-		delta: (values[values.length - 1] - first) / (values.length - 1),
-		t
-	};
-}
-/** 可参与等差序列的数字/日期格；公式格与其它类型返回 null */
-function readSeriesNumber(data) {
-	if (!data) return null;
-	if (data.f != null && data.f !== "") return null;
-	if (typeof data.v !== "number" || !Number.isFinite(data.v)) return null;
-	if (data.t != null && data.t !== "n" && data.t !== "d") return null;
-	return {
-		value: data.v,
-		t: data.t
-	};
-}
-function cloneCellData(data) {
-	if (!data) return void 0;
-	const cloned = {};
-	if (data.v !== void 0) cloned.v = data.v;
-	if (data.t !== void 0) cloned.t = data.t;
-	if (data.f !== void 0) cloned.f = data.f;
-	return cloned;
-}
-function positiveMod(n, mod) {
-	return (n % mod + mod) % mod;
-}
-/**
-* 公式引用字符串级位移：尊重 `$` 绝对行列；出界 → `#REF!`。
-* 跳过双引号字符串字面量，避免改写文本中的 A1 片段。
-*/
-function shiftFormulaRefs(formula, deltaRow, deltaCol) {
-	if (deltaRow === 0 && deltaCol === 0) return formula;
-	let result = "";
-	let i = 0;
-	while (i < formula.length) {
-		const ch = formula[i];
-		if (ch === "\"") {
-			const end = skipExcelString(formula, i);
-			result += formula.slice(i, end);
-			i = end;
-			continue;
-		}
-		const sheetMatch = matchSheetPrefix(formula, i);
-		const addrMatch = matchCellOrRange(formula, sheetMatch ? sheetMatch.end : i);
-		if (addrMatch && (sheetMatch || isRefBoundary(formula, i - 1))) {
-			const sheetPrefix = sheetMatch ? formula.slice(sheetMatch.start, sheetMatch.end) : "";
-			if (sheetMatch && !isRefBoundary(formula, sheetMatch.start - 1)) {
-				result += ch;
-				i++;
-				continue;
-			}
-			const shifted = shiftAddrPart(addrMatch.text, deltaRow, deltaCol);
-			result += sheetPrefix + shifted;
-			i = addrMatch.end;
-			continue;
-		}
-		result += ch;
-		i++;
-	}
-	return result;
-}
-function skipExcelString(text, start) {
-	let i = start + 1;
-	while (i < text.length) {
-		if (text[i] === "\"") {
-			if (text[i + 1] === "\"") {
-				i += 2;
-				continue;
-			}
-			return i + 1;
-		}
-		i++;
-	}
-	return text.length;
-}
-function matchSheetPrefix(text, start) {
-	if (text[start] === "'") {
-		let i = start + 1;
-		while (i < text.length) {
-			if (text[i] === "'") {
-				if (text[i + 1] === "'") {
-					i += 2;
-					continue;
-				}
-				if (text[i + 1] === "!") return {
-					start,
-					end: i + 2
-				};
-				return null;
-			}
-			i++;
-		}
-		return null;
-	}
-	if (!/[A-Za-z_]/.test(text[start] ?? "")) return null;
-	let i = start + 1;
-	while (i < text.length && /[\w.]/.test(text[i])) i++;
-	if (text[i] === "!") return {
-		start,
-		end: i + 1
-	};
-	return null;
-}
-const CELL_REF_RE = /^(\$?)([A-Za-z]+)(\$?)([1-9]\d*)/;
-function matchCellOrRange(text, start) {
-	const first = matchOneCell(text, start);
-	if (!first) return null;
-	if (text[first.end] === ":") {
-		const second = matchOneCell(text, first.end + 1);
-		if (!second) return {
-			text: first.text,
-			end: first.end
-		};
-		return {
-			text: text.slice(start, second.end),
-			end: second.end
-		};
-	}
-	return first;
-}
-function matchOneCell(text, start) {
-	const slice = text.slice(start);
-	const m = CELL_REF_RE.exec(slice);
-	if (!m) return null;
-	const end = start + m[0].length;
-	const next = text[end];
-	if (next && (/[A-Za-z]/.test(next) || next === "(")) return null;
-	return {
-		text: m[0],
-		end
-	};
-}
-function isRefBoundary(text, index) {
-	if (index < 0) return true;
-	const ch = text[index];
-	return !/[A-Za-z0-9_$]/.test(ch);
-}
-function shiftAddrPart(part, deltaRow, deltaCol) {
-	if (part.includes(":")) {
-		const [a, b] = part.split(":");
-		const left = shiftOneRef(a, deltaRow, deltaCol);
-		const right = shiftOneRef(b, deltaRow, deltaCol);
-		if (left === "#REF!" || right === "#REF!") return "#REF!";
-		return `${left}:${right}`;
-	}
-	return shiftOneRef(part, deltaRow, deltaCol);
-}
-function shiftOneRef(ref, deltaRow, deltaCol) {
-	const m = CELL_REF_RE.exec(ref);
-	if (!m) return ref;
-	const colAbs = m[1] === "$";
-	const rowAbs = m[3] === "$";
-	let col = colNameToIndex(m[2]);
-	let row = Number.parseInt(m[4], 10) - 1;
-	if (col < 0 || row < 0) return "#REF!";
-	if (!colAbs) col += deltaCol;
-	if (!rowAbs) row += deltaRow;
-	if (col < 0 || row < 0) return "#REF!";
-	return `${colAbs ? "$" : ""}${colIndexToName(col)}${rowAbs ? "$" : ""}${row + 1}`;
-}
-//#endregion
-export { computeFillTargetRange, generateFill, shiftFormulaRefs };
-
-//# sourceMappingURL=fill.js.map

package/dist/core/fill.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fill.js","names":[],"sources":["../../src/core/fill.ts"],"sourcesContent":["import type { CellAddress, CellRange } from './address'\nimport { colIndexToName, colNameToIndex, createRange, iterateRange } from './address'\nimport type { CellData, CellType } from './cell-store'\nimport type { SetCellValueItem } from './command/set-cell-value'\n\n/** 填充柄拖拽方向（与 VTable drag_fill_handle_end 一致） */\nexport type FillDirection = 'top' | 'bottom' | 'left' | 'right'\n\nexport interface GenerateFillOptions {\n  /** 拖拽前的源选区（模型坐标） */\n  source: CellRange\n  /** 需要写入的目标区（不含源区，模型坐标） */\n  target: CellRange\n  /** 填充方向 */\n  direction: FillDirection\n  /** 读取源区单元格（原始存储语义） */\n  getCellData: (addr: CellAddress) => CellData | undefined\n}\n\n/**\n * 由源选区 + 拖拽后扩展选区 + 方向，计算需要填充的目标区（模型坐标）。\n * 算法对齐 VTable 官方 fill-handle 示例（扩展选区含源区，目标为扩展部分）。\n */\nexport function computeFillTargetRange(\n  source: CellRange,\n  direction: FillDirection,\n  expanded: CellRange\n): CellRange | null {\n  const src = createRange(source.start, source.end)\n  const exp = createRange(expanded.start, expanded.end)\n\n  if (direction === 'bottom') {\n    if (exp.end.row <= src.end.row) return null\n    return {\n      start: { row: src.end.row + 1, col: src.start.col },\n      end: { row: exp.end.row, col: src.end.col }\n    }\n  }\n  if (direction === 'top') {\n    if (exp.start.row >= src.start.row) return null\n    return {\n      start: { row: exp.start.row, col: src.start.col },\n      end: { row: src.start.row - 1, col: src.end.col }\n    }\n  }\n  if (direction === 'right') {\n    if (exp.end.col <= src.end.col) return null\n    return {\n      start: { row: src.start.row, col: src.end.col + 1 },\n      end: { row: src.end.row, col: exp.end.col }\n    }\n  }\n  // left\n  if (exp.start.col >= src.start.col) return null\n  return {\n    start: { row: src.start.row, col: exp.start.col },\n    end: { row: src.end.row, col: src.start.col - 1 }\n  }\n}\n\n/**\n * 生成填充写入项（tile / 数字日期等差 / 公式相对引用位移）。\n * 调用方一次 `sheet.setCells(items)` 即可（单 undo 单元）。\n */\nexport function generateFill(options: GenerateFillOptions): SetCellValueItem[] {\n  const { source, target, direction, getCellData } = options\n  const src = createRange(source.start, source.end)\n  const tgt = createRange(target.start, target.end)\n  const srcRows = src.end.row - src.start.row + 1\n  const srcCols = src.end.col - src.start.col + 1\n  const vertical = direction === 'top' || direction === 'bottom'\n\n  const seriesByLane = new Map<number, SeriesInfo | null>()\n  if (vertical) {\n    for (let col = src.start.col; col <= src.end.col; col++) {\n      const values: number[] = []\n      let cellType: CellType | undefined\n      let ok = true\n      for (let row = src.start.row; row <= src.end.row; row++) {\n        const data = getCellData({ row, col })\n        const num = readSeriesNumber(data)\n        if (num == null) {\n          ok = false\n          break\n        }\n        values.push(num.value)\n        cellType = num.t\n      }\n      seriesByLane.set(col, ok ? makeSeriesInfo(values, cellType) : null)\n    }\n  } else {\n    for (let row = src.start.row; row <= src.end.row; row++) {\n      const values: number[] = []\n      let cellType: CellType | undefined\n      let ok = true\n      for (let col = src.start.col; col <= src.end.col; col++) {\n        const data = getCellData({ row, col })\n        const num = readSeriesNumber(data)\n        if (num == null) {\n          ok = false\n          break\n        }\n        values.push(num.value)\n        cellType = num.t\n      }\n      seriesByLane.set(row, ok ? makeSeriesInfo(values, cellType) : null)\n    }\n  }\n\n  const items: SetCellValueItem[] = []\n  for (const addr of iterateRange(tgt)) {\n    const rowOffset = positiveMod(addr.row - src.start.row, srcRows)\n    const colOffset = positiveMod(addr.col - src.start.col, srcCols)\n    const srcAddr: CellAddress = { row: src.start.row + rowOffset, col: src.start.col + colOffset }\n    const srcData = getCellData(srcAddr)\n\n    if (srcData?.f != null && srcData.f !== '') {\n      const deltaRow = addr.row - srcAddr.row\n      const deltaCol = addr.col - srcAddr.col\n      items.push({ addr, data: { f: shiftFormulaRefs(srcData.f, deltaRow, deltaCol) } })\n      continue\n    }\n\n    const lane = vertical ? srcAddr.col : srcAddr.row\n    const series = seriesByLane.get(lane)\n    if (series) {\n      const index = vertical ? addr.row - src.start.row : addr.col - src.start.col\n      const value = series.first + index * series.delta\n      items.push({ addr, data: { v: value, t: series.t ?? 'n' } })\n      continue\n    }\n\n    // tile 复制（含空格 → 清除）\n    items.push({ addr, data: cloneCellData(srcData) })\n  }\n  return items\n}\n\ninterface SeriesInfo {\n  first: number\n  delta: number\n  t?: CellType\n}\n\nfunction makeSeriesInfo(values: number[], t?: CellType): SeriesInfo {\n  const first = values[0]!\n  if (values.length === 1) {\n    return { first, delta: 1, t }\n  }\n  const delta = (values[values.length - 1]! - first) / (values.length - 1)\n  return { first, delta, t }\n}\n\n/** 可参与等差序列的数字/日期格；公式格与其它类型返回 null */\nfunction readSeriesNumber(data: CellData | undefined): { value: number; t?: CellType } | null {\n  if (!data) return null\n  if (data.f != null && data.f !== '') return null\n  if (typeof data.v !== 'number' || !Number.isFinite(data.v)) return null\n  if (data.t != null && data.t !== 'n' && data.t !== 'd') return null\n  return { value: data.v, t: data.t }\n}\n\nfunction cloneCellData(data: CellData | undefined): CellData | undefined {\n  if (!data) return undefined\n  const cloned: CellData = {}\n  if (data.v !== undefined) cloned.v = data.v\n  if (data.t !== undefined) cloned.t = data.t\n  if (data.f !== undefined) cloned.f = data.f\n  return cloned\n}\n\nfunction positiveMod(n: number, mod: number): number {\n  return ((n % mod) + mod) % mod\n}\n\n/**\n * 公式引用字符串级位移：尊重 `$` 绝对行列；出界 → `#REF!`。\n * 跳过双引号字符串字面量，避免改写文本中的 A1 片段。\n */\nexport function shiftFormulaRefs(formula: string, deltaRow: number, deltaCol: number): string {\n  if (deltaRow === 0 && deltaCol === 0) return formula\n\n  let result = ''\n  let i = 0\n  while (i < formula.length) {\n    const ch = formula[i]!\n    if (ch === '\"') {\n      const end = skipExcelString(formula, i)\n      result += formula.slice(i, end)\n      i = end\n      continue\n    }\n\n    const sheetMatch = matchSheetPrefix(formula, i)\n    const addrStart = sheetMatch ? sheetMatch.end : i\n    const addrMatch = matchCellOrRange(formula, addrStart)\n    if (addrMatch && (sheetMatch || isRefBoundary(formula, i - 1))) {\n      const sheetPrefix = sheetMatch ? formula.slice(sheetMatch.start, sheetMatch.end) : ''\n      // 有 sheet 前缀时，前缀前也需是边界\n      if (sheetMatch && !isRefBoundary(formula, sheetMatch.start - 1)) {\n        result += ch\n        i++\n        continue\n      }\n      const shifted = shiftAddrPart(addrMatch.text, deltaRow, deltaCol)\n      result += sheetPrefix + shifted\n      i = addrMatch.end\n      continue\n    }\n\n    result += ch\n    i++\n  }\n  return result\n}\n\nfunction skipExcelString(text: string, start: number): number {\n  // start 指向开引号；Excel 字符串内 \"\" 为转义\n  let i = start + 1\n  while (i < text.length) {\n    if (text[i] === '\"') {\n      if (text[i + 1] === '\"') {\n        i += 2\n        continue\n      }\n      return i + 1\n    }\n    i++\n  }\n  return text.length\n}\n\nfunction matchSheetPrefix(text: string, start: number): { start: number; end: number } | null {\n  if (text[start] === \"'\") {\n    let i = start + 1\n    while (i < text.length) {\n      if (text[i] === \"'\") {\n        if (text[i + 1] === \"'\") {\n          i += 2\n          continue\n        }\n        if (text[i + 1] === '!') {\n          return { start, end: i + 2 }\n        }\n        return null\n      }\n      i++\n    }\n    return null\n  }\n\n  // 简单表名：字母/下划线开头\n  if (!/[A-Za-z_]/.test(text[start] ?? '')) return null\n  let i = start + 1\n  while (i < text.length && /[\\w.]/.test(text[i]!)) i++\n  if (text[i] === '!') return { start, end: i + 1 }\n  return null\n}\n\nconst CELL_REF_RE = /^(\\$?)([A-Za-z]+)(\\$?)([1-9]\\d*)/\n\nfunction matchCellOrRange(text: string, start: number): { text: string; end: number } | null {\n  const first = matchOneCell(text, start)\n  if (!first) return null\n  if (text[first.end] === ':') {\n    const second = matchOneCell(text, first.end + 1)\n    if (!second) return { text: first.text, end: first.end }\n    return { text: text.slice(start, second.end), end: second.end }\n  }\n  return first\n}\n\nfunction matchOneCell(text: string, start: number): { text: string; end: number } | null {\n  const slice = text.slice(start)\n  const m = CELL_REF_RE.exec(slice)\n  if (!m) return null\n  const end = start + m[0].length\n  const next = text[end]\n  // 行号后紧跟字母 → 不是 A1；紧跟 `(` → 函数名（如 LOG10(）\n  if (next && (/[A-Za-z]/.test(next) || next === '(')) return null\n  return { text: m[0], end }\n}\n\nfunction isRefBoundary(text: string, index: number): boolean {\n  if (index < 0) return true\n  const ch = text[index]!\n  // 引用前不能是字母/数字（避免 FOOA1）；`!` 已由 sheet 前缀消费\n  return !/[A-Za-z0-9_$]/.test(ch)\n}\n\nfunction shiftAddrPart(part: string, deltaRow: number, deltaCol: number): string {\n  if (part.includes(':')) {\n    const [a, b] = part.split(':')\n    const left = shiftOneRef(a!, deltaRow, deltaCol)\n    const right = shiftOneRef(b!, deltaRow, deltaCol)\n    if (left === '#REF!' || right === '#REF!') return '#REF!'\n    return `${left}:${right}`\n  }\n  return shiftOneRef(part, deltaRow, deltaCol)\n}\n\nfunction shiftOneRef(ref: string, deltaRow: number, deltaCol: number): string {\n  const m = CELL_REF_RE.exec(ref)\n  if (!m) return ref\n  const colAbs = m[1] === '$'\n  const rowAbs = m[3] === '$'\n  let col = colNameToIndex(m[2]!)\n  let row = Number.parseInt(m[4]!, 10) - 1\n  if (col < 0 || row < 0) return '#REF!'\n  if (!colAbs) col += deltaCol\n  if (!rowAbs) row += deltaRow\n  if (col < 0 || row < 0) return '#REF!'\n  return `${colAbs ? '$' : ''}${colIndexToName(col)}${rowAbs ? '$' : ''}${row + 1}`\n}\n"],"mappings":"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"}

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

@@ -1,58 +0,0 @@
-import { CellAddress, CellRange } from "../address.js";
-//#region src/core/formula/ast.d.ts
-/**
- * 公式 AST 节点。
- * 引用节点携带可选 sheet 名（跨表引用）；缺省 = 公式所在 sheet。
- */
-type BinaryOperator = '+' | '-' | '*' | '/' | '^' | '&' | '=' | '<>' | '<' | '<=' | '>' | '>=';
-type AstNode = {
-  kind: 'number';
-  value: number;
-} | {
-  kind: 'string';
-  value: string;
-} | {
-  kind: 'boolean';
-  value: boolean;
-} |
-/** 未知名称（如裸写的 Sheet2 / 未定义命名）；求值为 #NAME? */
-{
-  kind: 'name';
-  name: string;
-} | {
-  kind: 'cell';
-  sheet?: string;
-  addr: CellAddress;
-} | {
-  kind: 'range';
-  sheet?: string;
-  range: CellRange;
-} | {
-  kind: 'unary';
-  op: '-' | '+';
-  operand: AstNode;
-} |
-/** 百分号后缀运算（除以 100） */
-{
-  kind: 'percent';
-  operand: AstNode;
-} | {
-  kind: 'binary';
-  op: BinaryOperator;
-  left: AstNode;
-  right: AstNode;
-} | {
-  kind: 'call';
-  name: string;
-  args: AstNode[];
-};
-/** 公式中的引用（依赖图提取用）：sheet 缺省由所属公式节点补齐 */
-interface AstReference {
-  sheet?: string;
-  range: CellRange;
-}
-/** 遍历 AST，收集全部引用（单格视为 1×1 区域） */
-declare function collectReferences(node: AstNode, out?: AstReference[]): AstReference[];
-//#endregion
-export { AstNode, AstReference, BinaryOperator, collectReferences };
-//# sourceMappingURL=ast.d.ts.map

package/dist/core/formula/ast.js

@@ -1,38 +0,0 @@
-//#region src/core/formula/ast.ts
-/** 遍历 AST，收集全部引用（单格视为 1×1 区域） */
-function collectReferences(node, out = []) {
-	switch (node.kind) {
-		case "cell":
-			out.push({
-				sheet: node.sheet,
-				range: {
-					start: node.addr,
-					end: node.addr
-				}
-			});
-			break;
-		case "range":
-			out.push({
-				sheet: node.sheet,
-				range: node.range
-			});
-			break;
-		case "unary":
-		case "percent":
-			collectReferences(node.operand, out);
-			break;
-		case "binary":
-			collectReferences(node.left, out);
-			collectReferences(node.right, out);
-			break;
-		case "call":
-			for (const arg of node.args) collectReferences(arg, out);
-			break;
-		default: break;
-	}
-	return out;
-}
-//#endregion
-export { collectReferences };
-
-//# sourceMappingURL=ast.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ast.js","names":[],"sources":["../../../src/core/formula/ast.ts"],"sourcesContent":["import type { CellAddress, CellRange } from '../address'\n\n/**\n * 公式 AST 节点。\n * 引用节点携带可选 sheet 名（跨表引用）；缺省 = 公式所在 sheet。\n */\n\nexport type BinaryOperator =\n  | '+'\n  | '-'\n  | '*'\n  | '/'\n  | '^'\n  | '&'\n  | '='\n  | '<>'\n  | '<'\n  | '<='\n  | '>'\n  | '>='\n\nexport type AstNode =\n  | { kind: 'number'; value: number }\n  | { kind: 'string'; value: string }\n  | { kind: 'boolean'; value: boolean }\n  /** 未知名称（如裸写的 Sheet2 / 未定义命名）；求值为 #NAME? */\n  | { kind: 'name'; name: string }\n  | { kind: 'cell'; sheet?: string; addr: CellAddress }\n  | { kind: 'range'; sheet?: string; range: CellRange }\n  | { kind: 'unary'; op: '-' | '+'; operand: AstNode }\n  /** 百分号后缀运算（除以 100） */\n  | { kind: 'percent'; operand: AstNode }\n  | { kind: 'binary'; op: BinaryOperator; left: AstNode; right: AstNode }\n  | { kind: 'call'; name: string; args: AstNode[] }\n\n/** 公式中的引用（依赖图提取用）：sheet 缺省由所属公式节点补齐 */\nexport interface AstReference {\n  sheet?: string\n  range: CellRange\n}\n\n/** 遍历 AST，收集全部引用（单格视为 1×1 区域） */\nexport function collectReferences(node: AstNode, out: AstReference[] = []): AstReference[] {\n  switch (node.kind) {\n    case 'cell':\n      out.push({ sheet: node.sheet, range: { start: node.addr, end: node.addr } })\n      break\n    case 'range':\n      out.push({ sheet: node.sheet, range: node.range })\n      break\n    case 'unary':\n    case 'percent':\n      collectReferences(node.operand, out)\n      break\n    case 'binary':\n      collectReferences(node.left, out)\n      collectReferences(node.right, out)\n      break\n    case 'call':\n      for (const arg of node.args) collectReferences(arg, out)\n      break\n    default:\n      break\n  }\n  return out\n}\n"],"mappings":";;AA0CA,SAAgB,kBAAkB,MAAe,MAAsB,CAAC,GAAmB;CACzF,QAAQ,KAAK,MAAb;EACE,KAAK;GACH,IAAI,KAAK;IAAE,OAAO,KAAK;IAAO,OAAO;KAAE,OAAO,KAAK;KAAM,KAAK,KAAK;IAAK;GAAE,CAAC;GAC3E;EACF,KAAK;GACH,IAAI,KAAK;IAAE,OAAO,KAAK;IAAO,OAAO,KAAK;GAAM,CAAC;GACjD;EACF,KAAK;EACL,KAAK;GACH,kBAAkB,KAAK,SAAS,GAAG;GACnC;EACF,KAAK;GACH,kBAAkB,KAAK,MAAM,GAAG;GAChC,kBAAkB,KAAK,OAAO,GAAG;GACjC;EACF,KAAK;GACH,KAAK,MAAM,OAAO,KAAK,MAAM,kBAAkB,KAAK,GAAG;GACvD;EACF,SACE;CACJ;CACA,OAAO;AACT"}

package/dist/core/formula/dependency-graph.d.ts

@@ -1,70 +0,0 @@
-import { CellAddress, CellRange } from "../address.js";
-import { CellData } from "../cell-store.js";
-import { AstNode } from "./ast.js";
-import { Sheet } from "../sheet.js";
-import { CellPatch } from "../command/types.js";
-//#region src/core/formula/dependency-graph.d.ts
-/**
- * 依赖图（工作簿级计算中枢）：
- * - sheet 注册表：跨表引用按名解析（不存在 → #REF!）
- * - 正向索引：公式格 → 引用格集合（节点 deps）；反向索引：引用格 → 依赖者
- *   （单格引用走 cellKey 精确索引 O(1)，区域引用走线性扫描）
- * - 变更时标脏（向上 BFS 收集全部依赖者）+ 拓扑序增量重算（递归向下，memo 去重）
- * - 循环引用检测：求值在途栈遇回边 → 环上所有格 #CYCLE!；依赖环外格只传播错误，
- *   打破循环（编辑环上格）后经标脏重算自动恢复
- *
- * 图状态与单元格存储严格同步：所有 f 变更（命令/undo/redo/rollback 回放）都经
- * Sheet.applyPatch → syncCell 维护节点；重算只发生在命令执行后（见 Sheet.executeCommand），
- * undo/redo 靠派生补丁精确回放缓存值，不重算。
- */
-/** 公式节点的一个依赖（sheet 名已补齐为具体值） */
-interface FormulaDependency {
-  sheetName: string;
-  range: CellRange;
-}
-/** 公式节点（依赖图管理的公式格状态；依赖图外部只读使用） */
-interface FormulaNode {
-  readonly sheetName: string;
-  readonly addr: CellAddress;
-  readonly formula: string;
-  /** null = 解析失败（求值 #ERROR!，无依赖） */
-  readonly ast: AstNode | null;
-  readonly deps: FormulaDependency[];
-  /** 反向索引清理器（removeNode 时执行） */
-  readonly cleanups: (() => void)[];
-}
-declare class DependencyGraph {
-  private readonly sheets;
-  /** 正向索引宿主：sheetName → cellKey → 公式节点 */
-  private readonly nodes;
-  /** 反向索引（单格引用）：sheetName → cellKey → 依赖者集合 */
-  private readonly exact;
-  /** 反向索引（区域引用）：sheetName → { 区域, 依赖者 } 集合（线性扫描） */
-  private readonly ranged;
-  registerSheet(sheet: Sheet): void;
-  /** 注销 sheet 并移除其全部公式节点（引用它的公式在下次重算时得 #REF!） */
-  unregisterSheet(sheet: Sheet): void;
-  getSheet(name: string): Sheet | undefined;
-  getNode(sheetName: string, addr: CellAddress): FormulaNode | undefined;
-  /** 公式节点总数（测试/调试用） */
-  get nodeCount(): number;
-  /**
-   * 单元格补丁后的图同步：f 增/删/改 → 节点增/删/重建。
-   * 由 Sheet.applyPatch（唯一变更通道）调用，命令与 undo/redo 回放均覆盖。
-   */
-  syncCell(sheet: Sheet, addr: CellAddress, before?: CellData, after?: CellData): void;
-  /**
-   * 变更集 → 标脏 + 拓扑序重算 → 派生补丁（未应用）。
-   * 调用方（Sheet.executeCommand）负责应用补丁并并入同一 undo 单元。
-   */
-  recalc(changed: readonly {
-    sheet: Sheet;
-    addr: CellAddress;
-  }[]): CellPatch[];
-  private addNode;
-  private removeNode;
-  private dependentsOf;
-}
-//#endregion
-export { DependencyGraph, FormulaDependency, FormulaNode };
-//# sourceMappingURL=dependency-graph.d.ts.map