@burdenoff/fe-libs 2026.927.3 → 2026.928.2

package/dist/shared/assistant/ui/voice/AssistantVoiceSession.js

@@ -1,25 +1,28 @@
-import { useAssistantTr as e } from "../../i18n.js";
-import { micIsInterrupt as t, showsAssistantCaption as n, voiceStageState as r } from "../../voice/voiceStageState.js";
-import { VOICE_THINKING_LABEL as i, composeVoiceStatus as ee, voiceStatusSuffix as te } from "../../voice/voiceStatus.js";
-import { spokenSoFar as a } from "../../voice/voiceSession.js";
-import { AssistantAttachmentButton as o } from "../composer/AssistantAttachmentButton.js";
-import { AssistantAttachmentChips as ne } from "../composer/AssistantAttachmentChips.js";
-import { AssistantVoiceOrb as s } from "./AssistantVoiceOrb.js";
-import { VoiceMiniController as c } from "./VoiceMiniController.js";
-import { VoiceStage as l } from "./VoiceStage.js";
-import { VoiceTranscriptDrawer as u } from "./VoiceTranscriptDrawer.js";
+import { useReturnFocus as e } from "../../../hooks/useReturnFocus.js";
+import { useAssistantTr as t } from "../../i18n.js";
+import { micIsInterrupt as n, showsAssistantCaption as r, voiceStageState as i } from "../../voice/voiceStageState.js";
+import { VOICE_THINKING_LABEL as a, composeVoiceStatus as ee, voiceStatusSuffix as te } from "../../voice/voiceStatus.js";
+import { spokenSoFar as o } from "../../voice/voiceSession.js";
+import { ASSISTANT_PANEL_ATTR as ne, ASSISTANT_VOICE_SESSION_ATTR as s } from "../panelOverlays.js";
+import { AssistantAttachmentButton as c } from "../composer/AssistantAttachmentButton.js";
+import { AssistantAttachmentChips as l } from "../composer/AssistantAttachmentChips.js";
+import { AssistantVoiceOrb as u } from "./AssistantVoiceOrb.js";
+import { VoiceMiniController as re } from "./VoiceMiniController.js";
+import { VoiceStage as ie } from "./VoiceStage.js";
+import { VoiceTranscriptDrawer as ae } from "./VoiceTranscriptDrawer.js";
+import { escapeBelongsToLayerAbove as oe, voiceSessionEscapeAction as se } from "./voiceSessionEscape.js";
 import { useCallback as d, useEffect as f, useRef as p, useState as m } from "react";
-import { Maximize2 as re, Minimize2 as h, ScrollText as g, X as _ } from "lucide-react";
-import { jsx as v, jsxs as y } from "react/jsx-runtime";
+import { Maximize2 as ce, Minimize2 as le, ScrollText as ue, X as de } from "lucide-react";
+import { jsx as h, jsxs as g } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/voice/AssistantVoiceSession.tsx
-var b = ({ session: b, turns: oe = [], onSaveTranscript: se, onContinueInChat: ce, notice: x = null, spoken: S, onInterrupt: C, onToggleMute: w, attachments: T = [], onAttachFiles: E, onRemoveAttachment: le, onRetryAttachment: ue, canAttachMore: de = !0, preparingAttachments: D = 0, spokenChunks: O = null, onEnd: k, capturing: A = !0, interrupting: fe = !1, awaitingEndpoint: pe = !1 }) => {
-	let j = e(), { muted: M, error: N } = b, P = p(null), F = p(null), [I, L] = m("mini"), R = I === "full", z = I === "mini", B = I === "mini" ? "panel" : I === "panel" ? "full" : "mini", [V, H] = m(!1), U = p(!1), W = p(w);
-	W.current = w;
+var _ = ({ session: _, turns: fe = [], onSaveTranscript: pe, onContinueInChat: me, notice: b = null, spoken: x, onInterrupt: he, onToggleMute: S, attachments: C = [], onAttachFiles: w, onRemoveAttachment: ge, onRetryAttachment: _e, canAttachMore: ve = !0, preparingAttachments: T = 0, spokenChunks: E = null, onEnd: D, capturing: O = !0, interrupting: k = !1, awaitingEndpoint: A = !1 }) => {
+	let j = t(), { muted: M, error: N } = _, P = p(null), F = p(null), [I, L] = m("mini"), R = I === "full", z = I === "mini", B = I === "mini" ? "panel" : I === "panel" ? "full" : "mini", [V, H] = m(!1), U = p(!1), W = p(S);
+	W.current = S;
 	let G = d(() => {
-		b.phase === "listening" && (M || U.current || a(b) || (U.current = !0, W.current()));
-	}, [M, b]), K = d(() => {
+		_.phase === "listening" && (M || U.current || o(_) || (U.current = !0, W.current()));
+	}, [M, _]), K = d(() => {
 		U.current && (U.current = !1, W.current());
-	}, []), me = G;
+	}, []), ye = G;
 	f(() => {
 		let e = () => {
 			document.visibilityState === "hidden" ? G() : K();
@@ -32,14 +35,20 @@ var b = ({ session: b, turns: oe = [], onSaveTranscript: se, onContinueInChat: c
 		};
 	}, []), f(() => {
 		P.current?.focus();
-	}, []), f(() => {
+	}, []), e(F, { fallbackSelector: `[${ne}]` }), f(() => {
 		let e = (e) => {
 			if (e.key === "Escape") {
-				if (V) {
-					H(!1);
-					return;
-				}
-				k();
+				let t = se({
+					defaultPrevented: e.defaultPrevented,
+					layerAbove: oe({
+						target: e.target,
+						session: F.current,
+						doc: document
+					}),
+					transcriptOpen: V
+				});
+				if (t === "ignore") return;
+				e.preventDefault(), t === "close-transcript" ? H(!1) : D();
 				return;
 			}
 			if (e.key !== "Tab" || !R) return;
@@ -50,21 +59,21 @@ var b = ({ session: b, turns: oe = [], onSaveTranscript: se, onContinueInChat: c
 		};
 		return window.addEventListener("keydown", e), () => window.removeEventListener("keydown", e);
 	}, [
-		k,
+		D,
 		R,
 		V
 	]);
-	let q = x !== null && N === null, J = a(b), Y = r({
-		snapshot: b,
-		capturing: A,
-		interrupting: fe,
-		awaitingEndpoint: pe
+	let q = b !== null && N === null, J = o(_), Y = i({
+		snapshot: _,
+		capturing: O,
+		interrupting: k,
+		awaitingEndpoint: A
 	}), X = (() => {
 		switch (Y) {
 			case "connecting": return j("voiceSession.connecting", "Starting the microphone…");
 			case "endpoint-grace": return j("voiceSession.endpointGrace", "Still listening — take your time");
 			case "interrupting": return j("voiceSession.interrupting", "Stopped — go ahead");
-			case "thinking": return j(i.key, i.fallback);
+			case "thinking": return j(a.key, a.fallback);
 			case "speaking": return j("voiceSession.speaking", "Speaking — tap to stop");
 			case "mic-error":
 			case "ended": return "";
@@ -77,59 +86,60 @@ var b = ({ session: b, turns: oe = [], onSaveTranscript: se, onContinueInChat: c
 		muted: M,
 		label: X
 	}), Q = ee(X, Z), $ = Y === "thinking";
-	return /* @__PURE__ */ y("div", {
+	return /* @__PURE__ */ g("div", {
 		ref: F,
 		className: `flex flex-col items-center justify-between bg-bg-sunken ${I === "full" ? "fixed inset-x-0 bottom-0 top-14 z-[60] px-6 py-8" : I === "panel" ? "absolute inset-0 z-20 px-4 py-6" : "absolute inset-x-0 bottom-0 z-20 h-[11.25rem] border-t border-border-subtle px-3 py-3 shadow-lg"}`,
 		role: "dialog",
 		"aria-modal": R || void 0,
 		"aria-label": j("voiceSession.title", "Voice conversation"),
 		"data-testid": "assistant-voice-session",
+		[s]: "",
 		children: [
-			/* @__PURE__ */ y("button", {
+			/* @__PURE__ */ g("button", {
 				ref: P,
 				type: "button",
-				onClick: k,
+				onClick: D,
 				className: `absolute ${R ? "right-6 top-6 h-14 gap-2 px-5 text-base" : z ? "right-12 top-2 h-8 gap-1.5 px-2.5 text-xs" : "right-3 top-3 h-11 gap-2 px-4 text-sm"} flex items-center justify-center rounded-full border border-border-default bg-bg-elevated text-text-secondary hover:bg-bg-sunken transition-colors focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong`,
 				title: j("voiceSession.end", "End the voice conversation"),
 				"data-testid": "assistant-voice-end",
-				children: [/* @__PURE__ */ v(_, {
+				children: [/* @__PURE__ */ h(de, {
 					className: R ? "size-6" : z ? "size-4" : "size-5",
 					"aria-hidden": "true"
-				}), /* @__PURE__ */ v("span", {
+				}), /* @__PURE__ */ h("span", {
 					className: `truncate whitespace-nowrap font-medium ${z ? "max-w-[3.5rem] text-xs" : "max-w-[7rem]"}`,
 					children: j("voiceSession.endShort", "End")
 				})]
 			}),
-			/* @__PURE__ */ v("div", {
+			/* @__PURE__ */ h("div", {
 				className: `flex flex-col items-center ${z ? "px-3" : `min-h-[1.5rem] ${q ? R ? "pt-14" : "pt-10" : ""}`}`,
-				children: q ? /* @__PURE__ */ v("p", {
+				children: q ? /* @__PURE__ */ h("p", {
 					className: "max-w-xs text-center text-xs text-status-warning",
 					"data-testid": "assistant-voice-notice",
-					children: ie(x, j)
+					children: v(b, j)
 				}) : null
 			}),
 			(() => {
-				let e = /* @__PURE__ */ v(s, {
-					session: b,
+				let e = /* @__PURE__ */ h(u, {
+					session: _,
 					compact: z,
 					connecting: Y === "connecting",
-					onPress: t(Y) ? C : w,
-					label: t(Y) ? j("voiceSession.interrupt", "Stop the assistant and speak") : M ? j("voiceSession.unmute", "Turn the microphone on") : j("voiceSession.mute", "Turn the microphone off")
-				}), r = n(Y) ? S : J || null, i = N === null ? null : ae(N, j);
-				return z ? /* @__PURE__ */ v(c, {
-					spokenChunks: O,
+					onPress: n(Y) ? he : S,
+					label: n(Y) ? j("voiceSession.interrupt", "Stop the assistant and speak") : M ? j("voiceSession.unmute", "Turn the microphone on") : j("voiceSession.mute", "Turn the microphone off")
+				}), t = r(Y) ? x : J || null, i = N === null ? null : y(N, j);
+				return z ? /* @__PURE__ */ h(re, {
+					spokenChunks: E,
 					state: Y,
-					caption: r,
+					caption: t,
 					statusText: Q,
 					statusSuffix: Z,
 					rotateStatus: $,
 					errorText: i,
 					control: e
-				}) : /* @__PURE__ */ v(l, {
+				}) : /* @__PURE__ */ h(ie, {
 					state: Y,
 					userCaption: J || null,
-					spokenChunks: O,
-					assistantCaption: S,
+					spokenChunks: E,
+					assistantCaption: x,
 					expanded: R,
 					statusText: Q,
 					statusSuffix: Z,
@@ -138,54 +148,54 @@ var b = ({ session: b, turns: oe = [], onSaveTranscript: se, onContinueInChat: c
 					control: e
 				});
 			})(),
-			V ? /* @__PURE__ */ v(u, {
-				turns: oe,
+			V ? /* @__PURE__ */ h(ae, {
+				turns: fe,
 				onClose: () => H(!1),
-				onSave: se,
-				onContinueInChat: ce
+				onSave: pe,
+				onContinueInChat: me
 			}) : null,
-			E ? /* @__PURE__ */ v("div", {
+			w ? /* @__PURE__ */ h("div", {
 				className: `absolute ${R ? "left-6 top-6" : z ? "left-11 top-2" : "left-3 top-3"}`,
-				children: /* @__PURE__ */ v(o, {
+				children: /* @__PURE__ */ h(c, {
 					onFiles: (e) => {
-						E(e), L((e) => e === "mini" ? "panel" : e);
+						w(e), L((e) => e === "mini" ? "panel" : e);
 					},
-					onPickerOpen: me,
+					onPickerOpen: ye,
 					direction: "down",
-					canAddMore: de
+					canAddMore: ve
 				})
 			}) : null,
-			(T.length > 0 || D > 0) && !z ? /* @__PURE__ */ v("div", {
+			(C.length > 0 || T > 0) && !z ? /* @__PURE__ */ h("div", {
 				className: `absolute ${R ? "bottom-24 left-24 right-24" : "bottom-16 left-16 right-16"}`,
 				"data-testid": "assistant-voice-attachments",
-				children: /* @__PURE__ */ v(ne, {
-					attachments: T,
-					onRemove: le ?? (() => void 0),
-					onRetry: ue ?? (() => void 0),
-					preparingCount: D
+				children: /* @__PURE__ */ h(l, {
+					attachments: C,
+					onRemove: ge ?? (() => void 0),
+					onRetry: _e ?? (() => void 0),
+					preparingCount: T
 				})
 			}) : null,
-			/* @__PURE__ */ v("button", {
+			/* @__PURE__ */ h("button", {
 				type: "button",
 				onClick: () => H((e) => !e),
 				className: `absolute ${R ? "bottom-6 right-6 size-14" : z ? "right-2 top-2 size-8" : "bottom-3 right-3 size-11"} flex items-center justify-center rounded-full bg-bg-elevated text-text-secondary transition-colors hover:bg-bg-raised hover:text-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong`,
 				"aria-pressed": V,
 				"aria-label": j("voiceSession.transcriptTitle", "Voice transcript"),
 				"data-testid": "assistant-voice-transcript-toggle",
-				children: /* @__PURE__ */ v(g, { className: R ? "size-6" : z ? "size-4" : "size-5" })
+				children: /* @__PURE__ */ h(ue, { className: R ? "size-6" : z ? "size-4" : "size-5" })
 			}),
-			/* @__PURE__ */ v("button", {
+			/* @__PURE__ */ h("button", {
 				type: "button",
 				onClick: () => L(B),
 				className: `absolute ${R ? "bottom-6 left-6 size-14" : z ? "left-2 top-2 size-8" : "bottom-3 left-3 size-11"} flex items-center justify-center rounded-full bg-bg-elevated text-text-secondary transition-colors hover:bg-bg-raised hover:text-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong`,
 				"aria-label": B === "panel" ? j("voiceSession.expandPanel", "Show the conversation in the panel") : B === "full" ? j("voiceSession.expand", "Expand the conversation to full screen") : j("voiceSession.collapse", "Shrink to the compact controller"),
 				"data-testid": "assistant-voice-expand",
-				children: R ? /* @__PURE__ */ v(h, { className: "size-5" }) : /* @__PURE__ */ v(re, { className: z ? "size-4" : "size-5" })
+				children: R ? /* @__PURE__ */ h(le, { className: "size-5" }) : /* @__PURE__ */ h(ce, { className: z ? "size-4" : "size-5" })
 			})
 		]
 	});
 };
-function ie(e, t) {
+function v(e, t) {
 	switch (e) {
 		case "network": return t("voiceSession.noticeNetwork", "Speech recognition lost its connection. Check your network — it will retry.");
 		case "not-capturing": return t("voiceSession.noticeNotCapturing", "The microphone did not start. Check that this site is allowed to use it, then try again.");
@@ -194,7 +204,7 @@ function ie(e, t) {
 		default: return e;
 	}
 }
-function ae(e, t) {
+function y(e, t) {
 	switch (e) {
 		case "mic-denied": return t("voiceSession.micDenied", "Microphone access is blocked. Allow it in your browser settings to talk.");
 		case "no-speech-support": return t("voiceSession.noSpeechSupport", "This browser cannot listen. Try a different browser, or type instead.");
@@ -203,4 +213,4 @@ function ae(e, t) {
 	}
 }
 //#endregion
-export { b as AssistantVoiceSession };
+export { _ as AssistantVoiceSession };

package/dist/shared/assistant/ui/voice/VoiceTranscriptDrawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VoiceTranscriptDrawer.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/ui/voice/VoiceTranscriptDrawer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAMnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AAEH,UAAU,KAAK;IACb,KAAK,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,+CAA+C;IAC/C,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,eAAO,MAAM,qBAAqB,EAAE,EAAE,CAAC,KAAK,CA+I3C,CAAC"}
+{"version":3,"file":"VoiceTranscriptDrawer.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/ui/voice/VoiceTranscriptDrawer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAOnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AAEH,UAAU,KAAK;IACb,KAAK,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,+CAA+C;IAC/C,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,eAAO,MAAM,qBAAqB,EAAE,EAAE,CAAC,KAAK,CAoJ3C,CAAC"}

package/dist/shared/assistant/ui/voice/VoiceTranscriptDrawer.js

@@ -1,70 +1,71 @@
-import { useAssistantTr as e } from "../../i18n.js";
-import { ASSISTANT_PANEL_ATTR as t, focusIsInsidePanel as n } from "../panelOverlays.js";
-import { VoiceConversationView as r } from "./VoiceConversationView.js";
-import { AssistantHistoryShowEarlier as i } from "../AssistantHistoryNotices.js";
-import { useEffect as a, useRef as o } from "react";
-import { ArrowRight as s, Download as c, X as l } from "lucide-react";
-import { jsx as u, jsxs as d } from "react/jsx-runtime";
+import { useReturnFocus as e } from "../../../hooks/useReturnFocus.js";
+import { useAssistantTr as t } from "../../i18n.js";
+import { ASSISTANT_PANEL_ATTR as n, focusIsInsidePanel as r } from "../panelOverlays.js";
+import { VoiceConversationView as i } from "./VoiceConversationView.js";
+import { AssistantHistoryShowEarlier as a } from "../AssistantHistoryNotices.js";
+import { useEffect as o, useRef as s } from "react";
+import { ArrowRight as c, Download as l, X as u } from "lucide-react";
+import { jsx as d, jsxs as f } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/voice/VoiceTranscriptDrawer.tsx
-var f = ({ turns: f, onClose: p, onSave: m, onContinueInChat: h, closeOnEscape: g = !1, onShowEarlier: _, showEarlierDisabled: v = !1 }) => {
-	let y = e(), b = o(null);
-	return a(() => {
-		if (!g) return;
+var p = ({ turns: p, onClose: m, onSave: h, onContinueInChat: g, closeOnEscape: _ = !1, onShowEarlier: v, showEarlierDisabled: y = !1 }) => {
+	let b = t(), x = s(null);
+	return e(x, { fallbackSelector: `[${n}]` }), o(() => {
+		if (!_) return;
 		let e = (e) => {
 			if (e.key !== "Escape" || document.querySelector("[role=\"alertdialog\"]")) return;
-			let r = b.current?.closest(`[${t}]`), i = document.activeElement;
-			n(r ?? null, i) && (e.preventDefault(), e.stopPropagation(), p());
+			let t = x.current?.closest(`[${n}]`), i = document.activeElement;
+			r(t ?? null, i) && (e.preventDefault(), e.stopPropagation(), m());
 		};
 		return document.addEventListener("keydown", e, !0), () => document.removeEventListener("keydown", e, !0);
-	}, [g, p]), /* @__PURE__ */ d("div", {
-		ref: b,
+	}, [_, m]), /* @__PURE__ */ f("div", {
+		ref: x,
 		className: "absolute inset-0 z-30 flex flex-col bg-bg-sunken/95 backdrop-blur-sm",
 		role: "dialog",
-		"aria-label": y("voiceSession.transcriptTitle", "Voice transcript"),
+		"aria-label": b("voiceSession.transcriptTitle", "Voice transcript"),
 		"data-testid": "assistant-voice-transcript",
 		children: [
-			/* @__PURE__ */ d("div", {
+			/* @__PURE__ */ f("div", {
 				className: "flex items-center justify-between border-b border-border-subtle px-4 py-3",
-				children: [/* @__PURE__ */ d("div", {
+				children: [/* @__PURE__ */ f("div", {
 					className: "min-w-0",
-					children: [/* @__PURE__ */ u("h2", {
+					children: [/* @__PURE__ */ d("h2", {
 						className: "text-sm font-semibold text-text-primary",
-						children: y("voiceSession.transcript", "Voice conversation")
-					}), /* @__PURE__ */ u("p", {
+						children: b("voiceSession.transcript", "Voice conversation")
+					}), /* @__PURE__ */ d("p", {
 						className: "truncate text-xs text-text-muted",
-						children: y("voiceSession.transcriptHint", "Spoken turns in this conversation — kept out of your typed chat.")
+						children: b("voiceSession.transcriptHint", "Spoken turns in this conversation — kept out of your typed chat.")
 					})]
-				}), /* @__PURE__ */ u("button", {
+				}), /* @__PURE__ */ d("button", {
 					type: "button",
-					onClick: p,
+					onClick: m,
 					className: "flex size-8 items-center justify-center rounded-full text-text-secondary transition-colors hover:bg-bg-raised hover:text-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong",
-					"aria-label": y("voiceSession.transcriptClose", "Close the transcript"),
+					"aria-label": b("voiceSession.transcriptClose", "Close the transcript"),
 					"data-testid": "assistant-voice-transcript-close",
-					children: /* @__PURE__ */ u(l, { className: "size-4" })
+					children: /* @__PURE__ */ d(u, { className: "size-4" })
 				})]
 			}),
-			_ ? /* @__PURE__ */ u(i, {
-				onShowEarlier: _,
-				disabled: v
+			v ? /* @__PURE__ */ d(a, {
+				onShowEarlier: v,
+				disabled: y
 			}) : null,
-			/* @__PURE__ */ u(r, { turns: f }),
-			(m || h) && f.length > 0 ? /* @__PURE__ */ d("div", {
+			/* @__PURE__ */ d(i, { turns: p }),
+			(h || g) && p.length > 0 ? /* @__PURE__ */ f("div", {
 				className: "flex items-center justify-end gap-2 border-t border-border-subtle px-4 py-3",
-				children: [m ? /* @__PURE__ */ d("button", {
+				children: [h ? /* @__PURE__ */ f("button", {
 					type: "button",
-					onClick: m,
+					onClick: h,
 					className: "flex items-center gap-1.5 rounded-lg border border-border-default px-3 py-1.5 text-xs text-text-secondary transition-colors hover:bg-bg-elevated hover:text-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong",
 					"data-testid": "assistant-voice-save-transcript",
-					children: [/* @__PURE__ */ u(c, {
+					children: [/* @__PURE__ */ d(l, {
 						className: "size-3.5",
 						"aria-hidden": "true"
-					}), y("voiceSession.save", "Save transcript")]
-				}) : null, h ? /* @__PURE__ */ d("button", {
+					}), b("voiceSession.save", "Save transcript")]
+				}) : null, g ? /* @__PURE__ */ f("button", {
 					type: "button",
-					onClick: h,
+					onClick: g,
 					className: "flex items-center gap-1.5 rounded-lg bg-action-primary-bg px-3 py-1.5 text-xs font-medium text-action-primary-fg transition-opacity hover:opacity-90 focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong",
 					"data-testid": "assistant-voice-continue-in-chat",
-					children: [y("voiceSession.continueInChat", "Continue in chat"), /* @__PURE__ */ u(s, {
+					children: [b("voiceSession.continueInChat", "Continue in chat"), /* @__PURE__ */ d(c, {
 						className: "size-3.5",
 						"aria-hidden": "true"
 					})]
@@ -74,4 +75,4 @@ var f = ({ turns: f, onClose: p, onSave: m, onContinueInChat: h, closeOnEscape:
 	});
 };
 //#endregion
-export { f as VoiceTranscriptDrawer };
+export { p as VoiceTranscriptDrawer };

package/dist/shared/assistant/ui/voice/voiceSessionEscape.d.ts

@@ -0,0 +1,57 @@
+/**
+ * A layer an Escape can be pressed INSIDE of: a dialog by role (the Radix
+ * `Dialog` and `AlertDialog` contents carry it), an open native `<dialog>`, or
+ * anything declared modal.
+ */
+export declare const VOICE_ESCAPE_LAYER_SELECTOR = "[role=\"dialog\"],[role=\"alertdialog\"],dialog[open],[aria-modal=\"true\"]";
+/**
+ * A layer that outranks the voice session wherever focus is.
+ *
+ * `[role="alertdialog"]` matches the guard the post-session transcript drawer
+ * already applies. There is no `dialog[open]` here: a native modal dialog makes
+ * everything behind it inert, so focus, and with it the key press, is always
+ * inside it, and the layer check already sees that. A NON-modal open
+ * `<dialog>` is not a modal, and must not block Escape across the whole page.
+ */
+export declare const VOICE_ESCAPE_MODAL_SELECTOR = "[aria-modal=\"true\"],[role=\"alertdialog\"]";
+export type VoiceSessionEscapeAction = "ignore" | "close-transcript" | "end";
+/**
+ * What the voice session does with an Escape.
+ *
+ * Two things outrank it, in this order:
+ *
+ *  - an earlier handler already took the key (`defaultPrevented`). Radix's
+ *    `DismissableLayer` dismisses in the CAPTURE phase on `document` and calls
+ *    `preventDefault()` when it does, so by the time the key reaches this
+ *    listener the dialog it closed can already be out of the DOM, with focus
+ *    back on `<body>` (measured in VibeControls prod on 2026-09-23: in the
+ *    bubble phase the dialog was gone and `activeElement` was BODY). This flag
+ *    is often the only trace left of it;
+ *  - a layer above the session: see `escapeBelongsToLayerAbove`.
+ *
+ * Otherwise nothing changes from before: the session's own transcript drawer
+ * closes first, and only then does Escape end the conversation.
+ */
+export declare function voiceSessionEscapeAction(input: {
+    defaultPrevented: boolean;
+    layerAbove: boolean;
+    transcriptOpen: boolean;
+}): VoiceSessionEscapeAction;
+/**
+ * Does this Escape belong to a dialog or modal above the voice session?
+ *
+ * Yes when:
+ *  - the key was pressed inside one: the event TARGET's nearest layer is
+ *    above the session. The target keeps its ancestors even after the dialog
+ *    has been removed, so this still holds in the bubble phase;
+ *  - focus is inside one: the same test on `activeElement`;
+ *  - a modal is open anywhere that is not the session's own.
+ *
+ * With none of those, the key is the session's, exactly as before.
+ */
+export declare function escapeBelongsToLayerAbove(input: {
+    target: EventTarget | null;
+    session: Element | null;
+    doc: Pick<Document, "activeElement" | "querySelectorAll">;
+}): boolean;
+//# sourceMappingURL=voiceSessionEscape.d.ts.map

package/dist/shared/assistant/ui/voice/voiceSessionEscape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voiceSessionEscape.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/ui/voice/voiceSessionEscape.ts"],"names":[],"mappings":"AA2BA;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,gFAAqD,CAAC;AAE9F;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,iDACI,CAAC;AAE7C,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,kBAAkB,GAAG,KAAK,CAAC;AAE7E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB,GAAG,wBAAwB,CAI3B;AAmCD;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,kBAAkB,CAAC,CAAC;CAC3D,GAAG,OAAO,CAOV"}

package/dist/shared/assistant/ui/voice/voiceSessionEscape.js

@@ -0,0 +1,19 @@
+import { focusIsInsidePanel as e } from "../panelOverlays.js";
+import { ASSISTANT_DIALOG_SELECTOR as t, closestAround as n } from "../assistantOverlayState.js";
+//#region src/shared/assistant/ui/voice/voiceSessionEscape.ts
+var r = `${t},[aria-modal="true"]`, i = "[aria-modal=\"true\"],[role=\"alertdialog\"]";
+function a(e) {
+	return e.defaultPrevented || e.layerAbove ? "ignore" : e.transcriptOpen ? "close-transcript" : "end";
+}
+function o(e) {
+	return n(e, r);
+}
+function s(t, n) {
+	return !(!t || e(n, t) || n && t.contains(n));
+}
+function c(e) {
+	let { target: t, session: n, doc: r } = e;
+	return s(o(t), n) || s(o(r.activeElement), n) ? !0 : Array.from(r.querySelectorAll(i)).some((e) => s(e, n));
+}
+//#endregion
+export { r as VOICE_ESCAPE_LAYER_SELECTOR, i as VOICE_ESCAPE_MODAL_SELECTOR, c as escapeBelongsToLayerAbove, a as voiceSessionEscapeAction };

package/dist/shared/assistant/useAssistantKeyboardShortcuts.d.ts

@@ -14,7 +14,9 @@ interface Options {
  * anyway and were just adding visible "shortcut listed, doesn't work"
  * inconsistencies. The shortcuts here match the in-app shortcuts modal.
  *
- * - Escape: Close panel
+ * - Escape: back out of the topmost layer — a full-surface overlay (history,
+ *   preview), else nothing here while a live voice session owns the key (it
+ *   closes its transcript, then ends), else close the panel
  * - Ctrl/Cmd+Shift+N: New conversation
  * - Ctrl/Cmd+Shift+E: Export (triggers click on export button)
  * - /: Focus input (only when no input/textarea is already focused)

package/dist/shared/assistant/useAssistantKeyboardShortcuts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAssistantKeyboardShortcuts.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/useAssistantKeyboardShortcuts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIlD,UAAU,OAAO;IACf,QAAQ,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,SAAS,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACjD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,QA+ErF"}
+{"version":3,"file":"useAssistantKeyboardShortcuts.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/useAssistantKeyboardShortcuts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIlD,UAAU,OAAO;IACf,QAAQ,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,SAAS,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACjD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,QAyFrF"}

package/dist/shared/assistant/useAssistantKeyboardShortcuts.js

@@ -1,41 +1,41 @@
 import { useAssistantStore as e } from "./store.js";
-import { focusIsInsidePanel as t, panelOwnsEscape as n } from "./ui/panelOverlays.js";
-import { useEffect as r } from "react";
+import { focusIsInsidePanel as t, panelOwnsEscape as n, voiceSessionOwnsEscape as r } from "./ui/panelOverlays.js";
+import { useEffect as i } from "react";
 //#region src/shared/assistant/useAssistantKeyboardShortcuts.ts
-function i({ panelRef: i, inputRef: a, onClose: o }) {
-	r(() => {
-		let r = (r) => {
-			let s = i.current;
-			if (!s) return;
-			let c = document.activeElement;
-			if (r.key === "Escape") {
-				if (!n(s, c, document.body)) return;
-				r.preventDefault(), o();
+function a({ panelRef: a, inputRef: o, onClose: s }) {
+	i(() => {
+		let i = (i) => {
+			let c = a.current;
+			if (!c) return;
+			let l = document.activeElement;
+			if (i.key === "Escape") {
+				if (i.defaultPrevented || !n(c, l, document.body) || r(c)) return;
+				i.preventDefault(), s();
 				return;
 			}
-			if (!t(s, c)) return;
-			let l = r.ctrlKey || r.metaKey;
-			if (l && r.shiftKey && (r.key === "N" || r.key === "n")) {
-				r.preventDefault(), e.getState().createConversation();
+			if (!t(c, l)) return;
+			let u = i.ctrlKey || i.metaKey;
+			if (u && i.shiftKey && (i.key === "N" || i.key === "n")) {
+				i.preventDefault(), e.getState().createConversation();
 				return;
 			}
-			if (l && r.shiftKey && (r.key === "E" || r.key === "e")) {
-				r.preventDefault();
-				let e = s.querySelector("[data-testid=\"assistant-more\"]");
+			if (u && i.shiftKey && (i.key === "E" || i.key === "e")) {
+				i.preventDefault();
+				let e = c.querySelector("[data-testid=\"assistant-more\"]");
 				e?.focus(), e?.click();
 				return;
 			}
-			if (r.key === "/" && !l && !r.shiftKey) {
-				let e = c?.tagName;
-				e !== "INPUT" && e !== "TEXTAREA" && (r.preventDefault(), a?.current?.focus());
+			if (i.key === "/" && !u && !i.shiftKey) {
+				let e = l?.tagName;
+				e !== "INPUT" && e !== "TEXTAREA" && (i.preventDefault(), o?.current?.focus());
 			}
 		};
-		return document.addEventListener("keydown", r), () => document.removeEventListener("keydown", r);
+		return document.addEventListener("keydown", i), () => document.removeEventListener("keydown", i);
 	}, [
-		i,
 		a,
-		o
+		o,
+		s
 	]);
 }
 //#endregion
-export { i as useAssistantKeyboardShortcuts };
+export { a as useAssistantKeyboardShortcuts };

package/dist/shared/hooks/index.d.ts

@@ -16,6 +16,7 @@ export { useOnClickOutside, useOnClickOutsideWithRef } from './useOnClickOutside
 export { useKeyPress, useKeyboardShortcut } from './useKeyPress';
 export { useCopyToClipboard } from './useCopyToClipboard';
 export { useExclusiveMenu } from './useExclusiveMenu';
+export { useReturnFocus, type UseReturnFocusOptions } from './useReturnFocus';
 export { useLocalStorage } from './useLocalStorage';
 export { useSessionStorage } from './useSessionStorage';
 export { usePrevious, usePreviousDistinct, usePreviousHistory } from './usePrevious';

package/dist/shared/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAc,MAAM,OAAO,CAAC;AACnC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,oBAAoB,8CAA2D,CAAC;AAE7F;;GAEG;AACH,wBAAgB,uBAAuB,2BAMtC;AAOD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAG9E,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC;AAG1B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,kBAAkB,EAClB,6BAA6B,EAC7B,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAGjG,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAc,MAAM,OAAO,CAAC;AACnC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,oBAAoB,8CAA2D,CAAC;AAE7F;;GAEG;AACH,wBAAgB,uBAAuB,2BAMtC;AAOD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAG9E,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC;AAG1B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,kBAAkB,EAClB,6BAA6B,EAC7B,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAGjG,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,iCAAiC,CAAC"}