@burdenoff/fe-libs 2026.1029.10 → 2026.1029.11

package/dist/shared/assistant/ui/assistantOverlayState.d.ts

@@ -254,6 +254,216 @@ export declare function assistantOverlayClassName(input: {
     expanded: boolean;
     docked: boolean;
 }): string;
+/**
+ * What the one assistant container is showing (DESIGN §8.2):
+ *  - `window`: the Quick assistant, a small non-modal window above the launcher
+ *    (a bottom sheet on a phone);
+ *  - `panel`: the full assistant, docked, floating or a sheet.
+ *
+ * ★ A surface is a CLASS and a geometry on one persistent element, never a
+ * place in the tree: the in-flight turn, the draft, its attachments, the
+ * microphone and the voice session all live below it.
+ */
+export type AssistantSurface = 'window' | 'panel';
+/** Narrow a stored value to a surface. */
+export declare function isAssistantSurface(value: unknown): value is AssistantSurface;
+/** The storage keys only the compact presentation uses. */
+export interface AssistantCompactOverlayKeys {
+    /** localStorage: the person's EXPLICIT Dock/Float pick (D1-A), `docked` or `floating`. */
+    layoutStorageKey: string;
+    /** sessionStorage: which surface is showing, `window` or `panel`. */
+    surfaceStorageKey: string;
+    /** sessionStorage: the Quick assistant window is minimized (`1`/`0`). */
+    minimizedStorageKey: string;
+}
+/**
+ * The compact keys for a product prefix: `<prefix>:ai-panel:layout`, `:surface`
+ * and `:minimized`. Separate from `assistantOverlayKeys` so the classic keys
+ * (and what a host reads of them) cannot change.
+ */
+export declare function assistantCompactOverlayKeys(prefix: string): AssistantCompactOverlayKeys;
+/** Dock or Float, as a person picked it. */
+export type AssistantLayoutChoice = 'docked' | 'floating';
+/** The explicit Dock/Float pick (D1-A), or null when none was made or storage fails. */
+export declare function readAssistantLayoutChoice(storage: () => Pick<Storage, 'getItem'> | undefined, key: string): AssistantLayoutChoice | null;
+/** Persist an explicit Dock/Float pick. An unavailable store keeps it in memory only. */
+export declare function writeAssistantLayoutChoice(storage: () => Pick<Storage, 'setItem'> | undefined, key: string, choice: AssistantLayoutChoice): void;
+/**
+ * The LEGACY dock key (`<prefix>:ai-panel:docked`) as a choice: `"1"` is docked,
+ * `"0"` is floating, anything else (absent, unreadable) is no choice.
+ *
+ * ★ The classic overlay writes `"0"` on mount, so a browser that has run any
+ * overlay holds a `"0"` that does not mean "I chose Float". The compact
+ * presentation therefore reads it only AFTER its own explicit key, and never
+ * writes it (D1-A).
+ */
+export declare function readAssistantLegacyDockChoice(storage: () => Pick<Storage, 'getItem'> | undefined, key: string): AssistantLayoutChoice | null;
+/**
+ * Docked is the default from this viewport width up (N2, DESIGN-DELTA A2): at
+ * 1024 the default sidebar leaves the page 328 px beside a 440 px dock, at 1280
+ * it leaves 584. Between 640 and 1279 the default is a floating window.
+ */
+export declare const ASSISTANT_COMPACT_DOCKED_MIN_VIEWPORT_PX = 1280;
+/** The media query for `ASSISTANT_COMPACT_DOCKED_MIN_VIEWPORT_PX`. */
+export declare const ASSISTANT_COMPACT_DOCKED_DEFAULT_QUERY = "(min-width: 1280px)";
+/**
+ * Is the full assistant docked? D1-A: the person's explicit pick, then the
+ * legacy stored `"1"`/`"0"`, then the viewport default (docked from 1280 px).
+ * On a phone the answer is irrelevant: every layout class is `sm:`.
+ */
+export declare function resolveCompactDocked(input: {
+    explicit: AssistantLayoutChoice | null;
+    legacy: AssistantLayoutChoice | null;
+    wideViewport: boolean;
+}): boolean;
+/** Width of the Quick assistant window on a desktop. Must match `sm:w-[360px]` below. */
+export declare const ASSISTANT_COMPACT_WINDOW_WIDTH_PX = 360;
+/** The window's height ceiling on a desktop. Must match the `600px` in its class below. */
+export declare const ASSISTANT_COMPACT_WINDOW_HEIGHT_PX = 600;
+/**
+ * The expanded width, docked or floating (N2): a FIXED 760 px, so the published
+ * inset stays a pure constant. Must match `sm:w-[760px]` below.
+ */
+export declare const ASSISTANT_COMPACT_EXPANDED_WIDTH_PX = 760;
+/** What a panel's geometry depends on besides the open flag and the viewport. */
+export interface AssistantCompactGeometryInput {
+    isOpen: boolean;
+    docked: boolean;
+    isDesktop: boolean;
+    surface: AssistantSurface;
+    /** Expand was pressed (the panel only reports it from 1536 px up). */
+    expanded: boolean;
+}
+/**
+ * The width the docked full panel takes from the page, in px: 440, or 760 when
+ * expanded. Nothing for the window, the floating panel, a phone sheet or a
+ * closed assistant. A pure constant of its inputs.
+ */
+export declare function publishedCompactDockWidth(input: AssistantCompactGeometryInput): number;
+/**
+ * How far the open full panel reaches in from the page's right edge, in px:
+ * the dock width while docked (440, 760 expanded), the floating width plus its
+ * right gap while floating (544, 784 expanded). Nothing is published for the
+ * Quick assistant window (it is a small non-modal overlay and the page stays
+ * whole), for a phone sheet, or while closed.
+ */
+export declare function publishedCompactPanelInset(input: AssistantCompactGeometryInput): number;
+/**
+ * Where the window's bottom edge sits: above the launcher. A variable the
+ * overlay sets on the container, from the launcher's own bottom offset, so a
+ * host that lifts the launcher lifts the window with it. Falls back to 6rem,
+ * the classic floating window's anchor.
+ */
+export declare const ASSISTANT_WINDOW_BOTTOM_VAR = "--assistant-window-bottom";
+/** The launcher is `size-14` (3.5rem); the window rests 1rem above it. */
+export declare const ASSISTANT_WINDOW_LAUNCHER_CLEARANCE = "4.5rem";
+/** The window's bottom offset for a launcher inset: the launcher's own, plus its size and a gap. */
+export declare function assistantWindowBottom(launcherBottomInset: string): string;
+/**
+ * CSS custom properties the overlay sets on the PHONE sheet from the visual
+ * viewport (DELTA A5): the height the sheet may use, and how far the on-screen
+ * keyboard covers the layout viewport's bottom edge. Set on the container, not
+ * on `<html>`: they are the sheet's own, and a keyboard animation writes them
+ * on every frame.
+ */
+export declare const ASSISTANT_VIEWPORT_HEIGHT_VAR = "--assistant-viewport-height";
+export declare const ASSISTANT_KEYBOARD_INSET_VAR = "--assistant-keyboard-inset";
+/**
+ * Shared by every compact surface, on a phone: a full-width bottom sheet with a
+ * rounded top edge. ★ No height here (see the heights below), and no surface
+ * colour: the window and the panel each name their own, so one class never
+ * fights another for the same property.
+ *
+ * ★ The bottom edge is the LARGER of the tab bar and the keyboard. With the
+ * keyboard up the tab bar is behind it, so the sheet rests on the keyboard;
+ * without one the inset is 0 and the tab bar wins, as in classic.
+ */
+export declare const ASSISTANT_COMPACT_SHEET_BASE_CLASS: string;
+/** The full panel's colours on every viewport: classic's surface and shadow. */
+export declare const ASSISTANT_COMPACT_PANEL_SURFACE_CLASS = "bg-bg-surface shadow-2xl";
+/**
+ * The window's colours on every viewport: an elevated surface and the elevation-4
+ * shadow.
+ *
+ * ★ The shadow is read from the TOKEN: `--shadow-elevation-4` is a `:root` custom
+ * property with no `@theme` entry, so `shadow-elevation-4` is not a utility and
+ * would paint nothing. The arbitrary-value form is how the other call sites read
+ * `--shadow-focus`.
+ */
+export declare const ASSISTANT_COMPACT_WINDOW_SURFACE_CLASS = "bg-bg-elevated shadow-[var(--shadow-elevation-4)]";
+/**
+ * Phone sheet heights, in `dvh` and capped by the visual viewport (DELTA A5 a):
+ * the sheet never grows taller than what the keyboard leaves, so the composer
+ * and Stop stay on screen and only the message list gives way. The window
+ * opens at about 62 %, the full panel at 60 %; either expands to 88 %.
+ */
+export declare const ASSISTANT_COMPACT_SHEET_WINDOW_CLASS = "h-[62dvh] max-h-[min(62dvh,var(--assistant-viewport-height,100dvh))]";
+export declare const ASSISTANT_COMPACT_SHEET_PANEL_CLASS = "h-[60dvh] max-h-[min(60dvh,var(--assistant-viewport-height,100dvh))]";
+export declare const ASSISTANT_COMPACT_SHEET_EXPANDED_CLASS = "h-[88dvh] max-h-[min(88dvh,var(--assistant-viewport-height,100dvh))]";
+/**
+ * Desktop: the Quick assistant window. 360 wide, `min(600px, 100dvh − header −
+ * launcher area)` tall, resting above the launcher; non-modal (no scrim).
+ */
+export declare const ASSISTANT_COMPACT_WINDOW_DESKTOP_CLASS: string;
+/** Desktop: the docked full panel, 440 wide. */
+export declare const ASSISTANT_COMPACT_DOCKED_DESKTOP_CLASS: string;
+/** Desktop: the docked full panel, expanded to a fixed 760. */
+export declare const ASSISTANT_COMPACT_DOCKED_EXPANDED_DESKTOP_CLASS: string;
+/** Desktop: the floating full panel, 520 × 680 clamped to the viewport, as classic. */
+export declare const ASSISTANT_COMPACT_FLOATING_DESKTOP_CLASS: string;
+/**
+ * Desktop: the floating full panel, expanded: a fixed 760 wide and `viewport −
+ * header − 48px` tall, so it keeps 24 px under the header and 24 px above the
+ * bottom edge. The launcher is hidden while the full panel is open (L1), so
+ * nothing needs the room it would have kept.
+ */
+export declare const ASSISTANT_COMPACT_FLOATING_EXPANDED_DESKTOP_CLASS: string;
+/**
+ * The container's class for the compact presentation.
+ *
+ * ★★ Like the classic one, every axis selects a CLASS on ONE persistent
+ * element, never a mount: surface, minimized, dock, float, sheet and expanded.
+ * A minimized window keeps its element (and the panel inside it) and only stops
+ * being displayed.
+ *
+ * @param sheetExpanded  the phone sheet is raised from its grab handle (88 %)
+ * @param expanded       the panel is Expanded to a fixed 760 px (desktop)
+ */
+export declare function assistantCompactOverlayClassName(input: {
+    surface: AssistantSurface;
+    minimized: boolean;
+    docked: boolean;
+    expanded: boolean;
+    sheetExpanded: boolean;
+}): string;
+/**
+ * Does the launcher show? Classic hides it on a phone while the assistant is
+ * open. The compact presentation hides it at ALL widths while the full panel is
+ * open (L1, the header button is the way back), and on a phone while the window
+ * is open (the sheet would be painted over by it). A minimized window shows it:
+ * it is the way back in.
+ */
+export declare function assistantCompactLauncherVisibility(input: {
+    isOpen: boolean;
+    surface: AssistantSurface;
+    minimized: boolean;
+}): 'always' | 'desktop-only' | 'hidden';
+/**
+ * The visual viewport, reduced to what the sheet needs. The keyboard inset is how
+ * far the on-screen keyboard covers the bottom of the LAYOUT viewport; the
+ * height is what is left for the sheet. `scale` guards pinch-zoom: a zoomed
+ * visual viewport is smaller than the layout one without any keyboard, and the
+ * sheet must not shrink for it.
+ */
+export declare function assistantVisualViewportMetrics(input: {
+    layoutHeight: number;
+    viewportHeight: number;
+    viewportOffsetTop: number;
+    scale: number;
+}): {
+    heightPx: number;
+    keyboardInsetPx: number;
+};
 export interface AssistantNavigateOptions {
     /** The product router's navigate, e.g. React Router's `useNavigate()`. */
     navigate: (path: string) => void;

package/dist/shared/assistant/ui/assistantOverlayState.js

@@ -16,48 +16,118 @@ function r(e, t) {
 	return t ?? !e;
 }
 var i = "Ctrl+Shift+A";
-function a(e) {
+function ee(e) {
 	return (e.ctrlKey || e.metaKey) && e.shiftKey && typeof e.key == "string" && e.key.toLowerCase() === "a";
 }
-var o = "[role=\"dialog\"],[role=\"alertdialog\"],dialog[open]";
-function s(e, t) {
-	return c(e) ? e.closest(t) : null;
+var te = "[role=\"dialog\"],[role=\"alertdialog\"],dialog[open]";
+function a(e, t) {
+	return o(e) ? e.closest(t) : null;
 }
-function c(e) {
+function o(e) {
 	return typeof e == "object" && !!e && "closest" in e && typeof e.closest == "function";
 }
-function l(e) {
+function ne(e) {
 	return e.key !== "Escape" || !e.isOpen || e.alreadyHandled || e.dialogOpen || e.pressedInsideDialog || e.panelOwnsEscape ? "ignore" : "close";
 }
-var u = "max(var(--mobile-tabbar-height, 0px), var(--safe-bottom, 0px), env(safe-area-inset-bottom, 0px))";
-function d(e) {
-	return `calc(${e} + ${u})`;
+var s = "max(var(--mobile-tabbar-height, 0px), var(--safe-bottom, 0px), env(safe-area-inset-bottom, 0px))";
+function c(e) {
+	return `calc(${e} + ${s})`;
 }
-var f = "--assistant-launcher-lift";
-function p(e) {
-	return `calc(var(${f}, 0px) + ${d(e)})`;
+var l = "--assistant-launcher-lift";
+function u(e) {
+	return `calc(var(${l}, 0px) + ${c(e)})`;
 }
-var m = "1.5rem";
-function h(e) {
-	return e > 0 ? `calc(${m} + ${e}px)` : m;
+var d = "1.5rem";
+function re(e) {
+	return e > 0 ? `calc(${d} + ${e}px)` : d;
 }
-var g = 440, _ = "--assistant-dock-width", v = "--assistant-sheet-bottom", y = "--assistant-overlay-top", b = 56, x = "(min-width: 640px)";
-function S(e) {
+var f = 440, p = "--assistant-dock-width", m = "--assistant-sheet-bottom", h = "--assistant-overlay-top", g = 56, _ = "(min-width: 640px)";
+function v(e) {
 	return e.isOpen && e.docked && e.isDesktop ? 440 : 0;
 }
-var C = 520, w = 24, T = "--assistant-panel-inset";
-function E(e) {
+var y = 520, ie = 24, ae = "--assistant-panel-inset";
+function oe(e) {
 	return !e.isOpen || !e.isDesktop ? 0 : e.docked ? 440 : 544;
 }
-var D = "fixed z-50 flex flex-col overflow-hidden border border-border-default bg-bg-surface shadow-2xl inset-x-0 bottom-[var(--assistant-sheet-bottom,0px)] top-auto rounded-t-2xl animate-in slide-in-from-bottom-4 fade-in duration-200", O = "h-[60vh] max-h-[60vh]", k = "h-[88vh] max-h-[88vh]", A = "sm:inset-auto sm:top-auto sm:bottom-24 sm:right-6 sm:rounded-2xl sm:h-[680px] sm:max-h-[calc(100vh-6rem-var(--assistant-overlay-top,56px)-0.5rem)] sm:w-[520px] sm:max-w-[calc(100vw-2rem)]", j = "sm:left-auto sm:right-0 sm:top-[var(--assistant-overlay-top)] sm:bottom-0 sm:rounded-none sm:h-auto sm:max-h-none sm:w-[440px] sm:max-w-[calc(100vw-2rem)]";
-function M(e) {
+var b = "fixed z-50 flex flex-col overflow-hidden border border-border-default bg-bg-surface shadow-2xl inset-x-0 bottom-[var(--assistant-sheet-bottom,0px)] top-auto rounded-t-2xl animate-in slide-in-from-bottom-4 fade-in duration-200", x = "h-[60vh] max-h-[60vh]", S = "h-[88vh] max-h-[88vh]", C = "sm:inset-auto sm:top-auto sm:bottom-24 sm:right-6 sm:rounded-2xl sm:h-[680px] sm:max-h-[calc(100vh-6rem-var(--assistant-overlay-top,56px)-0.5rem)] sm:w-[520px] sm:max-w-[calc(100vw-2rem)]", w = "sm:left-auto sm:right-0 sm:top-[var(--assistant-overlay-top)] sm:bottom-0 sm:rounded-none sm:h-auto sm:max-h-none sm:w-[440px] sm:max-w-[calc(100vw-2rem)]";
+function T(e) {
+	return [
+		b,
+		e.expanded ? S : x,
+		e.docked ? w : C
+	].join(" ");
+}
+function E(e) {
+	return e === "window" || e === "panel";
+}
+function D(e) {
+	return {
+		layoutStorageKey: `${e}:ai-panel:layout`,
+		surfaceStorageKey: `${e}:ai-panel:surface`,
+		minimizedStorageKey: `${e}:ai-panel:minimized`
+	};
+}
+function O(e, t) {
+	try {
+		let n = e()?.getItem(t);
+		return n === "docked" || n === "floating" ? n : null;
+	} catch {
+		return null;
+	}
+}
+function k(e, t, n) {
+	try {
+		e()?.setItem(t, n);
+	} catch {}
+}
+function A(e, t) {
+	try {
+		let n = e()?.getItem(t);
+		return n === "1" ? "docked" : n === "0" ? "floating" : null;
+	} catch {
+		return null;
+	}
+}
+var j = 1280, M = `(min-width: ${j}px)`;
+function N(e) {
+	let t = e.explicit ?? e.legacy;
+	return t === null ? e.wideViewport : t === "docked";
+}
+var P = 360, F = 600, I = 760;
+function L(e) {
+	return !e.isOpen || !e.isDesktop || e.surface !== "panel" || !e.docked ? 0 : e.expanded ? 760 : 440;
+}
+function R(e) {
+	if (!e.isOpen || !e.isDesktop || e.surface !== "panel") return 0;
+	let t = e.expanded ? 760 : e.docked ? 440 : 520;
+	return e.docked ? t : t + 24;
+}
+var z = "--assistant-window-bottom", B = "4.5rem";
+function V(e) {
+	return `calc(${u(e)} + ${B})`;
+}
+var se = "--assistant-viewport-height", H = "--assistant-keyboard-inset", U = "fixed z-50 flex flex-col overflow-hidden border border-border-default inset-x-0 bottom-[max(var(--assistant-sheet-bottom,0px),var(--assistant-keyboard-inset,0px))] top-auto rounded-t-2xl animate-in slide-in-from-bottom-4 fade-in duration-200", W = "bg-bg-surface shadow-2xl", G = "bg-bg-elevated shadow-[var(--shadow-elevation-4)]", K = "h-[62dvh] max-h-[min(62dvh,var(--assistant-viewport-height,100dvh))]", q = "h-[60dvh] max-h-[min(60dvh,var(--assistant-viewport-height,100dvh))]", J = "h-[88dvh] max-h-[min(88dvh,var(--assistant-viewport-height,100dvh))]", Y = "sm:inset-auto sm:top-auto sm:bottom-[var(--assistant-window-bottom,6rem)] sm:right-6 sm:rounded-3xl sm:h-[min(600px,calc(100dvh-var(--assistant-window-bottom,6rem)-var(--assistant-overlay-top,56px)-0.5rem))] sm:max-h-none sm:w-[360px] sm:max-w-[calc(100vw-2rem)]", X = "sm:left-auto sm:right-0 sm:top-[var(--assistant-overlay-top)] sm:bottom-0 sm:rounded-none sm:h-auto sm:max-h-none sm:w-[440px] sm:max-w-[calc(100vw-2rem)]", Z = "sm:left-auto sm:right-0 sm:top-[var(--assistant-overlay-top)] sm:bottom-0 sm:rounded-none sm:h-auto sm:max-h-none sm:w-[760px] sm:max-w-[calc(100vw-2rem)]", Q = "sm:inset-auto sm:top-auto sm:bottom-24 sm:right-6 sm:rounded-2xl sm:h-[680px] sm:max-h-[calc(100dvh-6rem-var(--assistant-overlay-top,56px)-0.5rem)] sm:w-[520px] sm:max-w-[calc(100vw-2rem)]", $ = "sm:inset-auto sm:top-auto sm:bottom-6 sm:right-6 sm:rounded-2xl sm:h-[calc(100dvh-var(--assistant-overlay-top,56px)-3rem)] sm:max-h-none sm:w-[760px] sm:max-w-[calc(100vw-2rem)]";
+function ce(e) {
+	if (e.minimized) return "hidden";
+	let t = e.surface === "window", n = e.sheetExpanded ? J : t ? K : q, r = t ? Y : e.docked ? e.expanded ? Z : X : e.expanded ? $ : Q;
 	return [
-		D,
-		e.expanded ? k : O,
-		e.docked ? j : A
+		U,
+		t ? G : W,
+		n,
+		r
 	].join(" ");
 }
-function N(t) {
+function le(e) {
+	return !e.isOpen || e.minimized ? "always" : e.surface === "panel" ? "hidden" : "desktop-only";
+}
+function ue(e) {
+	let t = e.scale > 1.01, n = e.layoutHeight - e.viewportHeight - e.viewportOffsetTop, r = t ? 0 : Math.max(0, Math.round(n));
+	return {
+		heightPx: Math.max(0, Math.round(t ? e.layoutHeight : e.viewportHeight)),
+		keyboardInsetPx: r
+	};
+}
+function de(t) {
 	return (n, r) => {
 		if (t.isShellLessTarget?.(n)) return t.openInNewTab(n), { kind: "new-tab" };
 		let i = e(r);
@@ -68,22 +138,22 @@ function N(t) {
 		} : (t.navigate(n), t.isDesktop() || t.collapseSheet(), { kind: "routed" });
 	};
 }
-function P(e) {
+function fe(e) {
 	if (typeof CustomEvent > "u" || !(e instanceof CustomEvent)) return "generic";
 	let t = e.detail;
 	return typeof t != "object" || !t || !("kind" in t) ? "generic" : t.kind === "sandbox" || t.kind === "ai-credits" ? t.kind : "generic";
 }
-function F(e, t) {
+function pe(e, t) {
 	try {
 		return e()?.getItem(t) === "1";
 	} catch {
 		return !1;
 	}
 }
-function I(e, t, n) {
+function me(e, t, n) {
 	try {
 		e()?.setItem(t, n ? "1" : "0");
 	} catch {}
 }
 //#endregion
-export { u as ASSISTANT_BOTTOM_CHROME_CLEARANCE, o as ASSISTANT_DIALOG_SELECTOR, j as ASSISTANT_DOCKED_DESKTOP_CLASS, g as ASSISTANT_DOCK_WIDTH_PX, _ as ASSISTANT_DOCK_WIDTH_VAR, A as ASSISTANT_FLOATING_DESKTOP_CLASS, w as ASSISTANT_FLOATING_RIGHT_PX, C as ASSISTANT_FLOATING_WIDTH_PX, f as ASSISTANT_LAUNCHER_LIFT_VAR, m as ASSISTANT_LAUNCHER_RIGHT_INSET, b as ASSISTANT_OVERLAY_DEFAULT_TOP_PX, x as ASSISTANT_OVERLAY_DESKTOP_QUERY, y as ASSISTANT_OVERLAY_TOP_VAR, T as ASSISTANT_PANEL_INSET_VAR, D as ASSISTANT_SHEET_BASE_CLASS, v as ASSISTANT_SHEET_BOTTOM_VAR, O as ASSISTANT_SHEET_COMPACT_CLASS, k as ASSISTANT_SHEET_EXPANDED_CLASS, i as ASSISTANT_TOGGLE_SHORTCUT_LABEL, d as aboveAssistantBottomChrome, p as assistantLauncherBottom, h as assistantLauncherRight, M as assistantOverlayClassName, l as assistantOverlayEscapeAction, t as assistantOverlayKeys, P as assistantQuotaKindOf, s as closestAround, N as createAssistantNavigate, a as isAssistantToggleShortcut, r as nextAssistantOpenState, S as publishedAssistantDockWidth, E as publishedAssistantPanelInset, F as readAssistantOverlayFlag, n as requestedAssistantOpenState, I as writeAssistantOverlayFlag };
+export { s as ASSISTANT_BOTTOM_CHROME_CLEARANCE, M as ASSISTANT_COMPACT_DOCKED_DEFAULT_QUERY, X as ASSISTANT_COMPACT_DOCKED_DESKTOP_CLASS, Z as ASSISTANT_COMPACT_DOCKED_EXPANDED_DESKTOP_CLASS, j as ASSISTANT_COMPACT_DOCKED_MIN_VIEWPORT_PX, I as ASSISTANT_COMPACT_EXPANDED_WIDTH_PX, Q as ASSISTANT_COMPACT_FLOATING_DESKTOP_CLASS, $ as ASSISTANT_COMPACT_FLOATING_EXPANDED_DESKTOP_CLASS, W as ASSISTANT_COMPACT_PANEL_SURFACE_CLASS, U as ASSISTANT_COMPACT_SHEET_BASE_CLASS, J as ASSISTANT_COMPACT_SHEET_EXPANDED_CLASS, q as ASSISTANT_COMPACT_SHEET_PANEL_CLASS, K as ASSISTANT_COMPACT_SHEET_WINDOW_CLASS, Y as ASSISTANT_COMPACT_WINDOW_DESKTOP_CLASS, F as ASSISTANT_COMPACT_WINDOW_HEIGHT_PX, G as ASSISTANT_COMPACT_WINDOW_SURFACE_CLASS, P as ASSISTANT_COMPACT_WINDOW_WIDTH_PX, te as ASSISTANT_DIALOG_SELECTOR, w as ASSISTANT_DOCKED_DESKTOP_CLASS, f as ASSISTANT_DOCK_WIDTH_PX, p as ASSISTANT_DOCK_WIDTH_VAR, C as ASSISTANT_FLOATING_DESKTOP_CLASS, ie as ASSISTANT_FLOATING_RIGHT_PX, y as ASSISTANT_FLOATING_WIDTH_PX, H as ASSISTANT_KEYBOARD_INSET_VAR, l as ASSISTANT_LAUNCHER_LIFT_VAR, d as ASSISTANT_LAUNCHER_RIGHT_INSET, g as ASSISTANT_OVERLAY_DEFAULT_TOP_PX, _ as ASSISTANT_OVERLAY_DESKTOP_QUERY, h as ASSISTANT_OVERLAY_TOP_VAR, ae as ASSISTANT_PANEL_INSET_VAR, b as ASSISTANT_SHEET_BASE_CLASS, m as ASSISTANT_SHEET_BOTTOM_VAR, x as ASSISTANT_SHEET_COMPACT_CLASS, S as ASSISTANT_SHEET_EXPANDED_CLASS, i as ASSISTANT_TOGGLE_SHORTCUT_LABEL, se as ASSISTANT_VIEWPORT_HEIGHT_VAR, z as ASSISTANT_WINDOW_BOTTOM_VAR, B as ASSISTANT_WINDOW_LAUNCHER_CLEARANCE, c as aboveAssistantBottomChrome, le as assistantCompactLauncherVisibility, ce as assistantCompactOverlayClassName, D as assistantCompactOverlayKeys, u as assistantLauncherBottom, re as assistantLauncherRight, T as assistantOverlayClassName, ne as assistantOverlayEscapeAction, t as assistantOverlayKeys, fe as assistantQuotaKindOf, ue as assistantVisualViewportMetrics, V as assistantWindowBottom, a as closestAround, de as createAssistantNavigate, E as isAssistantSurface, ee as isAssistantToggleShortcut, r as nextAssistantOpenState, v as publishedAssistantDockWidth, oe as publishedAssistantPanelInset, L as publishedCompactDockWidth, R as publishedCompactPanelInset, O as readAssistantLayoutChoice, A as readAssistantLegacyDockChoice, pe as readAssistantOverlayFlag, n as requestedAssistantOpenState, N as resolveCompactDocked, k as writeAssistantLayoutChoice, me as writeAssistantOverlayFlag };

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

@@ -0,0 +1,19 @@
+import { FC } from 'react';
+export interface AssistantWindowHeaderProps {
+    /** Switch the same instance to the full assistant. Nothing is re-sent. */
+    onOpenFull: () => void;
+    /** Hide the window and keep everything in it (CW-M). */
+    onMinimize: () => void;
+}
+/**
+ * The Quick assistant window's slim header (BOFF-10178, Slice 3):
+ * `[✦] Quick assistant ………… [Open full assistant] [Minimize]`.
+ *
+ * ★ No Close (CW-M): the window is hidden, never closed, so a draft, its
+ * attachments and the conversation stay exactly where they are. Closing is the
+ * full panel's. The view toggle, language pill and voice cue are Slice 5.
+ *
+ * ★ Both controls keep one NAME each (WCAG 2.5.3): the tooltip is the same
+ * words.
+ */
+export declare const AssistantWindowHeader: FC<AssistantWindowHeaderProps>;

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

@@ -0,0 +1,54 @@
+import { useAssistantTr as e } from "../../i18n.js";
+import { Minus as t, PanelRight as n, Sparkles as r } from "lucide-react";
+import { jsx as i, jsxs as a } from "react/jsx-runtime";
+//#region src/shared/assistant/ui/compact/AssistantWindowHeader.tsx
+var o = "flex size-10 shrink-0 items-center justify-center rounded-button transition-colors focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-focus-ring)]", s = "text-text-secondary hover:bg-bg-sunken hover:text-text-primary", c = ({ onOpenFull: c, onMinimize: l }) => {
+	let u = e(), d = u("window.openFull", "Open full assistant"), f = u("window.minimize", "Minimize");
+	return /* @__PURE__ */ a("div", {
+		className: "flex min-h-14 items-center gap-0.5 border-b border-border-default px-3 py-2",
+		"data-testid": "assistant-window-header",
+		"data-presentation": "compact",
+		"data-surface": "window",
+		children: [
+			/* @__PURE__ */ a("div", {
+				className: "flex min-w-0 flex-1 items-center gap-3",
+				children: [/* @__PURE__ */ i("span", {
+					className: "flex size-7 flex-shrink-0 items-center justify-center rounded-lg bg-gradient-to-br from-action-primary-bg/25 to-action-primary-bg/5 text-action-primary-bg",
+					children: /* @__PURE__ */ i(r, {
+						className: "size-4",
+						"aria-hidden": "true"
+					})
+				}), /* @__PURE__ */ i("span", {
+					className: "block min-w-0 flex-1 truncate text-base font-semibold leading-tight text-text-primary",
+					children: u("window.title", "Quick assistant")
+				})]
+			}),
+			/* @__PURE__ */ i("button", {
+				type: "button",
+				onClick: c,
+				className: `${o} ${s}`,
+				"aria-label": d,
+				title: d,
+				"data-testid": "assistant-open-full",
+				children: /* @__PURE__ */ i(n, {
+					className: "size-5",
+					"aria-hidden": "true"
+				})
+			}),
+			/* @__PURE__ */ i("button", {
+				type: "button",
+				onClick: l,
+				className: `${o} ${s}`,
+				"aria-label": f,
+				title: f,
+				"data-testid": "assistant-minimize",
+				children: /* @__PURE__ */ i(t, {
+					className: "size-5",
+					"aria-hidden": "true"
+				})
+			})
+		]
+	});
+};
+//#endregion
+export { c as AssistantWindowHeader };

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

@@ -32,6 +32,14 @@ interface Props {
      * into them; and a product composing its own chrome keeps the icon it has.
      */
     showLabel?: boolean;
+    /**
+     * BOFF-10178 (compact only): keep the source menu inside the VISUAL viewport.
+     * On a phone with the keyboard up the sheet is only as tall as the visual
+     * viewport leaves it (`--assistant-viewport-height`), and the menu opens
+     * upward inside it, so its height is capped to what the sheet can hold and it
+     * scrolls past that. Absent, the menu is exactly what it was.
+     */
+    capMenuHeight?: boolean;
 }
 /**
  * Leading circular "+" attach control in the composer.

package/dist/shared/assistant/ui/composer/AssistantAttachmentButton.js

@@ -9,88 +9,88 @@ import { useCallback as c, useEffect as l, useMemo as u, useRef as d, useState a
 import { Camera as p, FileText as m, FolderOpen as h, ImageIcon as g, Plus as _ } from "lucide-react";
 import { jsx as v, jsxs as y } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/composer/AssistantAttachmentButton.tsx
-var b = "flex size-9 items-center justify-center rounded-full border border-border-subtle bg-bg-elevated text-text-secondary transition-colors hover:bg-bg-sunken hover:text-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong disabled:cursor-not-allowed disabled:text-text-muted disabled:hover:bg-bg-elevated", x = `${b} sm:w-auto sm:gap-1.5 sm:px-3`, S = {
+var b = " max-h-[calc(var(--assistant-viewport-height,100dvh)-10rem)] overflow-y-auto", x = "flex size-9 items-center justify-center rounded-full border border-border-subtle bg-bg-elevated text-text-secondary transition-colors hover:bg-bg-sunken hover:text-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong disabled:cursor-not-allowed disabled:text-text-muted disabled:hover:bg-bg-elevated", S = `${x} sm:w-auto sm:gap-1.5 sm:px-3`, C = {
 	camera: p,
 	gallery: g,
 	documents: m,
 	files: h
-}, C = ({ onFiles: p, onPickerOpen: m, direction: h = "up", canAddMore: g, disabled: C = !1, showLabel: w = !1 }) => {
-	let T = t(), E = d(null), D = d(null), O = d(null), [k, A] = f(!1), j = d(m);
-	j.current = m;
-	let M = u(() => n(r()), []), N = i(a()), P = g || N, F = g ? N ? `${T("composer.attach", "Attach files or photos")} · ${T("composer.connectSource", "Connect a source")}` : T("composer.attach", "Attach files or photos") : T("composer.attachFull", "Attachment limit reached ({{max}})", { max: 5 }), I = w && g && N ? T("composer.connectSource", "Connect a source") : null, L = s(O, () => A(!1));
+}, w = ({ onFiles: p, onPickerOpen: m, direction: h = "up", canAddMore: g, disabled: w = !1, showLabel: T = !1, capMenuHeight: E = !1 }) => {
+	let D = t(), O = d(null), k = d(null), A = d(null), [j, M] = f(!1), N = d(m);
+	N.current = m;
+	let P = u(() => n(r()), []), F = i(a()), I = g || F, L = g ? F ? `${D("composer.attach", "Attach files or photos")} · ${D("composer.connectSource", "Connect a source")}` : D("composer.attach", "Attach files or photos") : D("composer.attachFull", "Attachment limit reached ({{max}})", { max: 5 }), R = T && g && F ? D("composer.connectSource", "Connect a source") : null, z = s(A, () => M(!1));
 	l(() => {
-		if (!k) return;
+		if (!j) return;
 		let e = (e) => {
 			let t = e.target;
-			D.current?.contains(t) || O.current?.contains(t) || A(!1);
+			k.current?.contains(t) || A.current?.contains(t) || M(!1);
 		};
 		return window.addEventListener("mousedown", e), () => {
 			window.removeEventListener("mousedown", e);
 		};
-	}, [k]);
-	let R = c((e) => {
+	}, [j]);
+	let B = c((e) => {
 		p(e.target.files), e.target.value = "";
-	}, [p]), z = c((e) => {
-		let t = E.current;
-		t && (t.accept = e.accept, t.multiple = e.multiple, e.capture ? t.setAttribute("capture", e.capture) : t.removeAttribute("capture"), A(!1), j.current?.(), t.click());
+	}, [p]), V = c((e) => {
+		let t = O.current;
+		t && (t.accept = e.accept, t.multiple = e.multiple, e.capture ? t.setAttribute("capture", e.capture) : t.removeAttribute("capture"), M(!1), N.current?.(), t.click());
 	}, []);
 	return /* @__PURE__ */ y("div", {
 		className: "relative flex-shrink-0",
 		children: [
 			/* @__PURE__ */ v("input", {
-				ref: E,
+				ref: O,
 				type: "file",
 				multiple: !0,
 				className: "hidden",
-				onChange: R,
+				onChange: B,
 				tabIndex: -1,
 				"aria-hidden": "true",
 				"data-testid": "assistant-attach-input"
 			}),
 			/* @__PURE__ */ y("button", {
-				ref: O,
+				ref: A,
 				type: "button",
-				onClick: () => A((e) => !e),
-				disabled: C || !P,
-				title: F,
-				"aria-label": F,
+				onClick: () => M((e) => !e),
+				disabled: w || !I,
+				title: L,
+				"aria-label": L,
 				"aria-haspopup": "menu",
-				"aria-expanded": k,
-				className: I ? x : b,
+				"aria-expanded": j,
+				className: R ? S : x,
 				"data-testid": "assistant-attach",
-				children: [/* @__PURE__ */ v(_, { className: "size-4" }), I ? /* @__PURE__ */ v("span", {
+				children: [/* @__PURE__ */ v(_, { className: "size-4" }), R ? /* @__PURE__ */ v("span", {
 					className: "hidden max-w-[10rem] truncate text-[13px] font-medium leading-tight sm:block",
 					"data-testid": "assistant-attach-label",
-					children: I
+					children: R
 				}) : null]
 			}),
-			k ? /* @__PURE__ */ v(e, {
-				...L,
+			j ? /* @__PURE__ */ v(e, {
+				...z,
 				children: /* @__PURE__ */ y("div", {
-					ref: D,
+					ref: k,
 					role: "menu",
-					"aria-label": T("composer.attachSource", "Attach from"),
-					className: `absolute ${h === "up" ? "bottom-full mb-2" : "top-full mt-2"} left-0 z-30 min-w-44 overflow-hidden rounded-xl border border-border-default bg-bg-elevated py-1 shadow-lg`,
+					"aria-label": D("composer.attachSource", "Attach from"),
+					className: `absolute ${h === "up" ? "bottom-full mb-2" : "top-full mt-2"} left-0 z-30 min-w-44 overflow-hidden rounded-xl border border-border-default bg-bg-elevated py-1 shadow-lg${E ? b : ""}`,
 					"data-testid": "assistant-attach-menu",
-					children: [M.map((e) => {
-						let t = S[e.id];
+					children: [P.map((e) => {
+						let t = C[e.id];
 						return /* @__PURE__ */ y("button", {
 							type: "button",
 							role: "menuitem",
 							disabled: !g,
-							onClick: () => z(e),
+							onClick: () => V(e),
 							className: "flex w-full items-center gap-2.5 px-3 py-2 text-left text-sm text-text-primary transition-colors hover:bg-bg-sunken focus:outline-none focus-visible:bg-bg-sunken disabled:cursor-not-allowed disabled:text-text-muted disabled:hover:bg-transparent",
 							"data-testid": `assistant-attach-source-${e.id}`,
 							children: [/* @__PURE__ */ v(t, {
 								className: "size-4 flex-shrink-0 text-text-secondary",
 								"aria-hidden": "true"
-							}), T(e.labelKey, e.labelFallback)]
+							}), D(e.labelKey, e.labelFallback)]
 						}, e.id);
-					}), /* @__PURE__ */ v(o, { onActivate: () => A(!1) })]
+					}), /* @__PURE__ */ v(o, { onActivate: () => M(!1) })]
 				})
 			}) : null
 		]
 	});
 };
 //#endregion
-export { C as AssistantAttachmentButton };
+export { w as AssistantAttachmentButton };

package/dist/shared/assistant/ui/composer/AssistantComposer.js

@@ -324,7 +324,8 @@ var m = ({ writeAccessDenied: m = !1, onSend: ye, disabled: h = !1, readOnly: be
 									onFiles: R,
 									canAddMore: $e,
 									disabled: S || O,
-									showLabel: !0
+									showLabel: !0,
+									capMenuHeight: !0
 								}),
 								/* @__PURE__ */ f(se, {
 									mode: Se,

package/dist/shared/assistant/ui/useAssistantVisualViewport.d.ts

@@ -0,0 +1,3 @@
+import { RefObject } from 'react';
+/** Publish the visual viewport's height and the keyboard inset on `target` while `enabled`. */
+export declare function useAssistantVisualViewport(target: RefObject<HTMLElement | null>, enabled: boolean): void;

package/dist/shared/assistant/ui/useAssistantVisualViewport.js

@@ -0,0 +1,24 @@
+import { ASSISTANT_KEYBOARD_INSET_VAR as e, ASSISTANT_VIEWPORT_HEIGHT_VAR as t, assistantVisualViewportMetrics as n } from "./assistantOverlayState.js";
+import { useEffect as r } from "react";
+//#region src/shared/assistant/ui/useAssistantVisualViewport.ts
+function i(i, a) {
+	r(() => {
+		if (!a || typeof window > "u") return;
+		let r = i.current, o = window.visualViewport;
+		if (!r || !o) return;
+		let s = () => {
+			let { heightPx: i, keyboardInsetPx: a } = n({
+				layoutHeight: document.documentElement.clientHeight || window.innerHeight,
+				viewportHeight: o.height,
+				viewportOffsetTop: o.offsetTop,
+				scale: o.scale
+			});
+			r.style.setProperty(t, `${i}px`), r.style.setProperty(e, `${a}px`);
+		};
+		return s(), o.addEventListener("resize", s), o.addEventListener("scroll", s), window.addEventListener("resize", s), () => {
+			o.removeEventListener("resize", s), o.removeEventListener("scroll", s), window.removeEventListener("resize", s), r.style.removeProperty(t), r.style.removeProperty(e);
+		};
+	}, [i, a]);
+}
+//#endregion
+export { i as useAssistantVisualViewport };