@burdenoff/fe-libs 2026.1029.7 → 2026.1029.9

package/dist/shared/assistant/ui/compact/AssistantMenuView.d.ts

@@ -0,0 +1,42 @@
+import { FC } from 'react';
+export interface AssistantMenuViewProps {
+    /** The element id `aria-controls` on ☰ points at. */
+    id: string;
+    /** Back to the conversation (Back, or Escape from the list). */
+    onClose: () => void;
+    /** The × of the view: closes the assistant, through the panel's close request (N1). */
+    onRequestClosePanel: () => void;
+    /** New conversation: the panel creates it, closes this view and focuses the message box. */
+    onNewConversation: () => void;
+    /** Absent: the live-avatar tab is not offered here, and the Avatar row is not shown. */
+    onOpenAvatar?: () => void;
+    docked?: boolean;
+    /** Absent: the product shows no dock control, and Panel layout is not shown. */
+    onToggleDock?: () => void;
+}
+/**
+ * The ☰ view (BOFF-10177, F2): what the compact header's ☰ opens, over the
+ * panel, in place of the classic header's New and History buttons and the ⋯
+ * menu's settings.
+ *
+ *  - Back to conversation, and × (which closes the assistant);
+ *  - New conversation (Ctrl/Cmd+Shift+N);
+ *  - Recent: the newest conversations, and View all history, which opens the
+ *    EXISTING history list (search, All/Chat/Voice, Pinned, Archived, groups,
+ *    row actions, delete confirmation) as a sub-view;
+ *  - Settings: Voice & language (a sub-view holding the six controls), Avatar
+ *    (a row that opens the Avatar tab; nothing of the avatar is duplicated
+ *    here) and Panel layout (Dock/Float, D13: its only home).
+ *
+ * ★ Every screen has an `h2` and a Back; focus lands on Back on open, on the
+ * sub-view's Back on entering one, and on the row that opened it on the way
+ * back. Escape closes ONE layer: a sub-view returns to this list, and this list
+ * returns to the conversation (`menuViewEscape`). The view is ONE `EscapeLayer`
+ * that decides, so it can neither double-close nor skip a screen, and a menu or
+ * dialog opened over it (mounted later) takes the key first.
+ *
+ * ★ The conversation under it stays mounted and `inert` (the panel sets that,
+ * as for the History drawer), so the draft, a running reply and a waiting
+ * change are exactly as they were.
+ */
+export declare const AssistantMenuView: FC<AssistantMenuViewProps>;

package/dist/shared/assistant/ui/compact/AssistantMenuView.js

@@ -0,0 +1,285 @@
+import { useI18n as e } from "../../../providers/shell/I18nProvider.js";
+import { EscapeLayer as t } from "../../../components/EscapeLayer.js";
+import { useAssistantProduct as n } from "../../product.js";
+import { useAssistantTr as r } from "../../i18n.js";
+import { useAssistantStore as i } from "../../store.js";
+import { resolveLanguagePair as a } from "../../voice/languagePair.js";
+import { useOverlayFocus as o } from "../useOverlayFocus.js";
+import { assistantModeOptionName as s } from "../composer/AssistantModeMenu.js";
+import { useAssistantHistoryStatus as c } from "../../history/historyStatus.js";
+import { assistantHistory as l } from "../../history/historyEngine.js";
+import { AssistantConversationList as u } from "../AssistantConversationList.js";
+import { fieldOwnsEscape as ee, menuViewEscape as te, recentConversations as ne } from "./compactChrome.js";
+import { AssistantVoiceLanguageSettings as re } from "./AssistantVoiceLanguageSettings.js";
+import { useEffect as d, useLayoutEffect as f, useMemo as p, useRef as m, useState as h } from "react";
+import { ArrowLeft as g, ChevronRight as _, History as ie, Languages as ae, PanelRight as oe, Plus as se, UserRound as v, X as y } from "lucide-react";
+import { Fragment as b, jsx as x, jsxs as S } from "react/jsx-runtime";
+//#region src/shared/assistant/ui/compact/AssistantMenuView.tsx
+var C = "focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-focus-ring)]", w = `flex size-10 shrink-0 items-center justify-center rounded-button text-text-secondary transition-colors hover:bg-bg-sunken hover:text-text-primary ${C}`, T = `flex min-h-11 w-full items-center gap-3 px-4 py-2 text-left text-sm text-text-primary transition-colors hover:bg-bg-sunken ${C} focus-visible:ring-inset`, ce = typeof document > "u" ? d : f, E = ({ icon: e, label: t, trailing: n, onClick: r, buttonRef: i, testId: a, describedBy: o }) => /* @__PURE__ */ S("button", {
+	ref: i,
+	type: "button",
+	onClick: r,
+	className: T,
+	"aria-describedby": o,
+	"data-testid": a,
+	children: [
+		/* @__PURE__ */ x("span", {
+			className: "flex size-5 shrink-0 items-center justify-center text-text-secondary",
+			children: e
+		}),
+		/* @__PURE__ */ x("span", {
+			className: "min-w-0 flex-1 truncate",
+			children: t
+		}),
+		n
+	]
+}), D = ({ id: e, children: t }) => /* @__PURE__ */ x("h3", {
+	id: e,
+	className: "px-4 pb-1 pt-4 text-xs font-semibold uppercase tracking-wide text-text-muted",
+	children: t
+}), le = ({ title: e, tr: t, onBack: n, backRef: r }) => /* @__PURE__ */ S("div", {
+	className: "flex items-center gap-1 border-b border-border-default bg-bg-elevated px-2 py-2",
+	children: [/* @__PURE__ */ x("button", {
+		ref: r,
+		type: "button",
+		onClick: n,
+		className: w,
+		"aria-label": t("menuView.back", "Back"),
+		"data-testid": "assistant-menu-subview-back",
+		children: /* @__PURE__ */ x(g, {
+			className: "size-5",
+			"aria-hidden": "true"
+		})
+	}), /* @__PURE__ */ x("h2", {
+		className: "min-w-0 flex-1 truncate text-base font-semibold text-text-primary",
+		children: e
+	})]
+}), O = ({ id: d, onClose: f, onRequestClosePanel: O, onNewConversation: ue, onOpenAvatar: k, docked: A, onToggleDock: j }) => {
+	let M = r(), { locale: N } = e(), { modes: P } = n(), { conversations: F, activeConversationId: I, assistantLanguage: L, replyLanguage: R, setActiveConversation: z, setMode: B } = i(), V = c((e) => e.product !== null), [H, U] = h("root"), de = o("assistant-menu"), W = m(null), G = m(null), K = m(null), q = m(null), J = m("back"), Y = (e) => {
+		J.current = e, U(e);
+	}, X = () => U("root");
+	ce(() => {
+		if (H !== "history") {
+			if (H === "voice-language") {
+				G.current?.focus({ preventScroll: !0 });
+				return;
+			}
+			((J.current === "voice-language" ? K.current : J.current === "history" ? q.current : null) ?? W.current)?.focus({ preventScroll: !0 }), J.current = "back";
+		}
+	}, [H]);
+	let Z = p(() => ne(F), [F]), fe = M("history.untitled", "Untitled conversation"), pe = (e) => {
+		if (V) l.openConversation(e, { modes: P });
+		else {
+			let t = F.find((t) => t.id === e);
+			z(e), t && B(t.mode);
+		}
+		f();
+	}, me = a(L, R, N).input.label, Q = `${d}-settings`, $ = `${d}-recent`;
+	return /* @__PURE__ */ x(t, {
+		onDismiss: () => {
+			H === "history" && ee(document.activeElement) || (te(H) === "back" ? X() : f());
+		},
+		children: /* @__PURE__ */ x("div", {
+			ref: de,
+			id: d,
+			tabIndex: -1,
+			role: "region",
+			"aria-label": M("menuView.title", "Assistant menu"),
+			className: "absolute inset-0 z-10 flex flex-col bg-bg-surface outline-none animate-in slide-in-from-left-2 fade-in duration-200 motion-reduce:animate-none",
+			"data-testid": "assistant-menu-view",
+			"data-menu-view": H,
+			children: H === "root" ? /* @__PURE__ */ S(b, { children: [/* @__PURE__ */ S("div", {
+				className: "flex items-center gap-1 border-b border-border-default bg-bg-elevated px-2 py-2",
+				children: [
+					/* @__PURE__ */ S("button", {
+						ref: W,
+						type: "button",
+						onClick: f,
+						className: `flex min-h-10 items-center gap-1.5 rounded-button px-2 text-sm font-medium text-text-primary transition-colors hover:bg-bg-sunken ${C}`,
+						"data-testid": "assistant-menu-back",
+						children: [/* @__PURE__ */ x(g, {
+							className: "size-5",
+							"aria-hidden": "true"
+						}), M("menuView.backToConversation", "Back to conversation")]
+					}),
+					/* @__PURE__ */ x("h2", {
+						className: "sr-only",
+						children: M("menuView.title", "Assistant menu")
+					}),
+					/* @__PURE__ */ x("span", { className: "flex-1" }),
+					/* @__PURE__ */ x("button", {
+						type: "button",
+						onClick: O,
+						className: w,
+						"aria-label": M("header.close", "Close assistant"),
+						"data-testid": "assistant-menu-close",
+						children: /* @__PURE__ */ x(y, {
+							className: "size-5",
+							"aria-hidden": "true"
+						})
+					})
+				]
+			}), /* @__PURE__ */ S("div", {
+				className: "scrollbar-slim min-h-0 flex-1 overflow-y-auto pb-2",
+				children: [
+					/* @__PURE__ */ S("button", {
+						type: "button",
+						onClick: ue,
+						className: `${T} mt-2`,
+						"aria-keyshortcuts": "Control+Shift+N Meta+Shift+N",
+						"data-testid": "assistant-new-conversation",
+						children: [
+							/* @__PURE__ */ x("span", {
+								className: "flex size-5 shrink-0 items-center justify-center text-text-secondary",
+								children: /* @__PURE__ */ x(se, {
+									className: "size-5",
+									"aria-hidden": "true"
+								})
+							}),
+							/* @__PURE__ */ x("span", {
+								className: "min-w-0 flex-1 truncate",
+								children: M("header.newConversation", "New conversation")
+							}),
+							/* @__PURE__ */ x("kbd", {
+								className: "shrink-0 text-xs text-text-muted",
+								children: "Ctrl+Shift+N"
+							})
+						]
+					}),
+					/* @__PURE__ */ S("section", {
+						"aria-labelledby": $,
+						"data-testid": "assistant-menu-recent",
+						children: [
+							/* @__PURE__ */ x(D, {
+								id: $,
+								children: M("menuView.recent", "Recent")
+							}),
+							Z.length === 0 ? /* @__PURE__ */ x("p", {
+								className: "px-4 py-2 text-sm text-text-muted",
+								children: M("conversations.empty", "No conversations yet")
+							}) : /* @__PURE__ */ x("ul", { children: Z.map((e) => {
+								let t = P.find((t) => t.id === e.mode);
+								return /* @__PURE__ */ x("li", { children: /* @__PURE__ */ x("button", {
+									type: "button",
+									onClick: () => pe(e.id),
+									className: `${T} ${e.id === I ? "bg-bg-elevated" : ""}`,
+									"aria-current": e.id === I ? "true" : void 0,
+									"data-testid": "assistant-menu-recent-row",
+									children: /* @__PURE__ */ S("span", {
+										className: "min-w-0 flex-1",
+										children: [/* @__PURE__ */ x("span", {
+											className: "block truncate",
+											children: e.title || fe
+										}), t ? /* @__PURE__ */ x("span", {
+											className: "block truncate text-xs text-text-muted",
+											children: s(M, t)
+										}) : null]
+									})
+								}) }, e.id);
+							}) }),
+							/* @__PURE__ */ x(E, {
+								buttonRef: q,
+								icon: /* @__PURE__ */ x(ie, {
+									className: "size-5",
+									"aria-hidden": "true"
+								}),
+								label: M("menuView.viewAllHistory", "View all history"),
+								trailing: /* @__PURE__ */ x(_, {
+									className: "size-4 text-text-muted",
+									"aria-hidden": "true"
+								}),
+								onClick: () => Y("history"),
+								testId: "assistant-open-history"
+							})
+						]
+					}),
+					/* @__PURE__ */ S("section", {
+						"aria-labelledby": Q,
+						"data-testid": "assistant-menu-settings",
+						children: [
+							/* @__PURE__ */ x(D, {
+								id: Q,
+								children: M("menuView.settings", "Settings")
+							}),
+							/* @__PURE__ */ x(E, {
+								buttonRef: K,
+								icon: /* @__PURE__ */ x(ae, {
+									className: "size-5",
+									"aria-hidden": "true"
+								}),
+								label: M("menuView.voiceLanguage", "Voice & language"),
+								trailing: /* @__PURE__ */ S(b, { children: [/* @__PURE__ */ x("span", {
+									className: "max-w-[40%] truncate text-xs text-text-muted",
+									children: me
+								}), /* @__PURE__ */ x(_, {
+									className: "size-4 shrink-0 text-text-muted",
+									"aria-hidden": "true"
+								})] }),
+								onClick: () => Y("voice-language"),
+								testId: "assistant-menu-voice-language-row"
+							}),
+							k ? /* @__PURE__ */ x(E, {
+								icon: /* @__PURE__ */ x(v, {
+									className: "size-5",
+									"aria-hidden": "true"
+								}),
+								label: M("menuView.avatar", "Avatar"),
+								trailing: /* @__PURE__ */ x(_, {
+									className: "size-4 text-text-muted",
+									"aria-hidden": "true"
+								}),
+								onClick: k,
+								testId: "assistant-menu-avatar-row"
+							}) : null,
+							j ? /* @__PURE__ */ S("fieldset", {
+								className: "hidden min-w-0 border-0 px-4 py-2 sm:block",
+								"data-testid": "assistant-menu-panel-layout",
+								children: [/* @__PURE__ */ S("legend", {
+									className: "flex items-center gap-3 py-1 text-sm text-text-primary",
+									children: [/* @__PURE__ */ x(oe, {
+										className: "size-5 shrink-0 text-text-secondary",
+										"aria-hidden": "true"
+									}), M("menuView.panelLayout", "Panel layout")]
+								}), [[
+									!0,
+									M("menuView.layoutDocked", "Docked side panel"),
+									"docked"
+								], [
+									!1,
+									M("menuView.layoutFloating", "Floating window"),
+									"floating"
+								]].map(([e, t, n]) => /* @__PURE__ */ S("label", {
+									className: "flex min-h-11 cursor-pointer items-center gap-3 pl-8 text-sm text-text-primary focus-within:ring-2 focus-within:ring-[var(--color-focus-ring)]",
+									children: [/* @__PURE__ */ x("input", {
+										type: "radio",
+										name: `${d}-layout`,
+										checked: !!A === e,
+										onChange: () => {
+											!!A !== e && j();
+										},
+										className: "size-4 accent-current",
+										"data-testid": `assistant-panel-layout-${n}`
+									}), t]
+								}, n))]
+							}) : null
+						]
+					})
+				]
+			})] }) : H === "voice-language" ? /* @__PURE__ */ S(b, { children: [/* @__PURE__ */ x(le, {
+				title: M("menuView.voiceLanguage", "Voice & language"),
+				tr: M,
+				onBack: X,
+				backRef: G
+			}), /* @__PURE__ */ x("div", {
+				className: "scrollbar-slim min-h-0 flex-1 overflow-y-auto",
+				children: /* @__PURE__ */ x(re, {})
+			})] }) : /* @__PURE__ */ x(u, {
+				presentation: "compact",
+				onBack: X,
+				onDone: f
+			})
+		})
+	});
+};
+//#endregion
+export { O as AssistantMenuView };

package/dist/shared/assistant/ui/compact/AssistantVoiceLanguageSettings.d.ts

@@ -0,0 +1,24 @@
+import { FC } from 'react';
+/**
+ * ☰ → Settings → Voice & language: the six controls the classic ⋯ menu held
+ * (BOFF-10177, DESIGN-DELTA A4), the SAME components under the SAME render
+ * conditions, so a value read or written here is the one the ⋯ menu would have
+ * read or written: nothing is stored anew.
+ *
+ *   1  Language you speak          `AssistantLanguageMenu`
+ *   2  Assistant replies in        `AssistantLanguageMenu`
+ *   3  Read replies aloud          below; needs speech output
+ *   4  Voice + Preview             voice picker needs 2 or more voices; Preview a resolved voice
+ *   5  Wait after I stop talking   needs speech recognition
+ *   6  Hands-free interrupt (beta) needs speech recognition or microphone capture
+ *
+ * ★ Read replies aloud is a real checkbox in its label, like the hands-free
+ * toggle beside it: the visible words are its name (WCAG 2.5.3). Blocked and
+ * off, it is `aria-disabled` (not `disabled`) and says why on screen, so a
+ * keyboard or screen-reader user finds it and hears the reason, as the classic
+ * row's tooltip told a mouse. Turning it OFF also silences what is speaking.
+ *
+ * ★ None of these touches the interface language: they set the assistant's
+ * own language and voice.
+ */
+export declare const AssistantVoiceLanguageSettings: FC;

package/dist/shared/assistant/ui/compact/AssistantVoiceLanguageSettings.js

@@ -0,0 +1,68 @@
+import { useAssistantTr as e } from "../../i18n.js";
+import { useAssistantSpeech as t } from "../AssistantSpeechProvider.js";
+import { AssistantLanguageMenu as n } from "../AssistantLanguageMenu.js";
+import { AssistantVoiceSelector as r } from "../composer/AssistantVoiceSelector.js";
+import { AssistantVoiceGraceSelector as i } from "../composer/AssistantVoiceGraceSelector.js";
+import { AssistantHandsFreeInterruptToggle as a } from "../composer/AssistantHandsFreeInterruptToggle.js";
+import { useId as o } from "react";
+import { Play as s, Volume2 as c } from "lucide-react";
+import { Fragment as l, jsx as u, jsxs as d } from "react/jsx-runtime";
+//#region src/shared/assistant/ui/compact/AssistantVoiceLanguageSettings.tsx
+var f = () => {
+	let f = e(), p = o(), { isSupported: m, isBlocked: h, disabledReason: g, autoSpeakEnabled: _, setAutoSpeak: v, stop: y, previewVoice: b, activeVoiceName: x } = t(), S = h && !_;
+	return /* @__PURE__ */ d("div", {
+		className: "py-1 [&_label]:min-h-11 [&_label]:text-sm",
+		"data-testid": "assistant-menu-voice-language",
+		children: [
+			m ? /* @__PURE__ */ d(l, { children: [/* @__PURE__ */ d("label", {
+				className: "flex items-center gap-2.5 px-4 py-2 text-text-primary focus-within:ring-2 focus-within:ring-inset focus-within:ring-[var(--color-focus-ring)]",
+				"data-testid": "assistant-auto-speak",
+				children: [
+					/* @__PURE__ */ u(c, {
+						className: "size-4 flex-shrink-0 text-text-secondary",
+						"aria-hidden": "true"
+					}),
+					/* @__PURE__ */ u("span", {
+						className: "flex-1",
+						children: f("menuView.readAloud", "Read replies aloud")
+					}),
+					/* @__PURE__ */ u("input", {
+						type: "checkbox",
+						checked: _,
+						"aria-disabled": S ? "true" : void 0,
+						"aria-describedby": S && g ? p : void 0,
+						onChange: () => {
+							S || (_ && y(), v(!_));
+						},
+						className: "size-4 accent-current aria-disabled:cursor-default aria-disabled:opacity-60",
+						"data-testid": "assistant-auto-speak-checkbox"
+					})
+				]
+			}), S && g ? /* @__PURE__ */ u("p", {
+				id: p,
+				className: "px-4 pb-2 text-xs text-text-muted",
+				children: g
+			}) : null] }) : null,
+			/* @__PURE__ */ u(n, {}),
+			/* @__PURE__ */ d("div", {
+				className: "flex items-center gap-1 px-3 py-1.5",
+				"data-testid": "assistant-menu-voice",
+				children: [/* @__PURE__ */ u(r, {}), x ? /* @__PURE__ */ d("button", {
+					type: "button",
+					onClick: () => b(x),
+					className: "flex min-h-9 items-center gap-1 rounded-md px-2 text-xs text-text-muted transition-colors hover:bg-bg-elevated hover:text-text-secondary focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-focus-ring)]",
+					"aria-label": f("voice.preview", "Hear this voice"),
+					"data-testid": "assistant-voice-preview",
+					children: [/* @__PURE__ */ u(s, {
+						className: "size-3",
+						"aria-hidden": "true"
+					}), f("voice.previewShort", "Preview")]
+				}) : null]
+			}),
+			/* @__PURE__ */ u(i, {}),
+			/* @__PURE__ */ u(a, {})
+		]
+	});
+};
+//#endregion
+export { f as AssistantVoiceLanguageSettings };

package/dist/shared/assistant/ui/compact/AssistantWaitingChangeRow.d.ts

@@ -0,0 +1,21 @@
+import { FC } from 'react';
+export interface AssistantWaitingChangeRowProps {
+    /** How many changes wait for the person's approval in the open conversation. */
+    count: number;
+    /** Scroll to the first waiting change's card and focus it. */
+    onReview: () => void;
+}
+/**
+ * The pinned "change waiting" row above the composer (N6, 2026-10-29), in the
+ * compact presentation only.
+ *
+ * ★ A pointer to the EXISTING approval card, never a second way to approve: it
+ * has no Approve and no Decline, only Review, which scrolls to the card and
+ * focuses it. The card stays the one place a change is confirmed, by a button
+ * press (`writeProposals.ts`: voice and typed "yes" never approve).
+ *
+ * The cards sit inside the message list, so a person who scrolled up never saw
+ * a new one arrive; this row is always on screen while any change waits. Its
+ * text is a polite status, so the arrival is announced without taking focus.
+ */
+export declare const AssistantWaitingChangeRow: FC<AssistantWaitingChangeRowProps>;

package/dist/shared/assistant/ui/compact/AssistantWaitingChangeRow.js

@@ -0,0 +1,34 @@
+import { useAssistantTr as e } from "../../i18n.js";
+import { ShieldAlert as t } from "lucide-react";
+import { jsx as n, jsxs as r } from "react/jsx-runtime";
+//#region src/shared/assistant/ui/compact/AssistantWaitingChangeRow.tsx
+var i = ({ count: i, onReview: a }) => {
+	let o = e();
+	return /* @__PURE__ */ r("div", {
+		className: "mb-2 flex min-h-11 items-center gap-2 rounded-xl border border-status-warning bg-status-warning/10 px-3 py-1",
+		"data-testid": "assistant-waiting-change",
+		children: [
+			/* @__PURE__ */ n(t, {
+				className: "size-4 shrink-0 text-status-warning",
+				"aria-hidden": "true"
+			}),
+			/* @__PURE__ */ n("p", {
+				role: "status",
+				"aria-live": "polite",
+				className: "min-w-0 flex-1 text-sm text-text-primary",
+				"data-testid": "assistant-waiting-change-status",
+				children: o("waitingChange.status", "{{count}} change(s) waiting for your approval", { count: i })
+			}),
+			/* @__PURE__ */ n("button", {
+				type: "button",
+				onClick: a,
+				className: "min-h-9 shrink-0 rounded-button px-3 text-sm font-medium text-action-primary-bg transition-colors hover:bg-bg-sunken focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-focus-ring)]",
+				"aria-label": o("waitingChange.reviewLabel", "Review the change waiting for your approval"),
+				"data-testid": "assistant-waiting-change-review",
+				children: o("waitingChange.review", "Review")
+			})
+		]
+	});
+};
+//#endregion
+export { i as AssistantWaitingChangeRow };

package/dist/shared/assistant/ui/compact/compactChrome.d.ts

@@ -0,0 +1,75 @@
+import { Conversation } from '../../conversation';
+/**
+ * Expand/Restore is offered only from this viewport width up (N2, 2026-10-29).
+ *
+ * At 1536 px the page keeps at least 520 px beside the default sidebar once the
+ * assistant is 760 px wide (DESIGN-DELTA A2); at 1440 it would keep 424 px, so
+ * the control is not offered there. A viewport that is exactly this wide IS
+ * offered it: the rule is "at least".
+ */
+export declare const COMPACT_EXPAND_MIN_VIEWPORT_PX = 1536;
+/** Is Expand/Restore offered at this viewport width? */
+export declare function compactExpandOffered(viewportWidthPx: number): boolean;
+/**
+ * Is Expand/Restore offered at the viewport's CURRENT width? Follows a resize.
+ * Never offered without a window (a server render): the control appears only
+ * where a width was actually read.
+ *
+ * ★ `enabled` is false for the classic presentation, which then listens to
+ * nothing and reads nothing: the hook has to be called either way.
+ */
+export declare function useCompactExpandOffered(enabled: boolean): boolean;
+/** The ☰ view's screens: its own list, and the two sub-views opened from it. */
+export type MenuViewName = 'root' | 'voice-language' | 'history';
+/**
+ * What Escape does inside the ☰ view: a sub-view goes back to the list, and the
+ * list closes the view. One key press, one layer (LA-06).
+ */
+export declare function menuViewEscape(view: MenuViewName): 'back' | 'close';
+/** The parts of the focused element `fieldOwnsEscape` reads. */
+export interface EscapeFieldLike {
+    readonly tagName?: string;
+    readonly value?: unknown;
+    getAttribute(name: string): string | null;
+}
+/**
+ * Does the focused element handle Escape ITSELF, so the ☰ view must not also
+ * step back? Inside History: the rename box (Escape cancels the rename) and the
+ * search box WHEN IT HOLDS TEXT (Escape clears it). An empty search box, a
+ * filter radio or a button leave Escape to the layer.
+ *
+ * ★ The ☰ view's `EscapeLayer` runs in the document CAPTURE phase, before the
+ * field's own React handler, so without this one press did both: cancelled the
+ * rename or cleared the search AND dropped back to the ☰ list.
+ */
+export declare function fieldOwnsEscape(element: EscapeFieldLike | null): boolean;
+/** What the composer reports about its draft (`AssistantComposerDraft`, the part N1 reads). */
+export interface UnsentDraft {
+    readonly text: string;
+    readonly hasAttachments: boolean;
+}
+/**
+ * Is there something typed or attached that has not been sent? Whitespace alone
+ * is not a draft: it is the composer's own `hasDraft` rule, so Close does not
+ * ask about a box that looks empty.
+ */
+export declare function draftIsUnsent(draft: UnsentDraft): boolean;
+/**
+ * What a request to close the panel does (N1): close, or ask first.
+ *
+ * `confirmed` is true while the person's "Discard and close" is running, so the
+ * close that follows it is not asked about again.
+ */
+export declare function closeRequestAction(args: {
+    compact: boolean;
+    unsent: boolean;
+    confirmed: boolean;
+}): 'close' | 'ask';
+/** How many conversations "Recent" lists. */
+export declare const COMPACT_RECENT_LIMIT = 5;
+/**
+ * The conversations "Recent" lists: the newest first, by last activity, with
+ * nothing in them left out (an empty draft is not something to go back to).
+ * The open conversation stays in the list, marked by the caller.
+ */
+export declare function recentConversations(conversations: readonly Conversation[], limit?: number): Conversation[];

package/dist/shared/assistant/ui/compact/compactChrome.js

@@ -0,0 +1,39 @@
+import { useSyncExternalStore as e } from "react";
+//#region src/shared/assistant/ui/compact/compactChrome.ts
+var t = 1536;
+function n(e) {
+	return e >= t;
+}
+function r(e) {
+	return typeof window > "u" ? () => {} : (window.addEventListener("resize", e), () => window.removeEventListener("resize", e));
+}
+var i = () => () => {}, a = () => typeof window < "u" && n(window.innerWidth), o = () => !1;
+function s(t) {
+	return e(t ? r : i, t ? a : o, o);
+}
+function c(e) {
+	return e === "root" ? "close" : "back";
+}
+function l(e) {
+	if (!e || e.tagName !== "INPUT") return !1;
+	let t = e.getAttribute("type");
+	return t !== null && t !== "text" && t !== "search" ? !1 : e.getAttribute("role") === "searchbox" ? typeof e.value == "string" && e.value !== "" : !0;
+}
+function u(e) {
+	return e.text.trim() !== "" || e.hasAttachments;
+}
+function d(e) {
+	return e.compact && e.unsent && !e.confirmed ? "ask" : "close";
+}
+var f = 5;
+function p(e, t = 5) {
+	return e.filter((e) => e.messages.length > 0).map((e, t) => ({
+		conversation: e,
+		index: t
+	})).sort((e, t) => {
+		let n = Date.parse(t.conversation.updatedAt) - Date.parse(e.conversation.updatedAt);
+		return Number.isNaN(n) || n === 0 ? e.index - t.index : n;
+	}).slice(0, t).map((e) => e.conversation);
+}
+//#endregion
+export { t as COMPACT_EXPAND_MIN_VIEWPORT_PX, f as COMPACT_RECENT_LIMIT, d as closeRequestAction, n as compactExpandOffered, u as draftIsUnsent, l as fieldOwnsEscape, c as menuViewEscape, p as recentConversations, s as useCompactExpandOffered };

package/dist/shared/assistant/ui/compact/waitingChange.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The pure half of the compact "change waiting" row (N6, BOFF-10177): how many
+ * changes wait for the person's approval, and how Review reaches the card.
+ *
+ * ★ The row is a POINTER to the existing approval card and nothing else. These
+ * two functions count and find; neither approves, declines or withdraws.
+ */
+/** What this reads of one proposal entry (`WriteProposalEntry`). */
+export interface WaitingChangeEntry {
+    readonly session: {
+        readonly conversationId: string;
+        readonly sandboxId: string;
+    };
+    readonly view: {
+        readonly status: string;
+    };
+}
+/**
+ * How many changes wait in the open conversation. The rule of
+ * `writeProposalPanel.liveFor` (pending, and not in a replaced sandbox), read
+ * from the entries so it can be recomputed on every arrival and decision.
+ *
+ * ★ Only changes with a card ON THE PAGE are counted (`cardProposalIds`: the
+ * proposals the typed thread's replies reference). The row points at a card; a
+ * change a SPOKEN turn left behind has none once the voice session ends (the
+ * thread omits spoken turns and the transcript draws no cards), so counting it
+ * would show a Review that finds nothing. Omitted, every pending change counts.
+ */
+export declare function countWaitingChanges(entries: Readonly<Record<string, WaitingChangeEntry>>, conversationId: string | null, retiredSandboxes: ReadonlySet<string>, cardProposalIds?: ReadonlySet<string>): number;
+/** A card waiting for a decision: the existing card's own markers. */
+export declare const WAITING_CARD_SELECTOR = "[data-testid=\"assistant-write-proposal\"][data-status=\"pending\"]";
+/** The slice of an element Review uses. */
+interface ReviewableCard {
+    closest(selector: string): unknown;
+    hasAttribute(name: string): boolean;
+    setAttribute(name: string, value: string): void;
+    scrollIntoView(options?: ScrollIntoViewOptions): void;
+    focus(options?: FocusOptions): void;
+}
+/**
+ * Scroll to the first waiting card under `root` and focus it. A replaced
+ * sandbox's card is inert and is skipped. The card is a `group` that cannot take
+ * focus by itself, so it is made a programmatic focus target first
+ * (`tabindex="-1"`, which adds no Tab stop). Returns whether a card was found.
+ */
+export declare function focusFirstWaitingCard(root: {
+    querySelectorAll(selector: string): ArrayLike<ReviewableCard>;
+} | null): boolean;
+export {};

package/dist/shared/assistant/ui/compact/waitingChange.js

@@ -0,0 +1,12 @@
+//#region src/shared/assistant/ui/compact/waitingChange.ts
+function e(e, t, n, r) {
+	return t === null ? 0 : Object.entries(e).filter(([e, i]) => i.session.conversationId === t && i.view.status === "pending" && !n.has(i.session.sandboxId) && (r === void 0 || r.has(e))).length;
+}
+var t = "[data-testid=\"assistant-write-proposal\"][data-status=\"pending\"]";
+function n(e) {
+	if (!e) return !1;
+	let n = Array.from(e.querySelectorAll(t)).find((e) => !e.closest("[inert]"));
+	return n ? (n.scrollIntoView({ block: "center" }), n.hasAttribute("tabindex") || n.setAttribute("tabindex", "-1"), n.focus({ preventScroll: !0 }), !0) : !1;
+}
+//#endregion
+export { t as WAITING_CARD_SELECTOR, e as countWaitingChanges, n as focusFirstWaitingCard };