@sheetxl/sdk 0.7.28-beta.4 → 0.8.0-beta.10

package/THIRD-PARTY-NOTICES.md

@@ -11,7 +11,7 @@ licensed — see `LICENSE.md`.
 Portions of the number-format engine are derived from [numfmt](https://github.com/borgar/numfmt)
 3.2.6, with local modifications.
 
-```
+``` code
 Copyright (c) 2020, Borgar Þorsteinsson <borgar@borgar.net>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

package/browser/esm/{DBIu6NUHIcxOOBQp.mjs → BEAY9XgKNx-bakXW.mjs}

@@ -1,5 +1,5 @@
 /**
-* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.7.28-beta.4
+* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.10
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
 * License: The license can be found at https://www.sheetxl.com/license.
@@ -17,7 +17,7 @@ var e = Object.create, t = Object.defineProperty, n = Object.getOwnPropertyDescr
 		enumerable: !(s = n(i, c)) || s.enumerable
 	});
 	return e;
-})(!s && o && o.__esModule ? c : t(c, "default", {
+})(!s && o && o.__esModule && a.call(o, "default") ? c : t(c, "default", {
 	value: o,
 	enumerable: !0
 }), o));

package/browser/esm/BbSmt62FpFIpoVzu.mjs

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