@plitzi/sdk-shared 0.37.2 → 0.37.4

package/dist/helpers/twigWrapper/filters/filters.mjs

@@ -1,13 +1,13 @@
 //#region src/helpers/twigWrapper/filters/filters.ts
-var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t) => e === t ? 0 : e == null ? -1 : t == null ? 1 : typeof e == "number" && typeof t == "number" ? e - t : String(e).localeCompare(String(t)), r = (e) => e == null ? "" : String(e), i = (e) => {
+var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t) => e === t ? 0 : e == null ? -1 : t == null ? 1 : typeof e == "number" && typeof t == "number" ? e - t : String(e).localeCompare(String(t)), r = (e) => e === void 0 || typeof e == "function" || typeof e == "symbol" ? "null" : typeof e == "bigint" ? e.toString() : JSON.stringify(e), i = (e) => e == null ? "" : String(e), a = (e) => {
 	let t = new TextEncoder().encode(e), n = "";
 	for (let e = 0; e < t.length; e++) n += String.fromCharCode(t[e]);
 	return btoa(n);
-}, a = (e) => {
+}, o = (e) => {
 	let t = atob(e), n = new Uint8Array(t.length);
 	for (let e = 0; e < t.length; e++) n[e] = t.charCodeAt(e);
 	return new TextDecoder().decode(n);
-}, o = (e) => {
+}, s = (e) => {
 	let t = [
 		7,
 		12,
@@ -96,10 +96,10 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 		return t;
 	};
 	return p(c) + p(l) + p(u) + p(d);
-}, s = "__PLITZI_RAW__", c = (e) => typeof e == "object" && !!e && e.__marker === "__PLITZI_RAW__", l = (e) => ({
+}, c = "__PLITZI_RAW__", l = (e) => typeof e == "object" && !!e && e.__marker === "__PLITZI_RAW__", u = (e) => ({
 	__raw: e,
-	__marker: s
-}), u = (e) => c(e) ? e.__raw : e, d = [
+	__marker: c
+}), d = (e) => l(e) ? e.__raw : e, f = [
 	"Sun",
 	"Mon",
 	"Tue",
@@ -107,9 +107,9 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 	"Thu",
 	"Fri",
 	"Sat"
-], f = /* @__PURE__ */ new Map(), p = (e) => {
-	if (!f.has(e)) try {
-		f.set(e, new Intl.DateTimeFormat("en-US", {
+], p = /* @__PURE__ */ new Map(), m = (e) => {
+	if (!p.has(e)) try {
+		p.set(e, new Intl.DateTimeFormat("en-US", {
 			timeZone: e,
 			hourCycle: "h23",
 			year: "numeric",
@@ -121,15 +121,15 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 			weekday: "short"
 		}));
 	} catch {
-		f.set(e, null);
+		p.set(e, null);
 	}
-	return f.get(e) ?? null;
-}, m = (e) => {
+	return p.get(e) ?? null;
+}, h = (e) => {
 	if (e instanceof Date) return e;
 	if (typeof e == "number") return new Date(e);
 	let t = String(e).trim();
 	return /^-?\d+$/.test(t) ? new Date(Number(t)) : new Date(t);
-}, h = (e, t) => {
+}, g = (e, t) => {
 	if (!t) return {
 		year: e.getFullYear(),
 		month: e.getMonth() + 1,
@@ -139,7 +139,7 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 		seconds: e.getSeconds(),
 		weekday: e.getDay()
 	};
-	let n = p(t);
+	let n = m(t);
 	if (!n) return;
 	let r = n.formatToParts(e), i = (e) => r.find((t) => t.type === e)?.value ?? "";
 	return {
@@ -149,12 +149,12 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 		hours: Number(i("hour")),
 		minutes: Number(i("minute")),
 		seconds: Number(i("second")),
-		weekday: d.indexOf(i("weekday"))
+		weekday: f.indexOf(i("weekday"))
 	};
-}, g = {
-	raw: (e) => l(e),
-	to_json: (e) => typeof e == "object" && e ? JSON.stringify(e) : r(e),
-	json_encode: (e) => typeof e == "object" && e ? JSON.stringify(e) : r(e),
+}, _ = {
+	raw: (e) => u(e),
+	to_json: (e) => r(e),
+	json_encode: (e) => r(e),
 	object_as_json: (e) => typeof e == "object" && e ? JSON.stringify(e) : e,
 	default: (e, n) => t(e) ? n[0] : e,
 	upper: (e) => typeof e == "string" ? e.toUpperCase() : e,
@@ -169,21 +169,21 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 	rtrim: (e) => typeof e == "string" ? e.trimEnd() : e,
 	pad: (e, t) => {
 		if (typeof e != "string") return e;
-		let n = Number(t[0]) || 0, i = t.length > 1 ? r(t[1]) : " ";
-		if (i === "") return e;
+		let n = Number(t[0]) || 0, r = t.length > 1 ? i(t[1]) : " ";
+		if (r === "") return e;
 		let a = n - e.length;
 		if (a <= 0) return e;
-		let o = Math.ceil(a / i.length);
-		return i.repeat(o).slice(0, a) + e;
+		let o = Math.ceil(a / r.length);
+		return r.repeat(o).slice(0, a) + e;
 	},
 	padRight: (e, t) => {
 		if (typeof e != "string") return e;
-		let n = Number(t[0]) || 0, i = t.length > 1 ? r(t[1]) : " ";
-		if (i === "") return e;
+		let n = Number(t[0]) || 0, r = t.length > 1 ? i(t[1]) : " ";
+		if (r === "") return e;
 		let a = n - e.length;
 		if (a <= 0) return e;
-		let o = Math.ceil(a / i.length);
-		return e + i.repeat(o).slice(0, a);
+		let o = Math.ceil(a / r.length);
+		return e + r.repeat(o).slice(0, a);
 	},
 	number: (e, t) => {
 		if (typeof e == "number") {
@@ -194,31 +194,31 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 		let n = e.match(/-?\d+(?:\.\d+)?/);
 		return n ? Number(n[0]) : 0;
 	},
-	replace: (e, t) => typeof e != "string" || t.length === 0 ? e : e.split(r(t[0])).join(r(t[1])),
+	replace: (e, t) => typeof e != "string" || t.length === 0 ? e : e.split(i(t[0])).join(i(t[1])),
 	slice: (e, t) => {
 		if (t.length === 0) return e;
 		let n = Number(t[0]) || 0, r = t.length > 1 && Number.isFinite(Number(t[1])) ? n + Number(t[1]) : void 0;
 		return typeof e == "string" || Array.isArray(e) ? e.slice(n, r) : e;
 	},
-	split: (e, t) => typeof e == "string" && t.length > 0 ? e.split(r(t[0])) : e,
-	join: (e, t) => Array.isArray(e) ? e.join(t.length === 0 ? "" : r(t[0])) : e,
+	split: (e, t) => typeof e == "string" && t.length > 0 ? e.split(i(t[0])) : e,
+	join: (e, t) => Array.isArray(e) ? e.join(t.length === 0 ? "" : i(t[0])) : e,
 	reverse: (e) => typeof e == "string" ? e.split("").reverse().join("") : Array.isArray(e) ? [...e].reverse() : e,
-	length: (e) => typeof e == "string" || Array.isArray(e) ? e.length : typeof e == "number" ? r(e).length : typeof e == "object" && e ? Object.keys(e).length : 0,
+	length: (e) => typeof e == "string" || Array.isArray(e) ? e.length : typeof e == "number" ? i(e).length : typeof e == "object" && e ? Object.keys(e).length : 0,
 	first: (e) => typeof e == "string" ? e.length > 0 ? e[0] : "" : Array.isArray(e) ? e.length > 0 ? e[0] : void 0 : e,
 	last: (e) => typeof e == "string" ? e.length > 0 ? e[e.length - 1] : "" : Array.isArray(e) ? e.length > 0 ? e[e.length - 1] : void 0 : e,
 	contains: (e, t) => {
 		if (t.length === 0) return !1;
 		let n = t[0];
-		return typeof e == "string" ? e.includes(r(n)) : Array.isArray(e) ? e.includes(n) : !1;
+		return typeof e == "string" ? e.includes(i(n)) : Array.isArray(e) ? e.includes(n) : !1;
 	},
-	startswith: (e, t) => typeof e == "string" && t.length > 0 && e.startsWith(r(t[0])),
-	endswith: (e, t) => typeof e == "string" && t.length > 0 && e.endsWith(r(t[0])),
+	startswith: (e, t) => typeof e == "string" && t.length > 0 && e.startsWith(i(t[0])),
+	endswith: (e, t) => typeof e == "string" && t.length > 0 && e.endsWith(i(t[0])),
 	number_format: (e, t) => {
 		if (typeof e != "number") return e;
-		let n = Number(t[0]) || 0, i = t[1] == null ? "." : r(t[1]), a = t[2] == null ? "" : r(t[2]), o = e.toFixed(n);
-		if (a === "") return o.replace(".", i);
+		let n = Number(t[0]) || 0, r = t[1] == null ? "." : i(t[1]), a = t[2] == null ? "" : i(t[2]), o = e.toFixed(n);
+		if (a === "") return o.replace(".", r);
 		let s = o.split(".");
-		return s[0] = s[0].replace(/\B(?=(\d{3})+(?!\d))/g, a), s.join(i);
+		return s[0] = s[0].replace(/\B(?=(\d{3})+(?!\d))/g, a), s.join(r);
 	},
 	sort: (t, r) => {
 		if (!Array.isArray(t)) return t;
@@ -265,10 +265,10 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 		if (t.length === 0) return e.filter(Boolean);
 		let n = t[0];
 		if (typeof n == "function") return e.filter((e, t) => n(e, t));
-		let i = r(n);
+		let r = i(n);
 		return e.filter((e) => {
 			if (typeof e == "object" && e) {
-				let t = e[i];
+				let t = e[r];
 				return t != null && t !== !1 && t !== "";
 			}
 			return !!e;
@@ -276,14 +276,14 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 	},
 	column: (e, t) => {
 		if (!Array.isArray(e) || t.length === 0) return e;
-		let n = r(t[0]);
+		let n = i(t[0]);
 		return e.map((e) => typeof e == "object" && e ? e[n] : void 0);
 	},
-	url_encode: (e) => typeof e == "string" ? encodeURIComponent(e) : typeof e == "object" && e && !Array.isArray(e) ? new URLSearchParams(Object.fromEntries(Object.entries(e).map(([e, t]) => [e, r(t)]))).toString() : e,
+	url_encode: (e) => typeof e == "string" ? encodeURIComponent(e) : typeof e == "object" && e && !Array.isArray(e) ? new URLSearchParams(Object.fromEntries(Object.entries(e).map(([e, t]) => [e, i(t)]))).toString() : e,
 	nl2br: (e) => typeof e == "string" ? e.replace(/\n/g, "<br>") : e,
 	striptags: (e, t) => {
 		if (typeof e != "string") return e;
-		let n = t.length > 0 ? r(t[0]).trim() : "";
+		let n = t.length > 0 ? i(t[0]).trim() : "";
 		if (n) {
 			let t = n.split(/(?:\s*>\s*<\s*|<\s*|>\s*)/).filter(Boolean).map((e) => e.replace(/[/>]/g, "").trim());
 			if (t.length > 0) {
@@ -296,106 +296,124 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 	abs: (e) => typeof e == "number" ? Math.abs(e) : e,
 	round: (e, t) => {
 		if (typeof e != "number") return e;
-		let n = Number(t[0]) || 0, i = t[1] == null ? "common" : r(t[1]), a = 10 ** n;
-		return i === "ceil" ? Math.ceil(e * a) / a : i === "floor" ? Math.floor(e * a) / a : Math.round(e * a) / a;
+		let n = Number(t[0]) || 0, r = t[1] == null ? "common" : i(t[1]), a = 10 ** n;
+		return r === "ceil" ? Math.ceil(e * a) / a : r === "floor" ? Math.floor(e * a) / a : Math.round(e * a) / a;
 	},
 	format: (e, t) => {
 		if (typeof e != "string") return e;
 		let n = 0;
-		return e.replace(/%s|%d|%f|%%/g, (e) => {
-			if (e === "%%") return "%";
-			let i = t[n];
-			return n++, i === void 0 ? e : e === "%d" ? String(Math.floor(Number(i))) : e === "%f" ? String(Number(i)) : r(i);
+		return e.replace(/%((?:[-+ 0]|'.)*)(\d*)(?:\.(\d+))?([sdf%])/g, (e, r, a, o, s) => {
+			if (s === "%") return "%";
+			let c = t[n];
+			if (n++, c === void 0) return e;
+			let l = r.includes("+"), u;
+			if (s === "d") {
+				let e = Math.trunc(Number(c));
+				u = `${l && e >= 0 ? "+" : ""}${e}`;
+			} else if (s === "f") {
+				let e = Number(c);
+				u = `${l && e >= 0 ? "+" : ""}${o === void 0 ? String(e) : e.toFixed(Number(o))}`;
+			} else u = i(c), u = o === void 0 ? u : u.slice(0, Number(o));
+			let d = Number(a || 0);
+			if (u.length >= d) return u;
+			let f = /'(.)/.exec(r), p = f ? f[1] : r.includes("0") ? "0" : " ";
+			return r.includes("-") ? u.padEnd(d, p === "0" ? " " : p) : p === "0" && s !== "s" && /^[+-]/.test(u) ? u[0] + u.slice(1).padStart(d - 1, "0") : u.padStart(d, p);
 		});
 	},
 	spaceless: (e) => typeof e == "string" ? e.replace(/>\s+</g, "><").trim() : e,
 	random: (e) => Array.isArray(e) ? e.length > 0 ? e[Math.floor(Math.random() * e.length)] : void 0 : typeof e == "string" ? e.length > 0 ? e[Math.floor(Math.random() * e.length)] : "" : typeof e == "number" ? Math.floor(Math.random() * e) : e,
 	date: (e, t) => {
 		if (t.length === 0) return e;
-		let n = r(t[0]), i = m(e);
-		if (Number.isNaN(i.getTime())) return "";
-		let a = h(i, t.length > 1 ? r(t[1]) : "");
+		let n = i(t[0]), r = h(e);
+		if (Number.isNaN(r.getTime())) return "";
+		let a = g(r, t.length > 1 ? i(t[1]) : "");
 		if (!a) return "";
-		let o = (e) => String(e).padStart(2, "0"), s = {
+		let o = (e) => String(e).padStart(2, "0"), s = [
+			"January",
+			"February",
+			"March",
+			"April",
+			"May",
+			"June",
+			"July",
+			"August",
+			"September",
+			"October",
+			"November",
+			"December"
+		], c = [
+			"Jan",
+			"Feb",
+			"Mar",
+			"Apr",
+			"May",
+			"Jun",
+			"Jul",
+			"Aug",
+			"Sep",
+			"Oct",
+			"Nov",
+			"Dec"
+		], l = [
+			"Sunday",
+			"Monday",
+			"Tuesday",
+			"Wednesday",
+			"Thursday",
+			"Friday",
+			"Saturday"
+		], u = {
 			Y: String(a.year),
+			y: o(a.year % 100),
 			m: o(a.month),
 			n: String(a.month),
 			d: o(a.day),
 			j: String(a.day),
 			H: o(a.hours),
 			G: String(a.hours),
+			h: o(a.hours % 12 || 12),
+			g: String(a.hours % 12 || 12),
+			A: a.hours < 12 ? "AM" : "PM",
+			a: a.hours < 12 ? "am" : "pm",
 			i: o(a.minutes),
 			s: o(a.seconds),
 			w: String(a.weekday),
 			N: String(a.weekday === 0 ? 7 : a.weekday),
-			U: String(Math.floor(i.getTime() / 1e3)),
-			l: [
-				"Sunday",
-				"Monday",
-				"Tuesday",
-				"Wednesday",
-				"Thursday",
-				"Friday",
-				"Saturday"
-			][a.weekday],
-			F: [
-				"January",
-				"February",
-				"March",
-				"April",
-				"May",
-				"June",
-				"July",
-				"August",
-				"September",
-				"October",
-				"November",
-				"December"
-			][a.month - 1],
-			M: [
-				"Jan",
-				"Feb",
-				"Mar",
-				"Apr",
-				"May",
-				"Jun",
-				"Jul",
-				"Aug",
-				"Sep",
-				"Oct",
-				"Nov",
-				"Dec"
-			][a.month - 1]
-		}, c = "";
-		for (let e of n) c += Object.prototype.hasOwnProperty.call(s, e) ? s[e] : e;
-		return c;
+			U: String(Math.floor(r.getTime() / 1e3)),
+			l: l[a.weekday],
+			D: l[a.weekday].slice(0, 3),
+			F: s[a.month - 1],
+			M: c[a.month - 1]
+		}, d = "", f = !1;
+		for (let e of n) f ? (d += e, f = !1) : e === "\\" ? f = !0 : d += Object.prototype.hasOwnProperty.call(u, e) ? u[e] : e;
+		return d;
 	},
-	base64_encode: (e) => typeof e == "string" ? i(e) : e,
-	base64_decode: (e) => typeof e == "string" ? a(e) : e,
-	md5: (e) => typeof e == "string" ? o(e) : e,
+	base64_encode: (e) => typeof e == "string" ? a(e) : e,
+	base64_decode: (e) => typeof e == "string" ? o(e) : e,
+	md5: (e) => typeof e == "string" ? s(e) : e,
 	without: (e, t) => {
 		if (typeof e != "object" || !e || Array.isArray(e)) return e;
-		let n = t.map(r), i = {};
-		for (let [t, r] of Object.entries(e)) n.includes(t) || (i[t] = r);
-		return i;
+		let n = t.map(i), r = {};
+		for (let [t, i] of Object.entries(e)) n.includes(t) || (r[t] = i);
+		return r;
 	},
 	only: (e, t) => {
 		if (typeof e != "object" || !e || Array.isArray(e)) return e;
-		let n = t.map(r), i = {};
-		for (let [t, r] of Object.entries(e)) n.includes(t) && (i[t] = r);
-		return i;
+		let n = t.map(i), r = {};
+		for (let [t, i] of Object.entries(e)) n.includes(t) && (r[t] = i);
+		return r;
 	},
 	find: (e, t) => {
 		if (!Array.isArray(e) || t.length === 0) return;
 		let n = t[0];
 		if (typeof n == "function") return e.find((e, t) => n(e, t));
 		if (t.length < 2) return;
-		let i = r(n), a = t[1];
-		return e.find((e) => typeof e == "object" && e ? e[i] === a : e === a);
+		let r = i(n), a = t[1];
+		return e.find((e) => typeof e == "object" && e ? e[r] === a : e === a);
 	},
 	pluck: (e, t) => {
 		if (!Array.isArray(e) || t.length === 0) return e;
-		let n = r(t[0]);
+		let n = i(t[0]);
 		return e.map((e) => typeof e == "object" && e ? e[n] : void 0);
 	},
 	unique: (e) => Array.isArray(e) ? [...new Set(e)] : e,
@@ -411,22 +429,22 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 	},
 	index_by: (e, t) => {
 		if (!Array.isArray(e) || t.length === 0) return e;
-		let n = r(t[0]), i = {};
+		let n = i(t[0]), r = {};
 		for (let t of e) if (typeof t == "object" && t) {
 			let e = String(t[n] ?? "");
-			i[e] = t;
+			r[e] = t;
 		}
-		return i;
+		return r;
 	},
 	group_by: (e, t) => {
 		if (!Array.isArray(e) || t.length === 0) return e;
-		let n = r(t[0]), i = {};
+		let n = i(t[0]), r = {};
 		for (let t of e) if (typeof t == "object" && t) {
 			let e = String(t[n] ?? "");
-			i[e] = i[e] ?? [], i[e].push(t);
+			r[e] = r[e] ?? [], r[e].push(t);
 		}
-		return i;
+		return r;
 	}
 };
 //#endregion
-export { e as ARROW_PARAMS, s as RAW_MARKER, g as filters, c as isRawMarker, u as unwrapRaw, l as wrapRaw };
+export { e as ARROW_PARAMS, c as RAW_MARKER, _ as filters, l as isRawMarker, d as unwrapRaw, u as wrapRaw };

package/dist/helpers/twigWrapper/index.d.ts

@@ -1,7 +1,10 @@
-export { processTwig } from './processTwig';
+export { processTwig, processTwigParam, processTwigValue } from './processTwig';
+export { MAX_PARAM_PASSES, resolveStepParam } from './processTwig/resolveStepParam';
 export { hasTemplateSyntax } from './tokens/hasTemplateSyntax';
 export { hasValidToken } from './tokens/hasValidToken';
-export { templateRootNames } from './templateRoots';
+export { inspectTemplate } from './inspectTemplate';
+export { templatePaths, templateRootNames } from './templateRoots';
 export { filters } from './filters/filters';
 export type { ASTNode, Expression } from './AST';
+export type { TemplateInspection } from './inspectTemplate';
 export type { TwigFilter } from './filters/filters';

package/dist/helpers/twigWrapper/index.mjs

@@ -1,6 +1,8 @@
 import { filters as e } from "./filters/filters.mjs";
-import { processTwig as t } from "./processTwig/processTwig.mjs";
-import { hasTemplateSyntax as n } from "./tokens/hasTemplateSyntax.mjs";
-import { hasValidToken as r } from "./tokens/hasValidToken.mjs";
-import { templateRootNames as i } from "./templateRoots.mjs";
-export { e as filters, n as hasTemplateSyntax, r as hasValidToken, t as processTwig, i as templateRootNames };
+import { processTwig as t, processTwigParam as n, processTwigValue as r } from "./processTwig/processTwig.mjs";
+import { hasTemplateSyntax as i } from "./tokens/hasTemplateSyntax.mjs";
+import { hasValidToken as a } from "./tokens/hasValidToken.mjs";
+import { MAX_PARAM_PASSES as o, resolveStepParam as s } from "./processTwig/resolveStepParam.mjs";
+import { inspectTemplate as c } from "./inspectTemplate.mjs";
+import { templatePaths as l, templateRootNames as u } from "./templateRoots.mjs";
+export { o as MAX_PARAM_PASSES, e as filters, i as hasTemplateSyntax, a as hasValidToken, c as inspectTemplate, t as processTwig, n as processTwigParam, r as processTwigValue, s as resolveStepParam, l as templatePaths, u as templateRootNames };

package/dist/helpers/twigWrapper/inspectTemplate.d.ts

@@ -0,0 +1,23 @@
+export type TemplateInspection = {
+    /**
+     * Everything the interpreter would read past rather than understand, in words: a character it skipped, an operator
+     * it does not implement, a filter or function it does not have, a tag it drops. Empty for a template that renders
+     * what it says.
+     */
+    issues: string[];
+    /**
+     * The names the template reads from its context — the first segment of every path that is not bound by the
+     * template itself (a `set`, a `for` variable, an arrow's parameter). What a caller checks against what will be in
+     * scope when it renders.
+     */
+    freeNames: string[];
+};
+/**
+ * What a template would do that its author did not write — read at author time, with the parser the runtime uses.
+ *
+ * The interpreter is forgiving on purpose: a page renders what it can rather than throwing. That same forgiveness is
+ * what turns a typo into a plausible wrong value — `s starts with 'x'` evaluated to `s` before the test existed, and a
+ * value in a condition is true. Anything that authors templates (the authoring surface, the builder) asks this first
+ * and refuses what it reports.
+ */
+export declare const inspectTemplate: (template: string) => TemplateInspection;

package/dist/helpers/twigWrapper/inspectTemplate.mjs

@@ -0,0 +1,110 @@
+import { filters as e } from "./filters/filters.mjs";
+import { lex as t } from "./Lexer/Lexer.mjs";
+import { parse as n } from "./Parser/Parser.mjs";
+//#region src/helpers/twigWrapper/inspectTemplate.ts
+var r = /* @__PURE__ */ new Set([
+	"cycle",
+	"max",
+	"min",
+	"range"
+]), i = "loop", a = class {
+	issues = [];
+	freeNames = /* @__PURE__ */ new Set();
+	nodes(e, t) {
+		let n = new Set(t);
+		for (let t of e) switch (t.type) {
+			case "text":
+			case "break":
+			case "continue": break;
+			case "variable":
+				this.expression(t.expression, n);
+				break;
+			case "if":
+				this.expression(t.condition, n), this.nodes(t.body, n);
+				for (let e of t.elseifClauses) this.expression(e.condition, n), this.nodes(e.body, n);
+				t.elseBody && this.nodes(t.elseBody, n);
+				break;
+			case "for": {
+				this.expression(t.collection, n);
+				let e = /* @__PURE__ */ new Set([
+					...n,
+					t.valueVar,
+					i,
+					...t.keyVar ? [t.keyVar] : []
+				]);
+				this.nodes(t.body, e), n = /* @__PURE__ */ new Set([...n, ...this.setsIn(t.body)]), t.elseBody && this.nodes(t.elseBody, n);
+				break;
+			}
+			case "set":
+				Array.isArray(t.value) ? this.nodes(t.value, n) : this.expression(t.value, n), n = /* @__PURE__ */ new Set([...n, t.name]);
+				break;
+			case "apply":
+				this.filterNames(t.filters.map((e) => e.name));
+				for (let e of t.filters) e.args.forEach((e) => this.expression(e, n));
+				this.nodes(t.body, n);
+		}
+		return n;
+	}
+	setsIn(e) {
+		return e.flatMap((e) => e.type === "set" ? [e.name] : []);
+	}
+	filterNames(t) {
+		for (let n of t) n && !Object.hasOwn(e, n) && this.issues.push(`Unknown filter "${n}"`);
+	}
+	expression(e, t) {
+		switch (e.type) {
+			case "literal": return;
+			case "array":
+				e.elements.forEach((e) => this.expression(e, t));
+				return;
+			case "object":
+				for (let n of e.entries) this.expression(n.key, t), this.expression(n.value, t);
+				return;
+			case "range":
+				this.expression(e.start, t), this.expression(e.end, t);
+				return;
+			case "path":
+				t.has(e.segments[0]) || this.freeNames.add(e.segments[0]);
+				return;
+			case "index":
+				this.expression(e.object, t), this.expression(e.index, t);
+				return;
+			case "function":
+				r.has(e.name) || this.issues.push(`Unknown function "${e.name}()": the functions are ${[...r].join(", ")}`), e.args.forEach((e) => this.expression(e, t));
+				return;
+			case "filter":
+				this.expression(e.subject, t), this.filterNames(e.filters.map((e) => e.name));
+				for (let n of e.filters) n.args.forEach((e) => this.expression(e, t));
+				return;
+			case "concat":
+				e.parts.forEach((e) => this.expression(e, t));
+				return;
+			case "unary":
+				this.expression(e.operand, t);
+				return;
+			case "binary":
+				this.expression(e.left, t), (e.operator !== "is" && e.operator !== "is not" || e.right.type !== "path") && this.expression(e.right, t);
+				return;
+			case "default":
+				this.expression(e.value, t), this.expression(e.defaultExpr, t);
+				return;
+			case "ternary":
+				this.expression(e.condition, t), e.trueExpr && this.expression(e.trueExpr, t), this.expression(e.falseExpr, t);
+				return;
+			case "arrow": this.expression(e.body, /* @__PURE__ */ new Set([...t, ...e.params]));
+		}
+	}
+}, o = (e) => {
+	let r = t(e);
+	if (r.error) return {
+		issues: [r.error],
+		freeNames: []
+	};
+	let i = new a(), { nodes: o, error: s } = n(r.tokens, !1, i.issues);
+	return s && i.issues.push(s), i.nodes(o, /* @__PURE__ */ new Set()), {
+		issues: [...new Set(i.issues)],
+		freeNames: [...i.freeNames]
+	};
+};
+//#endregion
+export { o as inspectTemplate };

package/dist/helpers/twigWrapper/processTwig/helpers.d.ts

@@ -2,6 +2,13 @@ import { CacheEntry } from '../TemplateCache';
 export declare const resolveSimplePath: (context: Record<string, unknown>, name: string) => unknown;
 export declare const resolveDottedPath: (context: Record<string, unknown>, path: string) => unknown;
 export declare const serializeValue: (value: unknown) => string;
+/**
+ * A rendered template as the value it reads as: `30` the number, `true`, an object from its JSON.
+ *
+ * Except a number that would not read back as the text it came from — `012345`, a code with a leading zero, or a
+ * 20-digit id past what a number can hold exactly. Those were handed on as `12345` and as the nearest double, which is
+ * a different second-factor code, PIN or id by the time anything sends it; they stay the text they were.
+ */
 export declare const finalizeRaw: (output: string) => unknown;
 export declare const flattenContext: (variables: Record<string, unknown>) => Record<string, unknown>;
 export declare const renderSimpleTokens: (entry: CacheEntry, context: Record<string, unknown>) => string;

package/dist/helpers/twigWrapper/processTwig/helpers.mjs

@@ -12,7 +12,8 @@ var e = (e, t) => e[t], t = (e, t) => {
 	return r;
 }, n = (e) => e == null ? "" : typeof e == "object" ? JSON.stringify(e) : String(e), r = (e) => {
 	try {
-		return JSON.parse(e) || e;
+		let t = JSON.parse(e);
+		return typeof t == "number" && String(t) !== e.trim() ? e : t || e;
 	} catch {
 		return e;
 	}

package/dist/helpers/twigWrapper/processTwig/index.d.ts

@@ -1 +1,2 @@
-export { processTwig } from './processTwig';
+export { processTwig, processTwigParam, processTwigValue } from './processTwig';
+export { MAX_PARAM_PASSES, resolveStepParam } from './resolveStepParam';

package/dist/helpers/twigWrapper/processTwig/index.mjs

@@ -1,2 +1,3 @@
-import { processTwig as e } from "./processTwig.mjs";
-export { e as processTwig };
+import { processTwig as e, processTwigParam as t, processTwigValue as n } from "./processTwig.mjs";
+import { MAX_PARAM_PASSES as r, resolveStepParam as i } from "./resolveStepParam.mjs";
+export { r as MAX_PARAM_PASSES, e as processTwig, t as processTwigParam, n as processTwigValue, i as resolveStepParam };

package/dist/helpers/twigWrapper/processTwig/processTwig.d.ts

@@ -1 +1,29 @@
 export declare const processTwig: (template: string, variables?: Record<string, unknown>, keepEmptyTokens?: boolean, asRaw?: boolean) => unknown;
+/**
+ * A template's VALUE, where it has one: `{{ rows|filter(r => r.open) }}` is the filtered array, `{{ count > 0 }}` a
+ * boolean, `{{ total }}` the number it holds.
+ *
+ * A template that is one `{{ expression }}` and nothing else (surrounding whitespace aside) answers that expression's
+ * value untouched. Anything with text around it, or tags, is text by nature and renders as {@link processTwig}.
+ *
+ * Unlike `processTwig`'s `asRaw`, nothing goes through JSON on the way: `0`, `false` and `null` come back as
+ * themselves, and a string that looks like a number stays a string.
+ */
+export declare const processTwigValue: (template: string, variables?: Record<string, unknown>) => unknown;
+/**
+ * A flow step's param — in the browser's flows and in a server action's — as the value the step is handed.
+ *
+ * A param that is one `{{ expression }}` is that expression's value, exactly: a string stays a string however it
+ * looks. The type is the VALUE's, never guessed from its text — which is what the step params used to do, rendering
+ * the value to text and reading the text back as JSON: a password typed as `1234` reached the server as a number, and
+ * a text field declared `text` on the far side then saw no password at all. What a param should be converted to is
+ * the business of whoever declares its type — `setState`'s `type`, an action's input fields — not of the resolver.
+ *
+ * Two readings of JSON stay, because in both the author wrote JSON on purpose: a param that is nothing but a JSON
+ * filter (`{{ saved|json_encode }}`) is the value it encodes, and text around the tokens that makes a JSON object or
+ * array (`{ "id": "{{ id }}" }`, an `input` written as a document) is that document. A value printed inside one of
+ * the document's string literals is escaped for it: a visitor's `Say "hi"` or a note on two lines used to break the
+ * document, and the step was handed its raw text instead. Any other text is text. A value that is not there reads as
+ * an empty string, as it renders.
+ */
+export declare const processTwigParam: (template: string, variables?: Record<string, unknown>) => unknown;