@burdenoff/fe-libs 2026.1004.4 → 2026.1004.6

package/dist/shared/assistant/appControls/plan.js

@@ -0,0 +1,511 @@
+import { getAssistantControl as e } from "./registry.js";
+import { uiLanguageEnglishName as t } from "./languages.js";
+import { resolveByLabel as n } from "./names.js";
+//#region src/shared/assistant/appControls/plan.ts
+var r = new Set([
+	"assistant.history",
+	"assistant.preview",
+	"assistant.conversation.new"
+]), i = (e, t) => ({
+	reply: e,
+	outcome: t
+});
+function a(e) {
+	try {
+		return e();
+	} catch {
+		return { status: "failed" };
+	}
+}
+var o = (e, t) => e.status === "failed" ? i({ code: "failed" }, "failed") : i(t(e.status === "already"), e.status);
+function s(e, t, n) {
+	if (n.voiceLive && r.has(e)) return "voice-session";
+	try {
+		return t.blockedBy?.() ?? null;
+	} catch {
+		return "permission";
+	}
+}
+var c = (e, t) => ({
+	kind: "reply",
+	control: e,
+	run: i({
+		code: "blocked",
+		reason: t
+	}, "blocked")
+});
+function l(t, n) {
+	let { control: r, what: i } = t, l = e(r);
+	if (!l) return null;
+	let u = s(r, l, n);
+	return u ? c(r, u) : {
+		kind: "run",
+		control: r,
+		run: () => o(a(() => l.run()), () => ({
+			code: "opened",
+			what: i
+		}))
+	};
+}
+var u = (e) => e.map((e) => e.label);
+function d(t, r) {
+	let l = e("page");
+	if (!l) return null;
+	let d = s("page", l, r);
+	if (d) return c("page", d);
+	let m = l.page, h = (e) => ({
+		kind: "reply",
+		control: "page",
+		run: e
+	}), g = (e) => ({
+		kind: "run",
+		control: "page",
+		run: e
+	});
+	switch (t.control) {
+		case "page.tab": {
+			let e = l.tabs;
+			if (!e) return null;
+			let r = e.items(), s = n(t.name, r);
+			if (s.kind === "none") return h(i({
+				code: "not-found",
+				what: "tab",
+				page: m,
+				name: t.name,
+				options: u(r)
+			}, "not-found"));
+			if (s.kind === "many") return h(i({
+				code: "ambiguous",
+				what: "tab",
+				name: t.name,
+				options: u(s.items)
+			}, "ambiguous"));
+			let c = s.item;
+			return e.current?.() === c.id ? h(i({
+				code: "tab",
+				name: c.label,
+				already: !0
+			}, "already")) : g(() => o(a(() => e.select(c.id)), (e) => ({
+				code: "tab",
+				name: c.label,
+				already: e
+			})));
+		}
+		case "page.filter": return p(l, t.filter, t.option, h, g);
+		case "page.filter.clear": {
+			let e = l.filters;
+			if (!e) return null;
+			let r = e.items();
+			if (t.filter === null) return g(() => o(a(() => {
+				if (e.clearAll) return e.clearAll();
+				for (let t of r) e.set(t.id, null);
+				return { status: "done" };
+			}), () => ({
+				code: "filter-cleared",
+				filter: null
+			})));
+			let s = n(t.filter, r);
+			if (s.kind === "none") return h(i({
+				code: "not-found",
+				what: "filter",
+				page: m,
+				name: t.filter,
+				options: u(r)
+			}, "not-found"));
+			if (s.kind === "many") return h(i({
+				code: "ambiguous",
+				what: "filter",
+				name: t.filter,
+				options: u(s.items)
+			}, "ambiguous"));
+			let c = s.item;
+			return g(() => o(a(() => e.set(c.id, null)), () => ({
+				code: "filter-cleared",
+				filter: c.label
+			})));
+		}
+		case "page.sort": {
+			let e = l.sort;
+			if (!e) return null;
+			let n = e.fields(), r = f(m, t.field, n, e.current?.() ?? null);
+			if ("reply" in r) return h(r.reply);
+			let { id: s, label: c } = r, u = t.direction ?? "asc", d = e.current?.() ?? null;
+			return d && d.field === s && d.direction === u ? h(i({
+				code: "sorted",
+				page: m,
+				field: c,
+				direction: u,
+				already: !0
+			}, "already")) : g(() => o(a(() => e.set(s, u)), () => ({
+				code: "sorted",
+				page: m,
+				field: c,
+				direction: u,
+				already: !1
+			})));
+		}
+		case "page.search": {
+			let e = l.search;
+			return e ? g(() => o(a(() => e.set(t.query)), () => ({
+				code: "searched",
+				page: m,
+				query: t.query
+			}))) : null;
+		}
+		case "page.search.clear": {
+			let e = l.search;
+			return e ? g(() => o(a(() => e.clear ? e.clear() : e.set("")), () => ({ code: "search-cleared" }))) : null;
+		}
+		case "page.open": {
+			let e = l.openers;
+			if (!e) return null;
+			let r = e.items(), s = n(t.name, r);
+			if (s.kind === "none") return h(i({
+				code: "not-found",
+				what: "form",
+				page: m,
+				name: t.name,
+				options: u(r)
+			}, "not-found"));
+			if (s.kind === "many") return h(i({
+				code: "ambiguous",
+				what: "form",
+				name: t.name,
+				options: u(s.items)
+			}, "ambiguous"));
+			let c = s.item;
+			return g(() => o(a(() => e.open(c.id)), () => ({
+				code: "form-opened",
+				name: c.label
+			})));
+		}
+		default: return null;
+	}
+}
+function f(e, t, r, a) {
+	if (t === null) return (a ? r.find((e) => e.id === a.field) : void 0) ?? { reply: i({ code: "sort-needs-field" }, "not-found") };
+	let o = n(t, r);
+	return o.kind === "one" ? o.item : { reply: o.kind === "none" ? i({
+		code: "not-found",
+		what: "sort",
+		page: e,
+		name: t,
+		options: u(r)
+	}, "not-found") : i({
+		code: "ambiguous",
+		what: "column",
+		name: t,
+		options: u(o.items)
+	}, "ambiguous") };
+}
+function p(e, t, r, s, c) {
+	let l = e.filters;
+	if (!l) return null;
+	let d = e.page, f = l.items(), p = [];
+	if (t !== null) {
+		let e = n(t, f);
+		if (e.kind === "none") return s(i({
+			code: "not-found",
+			what: "filter",
+			page: d,
+			name: t,
+			options: u(f)
+		}, "not-found"));
+		if (e.kind === "many") return s(i({
+			code: "ambiguous",
+			what: "filter",
+			name: t,
+			options: u(e.items)
+		}, "ambiguous"));
+		let a = e.item, o = a.options(), c = n(r, o, { sayingMayContainLabel: !0 });
+		if (c.kind === "none") return s(i({
+			code: "not-found",
+			what: "filter-option",
+			page: d,
+			name: r,
+			options: u(o),
+			filter: a.label
+		}, "not-found"));
+		if (c.kind === "many") return s(i({
+			code: "ambiguous",
+			what: "filter",
+			name: r,
+			options: u(c.items)
+		}, "ambiguous"));
+		p.push({
+			filter: a,
+			option: c.item
+		});
+	} else {
+		for (let e of f) {
+			let t = n(r, e.options(), { sayingMayContainLabel: !0 });
+			if (t.kind === "one") p.push({
+				filter: e,
+				option: t.item
+			});
+			else if (t.kind === "many") for (let n of t.items) p.push({
+				filter: e,
+				option: n
+			});
+		}
+		if (p.length === 0) {
+			let e = n(r, f);
+			return e.kind === "one" ? s(i({
+				code: "filter-choose",
+				filter: e.item.label,
+				options: u(e.item.options())
+			}, "not-found")) : s(i({
+				code: "not-found",
+				what: "filter",
+				page: d,
+				name: r,
+				options: u(f)
+			}, "not-found"));
+		}
+		if (p.length > 1) return s(i({
+			code: "ambiguous",
+			what: "filter",
+			name: r,
+			options: p.map((e) => `${e.filter.label}: ${e.option.label}`)
+		}, "ambiguous"));
+	}
+	let [m] = p;
+	if (!m) return null;
+	let { filter: h, option: g } = m;
+	return h.current?.() === g.value ? s(i({
+		code: "filter-set",
+		filter: h.label,
+		option: g.label,
+		already: !0
+	}, "already")) : c(() => o(a(() => l.set(h.id, g.value)), (e) => ({
+		code: "filter-set",
+		filter: h.label,
+		option: g.label,
+		already: e
+	})));
+}
+function m(r, f) {
+	switch (r.control) {
+		case "header.notifications": return l({
+			control: "header.notifications",
+			what: "notifications"
+		}, f);
+		case "header.help": return l({
+			control: "header.help",
+			what: "help"
+		}, f);
+		case "header.context": return l({
+			control: "header.context",
+			what: "context"
+		}, f);
+		case "assistant.history": return l({
+			control: "assistant.history",
+			what: "history"
+		}, f);
+		case "assistant.transcript": return l({
+			control: "assistant.transcript",
+			what: "transcript"
+		}, f);
+		case "assistant.preview": return l({
+			control: "assistant.preview",
+			what: "preview"
+		}, f);
+		case "assistant.conversation.new": {
+			let t = e("assistant.conversation.new");
+			if (!t) return null;
+			let n = s("assistant.conversation.new", t, f);
+			return n ? c("assistant.conversation.new", n) : {
+				kind: "run",
+				control: "assistant.conversation.new",
+				silent: !0,
+				run: () => o(a(() => t.run()), () => ({
+					code: "opened",
+					what: "conversation"
+				}))
+			};
+		}
+		case "header.search": {
+			let t = e("header.search");
+			if (!t) return null;
+			let n = s("header.search", t, f);
+			return n ? c("header.search", n) : {
+				kind: "run",
+				control: "header.search",
+				run: () => o(a(() => t.run({ query: r.query })), () => ({
+					code: "search-opened",
+					query: r.query
+				}))
+			};
+		}
+		case "sidebar": {
+			let t = e("sidebar");
+			if (!t) return null;
+			let n = s("sidebar", t, f);
+			return n ? c("sidebar", n) : t.collapsed() === r.collapsed ? {
+				kind: "reply",
+				control: "sidebar",
+				run: i({
+					code: "sidebar",
+					collapsed: r.collapsed,
+					already: !0
+				}, "already")
+			} : {
+				kind: "run",
+				control: "sidebar",
+				run: () => o(a(() => t.setCollapsed(r.collapsed)), (e) => ({
+					code: "sidebar",
+					collapsed: r.collapsed,
+					already: e
+				}))
+			};
+		}
+		case "sidebar.entry": {
+			let t = e("sidebar");
+			if (!t) return null;
+			let l = s("sidebar", t, f);
+			if (l) return c("sidebar", l);
+			let d = t.entries(), p = n(r.name, d);
+			if (p.kind === "none") return null;
+			if (p.kind === "many") return {
+				kind: "reply",
+				control: "sidebar",
+				run: i({
+					code: "ambiguous",
+					what: "menu",
+					name: r.name,
+					options: u(p.items)
+				}, "ambiguous")
+			};
+			let m = p.item;
+			return m.expanded === r.expanded ? {
+				kind: "reply",
+				control: "sidebar",
+				run: i({
+					code: "sidebar-entry",
+					name: m.label,
+					expanded: r.expanded,
+					already: !0
+				}, "already")
+			} : {
+				kind: "run",
+				control: "sidebar",
+				run: () => o(a(() => t.setExpanded(m.id, r.expanded)), (e) => ({
+					code: "sidebar-entry",
+					name: m.label,
+					expanded: r.expanded,
+					already: e
+				}))
+			};
+		}
+		case "language": {
+			let n = e("language");
+			if (!n) return null;
+			let l = s("language", n, f);
+			if (l) return c("language", l);
+			let u = n.languages().find((e) => e.code.toLowerCase() === r.code);
+			return u ? n.current().toLowerCase() === u.code.toLowerCase() ? {
+				kind: "reply",
+				control: "language",
+				run: i({
+					code: "language",
+					label: u.label,
+					already: !0
+				}, "already")
+			} : {
+				kind: "run",
+				control: "language",
+				run: () => o(a(() => n.set(u.code)), (e) => ({
+					code: "language",
+					label: u.label,
+					already: e
+				}))
+			} : {
+				kind: "reply",
+				control: "language",
+				run: i({
+					code: "language-not-offered",
+					label: t(r.code)
+				}, "not-found")
+			};
+		}
+		case "header.workspace": {
+			let t = e("header.workspace");
+			if (!t) return null;
+			let l = s("header.workspace", t, f);
+			if (l) return c("header.workspace", l);
+			let d = t.targets(), p = d.filter((e) => e.current !== !0);
+			if (p.length === 0) return {
+				kind: "reply",
+				control: "header.workspace",
+				run: i({ code: "workspace-none" }, "not-found")
+			};
+			let m = n(r.target, d);
+			if (m.kind === "none") return {
+				kind: "reply",
+				control: "header.workspace",
+				run: i({
+					code: "not-found",
+					what: "workspace",
+					page: "",
+					name: r.target,
+					options: u(p)
+				}, "not-found")
+			};
+			if (m.kind === "many") return {
+				kind: "reply",
+				control: "header.workspace",
+				run: i({
+					code: "ambiguous",
+					what: "workspace",
+					name: r.target,
+					options: u(m.items)
+				}, "ambiguous")
+			};
+			let h = m.item;
+			return h.current === !0 ? {
+				kind: "reply",
+				control: "header.workspace",
+				run: i({
+					code: "workspace-already",
+					name: h.label
+				}, "already")
+			} : {
+				kind: "confirm",
+				control: "header.workspace",
+				prompt: {
+					kind: "workspace",
+					name: h.label
+				},
+				ask: i({
+					code: "workspace-confirm",
+					name: h.label
+				}, "confirm"),
+				confirmed: () => {
+					let t = e("header.workspace"), n = t?.targets().find((e) => e.id === h.id);
+					return !t || !n || n.current === !0 || s("header.workspace", t, f) ? i({ code: "failed" }, "failed") : o(a(() => t.switchTo(h.id)), () => ({
+						code: "workspace-switched",
+						name: h.label
+					}));
+				}
+			};
+		}
+		case "account.logout": {
+			let t = e("account.logout");
+			if (!t) return null;
+			let n = s("account.logout", t, f);
+			return n ? c("account.logout", n) : {
+				kind: "confirm",
+				control: "account.logout",
+				prompt: { kind: "logout" },
+				ask: i({ code: "logout-confirm" }, "confirm"),
+				confirmed: () => {
+					let t = e("account.logout");
+					return !t || s("account.logout", t, f) ? i({ code: "failed" }, "failed") : o(a(() => t.run()), () => ({ code: "logout-done" }));
+				}
+			};
+		}
+		default: return d(r, f);
+	}
+}
+//#endregion
+export { m as planAppControl };

package/dist/shared/assistant/appControls/registry.d.ts

@@ -0,0 +1,9 @@
+import { ControlKey, ControlMap } from './types';
+/** Register `impl` for `key`. Returns the cleanup that removes exactly this entry. */
+export declare function registerAssistantControl<K extends ControlKey>(key: K, impl: ControlMap[K]): () => void;
+/** The handler in force for `key` (the newest registration), or null. */
+export declare function getAssistantControl<K extends ControlKey>(key: K): ControlMap[K] | null;
+export declare function hasAssistantControl(key: ControlKey): boolean;
+/** Test seam: forget every registration. */
+export declare function clearAssistantControls(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/shared/assistant/appControls/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/appControls/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AA8CtD,sFAAsF;AACtF,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,UAAU,EAC3D,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAClB,MAAM,IAAI,CAQZ;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAGtF;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAE5D;AAED,4CAA4C;AAC5C,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/shared/assistant/appControls/registry.js

@@ -0,0 +1,38 @@
+//#region src/shared/assistant/appControls/registry.ts
+var e = {
+	"header.notifications": [],
+	"header.search": [],
+	"header.help": [],
+	"header.context": [],
+	"header.workspace": [],
+	"account.logout": [],
+	sidebar: [],
+	language: [],
+	"assistant.history": [],
+	"assistant.transcript": [],
+	"assistant.preview": [],
+	"assistant.conversation.new": [],
+	page: []
+};
+function t(t, n) {
+	let r = Symbol(t), i = e[t];
+	return i.push({
+		token: r,
+		impl: n
+	}), () => {
+		let e = i.findIndex((e) => e.token === r);
+		e >= 0 && i.splice(e, 1);
+	};
+}
+function n(t) {
+	let n = e[t];
+	return n.length > 0 ? n[n.length - 1]?.impl ?? null : null;
+}
+function r(t) {
+	return e[t].length > 0;
+}
+function i() {
+	for (let t of Object.keys(e)) e[t].length = 0;
+}
+//#endregion
+export { i as clearAssistantControls, n as getAssistantControl, r as hasAssistantControl, t as registerAssistantControl };

package/dist/shared/assistant/appControls/snapshot.d.ts

@@ -0,0 +1,42 @@
+import { ControlKey, ControlTarget, SidebarEntry, UiLanguage } from './types';
+/** A page's controls as the grammar needs to see them (labels only, no handlers). */
+export interface PageSnapshot {
+    name: string;
+    tabs: readonly {
+        id: string;
+        label: string;
+    }[];
+    filters: readonly {
+        id: string;
+        label: string;
+        options: readonly {
+            value: string;
+            label: string;
+        }[];
+    }[];
+    sorts: readonly {
+        id: string;
+        label: string;
+    }[];
+    searchable: boolean;
+    openers: readonly {
+        id: string;
+        label: string;
+    }[];
+}
+/**
+ * What the grammar may know about the controls in force right now: which are
+ * registered, and the WORDS the product gave them (tab labels, filter options,
+ * languages). Read fresh for every sentence — never cached, because a page
+ * mounts and unmounts between two sentences.
+ */
+export interface ControlSnapshot {
+    registered: Readonly<Record<ControlKey, boolean>>;
+    languages: readonly UiLanguage[];
+    sidebarEntries: readonly SidebarEntry[];
+    workspaces: readonly ControlTarget[];
+    page: PageSnapshot | null;
+}
+export declare const EMPTY_CONTROL_SNAPSHOT: ControlSnapshot;
+export declare function readControlSnapshot(): ControlSnapshot;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/shared/assistant/appControls/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/appControls/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACX,MAAM,SAAS,CAAC;AAGjB,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,OAAO,EAAE,SAAS;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,SAAS;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACtD,EAAE,CAAC;IACJ,KAAK,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnD;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,SAAS,EAAE,SAAS,UAAU,EAAE,CAAC;IACjC,cAAc,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;IACrC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;CAC3B;AAED,eAAO,MAAM,sBAAsB,EAAE,eASpC,CAAC;AAWF,wBAAgB,mBAAmB,IAAI,eAAe,CAkCrD"}

package/dist/shared/assistant/appControls/snapshot.js

@@ -0,0 +1,40 @@
+import { getAssistantControl as e, hasAssistantControl as t } from "./registry.js";
+import { CONTROL_KEYS as n } from "./types.js";
+//#region src/shared/assistant/appControls/snapshot.ts
+var r = {
+	registered: Object.fromEntries(n.map((e) => [e, !1])),
+	languages: [],
+	sidebarEntries: [],
+	workspaces: [],
+	page: null
+};
+function i(e, t) {
+	try {
+		return e();
+	} catch {
+		return t;
+	}
+}
+function a() {
+	let r = Object.fromEntries(n.map((e) => [e, t(e)])), a = e("language"), o = e("sidebar"), s = e("header.workspace"), c = e("page");
+	return {
+		registered: r,
+		languages: a ? i(() => a.languages(), []) : [],
+		sidebarEntries: o ? i(() => o.entries(), []) : [],
+		workspaces: s ? i(() => s.targets(), []) : [],
+		page: c ? {
+			name: c.page,
+			tabs: c.tabs ? i(() => c.tabs?.items() ?? [], []) : [],
+			filters: c.filters ? i(() => c.filters?.items().map((e) => ({
+				id: e.id,
+				label: e.label,
+				options: e.options()
+			})) ?? [], []) : [],
+			sorts: c.sort ? i(() => c.sort?.fields() ?? [], []) : [],
+			searchable: c.search !== void 0,
+			openers: c.openers ? i(() => c.openers?.items() ?? [], []) : []
+		} : null
+	};
+}
+//#endregion
+export { r as EMPTY_CONTROL_SNAPSHOT, a as readControlSnapshot };

package/dist/shared/assistant/appControls/text.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Lower-case, punctuation-free, single-spaced ("let's" → "let s"). The ONE
+ * canonical form the command grammars compare in (`localUiCommands.ts` and
+ * `appControls/grammar.ts`), so a label and a sentence are judged alike.
+ */
+export declare function canonical(text: string): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/shared/assistant/appControls/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/appControls/text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ9C"}

package/dist/shared/assistant/appControls/text.js

@@ -0,0 +1,6 @@
+//#region src/shared/assistant/appControls/text.ts
+function e(e) {
+	return e.normalize("NFKC").toLowerCase().replace(/&/g, " and ").replace(/[^\p{L}\p{N}\s]/gu, " ").replace(/\s+/g, " ").trim();
+}
+//#endregion
+export { e as canonical };