@coffer-org/plugin-webchat 5.0.0 → 6.0.0

package/dist/{ChatWidget-uAyA3y0W.js → ChatWidget-DFVDexpD.js}

@@ -23959,42 +23959,35 @@ function AgentPicker({ agents, defaultAgentId, selection, onChange }) {
 	if (ladder) {
 		const level = ladder.indexOf(current) + 1;
 		const shown = preview ?? level;
-		const previewRow = preview === null ? void 0 : ladder[preview - 1];
 		const levelName = (row, n) => `${row.label} · ${t("webchat.level", {
 			value: n,
 			max: ladder.length
 		})}`;
-		return /* @__PURE__ */ jsxs("div", {
-			className: "flex min-w-0 items-center gap-1.5",
-			children: [/* @__PURE__ */ jsx("ul", {
-				"aria-label": t("webchat.agentPicker"),
-				className: "flex shrink-0 items-center",
-				onPointerLeave: () => setPreview(null),
-				children: ladder.map((r, i) => {
-					const n = i + 1;
-					return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx("button", {
-						type: "button",
-						...r === current ? { "aria-current": true } : {},
-						"aria-label": levelName(r, n),
-						className: "flex rounded p-1 focus-visible:outline-2 focus-visible:outline-accent",
-						onPointerEnter: () => setPreview(n),
-						onFocus: () => setPreview(n),
-						onBlur: () => setPreview(null),
-						onClick: () => onChange({
-							agentId: r.agentId,
-							presetId: r.presetId
-						}),
-						children: /* @__PURE__ */ jsx(Star, {
-							size: 16,
-							"aria-hidden": true,
-							className: n <= shown ? "fill-yellow-400 text-yellow-400" : "text-border"
-						})
-					}) }, `${r.agentId}/${r.presetId}`);
-				})
-			}), previewRow && /* @__PURE__ */ jsx("span", {
-				className: "min-w-0 truncate text-xs text-muted",
-				children: previewRow.hint || previewRow.label
-			})]
+		return /* @__PURE__ */ jsx("ul", {
+			"aria-label": t("webchat.agentPicker"),
+			className: "flex shrink-0 items-center",
+			onPointerLeave: () => setPreview(null),
+			children: ladder.map((r, i) => {
+				const n = i + 1;
+				return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx("button", {
+					type: "button",
+					...r === current ? { "aria-current": true } : {},
+					"aria-label": levelName(r, n),
+					className: "flex rounded p-1 focus-visible:outline-2 focus-visible:outline-accent",
+					onPointerEnter: () => setPreview(n),
+					onFocus: () => setPreview(n),
+					onBlur: () => setPreview(null),
+					onClick: () => onChange({
+						agentId: r.agentId,
+						presetId: r.presetId
+					}),
+					children: /* @__PURE__ */ jsx(Star, {
+						size: 16,
+						"aria-hidden": true,
+						className: n <= shown ? "fill-yellow-400 text-yellow-400" : "text-border"
+					})
+				}) }, `${r.agentId}/${r.presetId}`);
+			})
 		});
 	}
 	return /* @__PURE__ */ jsxs("div", {
@@ -24294,12 +24287,31 @@ function ChatDropSurface({ children, onFiles, className }) {
 		})]
 	});
 }
-/** What to do with the widget after following a link from a response. On desktop a 380px
-*  panel does not obstruct the page (a darkened modal does, so it collapses into it);
-*  on narrow screens the chat remains expanded so the user does not lose the active
-*  conversation after an in-app navigation. */
-function nextModeAfterNav(wideNav) {
-	return wideNav ? "panel" : "modal";
+/** The states the VIEWPORT offers, ordered from least to most expanded. `panel` — the 380px
+*  floating window — exists only where it does not obstruct the page: on a narrow screen the
+*  widget has exactly two states, the bubble and the full sheet. Every mode transition is a
+*  move along this ladder, so no call site can put the widget into a mode its screen lacks. */
+function chatModes(wide) {
+	return wide ? [
+		"bubble",
+		"panel",
+		"modal"
+	] : ["bubble", "modal"];
+}
+/** Where the widget rests once it is opened — expanded, but as little as the viewport allows.
+*  Also where it returns after following a link from a response: on a wide screen the panel
+*  does not obstruct the page the user just navigated to, while on a narrow one the sheet is
+*  the only visible state, so the active conversation survives the navigation either way. */
+function restingMode(wide) {
+	return chatModes(wide)[1];
+}
+/** One step along the ladder, clamped at both ends: `-1` is what collapse, Esc and a dialog
+*  dismiss do, `+1` is expand. A mode this viewport no longer offers is re-homed by the effect
+*  in the widget, not by stepping — the step always returns a mode from the current ladder. */
+function stepMode(mode, wide, delta) {
+	const ladder = chatModes(wide);
+	const next = ladder.indexOf(mode) + delta;
+	return ladder[Math.min(ladder.length - 1, Math.max(0, next))];
 }
 function ChatWidget() {
 	const { t } = useTranslation();
@@ -24313,20 +24325,22 @@ function ChatWidget() {
 	const [uploadError, setUploadError] = useState(null);
 	const [retryFiles, setRetryFiles] = useState([]);
 	const wide = useMinWidth("sm", 640);
-	const wideNav = useMinWidth("nav", 768);
 	const onChatNavigate = useCallback(() => {
-		setMode(nextModeAfterNav(wideNav));
-	}, [wideNav]);
+		setMode(restingMode(wide));
+	}, [wide]);
 	const expandBtnRef = useRef(null);
 	const prevModeRef = useRef("bubble");
 	useEffect(() => {
 		if (mode !== "modal") return;
 		const onKey = (e) => {
-			if (e.key === "Escape") setMode("panel");
+			if (e.key === "Escape") setMode(stepMode("modal", wide, -1));
 		};
 		window.addEventListener("keydown", onKey);
 		return () => window.removeEventListener("keydown", onKey);
-	}, [mode]);
+	}, [mode, wide]);
+	useEffect(() => {
+		if (!chatModes(wide).includes(mode)) setMode(restingMode(wide));
+	}, [mode, wide]);
 	useEffect(() => {
 		if (mode === "panel" && prevModeRef.current === "modal") expandBtnRef.current?.focus();
 		if (mode !== "modal") setThreadsOpen(false);
@@ -24429,11 +24443,11 @@ function ChatWidget() {
 					onClick: startNew,
 					children: /* @__PURE__ */ jsx(Plus, { size: 16 })
 				}),
-				/* @__PURE__ */ jsx("button", {
+				chatModes(wide).includes("panel") && /* @__PURE__ */ jsx("button", {
 					ref: expandBtnRef,
 					"aria-label": mode === "modal" ? t("webchat.collapse") : t("webchat.expand"),
 					className: "rounded p-1 hover:bg-elevated",
-					onClick: () => setMode(mode === "modal" ? "panel" : "modal"),
+					onClick: () => setMode(stepMode(mode, wide, mode === "modal" ? -1 : 1)),
 					children: mode === "modal" ? /* @__PURE__ */ jsx(Minimize2, { size: 16 }) : /* @__PURE__ */ jsx(Maximize2, { size: 16 })
 				}),
 				/* @__PURE__ */ jsx("button", {
@@ -24489,7 +24503,7 @@ function ChatWidget() {
 	});
 	if (mode === "bubble") return /* @__PURE__ */ jsx("button", {
 		"aria-label": t("webchat.open"),
-		onClick: () => setMode(wide ? "panel" : "modal"),
+		onClick: () => setMode(restingMode(wide)),
 		className: "fixed bottom-20 right-4 z-40 grid h-14 w-14 place-items-center rounded-full bg-accent text-white shadow-lg nav:bottom-4",
 		children: /* @__PURE__ */ jsx(MessageCircle, { size: 24 })
 	});
@@ -24501,7 +24515,7 @@ function ChatWidget() {
 	return /* @__PURE__ */ jsxs(Dialog, {
 		open: true,
 		modal: false,
-		onOpenChange: (open) => !open && setMode("panel"),
+		onOpenChange: (open) => !open && setMode(stepMode("modal", wide, -1)),
 		children: [/* @__PURE__ */ jsx("div", {
 			"data-chat-backdrop": true,
 			"aria-hidden": "true",
@@ -24536,4 +24550,4 @@ function ChatWidget() {
 	});
 }
 //#endregion
-export { ChatWidget, ChatWidget as default, nextModeAfterNav };
+export { ChatWidget, ChatWidget as default, chatModes, restingMode, stepMode };

package/dist/schema.js

@@ -4354,6 +4354,13 @@ function wrapKey(key, opts, meta) {
 			editor: opts.editor
 		}
 	};
+	if (opts.activate) m = {
+		...m,
+		hints: {
+			...m.hints,
+			activate: opts.activate
+		}
+	};
 	if (opts.span !== void 0) m = {
 		...m,
 		hints: {
@@ -4754,6 +4761,7 @@ function resolveUnits(u) {
 function normalizeOpts(rawIn) {
 	const raw = rawIn;
 	if (raw["view"] !== void 0) throw new Error("[normalizeOpts] `view` is gone — presentational options live in `ui: {}` (see CLAUDE.md § field author options and the field-types skill).");
+	if (raw.ui?.["agent"] !== void 0) throw new Error("[normalizeOpts] `agent` is not presentation — declare it at the top level of the field call, not in `ui: {}`.");
 	const r = raw.rules ?? {};
 	const v = raw.ui ?? {};
 	const config = {};
@@ -4790,7 +4798,8 @@ function normalizeOpts(rawIn) {
 		emphasis: v.emphasis,
 		noLabel: v.noLabel,
 		role: v.role,
-		editor: v.editor
+		editor: v.editor,
+		activate: v.activate
 	};
 	return Object.fromEntries(Object.entries(result).filter(([, val]) => val !== void 0));
 }
@@ -9542,10 +9551,11 @@ var field = new Proxy({}, {
 	has: (_t, k) => k in composedField()
 });
 function toClient(field) {
-	const { kind, label, required, prim, hints, options, strict, relation, json, hidden, derived, parts, cache } = field;
+	const { kind, label, agent, required, prim, hints, options, strict, relation, json, hidden, derived, parts, cache } = field;
 	return {
 		kind,
 		label,
+		...agent !== void 0 && { agent },
 		required,
 		prim,
 		hints,
@@ -9952,6 +9962,7 @@ function materialize(decl, name) {
 	const base = {
 		kind: type.kind,
 		label: opts.label ?? "",
+		...opts.agent !== void 0 && { agent: opts.agent },
 		required,
 		prim: type.prim,
 		column: built.column,
@@ -9995,6 +10006,7 @@ function collectionGroup(key, opts, parts, collectionView) {
 		multiple: true,
 		required: opts.required ?? false,
 		label: opts.label ?? key,
+		...opts.agent !== void 0 && { agent: opts.agent },
 		display: "wrap",
 		kind: collectionView,
 		fields: rowFields

package/dist/web.js

@@ -11,7 +11,7 @@ import { definePluginUI } from "@coffer-org/web-ui";
 var ui_default = definePluginUI({ slots: [{
 	slot: "overlay",
 	id: "webchat",
-	load: () => import("./ChatWidget-uAyA3y0W.js")
+	load: () => import("./ChatWidget-DFVDexpD.js")
 }] });
 //#endregion
 export { ui_default as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffer-org/plugin-webchat",
-  "version": "5.0.0",
+  "version": "6.0.0",
   "type": "module",
   "engines": {
     "node": ">=24"
@@ -27,8 +27,8 @@
     "test:ui": "vitest run --root ."
   },
   "dependencies": {
-    "@coffer-org/sdk": "^5.0.0",
-    "@coffer-org/server": "^5.0.0",
+    "@coffer-org/sdk": "^6.0.0",
+    "@coffer-org/server": "^6.0.0",
     "lucide-react": "^1.17.0",
     "react-markdown": "^10.1.0",
     "remark-gfm": "^4.0.1"