@burdenoff/fe-libs 2026.1009.1 → 2026.1010.1

package/dist/shared/assistant/localeCommands/engine.js

@@ -0,0 +1,351 @@
+import { effectiveManifest as e, isEnabled as t } from "./gate.js";
+import { foldText as n, foldWords as r } from "./fold.js";
+import { closedSlot as i, compileFrame as a, matchFrame as o } from "./frames.js";
+import { buildPrep as s, isQuestionText as c, normaliseSaid as l } from "./normalise.js";
+import { languageNameMap as u } from "./languageNames.js";
+import { LOCALE_TABLES as d, activeCommandLocales as f } from "./active.js";
+import { ENGLISH_COMMAND_ADDITIONS as p } from "./tables/en.js";
+//#region src/shared/assistant/localeCommands/engine.ts
+var m = {
+	maxLength: 80,
+	courtesy: {
+		prefix: [
+			"please",
+			"pls",
+			"kindly",
+			"hey",
+			"hi"
+		],
+		suffix: [
+			"please",
+			"pls",
+			"thanks",
+			"thank you",
+			"now"
+		]
+	},
+	fillers: [
+		"um",
+		"uh",
+		"erm",
+		"er",
+		"hmm"
+	],
+	compound: []
+};
+function h(e, t, n) {
+	let r = { p: i([[e.places, "place"]], n) };
+	if (t) {
+		let { pick: e, controls: a } = t;
+		r.o = i([...e.ordinals.map((e, t) => [e, t + 1]), [e.last, "last"]], n), r.n = i(e.numbers.map((e, t) => [e, t + 1]), n), r.d = i([[a.directions.asc, "asc"], [a.directions.desc, "desc"]], n);
+	}
+	return r;
+}
+var g = /* @__PURE__ */ new Map();
+function _(e, t, r, i, o, c) {
+	let l = g.get(c);
+	if (l) return l;
+	let u = h(t, e, o), d = (e) => e.map((e) => a(e, o, u)), f = (e) => e.map((e) => ({
+		frame: a(e.template, o, u),
+		weak: e.weak === !0
+	})), p = () => [], m = e?.controls, _ = {
+		fold: o,
+		zh: o === "zh",
+		prep: s(i, o),
+		closed: u,
+		goto: {
+			go: d(t.go),
+			open: d(t.open),
+			show: d(t.show)
+		},
+		ambiguous: new Set(t.ambiguous.map((e) => b(n(e, o), o))),
+		there: d(e?.there ?? []),
+		back: d(e?.back ?? []),
+		pick: d(e?.pick.frames ?? []),
+		language: d(r),
+		theme: (e?.theme ?? []).map((e) => ({
+			frame: a(e.template, o, u),
+			family: e.family,
+			invert: e.invert === !0,
+			saysTheme: e.saysTheme === !0
+		})),
+		controls: {
+			phrases: {
+				history: m ? f(m.history) : p(),
+				transcript: m ? f(m.transcript) : p(),
+				previewOpen: m ? f(m.previewOpen) : p(),
+				previewClose: m ? f(m.previewClose) : p(),
+				newConversation: m ? f(m.newConversation) : p(),
+				notifications: m ? f(m.notifications) : p(),
+				help: m ? f(m.help) : p(),
+				sidebarCollapse: m ? f(m.sidebarCollapse) : p(),
+				sidebarExpand: m ? f(m.sidebarExpand) : p()
+			},
+			tab: d(m?.tab ?? []),
+			filter: d(m?.filter ?? []),
+			filterClear: d(m?.filterClear ?? []),
+			sort: d(m?.sort ?? []),
+			sortDirection: d(m?.sortDirection ?? []),
+			search: d(m?.search ?? []),
+			searchVerbOnly: d((m?.search ?? []).map((e) => e.replace(/\s*\{q\}\s*/g, "")).filter((e) => e.length > 0)),
+			searchClear: d(m?.searchClear ?? [])
+		}
+	};
+	return g.set(c, _), _;
+}
+function v(e) {
+	return _(e, e.goto, e.language, e, e.locale, `native:${e.locale}`);
+}
+function y(e) {
+	let t = e?.locale ?? "en", n = e ?? m;
+	return _(null, p.goto, p.language, {
+		...n,
+		polite: void 0
+	}, t, `english:${t}`);
+}
+function b(e, t) {
+	return t === "es" ? e.replace(/^(?:el|la|los|las|un|una|unos|unas) (?=\S)/, "") : t === "ar" ? e.replace(/^(?:لل|ال)(?=\S{2})/, "") : e;
+}
+function x(e, t, r) {
+	let i = /* @__PURE__ */ new Map(), a = (e, r) => {
+		let a = b(n(e, t), t);
+		if (!a) return;
+		let o = i.get(a) ?? [];
+		o.some((e) => e.path === r.path) || o.push(r), i.set(a, o);
+	};
+	for (let t of e) {
+		a(t.label, t), t.context && a(`${t.context} ${t.label}`, t);
+		for (let e of r?.(t.label) ?? []) a(e, t);
+	}
+	return i;
+}
+function S(e, t, r) {
+	let i = b(e, r), a = t.filter((e) => b(n(e.label, r), r) === i);
+	return a.length === 1 ? a[0] ?? null : null;
+}
+function C(e, t) {
+	let n = b(e, t.fold);
+	if (t.zh) return [...t.ambiguous].some((e) => n.endsWith(e));
+	let r = n.split(" "), i = r[r.length - 1] ?? "", a = r.slice(-2).join(" ");
+	return t.ambiguous.has(i) || t.ambiguous.has(a);
+}
+function w(e, t, r) {
+	let i = /* @__PURE__ */ new Map(), a = "";
+	for (let s of [
+		"go",
+		"open",
+		"show"
+	]) for (let c of e.goto[s]) for (let l of o(c, t)) {
+		let t = l.x;
+		if (!t) continue;
+		let o = r.get(b(t, e.fold));
+		if (o && !(s === "open" && l.p === void 0 && (C(t, e) || o.some((t) => C(n(t.label, e.fold), e))))) {
+			for (let e of o) i.set(e.path, e);
+			a = t;
+		}
+	}
+	return i.size === 0 ? null : {
+		destinations: [...i.values()],
+		query: a
+	};
+}
+function T(e, t, n) {
+	for (let r of e.theme) if (!(n === "mode-only" && r.saysTheme) && o(r.frame, t).length !== 0) return {
+		kind: "family",
+		family: r.invert ? r.family === "dark" ? "light" : "dark" : r.family
+	};
+	return null;
+}
+function E(e, t) {
+	let n = [];
+	for (let r of e.pick) for (let i of o(r, t)) {
+		let t = i.o ?? i.n, r = i.o === void 0 ? "n" : "o", a = t === void 0 ? void 0 : e.closed[r]?.get(t);
+		a === "last" ? n.push({ kind: "last" }) : typeof a == "number" && n.push({
+			kind: "ordinal",
+			position: a
+		});
+	}
+	let [r] = n;
+	return r && n.every((e) => JSON.stringify(e) === JSON.stringify(r)) ? r : null;
+}
+var D = (e, t) => e.some((e) => o(e, t).length > 0);
+function O(e, t) {
+	let n = e.filter((e) => o(e.frame, t).length > 0);
+	return n.length === 0 ? null : { weak: n.every((e) => e.weak) };
+}
+var k = 60, A = 4;
+function j(e, t, n) {
+	if (n.zh) return t;
+	let i = r(e, n.fold), a = i.flatMap((e, t) => e.folded.map((e) => ({
+		token: e,
+		owner: t
+	}))), o = t.split(" ");
+	for (let e = a.length - o.length; e >= 0; --e) {
+		if (!o.every((t, n) => a[e + n]?.token === t)) continue;
+		let t = a[e]?.owner, n = a[e + o.length - 1]?.owner;
+		if (t === void 0 || n === void 0 || a.filter((e) => e.owner >= t && e.owner <= n).length !== o.length) break;
+		return i.slice(t, n + 1).map((e) => e.said).join(" ");
+	}
+	return t;
+}
+function M(e, t) {
+	let n = t === void 0 ? void 0 : e.closed.d?.get(t);
+	return n === "asc" || n === "desc" ? n : null;
+}
+function N(e, t, r, i, a, s) {
+	let { registered: c } = i;
+	if (e.prep.compound.some((n) => e.zh ? t.includes(n) : ` ${t} `.includes(` ${n} `))) return null;
+	let l = [], u = (e, t) => l.push({
+		request: e,
+		weak: t
+	}), { phrases: d } = e.controls, f = (e, n, r) => {
+		if (!n) return;
+		let i = O(d[e], t);
+		i && u(r, i.weak);
+	};
+	if (f("notifications", c["header.notifications"], { control: "header.notifications" }), f("help", c["header.help"], { control: "header.help" }), f("sidebarCollapse", c.sidebar, {
+		control: "sidebar",
+		collapsed: !0
+	}), f("sidebarExpand", c.sidebar, {
+		control: "sidebar",
+		collapsed: !1
+	}), f("history", c["assistant.history"], { control: "assistant.history" }), f("transcript", c["assistant.transcript"], { control: "assistant.transcript" }), f("previewOpen", c["assistant.preview"], { control: "assistant.preview" }), f("previewClose", c["assistant.preview"], { control: "assistant.preview.close" }), f("newConversation", c["assistant.conversation.new"], { control: "assistant.conversation.new" }), c.language && e.language.length > 0) {
+		let r = new Set(a.map((t) => b(n(t.label, e.fold), e.fold)));
+		for (let n of e.language) for (let i of o(n, t)) {
+			let t = i.lang, n = t === void 0 ? void 0 : s.get(t);
+			n && t !== void 0 && !r.has(b(t, e.fold)) && u({
+				control: "language",
+				code: n
+			}, !1);
+		}
+	}
+	let p = i.page;
+	if (p) {
+		if (p.tabs.length > 0) for (let n of e.controls.tab) for (let r of o(n, t)) {
+			let t = r.x ? S(r.x, p.tabs, e.fold) : null;
+			t && u({
+				control: "page.tab",
+				name: t.label
+			}, !1);
+		}
+		if (p.filters.length > 0) {
+			D(e.controls.filterClear, t) && u({
+				control: "page.filter.clear",
+				filter: null
+			}, !1);
+			for (let n of e.controls.filter) for (let r of o(n, t)) {
+				if (!r.x) continue;
+				let t = p.filters.filter((t) => S(r.x, t.options, e.fold) !== null), [n] = t;
+				if (!n) continue;
+				let i = S(r.x, n.options, e.fold);
+				i && u({
+					control: "page.filter",
+					filter: t.length === 1 ? n.label : null,
+					option: i.label
+				}, !1);
+			}
+		}
+		if (p.sorts.length > 0) {
+			for (let n of e.controls.sort) for (let r of o(n, t)) {
+				let t = r.x ? S(r.x, p.sorts, e.fold) : null;
+				t && u({
+					control: "page.sort",
+					field: t.label,
+					direction: M(e, r.d)
+				}, !1);
+			}
+			for (let n of e.controls.sortDirection) for (let r of o(n, t)) {
+				let t = M(e, r.d);
+				t && u({
+					control: "page.sort",
+					field: null,
+					direction: t
+				}, !1);
+			}
+		}
+		if (p.searchable) {
+			D(e.controls.searchClear, t) && u({ control: "page.search.clear" }, !1);
+			let n = null, i = D(e.controls.searchVerbOnly, t);
+			for (let r of i ? [] : e.controls.search) for (let i of o(r, t)) {
+				let t = i.q?.trim() ?? "", r = e.zh ? 0 : t.split(" ").length;
+				!t || t.length > k || r > A || (n === null || t.length < n.length) && (n = t);
+			}
+			n !== null && u({
+				control: "page.search",
+				query: j(r, n, e)
+			}, !1);
+		}
+	}
+	let m = l.filter((e) => !e.weak), h = m.length > 0 ? m : l, [g] = h;
+	return g && h.every((e) => JSON.stringify(e) === JSON.stringify(g)) ? g : null;
+}
+function P(e, t, n, r, i, a, o) {
+	let s = {};
+	if (i.enabled("theme")) {
+		let n = T(e, r, t.themeWords);
+		n && (s.theme = n);
+	}
+	if (i.enabled("back") && t.backRunnable && D(e.back, r) && (s.back = !0), i.enabled("pick") && t.navigation) {
+		let t = E(e, r);
+		t && (s.pick = t);
+	}
+	if (i.enabled("there") && t.navigation && D(e.there, r) && (s.there = !0), i.enabled("goto")) {
+		let t = w(e, r, o);
+		t && (s.goto = t);
+	}
+	if (t.controls && (i.enabled("controls") || i.enabled("language"))) {
+		let o = N(e, r, n, t.controls, t.destinations, a);
+		o && (o.request.control === "language" ? i.enabled("language") : i.enabled("controls")) && (s.control = o);
+	}
+	return s;
+}
+function F(n) {
+	let r = e(n.manifest), i = f({
+		ui: n.uiLocale,
+		input: n.inputLocale,
+		narrow: n.commandLocales,
+		manifest: r
+	}), a = i.length > 0 && t(r, "en", "goto"), o = t(r, "en", "language");
+	if (i.length === 0 && !o) return [];
+	let s = c(n.said), p = i.map((e) => d[e]), m = n.controls?.languages ?? [], h = [], g = (e) => u({
+		tables: p,
+		appLanguages: m,
+		fold: e
+	});
+	for (let e of p) {
+		let i = v(e), a = l(n.said, i.prep, s);
+		if (a === null) continue;
+		let o = P(i, n, n.said, a, { enabled: (n) => t(r, e.locale, n) }, g(e.locale), x(n.destinations, e.locale, e.nameForms));
+		Object.keys(o).length > 0 && h.push({
+			source: e.locale,
+			intents: o
+		});
+	}
+	if (!s && (a || o)) {
+		let e = i.length > 0 ? p : [null];
+		for (let t of e) {
+			let e = y(t), r = l(n.said, e.prep, !1);
+			if (r === null) continue;
+			let i = P(e, n, n.said, r, { enabled: (e) => e === "goto" ? a : e === "language" ? o : !1 }, g(e.fold), x(n.destinations, e.fold));
+			Object.keys(i).length > 0 && h.push({
+				source: "en",
+				intents: i
+			});
+		}
+	}
+	return h;
+}
+function I(n) {
+	let r = e(n.manifest), i = f({
+		ui: n.uiLocale,
+		input: n.inputLocale,
+		narrow: n.commandLocales,
+		manifest: r
+	}), a = c(n.said);
+	return i.some((e) => {
+		let i = d[e], o = v(i), s = l(n.said, o.prep, a);
+		return s === null ? !1 : t(r, e, "there") && D(o.there, s) || t(r, e, "pick") && E(o, s) !== null;
+	});
+}
+//#endregion
+export { v as compileNative, F as matchLocaleIntents, I as mayBeThereOrPick };

package/dist/shared/assistant/localeCommands/evaluate.d.ts

@@ -0,0 +1,77 @@
+import { ControlSnapshot } from '../appControls/snapshot';
+import { UiLanguage } from '../appControls/types';
+import { LocalDestination, LocalUiCommand } from '../localUiCommands';
+import { UiOfferYesState } from '../uiActions/uiOffers';
+import { CommandManifest } from './types';
+export interface EvalControls {
+    registered?: readonly string[];
+    languages?: readonly UiLanguage[];
+    sidebarEntries?: ControlSnapshot["sidebarEntries"];
+    page?: Partial<NonNullable<ControlSnapshot["page"]>> | null;
+}
+export interface EvalNavigation {
+    links?: readonly LocalDestination[];
+    unresolved?: number;
+    list?: readonly string[];
+    offered?: readonly string[];
+}
+export interface EvalYes {
+    offer?: UiOfferYesState;
+    pending?: number;
+    attachments?: boolean;
+    leaveGuard?: boolean;
+}
+export interface EvalItem {
+    id: string;
+    text: string;
+    uiLocale: string;
+    inputLocale?: string;
+    origin?: "typed" | "spoken";
+    family?: string;
+    sidebar?: readonly LocalDestination[];
+    controls?: EvalControls;
+    backRunnable?: boolean;
+    navigation?: EvalNavigation | null;
+    yes?: EvalYes;
+    themeWords?: "any" | "mode-only";
+    expected?: string | Record<string, unknown>;
+}
+export type EvalActual = {
+    result: "model";
+    plannedAs?: string;
+} | ({
+    result: "command";
+    kind: string;
+} & Record<string, unknown>);
+export type EvalVerdict = "pass" | "false-match" | "wrong" | "miss" | "unscored";
+export interface EvalResult {
+    id: string;
+    locale: string;
+    family: string;
+    actual: EvalActual;
+    expected?: string | Record<string, unknown>;
+    verdict: EvalVerdict;
+}
+/** A command as a flat, comparable record. */
+export declare function describeCommand(command: LocalUiCommand | null): EvalActual;
+/** What the shipping composition does with one item. */
+export declare function actualOf(item: EvalItem, manifest: CommandManifest): EvalActual;
+export declare function verdictOf(actual: EvalActual, expected: EvalItem["expected"]): EvalVerdict;
+export declare function evaluateCommandItem(item: EvalItem, manifest?: CommandManifest): EvalResult;
+export interface EvalCell {
+    locale: string;
+    family: string;
+    items: number;
+    positives: number;
+    negatives: number;
+    truePositives: number;
+    misses: number;
+    wrong: number;
+    falseMatches: number;
+    precision: number | null;
+    recall: number | null;
+}
+/** The scoreboard: per locale and family. `falseMatches` counts a wrong target too (G1). */
+export declare function scoreboard(results: readonly EvalResult[]): EvalCell[];
+/** The family names an item may be labelled with. */
+export declare const EVAL_FAMILIES: readonly string[];

package/dist/shared/assistant/localeCommands/evaluate.js

@@ -0,0 +1,180 @@
+import { planWriteReply as e } from "../writeReplySend.js";
+import { COMMAND_FAMILIES as t } from "./types.js";
+import { allOnManifest as n } from "./gate.js";
+import { matchLocalUiCommand as r } from "../localUiCommands.js";
+import { offerAssentFor as i } from "./assent.js";
+import { EMPTY_CONTROL_SNAPSHOT as a } from "../appControls/snapshot.js";
+//#region src/shared/assistant/localeCommands/evaluate.ts
+var o = (e) => e.id;
+function s(e) {
+	if (!e) return;
+	let t = { ...a.registered };
+	for (let n of e.registered ?? []) t[n] = !0;
+	let n = e.page ? {
+		name: e.page.name ?? "Page",
+		tabs: e.page.tabs ?? [],
+		filters: e.page.filters ?? [],
+		sorts: e.page.sorts ?? [],
+		searchable: e.page.searchable ?? !1,
+		openers: e.page.openers ?? []
+	} : null;
+	return {
+		...a,
+		registered: t,
+		languages: e.languages ?? [],
+		sidebarEntries: e.sidebarEntries ?? [],
+		page: n
+	};
+}
+function c(e) {
+	if (!e) return null;
+	let t = e.links ?? [], n = e.list, r = new Set(e.offered ?? []);
+	return {
+		links: {
+			targets: [...t],
+			unresolved: e.unresolved ?? 0
+		},
+		pendingChoice: n ? {
+			candidates: n.map((e) => t.find((t) => t.id === e) ?? null),
+			candidateIds: [...n]
+		} : null,
+		...r.size > 0 ? { offers: t.filter((e) => r.has(e.id)).map((e) => ({
+			path: e.path,
+			offerId: `uo_${e.id.padEnd(32, "0").slice(0, 32)}`
+		})) } : {}
+	};
+}
+function l(e) {
+	if (!e) return { result: "model" };
+	switch (e.kind) {
+		case "navigate": return {
+			result: "command",
+			kind: "navigate",
+			destinationId: e.destination.id,
+			...e.via ? { via: e.via } : {},
+			...e.via === "offer" ? { trigger: e.trigger } : {}
+		};
+		case "choose-destination":
+		case "choose-linked": return {
+			result: "command",
+			kind: e.kind,
+			candidateIds: e.candidates.map(o)
+		};
+		case "theme": return {
+			result: "command",
+			kind: "theme",
+			family: e.request.kind === "family" ? e.request.family : e.request.theme
+		};
+		case "app-control": return {
+			result: "command",
+			kind: "app-control",
+			control: e.request.control,
+			request: e.request
+		};
+		case "pick-from-list": return {
+			result: "command",
+			kind: "pick-from-list"
+		};
+		default: return {
+			result: "command",
+			kind: e.kind
+		};
+	}
+}
+function u(t, n) {
+	let a = t.inputLocale ?? t.uiLocale, o = t.origin === "spoken", u = o ? a : t.uiLocale;
+	if (t.yes) {
+		let r = t.yes, s = e({
+			text: t.text,
+			locale: u,
+			origin: o ? "spoken" : "typed",
+			hasAttachments: r.attachments === !0,
+			live: {
+				count: r.pending ?? 0,
+				execution: "enabled"
+			},
+			matchesLocalCommand: () => !1,
+			offer: r.offer ?? "none",
+			offerAssent: i({
+				text: t.text,
+				uiLocale: t.uiLocale,
+				inputLocale: a,
+				manifest: n,
+				leaveGuard: r.leaveGuard === !0
+			})
+		});
+		return s.kind === "accept_offer" ? {
+			result: "command",
+			kind: "accept_offer"
+		} : s.kind === "local_reply" ? {
+			result: "model",
+			plannedAs: "local_reply"
+		} : { result: "model" };
+	}
+	let d = s(t.controls), f = c(t.navigation), p = {
+		...t.backRunnable === void 0 ? {} : { backRunnable: t.backRunnable },
+		...f ? { navigation: f } : {},
+		...d ? { controls: d } : {}
+	};
+	return l(r(t.text, t.sidebar ?? [], {
+		locale: u,
+		uiLocale: t.uiLocale,
+		inputLocale: a,
+		commandManifest: n,
+		...t.themeWords ? { themeWords: t.themeWords } : {}
+	}, p));
+}
+function d(e, t) {
+	return typeof t == "string" ? e.result === t : Object.entries(t).every(([t, n]) => {
+		let r = e[t];
+		return JSON.stringify(r) === JSON.stringify(n);
+	});
+}
+function f(e, t) {
+	return t === void 0 ? "unscored" : (typeof t == "string" ? t === "model" : t.result === "model") ? e.result === "model" ? "pass" : "false-match" : e.result === "model" ? "miss" : d(e, t) ? "pass" : "wrong";
+}
+function p(e, t = n()) {
+	let r = u(e, t);
+	return {
+		id: e.id,
+		locale: e.uiLocale.toLowerCase().split(/[-_]/)[0] ?? e.uiLocale,
+		family: e.family ?? "unlabelled",
+		actual: r,
+		...e.expected === void 0 ? {} : { expected: e.expected },
+		verdict: f(r, e.expected)
+	};
+}
+function m(e) {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of e) {
+		if (n.verdict === "unscored") continue;
+		let e = `${n.locale}\u0000${n.family}`, r = t.get(e) ?? {
+			locale: n.locale,
+			family: n.family,
+			items: 0,
+			positives: 0,
+			negatives: 0,
+			truePositives: 0,
+			misses: 0,
+			wrong: 0,
+			falseMatches: 0,
+			precision: null,
+			recall: null
+		};
+		r.items += 1;
+		let i = typeof n.expected == "string" ? n.expected === "model" : n.expected?.result === "model";
+		i ? r.negatives += 1 : r.positives += 1, n.verdict === "pass" && !i && (r.truePositives += 1), n.verdict === "miss" && (r.misses += 1), n.verdict === "wrong" && (r.wrong += 1), n.verdict === "false-match" && (r.falseMatches += 1), t.set(e, r);
+	}
+	return [...t.values()].map((e) => {
+		let t = e.falseMatches + e.wrong, n = e.truePositives + t;
+		return {
+			...e,
+			falseMatches: t,
+			precision: n === 0 ? null : e.truePositives / n,
+			recall: e.positives === 0 ? null : e.truePositives / e.positives
+		};
+	}).sort((e, t) => `${e.locale}${e.family}`.localeCompare(`${t.locale}${t.family}`));
+}
+var h = [...t];
+//#endregion
+export { h as EVAL_FAMILIES, u as actualOf, l as describeCommand, p as evaluateCommandItem, m as scoreboard, f as verdictOf };

package/dist/shared/assistant/localeCommands/fold.d.ts

@@ -0,0 +1,17 @@
+import { CommandLocale } from './types';
+/**
+ * The fold: lower-case, punctuation-free, single-spaced — and, for `zh`, with no
+ * space at all. Idempotent.
+ */
+export declare function foldText(text: string, locale: CommandLocale | "en"): string;
+/** One word of a sentence, as said and as folded (a word may fold to several, or to none). */
+export interface FoldedWord {
+    said: string;
+    folded: string[];
+}
+/**
+ * The sentence split at its spaces, each word with its folded form(s), so a
+ * free-text slot can hand back the person's OWN words (case, inner
+ * punctuation) rather than the fold of them.
+ */
+export declare function foldWords(text: string, locale: CommandLocale | "en"): FoldedWord[];

package/dist/shared/assistant/localeCommands/fold.js

@@ -0,0 +1,66 @@
+//#region src/shared/assistant/localeCommands/fold.ts
+var e = /\p{Cf}/gu, t = [
+	1632,
+	1776,
+	2406,
+	3046
+];
+function n(e) {
+	return e.replace(/\p{Nd}/gu, (e) => {
+		let n = e.codePointAt(0) ?? 0;
+		for (let e of t) if (n >= e && n <= e + 9) return String(n - e);
+		return e;
+	});
+}
+var r = /़/g, i = /ँ/g, a = [
+	[/ङ्(?=[क-घ])/g, "ं"],
+	[/ञ्(?=[च-झ])/g, "ं"],
+	[/ण्(?=[ट-ढ])/g, "ं"],
+	[/न्(?=[त-ध])/g, "ं"],
+	[/म्(?=[प-भ])/g, "ं"]
+];
+function o(e) {
+	let t = e.replace(r, "").replace(i, "ं");
+	for (let [e, n] of a) t = t.replace(e, n);
+	return t;
+}
+var s = /[ً-ٰٟـ]/g, c = [
+	[/[أإآٱ]/g, "ا"],
+	[/ى/g, "ي"],
+	[/ة/g, "ه"],
+	[/ؤ/g, "و"],
+	[/ئ/g, "ي"],
+	[/ی/g, "ي"],
+	[/ک/g, "ك"]
+];
+function l(e) {
+	let t = e.replace(s, "");
+	for (let [e, n] of c) t = t.replace(e, n);
+	return t;
+}
+function u(e) {
+	return e.replace(/\p{Script=Latin}\p{M}*/gu, (e) => {
+		let t = e.normalize("NFC");
+		return t === "ñ" ? t : e.normalize("NFD").replace(/[̀-ͯ]/g, "");
+	});
+}
+var d = {
+	en: (e) => e,
+	hi: o,
+	ta: (e) => e,
+	ar: l,
+	es: u,
+	zh: (e) => e
+};
+function f(t, r) {
+	let i = n(t.normalize("NFKC").replace(e, "").toLowerCase().normalize("NFKC")), a = d[r](i).replace(/&/g, " and ").replace(/[^\p{L}\p{N}\p{M}\s]/gu, " ").replace(/\s+/g, " ").trim();
+	return r === "zh" ? a.replace(/\s+/g, "") : a;
+}
+function p(t, n) {
+	return t.normalize("NFKC").replace(e, "").split(/\s+/).filter(Boolean).map((e) => ({
+		said: e.replace(/^[^\p{L}\p{N}]+|[^\p{L}\p{N}]+$/gu, ""),
+		folded: f(e, n).split(" ").filter(Boolean)
+	}));
+}
+//#endregion
+export { f as foldText, p as foldWords };