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

package/browser/esm/index.mjs

@@ -1,5 +1,5 @@
 /**
-* @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.7.28-beta.4
+* @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - 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.
@@ -32,7 +32,13 @@ var t, n, r, i, a = {
 }, o = {
 	...a,
 	Date: "date"
-}, s = /[.*+?^${}()|[\]\\]/, c = (e) => s.test(e) ? "\\" + e : e, l = {
+}, s = {
+	...a,
+	Reference: "reference",
+	Array: "array",
+	Lambda: "lambda",
+	Omitted: "omitted"
+}, c = /[.*+?^${}()|[\]\\]/, l = (e) => c.test(e) ? "\\" + e : e, u = {
 	isWildCard: (e) => typeof e == "string" && /[*?]/.test(e),
 	toRegex: (e, t, n = !1) => {
 		let r = "", i = e.length;
@@ -40,14 +46,12 @@ var t, n, r, i, a = {
 			let n = e[t];
 			if (n === "~") {
 				let n = e[t + 1];
-				n === "*" || n === "?" || n === "~" ? (r += c(n), t++) : r += "~";
-				continue;
-			}
-			n === "*" ? r += ".*" : r += n === "?" ? "." : c(n);
+				n !== "*" && n !== "?" && n !== "~" || (r += l(n), t++);
+			} else r += n === "*" ? "[\\s\\S]*" : n === "?" ? "[\\s\\S]" : l(n);
 		}
-		return RegExp(n ? `^${r}$` : r, t);
+		return RegExp(n === "start" ? `^${r}` : n ? `^${r}$` : r, t);
 	}
-};
+}, d = (e) => typeof e == "object" && !!e && !0 === e.isLazy;
 (n = t ||= {}).Axis = {
 	Column: "column",
 	Row: "row"
@@ -309,15 +313,15 @@ var t, n, r, i, a = {
 	}
 	e.Timeout = S;
 }(i ||= {});
-var u = {};
-u[i.Code.Parse] = i.Parse, u[i.Code.Null] = i.Null, u[i.Code.Div0] = i.Div0, u[i.Code.Value] = i.Value, u[i.Code.Ref] = i.Ref, u[i.Code.Name] = i.Name, u[i.Code.Num] = i.Num, u[i.Code.NA] = i.NA, u[i.Code.GettingData] = i.GettingData, u[i.Code.Spill] = i.Spill, u[i.Code.Connect] = i.Connect, u[i.Code.Blocked] = i.Blocked, u[i.Code.Unknown] = i.Unknown, u[i.Code.Field] = i.Field, u[i.Code.Calc] = i.Calc, u[i.Code.Busy] = i.Busy, u[i.Code.Python] = i.Python, u[i.Code.Timeout] = i.Timeout;
-var d = /* @__PURE__ */ new Map(), f = /* @__PURE__ */ new Map(), p = /* @__PURE__ */ new Map(), m = /* @__PURE__ */ new Map(), h = Object.keys(u);
-for (let e = 0; e < h.length; e++) {
-	let t = u[h[e]], n = new t();
-	p.set(n.getLabel(), t), m.set(n.getCode(), t), d.set(n.getLabel(), n), f.set(n.getCode(), n);
+var f = {};
+f[i.Code.Parse] = i.Parse, f[i.Code.Null] = i.Null, f[i.Code.Div0] = i.Div0, f[i.Code.Value] = i.Value, f[i.Code.Ref] = i.Ref, f[i.Code.Name] = i.Name, f[i.Code.Num] = i.Num, f[i.Code.NA] = i.NA, f[i.Code.GettingData] = i.GettingData, f[i.Code.Spill] = i.Spill, f[i.Code.Connect] = i.Connect, f[i.Code.Blocked] = i.Blocked, f[i.Code.Unknown] = i.Unknown, f[i.Code.Field] = i.Field, f[i.Code.Calc] = i.Calc, f[i.Code.Busy] = i.Busy, f[i.Code.Python] = i.Python, f[i.Code.Timeout] = i.Timeout;
+var p = /* @__PURE__ */ new Map(), m = /* @__PURE__ */ new Map(), h = /* @__PURE__ */ new Map(), g = /* @__PURE__ */ new Map(), _ = Object.keys(f);
+for (let e = 0; e < _.length; e++) {
+	let t = f[_[e]], n = new t();
+	h.set(n.getLabel(), t), g.set(n.getCode(), t), p.set(n.getLabel(), n), m.set(n.getCode(), n);
 }
 (function(e) {
-	let t = e.getBuiltInByCode = (e) => f.get(e);
+	let t = e.getBuiltInByCode = (e) => m.get(e);
 	e.BuiltIn = {
 		Parse: t(i.Code.Parse),
 		Null: t(i.Code.Null),
@@ -339,12 +343,12 @@ for (let e = 0; e < h.length; e++) {
 		Timeout: t(i.Code.Timeout)
 	}, e.newTypedError = (e, t, n) => {
 		let r;
-		return r = typeof e == "string" ? p.get(e) : m.get(e), r ||= i.Unknown, new r(t, n);
-	}, e.getBuiltInByLabel = (e) => d.get(e), e.isError = function(e, t) {
+		return r = typeof e == "string" ? h.get(e) : g.get(e), r ||= i.Unknown, new r(t, n);
+	}, e.getBuiltInByLabel = (e) => p.get(e), e.isError = function(e, t) {
 		return !!e && !0 === e.isFormulaError && (t === void 0 || e.getCode() === t);
 	};
 })(i ||= {});
-var g = class {
+var v = class {
 	constructor(e) {
 		this._subscribeFn = e;
 	}
@@ -364,42 +368,48 @@ var g = class {
 			typeof i == "function" && i();
 		}, r;
 	}
-}, _ = class {
+}, y = class {
 	createRange(e, t, n) {
-		throw new y();
+		throw new S();
+	}
+	flattenAreas(e) {
+		throw new S();
 	}
 	getReference(e, t) {
-		throw new y();
+		throw new S();
 	}
 	getResizedReference(e, t, n) {
-		throw new y();
+		throw new S();
 	}
 	getNumberFormat(e, t) {
-		throw new y();
+		throw new S();
 	}
 	fromSerialDate(e, t) {
-		throw new y();
+		throw new S();
 	}
 	toSerialDate(e, t) {
-		throw new y();
+		throw new S();
 	}
 	getDateParts(e, t) {
-		throw new y();
+		throw new S();
 	}
 	getSerialDate(e, t, n, r, i, a, o) {
-		throw new y();
+		throw new S();
 	}
 	getNow() {
-		throw new y();
+		throw new S();
+	}
+	getRandom() {
+		return Math.random();
 	}
 	getValueAt(e, t, n, r) {
 		return null;
 	}
 	getEntireCoords() {
-		return b;
+		return C;
 	}
 	isValidDate(e, t) {
-		return e instanceof Date || Object.prototype.toString.call(e) === "[object Date]" ? !isNaN(e.getTime()) : !t && typeof e == "number" && !(e < 0 || e > S);
+		return e instanceof Date || Object.prototype.toString.call(e) === "[object Date]" ? !isNaN(e.getTime()) : !t && typeof e == "number" && !(e < 0 || e > T);
 	}
 	getRow() {
 		return 0;
@@ -407,6 +417,9 @@ var g = class {
 	getColumn() {
 		return 0;
 	}
+	isImplicitIntersect() {
+		return !1;
+	}
 	getFormulaAt(e, t, n) {
 		return null;
 	}
@@ -431,19 +444,22 @@ var g = class {
 		return null;
 	}
 	getAddress(e, t) {
-		throw new y();
+		throw new S();
 	}
 	parseAsSerialDate(e, t) {
-		throw new y();
+		throw new S();
 	}
 	parseAsDate(e, t) {
-		throw new y();
+		throw new S();
 	}
 	parseAsNumber(e, t) {
-		throw new y();
+		throw new S();
 	}
-	createCriteria(e) {
-		throw new y();
+	createCriteria(e, t) {
+		throw new S();
+	}
+	createGrouping(e, t) {
+		throw new S();
 	}
 	parseAsLiteral(e) {
 		let t = e.toUpperCase();
@@ -454,13 +470,16 @@ var g = class {
 	}
 	compare(e, t, n) {
 		if (e === t) return 0;
-		let r = v(e), i = v(t);
+		let r = b(e), i = b(t);
 		return r === i ? e < t ? -1 : +(e > t) : r < i ? -1 : 1;
 	}
 	getRuntime() {
-		return x;
+		return w;
+	}
+	getArgs() {
+		throw new S(x);
 	}
-}, v = (e) => {
+}, b = (e) => {
 	if (e == null) return 0;
 	switch (typeof e) {
 		case "number": return 1;
@@ -468,41 +487,45 @@ var g = class {
 		case "boolean": return 3;
 		default: return 4;
 	}
-}, y = class extends Error {
+}, x = "FormulaContext.getArgs() is only valid while a function body is running", S = class extends Error {
 	constructor(e = "Not implemented in StubbedFormulaContext") {
 		super(e), this.name = "NotImplementedError";
 	}
-}, b = Object.freeze({
+}, C = Object.freeze({
 	colStart: 0,
 	rowStart: 0,
 	colEnd: 2 ** 14 - 1,
 	rowEnd: 2 ** 20 - 1
-}), x = {
+}), w = {
 	isDate1904: () => !1,
-	getLocale: () => T.tag,
-	getLocaleProfile: () => T,
+	getLocale: () => O.tag,
+	getLocaleProfile: () => O,
 	isR1C1: () => !1,
 	getNow: () => 0,
+	getRandom: () => Math.random(),
 	getLocation: () => "unknown",
 	getVersion: () => "1.0.0",
 	getOS: () => "unknown",
 	getUser: () => "unidentified",
 	getDescription: () => "Stubbed Formula Context"
-}, S = 2958465, C = new _(), w = class {
+}, T = 2958465, E = new y(), D = class {
 	constructor() {
-		this._scope = C;
+		this._scope = E, this._argsFn = null;
 	}
 	_setScope(e) {
-		this._scope = e ?? C;
+		this._scope = e ?? E;
 	}
 	_getScope() {
 		return this._scope;
 	}
+	_setArgsProvider(e) {
+		this._argsFn = e;
+	}
 	getNumberFormat(e, t) {
 		return this._getScope().getNumberFormat(e, t);
 	}
 	getEntireCoords() {
-		return this._getScope().getEntireCoords() ?? b;
+		return this._getScope().getEntireCoords() ?? C;
 	}
 	parseAsSerialDate(e, t) {
 		return this._getScope().parseAsSerialDate(e, t);
@@ -513,12 +536,15 @@ var g = class {
 	parseAsNumber(e, t) {
 		return this._getScope().parseAsNumber(e, t);
 	}
-	createCriteria(e) {
-		return this._getScope().createCriteria(e);
+	createCriteria(e, t) {
+		return this._getScope().createCriteria(e, t);
+	}
+	createGrouping(e, t) {
+		return this._getScope().createGrouping(e, t);
 	}
 	parseAsLiteral(e) {
 		let t = this._getScope();
-		return t.parseAsLiteral ? t.parseAsLiteral(e) : C.parseAsLiteral(e);
+		return t.parseAsLiteral ? t.parseAsLiteral(e) : E.parseAsLiteral(e);
 	}
 	toText(e) {
 		return this._getScope().toText(e);
@@ -541,15 +567,30 @@ var g = class {
 	getNow() {
 		return this._getScope().getNow();
 	}
+	getRandom() {
+		return this._getScope().getRandom?.() ?? Math.random();
+	}
 	createRange(e, t, n) {
 		return this._getScope().createRange(e, t, n);
 	}
+	flattenAreas(e) {
+		if (!Array.isArray(e)) return e;
+		let t = [];
+		for (let n = 0; n < e.length; n++) {
+			let r = e[n], { rows: i, columns: a } = r.getShape();
+			for (let e = 0; e < i; e++) for (let n = 0; n < a; n++) t.push(r.getValueAt(e, n));
+		}
+		return this.createRange(t.length, 1, (e, n) => t[n.rowIndex]);
+	}
 	getRow() {
 		return this._getScope().getRow?.() ?? 0;
 	}
 	getColumn() {
 		return this._getScope().getColumn?.() ?? 0;
 	}
+	isImplicitIntersect() {
+		return this._getScope().isImplicitIntersect?.() ?? !1;
+	}
 	getReference(e, t) {
 		return this._getScope().getReference(e, t);
 	}
@@ -590,18 +631,23 @@ var g = class {
 		return this._getScope().getAddress(e, t);
 	}
 	compare(e, t, n) {
-		return this._getScope().compare?.(e, t, n) ?? C.compare(e, t, n);
+		return this._getScope().compare?.(e, t, n) ?? E.compare(e, t, n);
 	}
 	getRuntime() {
 		return this._getScope().getRuntime();
 	}
+	getArgs() {
+		let e = this._argsFn, t = e ? e() : null;
+		if (!t) throw new S(x);
+		return t;
+	}
 	get [Symbol.toStringTag]() {
 		return "[FormulaContext]";
 	}
 	toString() {
 		return this._getScope()?.toString?.() ?? "{STUB SCOPE}";
 	}
-}, T = Object.freeze({
+}, O = Object.freeze({
 	tag: "en-US",
 	numberingSystem: "latn",
 	decimal: ".",
@@ -681,5 +727,5 @@ var g = class {
 		sensitivity: "base",
 		numeric: !0
 	})
-}), E = new w();
-export { T as DEFAULT_LOCALE_PROFILE, E as FormulaContext, i as FormulaError, t as IRange, r as IRangeStats, o as InteropScalarType, g as Observable, e as Scalar, a as ScalarType, w as ScopedFormulaContext, _ as StubbedFormulaContext, l as WildCard };
+}), k = new D();
+export { O as DEFAULT_LOCALE_PROFILE, k as FormulaContext, i as FormulaError, t as IRange, r as IRangeStats, o as InteropScalarType, v as Observable, e as Scalar, a as ScalarType, D as ScopedFormulaContext, y as StubbedFormulaContext, s as ValueKind, u as WildCard, d as isLazyValue };