@dou-ui/sheet 0.0.0-stage → 0.1.0-alpha.1

package/dist/formula/parse.js

@@ -0,0 +1,369 @@
+import { splitSheet } from "../core/address.js";
+import { ERROR_CODES } from "./error.js";
+// src/formula/parse.ts
+/** Thrown for text that isn't a formula; it shows as `#ERROR!`. */
+var SheetFormulaSyntaxError = class extends Error {
+	at;
+	constructor(message, at) {
+		super(message);
+		this.at = at;
+	}
+};
+var END = "(?![\\p{L}\\p{N}_(!.])";
+var SHEET = "(?:('(?:[^']|'')+'|[\\p{L}_][\\p{L}\\p{N}_.]*)!)?";
+var REF = new RegExp(SHEET + "(?:(\\$?[a-z]{1,3}\\$?[1-9]\\d{0,6})(?::(\\$?[a-z]{1,3}\\$?[1-9]\\d{0,6}))?|(\\$?[a-z]{1,3}):(\\$?[a-z]{1,3})|(\\$?[1-9]\\d{0,6}):(\\$?[1-9]\\d{0,6}))" + END, "iuy");
+var SHEET_ERROR = new RegExp(`${SHEET}#REF!`, "iuy");
+var NUMBER = /(?:\d+(?:\.\d*)?|\.\d+)(?:e[-+]?\d+)?/iy;
+var NAME = /[\p{L}_][\p{L}\p{N}_.]*/uy;
+var NAME_START = /[\p{L}_]/u;
+var OPS = /* @__PURE__ */ new Set([
+	"+",
+	"-",
+	"*",
+	"/",
+	"^",
+	"&",
+	"=",
+	"<",
+	">",
+	"%",
+	"(",
+	")",
+	",",
+	";"
+]);
+/** One end of a reference, `$B$3`, `B` or `3`, read by hand: this runs for every reference. */
+function readEnd(text) {
+	let i = text.charCodeAt(0) === 36 ? 1 : 0;
+	let col = -1;
+	for (let c = text.charCodeAt(i); (c | 32) >= 97 && (c | 32) <= 122; c = text.charCodeAt(++i)) col = (col + 1) * 26 + (c | 32) - 97;
+	if (text.charCodeAt(i) === 36) i++;
+	const row = i < text.length ? Number(text.slice(i)) - 1 : -1;
+	return {
+		col: col === -1 ? void 0 : col,
+		row: row === -1 ? void 0 : row
+	};
+}
+function readRef(match) {
+	const sheet = match[1] ? splitSheet(`${match[1]}!`).sheet : void 0;
+	const first = match[2] != null ? 0 : match[4] != null ? 2 : 4;
+	const a = readEnd(match[first + 2]);
+	const to = match[first + 3];
+	const b = to != null ? readEnd(to) : a;
+	const node = {
+		type: "ref",
+		top: Math.min(a.row ?? 0, b.row ?? 0),
+		left: Math.min(a.col ?? 0, b.col ?? 0),
+		bottom: a.row == null ? Infinity : Math.max(a.row, b.row),
+		right: a.col == null ? Infinity : Math.max(a.col, b.col),
+		cell: first === 0 && to == null
+	};
+	if (sheet != null) node.sheet = sheet;
+	return node;
+}
+function tokenize(text, loose = false) {
+	const tokens = [];
+	let i = 0;
+	const push = (token, length) => {
+		tokens.push({
+			...token,
+			end: token.at + length
+		});
+		i = token.at + length;
+	};
+	const at = (re) => {
+		re.lastIndex = i;
+		return re.exec(text);
+	};
+	while (i < text.length) {
+		const char = text[i];
+		if (char === " " || /\s/.test(char)) {
+			i++;
+			continue;
+		}
+		if (char === "\"") {
+			let value = "";
+			let j = i + 1;
+			for (;; j++) {
+				if (j >= text.length) {
+					if (!loose) throw new SheetFormulaSyntaxError("Text without its closing quote", i);
+					break;
+				}
+				if (text[j] === "\"") {
+					if (text[j + 1] === "\"") {
+						value += "\"";
+						j++;
+					} else break;
+				} else value += text[j];
+			}
+			push({
+				kind: "text",
+				value,
+				at: i
+			}, Math.min(j + 1, text.length) - i);
+			continue;
+		}
+		if (char === "#") {
+			const code = ERROR_CODES.find((c) => text.startsWith(c, i) || text.toUpperCase().startsWith(c, i));
+			if (code) {
+				push({
+					kind: "error",
+					code,
+					at: i
+				}, code.length);
+				continue;
+			}
+			if (!loose) throw new SheetFormulaSyntaxError("Unknown error value", i);
+			push({
+				kind: "op",
+				value: char,
+				at: i
+			}, 1);
+			continue;
+		}
+		const ref = OPS.has(char) ? null : at(REF);
+		if (ref) {
+			push({
+				kind: "ref",
+				node: readRef(ref),
+				at: i
+			}, ref[0].length);
+			continue;
+		}
+		const refError = char === "'" || NAME_START.test(char) ? at(SHEET_ERROR) : null;
+		if (refError) {
+			push({
+				kind: "error",
+				code: "#REF!",
+				at: i
+			}, refError[0].length);
+			continue;
+		}
+		const number = char >= "0" && char <= "9" || char === "." ? at(NUMBER) : null;
+		if (number) {
+			push({
+				kind: "number",
+				value: Number(number[0]),
+				at: i
+			}, number[0].length);
+			continue;
+		}
+		const name = at(NAME);
+		if (name) {
+			push({
+				kind: "name",
+				value: name[0],
+				at: i
+			}, name[0].length);
+			continue;
+		}
+		const two = text.slice(i, i + 2);
+		const op = two === "<>" || two === "<=" || two === ">=" ? two : OPS.has(char) ? char : void 0;
+		if (!op && !loose) throw new SheetFormulaSyntaxError(`Unexpected "${char}"`, i);
+		push({
+			kind: "op",
+			value: op ?? char,
+			at: i
+		}, (op ?? char).length);
+	}
+	tokens.push({
+		kind: "end",
+		at: text.length,
+		end: text.length
+	});
+	return tokens;
+}
+/**
+* The pieces of a formula, also one being typed and not finished, e.g. for
+* coloring it: numbers, "text", names (of functions), references,
+* operators and brackets, and error values. Spaces are left out.
+*/
+function formulaTokens(formula) {
+	const offset = formula.startsWith("=") ? 1 : 0;
+	const text = formula.slice(offset);
+	const out = [];
+	for (const token of tokenize(text, true)) {
+		if (token.kind === "end") break;
+		const start = token.at + offset;
+		const end = token.end + offset;
+		const piece = formula.slice(start, end);
+		if (token.kind === "ref") out.push({
+			kind: "ref",
+			start,
+			end,
+			text: piece,
+			ref: token.node
+		});
+		else out.push({
+			kind: token.kind,
+			start,
+			end,
+			text: piece
+		});
+	}
+	return out;
+}
+var BINARY = {
+	"=": [1, "="],
+	"<>": [1, "<>"],
+	"<": [1, "<"],
+	">": [1, ">"],
+	"<=": [1, "<="],
+	">=": [1, ">="],
+	"&": [2, "&"],
+	"+": [3, "+"],
+	"-": [3, "-"],
+	"*": [4, "*"],
+	"/": [4, "/"],
+	"^": [5, "^"]
+};
+/**
+* Reads a formula, with or without its `=`, into a tree. Throws
+* `SheetFormulaSyntaxError` for text that isn't one.
+*/
+function parseFormula(formula) {
+	const tokens = tokenize(formula.startsWith("=") ? formula.slice(1) : formula);
+	let pos = 0;
+	const peek = () => tokens[pos];
+	const isOp = (value) => {
+		const t = peek();
+		return t.kind === "op" && t.value === value;
+	};
+	const expect = (value) => {
+		if (!isOp(value)) throw new SheetFormulaSyntaxError(`Expected "${value}"`, peek().at);
+		pos++;
+	};
+	function expression(min) {
+		let left = prefix();
+		for (;;) {
+			const t = peek();
+			if (t.kind !== "op") break;
+			const binary = BINARY[t.value];
+			if (!binary || binary[0] < min) break;
+			pos++;
+			const right = expression(binary[0] + 1);
+			left = {
+				type: "binary",
+				op: binary[1],
+				left,
+				right
+			};
+		}
+		return left;
+	}
+	function prefix() {
+		const t = peek();
+		if (t.kind === "op" && (t.value === "-" || t.value === "+")) {
+			pos++;
+			return {
+				type: "unary",
+				op: t.value,
+				arg: prefix()
+			};
+		}
+		let node = primary();
+		while (isOp("%")) {
+			pos++;
+			node = {
+				type: "unary",
+				op: "%",
+				arg: node
+			};
+		}
+		return node;
+	}
+	function primary() {
+		const t = peek();
+		pos++;
+		switch (t.kind) {
+			case "number": return {
+				type: "number",
+				value: t.value
+			};
+			case "text": return {
+				type: "text",
+				value: t.value
+			};
+			case "error": return {
+				type: "error",
+				code: t.code
+			};
+			case "ref": return t.node;
+			case "name": {
+				if (isOp("(")) {
+					pos++;
+					const args = [];
+					if (isOp(")")) pos++;
+					else for (;;) {
+						const n = peek();
+						args.push(n.kind === "op" && (n.value === "," || n.value === ";" || n.value === ")") ? { type: "empty" } : expression(1));
+						if (isOp(",") || isOp(";")) pos++;
+						else {
+							expect(")");
+							break;
+						}
+					}
+					return {
+						type: "call",
+						name: t.value.toUpperCase(),
+						args
+					};
+				}
+				const upper = t.value.toUpperCase();
+				if (upper === "TRUE" || upper === "FALSE") return {
+					type: "boolean",
+					value: upper === "TRUE"
+				};
+				return {
+					type: "error",
+					code: "#NAME?"
+				};
+			}
+			case "op":
+				if (t.value === "(") {
+					const inner = expression(1);
+					expect(")");
+					return inner;
+				}
+				throw new SheetFormulaSyntaxError(`Unexpected "${t.value}"`, t.at);
+			default: throw new SheetFormulaSyntaxError("The formula ends too soon", t.at);
+		}
+	}
+	if (peek().kind === "end") throw new SheetFormulaSyntaxError("The formula is empty", 0);
+	const node = expression(1);
+	if (peek().kind !== "end") throw new SheetFormulaSyntaxError("Unexpected text", peek().at);
+	return node;
+}
+/** Every reference in a formula tree. */
+function referencesOf(node, out = []) {
+	switch (node.type) {
+		case "ref":
+			out.push(node);
+			break;
+		case "call":
+			for (const arg of node.args) referencesOf(arg, out);
+			break;
+		case "unary":
+			referencesOf(node.arg, out);
+			break;
+		case "binary":
+			referencesOf(node.left, out);
+			referencesOf(node.right, out);
+	}
+	return out;
+}
+/** The functions a formula calls, in capitals. */
+function functionsOf(node, out = /* @__PURE__ */ new Set()) {
+	if (node.type === "call") {
+		out.add(node.name);
+		for (const arg of node.args) functionsOf(arg, out);
+	} else if (node.type === "unary") functionsOf(node.arg, out);
+	else if (node.type === "binary") {
+		functionsOf(node.left, out);
+		functionsOf(node.right, out);
+	}
+	return out;
+}
+export { SheetFormulaSyntaxError, formulaTokens, functionsOf, parseFormula, referencesOf };
+
+//# sourceMappingURL=parse.js.map

package/dist/formula/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","names":[],"sources":["../../src/formula/parse.ts"],"sourcesContent":["import { splitSheet } from '../core/address'\nimport { ERROR_CODES, type SheetErrorCode } from './error'\n\n/*\n * Formulas as a tree. The text after `=` is read the usual way: numbers,\n * \"text\" (with \"\" for a quote), TRUE / FALSE, error values, references\n * (`A1`, `$A$1`, `A1:B9`, `B:D`, `2:3`, `'表 2'!A1`), function calls,\n * and operators by precedence from loosest to tightest: comparison\n * (= <> < > <= >=), & (joining text), + -, * /, ^, % after a value, and a\n * sign before it. A sign binds tighter than ^, so `-2^2` is 4.\n */\n\nexport type SheetFormulaNode =\n  | { type: 'number'; value: number }\n  | { type: 'text'; value: string }\n  | { type: 'boolean'; value: boolean }\n  | { type: 'error'; code: SheetErrorCode }\n  /**\n   * A reference, with its sheet as written (unquoted); whole columns run\n   * from row 0 to `Infinity`, whole rows likewise. `cell` is a single cell.\n   */\n  | {\n      type: 'ref'\n      sheet?: string\n      top: number\n      left: number\n      bottom: number\n      right: number\n      cell: boolean\n    }\n  /** A function call; `name` in capitals. */\n  | { type: 'call'; name: string; args: SheetFormulaNode[] }\n  | { type: 'unary'; op: '-' | '+' | '%'; arg: SheetFormulaNode }\n  | { type: 'binary'; op: BinaryOp; left: SheetFormulaNode; right: SheetFormulaNode }\n  /** An argument left out, as in `IF(A1,,1)`. */\n  | { type: 'empty' }\n\nexport type BinaryOp = '+' | '-' | '*' | '/' | '^' | '&' | '=' | '<>' | '<' | '>' | '<=' | '>='\n\n/** Thrown for text that isn't a formula; it shows as `#ERROR!`. */\nexport class SheetFormulaSyntaxError extends Error {\n  constructor(\n    message: string,\n    readonly at: number,\n  ) {\n    super(message)\n  }\n}\n\ntype Token = (\n  | { kind: 'number'; value: number }\n  | { kind: 'text'; value: string }\n  | { kind: 'error'; code: SheetErrorCode }\n  | { kind: 'ref'; node: Extract<SheetFormulaNode, { type: 'ref' }> }\n  | { kind: 'name'; value: string }\n  | { kind: 'op'; value: string }\n  | { kind: 'end' }\n) & { at: number; end: number }\n\nconst END = '(?![\\\\p{L}\\\\p{N}_(!.])'\nconst SHEET = \"(?:('(?:[^']|'')+'|[\\\\p{L}_][\\\\p{L}\\\\p{N}_.]*)!)?\"\nconst REF = new RegExp(\n  SHEET +\n    '(?:(\\\\$?[a-z]{1,3}\\\\$?[1-9]\\\\d{0,6})(?::(\\\\$?[a-z]{1,3}\\\\$?[1-9]\\\\d{0,6}))?' +\n    '|(\\\\$?[a-z]{1,3}):(\\\\$?[a-z]{1,3})' +\n    '|(\\\\$?[1-9]\\\\d{0,6}):(\\\\$?[1-9]\\\\d{0,6}))' +\n    END,\n  'iuy',\n)\nconst SHEET_ERROR = new RegExp(`${SHEET}#REF!`, 'iuy')\nconst NUMBER = /(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:e[-+]?\\d+)?/iy\nconst NAME = /[\\p{L}_][\\p{L}\\p{N}_.]*/uy\nconst NAME_START = /[\\p{L}_]/u\nconst OPS = new Set(['+', '-', '*', '/', '^', '&', '=', '<', '>', '%', '(', ')', ',', ';'])\n\n/** One end of a reference, `$B$3`, `B` or `3`, read by hand: this runs for every reference. */\nfunction readEnd(text: string) {\n  let i = text.charCodeAt(0) === 36 ? 1 : 0\n  let col = -1\n  for (let c = text.charCodeAt(i); (c | 32) >= 97 && (c | 32) <= 122; c = text.charCodeAt(++i))\n    col = (col + 1) * 26 + (c | 32) - 97\n  if (text.charCodeAt(i) === 36) i++\n  const row = i < text.length ? Number(text.slice(i)) - 1 : -1\n  return { col: col === -1 ? undefined : col, row: row === -1 ? undefined : row }\n}\n\nfunction readRef(match: RegExpExecArray): Extract<SheetFormulaNode, { type: 'ref' }> {\n  const sheet = match[1] ? splitSheet(`${match[1]}!`).sheet : undefined\n  const first = match[2] != null ? 0 : match[4] != null ? 2 : 4\n  const a = readEnd(match[first + 2]!)\n  const to = match[first + 3]\n  const b = to != null ? readEnd(to) : a\n  const top = Math.min(a.row ?? 0, b.row ?? 0)\n  const left = Math.min(a.col ?? 0, b.col ?? 0)\n  const bottom = a.row == null ? Infinity : Math.max(a.row, b.row!)\n  const right = a.col == null ? Infinity : Math.max(a.col, b.col!)\n  const node: Extract<SheetFormulaNode, { type: 'ref' }> = {\n    type: 'ref',\n    top,\n    left,\n    bottom,\n    right,\n    cell: first === 0 && to == null,\n  }\n  if (sheet != null) node.sheet = sheet\n  return node\n}\n\n/** Splits a formula into tokens; `loose` reads what isn't a formula yet too, as while typing. */\n/** A token before its end is known; per kind, so each keeps its own fields. */\ntype WithoutEnd<T> = T extends unknown ? Omit<T, 'end'> : never\n\nfunction tokenize(text: string, loose = false): Token[] {\n  const tokens: Token[] = []\n  let i = 0\n  const push = (token: WithoutEnd<Token>, length: number) => {\n    tokens.push({ ...token, end: token.at + length } as Token)\n    i = token.at + length\n  }\n  const at = (re: RegExp) => {\n    re.lastIndex = i\n    return re.exec(text)\n  }\n  while (i < text.length) {\n    const char = text[i]!\n    if (char === ' ' || /\\s/.test(char)) {\n      i++\n      continue\n    }\n    if (char === '\"') {\n      let value = ''\n      let j = i + 1\n      for (; ; j++) {\n        if (j >= text.length) {\n          if (!loose) throw new SheetFormulaSyntaxError('Text without its closing quote', i)\n          break\n        }\n        if (text[j] === '\"') {\n          if (text[j + 1] === '\"') {\n            value += '\"'\n            j++\n          } else break\n        } else value += text[j]\n      }\n      push({ kind: 'text', value, at: i }, Math.min(j + 1, text.length) - i)\n      continue\n    }\n    if (char === '#') {\n      const code = ERROR_CODES.find(\n        (c) => text.startsWith(c, i) || text.toUpperCase().startsWith(c, i),\n      )\n      if (code) {\n        push({ kind: 'error', code, at: i }, code.length)\n        continue\n      }\n      if (!loose) throw new SheetFormulaSyntaxError('Unknown error value', i)\n      push({ kind: 'op', value: char, at: i }, 1)\n      continue\n    }\n    // a reference starts with a letter, `$`, a quote, or a digit for rows (`2:3`)\n    const ref = OPS.has(char) ? null : at(REF)\n    if (ref) {\n      push({ kind: 'ref', node: readRef(ref), at: i }, ref[0].length)\n      continue\n    }\n    const refError = char === \"'\" || NAME_START.test(char) ? at(SHEET_ERROR) : null\n    if (refError) {\n      push({ kind: 'error', code: '#REF!', at: i }, refError[0].length)\n      continue\n    }\n    const number = (char >= '0' && char <= '9') || char === '.' ? at(NUMBER) : null\n    if (number) {\n      push({ kind: 'number', value: Number(number[0]), at: i }, number[0].length)\n      continue\n    }\n    const name = at(NAME)\n    if (name) {\n      push({ kind: 'name', value: name[0], at: i }, name[0].length)\n      continue\n    }\n    const two = text.slice(i, i + 2)\n    const op = two === '<>' || two === '<=' || two === '>=' ? two : OPS.has(char) ? char : undefined\n    if (!op && !loose) throw new SheetFormulaSyntaxError(`Unexpected \"${char}\"`, i)\n    push({ kind: 'op', value: op ?? char, at: i }, (op ?? char).length)\n  }\n  tokens.push({ kind: 'end', at: text.length, end: text.length })\n  return tokens\n}\n\n/** A piece of a formula as written, with where it is in the text (counting the `=`). */\nexport type SheetFormulaToken =\n  | { kind: 'number' | 'text' | 'name' | 'op' | 'error'; start: number; end: number; text: string }\n  | {\n      kind: 'ref'\n      start: number\n      end: number\n      text: string\n      ref: Extract<SheetFormulaNode, { type: 'ref' }>\n    }\n\n/**\n * The pieces of a formula, also one being typed and not finished, e.g. for\n * coloring it: numbers, \"text\", names (of functions), references,\n * operators and brackets, and error values. Spaces are left out.\n */\nexport function formulaTokens(formula: string): SheetFormulaToken[] {\n  const offset = formula.startsWith('=') ? 1 : 0\n  const text = formula.slice(offset)\n  const out: SheetFormulaToken[] = []\n  for (const token of tokenize(text, true)) {\n    if (token.kind === 'end') break\n    const start = token.at + offset\n    const end = token.end + offset\n    const piece = formula.slice(start, end)\n    if (token.kind === 'ref') out.push({ kind: 'ref', start, end, text: piece, ref: token.node })\n    else out.push({ kind: token.kind, start, end, text: piece })\n  }\n  return out\n}\n\nconst BINARY: Record<string, [number, BinaryOp]> = {\n  '=': [1, '='],\n  '<>': [1, '<>'],\n  '<': [1, '<'],\n  '>': [1, '>'],\n  '<=': [1, '<='],\n  '>=': [1, '>='],\n  '&': [2, '&'],\n  '+': [3, '+'],\n  '-': [3, '-'],\n  '*': [4, '*'],\n  '/': [4, '/'],\n  '^': [5, '^'],\n}\n\n/**\n * Reads a formula, with or without its `=`, into a tree. Throws\n * `SheetFormulaSyntaxError` for text that isn't one.\n */\nexport function parseFormula(formula: string): SheetFormulaNode {\n  const text = formula.startsWith('=') ? formula.slice(1) : formula\n  const tokens = tokenize(text)\n  let pos = 0\n  const peek = () => tokens[pos]!\n  const isOp = (value: string) => {\n    const t = peek()\n    return t.kind === 'op' && t.value === value\n  }\n  const expect = (value: string) => {\n    if (!isOp(value)) throw new SheetFormulaSyntaxError(`Expected \"${value}\"`, peek().at)\n    pos++\n  }\n\n  function expression(min: number): SheetFormulaNode {\n    let left = prefix()\n    for (;;) {\n      const t = peek()\n      if (t.kind !== 'op') break\n      const binary = BINARY[t.value]\n      if (!binary || binary[0] < min) break\n      pos++\n      // ^ is left to right too, as spreadsheet programs read `2^3^2`\n      const right = expression(binary[0] + 1)\n      left = { type: 'binary', op: binary[1], left, right }\n    }\n    return left\n  }\n\n  function prefix(): SheetFormulaNode {\n    const t = peek()\n    if (t.kind === 'op' && (t.value === '-' || t.value === '+')) {\n      pos++\n      return { type: 'unary', op: t.value, arg: prefix() }\n    }\n    let node = primary()\n    while (isOp('%')) {\n      pos++\n      node = { type: 'unary', op: '%', arg: node }\n    }\n    return node\n  }\n\n  function primary(): SheetFormulaNode {\n    const t = peek()\n    pos++\n    switch (t.kind) {\n      case 'number':\n        return { type: 'number', value: t.value }\n      case 'text':\n        return { type: 'text', value: t.value }\n      case 'error':\n        return { type: 'error', code: t.code }\n      case 'ref':\n        return t.node\n      case 'name': {\n        if (isOp('(')) {\n          pos++\n          const args: SheetFormulaNode[] = []\n          if (isOp(')')) pos++\n          else\n            for (;;) {\n              const n = peek()\n              args.push(\n                n.kind === 'op' && (n.value === ',' || n.value === ';' || n.value === ')')\n                  ? { type: 'empty' }\n                  : expression(1),\n              )\n              if (isOp(',') || isOp(';')) pos++\n              else {\n                expect(')')\n                break\n              }\n            }\n          return { type: 'call', name: t.value.toUpperCase(), args }\n        }\n        const upper = t.value.toUpperCase()\n        if (upper === 'TRUE' || upper === 'FALSE')\n          return { type: 'boolean', value: upper === 'TRUE' }\n        return { type: 'error', code: '#NAME?' }\n      }\n      case 'op':\n        if (t.value === '(') {\n          const inner = expression(1)\n          expect(')')\n          return inner\n        }\n        throw new SheetFormulaSyntaxError(`Unexpected \"${t.value}\"`, t.at)\n      default:\n        throw new SheetFormulaSyntaxError('The formula ends too soon', t.at)\n    }\n  }\n\n  if (peek().kind === 'end') throw new SheetFormulaSyntaxError('The formula is empty', 0)\n  const node = expression(1)\n  if (peek().kind !== 'end') throw new SheetFormulaSyntaxError('Unexpected text', peek().at)\n  return node\n}\n\n/** Every reference in a formula tree. */\nexport function referencesOf(\n  node: SheetFormulaNode,\n  out: Extract<SheetFormulaNode, { type: 'ref' }>[] = [],\n) {\n  switch (node.type) {\n    case 'ref':\n      out.push(node)\n      break\n    case 'call':\n      for (const arg of node.args) referencesOf(arg, out)\n      break\n    case 'unary':\n      referencesOf(node.arg, out)\n      break\n    case 'binary':\n      referencesOf(node.left, out)\n      referencesOf(node.right, out)\n      break\n  }\n  return out\n}\n\n/** The functions a formula calls, in capitals. */\nexport function functionsOf(node: SheetFormulaNode, out = new Set<string>()) {\n  if (node.type === 'call') {\n    out.add(node.name)\n    for (const arg of node.args) functionsOf(arg, out)\n  } else if (node.type === 'unary') functionsOf(node.arg, out)\n  else if (node.type === 'binary') {\n    functionsOf(node.left, out)\n    functionsOf(node.right, out)\n  }\n  return out\n}\n"],"mappings":"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"}

package/dist/formula/values.js

@@ -0,0 +1,123 @@
+import { generalNumber, parseInput } from "../core/format.js";
+import { VALUE, isSheetError } from "./error.js";
+// src/formula/values.ts
+var isRange = (arg) => typeof arg === "object" && arg !== null && arg.kind === "range";
+var DATE = /^(\d{4})-(\d{2})-(\d{2})(?:[ T](\d{2}):(\d{2})(?::(\d{2}))?)?$/;
+var TIME = /^(\d{2}):(\d{2})(?::(\d{2}))?$/;
+var EPOCH = Date.UTC(1899, 11, 30);
+var DAY = 864e5;
+/** Whether a value is a date (or date and time) as cells write them. */
+var isDateText = (value) => typeof value === "string" && DATE.test(value);
+/** Whether a value is a time of day as cells write it, such as `09:30`. */
+var isTimeText = (value) => typeof value === "string" && TIME.test(value);
+/** A date or time written in a cell as a day number (a time as part of a day); `null` when it isn't one. */
+function serialOf(text) {
+	const date = DATE.exec(text);
+	if (date) {
+		const [, y, m, d, h = "0", min = "0", s = "0"] = date;
+		return (Date.UTC(+y, +m - 1, +d, +h, +min, +s) - EPOCH) / DAY;
+	}
+	const time = TIME.exec(text);
+	if (time) return (+time[1] * 3600 + +time[2] * 60 + +(time[3] ?? 0)) / 86400;
+	return null;
+}
+var pad = (n) => String(n).padStart(2, "0");
+/** A day number as a date, with its time when it has a part of a day. */
+function dateText(serial) {
+	const ms = Math.round((serial * DAY + EPOCH) / 1e3) * 1e3;
+	const d = new Date(ms);
+	const day = `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}`;
+	if (!(d.getUTCHours() * 3600 + d.getUTCMinutes() * 60 + d.getUTCSeconds())) return day;
+	const time = `${pad(d.getUTCHours())}:${pad(d.getUTCMinutes())}`;
+	return d.getUTCSeconds() ? `${day} ${time}:${pad(d.getUTCSeconds())}` : `${day} ${time}`;
+}
+/** A part of a day as `hh:mm`, or `hh:mm:ss` with seconds; a whole day and more wraps round. */
+function timeText(fraction) {
+	const seconds = Math.round((fraction % 1 + 1) % 1 * 86400) % 86400;
+	const h = Math.floor(seconds / 3600);
+	const m = Math.floor(seconds % 3600 / 60);
+	const sec = seconds % 60;
+	return sec ? `${pad(h)}:${pad(m)}:${pad(sec)}` : `${pad(h)}:${pad(m)}`;
+}
+/** A part of a day as a time; a whole day or more, or below nothing, stays a number of days. */
+var timeOrDays = (days) => days >= 0 && days < 1 ? timeText(days) : days;
+/** The parts of a date, from a date or a day number; `null` when it is neither. */
+function dateParts(value) {
+	const serial = typeof value === "number" ? value : typeof value === "string" ? serialOf(value) : null;
+	if (serial == null) return null;
+	const d = new Date(Math.floor(serial) * DAY + EPOCH);
+	return {
+		year: d.getUTCFullYear(),
+		month: d.getUTCMonth() + 1,
+		day: d.getUTCDate(),
+		serial
+	};
+}
+/**
+* A value as a number: `TRUE` is 1, an empty cell 0, text that reads as a
+* number (`12`, `1,280`, `12%`) or a date its number; other text is
+* `#VALUE!`. Errors pass through.
+*/
+function toNumber(value) {
+	if (typeof value === "number") return value;
+	if (value == null) return 0;
+	if (typeof value === "boolean") return value ? 1 : 0;
+	if (isSheetError(value)) return value;
+	const trimmed = value.trim();
+	if (trimmed === "") return VALUE;
+	const serial = serialOf(trimmed);
+	if (serial != null) return serial;
+	const read = parseInput(trimmed).value;
+	return typeof read === "number" ? read : VALUE;
+}
+/** A value as text: numbers as a cell shows them without a format, `TRUE` / `FALSE`. */
+function toText(value) {
+	if (value == null) return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number") return generalNumber(value);
+	if (typeof value === "boolean") return value ? "TRUE" : "FALSE";
+	return value;
+}
+/** A value as `TRUE` / `FALSE`: numbers are true unless 0; text `TRUE` / `FALSE` reads as such. */
+function toBoolean(value) {
+	if (typeof value === "boolean") return value;
+	if (value == null) return false;
+	if (typeof value === "number") return value !== 0;
+	if (isSheetError(value)) return value;
+	const upper = value.trim().toUpperCase();
+	if (upper === "TRUE") return true;
+	if (upper === "FALSE") return false;
+	return VALUE;
+}
+/**
+* Compares two values the way formulas do: numbers by size, text by
+* letters ignoring case, `FALSE` before `TRUE`; numbers come before text,
+* and text before `TRUE` / `FALSE`. An empty cell is 0, or "" next to text.
+*/
+function compareValues(a, b) {
+	if (a == null) a = typeof b === "string" ? "" : typeof b === "boolean" ? false : 0;
+	if (b == null) b = typeof a === "string" ? "" : typeof a === "boolean" ? false : 0;
+	const rank = (v) => typeof v === "number" ? 0 : typeof v === "string" ? 1 : 2;
+	const ra = rank(a);
+	const rb = rank(b);
+	if (ra !== rb) return ra - rb;
+	if (typeof a === "number") return a - b;
+	if (typeof a === "string") {
+		const x = a.toLowerCase();
+		const y = b.toLowerCase();
+		return x < y ? -1 : x > y ? 1 : 0;
+	}
+	return Number(a) - Number(b);
+}
+/**
+* A cell's value as it shows: for a formula, its result from `result`
+* (an error as its code, such as `#N/A`), when given.
+*/
+function shownValue(value, result, row, col) {
+	if (!result || typeof value !== "string" || !value.startsWith("=")) return value;
+	const out = result(row, col);
+	return isSheetError(out) ? out.code : out;
+}
+export { compareValues, dateParts, dateText, isDateText, isRange, isTimeText, serialOf, shownValue, timeOrDays, timeText, toBoolean, toNumber, toText };
+
+//# sourceMappingURL=values.js.map

package/dist/formula/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","names":[],"sources":["../../src/formula/values.ts"],"sourcesContent":["import { generalNumber, parseInput } from '../core/format'\nimport type { SheetValue } from '../core/model'\nimport { isSheetError, VALUE, type SheetError } from './error'\n\n/**\n * What a formula gives: a number, text, `TRUE` / `FALSE`, nothing (an\n * empty cell), or an error. Dates are text written `2026-03-05` (or\n * `2026-03-05 09:30`), as cells hold them.\n */\nexport type SheetResult = number | string | boolean | null | SheetError\n\n/** A range a function is given: its cells, as their values or their formulas' results. */\nexport interface SheetRangeArg {\n  readonly kind: 'range'\n  /** Its size, kept inside the sheet: `A:A` is as tall as the sheet. */\n  readonly rows: number\n  readonly cols: number\n  /** The cell at a row and column counted from the range's top left, from 0. */\n  at(row: number, col: number): SheetResult\n  /**\n   * The cells with something in them, row by row, with where they are.\n   * Empty cells are left out, so a whole column costs only its data.\n   */\n  entries(): Iterable<[row: number, col: number, value: SheetResult]>\n}\n\n/** What a function is given for each argument: a value, or a range for a reference to more than one cell. */\nexport type SheetArg = SheetResult | SheetRangeArg\n\nexport const isRange = (arg: unknown): arg is SheetRangeArg =>\n  typeof arg === 'object' && arg !== null && (arg as SheetRangeArg).kind === 'range'\n\n// Dates as day numbers, counted the usual way from 1899-12-30, so date\n// arithmetic and functions agree with other spreadsheet programs.\n\nconst DATE = /^(\\d{4})-(\\d{2})-(\\d{2})(?:[ T](\\d{2}):(\\d{2})(?::(\\d{2}))?)?$/\nconst TIME = /^(\\d{2}):(\\d{2})(?::(\\d{2}))?$/\nconst EPOCH = Date.UTC(1899, 11, 30)\nconst DAY = 86_400_000\n\n/** Whether a value is a date (or date and time) as cells write them. */\nexport const isDateText = (value: unknown): value is string =>\n  typeof value === 'string' && DATE.test(value)\n\n/** Whether a value is a time of day as cells write it, such as `09:30`. */\nexport const isTimeText = (value: unknown): value is string =>\n  typeof value === 'string' && TIME.test(value)\n\n/** A date or time written in a cell as a day number (a time as part of a day); `null` when it isn't one. */\nexport function serialOf(text: string): number | null {\n  const date = DATE.exec(text)\n  if (date) {\n    const [, y, m, d, h = '0', min = '0', s = '0'] = date\n    const ms = Date.UTC(+y!, +m! - 1, +d!, +h, +min, +s)\n    return (ms - EPOCH) / DAY\n  }\n  const time = TIME.exec(text)\n  if (time) return (+time[1]! * 3600 + +time[2]! * 60 + +(time[3] ?? 0)) / 86_400\n  return null\n}\n\nconst pad = (n: number) => String(n).padStart(2, '0')\n\n/** A day number as a date, with its time when it has a part of a day. */\nexport function dateText(serial: number) {\n  const ms = Math.round((serial * DAY + EPOCH) / 1000) * 1000\n  const d = new Date(ms)\n  const day = `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}`\n  const seconds = d.getUTCHours() * 3600 + d.getUTCMinutes() * 60 + d.getUTCSeconds()\n  if (!seconds) return day\n  const time = `${pad(d.getUTCHours())}:${pad(d.getUTCMinutes())}`\n  return d.getUTCSeconds() ? `${day} ${time}:${pad(d.getUTCSeconds())}` : `${day} ${time}`\n}\n\n/** A part of a day as `hh:mm`, or `hh:mm:ss` with seconds; a whole day and more wraps round. */\nexport function timeText(fraction: number) {\n  const seconds = Math.round((((fraction % 1) + 1) % 1) * 86_400) % 86_400\n  const h = Math.floor(seconds / 3600)\n  const m = Math.floor((seconds % 3600) / 60)\n  const sec = seconds % 60\n  return sec ? `${pad(h)}:${pad(m)}:${pad(sec)}` : `${pad(h)}:${pad(m)}`\n}\n\n/** A part of a day as a time; a whole day or more, or below nothing, stays a number of days. */\nexport const timeOrDays = (days: number): number | string =>\n  days >= 0 && days < 1 ? timeText(days) : days\n\n/** The parts of a date, from a date or a day number; `null` when it is neither. */\nexport function dateParts(value: SheetResult) {\n  const serial =\n    typeof value === 'number' ? value : typeof value === 'string' ? serialOf(value) : null\n  if (serial == null) return null\n  const d = new Date(Math.floor(serial) * DAY + EPOCH)\n  return { year: d.getUTCFullYear(), month: d.getUTCMonth() + 1, day: d.getUTCDate(), serial }\n}\n\n/**\n * A value as a number: `TRUE` is 1, an empty cell 0, text that reads as a\n * number (`12`, `1,280`, `12%`) or a date its number; other text is\n * `#VALUE!`. Errors pass through.\n */\nexport function toNumber(value: SheetResult): number | SheetError {\n  if (typeof value === 'number') return value\n  if (value == null) return 0\n  if (typeof value === 'boolean') return value ? 1 : 0\n  if (isSheetError(value)) return value\n  const trimmed = value.trim()\n  if (trimmed === '') return VALUE\n  const serial = serialOf(trimmed)\n  if (serial != null) return serial\n  const read = parseInput(trimmed).value\n  return typeof read === 'number' ? read : VALUE\n}\n\n/** A value as text: numbers as a cell shows them without a format, `TRUE` / `FALSE`. */\nexport function toText(value: SheetResult): string | SheetError {\n  if (value == null) return ''\n  if (typeof value === 'string') return value\n  if (typeof value === 'number') return generalNumber(value)\n  if (typeof value === 'boolean') return value ? 'TRUE' : 'FALSE'\n  return value\n}\n\n/** A value as `TRUE` / `FALSE`: numbers are true unless 0; text `TRUE` / `FALSE` reads as such. */\nexport function toBoolean(value: SheetResult): boolean | SheetError {\n  if (typeof value === 'boolean') return value\n  if (value == null) return false\n  if (typeof value === 'number') return value !== 0\n  if (isSheetError(value)) return value\n  const upper = value.trim().toUpperCase()\n  if (upper === 'TRUE') return true\n  if (upper === 'FALSE') return false\n  return VALUE\n}\n\n/**\n * Compares two values the way formulas do: numbers by size, text by\n * letters ignoring case, `FALSE` before `TRUE`; numbers come before text,\n * and text before `TRUE` / `FALSE`. An empty cell is 0, or \"\" next to text.\n */\nexport function compareValues(a: SheetResult, b: SheetResult): number {\n  if (a == null) a = typeof b === 'string' ? '' : typeof b === 'boolean' ? false : 0\n  if (b == null) b = typeof a === 'string' ? '' : typeof a === 'boolean' ? false : 0\n  const rank = (v: SheetResult) => (typeof v === 'number' ? 0 : typeof v === 'string' ? 1 : 2)\n  const ra = rank(a)\n  const rb = rank(b)\n  if (ra !== rb) return ra - rb\n  if (typeof a === 'number') return a - (b as number)\n  if (typeof a === 'string') {\n    const x = a.toLowerCase()\n    const y = (b as string).toLowerCase()\n    return x < y ? -1 : x > y ? 1 : 0\n  }\n  return Number(a) - Number(b)\n}\n\n/**\n * A cell's value as it shows: for a formula, its result from `result`\n * (an error as its code, such as `#N/A`), when given.\n */\nexport function shownValue(\n  value: SheetValue,\n  result: ((row: number, col: number) => SheetResult) | undefined,\n  row: number,\n  col: number,\n): SheetValue {\n  if (!result || typeof value !== 'string' || !value.startsWith('=')) return value\n  const out = result(row, col)\n  return isSheetError(out) ? out.code : out\n}\n"],"mappings":";;;AA6BA,IAAa,WAAW,QACtB,OAAO,QAAQ,YAAY,QAAQ,QAAS,IAAsB,SAAS;AAK7E,IAAM,OAAO;AACb,IAAM,OAAO;AACb,IAAM,QAAQ,KAAK,IAAI,MAAM,IAAI,EAAE;AACnC,IAAM,MAAM;;AAGZ,IAAa,cAAc,UACzB,OAAO,UAAU,YAAY,KAAK,KAAK,KAAK;;AAG9C,IAAa,cAAc,UACzB,OAAO,UAAU,YAAY,KAAK,KAAK,KAAK;;AAG9C,SAAgB,SAAS,MAA6B;CACpD,MAAM,OAAO,KAAK,KAAK,IAAI;CAC3B,IAAI,MAAM;EACR,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,KAAK,MAAM,KAAK,IAAI,OAAO;EAEjD,QADW,KAAK,IAAI,CAAC,GAAI,CAAC,IAAK,GAAG,CAAC,GAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAC1C,IAAK,SAAS;CACxB;CACA,MAAM,OAAO,KAAK,KAAK,IAAI;CAC3B,IAAI,MAAM,QAAQ,CAAC,KAAK,KAAM,OAAO,CAAC,KAAK,KAAM,KAAK,EAAE,KAAK,MAAM,MAAM;CACzE,OAAO;AACT;AAEA,IAAM,OAAO,MAAc,OAAO,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;;AAGpD,SAAgB,SAAS,QAAgB;CACvC,MAAM,KAAK,KAAK,OAAO,SAAS,MAAM,SAAS,GAAI,IAAI;CACvD,MAAM,IAAI,IAAI,KAAK,EAAE;CACrB,MAAM,MAAM,GAAG,EAAE,eAAe,EAAE,GAAG,IAAI,EAAE,YAAY,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,CAAC;CAEnF,IAAI,EADY,EAAE,YAAY,IAAI,OAAO,EAAE,cAAc,IAAI,KAAK,EAAE,cAAc,IACpE,OAAO;CACrB,MAAM,OAAO,GAAG,IAAI,EAAE,YAAY,CAAC,EAAE,GAAG,IAAI,EAAE,cAAc,CAAC;CAC7D,OAAO,EAAE,cAAc,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,EAAE,cAAc,CAAC,MAAM,GAAG,IAAI,GAAG;AACpF;;AAGA,SAAgB,SAAS,UAAkB;CACzC,MAAM,UAAU,KAAK,OAAS,WAAW,IAAK,KAAK,IAAK,KAAM,IAAI;CAClE,MAAM,IAAI,KAAK,MAAM,UAAU,IAAI;CACnC,MAAM,IAAI,KAAK,MAAO,UAAU,OAAQ,EAAE;CAC1C,MAAM,MAAM,UAAU;CACtB,OAAO,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;AACrE;;AAGA,IAAa,cAAc,SACzB,QAAQ,KAAK,OAAO,IAAI,SAAS,IAAI,IAAI;;AAG3C,SAAgB,UAAU,OAAoB;CAC5C,MAAM,SACJ,OAAO,UAAU,WAAW,QAAQ,OAAO,UAAU,WAAW,SAAS,KAAK,IAAI;CACpF,IAAI,UAAU,MAAM,OAAO;CAC3B,MAAM,IAAI,IAAI,KAAK,KAAK,MAAM,MAAM,IAAI,MAAM,KAAK;CACnD,OAAO;EAAE,MAAM,EAAE,eAAe;EAAG,OAAO,EAAE,YAAY,IAAI;EAAG,KAAK,EAAE,WAAW;EAAG;CAAO;AAC7F;;;;;;AAOA,SAAgB,SAAS,OAAyC;CAChE,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI,SAAS,MAAM,OAAO;CAC1B,IAAI,OAAO,UAAU,WAAW,OAAO,QAAQ,IAAI;CACnD,IAAI,aAAa,KAAK,GAAG,OAAO;CAChC,MAAM,UAAU,MAAM,KAAK;CAC3B,IAAI,YAAY,IAAI,OAAO;CAC3B,MAAM,SAAS,SAAS,OAAO;CAC/B,IAAI,UAAU,MAAM,OAAO;CAC3B,MAAM,OAAO,WAAW,OAAO,CAAC,CAAC;CACjC,OAAO,OAAO,SAAS,WAAW,OAAO;AAC3C;;AAGA,SAAgB,OAAO,OAAyC;CAC9D,IAAI,SAAS,MAAM,OAAO;CAC1B,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI,OAAO,UAAU,UAAU,OAAO,cAAc,KAAK;CACzD,IAAI,OAAO,UAAU,WAAW,OAAO,QAAQ,SAAS;CACxD,OAAO;AACT;;AAGA,SAAgB,UAAU,OAA0C;CAClE,IAAI,OAAO,UAAU,WAAW,OAAO;CACvC,IAAI,SAAS,MAAM,OAAO;CAC1B,IAAI,OAAO,UAAU,UAAU,OAAO,UAAU;CAChD,IAAI,aAAa,KAAK,GAAG,OAAO;CAChC,MAAM,QAAQ,MAAM,KAAK,CAAC,CAAC,YAAY;CACvC,IAAI,UAAU,QAAQ,OAAO;CAC7B,IAAI,UAAU,SAAS,OAAO;CAC9B,OAAO;AACT;;;;;;AAOA,SAAgB,cAAc,GAAgB,GAAwB;CACpE,IAAI,KAAK,MAAM,IAAI,OAAO,MAAM,WAAW,KAAK,OAAO,MAAM,YAAY,QAAQ;CACjF,IAAI,KAAK,MAAM,IAAI,OAAO,MAAM,WAAW,KAAK,OAAO,MAAM,YAAY,QAAQ;CACjF,MAAM,QAAQ,MAAoB,OAAO,MAAM,WAAW,IAAI,OAAO,MAAM,WAAW,IAAI;CAC1F,MAAM,KAAK,KAAK,CAAC;CACjB,MAAM,KAAK,KAAK,CAAC;CACjB,IAAI,OAAO,IAAI,OAAO,KAAK;CAC3B,IAAI,OAAO,MAAM,UAAU,OAAO,IAAK;CACvC,IAAI,OAAO,MAAM,UAAU;EACzB,MAAM,IAAI,EAAE,YAAY;EACxB,MAAM,IAAK,EAAa,YAAY;EACpC,OAAO,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI;CAClC;CACA,OAAO,OAAO,CAAC,IAAI,OAAO,CAAC;AAC7B;;;;;AAMA,SAAgB,WACd,OACA,QACA,KACA,KACY;CACZ,IAAI,CAAC,UAAU,OAAO,UAAU,YAAY,CAAC,MAAM,WAAW,GAAG,GAAG,OAAO;CAC3E,MAAM,MAAM,OAAO,KAAK,GAAG;CAC3B,OAAO,aAAa,GAAG,IAAI,IAAI,OAAO;AACxC"}

package/dist/formulas.js

@@ -0,0 +1,30 @@
+import { SheetFormulaEngine } from "./formula/engine.js";
+import { shallowRef, toRaw, toValue, triggerRef, watch } from "vue";
+// src/formulas.ts
+/**
+* Works out a workbook's formulas outside the grid, such as for totals
+* shown above it. `book` is the workbook bound to the grid's `v-model`.
+*/
+function useSheetFormulas(book, options) {
+	const read = () => toRaw(toValue(book));
+	const engine = shallowRef(new SheetFormulaEngine(read(), options));
+	watch(read, (doc) => {
+		if (doc === engine.value.doc) return;
+		engine.value.load(doc);
+		triggerRef(engine);
+	});
+	return {
+		result: ((sheet, at, col) => typeof at === "number" ? engine.value.result(sheet, at, col) : engine.value.result(sheet, at)),
+		evaluate: (formula, sheet) => engine.value.evaluate(formula, sheet),
+		update: (change) => {
+			engine.value.update(change);
+			triggerRef(engine);
+		},
+		get engine() {
+			return engine.value;
+		}
+	};
+}
+export { useSheetFormulas };
+
+//# sourceMappingURL=formulas.js.map

package/dist/formulas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formulas.js","names":[],"sources":["../src/formulas.ts"],"sourcesContent":["import { shallowRef, toRaw, toValue, triggerRef, watch, type MaybeRefOrGetter } from 'vue'\nimport type { SheetCellTarget } from './core/address'\nimport type { SheetWorkbook } from './core/model'\nimport {\n  SheetFormulaEngine,\n  type SheetFormulaChange,\n  type SheetFormulaEngineOptions,\n} from './formula/engine'\nimport type { SheetResult } from './formula/values'\n\n/** The results of a workbook's formulas, read reactively. */\nexport interface SheetFormulas {\n  /**\n   * A cell's result, as `SheetFormulaEngine.result` gives it. Read in a\n   * `computed` or a template, it is read again when the workbook changes.\n   */\n  result: {\n    (sheet: string | number, cell: SheetCellTarget): SheetResult\n    (sheet: string | number, row: number, col: number): SheetResult\n  }\n  /** Works out a formula without writing it into a cell, reactively too. */\n  evaluate: (formula: string, sheet?: string | number) => SheetResult\n  /**\n   * Catches up with a change of the grid: pass it the `transaction` event\n   * (`@transaction=\"formulas.update\"`), and only the formulas the change\n   * reaches are worked out again. Without it, every change of the workbook\n   * works all of them out again.\n   */\n  update: (change: SheetFormulaChange) => void\n  /** The engine underneath. */\n  readonly engine: SheetFormulaEngine\n}\n\n/**\n * Works out a workbook's formulas outside the grid, such as for totals\n * shown above it. `book` is the workbook bound to the grid's `v-model`.\n */\nexport function useSheetFormulas(\n  book: MaybeRefOrGetter<SheetWorkbook>,\n  options?: SheetFormulaEngineOptions,\n): SheetFormulas {\n  // the plain workbook: the grid's transactions start from it, not from a proxy\n  const read = () => toRaw(toValue(book))\n  const engine = shallowRef(new SheetFormulaEngine(read(), options))\n  // a workbook the engine doesn't have yet (replaced from outside, or\n  // changed without `update`): start over with it\n  watch(read, (doc) => {\n    if (doc === engine.value.doc) return\n    engine.value.load(doc)\n    triggerRef(engine)\n  })\n  return {\n    result: ((sheet: string | number, at: SheetCellTarget | number, col?: number) =>\n      typeof at === 'number'\n        ? engine.value.result(sheet, at, col!)\n        : engine.value.result(sheet, at)) as SheetFormulas['result'],\n    evaluate: (formula, sheet) => engine.value.evaluate(formula, sheet),\n    update: (change) => {\n      engine.value.update(change)\n      triggerRef(engine)\n    },\n    get engine() {\n      return engine.value\n    },\n  }\n}\n"],"mappings":";;;;;;;AAqCA,SAAgB,iBACd,MACA,SACe;CAEf,MAAM,aAAa,MAAM,QAAQ,IAAI,CAAC;CACtC,MAAM,SAAS,WAAW,IAAI,mBAAmB,KAAK,GAAG,OAAO,CAAC;CAGjE,MAAM,OAAO,QAAQ;EACnB,IAAI,QAAQ,OAAO,MAAM,KAAK;EAC9B,OAAO,MAAM,KAAK,GAAG;EACrB,WAAW,MAAM;CACnB,CAAC;CACD,OAAO;EACL,UAAU,OAAwB,IAA8B,QAC9D,OAAO,OAAO,WACV,OAAO,MAAM,OAAO,OAAO,IAAI,GAAI,IACnC,OAAO,MAAM,OAAO,OAAO,EAAE;EACnC,WAAW,SAAS,UAAU,OAAO,MAAM,SAAS,SAAS,KAAK;EAClE,SAAS,WAAW;GAClB,OAAO,MAAM,OAAO,MAAM;GAC1B,WAAW,MAAM;EACnB;EACA,IAAI,SAAS;GACX,OAAO,OAAO;EAChB;CACF;AACF"}

package/dist/index.js

@@ -0,0 +1,39 @@
+import { boundsOf, columnIndex, columnName, dropReferences, formatCell, formatRange, moveReferences, parseCell, parseRange, quoteSheet, renameReferences, renameReferencesAll, shiftFormula, splitSheet } from "./core/address.js";
+import { changeDecimals, formatValue, parseInput } from "./core/format.js";
+import { cellOf, valueOf } from "./core/model.js";
+import { SheetError, isSheetError } from "./formula/error.js";
+import { compareValues, dateText, serialOf, toBoolean, toNumber, toText } from "./formula/values.js";
+import { detectDelimiter, parseCSV, readCSV, sheetToCSV } from "./core/csv.js";
+import { linkTarget } from "./core/link.js";
+import { formatClip, parseClip, parseTSV } from "./core/clipboard.js";
+import { continueValues, fillContinues } from "./core/fill.js";
+import { defineSheetExtension, resolveSheetExtensions } from "./core/extension.js";
+import { defineSheetCellType, optionOf, resolveCellType } from "./core/cell-type.js";
+import { checkWorkbook, emptyWorkbook, migrateWorkbook } from "./core/document.js";
+import { defineSheetCommand } from "./core/commands.js";
+import { compareForSort, meetsRule, sortRows, textCollator } from "./core/data.js";
+import { SheetTransaction, applySheetSteps, compactSheetSteps, sheetKey } from "./core/transaction.js";
+import { keepCommentAnchors, sheetCommentAnchors } from "./core/comments.js";
+import { diffWorkbooks, restoreWorkbook } from "./core/versions.js";
+import { criteriaOf, defineSheetFunction, numbersOf, scalarOf } from "./formula/functions.js";
+import { lightThemeColor, plainStyle } from "./core/paint.js";
+import { sheetLocales, sheetMessagesFor } from "./locale.js";
+import { isSelected, selectCell } from "./core/selection.js";
+import { checkProtection, isLocked, protectionOf } from "./core/protect.js";
+import { sheetContextKey, useSheet } from "./context.js";
+import { useSheetMessages } from "./use-messages.js";
+import { SheetFileError, createFileSource, csvExporter, csvImporter, defineSheetExporter, defineSheetImporter, exportWorkbook, readWorkbook } from "./core/file.js";
+import sheet_default from "./sheet.js";
+import sheet_tabs_default from "./components/sheet-tabs.js";
+import sheet_toolbar_default from "./components/sheet-toolbar.js";
+import sheet_formula_bar_default from "./components/sheet-formula-bar.js";
+import { useSheetFormulas } from "./formulas.js";
+import { withInstall } from "dou-ui";
+// src/index.ts
+var DouSheet = withInstall(sheet_default);
+var DouSheetTabs = withInstall(sheet_tabs_default);
+var DouSheetToolbar = withInstall(sheet_toolbar_default);
+var DouSheetFormulaBar = withInstall(sheet_formula_bar_default);
+export { DouSheet, DouSheet as default, DouSheetFormulaBar, DouSheetTabs, DouSheetToolbar, SheetError, SheetFileError, SheetTransaction, applySheetSteps, boundsOf, cellOf, changeDecimals, checkProtection, checkWorkbook, columnIndex, columnName, compactSheetSteps, compareForSort, compareValues, continueValues, createFileSource, criteriaOf, csvExporter, csvImporter, dateText, defineSheetCellType, defineSheetCommand, defineSheetExporter, defineSheetExtension, defineSheetFunction, defineSheetImporter, detectDelimiter, diffWorkbooks, dropReferences, emptyWorkbook, exportWorkbook, fillContinues, formatCell, formatClip, formatRange, formatValue, isLocked, isSelected, isSheetError, keepCommentAnchors, lightThemeColor, linkTarget, meetsRule, migrateWorkbook, moveReferences, numbersOf, optionOf, parseCSV, parseCell, parseClip, parseInput, parseRange, parseTSV, plainStyle, protectionOf, quoteSheet, readCSV, readWorkbook, renameReferences, renameReferencesAll, resolveCellType, resolveSheetExtensions, restoreWorkbook, scalarOf, selectCell, serialOf, sheetCommentAnchors, sheetContextKey, sheetKey, sheetLocales, sheetMessagesFor, sheetToCSV, shiftFormula, sortRows, splitSheet, textCollator, toBoolean, toNumber, toText, useSheet, useSheetFormulas, useSheetMessages, valueOf };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["Sheet","SheetTabs","SheetToolbar","SheetFormulaBar"],"sources":["../src/index.ts"],"sourcesContent":["import { withInstall } from 'dou-ui'\nimport Sheet from './sheet.vue'\nimport SheetTabs from './components/sheet-tabs.vue'\nimport SheetToolbar from './components/sheet-toolbar.vue'\nimport SheetFormulaBar from './components/sheet-formula-bar.vue'\n\nexport const DouSheet = withInstall(Sheet)\nexport const DouSheetTabs = withInstall(SheetTabs)\nexport const DouSheetToolbar = withInstall(SheetToolbar)\nexport const DouSheetFormulaBar = withInstall(SheetFormulaBar)\nexport default DouSheet\n\nexport { useSheet, sheetContextKey } from './context'\nexport { useSheetFormulas } from './formulas'\nexport type { SheetFormulas } from './formulas'\nexport type {\n  SheetContext,\n  SheetEditInputOptions,\n  SheetEditorContext,\n  SheetRangeRect,\n  SheetRect,\n} from './context'\nexport { defineSheetExtension, resolveSheetExtensions } from './core/extension'\nexport type {\n  ResolvedSheetExtensions,\n  SheetExtension,\n  SheetExtensionContext,\n  SheetCommentsProvider,\n  SheetHistoryHandler,\n  SheetKeyHandler,\n  SheetUpdate,\n} from './core/extension'\nexport { keepCommentAnchors, sheetCommentAnchors } from './core/comments'\nexport { diffWorkbooks, restoreWorkbook } from './core/versions'\nexport type { SheetCellChange, WorkbookDiff } from './core/versions'\nexport type { SheetCommentAnchor } from './core/comments'\nexport { defineSheetCommand } from './core/commands'\nexport {\n  createFileSource,\n  csvExporter,\n  csvImporter,\n  defineSheetExporter,\n  defineSheetImporter,\n  SheetFileError,\n  exportWorkbook,\n  readWorkbook,\n} from './core/file'\nexport type {\n  SheetCSVExportOptions,\n  SheetExporter,\n  SheetExporterInfo,\n  SheetExportScope,\n  SheetExportWorkbookOptions,\n  SheetFileSheet,\n  SheetFileSource,\n  SheetFileSourceOptions,\n  SheetFileView,\n  SheetImportContext,\n  SheetImporter,\n  SheetImporterInfo,\n  SheetImportResult,\n  SheetImportWarning,\n  SheetReadWorkbookOptions,\n} from './core/file'\nexport type { SheetCommand, SheetCommandInfo, SheetCommands, SheetLabel } from './core/commands'\nexport { defineSheetCellType, optionOf, resolveCellType } from './core/cell-type'\nexport type {\n  SheetCellPanelExpose,\n  SheetCellPanelProps,\n  SheetCellRenderProps,\n  SheetCellType,\n  SheetDrawContext,\n  SheetDrawRect,\n  SheetDrawTextOptions,\n  SheetResolvedType,\n} from './core/cell-type'\nexport type {\n  SheetEmits,\n  SheetFormatOption,\n  SheetSlots,\n  SheetToolbarProps,\n  SheetToolbarSlots,\n  SheetToolbarTool,\n  SheetToolbarItem,\n  SheetExpose,\n  SheetExportFileOptions,\n  SheetExporterOptions,\n  SheetExporterOptionsOf,\n  SheetFileErrorEvent,\n  SheetSaveFileOptions,\n  SheetImportEvent,\n  SheetImportMode,\n  SheetImportFileOptions,\n  SheetInvalidCell,\n  SheetExportOptions,\n  SheetImageOptions,\n  SheetPrintOptions,\n  SheetMenuContext,\n  SheetMenuItem,\n  SheetLinkOpenEvent,\n  SheetPasteEvent,\n  SheetProps,\n} from './types'\nexport {\n  boundsOf,\n  columnIndex,\n  columnName,\n  formatCell,\n  formatRange,\n  moveReferences,\n  dropReferences,\n  renameReferences,\n  renameReferencesAll,\n  parseCell,\n  parseRange,\n  quoteSheet,\n  shiftFormula,\n  splitSheet,\n} from './core/address'\nexport { formatClip, parseClip, parseTSV } from './core/clipboard'\nexport { detectDelimiter, parseCSV, readCSV, sheetToCSV } from './core/csv'\nexport type { SheetCSVReadOptions, SheetCSVWriteOptions } from './core/csv'\nexport type { SheetClip, SheetClipFormat } from './core/clipboard'\nexport { continueValues, fillContinues } from './core/fill'\nexport type { SheetFillMode, SheetFillOptions } from './core/fill'\nexport type {\n  SheetBounds,\n  SheetCellTarget,\n  SheetPoint,\n  SheetRange,\n  SheetRefMap,\n} from './core/address'\nexport { cellOf, valueOf } from './core/model'\nexport { checkWorkbook, emptyWorkbook, migrateWorkbook } from './core/document'\nexport type { CheckWorkbookOptions, WorkbookProblem } from './core/document'\nexport type {\n  SheetCell,\n  SheetCellInput,\n  SheetColor,\n  SheetCondition,\n  SheetConditionalAverage,\n  SheetConditionalBar,\n  SheetConditionalDuplicates,\n  SheetConditionalFormat,\n  SheetConditionalFormula,\n  SheetConditionalRank,\n  SheetConditionalScale,\n  SheetConditionalStyle,\n  SheetConditionalUnique,\n  SheetConditionalWhen,\n  SheetData,\n  SheetFilter,\n  SheetFilterRule,\n  SheetFreeze,\n  SheetProtection,\n  SheetRow,\n  SheetRuleRange,\n  SheetSelectOption,\n  SheetSortOrder,\n  SheetStyle,\n  SheetTypeSetup,\n  SheetValidation,\n  SheetValidationFormula,\n  SheetValidationList,\n  SheetValidationWhen,\n  SheetValue,\n  SheetWorkbook,\n} from './core/model'\nexport { compareForSort, meetsRule, sortRows, textCollator } from './core/data'\nexport type { SheetSortKey } from './core/data'\nexport { changeDecimals, formatValue, parseInput } from './core/format'\nexport type { SheetInput } from './core/format'\nexport { isSelected, selectCell } from './core/selection'\nexport type { SheetSelection } from './core/selection'\nexport type { SheetSearchQuery, SheetMatch } from './core/find'\nexport { checkProtection, isLocked, protectionOf } from './core/protect'\nexport { linkTarget } from './core/link'\nexport type { SheetLinkTarget } from './core/link'\nexport type { SheetProtectionCheck, SheetProtectionRefusal } from './core/protect'\nexport { applySheetSteps, compactSheetSteps, sheetKey, SheetTransaction } from './core/transaction'\nexport type {\n  SheetAction,\n  SheetAxisName,\n  SheetCellAt,\n  SheetLinesAt,\n  SheetBookPatch,\n  SheetPatch,\n  SheetRangeAt,\n  SheetRef,\n  SheetStep,\n  SheetStylePatch,\n  SheetTransactionMeta,\n} from './core/transaction'\nexport { criteriaOf, defineSheetFunction, numbersOf, scalarOf } from './formula/functions'\nexport { compareValues, dateText, serialOf, toBoolean, toNumber, toText } from './formula/values'\nexport type { SheetFunction, SheetFunctionContext } from './formula/functions'\nexport { isSheetError, SheetError } from './formula/error'\nexport type { SheetErrorCode } from './formula/error'\nexport type { SheetArg, SheetRangeArg, SheetResult } from './formula/values'\nexport { sheetMessagesFor, sheetLocales } from './locale'\nexport { useSheetMessages } from './use-messages'\nexport type {\n  SheetCommentMessages,\n  SheetCompareMessages,\n  SheetFileMessages,\n  SheetMessages,\n  SheetMessagesOverride,\n} from './locale'\n\ndeclare module 'vue' {\n  export interface GlobalComponents {\n    DouSheet: typeof DouSheet\n    DouSheetTabs: typeof DouSheetTabs\n    DouSheetToolbar: typeof DouSheetToolbar\n    DouSheetFormulaBar: typeof DouSheetFormulaBar\n  }\n}\nexport type { DrawCell, DrawLook, DrawTheme, SheetDrawing } from './export/draw'\nexport { lightThemeColor, plainStyle } from './core/paint'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,IAAa,WAAW,YAAYA,aAAK;AACzC,IAAa,eAAe,YAAYC,kBAAS;AACjD,IAAa,kBAAkB,YAAYC,qBAAY;AACvD,IAAa,qBAAqB,YAAYC,yBAAe"}