@burdenoff/fe-libs 2026.1029.8 → 2026.1029.10

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

@@ -18,6 +18,17 @@ export interface AssistantOverlayContextValue {
      */
     panelInsetPx: number;
     keys: AssistantOverlayKeys;
+    /**
+     * BOFF-10177 (N1): let the open panel ask before it is closed. The guard runs
+     * for every request to CLOSE from outside the panel (the launcher, the
+     * shortcut, the toggle event, Escape with focus outside it, `close()`), and
+     * returns true when it took the request, which it then answers itself, by
+     * asking the person and calling `close()` again once they have said yes.
+     * Returns an unregister function. Only the compact panel registers one, so
+     * with none, every path below closes exactly as before. Optional so a host
+     * that builds this value itself keeps compiling.
+     */
+    registerCloseGuard?: (guard: () => boolean) => () => void;
 }
 /** The overlay state in force, or null when no provider is mounted. */
 export declare function useAssistantOverlayOrNull(): AssistantOverlayContextValue | null;

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

@@ -4,134 +4,147 @@ import { assistantPanelOwnsEscape as n } from "./panelOverlays.js";
 import { AssistantPreviewBridgeHost as r } from "../preview/bridgeHost.js";
 import { ASSISTANT_DOCK_WIDTH_VAR as i, ASSISTANT_OVERLAY_DESKTOP_QUERY as a, ASSISTANT_OVERLAY_TOP_VAR as o, ASSISTANT_PANEL_INSET_VAR as s, ASSISTANT_SHEET_BOTTOM_VAR as c, assistantLauncherBottom as l, assistantLauncherRight as u, assistantOverlayClassName as d, assistantOverlayEscapeAction as f, assistantOverlayKeys as p, assistantQuotaKindOf as m, closestAround as h, createAssistantNavigate as g, isAssistantToggleShortcut as _, nextAssistantOpenState as v, publishedAssistantDockWidth as y, publishedAssistantPanelInset as b, readAssistantOverlayFlag as x, requestedAssistantOpenState as S, writeAssistantOverlayFlag as C } from "./assistantOverlayState.js";
 import { useAssistantServerHistory as w } from "../history/useAssistantServerHistory.js";
-import { AIAssistantPanel as T } from "./AIAssistantPanel.js";
-import { createContext as E, useCallback as D, useContext as O, useEffect as k, useMemo as A, useRef as j, useState as M, useSyncExternalStore as N } from "react";
-import { Sparkles as P } from "lucide-react";
-import { jsx as F, jsxs as I } from "react/jsx-runtime";
+import { AssistantCloseGuardContext as T } from "./closeGuard.js";
+import { AIAssistantPanel as E } from "./AIAssistantPanel.js";
+import { createContext as D, useCallback as O, useContext as k, useEffect as A, useMemo as j, useRef as M, useState as N, useSyncExternalStore as P } from "react";
+import { Sparkles as F } from "lucide-react";
+import { jsx as I, jsxs as L } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/AssistantOverlay.tsx
-var L = E(null);
-function R() {
-	return O(L);
-}
+var R = D(null);
 function z() {
-	return O(L)?.dockWidthPx ?? 0;
+	return k(R);
 }
 function B() {
-	return O(L)?.panelInsetPx ?? 0;
+	return k(R)?.dockWidthPx ?? 0;
+}
+function V() {
+	return k(R)?.panelInsetPx ?? 0;
 }
-var V = () => typeof window > "u" ? void 0 : window.sessionStorage, H = () => typeof window > "u" ? void 0 : window.localStorage;
-function U(e) {
+var H = () => typeof window > "u" ? void 0 : window.sessionStorage, U = () => typeof window > "u" ? void 0 : window.localStorage;
+function W(e) {
 	if (typeof window > "u" || typeof window.matchMedia != "function") return () => {};
 	let t = window.matchMedia(a);
 	return t.addEventListener("change", e), () => t.removeEventListener("change", e);
 }
-function W() {
+function G() {
 	return typeof window < "u" && typeof window.matchMedia == "function" && window.matchMedia("(min-width: 640px)").matches;
 }
-function G() {
-	return N(U, W, () => !1);
+function K() {
+	return P(W, G, () => !1);
 }
-function K(t, n) {
-	let r = j(n);
-	k(() => {
+function q(t, n) {
+	let r = M(n);
+	A(() => {
 		r.current = n;
-	}, [n]), k(() => {
+	}, [n]), A(() => {
 		if (!t || typeof window > "u") return;
 		let n = e(t), i = (e) => r.current(m(e), e);
 		return window.addEventListener(n, i), () => window.removeEventListener(n, i);
 	}, [t]);
 }
-var q = () => {};
-function J({ keyPrefix: e, quota: t, children: n }) {
-	let r = A(() => p(e), [e]), [a, o] = M(() => x(V, r.openStorageKey)), [c, l] = M(() => x(H, r.dockStorageKey)), u = D(() => o(!0), []), d = D(() => o(!1), []), f = D(() => o((e) => !e), []), m = D(() => l((e) => !e), []);
-	k(() => {
-		C(V, r.openStorageKey, a);
-	}, [r.openStorageKey, a]), k(() => {
-		C(H, r.dockStorageKey, c);
-	}, [r.dockStorageKey, c]), k(() => {
+var J = () => {};
+function Y({ keyPrefix: e, quota: t, children: n }) {
+	let r = j(() => p(e), [e]), [a, o] = N(() => x(H, r.openStorageKey)), [c, l] = N(() => x(U, r.dockStorageKey)), u = M(null), d = M(a);
+	A(() => {
+		d.current = a;
+	}, [a]);
+	let f = O(() => u.current?.() === !0, []), m = O((e) => (u.current = e, () => {
+		u.current === e && (u.current = null);
+	}), []), h = O(() => o(!0), []), g = O(() => {
+		f() || o(!1);
+	}, [f]), w = O(() => {
+		d.current && f() || o((e) => !e);
+	}, [f]), T = O(() => l((e) => !e), []);
+	A(() => {
+		C(H, r.openStorageKey, a);
+	}, [r.openStorageKey, a]), A(() => {
+		C(U, r.dockStorageKey, c);
+	}, [r.dockStorageKey, c]), A(() => {
 		if (typeof window > "u") return;
 		let e = (e) => {
 			let t = S(e);
-			o((e) => v(e, t));
+			d.current && !v(!0, t) && u.current?.() === !0 || o((e) => v(e, t));
 		};
 		return window.addEventListener(r.toggleEvent, e), () => window.removeEventListener(r.toggleEvent, e);
-	}, [r.toggleEvent]), k(() => {
+	}, [r.toggleEvent]), A(() => {
 		if (typeof document > "u") return;
 		let e = (e) => {
-			_(e) && (e.preventDefault(), o((e) => !e));
+			_(e) && (e.preventDefault(), !(d.current && u.current?.() === !0) && o((e) => !e));
 		};
 		return document.addEventListener("keydown", e), () => document.removeEventListener("keydown", e);
-	}, []), K(t?.product ?? null, t?.onExhausted ?? q);
-	let h = G(), g = y({
+	}, []), q(t?.product ?? null, t?.onExhausted ?? J);
+	let E = K(), D = y({
 		isOpen: a,
 		docked: c,
-		isDesktop: h
-	}), w = b({
+		isDesktop: E
+	}), k = b({
 		isOpen: a,
 		docked: c,
-		isDesktop: h
+		isDesktop: E
 	});
-	k(() => {
+	A(() => {
 		if (typeof document > "u") return;
 		let e = document.documentElement.style;
-		return e.setProperty(i, `${g}px`), () => {
+		return e.setProperty(i, `${D}px`), () => {
 			e.removeProperty(i);
 		};
-	}, [g]), k(() => {
+	}, [D]), A(() => {
 		if (typeof document > "u") return;
 		let e = document.documentElement.style;
-		return e.setProperty(s, `${w}px`), () => {
+		return e.setProperty(s, `${k}px`), () => {
 			e.removeProperty(s);
 		};
-	}, [w]);
-	let T = A(() => ({
+	}, [k]);
+	let P = j(() => ({
 		isOpen: a,
-		open: u,
-		close: d,
-		toggle: f,
+		open: h,
+		close: g,
+		toggle: w,
 		docked: c,
-		toggleDock: m,
-		dockWidthPx: g,
-		panelInsetPx: w,
-		keys: r
+		toggleDock: T,
+		dockWidthPx: D,
+		panelInsetPx: k,
+		keys: r,
+		registerCloseGuard: m
 	}), [
 		a,
-		u,
-		d,
-		f,
-		c,
-		m,
+		h,
 		g,
 		w,
-		r
+		c,
+		T,
+		D,
+		k,
+		r,
+		m
 	]);
-	return /* @__PURE__ */ F(L.Provider, {
-		value: T,
+	return /* @__PURE__ */ I(R.Provider, {
+		value: P,
 		children: n
 	});
 }
-var Y = (e, t) => /* @__PURE__ */ F(T, {
+var X = (e, t) => /* @__PURE__ */ I(E, {
 	...e,
 	...t
 });
-function X(e) {
-	let t = R();
-	return t ? /* @__PURE__ */ F(Z, {
+function Z(e) {
+	let t = z();
+	return t ? /* @__PURE__ */ I(Q, {
 		state: t,
 		...e
 	}) : null;
 }
-function Z({ state: e, panelId: i = "ai-assistant", panelProps: a, renderPanel: s, navigate: p, isShellLessTarget: m, topOffsetPx: _ = 56, launcherIcon: v, launcherBottomInset: y = "1.5rem", showLauncher: b = !0, closeOnEscape: x = !0 }) {
-	let { isOpen: S, close: C, toggle: T, docked: E, toggleDock: D, dockWidthPx: O } = e, j = t();
+function Q({ state: e, panelId: i = "ai-assistant", panelProps: a, renderPanel: s, navigate: p, isShellLessTarget: m, topOffsetPx: _ = 56, launcherIcon: v, launcherBottomInset: y = "1.5rem", showLauncher: b = !0, closeOnEscape: x = !0 }) {
+	let { isOpen: S, close: C, toggle: E, docked: D, toggleDock: O, dockWidthPx: k } = e, M = t();
 	w(a?.serverHistory === !0);
-	let [N, L] = M(!1), R = A(() => p ? g({
+	let [P, R] = N(!1), z = j(() => p ? g({
 		navigate: p,
 		isShellLessTarget: m,
-		isDesktop: W,
-		collapseSheet: () => L(!1),
+		isDesktop: G,
+		collapseSheet: () => R(!1),
 		openInNewTab: (e) => window.open(e, "_blank", "noopener,noreferrer")
 	}) : void 0, [p, m]);
-	k(() => {
+	A(() => {
 		if (!S || !x) return;
 		let e = (e) => {
 			f({
@@ -149,53 +162,56 @@ function Z({ state: e, panelId: i = "ai-assistant", panelProps: a, renderPanel:
 		C,
 		x
 	]);
-	let z = {
+	let B = {
 		panelId: i,
 		visible: !0,
 		onClose: C,
-		docked: E,
-		onToggleDock: D,
-		onNavigate: R,
+		docked: D,
+		onToggleDock: O,
+		onNavigate: z,
 		isShellLessTarget: m
-	}, B = j("overlay.launcher", "AI Assistant"), V = {
+	}, V = M("overlay.launcher", "AI Assistant"), H = {
 		[o]: `${_}px`,
 		[c]: "var(--mobile-tabbar-height, 0px)"
 	};
-	return /* @__PURE__ */ I(r, {
+	return /* @__PURE__ */ L(r, {
 		preview: a?.preview,
-		children: [S && /* @__PURE__ */ I("div", {
+		children: [S && /* @__PURE__ */ L("div", {
 			className: d({
-				expanded: N,
-				docked: E
+				expanded: P,
+				docked: D
 			}),
-			style: V,
+			style: H,
 			"data-testid": "assistant-overlay",
-			children: [/* @__PURE__ */ F("button", {
+			children: [/* @__PURE__ */ I("button", {
 				type: "button",
-				onClick: () => L((e) => !e),
+				onClick: () => R((e) => !e),
 				className: "flex w-full shrink-0 justify-center pt-2 pb-1 sm:hidden",
-				"aria-label": N ? j("sheet.collapse", "Shrink the assistant") : j("sheet.expand", "Expand the assistant"),
-				"aria-expanded": N,
+				"aria-label": P ? M("sheet.collapse", "Shrink the assistant") : M("sheet.expand", "Expand the assistant"),
+				"aria-expanded": P,
 				"data-testid": "assistant-sheet-handle",
-				children: /* @__PURE__ */ F("span", { className: "h-1.5 w-10 rounded-full bg-border-strong" })
-			}), /* @__PURE__ */ F("div", {
+				children: /* @__PURE__ */ I("span", { className: "h-1.5 w-10 rounded-full bg-border-strong" })
+			}), /* @__PURE__ */ I("div", {
 				className: "flex min-h-0 flex-1 flex-col",
-				children: s ? s(z) : Y(a, z)
+				children: /* @__PURE__ */ I(T.Provider, {
+					value: e.registerCloseGuard ?? null,
+					children: s ? s(B) : X(a, B)
+				})
 			})]
-		}), b && /* @__PURE__ */ F("button", {
+		}), b && /* @__PURE__ */ I("button", {
 			type: "button",
-			onClick: T,
-			title: j("overlay.launcherTitle", "AI Assistant ({{shortcut}})", { shortcut: "Ctrl+Shift+A" }),
-			"aria-label": B,
+			onClick: E,
+			title: M("overlay.launcherTitle", "AI Assistant ({{shortcut}})", { shortcut: "Ctrl+Shift+A" }),
+			"aria-label": V,
 			"aria-haspopup": "dialog",
 			"aria-expanded": S,
 			"data-testid": "assistant-fab",
 			style: {
 				bottom: l(y),
-				right: u(O)
+				right: u(k)
 			},
 			className: "fixed z-30 size-14 items-center justify-center rounded-full border border-border-strong bg-[var(--color-accent-soft)] text-action-primary-bg shadow-float transition-colors duration-200 hover:border-action-primary-bg focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-focus-ring)] cursor-pointer " + (S ? "hidden sm:inline-flex" : "inline-flex"),
-			children: v ?? /* @__PURE__ */ F(P, {
+			children: v ?? /* @__PURE__ */ I(F, {
 				className: "size-6",
 				"aria-hidden": "true"
 			})
@@ -203,4 +219,4 @@ function Z({ state: e, panelId: i = "ai-assistant", panelProps: a, renderPanel:
 	});
 }
 //#endregion
-export { X as AssistantOverlay, J as AssistantOverlayProvider, z as useAssistantDockWidth, R as useAssistantOverlayOrNull, B as useAssistantPanelInset, K as useAssistantQuotaExhausted };
+export { Z as AssistantOverlay, Y as AssistantOverlayProvider, B as useAssistantDockWidth, z as useAssistantOverlayOrNull, V as useAssistantPanelInset, q as useAssistantQuotaExhausted };