@burdenoff/fe-libs 2026.1028.3 → 2026.1028.5

package/dist/shared/assistant/uiActions/draftPathname.d.ts

@@ -0,0 +1,13 @@
+/** The panel may live outside a Router; observe paths without polling. */
+type PathSource = Pick<EventTarget, 'addEventListener' | 'removeEventListener'> & {
+    location: Pick<Location, 'pathname'>;
+    history?: Pick<History, 'pushState' | 'replaceState'>;
+};
+/**
+ * Only pathnames are compared. History arguments/state, query strings and
+ * hashes are passed through untouched and are never retained or emitted.
+ * Multiple panels share one observer; the last cleanup restores our wrappers
+ * only if another integration has not replaced them in the meantime.
+ */
+export declare function subscribeDraftPathname(source: PathSource, listener: () => void): () => void;
+export {};

package/dist/shared/assistant/uiActions/draftPathname.js

@@ -0,0 +1,31 @@
+//#region src/shared/assistant/uiActions/draftPathname.ts
+var e = /* @__PURE__ */ new WeakMap();
+function t(t, n) {
+	let r = e.get(t);
+	if (!r) {
+		let n = /* @__PURE__ */ new Set(), i = t.location.pathname, a = () => {
+			let e = t.location.pathname;
+			if (e !== i) {
+				i = e;
+				for (let e of [...n]) e();
+			}
+		}, o = t.history, s = o?.pushState, c = o?.replaceState, l = (e) => function(...t) {
+			let n = e.apply(this, t);
+			return queueMicrotask(a), n;
+		}, u = typeof s == "function" ? l(s) : void 0, d = typeof c == "function" ? l(c) : void 0;
+		o && u && (o.pushState = u), o && d && (o.replaceState = d), t.addEventListener("popstate", a), r = {
+			listeners: n,
+			dispose: () => {
+				t.removeEventListener("popstate", a), o && u && o.pushState === u && s && (o.pushState = s), o && d && o.replaceState === d && c && (o.replaceState = c);
+			}
+		}, e.set(t, r);
+	}
+	let i = r, a = () => n();
+	i.listeners.add(a);
+	let o = !0;
+	return () => {
+		o && (o = !1, i.listeners.delete(a), i.listeners.size === 0 && (i.dispose(), e.delete(t)));
+	};
+}
+//#endregion
+export { t as subscribeDraftPathname };

package/dist/shared/assistant/uiActions/recordNames.js

@@ -2,55 +2,58 @@ import { canonical as e } from "../appControls/text.js";
 import { fillEntityRoute as t } from "./entityRoutes.js";
 import { ENTITY_TARGET_PREFIX as n } from "./resolveTarget.js";
 //#region src/shared/assistant/uiActions/recordNames.ts
-var r = (e) => e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), i = new Set(/* @__PURE__ */ "it.that.this.there.here.back.them.those.one.link.page.screen.list.tab.section.view.all.my.the.new.first.second.third.fourth.last.next.previous.settings".split(".")), a = /(?:^| )(?:page|screen|list|tab|section|view|settings|menu)$/, o = 60, s = "(?:open|go to|take me to|pull up|bring up|navigate to|switch to|show me)", c = "(?:open|go to|take me to|pull up|bring up|navigate to)";
-function l(e, t) {
+var r = (e) => e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), i = new Set(/* @__PURE__ */ "it.that.this.there.here.back.them.those.one.link.page.screen.list.tab.section.view.all.my.the.new.first.second.third.fourth.last.next.previous.settings".split(".")), a = /(?:^| )(?:page|screen|list|tab|section|view|settings|menu)$/, o = 60, s = "(?:open|go to|take me to|pull up|bring up|navigate to|switch to|show me)", c = /* @__PURE__ */ RegExp("^(?:open|go to|take me to|pull up|bring up|navigate to) (?:the |my )?(.+)$");
+function l(e) {
+	return [RegExp(`^${s} (?:the |my )?(${e}) (?:(?:called|named) )?(.+)$`), RegExp(`^${s} (?:the |my )?(.+?) (${e})$`)];
+}
+function u(e, t) {
 	if (t.length === 0) return null;
-	let n = (e) => t.filter((t) => t.nouns.includes(e)).map((e) => e.id), l = [...new Set(t.flatMap((e) => e.nouns))].sort((e, t) => t.length - e.length), u = (e) => {
+	let n = (e) => t.filter((t) => t.nouns.includes(e)).map((e) => e.id), s = [...new Set(t.flatMap((e) => e.nouns))].sort((e, t) => t.length - e.length), u = (e) => {
 		let t = e.trim();
 		return t.length >= 2 && t.length <= o && !i.has(t) && !a.test(t);
 	};
-	if (l.length > 0) {
-		let t = l.map((e) => r(e)).join("|"), i = RegExp(`^${s} (?:the |my )?(${t}) (?:(?:called|named) )?(.+)$`).exec(e);
-		if (i && u(i[2] ?? "")) {
-			let e = n(i[1] ?? "");
+	if (s.length > 0) {
+		let [t, i] = l(s.map((e) => r(e)).join("|")), a = t.exec(e);
+		if (a && u(a[2] ?? "")) {
+			let e = n(a[1] ?? "");
 			if (e.length > 0) return {
-				name: (i[2] ?? "").trim(),
+				name: (a[2] ?? "").trim(),
 				adapterIds: e
 			};
 		}
-		let a = RegExp(`^${s} (?:the |my )?(.+?) (${t})$`).exec(e);
-		if (a && u(a[1] ?? "")) {
-			let e = n(a[2] ?? "");
+		let o = i.exec(e);
+		if (o && u(o[1] ?? "")) {
+			let e = n(o[2] ?? "");
 			if (e.length > 0) return {
-				name: (a[1] ?? "").trim(),
+				name: (o[1] ?? "").trim(),
 				adapterIds: e
 			};
 		}
 	}
-	let d = RegExp(`^${c} (?:the |my )?(.+)$`).exec(e);
+	let d = c.exec(e);
 	return d && u(d[1] ?? "") && (d[1] ?? "").length >= 3 ? {
 		name: (d[1] ?? "").trim(),
 		adapterIds: []
 	} : null;
 }
-var u = 4;
-function d(t) {
+var d = 4;
+function f(t) {
 	return e(t);
 }
-var f = d;
-function p(e, t) {
+var p = f;
+function m(e, t) {
 	let n = t.split(" ");
 	return e.split(" ").every((e) => n.some((t) => t.startsWith(e)));
 }
-function m(e, r) {
-	let i = f(e);
+function h(e, r) {
+	let i = p(e);
 	if (!i) return { kind: "none" };
 	let a = [];
 	for (let e of r) for (let r of e.matches) {
 		let o = t(e.route, r.params);
 		if (o === null) continue;
-		let s = f(r.name), c = s === i;
-		!c && !p(i, s) || a.some((e) => e.destination.path === o) || a.push({
+		let s = p(r.name), c = s === i;
+		!c && !m(i, s) || a.some((e) => e.destination.path === o) || a.push({
 			adapterId: e.adapter.id,
 			noun: e.noun,
 			exact: c,
@@ -76,23 +79,23 @@ function m(e, r) {
 		nouns: [...new Set(l.map((e) => e.noun))]
 	};
 }
-var h = 2500, g = 50, _ = 200;
-function v(e) {
+var g = 2500, _ = 50, v = 200;
+function y(e) {
 	if (typeof e != "object" || !e) return !1;
 	let { name: t, params: n } = e;
 	if (typeof t != "string") return !1;
 	let r = t.trim();
-	if (r.length === 0 || r.length > _ || typeof n != "object" || !n || Array.isArray(n)) return !1;
+	if (r.length === 0 || r.length > v || typeof n != "object" || !n || Array.isArray(n)) return !1;
 	let i = Object.values(n);
 	return i.length > 0 && i.every((e) => typeof e == "string");
 }
-function y(e) {
+function b(e) {
 	if (!Array.isArray(e)) return [];
 	let t = [];
-	for (let n of e) if (v(n) && t.push(n), t.length >= 50) break;
+	for (let n of e) if (y(n) && t.push(n), t.length >= 50) break;
 	return t;
 }
-async function b(e) {
+async function x(e) {
 	let t = new AbortController(), n, r = new Promise((r) => {
 		n = setTimeout(() => {
 			t.abort(), r(null);
@@ -116,10 +119,10 @@ async function b(e) {
 				adapter: n,
 				route: i,
 				noun: s,
-				matches: y(o)
+				matches: b(o)
 			};
 		}));
-		return m(e.name, n);
+		return h(e.name, n);
 	} catch {
 		return { kind: "none" };
 	} finally {
@@ -127,4 +130,4 @@ async function b(e) {
 	}
 }
 //#endregion
-export { u as RECORD_CHOICE_MAX, h as RECORD_LOOKUP_TIMEOUT_MS, g as RECORD_MATCHES_MAX, v as isRecordMatch, b as lookupNamedRecords, d as normaliseRecordName, l as parseRecordRequest, m as planRecordResolution, y as sanitizeRecordMatches };
+export { d as RECORD_CHOICE_MAX, g as RECORD_LOOKUP_TIMEOUT_MS, _ as RECORD_MATCHES_MAX, y as isRecordMatch, x as lookupNamedRecords, f as normaliseRecordName, u as parseRecordRequest, h as planRecordResolution, b as sanitizeRecordMatches };

package/dist/shared/assistant/voice/handsfree/handsFreeController.d.ts

@@ -33,6 +33,9 @@ export interface ControllerDeps {
     onFallback: (reason: FallbackReason) => void;
     /** A barge-in that produced no words within `NOTHING_HEARD_MS`. */
     onNothingHeard?: () => void;
+    /** Timing only: end of the latest echo-approved voiced capture frame. */
+    onSpeechFrame?: (at: number) => void;
+    now?: () => number;
     isEnabled: () => boolean;
     prerollMs?: number;
     setTimer?: (fn: () => void, ms: number) => ReturnType<typeof setTimeout>;

package/dist/shared/assistant/voice/handsfree/handsFreeController.js

@@ -66,7 +66,11 @@ function u(u) {
 			rmsDb: e.rmsDb,
 			zcr: e.zcr
 		}, t.pass);
-		r.event === "onset" ? M(t.reason) : b && r.inSegment && u.transport.pushFrame(n), r.event === "end" && j();
+		if (r.event === "onset" && M(t.reason), b && r.voiced && t.pass) {
+			let t = u.now?.() ?? performance.now(), n = _?.context ? Math.max(0, (_.context.currentTime - e.ctxTime) * 1e3) : 0;
+			u.onSpeechFrame?.(t - n);
+		}
+		r.event !== "onset" && b && r.inSegment && u.transport.pushFrame(n), r.event === "end" && j();
 	}, P = () => {
 		if (!v && !_) return;
 		v = !1, k(), b && u.transport.cancelUtterance(b.id), b = null, g.invalidate(), u.transport.stop(), h.clear(), p.reset(), m.reset();

package/dist/shared/assistant/voice/handsfree/useHandsFreeInterrupt.d.ts

@@ -24,6 +24,7 @@ export interface UseHandsFreeInterruptOptions {
     language: string;
     /** The user's voice started while the assistant was audible. */
     onBargeIn: () => void;
+    onSpeechFrame?: (at: number) => void;
     onTranscript: (text: string, final: boolean, language: string | undefined) => void;
     /**
      * The backend stream's privacy-notice version this person accepted (it is

package/dist/shared/assistant/voice/handsfree/useHandsFreeInterrupt.js

@@ -57,6 +57,7 @@ function b(s) {
 			onTranscript: (e, t, n) => {
 				D(!1), C.current.onTranscript(e, t, n);
 			},
+			onSpeechFrame: (e) => C.current.onSpeechFrame?.(e),
 			onFallback: T,
 			onNothingHeard: () => D(!0),
 			isEnabled: () => C.current.enabled

package/dist/shared/assistant/voice/useVoiceInput.d.ts

@@ -94,6 +94,8 @@ export interface UseVoiceInputOptions {
      * here) means the user can freely edit while dictation continues.
      */
     onFinalize: (text: string) => void;
+    /** Browser endpoint notification time; not an acoustic timestamp. */
+    onSpeechEnd?: (at: number) => void;
     /**
      * BCP-47 tag to listen for. Omit to follow the app locale, which is what this
      * hook did unconditionally before (BOFF-7108).
@@ -137,4 +139,4 @@ export interface UseVoiceInputResult {
     toggle: () => void;
     clearError: () => void;
 }
-export declare function useVoiceInput({ onFinalize, language: requested, }: UseVoiceInputOptions): UseVoiceInputResult;
+export declare function useVoiceInput({ onFinalize, onSpeechEnd, language: requested, }: UseVoiceInputOptions): UseVoiceInputResult;

package/dist/shared/assistant/voice/useVoiceInput.js

@@ -35,72 +35,78 @@ function d(e) {
 		default: return "unknown";
 	}
 }
-function f({ onFinalize: s, language: c }) {
-	let { locale: f } = e(), [p, m] = i(!1), [h, g] = i(!1), [_, v] = i(""), [y, b] = i(null), x = r(null), S = r(0), C = r(-Infinity), w = r(0), T = r(s);
+function f({ onFinalize: s, onSpeechEnd: c, language: f }) {
+	let { locale: p } = e(), [m, h] = i(!1), [g, _] = i(!1), [v, y] = i(""), [b, x] = i(null), S = r(null), C = r(0), w = r(-Infinity), T = r(0), E = r(c);
 	n(() => {
-		T.current = s;
+		E.current = c;
+	}, [c]);
+	let D = r(s);
+	n(() => {
+		D.current = s;
 	}, [s]);
-	let E = o() !== null, D = c ?? a[f] ?? "en-US";
+	let O = o() !== null, k = f ?? a[p] ?? "en-US";
 	n(() => () => {
-		x.current?.abort(), x.current = null;
+		S.current?.abort(), S.current = null;
 	}, []);
-	let O = t((e = "manual") => {
+	let A = t((e = "manual") => {
 		let t = o();
-		if (!t || x.current || e === "auto" && u(C.current, performance.now())) return;
+		if (!t || S.current || e === "auto" && u(w.current, performance.now())) return;
 		let n = new t();
-		n.continuous = !0, n.interimResults = !0, n.lang = D;
-		let r = S.current;
-		n.onresult = (e) => {
-			if (r !== S.current) return;
+		n.continuous = !0, n.interimResults = !0, n.lang = k;
+		let r = C.current;
+		n.onspeechend = () => {
+			r === C.current && E.current?.(performance.now());
+		}, n.onresult = (e) => {
+			if (r !== C.current) return;
 			let t = "", n = "";
 			for (let r = e.resultIndex; r < e.results.length; r += 1) {
 				let i = e.results[r], a = i[0]?.transcript ?? "";
 				i.isFinal ? t += a : n += a;
 			}
-			t.trim() && T.current(t.trim()), v(n.trim());
+			t.trim() && D.current(t.trim()), y(n.trim());
 		}, n.onerror = (e) => {
-			if (r !== S.current) return;
+			if (r !== C.current) return;
 			let t = d(e.error);
-			t !== "no-speech" && b(t);
+			t !== "no-speech" && x(t);
 		}, n.onend = () => {
-			r === S.current && (x.current = null, g(!1), m(!1), v(""));
+			r === C.current && (S.current = null, _(!1), h(!1), y(""));
 		}, n.onstart = () => {
-			r === S.current && (g(!1), m(!0));
-		}, g(!0);
+			r === C.current && (_(!1), h(!0));
+		}, _(!0);
 		try {
 			n.start();
 		} catch {
-			C.current = performance.now(), w.current += 1, w.current >= l && b("unknown"), x.current = null, g(!1), m(!1);
+			w.current = performance.now(), T.current += 1, T.current >= l && x("unknown"), S.current = null, _(!1), h(!1);
 			return;
 		}
-		x.current = n, w.current = 0, b(null), v("");
-	}, [D]), k = t(() => {
-		let e = x.current;
-		x.current = null, S.current += 1, e?.stop(), g(!1), m(!1), v("");
-	}, []), A = r(D);
+		S.current = n, T.current = 0, x(null), y("");
+	}, [k]), j = t(() => {
+		let e = S.current;
+		S.current = null, C.current += 1, e?.stop(), _(!1), h(!1), y("");
+	}, []), M = r(k);
 	n(() => {
-		A.current !== D && (A.current = D, k(), b(null));
-	}, [D, k]);
-	let j = t(() => {
-		p || h ? k() : O();
+		M.current !== k && (M.current = k, j(), x(null));
+	}, [k, j]);
+	let N = t(() => {
+		m || g ? j() : A();
 	}, [
-		p,
-		h,
-		O,
-		k
-	]), M = t(() => b(null), []);
+		m,
+		g,
+		A,
+		j
+	]), P = t(() => x(null), []);
 	return {
-		isSupported: E,
-		isListening: p,
-		isStarting: h,
-		isActive: p || h,
-		interim: _,
-		error: y,
-		language: D,
-		start: O,
-		stop: k,
-		toggle: j,
-		clearError: M
+		isSupported: O,
+		isListening: m,
+		isStarting: g,
+		isActive: m || g,
+		interim: v,
+		error: b,
+		language: k,
+		start: A,
+		stop: j,
+		toggle: N,
+		clearError: P
 	};
 }
 //#endregion