@burdenoff/fe-libs 2026.1029.8 → 2026.1029.10

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 };

package/dist/shared/assistant/ui/composer/AssistantComposer.d.ts

@@ -1,4 +1,4 @@
-import { FC } from 'react';
+import { FC, ReactNode, Ref } from 'react';
 import { AssistantModeConfig } from '../../conversation';
 import { AssistantMode } from '../../types';
 import { AssistantAttachment } from '../../attachments';
@@ -95,8 +95,26 @@ interface Props {
      * none was running; only a stopped turn is announced.
      */
     onStop?: () => string | null;
+    /**
+     * The id of the reply in flight (what `onStop` returns for it), or null. Lets
+     * Stop tell "the reply I stopped is still ending" from "another reply has
+     * begun": a parked send is replayed in the stopped turn's own `finally`, so
+     * `turnInFlight` can stay true across the two. Absent: Stop goes by
+     * `turnInFlight` alone.
+     */
+    turnId?: string | null;
     /** Why the Mode menu is disabled; absent while it is disabled: `busy`. */
     modeDisabledReason?: AssistantModeDisabledReason | null;
+    /**
+     * The message box, for the panel's `/` shortcut (BOFF-10177, compact only).
+     * Classic never reads it: its box is exactly as before.
+     */
+    inputRef?: Ref<HTMLTextAreaElement>;
+    /**
+     * Compact only (BOFF-10177, N6): what sits pinned just above the card, the
+     * "change waiting" row. Classic never draws it.
+     */
+    aboveCard?: ReactNode;
 }
 /** A local draft snapshot; no files are uploaded by observing it. */
 export interface AssistantComposerDraft {
@@ -109,22 +127,5 @@ export interface AssistantComposerVoiceState {
     readonly committing: boolean;
     readonly dictating: boolean;
 }
-/**
- * AssistantComposer — the v2 input surface (per the ai-assistant-v2 mockups).
- *
- * A rounded card with, on the input row: a leading circular "+" attach control,
- * an auto-growing textarea, a microphone, and a prominent filled forest-green
- * circular send button. BELOW the input sit the mode pills ("Ask" active-green /
- * "Take action" outline); ABOVE it, chips for any pending attachments.
- *
- * Multimodal input (Workstreams 2–3) arrives through three converging paths —
- * the attach button, drag-and-drop onto the card, and paste (a screenshot from
- * the clipboard is the single most common way a user shares one) — plus voice
- * dictation, which appends recognised speech to the draft so it can still be
- * edited before sending.
- *
- * Fully controlled (React state for the text) with auto-grow via a layout
- * effect. Enter sends, Shift+Enter inserts a newline.
- */
 export declare const AssistantComposer: FC<Props>;
 export {};