@burdenoff/fe-libs 2026.1009.2 → 2026.1010.1

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

@@ -0,0 +1,78 @@
+import { effectiveManifest as e, isEnabled as t } from "./gate.js";
+import { carriesSymbolOrEmoticon as n } from "./symbols.js";
+import { foldText as r } from "./fold.js";
+import { buildPrep as i, collapseRepeat as a, foldedList as o, removeFillers as s, stripEdges as c } from "./normalise.js";
+import { LOCALE_TABLES as l, activeCommandLocales as u } from "./active.js";
+//#region src/shared/assistant/localeCommands/assent.ts
+var d = [
+	"no",
+	"nope",
+	"nah",
+	"not",
+	"never",
+	"dont",
+	"don",
+	"cancel",
+	"stop",
+	"wait",
+	"but",
+	"however",
+	"though",
+	"nothing"
+], f = /[?¿؟？]/u, p = 3, m = 6, h = /* @__PURE__ */ new Map();
+function g(e) {
+	let t = h.get(e);
+	if (t) return t;
+	let n = l[e], r = {
+		locale: e,
+		prep: i(n, e),
+		tierA: new Set(o(n.yes.tierA, e)),
+		negation: new Set(o(n.yes.negation, e))
+	};
+	return h.set(e, r), r;
+}
+function _(e, t) {
+	let n = r(e, t.locale);
+	if (!n) return null;
+	let i = c(a(s(n, t.prep), t.prep.zh), t.prep.prefix, t.prep.suffix, t.prep.zh);
+	return i && i.length > 0 ? i : null;
+}
+function v(e, t) {
+	if (t.prep.zh) {
+		if (e.length > 6) return !1;
+		let n = Array(e.length + 1).fill(!1);
+		n[0] = !0;
+		for (let r = 0; r < e.length; r += 1) if (n[r]) for (let i of t.tierA) e.startsWith(i, r) && (n[r + i.length] = !0);
+		return n[e.length] === !0;
+	}
+	let n = e.split(" ");
+	if (n.length > 3) return !1;
+	let r = (e) => {
+		if (e === n.length) return !0;
+		for (let i = Math.min(3, n.length - e); i > 0; --i) if (t.tierA.has(n.slice(e, e + i).join(" ")) && r(e + i)) return !0;
+		return !1;
+	};
+	return r(0);
+}
+function y(i) {
+	if (i.leaveGuard !== !0 || typeof i.text != "string" || f.test(i.text) || n(i.text.normalize("NFKC").trim())) return !1;
+	let a = e(i.manifest), o = u({
+		ui: i.uiLocale,
+		input: i.inputLocale,
+		narrow: i.commandLocales,
+		manifest: a
+	}).filter((e) => t(a, e, "yes"));
+	if (o.length === 0) return !1;
+	let s = o.map(g), c = new Set(d);
+	for (let e of s) for (let t of e.negation) c.add(t);
+	for (let e of s) {
+		let t = r(i.text, e.locale);
+		if (!t || !e.prep.zh && t.split(" ").some((e) => c.has(e))) return !1;
+	}
+	return s.some((e) => {
+		let t = _(i.text, e);
+		return t !== null && v(t, e);
+	});
+}
+//#endregion
+export { p as ASSENT_MAX_TOKENS, m as ASSENT_MAX_ZH_CHARS, y as offerAssentFor };

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

@@ -0,0 +1,89 @@
+import { AppControlRequest } from '../appControls/grammar';
+import { ControlSnapshot } from '../appControls/snapshot';
+import { LocalDestination, ThemeRequest } from '../localUiCommands';
+import { ChoiceRequest } from '../uiActions/deixis';
+import { ClosedSlots, CompiledFrame } from './frames';
+import { FoldLocale, PrepData } from './normalise';
+import { CommandManifest, LocaleTable } from './types';
+export interface CompiledControlPhrase {
+    frame: CompiledFrame;
+    weak: boolean;
+}
+export interface Compiled {
+    fold: FoldLocale;
+    zh: boolean;
+    prep: PrepData;
+    closed: ClosedSlots;
+    goto: Record<"go" | "open" | "show", CompiledFrame[]>;
+    ambiguous: Set<string>;
+    there: CompiledFrame[];
+    back: CompiledFrame[];
+    pick: CompiledFrame[];
+    language: CompiledFrame[];
+    theme: Array<{
+        frame: CompiledFrame;
+        family: "light" | "dark";
+        invert: boolean;
+        saysTheme: boolean;
+    }>;
+    controls: {
+        phrases: Record<"history" | "transcript" | "previewOpen" | "previewClose" | "newConversation" | "notifications" | "help" | "sidebarCollapse" | "sidebarExpand", CompiledControlPhrase[]>;
+        tab: CompiledFrame[];
+        filter: CompiledFrame[];
+        filterClear: CompiledFrame[];
+        sort: CompiledFrame[];
+        sortDirection: CompiledFrame[];
+        search: CompiledFrame[];
+        /** The search frames with `{q}` taken out: a verb on its own ("搜索") is never a query ("索"). */
+        searchVerbOnly: CompiledFrame[];
+        searchClear: CompiledFrame[];
+    };
+}
+/** @internal for the tests: the compiled form of a table (templates, closed slots). */
+export declare function compileNative(table: LocaleTable): Compiled;
+export type ControlIntent = {
+    request: AppControlRequest;
+    weak: boolean;
+};
+export interface LocaleIntents {
+    theme?: ThemeRequest;
+    back?: true;
+    pick?: ChoiceRequest;
+    there?: true;
+    goto?: {
+        destinations: LocalDestination[];
+        query: string;
+    };
+    control?: ControlIntent;
+}
+export interface LocaleRun {
+    /** `hi`, `ta`, … or `en` for the English additions. */
+    source: string;
+    intents: LocaleIntents;
+}
+export interface LocaleEngineInput {
+    /** The sentence with `normalize("NFKC")` and `trim()` applied, as the matcher holds it. */
+    said: string;
+    destinations: readonly LocalDestination[];
+    uiLocale?: string | undefined;
+    inputLocale?: string | undefined;
+    commandLocales?: readonly string[] | undefined;
+    manifest: CommandManifest;
+    themeWords?: "any" | "mode-only" | undefined;
+    /** An offered navigation context exists (the newest reply's links or list). */
+    navigation: boolean;
+    backRunnable: boolean;
+    controls?: ControlSnapshot | undefined;
+}
+/**
+ * Read one sentence with every active table. Empty when nothing is switched on.
+ * The caller maps each run's intents to a command and drops the result if two
+ * runs disagree.
+ */
+export declare function matchLocaleIntents(input: LocaleEngineInput): LocaleRun[];
+/**
+ * Could this sentence be "take me there" or a pick, in any active table? The
+ * panel builds the offered-navigation context (a parse of the newest reply) only
+ * for such a sentence, so an ordinary send never parses a reply.
+ */
+export declare function mayBeThereOrPick(input: Omit<LocaleEngineInput, "destinations" | "controls">): boolean;

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[];