@burdenoff/fe-libs 2026.1004.4 → 2026.1004.6

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

@@ -0,0 +1,236 @@
+import { canonical as e } from "./text.js";
+import { uiLanguageFromWords as t } from "./languages.js";
+import { resolveByLabel as n } from "./names.js";
+//#region src/shared/assistant/appControls/grammar.ts
+var r = "(?:(?:the|my|our|this) )?", i = "(?:open|show|show me|view|pull up|bring up|display|check)", a = (e) => ({
+	request: e,
+	weak: !1
+}), o = (e) => ({
+	request: e,
+	weak: !0
+}), s = (e) => e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function c(e, t) {
+	let n = t.split(" ").filter(Boolean);
+	if (n.length === 0) return t;
+	let r = new RegExp(n.map(s).join("[^\\p{L}\\p{N}]+"), "giu"), i = e.normalize("NFKC"), a = null;
+	for (let e of i.matchAll(r)) a = e[0];
+	return a ?? t;
+}
+var l = 60, u = /^(?:log ?out|sign ?out|(?:log|sign) (?:me )?out(?: of (?:the |my |this )?(?:app|application|account|session))?)$/, d = "(?:workspace|workspaces|context|contexts|organi[sz]ation|organi[sz]ations|org|project)", f = "(?:switcher|selector|picker|menu|dropdown|list)", p = /^(?:another|other|a different|different|a new|new|a|the|another one|other one)$/, m = RegExp(`^${i} ${r}(?:notification|notifications) (?:panel|bell|centre|center|menu|tray|drawer|list)$`), h = RegExp(`^${i} ${r}(?:notification )?bell$`), g = RegExp(`^${i} ${r}notifications?$`), _ = RegExp(`^${i} ${r}(?:help (?:menu|panel|dialog|dialogue|centre|center)|keyboard shortcuts|keyboard help|shortcuts)$`), v = RegExp(`^${i} ${r}help$`), y = RegExp(`^(?:open|show|start|use|pull up|bring up) ${r}(?:global |app )search(?: (?:bar|box|dialog|dialogue|panel))?$|^(?:open|show|start|use|pull up|bring up) ${r}search (?:bar|box|dialog|dialogue|panel)$`), b = /^(?:open|start|use|pull up|bring up) (?:(?:the|my) )?search$/, x = [
+	/^(?:open|start|use|pull up|bring up) (?:(?:the|my) )?(?:global |app )?search (?:for|with) (.+)$/,
+	/^(?:global search|search everything|search everywhere|search globally|search the app|search all|search across the app) (?:for )?(.+)$/,
+	/^search (?:the app|everything|everywhere|globally|all|across the app) for (.+)$/
+], S = "(?:side ?bar|side menu|side navigation|side nav|navigation (?:bar|menu|panel|drawer)|nav (?:bar|menu|panel|drawer)|left (?:menu|sidebar|panel))", C = RegExp(`^(?:collapse|close|hide|minimi[sz]e|shrink|fold) ${r}${S}$`), w = RegExp(`^(?:expand|open|show|reveal|unhide|bring up|widen|unfold) ${r}${S}$`), T = "(?: (?:group|section|menu|folder|submenu|sub menu|list|dropdown))?", E = RegExp(`^(expand|unfold|open up|open|show) ${r}(.+?)${T}$`), D = RegExp(`^(collapse|fold up|close|hide) ${r}(.+?)${T}$`), O = [
+	RegExp(`^(?:change|switch|set|update|turn|put|make)(?: over)? ${r}(?:(?:app|ui|user interface|interface|screen|display|site|system|menu|application) )?language (?:to|into|as|over to) (.+)$`),
+	RegExp(`^(?:switch|change|set|put|turn) ${r}(?:app|ui|user interface|interface|screen|display|site|application|menus?) (?:language )?(?:to|into) (.+)$`),
+	RegExp(`^(?:show|display|use|run) ${r}(?:app|ui|user interface|interface|screen|display|site|application)(?: menus?)? in (.+)$`)
+], k = RegExp(`^${i} ${r}(?:(?:assistant|ai|conversation|conversations|chat) history|history of (?:my )?(?:conversations|chats)|(?:past|previous|old|earlier) conversations)$`), A = RegExp(`^${i} ${r}history$`), j = RegExp(`^${i} ${r}(?:voice|spoken|speech) transcript$`), M = RegExp(`^${i} ${r}transcript$`), N = RegExp(`^${i} ${r}(?:ai|assistant) preview(?: panel| pane| surface)?$`), P = RegExp(`^${i} ${r}preview(?: panel| pane)?$`), F = /^(?:(?:start|begin|open) (?:a |an |another )?(?:new |fresh |blank )?conversation|new conversation|(?:start|begin) (?:a )?(?:new|fresh) conversation with you)$/, I = [RegExp(`^(?:go to|open|show|show me|switch to|select|view|change to|move to|take me to|bring up) ${r}(.+) tab$`), /^(?:switch|change|move) tabs? to (.+)$/], L = "(?:filter|narrow|limit)(?: down)?", R = [RegExp(`^${L}(?: ${r}(?:page|list|table|results|items|rows|view))? (?:by|to|for|on) ${r}(.+)$`)], z = [/^(?:show|display|list|keep) only (.+)$/, /^only (?:show|display|list|keep) (.+)$/], B = [
+	RegExp(`^(?:set|change|switch|put|make) ${r}(.+?) filter (?:to|as|on) (.+)$`),
+	RegExp(`^${L} ${r}(.+?) (?:by|to|for|on) (.+)$`),
+	RegExp(`^(?:use|apply) ${r}(.+?) filter (?:of|with|for|set to) (.+)$`)
+], V = RegExp(`^(?:clear|remove|reset|drop|turn off) ${r}(?:(?:all|every) )?(?:(.+?) )?filters?$`), H = [
+	[/(?: in)? (?:ascending|asc)(?: order)?$/, "asc"],
+	[/(?: in)? (?:descending|desc)(?: order)?$/, "desc"],
+	[/ (?:a to z|low to high|lowest first|smallest first|oldest first)$/, "asc"],
+	[/ (?:z to a|high to low|highest first|largest first|biggest first|newest first|latest first)$/, "desc"]
+], U = RegExp(`^(?:sort|order|arrange|rank)(?: ${r}(?:page|list|table|results|items|rows|view|it|them))? by (.+)$`), W = /^(?:sort|order)(?: it| them)? (ascending|descending|asc|desc)$/, G = [
+	/^(?:search|find|look)(?: (?:this page|the page|the list|the table|this list|this table|here|these|them))? for (.+)$/,
+	/^(?:find|search for) (.+?) (?:on|in) (?:this|the) (?:page|list|table)$/,
+	/^search (?:this page|the page|the list|the table|here) (?:for )?(.+)$/
+], K = /^(?:clear|reset|empty|remove|stop) (?:the |my |this )?(?:page )?search(?:ing)?$/, q = [RegExp(`^(?:open|show|start|bring up|pull up) ${r}(.+?) (?:form|dialog|dialogue|modal)$`)], J = RegExp(`^(?:open|show|start|bring up|pull up) ${r}(.+)$`), Y = /\b(?:and then|then|and also|also|after that|afterwards|and open|and show|and go|and sort|and filter)\b/;
+function X(e, t) {
+	for (let n of e) {
+		let e = n.exec(t);
+		if (e) return e;
+	}
+	return null;
+}
+function Z(e) {
+	for (let [t, n] of H) {
+		let r = t.exec(e);
+		if (r) return {
+			field: e.slice(0, r.index).trim(),
+			direction: n
+		};
+	}
+	return {
+		field: e,
+		direction: null
+	};
+}
+function Q(e) {
+	let t = e.replace(/\b(?:please|pls)$/, "").trim();
+	return !t || t.length > l ? null : t;
+}
+function $(s, l, S) {
+	let T = S.registered;
+	if (Y.test(s)) return null;
+	if (T["account.logout"] && u.test(s)) return a({ control: "account.logout" });
+	if (T["header.workspace"] || T["header.context"]) {
+		let e = RegExp(`^(?:switch|change|move|go|jump|hop)(?: over)? to ${r}(.+?) ${d}$`).exec(s) ?? RegExp(`^(?:switch|change|move) ${r}${d} (?:to|over to) ${r}(.+)$`).exec(s);
+		if (e && T["header.workspace"]) {
+			let t = (e[1] ?? "").trim();
+			if (t && !p.test(t)) return a({
+				control: "header.workspace",
+				target: t
+			});
+			if (T["header.context"]) return a({ control: "header.context" });
+		}
+		if (T["header.context"] && (RegExp(`^${i} ${r}${d} ${f}$`).test(s) || RegExp(`^(?:switch|change) ${r}${d}$`).test(s))) return a({ control: "header.context" });
+	}
+	if (T["header.notifications"]) {
+		if (m.test(s) || h.test(s)) return a({ control: "header.notifications" });
+		if (g.test(s)) return o({ control: "header.notifications" });
+	}
+	if (T["header.help"]) {
+		if (_.test(s)) return a({ control: "header.help" });
+		if (v.test(s)) return o({ control: "header.help" });
+	}
+	if (T["header.search"]) {
+		for (let e of x) {
+			let t = e.exec(s), n = t ? Q(t[1] ?? "") : null;
+			if (n) return a({
+				control: "header.search",
+				query: c(l, n)
+			});
+		}
+		if (y.test(s)) return a({
+			control: "header.search",
+			query: null
+		});
+		if (b.test(s)) return o({
+			control: "header.search",
+			query: null
+		});
+	}
+	if (T.sidebar) {
+		if (C.test(s)) return a({
+			control: "sidebar",
+			collapsed: !0
+		});
+		if (w.test(s)) return a({
+			control: "sidebar",
+			collapsed: !1
+		});
+		let e = E.exec(s), t = e ? null : D.exec(s), r = e ?? t;
+		if (r && S.sidebarEntries.length > 0) {
+			let t = (r[2] ?? "").trim(), i = r[1] ?? "";
+			if (t && n(t, S.sidebarEntries).kind !== "none") return {
+				request: {
+					control: "sidebar.entry",
+					name: t,
+					expanded: e !== null
+				},
+				weak: !/^(?:expand|unfold|open up|collapse|fold up)$/.test(i)
+			};
+		}
+	}
+	if (T.language) for (let e of O) {
+		let n = e.exec(s);
+		if (!n) continue;
+		let r = t(n[1] ?? "");
+		if (r) return a({
+			control: "language",
+			code: r
+		});
+	}
+	if (T["assistant.history"]) {
+		if (k.test(s)) return a({ control: "assistant.history" });
+		if (A.test(s)) return o({ control: "assistant.history" });
+	}
+	if (T["assistant.transcript"]) {
+		if (j.test(s)) return a({ control: "assistant.transcript" });
+		if (M.test(s)) return o({ control: "assistant.transcript" });
+	}
+	if (T["assistant.preview"]) {
+		if (N.test(s)) return a({ control: "assistant.preview" });
+		if (P.test(s)) return o({ control: "assistant.preview" });
+	}
+	if (T["assistant.conversation.new"] && F.test(s)) return a({ control: "assistant.conversation.new" });
+	let L = S.page;
+	if (!L) return null;
+	if (L.tabs.length > 0) {
+		let e = X(I, s), t = e ? (e[1] ?? "").trim() : "";
+		if (t) {
+			let e = n(t, L.tabs).kind !== "none";
+			return {
+				request: {
+					control: "page.tab",
+					name: t
+				},
+				weak: !e
+			};
+		}
+	}
+	if (L.filters.length > 0) {
+		let e = V.exec(s);
+		if (e) return a({
+			control: "page.filter.clear",
+			filter: (e[1] ?? "").trim() || null
+		});
+		let t = X(B, s);
+		if (t) {
+			let e = (t[1] ?? "").trim(), r = (t[2] ?? "").trim();
+			if (e && r && n(e, L.filters).kind !== "none") return a({
+				control: "page.filter",
+				filter: e,
+				option: r
+			});
+		}
+		let r = X(R, s);
+		if (r && (r[1] ?? "").trim()) return a({
+			control: "page.filter",
+			filter: null,
+			option: (r[1] ?? "").trim()
+		});
+		let i = X(z, s);
+		if (i) {
+			let e = (i[1] ?? "").trim(), t = L.filters.some((t) => n(e, t.options).kind !== "none");
+			if (e && t) return a({
+				control: "page.filter",
+				filter: null,
+				option: e
+			});
+		}
+	}
+	if (L.sorts.length > 0) {
+		let e = W.exec(s);
+		if (e) return a({
+			control: "page.sort",
+			field: null,
+			direction: /^asc/.test(e[1] ?? "") ? "asc" : "desc"
+		});
+		let t = U.exec(s);
+		if (t) {
+			let { field: e, direction: n } = Z((t[1] ?? "").trim());
+			if (e) return a({
+				control: "page.sort",
+				field: e,
+				direction: n
+			});
+		}
+	}
+	if (L.searchable) {
+		if (K.test(s)) return a({ control: "page.search.clear" });
+		let e = X(G, s), t = e ? Q(e[1] ?? "") : null;
+		if (t) return a({
+			control: "page.search",
+			query: c(l, t)
+		});
+	}
+	if (L.openers.length > 0) {
+		let t = X(q, s), r = t ? (t[1] ?? "").trim() : "";
+		if (r && n(r, L.openers).kind !== "none") return a({
+			control: "page.open",
+			name: r
+		});
+		let i = J.exec(s), c = i ? (i[1] ?? "").trim() : "";
+		if (c && L.openers.filter((t) => e(t.label) === c).length > 0) return o({
+			control: "page.open",
+			name: c
+		});
+	}
+	return null;
+}
+//#endregion
+export { $ as matchAppControl, c as queryAsSaid };

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

@@ -0,0 +1,6 @@
+import { UiLanguageCode } from './types';
+/** The UI language a phrase names ("Hindi", "the Tamil language"), or null. */
+export declare function uiLanguageFromWords(said: string): UiLanguageCode | null;
+/** The English name of a UI language, for saying that an app does not offer it. */
+export declare function uiLanguageEnglishName(code: UiLanguageCode): string;
+//# sourceMappingURL=languages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/appControls/languages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAoB9C,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAMvE;AAWD,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAElE"}

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

@@ -0,0 +1,52 @@
+import { canonical as e } from "./text.js";
+//#region src/shared/assistant/appControls/languages.ts
+var t = {
+	en: [
+		"english",
+		"inglés",
+		"ingles"
+	],
+	ar: [
+		"arabic",
+		"عربي",
+		"العربية",
+		"عربى"
+	],
+	es: [
+		"spanish",
+		"español",
+		"espanol",
+		"castilian"
+	],
+	hi: [
+		"hindi",
+		"हिन्दी",
+		"हिंदी"
+	],
+	ta: ["tamil", "தமிழ்"],
+	zh: [
+		"chinese",
+		"mandarin",
+		"中文",
+		"简体中文",
+		"simplified chinese"
+	]
+}, n = /* @__PURE__ */ new Map();
+for (let [r, i] of Object.entries(t)) for (let t of i) n.set(e(t), r);
+function r(t) {
+	let r = e(t).replace(/^(?:the|a) /, "").replace(/ language$/, "").trim();
+	return n.get(r) ?? null;
+}
+var i = {
+	en: "English",
+	ar: "Arabic",
+	es: "Spanish",
+	hi: "Hindi",
+	ta: "Tamil",
+	zh: "Chinese"
+};
+function a(e) {
+	return i[e];
+}
+//#endregion
+export { a as uiLanguageEnglishName, r as uiLanguageFromWords };

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

@@ -0,0 +1,22 @@
+export type NameMatch<T> = {
+    kind: "one";
+    item: T;
+} | {
+    kind: "many";
+    items: T[];
+} | {
+    kind: "none";
+};
+/**
+ * Which of `items` a person means by `said`, judged on the product's own
+ * labels. Exact first; otherwise the saying is a whole-word part of the label
+ * ("overview" for "Overview & Metrics") or, where the caller allows it, the
+ * label is a part of the saying ("active crops" for "Active"). A name that
+ * several items share is `many` — never guessed at.
+ */
+export declare function resolveByLabel<T extends {
+    label: string;
+}>(said: string, items: readonly T[], options?: {
+    sayingMayContainLabel?: boolean;
+}): NameMatch<T>;
+//# sourceMappingURL=names.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/appControls/names.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,CAAC,CAAC,IACnB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAQrB;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EACxD,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,GAAE;IAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAO,GAChD,SAAS,CAAC,CAAC,CAAC,CA4Bd"}

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

@@ -0,0 +1,29 @@
+import { canonical as e } from "./text.js";
+//#region src/shared/assistant/appControls/names.ts
+var t = /^(?:the|my|our|this|that|a|an) /, n = (e, t) => t.length > 0 && ` ${e} `.includes(` ${t} `);
+function r(r, i, a = {}) {
+	let o = e(r).replace(t, "").trim();
+	if (!o) return { kind: "none" };
+	let s = i.map((n) => ({
+		item: n,
+		label: e(n.label).replace(t, "")
+	})).filter((e) => e.label.length > 0), c = s.filter((e) => e.label === o), l = (e) => {
+		let [t, ...n] = e;
+		return t ? n.length === 0 ? {
+			kind: "one",
+			item: t.item
+		} : {
+			kind: "many",
+			items: e.map((e) => e.item)
+		} : { kind: "none" };
+	};
+	if (c.length > 0) return l(c);
+	let u = a.sayingMayContainLabel ? s.filter((e) => n(o, e.label) && e.label.length >= 3) : [];
+	if (u.length > 0) {
+		let e = Math.max(...u.map((e) => e.label.length));
+		return l(u.filter((t) => t.label.length === e));
+	}
+	return l(s.filter((e) => o.length >= 3 && n(e.label, o)));
+}
+//#endregion
+export { r as resolveByLabel };

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

@@ -0,0 +1,59 @@
+import { ControlResult, PageControlsAdapter, PageFilter } from './types';
+export interface EnumFilterSpec<V extends string> {
+    id: string;
+    /** The filter's own name on the page ("Status"). */
+    label: string;
+    /**
+     * The options the page offers, in its words. The NEUTRAL one ("All") may be
+     * included: it is not listed to the assistant (it is "clear the filter").
+     */
+    options: readonly {
+        value: V;
+        label: string;
+    }[];
+    /** The value that means "no filter". */
+    neutral: V;
+    /** The value applied now. */
+    value: V;
+    /** The page's own setter. */
+    set: (value: V) => void;
+}
+export interface EnumFilterEntry {
+    filter: PageFilter;
+    /** Apply `value` (null: clear). Reports `already` when it is what is applied. */
+    apply: (value: string | null) => ControlResult;
+}
+export declare function enumFilter<V extends string>(spec: EnumFilterSpec<V>): EnumFilterEntry;
+export declare function filtersOf(entries: readonly EnumFilterEntry[]): NonNullable<PageControlsAdapter["filters"]>;
+export interface SortFieldSpec<V extends string> {
+    id: string;
+    label: string;
+    /** The page's sort value for this column ascending, and descending. */
+    asc: V;
+    desc: V;
+}
+export interface SortSpec<V extends string> {
+    /** Only columns the page can sort BOTH ways (and shows right now). */
+    fields: readonly SortFieldSpec<V>[];
+    value: V;
+    set: (value: V) => void;
+}
+export declare function sortOf<V extends string>(spec: SortSpec<V>): NonNullable<PageControlsAdapter["sort"]>;
+export interface TabsSpec<T extends string> {
+    items: readonly {
+        id: T;
+        label: string;
+    }[];
+    value: T;
+    set: (id: T) => void;
+}
+export declare function tabsOf<T extends string>(spec: TabsSpec<T>): NonNullable<PageControlsAdapter["tabs"]>;
+export declare function searchOf(set: (query: string) => void): NonNullable<PageControlsAdapter["search"]>;
+/** One form or dialog the page can OPEN. `open` must only open it. */
+export interface OpenerSpec {
+    id: string;
+    label: string;
+    open: () => void;
+}
+export declare function openersOf(specs: readonly OpenerSpec[]): NonNullable<PageControlsAdapter["openers"]>;
+//# sourceMappingURL=pageAdapters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pageAdapters.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/appControls/pageAdapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,UAAU,EAGX,MAAM,SAAS,CAAC;AAoBjB,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,EAAE,SAAS;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,wCAAwC;IACxC,OAAO,EAAE,CAAC,CAAC;IACX,6BAA6B;IAC7B,KAAK,EAAE,CAAC,CAAC;IACT,6BAA6B;IAC7B,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,iFAAiF;IACjF,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,aAAa,CAAC;CAChD;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,eAAe,CAmBrF;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,WAAW,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAa7C;AAID,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,GAAG,EAAE,CAAC,CAAC;IACP,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,MAAM;IACxC,sEAAsE;IACtE,MAAM,EAAE,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC;IACT,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CACzB;AAED,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EACrC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAChB,WAAW,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAmB1C;AAID,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,MAAM;IACxC,KAAK,EAAE,SAAS;QAAE,EAAE,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC;IACT,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC;CACtB;AAED,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAYpG;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAWjG;AAED,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,WAAW,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAU7C"}

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

@@ -0,0 +1,87 @@
+//#region src/shared/assistant/appControls/pageAdapters.ts
+var e = { status: "done" }, t = { status: "already" }, n = { status: "failed" };
+function r(r) {
+	return {
+		filter: {
+			id: r.id,
+			label: r.label,
+			options: () => r.options.filter((e) => e.value !== r.neutral),
+			current: () => r.value === r.neutral ? null : r.value
+		},
+		apply: (i) => {
+			let a = i === null ? r.neutral : i, o = r.options.find((e) => e.value === a);
+			return o ? r.value === o.value ? t : (r.set(o.value), e) : n;
+		}
+	};
+}
+function i(r) {
+	return {
+		items: () => r.map((e) => e.filter),
+		set: (e, t) => {
+			let i = r.find((t) => t.filter.id === e);
+			return i ? i.apply(t) : n;
+		},
+		clearAll: () => {
+			let n = !1;
+			for (let e of r) e.apply(null).status === "done" && (n = !0);
+			return n ? e : t;
+		}
+	};
+}
+function a(r) {
+	return {
+		fields: () => r.fields.map(({ id: e, label: t }) => ({
+			id: e,
+			label: t
+		})),
+		current: () => {
+			for (let e of r.fields) {
+				if (e.asc === r.value) return {
+					field: e.id,
+					direction: "asc"
+				};
+				if (e.desc === r.value) return {
+					field: e.id,
+					direction: "desc"
+				};
+			}
+			return null;
+		},
+		set: (i, a) => {
+			let o = r.fields.find((e) => e.id === i);
+			if (!o) return n;
+			let s = a === "asc" ? o.asc : o.desc;
+			return r.value === s ? t : (r.set(s), e);
+		}
+	};
+}
+function o(r) {
+	return {
+		items: () => r.items,
+		current: () => r.value,
+		select: (i) => {
+			let a = r.items.find((e) => e.id === i);
+			return a ? r.value === a.id ? t : (r.set(a.id), e) : n;
+		}
+	};
+}
+function s(t) {
+	return {
+		set: (n) => (t(n), e),
+		clear: () => (t(""), e)
+	};
+}
+function c(t) {
+	return {
+		items: () => t.map(({ id: e, label: t }) => ({
+			id: e,
+			label: t
+		})),
+		open: (r) => {
+			let i = t.find((e) => e.id === r);
+			return i ? (i.open(), e) : n;
+		}
+	};
+}
+//#endregion
+export { r as enumFilter, i as filtersOf, c as openersOf, s as searchOf, a as sortOf, o as tabsOf };

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

@@ -0,0 +1,148 @@
+import { AppControlRequest } from './grammar';
+import { ControlBlock, ControlKey, SortDirection } from './types';
+/**
+ * ★ BOFF-8060: turn a matched request into what the panel does — against the
+ * handlers registered RIGHT NOW. Pure but for the handlers it calls; the panel
+ * owns the conversation, the speech and the confirmation dialog.
+ */
+/** What the panel says, as data. `appControlCopy.ts` turns it into words. */
+export type ControlReply = {
+    code: "opened";
+    what: OpenedWhat;
+} | {
+    code: "search-opened";
+    query: string | null;
+} | {
+    code: "sidebar";
+    collapsed: boolean;
+    already: boolean;
+} | {
+    code: "sidebar-entry";
+    name: string;
+    expanded: boolean;
+    already: boolean;
+} | {
+    code: "language";
+    label: string;
+    already: boolean;
+} | {
+    code: "language-not-offered";
+    label: string;
+} | {
+    code: "workspace-confirm";
+    name: string;
+} | {
+    code: "workspace-switched";
+    name: string;
+} | {
+    code: "workspace-already";
+    name: string;
+} | {
+    code: "workspace-none";
+} | {
+    code: "logout-confirm";
+} | {
+    code: "logout-done";
+} | {
+    code: "tab";
+    name: string;
+    already: boolean;
+} | {
+    code: "filter-set";
+    filter: string;
+    option: string;
+    already: boolean;
+} | {
+    code: "filter-cleared";
+    filter: string | null;
+} | {
+    code: "sorted";
+    page: string;
+    field: string;
+    direction: SortDirection;
+    already: boolean;
+} | {
+    code: "sort-needs-field";
+} | {
+    code: "searched";
+    page: string;
+    query: string;
+} | {
+    code: "search-cleared";
+} | {
+    code: "form-opened";
+    name: string;
+} | {
+    code: "not-found";
+    what: NotFoundKind;
+    page: string;
+    name: string;
+    options: string[];
+    filter?: string;
+} | {
+    code: "ambiguous";
+    what: AmbiguousKind;
+    name: string;
+    options: string[];
+} | {
+    code: "filter-choose";
+    filter: string;
+    options: string[];
+} | {
+    code: "failed";
+} | {
+    code: "blocked";
+    reason: ControlBlock;
+};
+export type OpenedWhat = "notifications" | "help" | "context" | "history" | "transcript" | "preview" | "conversation";
+export type NotFoundKind = "tab" | "filter" | "filter-option" | "sort" | "form" | "workspace";
+export type AmbiguousKind = "tab" | "filter" | "menu" | "workspace" | "column" | "form";
+/** What is recorded on the exchange (`AssistantLocalAction`). */
+export type ControlOutcome = "done" | "already" | "failed" | "blocked" | "not-found" | "ambiguous" | "confirm";
+export interface ControlRun {
+    reply: ControlReply;
+    outcome: ControlOutcome;
+}
+/** What the stronger confirmation asks about. */
+export type ConfirmPrompt = {
+    kind: "logout";
+} | {
+    kind: "workspace";
+    name: string;
+};
+export type ControlPlan = 
+/** Nothing to run: say it. */
+{
+    kind: "reply";
+    control: ControlKey | "page";
+    run: ControlRun;
+}
+/** Run it now and say what happened. `silent`: record nothing (a new conversation). */
+ | {
+    kind: "run";
+    control: ControlKey | "page";
+    run: () => ControlRun;
+    silent?: boolean;
+}
+/**
+ * ★ Stronger confirmation. `ask` is said now; `confirmed` runs ONLY from a
+ * trusted press on the dialog's button — never from anything typed or said.
+ */
+ | {
+    kind: "confirm";
+    control: ControlKey;
+    ask: ControlRun;
+    prompt: ConfirmPrompt;
+    confirmed: () => ControlRun;
+};
+export interface ControlPlanEnv {
+    /** A live voice session (or a spoken command) — the voice screen is up. */
+    voiceLive: boolean;
+}
+/**
+ * The plan for `request`, or null when what it needs is no longer registered
+ * (the page moved on between the match and the run): the panel then leaves the
+ * sentence to the model, exactly as if nothing had matched.
+ */
+export declare function planAppControl(request: AppControlRequest, env: ControlPlanEnv): ControlPlan | null;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/appControls/plan.ts"],"names":[],"mappings":"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"}