@sheetxl/primitives 0.8.0-beta.2 → 0.8.0-beta.20

package/LICENSE.md

@@ -1,11 +1,21 @@
-# Repository Licensing
+MIT License
 
-SheetXL contains a mix of open-source and commercially licensed packages. Each package is individually licensed and contains its own license file.
+Copyright (c) 2026-present SheetXL Inc. & Michael T. Ford
 
-For the specific terms and conditions applicable to a package, please see the `LICENSE.md` file located in that package's root directory.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-Generally, packages intended for public distribution (such as CLIs, adapters, and vanilla wrappers) are licensed under the MIT license. All other core packages are proprietary and require a commercial license for use.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-For more details on commercial licensing, please visit our website:
-
-https://www.sheetxl.com/docs/guides/licensing-pricing
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/browser/esm/index.mjs

@@ -1,8 +1,8 @@
 /**
-* @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.8.0-beta.2
+* @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.8.0-beta.20
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
-* License: The license can be found at https://www.sheetxl.com/license.
+* License: MIT
 */
 var e;
 (function(e) {
@@ -21,6 +21,39 @@ var e;
 		}
 		return i === null ? e : i.join("");
 	};
+	let n = e.MIN_NUMBER = 22250738585072014e-324;
+	e.flushSubnormal = function(e) {
+		return e > -n && e < n ? 0 : e;
+	}, e.isNumberTextInRange = function(e, t = ".") {
+		let n = e.length;
+		if (n < 309 && e.indexOf("E") < 0 && e.indexOf("e") < 0) return !0;
+		let r = t.charCodeAt(0), i = !1, a = !1, o = !1, s = 0, c = 0, l = 0, u = 0;
+		for (; u < n; u++) {
+			let t = e.charCodeAt(u);
+			if (t >= 48 && t <= 57) i = !0, a ? (l++, o || (t === 48 ? c++ : o = !0)) : (o || t !== 48) && (o = !0, s++);
+			else if (t === r) a = !0;
+			else if ((t === 69 || t === 101) && i) break;
+		}
+		let d = 0;
+		if (u < n) {
+			let t = u + 1, r = !1, i = e.charCodeAt(t);
+			i === 45 ? (r = !0, t++) : i === 43 && t++;
+			let a = 0;
+			for (; t < n; t++) {
+				let n = e.charCodeAt(t);
+				if (n < 48 || n > 57) break;
+				d = 10 * d + (n - 48), a++;
+			}
+			if (a === 0) return !0;
+			r && (d = -d);
+		}
+		if (o) {
+			let e = (s > 0 ? s - 1 : -(c + 1)) + d;
+			return e >= -309 && e <= 307;
+		}
+		let f = d - l;
+		return f >= -308 && f <= 308;
+	};
 })(e ||= {});
 var t, n, r, i, a = {
 	Number: "number",
@@ -47,9 +80,7 @@ var t, n, r, i, a = {
 			if (n === "~") {
 				let n = e[t + 1];
 				n !== "*" && n !== "?" && n !== "~" || (r += l(n), t++);
-				continue;
-			}
-			n === "*" ? r += "[\\s\\S]*" : r += n === "?" ? "[\\s\\S]" : l(n);
+			} else r += n === "*" ? "[\\s\\S]*" : n === "?" ? "[\\s\\S]" : l(n);
 		}
 		return RegExp(n === "start" ? `^${r}` : n ? `^${r}$` : r, t);
 	}
@@ -372,34 +403,34 @@ var v = class {
 	}
 }, y = class {
 	createRange(e, t, n) {
-		throw new S();
+		throw x("createRange");
 	}
 	flattenAreas(e) {
-		throw new S();
+		throw x("flattenAreas");
 	}
 	getReference(e, t) {
-		throw new S();
+		throw x("getReference");
 	}
 	getResizedReference(e, t, n) {
-		throw new S();
+		throw x("getResizedReference");
 	}
 	getNumberFormat(e, t) {
-		throw new S();
+		throw x("getNumberFormat");
 	}
 	fromSerialDate(e, t) {
-		throw new S();
+		throw x("fromSerialDate");
 	}
 	toSerialDate(e, t) {
-		throw new S();
+		throw x("toSerialDate");
 	}
 	getDateParts(e, t) {
-		throw new S();
+		throw x("getDateParts");
 	}
 	getSerialDate(e, t, n, r, i, a, o) {
-		throw new S();
+		throw x("getSerialDate");
 	}
 	getNow() {
-		throw new S();
+		throw x("getNow");
 	}
 	getRandom() {
 		return Math.random();
@@ -408,10 +439,10 @@ var v = class {
 		return null;
 	}
 	getEntireCoords() {
-		return C;
+		return T;
 	}
 	isValidDate(e, t) {
-		return e instanceof Date || Object.prototype.toString.call(e) === "[object Date]" ? !isNaN(e.getTime()) : !t && typeof e == "number" && !(e < 0 || e > T);
+		return e instanceof Date || Object.prototype.toString.call(e) === "[object Date]" ? !isNaN(e.getTime()) : !t && typeof e == "number" && !(e < 0 || e > D);
 	}
 	getRow() {
 		return 0;
@@ -434,7 +465,7 @@ var v = class {
 	getSheetCount() {
 		return 1;
 	}
-	markVolatile() {}
+	defer(e, t) {}
 	formatResults(e) {}
 	filterHidden(e, t) {
 		return e;
@@ -446,19 +477,25 @@ var v = class {
 		return null;
 	}
 	getAddress(e, t) {
-		throw new S();
+		throw x("getAddress");
 	}
 	parseAsSerialDate(e, t) {
-		throw new S();
+		throw x("parseAsSerialDate");
 	}
 	parseAsDate(e, t) {
-		throw new S();
+		throw x("parseAsDate");
 	}
 	parseAsNumber(e, t) {
-		throw new S();
+		throw x("parseAsNumber");
 	}
 	createCriteria(e, t) {
-		throw new S();
+		throw x("createCriteria");
+	}
+	createPivot(e, t, n) {
+		throw x("createPivot");
+	}
+	getPivotAt(e) {
+		return null;
 	}
 	parseAsLiteral(e) {
 		let t = e.toUpperCase();
@@ -473,10 +510,13 @@ var v = class {
 		return r === i ? e < t ? -1 : +(e > t) : r < i ? -1 : 1;
 	}
 	getRuntime() {
-		return w;
+		return E;
 	}
 	getArgs() {
-		throw new S(x);
+		throw new w(S);
+	}
+	createRichData(e, t) {
+		throw new w(C);
 	}
 }, b = (e) => {
 	if (e == null) return 0;
@@ -486,19 +526,19 @@ var v = class {
 		case "boolean": return 3;
 		default: return 4;
 	}
-}, x = "FormulaContext.getArgs() is only valid while a function body is running", S = class extends Error {
+}, x = (e) => new w(`FormulaContext.${e}() is only valid while a function body is running. A deferred executor reads its workbook through ctx.getFormulaContext().`), S = "FormulaContext.getArgs() is only valid while a function body is running", C = "FormulaContext.createRichData() needs a workbook being calculated", w = class extends Error {
 	constructor(e = "Not implemented in StubbedFormulaContext") {
 		super(e), this.name = "NotImplementedError";
 	}
-}, C = Object.freeze({
+}, T = Object.freeze({
 	colStart: 0,
 	rowStart: 0,
 	colEnd: 2 ** 14 - 1,
 	rowEnd: 2 ** 20 - 1
-}), w = {
+}), E = {
 	isDate1904: () => !1,
-	getLocale: () => O.tag,
-	getLocaleProfile: () => O,
+	getLocale: () => A.tag,
+	getLocaleProfile: () => A,
 	isR1C1: () => !1,
 	getNow: () => 0,
 	getRandom: () => Math.random(),
@@ -507,12 +547,12 @@ var v = class {
 	getOS: () => "unknown",
 	getUser: () => "unidentified",
 	getDescription: () => "Stubbed Formula Context"
-}, T = 2958465, E = new y(), D = class {
+}, D = 2958465, O = new y(), k = class {
 	constructor() {
-		this._scope = E, this._argsFn = null;
+		this._scope = O, this._argsFn = null;
 	}
 	_setScope(e) {
-		this._scope = e ?? E;
+		this._scope = e ?? O;
 	}
 	_getScope() {
 		return this._scope;
@@ -524,7 +564,7 @@ var v = class {
 		return this._getScope().getNumberFormat(e, t);
 	}
 	getEntireCoords() {
-		return this._getScope().getEntireCoords() ?? C;
+		return this._getScope().getEntireCoords() ?? T;
 	}
 	parseAsSerialDate(e, t) {
 		return this._getScope().parseAsSerialDate(e, t);
@@ -538,9 +578,15 @@ var v = class {
 	createCriteria(e, t) {
 		return this._getScope().createCriteria(e, t);
 	}
+	createPivot(e, t, n) {
+		return this._getScope().createPivot(e, t, n);
+	}
+	getPivotAt(e) {
+		return this._getScope().getPivotAt?.(e) ?? null;
+	}
 	parseAsLiteral(e) {
 		let t = this._getScope();
-		return t.parseAsLiteral ? t.parseAsLiteral(e) : E.parseAsLiteral(e);
+		return t.parseAsLiteral ? t.parseAsLiteral(e) : O.parseAsLiteral(e);
 	}
 	toText(e) {
 		return this._getScope().toText(e);
@@ -608,8 +654,8 @@ var v = class {
 	getSheetCount() {
 		return this._getScope().getSheetCount?.() ?? 1;
 	}
-	markVolatile() {
-		this._getScope().markVolatile?.();
+	defer(e, t) {
+		return this._getScope().defer?.(e, t);
 	}
 	formatResults(e) {
 		this._getScope().formatResults?.(e);
@@ -627,14 +673,18 @@ var v = class {
 		return this._getScope().getAddress(e, t);
 	}
 	compare(e, t, n) {
-		return this._getScope().compare?.(e, t, n) ?? E.compare(e, t, n);
+		return this._getScope().compare?.(e, t, n) ?? O.compare(e, t, n);
 	}
 	getRuntime() {
 		return this._getScope().getRuntime();
 	}
+	createRichData(e, t) {
+		let n = this._getScope();
+		return n.createRichData ? n.createRichData(e, t) : O.createRichData(e, t);
+	}
 	getArgs() {
 		let e = this._argsFn, t = e ? e() : null;
-		if (!t) throw new S(x);
+		if (!t) throw new w(S);
 		return t;
 	}
 	get [Symbol.toStringTag]() {
@@ -643,7 +693,7 @@ var v = class {
 	toString() {
 		return this._getScope()?.toString?.() ?? "{STUB SCOPE}";
 	}
-}, O = Object.freeze({
+}, A = Object.freeze({
 	tag: "en-US",
 	numberingSystem: "latn",
 	decimal: ".",
@@ -723,5 +773,5 @@ var v = class {
 		sensitivity: "base",
 		numeric: !0
 	})
-}), 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 };
+}), j = new k();
+export { A as DEFAULT_LOCALE_PROFILE, j as FormulaContext, i as FormulaError, t as IRange, r as IRangeStats, o as InteropScalarType, v as Observable, e as Scalar, a as ScalarType, k as ScopedFormulaContext, y as StubbedFormulaContext, s as ValueKind, u as WildCard, d as isLazyValue };