@plitzi/sdk-shared 0.37.1 → 0.37.3

package/dist/helpers/twigWrapper/Parser/Parser.mjs

@@ -3,18 +3,18 @@ import { reconstructSource as n, reconstructToken as r } from "../Lexer/types.mj
 import { parseApplyFilters as i, parseExpression as a } from "./ExpressionParser.mjs";
 import { extractFirstWord as o, splitRange as s } from "./helpers.mjs";
 //#region src/helpers/twigWrapper/Parser/Parser.ts
-var c = (e, t = !1) => {
-	let n = new f(e, t), r = n.parseBody();
-	if (!n.error) {
-		let e = n.peek();
+var c = (e, t = !1, n) => {
+	let r = new f(e, t, n), i = r.parseBody();
+	if (!r.error) {
+		let e = r.peek();
 		if (e && e.type === "tag") {
 			let t = o(e.content.trim());
-			l.has(t) && (n.error = `Orphan closing tag: {% ${t} %} without matching opening tag`);
+			l.has(t) && (r.error = `Orphan closing tag: {% ${t} %} without matching opening tag`);
 		}
 	}
 	return {
-		nodes: r,
-		error: n.error
+		nodes: i,
+		error: r.error
 	};
 }, l = /* @__PURE__ */ new Set([
 	"endif",
@@ -45,10 +45,11 @@ var c = (e, t = !1) => {
 }), f = class {
 	tokens;
 	keepEmptyTokens;
+	issues;
 	pos = 0;
 	error = null;
-	constructor(e, t = !1) {
-		this.tokens = e, this.keepEmptyTokens = t;
+	constructor(e, t = !1, n) {
+		this.tokens = e, this.keepEmptyTokens = t, this.issues = n;
 	}
 	peek() {
 		return this.tokens[this.pos];
@@ -101,7 +102,7 @@ var c = (e, t = !1) => {
 			},
 			source: i
 		};
-		let o = a(r);
+		let o = a(r, this.issues);
 		return {
 			type: "variable",
 			raw: t.raw,
@@ -112,15 +113,15 @@ var c = (e, t = !1) => {
 	parseTag() {
 		let e = this.peek();
 		if (!e || e.type !== "tag") return null;
-		let t = e.content.trim();
-		switch (o(t)) {
+		let t = e.content.trim(), n = o(t);
+		switch (n) {
 			case "if": return this.parseIf();
 			case "for": return this.parseFor();
 			case "set": return this.parseSet();
 			case "apply": return this.parseApply();
 			case "break": return this.advance(), { type: "break" };
 			case "continue": return this.advance(), { type: "continue" };
-			default: return this.advance(), null;
+			default: return this.issues?.push(`Unknown tag {% ${n} %}: the tags are if, for, set, apply, break and continue`), this.advance(), null;
 		}
 	}
 	parseIf() {
@@ -129,14 +130,14 @@ var c = (e, t = !1) => {
 		if (e.type !== "tag") return this.error = "Malformed {% if %} tag", u();
 		let t = e.content.trim(), n = t.indexOf(" ") === -1 ? "" : t.slice(t.indexOf(" ") + 1).trim();
 		if (!n) return this.error = "Malformed {% if %} tag: missing condition", u();
-		let r = a(n), i = this.parseBody(), s = [], c = null, l = !1;
+		let r = a(n, this.issues), i = this.parseBody(), s = [], c = null, l = !1;
 		for (; this.peek();) {
 			let e = this.peek();
 			if (!e || e.type !== "tag") break;
 			let t = o(e.content.trim());
 			if (t === "elseif") {
 				this.advance();
-				let t = e.content.trim(), n = t.slice(t.indexOf(" ") + 1).trim(), r = a(n), i = this.parseBody();
+				let t = e.content.trim(), n = t.slice(t.indexOf(" ") + 1).trim(), r = a(n, this.issues), i = this.parseBody();
 				s.push({
 					condition: r,
 					body: i
@@ -164,9 +165,9 @@ var c = (e, t = !1) => {
 		if (!c) return this.error = "Invalid {% for %} syntax: missing the `in` keyword", d();
 		let l = i.slice(0, c.index).trim(), u = i.slice(c.index + c[0].length).trim(), f = s(u), p = f ? {
 			type: "range",
-			start: a(f[0]),
-			end: a(f[1])
-		} : a(u), m = l.indexOf(","), h = m === -1 ? null : l.slice(0, m).trim(), g = m === -1 ? l : l.slice(m + 1).trim();
+			start: a(f[0], this.issues),
+			end: a(f[1], this.issues)
+		} : a(u, this.issues), m = l.indexOf(","), h = m === -1 ? null : l.slice(0, m).trim(), g = m === -1 ? l : l.slice(m + 1).trim();
 		if (!t(g)) return this.error = `Invalid {% for %} variable name: "${g}"`, d();
 		if (h !== null && !t(h)) return this.error = `Invalid {% for %} key variable name: "${h}"`, d();
 		let _ = this.parseBody(), v = null;
@@ -216,7 +217,7 @@ var c = (e, t = !1) => {
 		return {
 			type: "set",
 			name: i,
-			value: a(o)
+			value: a(o, this.issues)
 		};
 	}
 	parseApply() {
@@ -227,7 +228,7 @@ var c = (e, t = !1) => {
 			filters: [],
 			body: []
 		};
-		let t = e.content.trim(), n = t.slice(t.indexOf(" ") + 1).trim(), r = i(n), a = this.parseBody(), o = this.peek();
+		let t = e.content.trim(), n = t.slice(t.indexOf(" ") + 1).trim(), r = i(n, this.issues), a = this.parseBody(), o = this.peek();
 		return o && o.type === "tag" && this.advance(), {
 			type: "apply",
 			filters: r,

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,10 +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, t) => {
+	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);
+}, g = (e, t) => {
 	if (!t) return {
 		year: e.getFullYear(),
 		month: e.getMonth() + 1,
@@ -134,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 {
@@ -144,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"))
 	};
-}, h = {
-	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,
@@ -164,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") {
@@ -189,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;
@@ -260,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;
@@ -271,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) {
@@ -291,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 = e instanceof Date ? e : new Date(String(e));
-		if (Number.isNaN(i.getTime())) return "";
-		let a = m(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,
@@ -406,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, h 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,6 +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,5 +1,8 @@
 import { filters as e } from "./filters/filters.mjs";
-import { processTwig as t } from "./processTwig/processTwig.mjs";
-import { hasValidToken as n } from "./tokens/hasValidToken.mjs";
-import { templateRootNames as r } from "./templateRoots.mjs";
-export { e as filters, n as hasValidToken, t as processTwig, r 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;