@sheetxl/sdk 0.8.0-beta.1 → 0.8.0-beta.2

package/node/esm/O2cOO3xIynWUgOWe.mjs

@@ -0,0 +1,403 @@
+/**
+* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.2
+*
+* (C) 2026-present SheetXL Inc. & Michael T. Ford
+* License: The license can be found at https://www.sheetxl.com/license.
+*/
+import { ICalculation as e, S as t, _ as n, a as r, b as s, c as a, d as o, f as l, g as i, h as c, i as u, l as p, m as d, n as f, o as h, p as g, r as x, s as m, u as y, v, x as I, y as _ } from "./index.mjs";
+import { FormulaError as b } from "@sheetxl/primitives";
+import { CommonUtils as T } from "@sheetxl/utils";
+var P = class {
+	constructor(e) {
+		e = { ...e }, this._editing = "editing" === e.profile, this._parser = new I(e);
+	}
+	compile(t, f, v, I, T, P, k, E, w) {
+		if (0 === I.length) {
+			const e = new b.Parse(_);
+			return this._compileUnparsed(t, T, I, {
+				input: I,
+				cause: e,
+				causes: [e]
+			});
+		}
+		if (I.length > e.MAX_EXPRESSION_LENGTH) {
+			const n = new b.Parse(s(I.length, e.MAX_EXPRESSION_LENGTH));
+			return this._compileUnparsed(t, T, I, {
+				input: I,
+				cause: n,
+				causes: [n]
+			});
+		}
+		let F, C, U = [];
+		try {
+			const e = this._parser.parse(f, v, I);
+			F = e.root, U = e.errors, E && F && 0 === U.length && (F.legacyIntersect = !0);
+		} catch (e) {
+			C = b.isError(e, b.Code.Parse) ? e : new b.Parse(e.message, e);
+		}
+		const z = [];
+		for (const e of U) z.push(g(e));
+		if (F) {
+			const e = c(F, P ?? null);
+			"string" == typeof e ? z.push(new b.Parse(e)) : F = e, y(F, P ?? null) && z.push(new b.Parse("The implicit intersection operator ' ' requires a cell or range on both sides")), p(F, P ?? null) && z.push(new b.Parse("The spill anchor operator '#' requires a cell or range")), l(F, P ?? null) && z.push(new b.Parse("Expected a reference; a value cannot be converted to one."));
+			const t = r(F, P ?? null);
+			t && z.push(new b.Parse(t));
+			const n = h(F, P ?? null);
+			n && z.push(new b.Parse(n));
+			const s = m(F, P ?? null);
+			s && z.push(new b.Parse(s));
+			const o = a(F);
+			o && z.push(new b.Parse(o));
+		}
+		z.length > 0 && !C && (C = z[0]);
+		let R = null;
+		if (C && (R = {
+			input: I,
+			cause: C,
+			causes: z.length > 0 ? z : [C]
+		}), !F) {
+			if (this._editing) {
+				const e = this._recoverCompiled(t, f, v, I, T, R, k);
+				if (e) return e;
+			}
+			return this._compileUnparsed(t, T, I, R, this._editing, () => A(T, k, f, v));
+		}
+		if (F = i(F, P ?? null), F = x(F, P ?? null), T) {
+			const e = this._editing ? w : {
+				mint: !w?.book,
+				...w
+			};
+			F = d(F, T, k, e, {
+				rowIndex: f,
+				colIndex: v
+			});
+			const t = o(F, T);
+			if (t) {
+				const e = new b.Parse(t);
+				z.push(e), R = {
+					input: I,
+					cause: R?.cause ?? e,
+					causes: R ? [...R.causes, e] : [e]
+				};
+			}
+		}
+		const S = u(t, T, F, this._editing, R, P ?? null);
+		if (this._editing && R && n(S.getTokens(), T) !== I) return this._recoverCompiled(t, f, v, I, T, R, k) || this._compileUnparsed(t, T, I, R, !0);
+		return S;
+	}
+	autoCorrect(e) {
+		const t = function(e) {
+			let t = 0, n = null;
+			for (let r = 0; r < e.length; r++) {
+				const s = e[r];
+				n ? s === n && (n = null) : t > 0 ? "'" === s ? r++ : "[" === s ? t++ : "]" === s && t-- : "\"" === s || "'" === s ? n = s : "[" === s && t++;
+			}
+			return n ? 0 : t;
+		}(e), n = e + "]".repeat(t);
+		let r;
+		try {
+			const e = this._parser.getLexer().tokenize(n, !1);
+			if (e.errors.length > 0) return null;
+			r = e.tokens;
+		} catch {
+			return null;
+		}
+		const s = [];
+		for (const e of r) {
+			const t = e.tokenType?.name;
+			if ("OpenParen" === t) s.push(")");
+			else if ("OpenCurlyParen" === t) s.push("}");
+			else if (("CloseParen" === t || "CloseCurlyParen" === t) && s.pop() !== ("CloseParen" === t ? ")" : "}")) return null;
+		}
+		return 0 === s.length && 0 === t ? null : n + s.reverse().join("");
+	}
+	_compileUnparsed(e, n, r, s, a = !1, o) {
+		const l = {
+			runtime: e,
+			symbols: n,
+			getFunction: null,
+			ast: null,
+			evaluations: T.EmptyArray,
+			executions: T.EmptyArray,
+			bindings: T.EmptyArray,
+			referencesAbsolute: T.EmptyArray,
+			referencesExecute: T.EmptyArray,
+			referencesRelative: T.EmptyArray,
+			referencesRoot: T.EmptyArray,
+			referenceIndices: T.EmptyArray,
+			formatReferenceIndices: T.EmptyArray,
+			getTokens: () => {
+				const e = [];
+				return a && F(e, r, void 0, o) ? e : [{
+					type: t.Unparsed,
+					value: r,
+					text: r
+				}];
+			},
+			namedIds: T.EmptyArray,
+			symbolIds: T.EmptyArray,
+			hasTotals: !1,
+			hasVolatile: !1,
+			isBlankCacheable: !1,
+			isBlankCacheableArray: !1,
+			isReferenceOnly: !1,
+			error: s,
+			transform: () => l
+		};
+		return l;
+	}
+	_recoverCompiled(e, r, s, a, o, l, i) {
+		let c, p = a.length;
+		try {
+			const e = this._parser.getLexer().tokenize(a, !1);
+			c = e.tokens, e.errors.length > 0 && (p = Math.min(p, e.errors[0].offset));
+		} catch {
+			return null;
+		}
+		const f = [];
+		for (let e = c.length - 1; e >= 0 && f.length < 24; e--) {
+			const t = (c[e].endOffset ?? -1) + 1;
+			t > 0 && t < a.length && t <= p && f.push(t);
+		}
+		for (const c of f) {
+			const p = a.slice(0, c);
+			let f, h;
+			try {
+				f = this._parser.parse(r, s, p).root;
+			} catch {
+				continue;
+			}
+			if (!f || f.type === t.Unparsed) continue;
+			try {
+				const t = x(f, null);
+				h = u(e, o, o ? d(t, o, i, void 0, {
+					rowIndex: r,
+					colIndex: s
+				}) : t, !0, l);
+			} catch {
+				continue;
+			}
+			if (n(h.getTokens(), o) !== p) continue;
+			const g = a.slice(c);
+			if (0 === g.length) return h;
+			let m;
+			const y = {
+				...h,
+				getTokens: () => (m || (m = [...h.getTokens()], this._appendUnparsedTail(m, g, () => A(o, i, r, s))), m),
+				transform: () => y
+			};
+			return y;
+		}
+		return null;
+	}
+	_appendUnparsedTail(e, n, r) {
+		const s = [];
+		for (const n of e) {
+			if (n.type === t.Whitespace) continue;
+			const e = n.type === t.Paren || n.type === t.Type ? n.text : void 0, r = s.length > 0 ? s[s.length - 1] : void 0;
+			if (n.type === t.Separator && r) {
+				const e = r.declared[r.declared.length - 1];
+				"let" === r.ctx?.type && -1 === r.ctx.argIndex && r.lambda?.argTokens === r.argTokens && e?.argIndex === r.argIndex - 1 && (e.params = r.lambda.params), r.argIndex++, r.argTokens = 0, r.lambda = void 0;
+				continue;
+			}
+			if (r && r.argTokens++, "(" === e || "[" === e || "{" === e) s.push({
+				ctx: n.context,
+				argIndex: 0,
+				declared: [],
+				argTokens: 0,
+				leadsArg: 2 === r?.argTokens
+			});
+			else if (")" === e || "]" === e || "}" === e) {
+				const e = s.pop(), t = s.length > 0 ? s[s.length - 1] : void 0;
+				t && e?.leadsArg && "lambda" === e.ctx?.type && -1 === e.ctx.argIndex && (t.lambda = {
+					params: e.declared.map(({ name: e, optional: t }) => t ? {
+						name: e,
+						optional: t
+					} : { name: e }),
+					argTokens: t.argTokens
+				});
+			} else if (n.type === t.Parameter && r && n.value?.declaration) {
+				const e = n.value;
+				r.declared.push(e.optional ? {
+					name: e.name,
+					argIndex: r.argIndex,
+					optional: !0
+				} : {
+					name: e.name,
+					argIndex: r.argIndex
+				});
+			}
+		}
+		const a = s.length > 0 ? s[s.length - 1] : void 0, o = a?.ctx ? {
+			...a.ctx,
+			argIndex: -1 === a.ctx.argIndex ? a.argIndex : a.ctx.argIndex
+		} : void 0;
+		if (o && -1 === a.ctx.argIndex && ("let" === o.type || "lambda" === o.type)) {
+			const e = "let" === o.type ? 2 : 1;
+			let t = o.bound;
+			for (const n of a.declared) {
+				if (o.argIndex < n.argIndex + e) continue;
+				const { name: r, params: s } = n;
+				t = f(t, s ? {
+					name: r,
+					params: s
+				} : { name: r });
+			}
+			t && (o.bound = t);
+		}
+		const l = (n, r) => {
+			const s = r ? {
+				type: t.Named,
+				value: { name: n },
+				text: n
+			} : {
+				type: t.Unparsed,
+				value: n,
+				text: n
+			};
+			o && (s.context = o), e.push(s);
+		};
+		if (F(e, n, o, r)) return;
+		const i = /[A-Za-z_][A-Za-z0-9_]*$/.exec(n), c = i ? i.index : -1;
+		let u = c > 0 ? n[c - 1] : "";
+		for (let t = e.length - 1; 0 === c && t >= 0 && !u; t--) u = e[t].text?.at(-1) ?? "";
+		c >= 0 && !/[A-Za-z0-9_.]/.test(u) ? (c > 0 && l(n.slice(0, c)), l(n.slice(c), !0)) : l(n);
+	}
+};
+function A(e, t, n, r) {
+	if (!e || !t) return;
+	const s = e.bind(v.Table, "", { at: {
+		scope: t,
+		rowIndex: n,
+		colIndex: r
+	} });
+	return s ? e.resolve(v.Table, s)?.toString() : void 0;
+}
+var k = /[A-Za-z_\\\u007F-\uFFFF][A-Za-z0-9_.\u007F-\uFFFF]*$/, E = /[A-Za-z0-9_.)\]}"'!#\u007F-\uFFFF]/;
+function w(e, t) {
+	for (let n = t + 1; n < e.length; n++) {
+		const t = e[n];
+		if ("'" !== t) {
+			if ("]" === t) return n + 1;
+			if ("[" === t) return null;
+		} else n++;
+	}
+	return -1;
+}
+function F(e, n, r, s) {
+	let a = 0, o = -1;
+	for (let e = 0; e < n.length; e++) {
+		const t = n[e];
+		a > 0 && "'" === t ? e++ : "[" === t ? (0 === a && (o = e), a++) : "]" === t && a > 0 && a--;
+	}
+	if (0 === a) return !1;
+	let l = n.slice(0, o);
+	if ((l.split("\"").length - 1) % 2 == 1) return !1;
+	const i = e.length > 0 ? e[e.length - 1] : void 0;
+	let c = "", u = !1;
+	const p = k.exec(l);
+	if (p) {
+		const e = p.index > 0 ? l[p.index - 1] : i?.text?.at(-1) ?? "";
+		if (/[A-Za-z0-9_.]/.test(e)) return !1;
+		c = p[0], l = l.slice(0, p.index);
+	} else 0 === l.length && i?.text && 0 === k.exec(i.text)?.index && (i.type === t.Named && !i.value?.scope || i.type === t.TableReference) && (c = i.text, u = !0);
+	if (!u) {
+		const e = l.length > 0 ? l[l.length - 1] : i?.text?.at(-1) ?? "";
+		if (e && E.test(e)) return !1;
+	}
+	const d = c || (s?.() ?? ""), f = [], h = (e, t, n) => {
+		f.push({
+			type: e,
+			value: t,
+			text: t,
+			context: {
+				name: d,
+				argIndex: n,
+				type: "table"
+			}
+		});
+	}, g = (e, n, r, s) => {
+		const a = e.startsWith("#"), o = r ? s ? "column" : a ? "specifier" : e ? "column" : "any" : void 0, l = o ? {
+			table: d,
+			name: e,
+			partial: o
+		} : {
+			table: d,
+			name: e
+		};
+		f.push({
+			type: a ? t.TableSpecifier : t.TableColumn,
+			value: l,
+			text: e,
+			context: {
+				name: d,
+				argIndex: n,
+				type: "table"
+			}
+		});
+	}, x = (e, n, r, s) => {
+		h(t.Paren, "[", r), g(e.slice(1, n ? -1 : void 0), r, !n, s), n && h(t.Paren, "]", r);
+	};
+	h(t.Paren, "[", -1);
+	const m = n.slice(o + 1);
+	if (m.startsWith("[")) {
+		let e = 0, n = !1, r = 0;
+		for (; r < m.length;) {
+			const s = m[r];
+			if ("[" === s) {
+				const t = w(m, r);
+				if (null === t) return !1;
+				const s = -1 !== t;
+				if (x(m.slice(r, s ? t : m.length), s, e, n), n = !1, !s) break;
+				r = t;
+			} else if ("," === s) h(t.Separator, ",", e++), r++;
+			else if (":" === s) h(t.Infix, ":", e), r++;
+			else if ("@" === s) h(t.Prefix, "@", e), n = !0, r++;
+			else {
+				if (" " !== s) return !1;
+				{
+					let n = r;
+					for (; " " === m[n];) n++;
+					h(t.Whitespace, m.slice(r, n), e), r = n;
+				}
+			}
+		}
+	} else {
+		let e = m;
+		const n = e.startsWith("@");
+		if (n && (h(t.Prefix, "@", 0), e = e.slice(1)), e.startsWith("[")) {
+			if (-1 !== w(e, 0)) return !1;
+			x(e, !1, 0, n);
+		} else {
+			if (/(^|[^'])[[\]]/.test(e) || e.startsWith("#") && e.includes(",")) return !1;
+			g(e, 0, !0, n);
+		}
+	}
+	if (l) {
+		const n = {
+			type: t.Unparsed,
+			value: l,
+			text: l
+		};
+		r && (n.context = r), e.push(n);
+	}
+	if (u) {
+		const n = {
+			...i,
+			type: t.TableReference,
+			value: c,
+			text: c
+		};
+		delete n.referenceIndex, e[e.length - 1] = n;
+	} else if (c) {
+		const n = {
+			type: t.TableReference,
+			value: c,
+			text: c
+		};
+		r && (n.context = r), e.push(n);
+	}
+	for (const t of f) e.push(t);
+	return !0;
+}
+export { P as FormulaCompiler, F as appendPartialStructuredReference };