@sheetxl/primitives 0.8.0-beta.1 → 0.8.0-beta.11

package/browser/esm/index.mjs

@@ -1,5 +1,5 @@
 /**
-* @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.8.0-beta.1
+* @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.8.0-beta.11
 *
 * (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,30 +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);
-		}
-		return RegExp(n ? `^${r}$` : r, t);
-	}
-}, u = {
-	noReferenceLift: "A multi-cell reference at a non-repeating scalar parameter is #VALUE! rather than a broadcast.",
-	noMemberFilter: "Members of a repeating scalar parameter are coerced rather than filtered; one that cannot be is #VALUE!."
-}, d = { atp: ["noReferenceLift", "noMemberFilter"] };
-function f(e) {
-	let t = p(e);
-	if (t) return [t];
-	let n = (e ?? "").trim().toLowerCase();
-	for (let e of Object.keys(d)) if (e.toLowerCase() === n) return d[e];
-	return null;
-}
-function p(e) {
-	if (!e) return null;
-	let t = e.trim().toLowerCase();
-	for (let e of Object.keys(u)) if (e.toLowerCase() === t) return e;
-	return null;
-}
+				n !== "*" && n !== "?" && n !== "~" || (r += l(n), t++);
+			} else r += n === "*" ? "[\\s\\S]*" : n === "?" ? "[\\s\\S]" : l(n);
+		}
+		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"
@@ -325,15 +313,15 @@ function p(e) {
 	}
 	e.Timeout = S;
 }(i ||= {});
-var m = {};
-m[i.Code.Parse] = i.Parse, m[i.Code.Null] = i.Null, m[i.Code.Div0] = i.Div0, m[i.Code.Value] = i.Value, m[i.Code.Ref] = i.Ref, m[i.Code.Name] = i.Name, m[i.Code.Num] = i.Num, m[i.Code.NA] = i.NA, m[i.Code.GettingData] = i.GettingData, m[i.Code.Spill] = i.Spill, m[i.Code.Connect] = i.Connect, m[i.Code.Blocked] = i.Blocked, m[i.Code.Unknown] = i.Unknown, m[i.Code.Field] = i.Field, m[i.Code.Calc] = i.Calc, m[i.Code.Busy] = i.Busy, m[i.Code.Python] = i.Python, m[i.Code.Timeout] = i.Timeout;
-var h = /* @__PURE__ */ new Map(), g = /* @__PURE__ */ new Map(), _ = /* @__PURE__ */ new Map(), v = /* @__PURE__ */ new Map(), y = Object.keys(m);
-for (let e = 0; e < y.length; e++) {
-	let t = m[y[e]], n = new t();
-	_.set(n.getLabel(), t), v.set(n.getCode(), t), h.set(n.getLabel(), n), g.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) => g.get(e);
+	let t = e.getBuiltInByCode = (e) => m.get(e);
 	e.BuiltIn = {
 		Parse: t(i.Code.Parse),
 		Null: t(i.Code.Null),
@@ -355,12 +343,12 @@ for (let e = 0; e < y.length; e++) {
 		Timeout: t(i.Code.Timeout)
 	}, e.newTypedError = (e, t, n) => {
 		let r;
-		return r = typeof e == "string" ? _.get(e) : v.get(e), r ||= i.Unknown, new r(t, n);
-	}, e.getBuiltInByLabel = (e) => h.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 b = class {
+var v = class {
 	constructor(e) {
 		this._subscribeFn = e;
 	}
@@ -380,42 +368,48 @@ var b = class {
 			typeof i == "function" && i();
 		}, r;
 	}
-}, x = class {
+}, y = class {
 	createRange(e, t, n) {
-		throw new w();
+		throw new S();
+	}
+	flattenAreas(e) {
+		throw new S();
 	}
 	getReference(e, t) {
-		throw new w();
+		throw new S();
 	}
 	getResizedReference(e, t, n) {
-		throw new w();
+		throw new S();
 	}
 	getNumberFormat(e, t) {
-		throw new w();
+		throw new S();
 	}
 	fromSerialDate(e, t) {
-		throw new w();
+		throw new S();
 	}
 	toSerialDate(e, t) {
-		throw new w();
+		throw new S();
 	}
 	getDateParts(e, t) {
-		throw new w();
+		throw new S();
 	}
 	getSerialDate(e, t, n, r, i, a, o) {
-		throw new w();
+		throw new S();
 	}
 	getNow() {
-		throw new w();
+		throw new S();
+	}
+	getRandom() {
+		return Math.random();
 	}
 	getValueAt(e, t, n, r) {
 		return null;
 	}
 	getEntireCoords() {
-		return T;
+		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 > D);
+		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;
@@ -423,6 +417,9 @@ var b = class {
 	getColumn() {
 		return 0;
 	}
+	isImplicitIntersect() {
+		return !1;
+	}
 	getFormulaAt(e, t, n) {
 		return null;
 	}
@@ -447,19 +444,22 @@ var b = class {
 		return null;
 	}
 	getAddress(e, t) {
-		throw new w();
+		throw new S();
 	}
 	parseAsSerialDate(e, t) {
-		throw new w();
+		throw new S();
 	}
 	parseAsDate(e, t) {
-		throw new w();
+		throw new S();
 	}
 	parseAsNumber(e, t) {
-		throw new w();
+		throw new S();
+	}
+	createCriteria(e, t) {
+		throw new S();
 	}
-	createCriteria(e) {
-		throw new w();
+	createGrouping(e, t) {
+		throw new S();
 	}
 	parseAsLiteral(e) {
 		let t = e.toUpperCase();
@@ -470,16 +470,16 @@ var b = class {
 	}
 	compare(e, t, n) {
 		if (e === t) return 0;
-		let r = S(e), i = S(t);
+		let r = b(e), i = b(t);
 		return r === i ? e < t ? -1 : +(e > t) : r < i ? -1 : 1;
 	}
 	getRuntime() {
-		return E;
+		return w;
 	}
 	getArgs() {
-		throw new w(C);
+		throw new S(x);
 	}
-}, S = (e) => {
+}, b = (e) => {
 	if (e == null) return 0;
 	switch (typeof e) {
 		case "number": return 1;
@@ -487,32 +487,33 @@ var b = class {
 		case "boolean": return 3;
 		default: return 4;
 	}
-}, C = "FormulaContext.getArgs() is only valid while a function body is running", w = 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";
 	}
-}, T = Object.freeze({
+}, C = Object.freeze({
 	colStart: 0,
 	rowStart: 0,
 	colEnd: 2 ** 14 - 1,
 	rowEnd: 2 ** 20 - 1
-}), E = {
+}), w = {
 	isDate1904: () => !1,
-	getLocale: () => A.tag,
-	getLocaleProfile: () => A,
+	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"
-}, D = 2958465, O = new x(), k = class {
+}, T = 2958465, E = new y(), D = class {
 	constructor() {
-		this._scope = O, this._argsFn = null;
+		this._scope = E, this._argsFn = null;
 	}
 	_setScope(e) {
-		this._scope = e ?? O;
+		this._scope = e ?? E;
 	}
 	_getScope() {
 		return this._scope;
@@ -524,7 +525,7 @@ var b = class {
 		return this._getScope().getNumberFormat(e, t);
 	}
 	getEntireCoords() {
-		return this._getScope().getEntireCoords() ?? T;
+		return this._getScope().getEntireCoords() ?? C;
 	}
 	parseAsSerialDate(e, t) {
 		return this._getScope().parseAsSerialDate(e, t);
@@ -535,12 +536,15 @@ var b = 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) : O.parseAsLiteral(e);
+		return t.parseAsLiteral ? t.parseAsLiteral(e) : E.parseAsLiteral(e);
 	}
 	toText(e) {
 		return this._getScope().toText(e);
@@ -563,15 +567,30 @@ var b = 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);
 	}
@@ -612,14 +631,14 @@ var b = class {
 		return this._getScope().getAddress(e, t);
 	}
 	compare(e, t, n) {
-		return this._getScope().compare?.(e, t, n) ?? O.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 w(C);
+		if (!t) throw new S(x);
 		return t;
 	}
 	get [Symbol.toStringTag]() {
@@ -628,7 +647,7 @@ var b = class {
 	toString() {
 		return this._getScope()?.toString?.() ?? "{STUB SCOPE}";
 	}
-}, A = Object.freeze({
+}, O = Object.freeze({
 	tag: "en-US",
 	numberingSystem: "latn",
 	decimal: ".",
@@ -708,5 +727,5 @@ var b = class {
 		sensitivity: "base",
 		numeric: !0
 	})
-}), j = new k();
-export { d as CompatAliases, u as CompatFeatures, A as DEFAULT_LOCALE_PROFILE, j as FormulaContext, i as FormulaError, t as IRange, r as IRangeStats, o as InteropScalarType, b as Observable, e as Scalar, a as ScalarType, k as ScopedFormulaContext, x as StubbedFormulaContext, l as WildCard, p as resolveCompatFeature, f as resolveCompatFeatures };
+}), 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 };