@sheetxl/studio-vanilla 0.8.0-beta.10 → 0.8.0-beta.12

package/{browser/esm/DEvZj68igS7Q8SZE.mjs → cdn/assets/CaQrZOnzyAelKzTt.js}

@@ -1,11 +1,11 @@
 /**
-* @license @sheetxl/studio-vanilla - SheetXL Studio - Vanilla entry point for integrating SheetXL UI. - v0.8.0-beta.10
+* @license @sheetxl/studio-vanilla - SheetXL Studio - Vanilla entry point for integrating SheetXL UI. - v0.8.0-beta.12
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
 * License: The license can be found at https://www.sheetxl.com/license.
 */
-import { P as e } from "./CMxbiQ5J79M3n1tk.mjs";
-import { c as t, o as n, t as r } from "./BAH_cWcQEIBKWnl6.mjs";
+import { G as e } from "./Cif0315haNLmyMj-.js";
+import { c as t, n, o as r } from "./B8-nLKLPjZ7pIJdE.js";
 var i = Object.freeze({
 	NoBody: "SXL1001",
 	Anonymous: "SXL1002",
@@ -16,7 +16,6 @@ var i = Object.freeze({
 	MissingType: "SXL2004",
 	UntypedArray: "SXL2005",
 	GenericArity: "SXL2006",
-	MultipleModifiers: "SXL2007",
 	ContextNotFirst: "SXL2010",
 	MultipleLambda: "SXL2020",
 	LambdaNotLast: "SXL2021",
@@ -119,7 +118,7 @@ function s(e) {
 }
 var c = /* @__PURE__ */ new Map([["IReferenceRange", "p"], ["IRange", "r"]]), l = new Set(Object.values(t).filter((e) => e !== t.Omitted)), u = /* @__PURE__ */ new Map([
 	["IWorkbook", "workbook"],
-	["ISheet", "sheet"],
+	["IWorksheet", "sheet"],
 	["ICellRanges", "ranges"],
 	["ICellRange", "range"]
 ]), d = Array.from(u.keys()), f = (e, t) => {
@@ -130,20 +129,15 @@ var c = /* @__PURE__ */ new Map([["IReferenceRange", "p"], ["IRange", "r"]]), l
 }, p = /* @__PURE__ */ new Map([
 	["Scalar", "*"],
 	["Lambda", "l"],
-	["FormulaError.Known", r.Error],
-	["Date", n.Date],
-	["IRichData", n.RichData]
+	["FormulaError.Known", n.Error],
+	["Date", r.Date],
+	["IRichData", r.RichData]
 ]), m = /* @__PURE__ */ new Map([["Repeating", "repeating"]]), h = /* @__PURE__ */ new Set(["Flatten", "SheetXL.Flatten"]), g = /* @__PURE__ */ new Set(["AcceptError"]), _ = /* @__PURE__ */ new Set(["Omittable"]), v = /* @__PURE__ */ new Set(["NoLift"]), y = /* @__PURE__ */ new Set(["NoFilter"]), b = /* @__PURE__ */ new Set(["Lazy"]), x = /* @__PURE__ */ new Set(["ReportType"]), S = /^[a-zA-Z_-￿][a-zA-Z0-9_.-￿]*$/, C = /^([a-z]{1,3})([0-9]+)$/i, w = /^r[0-9]*c[0-9]*$/i, T = "SheetXL", E = (e) => {
 	let t = e.typeName.getText();
 	return t.startsWith(`${T}.`) ? t.slice(8) : t;
 };
 f(T, c), f(T, u), f(T, m), g.add(T + ".AcceptError"), _.add(`${T}.Omittable`), v.add(`${T}.NoLift`), y.add(`${T}.NoFilter`), b.add(`${T}.Lazy`), x.add(`${T}.ReportType`);
-var D = /* @__PURE__ */ new Map([
-	["Promise", () => ({ async: !0 })],
-	["Observable", () => ({ stream: !0 })],
-	["Volatile", () => ({ volatile: !0 })],
-	[`${T}.Volatile`, () => ({ volatile: !0 })]
-]), O = "__scriptContext__", k = "script", A = /* @__PURE__ */ new Set([
+var D = /* @__PURE__ */ new Map([["Volatile", () => ({ volatile: !0 })], [`${T}.Volatile`, () => ({ volatile: !0 })]]), O = "__scriptContext__", k = "script", A = /* @__PURE__ */ new Set([
 	"IScript.ScriptContext",
 	`${T}.IScript.ScriptContext`,
 	"ScriptContext"
@@ -177,7 +171,7 @@ var D = /* @__PURE__ */ new Map([
 	}
 	return t.replace(/\r\n?/g, "\n").split(/\n[^\S\n]*\n\s*/).map((e) => e.split("\n").map((e) => e.trim()).filter(Boolean).join(" ")).filter(Boolean).join("\n").trim();
 };
-function N(t, n, a, o) {
+function N(t, r, a, o) {
 	let f = o?.builtInNames?.length ? new Set(o.builtInNames.map((e) => e.toUpperCase())) : null, N = [], P = /* @__PURE__ */ new Map(), F = [], I = null, L = (e, t, n, r) => {
 		let { start: i, length: a } = ((e) => {
 			if (!e || typeof e.getStart != "function") return {
@@ -205,46 +199,46 @@ function N(t, n, a, o) {
 		});
 	}, R = (e, t, n) => {
 		L(e, t, "error", n);
-	}, z = (e) => e?.parent?.name?.escapedText, B = (e, t, n, r, a = !1, o = !1, s = !1) => {
-		let c = { count: 0 }, l = Z(e, t, n, r, c, a, o, s);
+	}, z = (e) => e?.parent?.name?.escapedText, B = null, V = (e, t, n, r, a = !1, o = !1, s = !1) => {
+		let c = { count: 0 }, l = Q(e, t, n, r, c, a, o, s);
 		c.count >= 2 && (t.range || (t.range = "m", c.count -= 2), !r && c.count >= 1 && (--c.count, c.count > 0 && R(e, i.ArrayDepth, `Arrays of more than 2 dimensions are not supported: '${z(e)}'.`))), c.count > 0 && (t.arrayDepth = c.count);
 		let u = t.enum;
-		return u && (c.count > +!!s || t.range) && !K.has(t) && (t.valueOrRange || (R(e, i.EnumPosition, `A list cannot hold the enum '${u.id}': '${t.name ?? z(e)}'. Its members reach the body as they are, so nothing checks them against the enum. Take one value per argument ('...x: ${u.id}[]'), or type the list by its scalar ('${u.type}').`), delete t.enum)), l;
-	}, V = (e, n, r, i, a) => {
+		return u && (c.count > +!!s || t.range) && !q.has(t) && (t.valueOrRange || (R(e, i.EnumPosition, `A list cannot hold the enum '${u.id}': '${t.name ?? z(e)}'. Its members reach the body as they are, so nothing checks them against the enum. Take one value per argument ('...x: ${u.id}[]'), or type the list by its scalar ('${u.type}').`), delete t.enum)), l;
+	}, H = (e, n, r, i, a) => {
 		if (n !== "Lambda" && n !== `${T}.Lambda`) return !1;
 		let o = e.typeArguments, s = "*";
 		if (o && o.length === 2) {
 			if (a && o[0].kind === t.SyntaxKind.TupleType && (r.lambdaArity = o[0].elements.length), o[1].kind === t.SyntaxKind.AnyKeyword) s = "raw";
 			else {
 				let e = {};
-				Z(o[1], e, i, !1, { count: 0 }), s = e.scalar ?? "*";
+				Q(o[1], e, i, !1, { count: 0 }), s = e.scalar ?? "*";
 			}
 		} else if (o && o.length === 1 && o[0].kind !== t.SyntaxKind.TupleType && o[0].kind !== t.SyntaxKind.ArrayType) {
 			if (a && (r.lambdaArity = 2), o[0].kind === t.SyntaxKind.AnyKeyword) s = "raw";
 			else {
 				let e = {};
-				Z(o[0], e, i, !1, { count: 0 }), s = e.scalar ?? "*";
+				Q(o[0], e, i, !1, { count: 0 }), s = e.scalar ?? "*";
 			}
 		}
 		return r.lambda = s, !0;
-	}, H = /* @__PURE__ */ new Map(), U = /* @__PURE__ */ new Map(), W = /* @__PURE__ */ new Map(), G = /* @__PURE__ */ new Set(), K = /* @__PURE__ */ new WeakSet(), q = (e) => e !== void 0 && e.getSourceFile() === n, J = (t, n = !1) => t.getJsDocTags(a).find((e) => e.name === "name")?.text?.map((e) => e.text).join("").trim() || (n ? e.camelToPrettyCase(t.name) : t.name), Y = (e) => {
+	}, U = /* @__PURE__ */ new Map(), W = /* @__PURE__ */ new Map(), G = /* @__PURE__ */ new Map(), K = /* @__PURE__ */ new Set(), q = /* @__PURE__ */ new WeakSet(), J = (e) => e !== void 0 && e.getSourceFile() === r, Y = (t, n = !1) => t.getJsDocTags(a).find((e) => e.name === "name")?.text?.map((e) => e.text).join("").trim() || (n ? e.camelToPrettyCase(t.name) : t.name), X = (e) => {
 		let t = e.getJsDocTags(a).find((e) => e.name === "deprecated");
 		if (t) return t.text?.map((e) => e.text).join("").trim() || !0;
-	}, X = (e, o) => {
+	}, Z = (e, o) => {
 		let s = t.isTypeReferenceNode(e) ? e.typeName : void 0, c = s ? a.getSymbolAtLocation(s) : void 0, l = c?.declarations?.length ? c : void 0;
 		if (s) {
 			if (l && l.flags & t.SymbolFlags.Alias) return void R(e, i.EnumNotLocal, `'${s.getText()}' is imported, so its declaration cannot be read: '${o}'. An enum must be declared in the module that uses it.`);
 			if (!(l && l.flags & t.SymbolFlags.Type)) {
-				let r = s.getText();
-				return (l ? (l.flags & t.SymbolFlags.Variable) !== 0 : n.statements.some((e) => t.isVariableStatement(e) && e.declarationList.declarations.some((e) => t.isIdentifier(e.name) && e.name.text === r))) ? void R(e, i.EnumMissingAlias, `'${r}' is a value, not a type: '${o}'. Pair the object with a same-name type — 'type ${r} = typeof ${r}[keyof typeof ${r}];' — or declare it as 'enum ${r} { … }'.`) : null;
+				let n = s.getText();
+				return (l ? (l.flags & t.SymbolFlags.Variable) !== 0 : r.statements.some((e) => t.isVariableStatement(e) && e.declarationList.declarations.some((e) => t.isIdentifier(e.name) && e.name.text === n))) ? void R(e, i.EnumMissingAlias, `'${n}' is a value, not a type: '${o}'. Pair the object with a same-name type — 'type ${n} = typeof ${n}[keyof typeof ${n}];' — or declare it as 'enum ${n} { … }'.`) : null;
 			}
-			let r = H.get(l);
-			if (r !== void 0) return r;
-			if (G.has(l)) return;
+			let n = U.get(l);
+			if (n !== void 0) return n;
+			if (K.has(l)) return;
 		}
 		let u = [], d = !1;
 		if (l && l.flags & t.SymbolFlags.Enum) {
-			if (!l.declarations?.some(q)) return void R(e, i.EnumNotLocal, `'${l.name}' is not declared in this module: '${o}'. An enum must be declared in the module that uses it.`);
+			if (!l.declarations?.some(J)) return void R(e, i.EnumNotLocal, `'${l.name}' is not declared in this module: '${o}'. An enum must be declared in the module that uses it.`);
 			d = !0;
 			let n = !1;
 			if (l.exports?.forEach((e) => {
@@ -253,17 +247,17 @@ function N(t, n, a, o) {
 				let o = a.getConstantValue(r);
 				if (o === void 0) return R(r, i.EnumMemberNotConstant, `'${l.name}.${e.name}' is not a constant number or string. A formula passes the VALUE, so every member needs one that can be read at compile time.`), void (n = !0);
 				u.push([
-					J(e, !0),
+					Y(e, !0),
 					o,
 					r,
 					M(e.getDocumentationComment(a)),
-					Y(e)
+					X(e)
 				]);
-			}), n) return void G.add(l);
+			}), n) return void K.add(l);
 		} else {
 			let n = a.getTypeFromTypeNode(e), r = t.TypeFlags.Null | t.TypeFlags.Undefined | t.TypeFlags.Void, i = (n.isUnion() ? n.types : [n]).filter((e) => !(e.flags & r)), o = [];
 			for (let e of i) {
-				if (!(e.flags & (t.TypeFlags.NumberLiteral | t.TypeFlags.StringLiteral))) return l && H.set(l, null), null;
+				if (!(e.flags & (t.TypeFlags.NumberLiteral | t.TypeFlags.StringLiteral))) return l && U.set(l, null), null;
 				o.push(e.value);
 			}
 			if (o.length === 0) return null;
@@ -279,16 +273,16 @@ function N(t, n, a, o) {
 				o.sort((e, n) => t(e) - t(n));
 			}
 			let f = l && l.flags & t.SymbolFlags.Variable ? l.valueDeclaration : void 0, p = new Set(o);
-			if (l && f && q(f)) for (let e of a.getTypeOfSymbolAtLocation(l, f).getProperties()) {
+			if (l && f && J(f)) for (let e of a.getTypeOfSymbolAtLocation(l, f).getProperties()) {
 				let n = e.valueDeclaration, r = a.getTypeOfSymbolAtLocation(e, n ?? f);
 				if (!(r.flags & (t.TypeFlags.NumberLiteral | t.TypeFlags.StringLiteral))) continue;
 				let i = r.value;
 				o.includes(i) && (d = !0, p.delete(i), u.push([
-					J(e, !0),
+					Y(e, !0),
 					i,
 					n,
 					M(e.getDocumentationComment(a)),
-					Y(e)
+					X(e)
 				]));
 			}
 			for (let e of o) p.has(e) && u.push([
@@ -301,7 +295,7 @@ function N(t, n, a, o) {
 		if (u.length === 0) return null;
 		let f = typeof u[0][1] == "number";
 		if (u.some(([, e]) => typeof e == "number" !== f)) return void R(e, i.EnumMixed, `'${l?.name ?? e.getText()}' mixes number and string members: '${o}'. A parameter has one type, so an enum is all numbers or all strings.`);
-		let p = l ? J(l) : u.map(([, e]) => String(e)).join("|"), m = l ? void 0 : U.get(p);
+		let p = l ? Y(l) : u.map(([, e]) => String(e)).join("|"), m = l ? void 0 : W.get(p);
 		if (m) return m;
 		if (d) {
 			let t = /* @__PURE__ */ new Map();
@@ -312,116 +306,116 @@ function N(t, n, a, o) {
 		}
 		let h = {
 			id: p,
-			type: f ? r.Number : r.String,
+			type: f ? n.Number : n.String,
 			members: u.map(([e, t, , , n]) => n ? [
 				e,
 				t,
 				n
 			] : [e, t])
 		};
-		l ? H.set(l, h) : U.set(p, h);
+		l ? U.set(l, h) : W.set(p, h);
 		let g = l ? M(l.getDocumentationComment(a)) : "", _ = {};
 		for (let [e, , , t] of u) t && (_[e] = { description: t });
 		if (g || Object.keys(_).length > 0) {
 			let e = {};
-			g && (e.summary = g), Object.keys(_).length > 0 && (e.members = _), W.set(h, e);
+			g && (e.summary = g), Object.keys(_).length > 0 && (e.members = _), G.set(h, e);
 		}
 		return h;
-	}, Z = (e, n, a, o, s, l = !1, f = !1, S = !1) => {
+	}, Q = (e, r, a, o, s, l = !1, f = !1, S = !1) => {
 		if (e) {
-			if (e.kind === t.SyntaxKind.ParenthesizedType) return Z(e.type, n, a, o, s, l, f, S);
+			if (e.kind === t.SyntaxKind.ParenthesizedType) return Q(e.type, r, a, o, s, l, f, S);
 			if (e.kind === t.SyntaxKind.UnionType) {
-				let r = (e) => e.kind === t.SyntaxKind.UndefinedKeyword || e.kind === t.SyntaxKind.VoidKeyword || e.kind === t.SyntaxKind.NullKeyword || e.kind === t.SyntaxKind.LiteralType && e.literal?.kind === t.SyntaxKind.NullKeyword, u = e.types.filter((e) => !r(e));
-				if (u.length === 1) return Z(u[0], n, a, o, s, l, f, S);
-				let d = X(e, n.name ?? z(e));
+				let n = (e) => e.kind === t.SyntaxKind.UndefinedKeyword || e.kind === t.SyntaxKind.VoidKeyword || e.kind === t.SyntaxKind.NullKeyword || e.kind === t.SyntaxKind.LiteralType && e.literal?.kind === t.SyntaxKind.NullKeyword, u = e.types.filter((e) => !n(e));
+				if (u.length === 1) return Q(u[0], r, a, o, s, l, f, S);
+				let d = Z(e, r.name ?? z(e));
 				if (d === void 0) return;
-				if (d !== null) return n.scalar = d.type, void (o && (n.enum = d));
-				if (!o) return void (n.scalar = "*");
+				if (d !== null) return r.scalar = d.type, void (o && (r.enum = d));
+				if (!o) return void (r.scalar = "*");
 				if (u.length === 2) {
-					let e = (e) => e.kind === t.SyntaxKind.TypeReference && t.isTypeReferenceNode(e) && E(e) === "Lambda", r = u.findIndex(e);
-					if (r >= 0 && !e(u[1 - r])) return Z(u[1 - r], n, a, o, s, l, f, S), void V(u[r], E(u[r]), n, a, o);
+					let e = (e) => e.kind === t.SyntaxKind.TypeReference && t.isTypeReferenceNode(e) && E(e) === "Lambda", n = u.findIndex(e);
+					if (n >= 0 && !e(u[1 - n])) return Q(u[1 - n], r, a, o, s, l, f, S), void H(u[n], E(u[n]), r, a, o);
 				}
 				if (o && u.length === 2) {
 					let e = (e) => {
 						if (e.kind === t.SyntaxKind.TypeReference && !e.typeArguments?.length) return c.get(E(e));
-					}, r = u.findIndex((t) => e(t) !== void 0);
-					if (r >= 0 && e(u[1 - r]) === void 0) {
+					}, n = u.findIndex((t) => e(t) !== void 0);
+					if (n >= 0 && e(u[1 - n]) === void 0) {
 						let t = {}, i = s.count;
-						if (Z(u[1 - r], t, a, o, s, l, !1), t.scalar && !t.range && t.lambda == null && s.count === i) {
-							n.range = e(u[r]), n.scalar = t.scalar, n.valueOrRange = !0;
+						if (Q(u[1 - n], t, a, o, s, l, !1), t.scalar && !t.range && t.lambda == null && s.count === i) {
+							r.range = e(u[n]), r.scalar = t.scalar, r.valueOrRange = !0;
 							let i = t.enum;
-							i && (n.enum = i);
+							i && (r.enum = i);
 							return;
 						}
 					}
 				}
 				if (o && u.length === 2) {
-					let r = (e) => e.kind === t.SyntaxKind.TypeReference && !e.typeArguments?.length && E(e) === "Scalar", i = u.findIndex(r);
-					if (i >= 0 && !r(u[1 - i])) {
-						let t = X(u[1 - i], n.name ?? z(e));
+					let n = (e) => e.kind === t.SyntaxKind.TypeReference && !e.typeArguments?.length && E(e) === "Scalar", i = u.findIndex(n);
+					if (i >= 0 && !n(u[1 - i])) {
+						let t = Z(u[1 - i], r.name ?? z(e));
 						if (t === void 0) return;
-						if (t !== null) return n.scalar = "*", void (n.enum = t);
+						if (t !== null) return r.scalar = "*", void (r.enum = t);
 					}
 				}
 				R(e, i.InvalidParamType, `Union parameter types are not supported: '${z(e)}'. Use a single type, optionally with '| null' or '| undefined', 'T | Lambda<…>' for a value-or-lambda slot, 'IRange | Scalar' for a value-or-range slot, or 'E | Scalar' for an uncoerced slot whose values an enum documents.`);
 				return;
 			}
-			if (e.kind === t.SyntaxKind.NumberKeyword) n.scalar = r.Number;
-			else if (e.kind === t.SyntaxKind.StringKeyword) n.scalar = r.String;
-			else if (e.kind === t.SyntaxKind.BooleanKeyword) n.scalar = r.Boolean;
+			if (e.kind === t.SyntaxKind.NumberKeyword) r.scalar = n.Number;
+			else if (e.kind === t.SyntaxKind.StringKeyword) r.scalar = n.String;
+			else if (e.kind === t.SyntaxKind.BooleanKeyword) r.scalar = n.Boolean;
 			else if (e.kind === t.SyntaxKind.UndefinedKeyword || e.kind === t.SyntaxKind.NullKeyword || e.kind === t.SyntaxKind.VoidKeyword) {
 				if (o) return void R(e, i.UndefinedInput, `'undefined' is not a valid type for input: '${z(e)}'.`);
-				n.scalar = r.Null;
-			} else if (e.kind === t.SyntaxKind.BigIntKeyword) n.scalar = r.Number;
-			else if (e.kind === t.SyntaxKind.AnyKeyword) o && (n.range = "*");
+				r.scalar = n.Null;
+			} else if (e.kind === t.SyntaxKind.BigIntKeyword) r.scalar = n.Number;
+			else if (e.kind === t.SyntaxKind.AnyKeyword) o && (r.range = "*");
 			else if (e.kind === t.SyntaxKind.ArrayType) {
 				let t = e.elementType;
 				if (!t) return void R(e, i.UntypedArray, `'Array' must be typed: '${z(e)}'.`);
 				if (o && f) {
-					let r = n, i = r.name ?? z(e) ?? "parameter", o = r.acceptError;
-					delete r.acceptError;
+					let n = r, i = n.name ?? z(e) ?? "parameter", o = n.acceptError;
+					delete n.acceptError;
 					let s = { name: i };
-					B(t, s, a, !0), o && !s.acceptError && (s.acceptError = !0), r.repeating = [s];
+					V(t, s, a, !0), o && !s.acceptError && (s.acceptError = !0), n.repeating = [s];
 					return;
 				}
-				s.count++, Z(t, n, a, o, s);
+				s.count++, Q(t, r, a, o, s);
 			} else if (e.kind !== t.SyntaxKind.TupleType) {
 				if (e.kind === t.SyntaxKind.TypeReference) {
-					let r = E(e);
-					if (g.has(r)) {
+					let n = E(e);
+					if (g.has(n)) {
 						let t = z(e);
-						if (!o) return void R(e, i.InvalidReturnType, `'${r}' is not a valid return type: '${t}'. It describes how an ARGUMENT is received.`);
-						let c = n;
+						if (!o) return void R(e, i.InvalidReturnType, `'${n}' is not a valid return type: '${t}'. It describes how an ARGUMENT is received.`);
+						let c = r;
 						if (c.acceptError) return void R(e, i.InvalidParamType, `'${t}' declares 'AcceptError' more than once.`);
 						let u = e.typeArguments;
-						return u && u.length === 1 ? (c.acceptError = !0, Z(u[0], n, a, o, s, l, f, S)) : void R(e, i.GenericArity, `'${r}' must be typed with exactly 1 type: '${t}'.`);
+						return u && u.length === 1 ? (c.acceptError = !0, Q(u[0], r, a, o, s, l, f, S)) : void R(e, i.GenericArity, `'${n}' must be typed with exactly 1 type: '${t}'.`);
 					}
-					if (x.has(r)) {
-						let t = n.name ?? z(e);
+					if (x.has(n)) {
+						let t = r.name ?? z(e);
 						if (!o) return void R(e, i.InvalidReturnType, `'ReportType' is not a valid return type: '${t}'. It describes how an ARGUMENT is received.`);
 						let c = e.typeArguments;
-						return c && c.length === 1 ? (n.reportType = !0, Z(c[0], n, a, o, s, l, f, S)) : void R(e, i.GenericArity, `'${r}' must be typed with exactly 1 type: '${t}'.`);
+						return c && c.length === 1 ? (r.reportType = !0, Q(c[0], r, a, o, s, l, f, S)) : void R(e, i.GenericArity, `'${n}' must be typed with exactly 1 type: '${t}'.`);
 					}
-					if (v.has(r)) {
-						let t = n.name ?? z(e);
+					if (v.has(n)) {
+						let t = r.name ?? z(e);
 						if (!o) return void R(e, i.InvalidReturnType, `'NoLift' is not a valid return type: '${t}'. It describes how an ARGUMENT is received.`);
 						let c = e.typeArguments;
-						if (!c || c.length !== 1) return void R(e, i.GenericArity, `'${r}' must be typed with exactly 1 type: '${t}'.`);
-						let u = n;
+						if (!c || c.length !== 1) return void R(e, i.GenericArity, `'${n}' must be typed with exactly 1 type: '${t}'.`);
+						let u = r;
 						u.noLift = !0;
 						let d = s.count;
-						Z(c[0], n, a, o, s, l, f, S), (u.range || u.lambda != null || u.repeating || s.count !== d) && R(e, i.InvalidParamType, `'${t}': 'NoLift' applies to a SCALAR parameter only - a range, list, repeating or lambda slot never lifts.`);
+						Q(c[0], r, a, o, s, l, f, S), (u.range || u.lambda != null || u.repeating || s.count !== d) && R(e, i.InvalidParamType, `'${t}': 'NoLift' applies to a SCALAR parameter only - a range, list, repeating or lambda slot never lifts.`);
 						return;
 					}
-					if (y.has(r)) {
-						let t = n.name ?? z(e);
+					if (y.has(n)) {
+						let t = r.name ?? z(e);
 						if (!o) return void R(e, i.InvalidReturnType, `'NoFilter' is not a valid return type: '${t}'. It describes how an ARGUMENT is received.`);
 						let c = e.typeArguments;
-						if (!c || c.length !== 1) return void R(e, i.GenericArity, `'${r}' must be typed with exactly 1 type: '${t}'.`);
-						let u = n;
+						if (!c || c.length !== 1) return void R(e, i.GenericArity, `'${n}' must be typed with exactly 1 type: '${t}'.`);
+						let u = r;
 						u.noFilter = !0;
 						let d = s.count;
-						if (Z(c[0], n, a, o, s, l, f, S), u.range || u.lambda != null || s.count !== d) return void R(e, i.InvalidParamType, `'${t}': 'NoFilter' applies to a SCALAR slot only - a range, list or lambda slot has no members to coerce.`);
+						if (Q(c[0], r, a, o, s, l, f, S), u.range || u.lambda != null || s.count !== d) return void R(e, i.InvalidParamType, `'${t}': 'NoFilter' applies to a SCALAR slot only - a range, list or lambda slot has no members to coerce.`);
 						let p = u.repeating;
 						if (p) {
 							if (delete u.noFilter, p.length !== 1) return void R(e, i.InvalidParamType, `'${t}': 'NoFilter' over a repeating group applies to a period-1 group only - write it on the slot that takes the members.`);
@@ -429,60 +423,60 @@ function N(t, n, a, o) {
 						} else f && R(e, i.InvalidParamType, `'${t}': 'NoFilter' applies to a REPEATING slot only - a single scalar argument has no members to coerce.`);
 						return;
 					}
-					if (_.has(r)) {
-						let c = n.name ?? z(e);
+					if (_.has(n)) {
+						let c = r.name ?? z(e);
 						if (!o) return void R(e, i.InvalidReturnType, `'Omittable' is not a valid return type: '${c}'. It describes how an ARGUMENT is received.`);
 						let u = e.typeArguments;
-						if (!u || u.length < 1 || u.length > 2) return void R(e, i.GenericArity, `'${r}' must be typed with 1 or 2 types: '${c}'.`);
-						let d = n;
+						if (!u || u.length < 1 || u.length > 2) return void R(e, i.GenericArity, `'${n}' must be typed with 1 or 2 types: '${c}'.`);
+						let d = r;
 						if (d.omittable = !0, u.length === 2) {
-							let n = j(t, u[1]);
-							if (n === void 0) return void R(e, i.InvalidParamType, `'${c}' declares '${r}' with a second type that is not a literal value. Use a number, string, boolean or null - the engine substitutes it for an omitted argument.`);
-							d.omittedValue = n;
+							let r = j(t, u[1]);
+							if (r === void 0) return void R(e, i.InvalidParamType, `'${c}' declares '${n}' with a second type that is not a literal value. Use a number, string, boolean or null - the engine substitutes it for an omitted argument.`);
+							d.omittedValue = r;
 						}
-						let p = Z(u[0], n, a, o, s, l, f, S), m = d.omittedValue;
+						let p = Q(u[0], r, a, o, s, l, f, S), m = d.omittedValue;
 						return d.enum && m != null && !d.enum.members.some(([, e]) => e === m) && R(u[1], i.EnumOmittedValue, `'${c}': ${JSON.stringify(m)} is not a member of '${d.enum.id}'. An omitted argument must mean a member (${d.enum.members.map(([, e]) => JSON.stringify(e)).join(", ")}) or null.`), p;
 					}
-					if (b.has(r)) {
-						let c = n.name ?? z(e);
+					if (b.has(n)) {
+						let c = r.name ?? z(e);
 						if (!o) return void R(e, i.InvalidReturnType, `'Lazy' is not a valid return type: '${c}'. It describes how an ARGUMENT is received.`);
-						let u = n;
+						let u = r;
 						if (u.lazy) return void R(e, i.InvalidParamType, `'${c}' declares 'Lazy' more than once.`);
 						let d = e.typeArguments;
-						if (!d || d.length < 1 || d.length > 2) return void R(e, i.GenericArity, `'${r}' must be typed with 1 or 2 types: '${c}'.`);
+						if (!d || d.length < 1 || d.length > 2) return void R(e, i.GenericArity, `'${n}' must be typed with 1 or 2 types: '${c}'.`);
 						if (u.lazy = !0, d.length === 2) {
-							let n = j(t, d[1]);
-							if (n === void 0) return void R(e, i.InvalidParamType, `'${c}' declares '${r}' with a second type that is not a literal value. Use a number, string, boolean or null - the engine substitutes it for an absent argument.`);
-							u.optional = !0, u.defaultValue = n;
+							let r = j(t, d[1]);
+							if (r === void 0) return void R(e, i.InvalidParamType, `'${c}' declares '${n}' with a second type that is not a literal value. Use a number, string, boolean or null - the engine substitutes it for an absent argument.`);
+							u.optional = !0, u.defaultValue = r;
 						}
-						Z(d[0], n, a, o, s, l, f, S), u.enum ? (R(e, i.EnumPosition, `'${c}': 'Lazy' cannot hold the enum '${u.enum.id}'. The argument may never be evaluated, so there is no point at which it could be checked against the members.`), delete u.enum) : u.lambda == null ? u.repeating && R(e, i.InvalidParamType, `'${c}': 'Lazy' applies to a VALUE, not to a repeating group - mark the group's slots instead.`) : R(e, i.InvalidParamType, `'${c}': 'Lazy' cannot be combined with a Lambda parameter - a callable slot is already the body's to call, or not.`);
+						Q(d[0], r, a, o, s, l, f, S), u.enum ? (R(e, i.EnumPosition, `'${c}': 'Lazy' cannot hold the enum '${u.enum.id}'. The argument may never be evaluated, so there is no point at which it could be checked against the members.`), delete u.enum) : u.lambda == null ? u.repeating && R(e, i.InvalidParamType, `'${c}': 'Lazy' applies to a VALUE, not to a repeating group - mark the group's slots instead.`) : R(e, i.InvalidParamType, `'${c}': 'Lazy' cannot be combined with a Lambda parameter - a callable slot is already the body's to call, or not.`);
 						return;
 					}
-					if (h.has(r)) {
-						let t = n.name ?? z(e);
+					if (h.has(n)) {
+						let t = r.name ?? z(e);
 						if (!o) return void R(e, i.InvalidReturnType, `'Flatten' is not a valid return type: '${t}'. It describes how an ARGUMENT is received.`);
 						let c = e.typeArguments;
-						return c && c.length === 1 ? (s.count++, Z(c[0], n, a, o, s, l)) : void R(e, i.GenericArity, `'${r}' must be typed with exactly 1 type: '${t}'.`);
+						return c && c.length === 1 ? (s.count++, Q(c[0], r, a, o, s, l)) : void R(e, i.GenericArity, `'${n}' must be typed with exactly 1 type: '${t}'.`);
 					}
-					if (m.get(r) === "repeating") {
-						let c = n.name ?? z(e);
+					if (m.get(n) === "repeating") {
+						let c = r.name ?? z(e);
 						if (!o) return void R(e, i.RepeatingPosition, `'Repeating' is not a valid return type: '${c}'.`);
 						if (s.count !== 0) return void R(e, i.RepeatingPosition, `'Repeating' cannot be nested inside another type: '${c}'.`);
-						let u = n, d = e.typeArguments;
-						if (!d || d.length < 1 || d.length > 2) return void R(e, i.GenericArity, `'${r}' must be typed with 1 type, optionally followed by a maximum argument count: '${c}'.`);
+						let u = r, d = e.typeArguments;
+						if (!d || d.length < 1 || d.length > 2) return void R(e, i.GenericArity, `'${n}' must be typed with 1 type, optionally followed by a maximum argument count: '${c}'.`);
 						let p;
 						if (d.length === 2) {
-							let e = d[1], n = e.kind === t.SyntaxKind.LiteralType ? e.literal : null, o = n && n.kind === t.SyntaxKind.NumericLiteral ? Number(n.text) : NaN;
-							if (!Number.isInteger(o) || o < 1 || o > 255) return void R(e, i.RepeatingMax, `'${c}': '${r}'’s maximum must be a whole number between 1 and 255.`);
+							let e = d[1], r = e.kind === t.SyntaxKind.LiteralType ? e.literal : null, o = r && r.kind === t.SyntaxKind.NumericLiteral ? Number(r.text) : NaN;
+							if (!Number.isInteger(o) || o < 1 || o > 255) return void R(e, i.RepeatingMax, `'${c}': '${n}'’s maximum must be a whole number between 1 and 255.`);
 							p = o, a.maxArguments = o;
 						}
-						if (S) return p === void 0 ? void R(e, i.RepeatingPosition, `'${c}' is a rest parameter and a repeating group. A group already repeats — drop the '...', or give the group a maximum ('Repeating<T, 254>') if the ceiling is all you meant.`) : Z(d[0], n, a, o, s, l, f);
+						if (S) return p === void 0 ? void R(e, i.RepeatingPosition, `'${c}' is a rest parameter and a repeating group. A group already repeats — drop the '...', or give the group a maximum ('Repeating<T, 254>') if the ceiling is all you meant.`) : Q(d[0], r, a, o, s, l, f);
 						let m = u.acceptError;
 						delete u.acceptError;
 						let h = ((e, n, r, a) => {
 							let o = (e, t, n) => {
 								let i = { name: e };
-								return B(t, i, r, !0), n && (i.optional = !0), a && !i.acceptError && (i.acceptError = !0), i;
+								return V(t, i, r, !0), n && (i.optional = !0), a && !i.acceptError && (i.acceptError = !0), i;
 							};
 							if (e.kind !== t.SyntaxKind.TupleType) return [o(n, e, !1)];
 							let s = e.elements;
@@ -500,53 +494,50 @@ function N(t, n, a, o) {
 						h && (u.repeating = h);
 						return;
 					}
-					let C = c.get(r), w = !1;
-					C && (n.range = C, w = !0);
-					let k = p.get(r);
-					if (k && (n.scalar = k), k !== void 0 && (w = !0), V(e, r, n, a, o)) return;
+					let C = c.get(n), w = !1;
+					C && (r.range = C, w = !0);
+					let k = p.get(n);
+					if (k && (r.scalar = k), k !== void 0 && (w = !0), H(e, n, r, a, o)) return;
 					if (o) {
-						if (r === "Volatile" || r === `${T}.Volatile`) return void R(e, i.InvalidParamType, `'Volatile' is not a valid parameter type: '${z(e)}'. It describes the function's RESULT, so it belongs on the return type.`);
-						if (A.has(r)) return O;
-						let t = u.get(r);
+						if (n === "Volatile" || n === `${T}.Volatile`) return void R(e, i.InvalidParamType, `'Volatile' is not a valid parameter type: '${z(e)}'. It describes the function's RESULT, so it belongs on the return type.`);
+						if (A.has(n)) return O;
+						let t = u.get(n);
 						if (t) return t;
-					} else {
-						let t = D.get(r);
-						if (t) {
-							let a = Object.assign(n, t()), o = 0;
-							if (a.async && o++, a.stream && o++, o > 1) return void R(e, i.MultipleModifiers, `'${r}' cannot have multiple modifiers: '${z(e)}'.`);
-							w = !0;
-						}
+					} else if (n === "Promise") B = e, w = !0;
+					else {
+						let e = D.get(n);
+						e && (Object.assign(r, e()), w = !0);
 					}
 					if (!w) {
-						let t = X(e, n.name ?? z(e));
+						let t = Z(e, r.name ?? z(e));
 						if (t === void 0) return;
-						if (t !== null) return n.scalar = t.type, void (o && (n.enum = t));
+						if (t !== null) return r.scalar = t.type, void (o && (r.enum = t));
 					}
 					if (!w) {
-						let t = "number, string, boolean, Scalar, Lambda, Date, FormulaError.Known, IRichData, IRange, IReferenceRange (and arrays of these; optionally wrapped in AcceptError<T>, or grouped with Repeating<T>)", n;
-						n = o ? l ? `'${r}' is not a valid first parameter: '${z(e)}'. The first parameter is EITHER a macro target (making this a macro) OR a calculation input (making this a calculation function). Allowed: ${d.join(", ")} (macro target); ${t} (calculation input).` : `'${r}' is not a valid parameter type: '${z(e)}'. Allowed: ${t}.` : `'${r}' is not a valid return type: '${z(e)}'. Allowed: number, string, boolean, Scalar, Date, FormulaError.Known, IRichData, IRange, Promise<T>, Observable<T>, Volatile<T> (and arrays of these).`, R(e, o ? i.InvalidParamType : i.InvalidReturnType, n);
+						let t = "number, string, boolean, Scalar, Lambda, Date, FormulaError.Known, IRichData, IRange, IReferenceRange (and arrays of these; optionally wrapped in AcceptError<T>, or grouped with Repeating<T>)", r;
+						r = o ? l ? `'${n}' is not a valid first parameter: '${z(e)}'. The first parameter is EITHER a macro target (making this a macro) OR a calculation input (making this a calculation function). Allowed: ${d.join(", ")} (macro target); ${t} (calculation input).` : `'${n}' is not a valid parameter type: '${z(e)}'. Allowed: ${t}.` : `'${n}' is not a valid return type: '${z(e)}'. Allowed: number, string, boolean, Scalar, Date, FormulaError.Known, IRichData, IRange, Volatile<T> (and arrays of these).`, R(e, o ? i.InvalidParamType : i.InvalidReturnType, r);
 						return;
 					}
 					let M = e.typeArguments;
 					if (M) {
-						if (M.length !== 1) return void R(e, i.GenericArity, `'${r}' must be typed with exactly 1 type: '${z(e)}'.`);
-						let s = M[0], c = o && t.isTypeReferenceNode(s) && x.has(E(s)), l = n.reportType;
-						c && K.add(n), B(s, n, a, o), c && l === void 0 && delete n.reportType;
-						let u = n.enum;
-						u && !c && (R(M[0], i.EnumPosition, `'${r}' cannot hold the enum '${u.id}': '${z(e)}'. The members of a range reach the body as they are, so nothing checks them against the enum. Take the enum as a value, or type the range by its scalar ('${r}<${u.type}>').`), delete n.enum);
+						if (M.length !== 1) return void R(e, i.GenericArity, `'${n}' must be typed with exactly 1 type: '${z(e)}'.`);
+						let s = M[0], c = o && t.isTypeReferenceNode(s) && x.has(E(s)), l = r.reportType;
+						c && q.add(r), V(s, r, a, o), c && l === void 0 && delete r.reportType;
+						let u = r.enum;
+						u && !c && (R(M[0], i.EnumPosition, `'${n}' cannot hold the enum '${u.id}': '${z(e)}'. The members of a range reach the body as they are, so nothing checks them against the enum. Take the enum as a value, or type the range by its scalar ('${n}<${u.type}>').`), delete r.enum);
 					}
 				} else e.kind === t.SyntaxKind.FunctionType && ((e, n, r, a) => {
 					if (!a) return void R(e, i.FunctionReturn, `Function type is not a valid return type: '${z(e)}'. Declare a 'Lambda' return instead.`);
 					let o = e.type, s = {}, c = "*";
-					o && (o.kind === t.SyntaxKind.AnyKeyword ? c = "raw" : (Z(o, s, r, !1, { count: 0 }), c = s.scalar ?? "*"));
+					o && (o.kind === t.SyntaxKind.AnyKeyword ? c = "raw" : (Q(o, s, r, !1, { count: 0 }), c = s.scalar ?? "*"));
 					let l = e.parameters;
 					l && !l.some((e) => e.dotDotDotToken) && (n.lambdaArity = l.length), n.lambda = c;
-				})(e, n, a, o);
+				})(e, r, a, o);
 			}
-		} else R(e, i.MissingType, `Type is not defined for '${n?.name ?? "return"}'.`);
+		} else R(e, i.MissingType, `Type is not defined for '${r?.name ?? "return"}'.`);
 	};
 	try {
-		t.forEachChild(n, (e) => {
+		t.forEachChild(r, (e) => {
 			if (r = e, (t.getCombinedModifierFlags(r) & t.ModifierFlags.Export) !== 0 && t.isFunctionDeclaration(e)) {
 				let r = e?.name?.getText();
 				if (!e.body) return void R(e, i.NoBody, `'${r}': function has no body.`);
@@ -557,7 +548,7 @@ function N(t, n, a, o) {
 					let d = M(a.getSymbolAtLocation(e.name)?.getDocumentationComment(a));
 					d && (u.summary = d);
 					let p = {};
-					B(e.type, p, c, !1), c.returnType = p;
+					B = null, V(e.type, p, c, !1), c.returnType = p;
 					let m = {};
 					n = e, (t.getCombinedModifierFlags(n) & t.ModifierFlags.Default) !== 0 && (m.default = !0, I = r), c.parameters = [];
 					let h = /* @__PURE__ */ new Map(), g = /* @__PURE__ */ new Map(), _ = /* @__PURE__ */ new Set(), v = null, y = null, b = null, x = 0, T = !1, E = 0;
@@ -569,7 +560,7 @@ function N(t, n, a, o) {
 							c.context = k;
 							continue;
 						}
-						let d = B(r.type, s, c, !0, l, !r.dotDotDotToken, !!r.dotDotDotToken);
+						let d = V(r.type, s, c, !0, l, !r.dotDotDotToken, !!r.dotDotDotToken);
 						if (d === O) {
 							n === 0 && c.context === void 0 && (c.context = k);
 							continue;
@@ -620,7 +611,7 @@ function N(t, n, a, o) {
 						let A = { description: "" };
 						u.parameters[s.name] = A, A.description = M(a.getSymbolAtLocation(r.name)?.getDocumentationComment(a)), p !== void 0 && (s.defaultValue = p);
 						for (let e of [s, ...s.repeating ?? []]) {
-							let t = e.enum ? W.get(e.enum) : void 0;
+							let t = e.enum ? G.get(e.enum) : void 0;
 							t && ((u.enums ??= {})[e.enum.id] = t);
 						}
 						if (h.set(s.name, s), g.set(s.name, r), S && S.length > 1) {
@@ -687,6 +678,7 @@ function N(t, n, a, o) {
 							}
 						}
 					}
+					if (!c.context && B) return void R(B, i.InvalidReturnType, `'${r}': Promise<T> is not a valid return type for a calculation function. Return the value the cell shows now, and call FormulaContext.defer(executor, payload) to deliver the result later.`);
 					Object.keys(c.returnType).length === 0 && delete c.returnType, Object.keys(m).length > 0 && (c.behavior = m), u.summary || L(e.name ?? e, i.MissingSummary, "warning", `'${r}': missing a description. Add a JSDoc comment above the function.`);
 					let A = !c.context, j = A && u.name || r;
 					if (A && !S.test(j)) {
@@ -760,4 +752,4 @@ function P(e, t, n) {
 	}), s = o.getTypeChecker(), c = o.getSourceFile(r);
 	return c ? N(e, c, s, n).diagnostics : [];
 }
-export { N as analyzeModule, P as lintScript, i as t };
+export { i, N as n, a as r, P as t };