@deepseek-ai/dsh-client-ui-primitives 0.2.1-alpha.2 → 0.2.1-alpha.3

package/lib/index.js

@@ -20,15 +20,15 @@ import css$13 from "./ShortcutKeys.module.css";
 import css$14 from "./MenuSurface.module.css";
 import css$15 from "./Menu.module.css";
 import css$16 from "./MenuGroup.module.css";
-import css$17 from "./Tooltip.module.css";
-import css$18 from "./HoverCard.module.css";
-import css$19 from "./Modal.module.css";
-import css$20 from "./RiskConfirmation.module.css";
-import css$21 from "./ConnectionIndicator.module.css";
-import css$22 from "./FileTypeIcon.module.css";
+import css$17 from "./HoverCard.module.css";
+import css$18 from "./Modal.module.css";
+import css$19 from "./RiskConfirmation.module.css";
+import css$20 from "./ConnectionIndicator.module.css";
+import css$21 from "./FileTypeIcon.module.css";
 import { siAliexpress, siApple, siBaidu, siBilibili, siCsdn, siDuckduckgo, siEbay, siFacebook, siGithub, siGitlab, siGoogle, siInstagram, siJuejin, siMdnwebdocs, siNetflix, siNpm, siPypi, siQq, siQuora, siReddit, siSinaweibo, siSpotify, siStackoverflow, siTaobao, siTelegram, siTiktok, siV2ex, siWechat, siWhatsapp, siWikipedia, siX, siYcombinator, siYoutube, siZhihu } from "simple-icons";
-import css$23 from "./user-text.module.css";
+import css$22 from "./user-text.module.css";
 import markdownCss from "./markdown/MarkdownText.module.css";
+import css$23 from "./Tooltip.module.css";
 import css$24 from "./Toast.module.css";
 import css$25 from "./settings-form/SettingsForm.module.css";
 import css$26 from "./settings-form/fields.module.css";
@@ -4646,396 +4646,176 @@ async function writeClipboard(text) {
 	}
 }
 //#endregion
-//#region lib/types/input-modality.js
-/**
-* Document-wide input tracking shared by tooltips and focus-ring styles.
-* Tooltips follow the last input; rings follow navigation or a key followed by
-* focus on a different control. Modifiers and refocusing alone keep rings silent.
-* Module-level listeners live for the document lifetime; Node imports are inert.
-*/
-/** Modality values published on the document element. */
-const INPUT_MODALITY = {
-	pointer: "pointer",
-	keyboard: "keyboard"
-};
-/** Attribute carrying whether focus navigation last owned focus. */
-const INPUT_MODALITY_ATTRIBUTE = "data-input-modality";
-const FOCUS_NAVIGATION = new Set([
-	"Tab",
-	"Home",
-	"End",
-	"PageUp",
-	"PageDown"
-]);
-let pointer = false;
-let pointerOwnsFocus = false;
-let keyFocusOrigin;
-function publish() {
-	document.documentElement.setAttribute(INPUT_MODALITY_ATTRIBUTE, pointerOwnsFocus ? INPUT_MODALITY.pointer : INPUT_MODALITY.keyboard);
-}
-/**
-* Whether the last input came from a pointer, independently of ring visibility.
-* @returns True after pointer input; false after any key.
-*/
-function pointerModality() {
-	return pointer;
-}
-if (typeof window !== "undefined") {
-	window.addEventListener("pointerdown", () => {
-		pointer = true;
-		pointerOwnsFocus = true;
-		keyFocusOrigin = void 0;
-		publish();
-	}, true);
-	window.addEventListener("keydown", (event) => {
-		pointer = false;
-		if (event.isComposing) {
-			keyFocusOrigin = void 0;
-			return;
-		}
-		keyFocusOrigin = event.composedPath()[0];
-		if (!FOCUS_NAVIGATION.has(event.key) && !event.key.startsWith("Arrow")) return;
-		pointerOwnsFocus = false;
-		publish();
-	}, true);
-	window.addEventListener("focusin", (event) => {
-		if (keyFocusOrigin === void 0 || event.composedPath()[0] === keyFocusOrigin) return;
-		keyFocusOrigin = void 0;
-		if (!pointerOwnsFocus) return;
-		pointerOwnsFocus = false;
-		publish();
-	}, true);
-	window.addEventListener("blur", () => {
-		keyFocusOrigin = void 0;
+//#region lib/types/HoverCardGroup.js
+/** Private coordination shared only by opted-in HoverCards inside one mounted group. */
+const HoverCardGroupContext = createContext(null);
+/**
+* Share first-display dwell across a list and its active portal, including the card's existing pointer grace.
+* @param props.children - list contents, including opted-in HoverCards.
+* @param props.className - classes for the physical list container.
+* @returns the list container and its private hover coordinator.
+*/
+function HoverCardGroup({ children, className }) {
+	const [group] = useState(() => {
+		let pointer = "outside";
+		let warm = false;
+		let active = null;
+		return {
+			isWarm: () => warm,
+			enter: (overCard) => {
+				pointer = overCard ? "card" : "list";
+				if (overCard) warm = true;
+			},
+			leave: () => {
+				pointer = "outside";
+				if (active === null) warm = false;
+			},
+			containsCard: (target) => target instanceof Node && active !== null && active.element.contains(target),
+			shown: (owner, dismiss, element) => {
+				if (pointer === "card") {
+					pointer = "outside";
+					warm = false;
+				}
+				if (pointer === "list") warm = true;
+				const previous = active;
+				active = {
+					owner,
+					dismiss,
+					element
+				};
+				if (previous !== null && previous.owner !== owner) previous.dismiss();
+			},
+			release: (owner) => {
+				if (active?.owner !== owner) return;
+				active = null;
+				if (pointer !== "list") {
+					pointer = "outside";
+					warm = false;
+				}
+			}
+		};
+	});
+	return jsx(HoverCardGroupContext.Provider, {
+		value: group,
+		children: jsx("div", {
+			className,
+			onPointerOverCapture: (event) => {
+				const overCard = group.containsCard(event.target);
+				if (event.currentTarget.contains(event.target) || overCard) group.enter(overCard);
+			},
+			onPointerOutCapture: (event) => {
+				const fromGroup = event.currentTarget.contains(event.target) || group.containsCard(event.target);
+				const intoGroup = event.relatedTarget instanceof Node && event.currentTarget.contains(event.relatedTarget) || group.containsCard(event.relatedTarget);
+				if (fromGroup && !intoGroup) group.leave();
+			},
+			children
+		})
 	});
 }
 //#endregion
-//#region lib/types/Tooltip.js
-/** Anchor-preserving tooltips; an optional body portal escapes clipping containers and stacking contexts that cap the bubble's z-index. */
-/**
-* Suppression channel for enclosing tooltip and hover-card anchors: a visible
-* tooltip within an anchor withdraws the enclosing preview while its bubble is shown.
-*/
-const TooltipSuppression = createContext(null);
+//#region lib/types/HoverCard.js
+/** Preview opacity transition and retained lifetime during dismissal. */
+const PREVIEW_FADE_MS = 100;
+const PREVIEW_MAX_HEIGHT = 420;
+const PREVIEW_INSET = 24;
+const INLINE_PREVIEW_WIDTH = 300;
+const ANCHOR_GAP = 8;
+const VIEWPORT_MARGIN = 8;
 /**
-* Attach a hover/focus tooltip to an anchor element.
-* @param props.label - bubble text, or a resolver evaluated only while visible; an empty string shows only shortcut keys.
-* @param props.shortcutKeys - effective key labels rendered as platform-formatted keycaps after optional text.
-* @param props.side - placement relative to the anchor (default 'right').
-* @param props.align - horizontal anchor-edge alignment for 'bottom'/'top' bubbles: 'end' pins
-* the bubble's right edge to the anchor's (for anchors beside other hover surfaces the centered
-* bubble would overlap); default 'center'. Ignored for side 'right'.
-* @param props.portal - render the bubble under document.body, so an ancestor's clipping or its
-* stacking context (which confines the bubble's z-index to that context) cannot hide it.
-* @param props.delayMs - hover delay in milliseconds (default 0).
-* @param props.focusDelayMs - keyboard focus delay in milliseconds (default 0); blur, click,
-* mouse leave, disabling, and unmount cancel a pending show.
-* @param props.gap - anchor-to-bubble distance in pixels for 'bottom'/'top' bubbles (default 8);
-* ignored for side 'right'.
-* @param props.disabled - suppress the bubble while true; the anchor renders identically so
-* toggling never remounts it (which would cut its CSS transitions).
-* @param props.maxWidth - bubble width cap in pixels, for labels long enough that the default
-* half-viewport cap would render a slab wider than the surface the anchor sits on.
-* @param props.openOnClick - clicking also pins the bubble for reading; another click, Escape,
-* Tab, or an outside pointerdown dismisses it. Defaults to false for ordinary action tooltips.
-* @param props.children - a single anchor element; its own ref (callback or object) is forwarded alongside the tooltip's.
-* @returns the cloned anchor plus a fixed-position bubble, optionally portaled to the body.
-* The bubble stays hidden until ResizeObserver supplies its size for viewport fitting; clicking the
-* anchor dismisses the bubble unless openOnClick is enabled, and focus arriving after a pointer
-* interaction (a closing menu refocusing its trigger) never raises it.
+* Render an anchor with a hover-triggered preview card independently of nested tooltips.
+* @param props.anchor - the hover target (rendered in place inside a wrapper span).
+* @param props.content - card content; the pointer may rest on it, so it is
+* readable and selectable, but it carries no dismissal affordance of its own.
+* @param props.openDelayMs - hover dwell before the card shows (default 500).
+* @param props.variant - compact card beside the anchor, or a preview above/below it
+* with 24px side insets, a 420px height cap, frame-top clearance, and 100ms opacity transitions.
+* @param props.widthAnchorRef - optional element whose width and horizontal position size the preview.
+* @param props.inline - keep the anchor in prose; show a contained preview on hover or keyboard focus.
+* @param props.disabled - suppress opening; turning true dismisses an open card.
+* @param props.grouped - share first-display dwell across the surrounding list and active portal.
+* Group replacement removes the previous card immediately, including a fading preview.
+* @param props.copyText - optional primary value copied by activation and
+* included in the card's accessible name.
+* @param props.copyLabel - localized accessible activation-label prefix.
+* @param props.copiedLabel - localized visible success label.
+* @returns anchor wrapper with the conditional portaled card.
 */
-function Tooltip({ label, shortcutKeys, side = "right", align = "center", delayMs = 0, focusDelayMs = 0, gap = 8, disabled = false, portal = false, maxWidth, openOnClick = false, children }) {
-	const id = useId();
-	const [pinned, setPinned] = useState(false);
-	const anchor = useRef(null);
-	const childRef = children.ref;
-	const mergedRef = useCallback((el) => {
-		anchor.current = el;
-		if (typeof childRef === "function") childRef(el);
-		else if (childRef != null) childRef.current = el;
-	}, [childRef]);
+function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, grouped = false, copyText, copyLabel, copiedLabel, variant = "compact", widthAnchorRef, inline = false }) {
+	const rootRef = useRef(null);
+	const cardRef = useRef(null);
+	const timerRef = useRef(null);
+	const copyTimerRef = useRef(null);
+	const copyHeightRef = useRef(null);
+	const copyEpochRef = useRef(0);
+	const copyingRef = useRef(false);
+	const mountedRef = useRef(true);
+	const [phase, setPhase] = useState("closed");
+	const open = phase !== "closed";
+	const closing = phase === "closing";
 	const [pos, setPos] = useState(null);
-	const bubble = useRef(null);
-	const resolvedLabel = pos === null ? null : typeof label === "function" ? label() : label;
-	const y = pos === null ? 0 : side === "right" ? pos.top + (pos.bottom - pos.top) / 2 : side === "top" ? pos.top - gap : pos.bottom + gap;
-	const showTimer = useRef(null);
-	const triggers = useRef({
-		hover: false,
-		focus: false
-	});
-	const suppressAncestors = useContext(TooltipSuppression);
-	const [suppressed, setSuppressed] = useState(false);
-	const announce = useCallback((active) => {
-		suppressAncestors?.(active);
-	}, [suppressAncestors]);
-	const visible = pos !== null && !disabled;
-	useEffect(() => {
-		const el = bubble.current;
-		if (pos === null || !visible || suppressed || el === null) return;
-		const edgeMargin = 12;
-		let size;
-		let placement = side;
-		const fit = () => {
-			if (size === void 0) return;
-			const { inlineSize: width, blockSize: height } = size;
-			const offset = side === "right" ? 0 : align === "end" ? width : width / 2;
-			const left = Math.max(edgeMargin, Math.min(pos.x - offset, window.innerWidth - edgeMargin - width));
-			const fitsBelow = pos.bottom + gap + height <= window.innerHeight - edgeMargin;
-			const fitsAbove = pos.top - gap - height >= edgeMargin;
-			if (placement === "bottom" && !fitsBelow && fitsAbove) placement = "top";
-			else if (placement === "top" && !fitsAbove && fitsBelow) placement = "bottom";
-			el.style.left = `${left + offset}px`;
-			el.style.top = `${placement === "right" ? (pos.top + pos.bottom) / 2 : placement === "top" ? pos.top - gap : pos.bottom + gap}px`;
-			el.dataset.side = placement;
-			el.style.visibility = "visible";
-		};
-		const observer = new ResizeObserver((entries) => {
-			size = entries[0]?.borderBoxSize[0];
-			fit();
-		});
-		observer.observe(el, { box: "border-box" });
-		window.addEventListener("resize", fit);
+	const positioned = pos !== null;
+	const [copied, setCopied] = useState(false);
+	const parentGroup = useContext(HoverCardGroupContext);
+	const group = grouped ? parentGroup : null;
+	const [groupOwner] = useState(() => Symbol("hover-card"));
+	const clearCopied = useCallback(() => {
+		if (copyTimerRef.current !== null) {
+			clearTimeout(copyTimerRef.current);
+			copyTimerRef.current = null;
+		}
+		copyHeightRef.current = null;
+		setCopied(false);
+	}, []);
+	const close = useCallback(() => {
+		copyEpochRef.current += 1;
+		clearCopied();
+		setPhase((current) => variant === "preview" && current !== "closed" ? "closing" : "closed");
+	}, [clearCopied, variant]);
+	const { arm: armClose, cancel: cancelClose } = usePointerGrace(close);
+	const clearTimer = useCallback(() => {
+		if (timerRef.current !== null) {
+			clearTimeout(timerRef.current);
+			timerRef.current = null;
+		}
+	}, []);
+	const dismissImmediately = useCallback(() => {
+		clearTimer();
+		cancelClose();
+		copyEpochRef.current += 1;
+		clearCopied();
+		setPhase("closed");
+	}, [
+		clearTimer,
+		cancelClose,
+		clearCopied
+	]);
+	const groupVisible = open && positioned;
+	useLayoutEffect(() => {
+		if (!groupVisible || group === null) return;
+		group.shown(groupOwner, dismissImmediately, cardRef.current);
 		return () => {
-			observer.disconnect();
-			window.removeEventListener("resize", fit);
+			group.release(groupOwner);
 		};
 	}, [
-		align,
-		gap,
-		pos,
-		side,
-		suppressed,
-		visible
+		group,
+		groupOwner,
+		groupVisible,
+		dismissImmediately
 	]);
 	useEffect(() => {
-		announce(visible);
+		if (!closing) return;
+		const timer = setTimeout(() => {
+			setPhase("closed");
+		}, PREVIEW_FADE_MS);
 		return () => {
-			announce(false);
+			clearTimeout(timer);
 		};
-	}, [announce, visible]);
-	const cancelShow = useCallback(() => {
-		if (showTimer.current === null) return;
-		clearTimeout(showTimer.current);
-		showTimer.current = null;
-	}, []);
+	}, [closing]);
 	useEffect(() => {
-		if (pinned && (disabled || !openOnClick)) setPinned(false);
-		if (disabled) {
-			cancelShow();
-			triggers.current = {
-				hover: false,
-				focus: false
-			};
-			setPos(null);
-		}
-		return cancelShow;
-	}, [
-		cancelShow,
-		disabled,
-		openOnClick,
-		pinned
-	]);
-	const show = () => {
-		if (disabled) return;
-		const el = anchor.current;
-		/* v8 ignore next -- the ref is attached by event time: events fire on the cloned anchor. */
-		if (el === null) return;
-		const r = el.getBoundingClientRect();
-		setPos({
-			x: side === "right" ? r.right + 10 : align === "end" ? r.right : r.left + r.width / 2,
-			top: r.top,
-			bottom: r.bottom
-		});
-		announce(true);
-	};
-	const showAfterDelay = (delay) => {
-		cancelShow();
-		if (delay <= 0) {
-			show();
-			return;
-		}
-		showTimer.current = setTimeout(() => {
-			showTimer.current = null;
-			show();
-		}, delay);
-	};
-	const withdraw = useCallback(() => {
-		setPinned(false);
-		setPos(null);
-		announce(false);
-	}, [announce]);
-	const hide = () => {
-		cancelShow();
-		if (!triggers.current.hover && !triggers.current.focus && !pinned) withdraw();
-	};
-	const dismiss = useCallback(() => {
-		cancelShow();
-		triggers.current = {
-			hover: false,
-			focus: false
-		};
-		withdraw();
-	}, [cancelShow, withdraw]);
-	useDismissOnOutsidePointer(anchor, openOnClick && visible, dismiss, bubble);
-	useEffect(() => {
-		if (!openOnClick || !visible) return;
-		const onKeyDown = (event) => {
-			if (event.key !== "Escape" && event.key !== "Tab") return;
-			if (event.key === "Escape") {
-				event.preventDefault();
-				event.stopPropagation();
-			}
-			dismiss();
-		};
-		document.addEventListener("keydown", onKeyDown, true);
-		return () => {
-			document.removeEventListener("keydown", onKeyDown, true);
-		};
-	}, [
-		dismiss,
-		openOnClick,
-		visible
-	]);
-	const content = visible && !suppressed && jsxs("span", {
-		ref: bubble,
-		id: openOnClick ? id : void 0,
-		className: css$17.bubble,
-		"data-side": side,
-		"data-portal": portal || void 0,
-		"data-pinned": pinned || void 0,
-		"data-align": align,
-		"data-has-shortcut": shortcutKeys?.length ? true : void 0,
-		style: {
-			left: pos.x,
-			top: y,
-			visibility: "hidden",
-			...maxWidth === void 0 ? {} : { maxWidth }
-		},
-		role: "tooltip",
-		"aria-label": shortcutKeys?.length ? [resolvedLabel, shortcutKeys.join(" ")].filter(Boolean).join(" ") : void 0,
-		children: [resolvedLabel && jsx("span", {
-			className: css$17.label,
-			children: resolvedLabel
-		}), shortcutKeys !== void 0 && shortcutKeys.length > 0 && jsx(ShortcutKeys, {
-			keys: shortcutKeys,
-			variant: "tooltip"
-		})]
-	});
-	return jsxs(TooltipSuppression.Provider, {
-		value: setSuppressed,
-		children: [cloneElement(children, {
-			ref: mergedRef,
-			"aria-describedby": openOnClick && visible ? [children.props["aria-describedby"], id].filter(Boolean).join(" ") : children.props["aria-describedby"],
-			onMouseEnter: (e) => {
-				children.props.onMouseEnter?.(e);
-				triggers.current.hover = true;
-				showAfterDelay(delayMs);
-			},
-			onMouseLeave: (e) => {
-				children.props.onMouseLeave?.(e);
-				triggers.current.hover = false;
-				cancelShow();
-				if (!pinned) withdraw();
-			},
-			onClick: (e) => {
-				children.props.onClick?.(e);
-				triggers.current.focus = false;
-				cancelShow();
-				if (openOnClick && !disabled && !pinned) {
-					setPinned(true);
-					show();
-				} else withdraw();
-			},
-			onFocus: (e) => {
-				children.props.onFocus?.(e);
-				if (pointerModality()) return;
-				triggers.current.focus = true;
-				showAfterDelay(focusDelayMs);
-			},
-			onBlur: (e) => {
-				children.props.onBlur?.(e);
-				triggers.current.focus = false;
-				hide();
-			}
-		}), portal ? content !== false && createPortal(content, document.body) : content]
-	});
-}
-//#endregion
-//#region lib/types/HoverCard.js
-/** Preview opacity transition and retained lifetime during dismissal. */
-const PREVIEW_FADE_MS = 100;
-const PREVIEW_MAX_HEIGHT = 420;
-const PREVIEW_INSET = 24;
-const INLINE_PREVIEW_WIDTH = 300;
-const ANCHOR_GAP = 8;
-const VIEWPORT_MARGIN = 8;
-/**
-* Render an anchor with a hover-triggered preview card, hidden while a tooltip within the anchor is visible.
-* @param props.anchor - the hover target (rendered in place inside a wrapper span).
-* @param props.content - card content; the pointer may rest on it, so it is
-* readable and selectable, but it carries no dismissal affordance of its own.
-* @param props.openDelayMs - hover dwell before the card shows (default 500).
-* @param props.variant - compact card beside the anchor, or a preview above/below it
-* with 24px side insets, a 420px height cap, frame-top clearance, and 100ms opacity transitions.
-* @param props.widthAnchorRef - optional element whose width and horizontal position size the preview.
-* @param props.inline - keep the anchor in prose; show a contained preview on hover or keyboard focus.
-* @param props.disabled - suppress opening; turning true dismisses an open card.
-* @param props.copyText - optional primary value copied by activation and
-* included in the card's accessible name.
-* @param props.copyLabel - localized accessible activation-label prefix.
-* @param props.copiedLabel - localized visible success label.
-* @returns anchor wrapper with the conditional portaled card.
-*/
-function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyText, copyLabel, copiedLabel, variant = "compact", widthAnchorRef, inline = false }) {
-	const rootRef = useRef(null);
-	const cardRef = useRef(null);
-	const timerRef = useRef(null);
-	const copyTimerRef = useRef(null);
-	const copyHeightRef = useRef(null);
-	const copyEpochRef = useRef(0);
-	const copyingRef = useRef(false);
-	const mountedRef = useRef(true);
-	const [phase, setPhase] = useState("closed");
-	const open = phase !== "closed";
-	const closing = phase === "closing";
-	const [pos, setPos] = useState(null);
-	const positioned = pos !== null;
-	const [copied, setCopied] = useState(false);
-	const [suppressed, setSuppressed] = useState(false);
-	const clearCopied = useCallback(() => {
-		if (copyTimerRef.current !== null) {
-			clearTimeout(copyTimerRef.current);
-			copyTimerRef.current = null;
-		}
-		copyHeightRef.current = null;
-		setCopied(false);
-	}, []);
-	const close = useCallback(() => {
-		copyEpochRef.current += 1;
-		clearCopied();
-		setPhase((current) => variant === "preview" && current !== "closed" ? "closing" : "closed");
-	}, [clearCopied, variant]);
-	const { arm: armClose, cancel: cancelClose } = usePointerGrace(close);
-	const clearTimer = () => {
-		if (timerRef.current !== null) {
-			clearTimeout(timerRef.current);
-			timerRef.current = null;
-		}
-	};
-	useEffect(() => {
-		if (!closing) return;
-		const timer = setTimeout(() => {
-			setPhase("closed");
-		}, PREVIEW_FADE_MS);
-		return () => {
-			clearTimeout(timer);
-		};
-	}, [closing]);
-	useEffect(() => {
-		if (!disabled) return;
-		clearTimer();
-		cancelClose();
-		close();
+		if (!disabled) return;
+		clearTimer();
+		cancelClose();
+		close();
 	}, [
 		disabled,
 		cancelClose,
@@ -5146,7 +4926,7 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 		inline
 	]);
 	useLayoutEffect(() => {
-		if (!open || pos === null || variant === "preview" || inline || suppressed) return;
+		if (!open || pos === null || variant === "preview" || inline) return;
 		/* v8 ignore next -- the card is mounted whenever pos is set, so the ref is attached here. */
 		const h = cardRef.current?.offsetHeight ?? 0;
 		if (pos.top + h > window.innerHeight - VIEWPORT_MARGIN) setPos({
@@ -5157,8 +4937,7 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 		open,
 		pos,
 		variant,
-		inline,
-		suppressed
+		inline
 	]);
 	const copy = async (text) => {
 		if (copied || copyingRef.current) return;
@@ -5180,9 +4959,9 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 		cancelClose();
 		close();
 	};
-	const card = open && pos !== null && !suppressed && jsx("div", {
+	const card = open && pos !== null && jsx("div", {
 		ref: cardRef,
-		className: clsx(css$18.card, variant === "preview" && css$18.preview, inline && css$18.media, copyable && css$18.copyable, copied && css$18.feedback),
+		className: clsx(css$17.card, variant === "preview" && css$17.preview, inline && css$17.media, copyable && css$17.copyable, copied && css$17.feedback),
 		"data-closing": closing || void 0,
 		style: {
 			...pos,
@@ -5205,14 +4984,14 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 			copy(copyText);
 		} : void 0,
 		children: copied ? jsx("span", {
-			className: css$18.copied,
+			className: css$17.copied,
 			"aria-hidden": "true",
 			children: copiedLabel
 		}) : content
 	});
 	return jsxs("span", {
 		ref: rootRef,
-		className: clsx(css$18.root, inline && css$18.inline),
+		className: clsx(css$17.root, inline && css$17.inline),
 		onFocus: inline ? (event) => {
 			if (!disabled && event.target.matches(":focus-visible")) {
 				cancelClose();
@@ -5234,7 +5013,8 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 				return;
 			}
 			clearTimer();
-			timerRef.current = setTimeout(() => {
+			if (group?.isWarm()) setPhase("open");
+			else timerRef.current = setTimeout(() => {
 				setPhase("open");
 			}, openDelayMs);
 		},
@@ -5245,12 +5025,9 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 		onPointerDownCapture: dismissFromAnchor,
 		onClickCapture: dismissFromAnchor,
 		children: [
-			jsx(TooltipSuppression.Provider, {
-				value: setSuppressed,
-				children: anchor
-			}),
-			open && !suppressed && copyable && jsx("span", {
-				className: css$18.status,
+			anchor,
+			open && copyable && jsx("span", {
+				className: css$17.status,
 				role: "status",
 				children: copied ? copiedLabel : ""
 			}),
@@ -5285,11 +5062,11 @@ function Modal({ open, onClose, title, closeLabel, description, children, footer
 	useModalLayer(dialog, open, onClose);
 	if (!open) return null;
 	return createPortal(jsxs("div", {
-		className: css$19.root,
+		className: css$18.root,
 		role: "presentation",
 		onKeyDownCapture,
 		children: [jsx("div", {
-			className: css$19.mask,
+			className: css$18.mask,
 			style: backdropBlur ? void 0 : { backdropFilter: "none" },
 			"aria-hidden": "true",
 			onClick: onClose
@@ -5297,37 +5074,37 @@ function Modal({ open, onClose, title, closeLabel, description, children, footer
 			ref: dialog,
 			tabIndex: -1,
 			"data-shortcut-modal": shortcutModal,
-			className: clsx(css$19.dialog, className),
+			className: clsx(css$18.dialog, className),
 			role: "dialog",
 			"aria-modal": "true",
 			"aria-label": title,
 			children: headless ? children : jsxs(Fragment, { children: [jsxs("div", {
-				className: clsx(css$19.content, contentClassName),
+				className: clsx(css$18.content, contentClassName),
 				children: [
 					jsxs("div", {
-						className: css$19.header,
+						className: css$18.header,
 						children: [jsx("h2", {
-							className: css$19.title,
+							className: css$18.title,
 							children: title
 						}), jsx("button", {
 							type: "button",
-							className: css$19.close,
+							className: css$18.close,
 							"aria-label": closeLabel,
 							onClick: onClose,
 							children: jsx(IconCloseOutlineRegular, { size: 14 })
 						})]
 					}),
 					description !== void 0 && description !== "" && jsx("p", {
-						className: css$19.description,
+						className: css$18.description,
 						children: description
 					}),
 					children !== void 0 && jsx("div", {
-						className: css$19.body,
+						className: css$18.body,
 						children
 					})
 				]
 			}), footer !== void 0 && jsx("div", {
-				className: css$19.footer,
+				className: css$18.footer,
 				children: footer
 			})] })
 		})]
@@ -5349,28 +5126,28 @@ function RiskConfirmation({ open, title, description, acknowledgeLabel, cancelLa
 		onClose: onCancel,
 		title,
 		closeLabel,
-		className: css$20.confirmation ?? "",
-		contentClassName: css$20.confirmationContent ?? "",
+		className: css$19.confirmation ?? "",
+		contentClassName: css$19.confirmationContent ?? "",
 		footer: jsxs(Fragment, { children: [jsx(Button, {
 			variant: "outline",
-			className: css$20.modalAction,
+			className: css$19.modalAction,
 			onClick: onCancel,
 			children: cancelLabel
 		}), jsx(Button, {
 			variant: "primary",
-			className: css$20.confirmAction,
+			className: css$19.confirmAction,
 			disabled: disabled || !acknowledged,
 			onClick: onConfirm,
 			children: confirmLabel
 		})] }),
 		children: [jsxs("div", {
-			className: css$20.warning,
+			className: css$19.warning,
 			children: [jsx(IconWarningOutlineRegular, {
 				size: 18,
-				className: css$20.warningIcon
+				className: css$19.warningIcon
 			}), jsx("p", { children: description })]
 		}), jsxs("label", {
-			className: css$20.acknowledgement,
+			className: css$19.acknowledgement,
 			children: [jsx("input", {
 				type: "checkbox",
 				checked: acknowledged,
@@ -5418,44 +5195,44 @@ function ConnectionIndicator({ state, disconnectedLabel, connectingLabel, recove
 		};
 	}, [state, rendered]);
 	if (rendered === void 0) return null;
-	const leavingClass = leaving ? ` ${css$21.leaving}` : "";
+	const leavingClass = leaving ? ` ${css$20.leaving}` : "";
 	if (rendered === "recovered") return jsxs("div", {
-		className: `${css$21.indicator} ${css$21.success}${leavingClass}`,
+		className: `${css$20.indicator} ${css$20.success}${leavingClass}`,
 		role: "status",
 		"aria-label": recoveredLabel,
 		children: [jsx("span", {
-			className: css$21.icon,
+			className: css$20.icon,
 			"aria-hidden": "true",
 			children: jsx(IconCheckOutlineRegular, { size: 14 })
 		}), jsx("span", {
-			className: css$21.label,
+			className: css$20.label,
 			children: recoveredLabel
 		})]
 	});
 	const connecting = rendered === "connecting";
 	return jsxs("button", {
 		type: "button",
-		className: `${css$21.indicator} ${css$21.warning}${leavingClass}`,
+		className: `${css$20.indicator} ${css$20.warning}${leavingClass}`,
 		"data-phase": rendered,
 		"aria-label": connecting ? restartActionLabel : reconnectActionLabel,
 		onClick: onReconnect,
 		children: [jsx("span", {
-			className: css$21.icon,
+			className: css$20.icon,
 			"aria-hidden": "true",
 			children: connecting ? jsx(StateDot, { state: "ongoing" }) : jsx(IconRefreshOutlineRegular, { size: 14 })
 		}), jsx("span", {
-			className: css$21.label,
+			className: css$20.label,
 			children: connecting ? jsxs(Fragment, { children: [connectingLabel, jsxs("span", {
-				className: css$21.dots,
+				className: css$20.dots,
 				"aria-hidden": "true",
 				children: [
 					jsx("span", { children: "." }),
 					jsx("span", {
-						className: css$21.secondDot,
+						className: css$20.secondDot,
 						children: "."
 					}),
 					jsx("span", {
-						className: css$21.thirdDot,
+						className: css$20.thirdDot,
 						children: "."
 					})
 				]
@@ -5697,6 +5474,28 @@ function FullAccessArtwork({ size = 16, className, strokeWidth }) {
 		]
 	});
 }
+function AutoReviewArtwork({ size = 16, className, strokeWidth }) {
+	return jsxs("svg", {
+		width: size,
+		height: size,
+		className,
+		viewBox: "0 0 16 16",
+		fill: "none",
+		xmlns: "http://www.w3.org/2000/svg",
+		"aria-hidden": "true",
+		strokeWidth,
+		children: [jsx("path", {
+			d: "M6.59624 2.14853C7.50155 1.80917 8.49914 1.80919 9.40444 2.14859L13.9245 3.84317V7.11961C13.9245 11.6089 10.5565 13.5975 8.00035 14.5779C5.44423 13.5975 2.07544 11.6089 2.07544 7.11961V3.84317L6.59624 2.14853Z",
+			stroke: "currentColor",
+			strokeLinejoin: "round"
+		}), jsx("path", {
+			d: "M5.75 10.15L8 4.95L10.25 10.15M6.43 8.59H9.57",
+			stroke: "currentColor",
+			strokeLinecap: "round",
+			strokeLinejoin: "round"
+		})]
+	});
+}
 /**
 * Render the read-only permission icon with a one-pixel stroke.
 * @param props - Size and optional class.
@@ -5763,6 +5562,28 @@ function PermissionIconFullAccessMedium(props) {
 		strokeWidth: ICON_MEDIUM_STROKE
 	});
 }
+/**
+* Render the auto-review permission icon with a one-pixel stroke.
+* @param props - Size and optional class.
+* @returns The regular decorative permission glyph.
+*/
+function PermissionIconAutoReviewRegular(props) {
+	return jsx(AutoReviewArtwork, {
+		...props,
+		strokeWidth: 1
+	});
+}
+/**
+* Render the auto-review permission icon with a 1.3px stroke.
+* @param props - Size and optional class.
+* @returns The medium decorative permission glyph.
+*/
+function PermissionIconAutoReviewMedium(props) {
+	return jsx(AutoReviewArtwork, {
+		...props,
+		strokeWidth: ICON_MEDIUM_STROKE
+	});
+}
 //#endregion
 //#region lib/types/ReferenceIcon.js
 /**
@@ -6486,7 +6307,7 @@ function FileTypeIcon(props) {
 		type: resolvedType,
 		size,
 		className
-	}) : glyph(resolvedType, size, clsx(css$22.icon, css$22[resolvedType], className));
+	}) : glyph(resolvedType, size, clsx(css$21.icon, css$21[resolvedType], className));
 }
 //#endregion
 //#region lib/types/SiteGlyph.js
@@ -6755,111 +6576,362 @@ function LinkIconMedium(props) {
 }
 //#endregion
 //#region lib/types/user-text.js
-/** The wire form a session chip serializes to; label is the display text. */
-const SESSION_WIRE_RE = /@\[([^\]\n]+)\]\(dsh-session:[^)\s]+\)/gu;
-/** Sentence punctuation a bare `@name` token may carry without being part of the reference. */
-const TRAILING_PUNCTUATION_RE = /[.,;:!?，。；：！？]+$/u;
-/**
-* Split one sent text into inline plain runs and reference chips.
-* @param text - the logged model text of the message or queue row.
-* @param sessionLabels - exact session mention labels associated by an adjacent recall.
-* @param slashNames - names a `/name` token may decorate as: the skills the
-* host loaded for this message, or the command a command bubble echoes
-* (unsent queue rows pass none).
-* @param slashKind - the chip kind those tokens render as.
-* @param references - optional file and skill preview actions; session and command tokens stay labels.
-* @returns inline nodes covering the whole text.
-*/
-function projectUserText(text, sessionLabels, slashNames = [], slashKind = "skill", references) {
-	const ranges = [];
-	SESSION_WIRE_RE.lastIndex = 0;
-	let wire;
-	while ((wire = SESSION_WIRE_RE.exec(text)) !== null) ranges.push({
-		start: wire.index,
-		end: wire.index + wire[0].length,
-		label: wire[0],
-		kind: "session",
-		display: wire[1]
-	});
-	for (const rawLabel of [...new Set(sessionLabels)].sort((a, b) => b.length - a.length)) {
-		const label = `@${rawLabel}`;
-		let start = text.indexOf(label);
-		while (start >= 0) {
-			ranges.push({
-				start,
-				end: start + label.length,
-				label,
-				kind: "session"
-			});
-			start = text.indexOf(label, start + label.length);
-		}
-	}
-	const re = /(^|\s)(\/[\w-]+(?=\s|$)|@"[^"\n]+"|@[^\s]+)/gu;
-	let m;
-	while ((m = re.exec(text)) !== null) {
-		const tokenStart = m.index + m[1].length;
-		const rawLabel = m[2];
-		const label = rawLabel.startsWith("@\"") ? rawLabel : rawLabel.replace(TRAILING_PUNCTUATION_RE, "");
-		if (label.length <= 1) continue;
-		if (label.startsWith("/") && !slashNames.includes(label.slice(1))) continue;
-		ranges.push({
-			start: tokenStart,
-			end: tokenStart + label.length,
-			label,
-			kind: "plain"
-		});
-	}
-	const rankOf = (range) => range.kind === "session" ? 0 : 1;
-	ranges.sort((a, b) => a.start - b.start || rankOf(a) - rankOf(b) || b.end - a.end);
-	const parts = [];
-	let cursor = 0;
-	const pushPlain = (from, to) => {
-		parts.push(jsx("span", {
-			className: css$23.plainRun,
-			children: text.slice(from, to)
-		}, `t${from}`));
-	};
-	for (const range of ranges) {
-		if (range.start < cursor) continue;
-		const { start: tokenStart, end, label, kind } = range;
-		if (tokenStart > cursor) pushPlain(cursor, tokenStart);
-		const referenceKind = kind === "session" ? "session" : label.startsWith("@") ? label.replace(/^@"|"$/gu, "").endsWith("/") ? "folder" : "file" : void 0;
-		const displayLabel = range.display ?? (referenceKind === void 0 ? label : referenceKind === "session" ? label.slice(1) : label.slice(1).replace(/^"|"$/gu, "").split(/[\\/]/u).filter(Boolean).at(-1) ?? label.slice(1));
-		const contents = jsxs(Fragment, { children: [referenceKind !== void 0 && jsx(ReferenceIconRegular, {
-			kind: referenceKind,
-			size: 16,
-			className: css$23.refIcon
-		}), displayLabel] });
-		const open = references === void 0 ? void 0 : referenceKind === "file" ? () => {
-			references.openFile(label.slice(1).replace(/^"|"$/gu, ""));
-		} : referenceKind === void 0 && slashKind === "skill" ? () => {
-			references.openSkill(label.slice(1));
-		} : void 0;
-		const className = clsx(css$23.refChip, referenceKind === void 0 && css$23.slashChip);
-		parts.push(open === void 0 ? jsx("span", {
-			className,
-			"data-ref-chip": referenceKind ?? slashKind,
-			title: label,
-			children: contents
-		}, tokenStart) : jsx("button", {
-			type: "button",
-			className: clsx(className, markdownCss.fileMention),
-			"data-ref-chip": referenceKind ?? slashKind,
-			title: label,
-			onClick: (event) => {
-				if (event.detail > 1 || event.detail !== 0 && event.currentTarget.ownerDocument.getSelection()?.isCollapsed === false) return;
-				open();
-			},
-			children: contents
-		}, tokenStart));
-		cursor = end;
-	}
-	if (parts.length === 0) return jsx("span", {
-		className: css$23.plainRun,
+/**
+* Render an uninterpreted inline text run.
+* @param props - text retained verbatim from the caller's document.
+* @returns one inline run without Markdown or reference recognition.
+*/
+function UserTextRun({ text }) {
+	return jsx("span", {
+		className: css$22.plainRun,
 		children: text
 	});
-	if (cursor < text.length) pushPlain(cursor, text.length);
-	return jsx(Fragment, { children: parts });
+}
+/**
+* Render a reference label or its explicitly supplied activation action.
+* Text selection and repeated pointer clicks do not activate the reference.
+* @param props - resolved visual fields and optional action from the owning renderer.
+* @returns an inline label, or a keyboard-accessible button when activation is supplied.
+*/
+function ReferenceChip({ appearance, label, title, onActivate }) {
+	const slash = appearance === "skill" || appearance === "command";
+	const contents = jsxs(Fragment, { children: [!slash && jsx(ReferenceIconRegular, {
+		kind: appearance,
+		size: 16,
+		className: css$22.refIcon
+	}), label] });
+	const className = clsx(css$22.refChip, slash && css$22.slashChip);
+	return onActivate === void 0 ? jsx("span", {
+		className,
+		"data-ref-chip": appearance,
+		title,
+		children: contents
+	}) : jsx("button", {
+		type: "button",
+		className: clsx(className, markdownCss.fileMention),
+		"data-ref-chip": appearance,
+		title,
+		onClick: (event) => {
+			if (event.detail > 1 || event.detail !== 0 && event.currentTarget.ownerDocument.getSelection()?.isCollapsed === false) return;
+			onActivate();
+		},
+		children: contents
+	});
+}
+//#endregion
+//#region lib/types/input-modality.js
+/**
+* Document-wide input tracking shared by tooltips and focus-ring styles.
+* Tooltips follow the last input; rings follow navigation or a key followed by
+* focus on a different control. Modifiers and refocusing alone keep rings silent.
+* Module-level listeners live for the document lifetime; Node imports are inert.
+*/
+/** Modality values published on the document element. */
+const INPUT_MODALITY = {
+	pointer: "pointer",
+	keyboard: "keyboard"
+};
+/** Attribute carrying whether focus navigation last owned focus. */
+const INPUT_MODALITY_ATTRIBUTE = "data-input-modality";
+const FOCUS_NAVIGATION = new Set([
+	"Tab",
+	"Home",
+	"End",
+	"PageUp",
+	"PageDown"
+]);
+let pointer = false;
+let pointerOwnsFocus = false;
+let keyFocusOrigin;
+function publish() {
+	document.documentElement.setAttribute(INPUT_MODALITY_ATTRIBUTE, pointerOwnsFocus ? INPUT_MODALITY.pointer : INPUT_MODALITY.keyboard);
+}
+/**
+* Whether the last input came from a pointer, independently of ring visibility.
+* @returns True after pointer input; false after any key.
+*/
+function pointerModality() {
+	return pointer;
+}
+if (typeof window !== "undefined") {
+	window.addEventListener("pointerdown", () => {
+		pointer = true;
+		pointerOwnsFocus = true;
+		keyFocusOrigin = void 0;
+		publish();
+	}, true);
+	window.addEventListener("keydown", (event) => {
+		pointer = false;
+		if (event.isComposing) {
+			keyFocusOrigin = void 0;
+			return;
+		}
+		keyFocusOrigin = event.composedPath()[0];
+		if (!FOCUS_NAVIGATION.has(event.key) && !event.key.startsWith("Arrow")) return;
+		pointerOwnsFocus = false;
+		publish();
+	}, true);
+	window.addEventListener("focusin", (event) => {
+		if (keyFocusOrigin === void 0 || event.composedPath()[0] === keyFocusOrigin) return;
+		keyFocusOrigin = void 0;
+		if (!pointerOwnsFocus) return;
+		pointerOwnsFocus = false;
+		publish();
+	}, true);
+	window.addEventListener("blur", () => {
+		keyFocusOrigin = void 0;
+	});
+}
+//#endregion
+//#region lib/types/Tooltip.js
+/** Anchor-preserving tooltips; an optional body portal escapes clipping containers and stacking contexts that cap the bubble's z-index. */
+/**
+* Suppression channel for nested tooltips: a visible descendant tooltip
+* withdraws the enclosing tooltip while its bubble is shown.
+*/
+const TooltipSuppression = createContext(null);
+/**
+* Attach a hover/focus tooltip to an anchor element.
+* @param props.label - bubble text, or a resolver evaluated only while visible; an empty string shows only shortcut keys.
+* @param props.shortcutKeys - effective key labels rendered as platform-formatted keycaps after optional text.
+* @param props.side - placement relative to the anchor (default 'right').
+* @param props.align - horizontal anchor-edge alignment for 'bottom'/'top' bubbles: 'end' pins
+* the bubble's right edge to the anchor's (for anchors beside other hover surfaces the centered
+* bubble would overlap); default 'center'. Ignored for side 'right'.
+* @param props.portal - render the bubble under document.body, so an ancestor's clipping or its
+* stacking context (which confines the bubble's z-index to that context) cannot hide it.
+* @param props.delayMs - hover delay in milliseconds (default 0).
+* @param props.focusDelayMs - keyboard focus delay in milliseconds (default 0); blur, click,
+* mouse leave, disabling, and unmount cancel a pending show.
+* @param props.gap - anchor-to-bubble distance in pixels for 'bottom'/'top' bubbles (default 8);
+* ignored for side 'right'.
+* @param props.disabled - suppress the bubble while true; the anchor renders identically so
+* toggling never remounts it (which would cut its CSS transitions).
+* @param props.maxWidth - bubble width cap in pixels, for labels long enough that the default
+* half-viewport cap would render a slab wider than the surface the anchor sits on.
+* @param props.openOnClick - clicking also pins the bubble for reading; another click, Escape,
+* Tab, or an outside pointerdown dismisses it. Defaults to false for ordinary action tooltips.
+* @param props.children - a single anchor element; its own ref (callback or object) is forwarded alongside the tooltip's.
+* @returns the cloned anchor plus a fixed-position bubble, optionally portaled to the body.
+* The bubble stays hidden until ResizeObserver supplies its size for viewport fitting; clicking the
+* anchor dismisses the bubble unless openOnClick is enabled, and focus arriving after a pointer
+* interaction (a closing menu refocusing its trigger) never raises it.
+*/
+function Tooltip({ label, shortcutKeys, side = "right", align = "center", delayMs = 0, focusDelayMs = 0, gap = 8, disabled = false, portal = false, maxWidth, openOnClick = false, children }) {
+	const id = useId();
+	const [pinned, setPinned] = useState(false);
+	const anchor = useRef(null);
+	const childRef = children.ref;
+	const mergedRef = useCallback((el) => {
+		anchor.current = el;
+		if (typeof childRef === "function") childRef(el);
+		else if (childRef != null) childRef.current = el;
+	}, [childRef]);
+	const [pos, setPos] = useState(null);
+	const bubble = useRef(null);
+	const resolvedLabel = pos === null ? null : typeof label === "function" ? label() : label;
+	const y = pos === null ? 0 : side === "right" ? pos.top + (pos.bottom - pos.top) / 2 : side === "top" ? pos.top - gap : pos.bottom + gap;
+	const showTimer = useRef(null);
+	const triggers = useRef({
+		hover: false,
+		focus: false
+	});
+	const suppressAncestors = useContext(TooltipSuppression);
+	const [suppressed, setSuppressed] = useState(false);
+	const announce = useCallback((active) => {
+		suppressAncestors?.(active);
+	}, [suppressAncestors]);
+	const visible = pos !== null && !disabled;
+	useEffect(() => {
+		const el = bubble.current;
+		if (pos === null || !visible || suppressed || el === null) return;
+		const edgeMargin = 12;
+		let size;
+		let placement = side;
+		const fit = () => {
+			if (size === void 0) return;
+			const { inlineSize: width, blockSize: height } = size;
+			const offset = side === "right" ? 0 : align === "end" ? width : width / 2;
+			const left = Math.max(edgeMargin, Math.min(pos.x - offset, window.innerWidth - edgeMargin - width));
+			const fitsBelow = pos.bottom + gap + height <= window.innerHeight - edgeMargin;
+			const fitsAbove = pos.top - gap - height >= edgeMargin;
+			if (placement === "bottom" && !fitsBelow && fitsAbove) placement = "top";
+			else if (placement === "top" && !fitsAbove && fitsBelow) placement = "bottom";
+			el.style.left = `${left + offset}px`;
+			el.style.top = `${placement === "right" ? (pos.top + pos.bottom) / 2 : placement === "top" ? pos.top - gap : pos.bottom + gap}px`;
+			el.dataset.side = placement;
+			el.style.visibility = "visible";
+		};
+		const observer = new ResizeObserver((entries) => {
+			size = entries[0]?.borderBoxSize[0];
+			fit();
+		});
+		observer.observe(el, { box: "border-box" });
+		window.addEventListener("resize", fit);
+		return () => {
+			observer.disconnect();
+			window.removeEventListener("resize", fit);
+		};
+	}, [
+		align,
+		gap,
+		pos,
+		side,
+		suppressed,
+		visible
+	]);
+	useEffect(() => {
+		announce(visible);
+		return () => {
+			announce(false);
+		};
+	}, [announce, visible]);
+	const cancelShow = useCallback(() => {
+		if (showTimer.current === null) return;
+		clearTimeout(showTimer.current);
+		showTimer.current = null;
+	}, []);
+	useEffect(() => {
+		if (pinned && (disabled || !openOnClick)) setPinned(false);
+		if (disabled) {
+			cancelShow();
+			triggers.current = {
+				hover: false,
+				focus: false
+			};
+			setPos(null);
+		}
+		return cancelShow;
+	}, [
+		cancelShow,
+		disabled,
+		openOnClick,
+		pinned
+	]);
+	const show = () => {
+		if (disabled) return;
+		const el = anchor.current;
+		/* v8 ignore next -- the ref is attached by event time: events fire on the cloned anchor. */
+		if (el === null) return;
+		const r = el.getBoundingClientRect();
+		setPos({
+			x: side === "right" ? r.right + 10 : align === "end" ? r.right : r.left + r.width / 2,
+			top: r.top,
+			bottom: r.bottom
+		});
+		announce(true);
+	};
+	const showAfterDelay = (delay) => {
+		cancelShow();
+		if (delay <= 0) {
+			show();
+			return;
+		}
+		showTimer.current = setTimeout(() => {
+			showTimer.current = null;
+			show();
+		}, delay);
+	};
+	const withdraw = useCallback(() => {
+		setPinned(false);
+		setPos(null);
+		announce(false);
+	}, [announce]);
+	const hide = () => {
+		cancelShow();
+		if (!triggers.current.hover && !triggers.current.focus && !pinned) withdraw();
+	};
+	const dismiss = useCallback(() => {
+		cancelShow();
+		triggers.current = {
+			hover: false,
+			focus: false
+		};
+		withdraw();
+	}, [cancelShow, withdraw]);
+	useDismissOnOutsidePointer(anchor, openOnClick && visible, dismiss, bubble);
+	useEffect(() => {
+		if (!openOnClick || !visible) return;
+		const onKeyDown = (event) => {
+			if (event.key !== "Escape" && event.key !== "Tab") return;
+			if (event.key === "Escape") {
+				event.preventDefault();
+				event.stopPropagation();
+			}
+			dismiss();
+		};
+		document.addEventListener("keydown", onKeyDown, true);
+		return () => {
+			document.removeEventListener("keydown", onKeyDown, true);
+		};
+	}, [
+		dismiss,
+		openOnClick,
+		visible
+	]);
+	const content = visible && !suppressed && jsxs("span", {
+		ref: bubble,
+		id: openOnClick ? id : void 0,
+		className: css$23.bubble,
+		"data-side": side,
+		"data-portal": portal || void 0,
+		"data-pinned": pinned || void 0,
+		"data-align": align,
+		"data-has-shortcut": shortcutKeys?.length ? true : void 0,
+		style: {
+			left: pos.x,
+			top: y,
+			visibility: "hidden",
+			...maxWidth === void 0 ? {} : { maxWidth }
+		},
+		role: "tooltip",
+		"aria-label": shortcutKeys?.length ? [resolvedLabel, shortcutKeys.join(" ")].filter(Boolean).join(" ") : void 0,
+		children: [resolvedLabel && jsx("span", {
+			className: css$23.label,
+			children: resolvedLabel
+		}), shortcutKeys !== void 0 && shortcutKeys.length > 0 && jsx(ShortcutKeys, {
+			keys: shortcutKeys,
+			variant: "tooltip"
+		})]
+	});
+	return jsxs(TooltipSuppression.Provider, {
+		value: setSuppressed,
+		children: [cloneElement(children, {
+			ref: mergedRef,
+			"aria-describedby": openOnClick && visible ? [children.props["aria-describedby"], id].filter(Boolean).join(" ") : children.props["aria-describedby"],
+			onMouseEnter: (e) => {
+				children.props.onMouseEnter?.(e);
+				triggers.current.hover = true;
+				showAfterDelay(delayMs);
+			},
+			onMouseLeave: (e) => {
+				children.props.onMouseLeave?.(e);
+				triggers.current.hover = false;
+				cancelShow();
+				if (!pinned) withdraw();
+			},
+			onClick: (e) => {
+				children.props.onClick?.(e);
+				triggers.current.focus = false;
+				cancelShow();
+				if (openOnClick && !disabled && !pinned) {
+					setPinned(true);
+					show();
+				} else withdraw();
+			},
+			onFocus: (e) => {
+				children.props.onFocus?.(e);
+				if (pointerModality()) return;
+				triggers.current.focus = true;
+				showAfterDelay(focusDelayMs);
+			},
+			onBlur: (e) => {
+				children.props.onBlur?.(e);
+				triggers.current.focus = false;
+				hide();
+			}
+		}), portal ? content !== false && createPortal(content, document.body) : content]
+	});
 }
 //#endregion
 //#region lib/types/Toast.js
@@ -9468,7 +9540,7 @@ function renderLine$1(line) {
 * @param props - see {@link TerminalBlockProps}.
 * @returns the terminal block element.
 */
-function TerminalBlock({ command, cwd, home, output, exitCode, signal, running = false, maxLines = 16, copyText, runStateDot = true, className, labels }) {
+function TerminalBlock({ command, cwd, home, output, exitCode, signal, running = false, background = false, maxLines = 16, copyText, runStateDot = true, className, labels }) {
 	const copy = labels;
 	const text = output ?? "";
 	const lines = useMemo(() => {
@@ -9481,14 +9553,15 @@ function TerminalBlock({ command, cwd, home, output, exitCode, signal, running =
 	const onToggle = useCallback(() => {
 		setExpanded((value) => !value);
 	}, []);
-	const status = statusText(exitCode, signal, copy);
+	const status = background ? void 0 : statusText(exitCode, signal, copy);
 	const state = runState(running, exitCode, signal, copy);
+	const showState = runStateDot && (!background || running);
 	const commandLines = useMemo(() => {
 		return (command.endsWith("\n") ? command.slice(0, -1) : command).split("\n");
 	}, [command]);
 	const empty = lines.every((line) => line.every((span) => span.text.trim() === ""));
 	const { hidden, capped, headLines, tailLines } = headTailCap(lines.length, maxLines, expanded);
-	const body = !running || !empty;
+	const body = !background && (!running || !empty);
 	return jsxs("div", {
 		className: clsx(css$28.block, className),
 		"data-terminal": "",
@@ -9499,13 +9572,13 @@ function TerminalBlock({ command, cwd, home, output, exitCode, signal, running =
 			children: [
 				jsxs("div", {
 					className: css$28.prompt,
-					children: [runStateDot && jsx("span", {
+					children: [showState && jsx("span", {
 						className: css$28.runStateLabel,
 						children: state.label
 					}), commandLines.map((line, index) => jsxs("div", {
 						className: css$28.promptLine,
 						children: [
-							index === 0 && runStateDot && jsx(StateDot, {
+							index === 0 && showState && jsx(StateDot, {
 								state: state.state,
 								className: css$28.runState
 							}),
@@ -9525,7 +9598,7 @@ function TerminalBlock({ command, cwd, home, output, exitCode, signal, running =
 					className: css$28.status,
 					children: status
 				}),
-				(copyText !== void 0 || !running && !empty) && jsx("button", {
+				(copyText !== void 0 || !background && !running && !empty) && jsx("button", {
 					type: "button",
 					className: css$28.copyButton,
 					onClick: onCopy,
@@ -12505,6 +12578,6 @@ function GuideArtworkFiles({ size = 36, className }) {
 	});
 }
 //#endregion
-export { BrandWordmark, Button, CODE_HIGHLIGHT_EXTENSIONS, Checkbox, CodeBlock, CommandText, ConnectionIndicator, DEFAULT_DIFF_MAX_LINES, DEFAULT_READ_MAX_LINES, DEFAULT_SEARCH_MAX_LINES, DEFAULT_TERMINAL_MAX_LINES, DiffBlock, DisclosureRow, FISH_LOGO_PATH, FISH_LOGO_VIEWBOX, FileTypeIcon, FishLogo, GuideArtworkBrowser, GuideArtworkFiles, HoverCard, ICON_MEDIUM_STROKE, ICON_REGULAR_STROKE, IconAgentPresetOutlineMedium, IconAgentPresetOutlineRegular, IconAlarmClockOutlineMedium, IconAlarmClockOutlineRegular, IconApiOutlineMedium, IconApiOutlineRegular, IconArchiveCheckOutlineMedium, IconArchiveCheckOutlineRegular, IconArchiveOffOutlineMedium, IconArchiveOffOutlineRegular, IconArchiveOutlineMedium, IconArchiveOutlineRegular, IconBranchOutlineMedium, IconBranchOutlineRegular, IconBrowseOutlineMedium, IconBrowseOutlineRegular, IconCheckCircleFillMedium, IconCheckCircleFillRegular, IconCheckCircleOutlineMedium, IconCheckCircleOutlineRegular, IconCheckOutlineMedium, IconCheckOutlineRegular, IconChecklistOutlineMedium, IconChecklistOutlineRegular, IconChevronDownOutlineMedium, IconChevronDownOutlineRegular, IconChevronLeftOutlineMedium, IconChevronLeftOutlineRegular, IconChevronRightOutlineMedium, IconChevronRightOutlineRegular, IconChevronUpOutlineMedium, IconChevronUpOutlineRegular, IconChevronsUpDownOutlineMedium, IconChevronsUpDownOutlineRegular, IconClockOutlineMedium, IconClockOutlineRegular, IconCloseCircleFillMedium, IconCloseCircleFillRegular, IconCloseFillMedium, IconCloseFillRegular, IconCloseOutlineMedium, IconCloseOutlineRegular, IconCodeOutlineMedium, IconCodeOutlineRegular, IconCompactOutlineMedium, IconCompactOutlineRegular, IconCompareSplitOutlineMedium, IconCompareSplitOutlineRegular, IconContextInjectionOutlineMedium, IconContextInjectionOutlineRegular, IconCopyOutlineMedium, IconCopyOutlineRegular, IconCordisPluginOutlineMedium, IconCordisPluginOutlineRegular, IconDarkOutlineMedium, IconDarkOutlineRegular, IconDataOutlineMedium, IconDataOutlineRegular, IconDatabaseOutlineMedium, IconDatabaseOutlineRegular, IconDeliverDocMedium, IconDeliverDocRegular, IconDislikeFillMedium, IconDislikeFillRegular, IconDislikeOutlineMedium, IconDislikeOutlineRegular, IconDownloadOutlineMedium, IconDownloadOutlineRegular, IconEditOutlineMedium, IconEditOutlineRegular, IconEllipsisOutlineMedium, IconEllipsisOutlineRegular, IconEnhanceOutlineMedium, IconEnhanceOutlineRegular, IconFlatListOutlineMedium, IconFlatListOutlineRegular, IconFolderCloseMedium, IconFolderCloseRegular, IconFolderOpenMedium, IconFolderOpenOutlineMedium, IconFolderOpenOutlineRegular, IconFolderOpenRegular, IconFollowsystemOutlineMedium, IconFollowsystemOutlineRegular, IconFullscreenOutlineMedium, IconFullscreenOutlineRegular, IconGaugeOutlineMedium, IconGaugeOutlineRegular, IconGlobeOutlineMedium, IconGlobeOutlineRegular, IconGoalOutlineMedium, IconGoalOutlineRegular, IconInfoOutlineMedium, IconInfoOutlineRegular, IconInspectOutlineMedium, IconInspectOutlineRegular, IconLightOutlineMedium, IconLightOutlineRegular, IconLikeFillMedium, IconLikeFillRegular, IconLikeOutlineMedium, IconLikeOutlineRegular, IconLinkOutlineMedium, IconLinkOutlineRegular, IconListPenOutlineMedium, IconListPenOutlineRegular, IconLoadingOutlineMedium, IconLoadingOutlineRegular, IconMicrophoneOutlineMedium, IconMicrophoneOutlineRegular, IconNewChatOutlineMedium, IconNewChatOutlineRegular, IconNowrapFillMedium, IconNowrapFillRegular, IconPanelLeftOutlineMedium, IconPanelLeftOutlineRegular, IconPaperPlaneOutlineMedium, IconPaperPlaneOutlineRegular, IconPaperclipOutlineMedium, IconPaperclipOutlineRegular, IconPauseOutlineMedium, IconPauseOutlineRegular, IconPersonalizationOutlineMedium, IconPersonalizationOutlineRegular, IconPinFillMedium, IconPinFillRegular, IconPinOutlineMedium, IconPinOutlineRegular, IconPlanOutlineMedium, IconPlanOutlineRegular, IconPlayOutlineMedium, IconPlayOutlineRegular, IconPluginPinwheelOutlineMedium, IconPluginPinwheelOutlineRegular, IconPlusOutlineMedium, IconPlusOutlineRegular, IconProjectAddOutlineMedium, IconProjectAddOutlineRegular, IconQuestionOutlineMedium, IconQuestionOutlineRegular, IconQueueOutlineMedium, IconQueueOutlineRegular, IconRefreshOutlineMedium, IconRefreshOutlineRegular, IconRightUpOutlineMedium, IconRightUpOutlineRegular, IconSearchOutlineMedium, IconSearchOutlineRegular, IconSendOutlineMedium, IconSendOutlineRegular, IconSettingsOutlineMedium, IconSettingsOutlineRegular, IconShareOutlineMedium, IconShareOutlineRegular, IconShieldOutlineMedium, IconShieldOutlineRegular, IconSkillOutlineMedium, IconSkillOutlineRegular, IconSlidersTwoOutlineMedium, IconSlidersTwoOutlineRegular, IconSparkleMedium, IconSparkleRegular, IconStopFillMedium, IconStopFillRegular, IconThinkOutlineMedium, IconThinkOutlineRegular, IconTrashOutlineMedium, IconTrashOutlineRegular, IconTreeCornerMedium, IconTreeCornerRegular, IconTriangleRightFillMedium, IconTriangleRightFillRegular, IconUnarchiveOutlineMedium, IconUnarchiveOutlineRegular, IconUserOutlineMedium, IconUserOutlineRegular, IconUsersOutlineMedium, IconUsersOutlineRegular, IconWarningOutlineMedium, IconWarningOutlineRegular, IconWarningTriangleOutlineMedium, IconWarningTriangleOutlineRegular, IconWorkspaceTreeOutlineMedium, IconWorkspaceTreeOutlineRegular, IconWrapFillMedium, IconWrapFillRegular, IconWrapLinesOutlineMedium, IconWrapLinesOutlineRegular, ImageLightbox, InlineEditor, Input, JsonBlock, JsonTree, LinkIconMedium, LinkIconRegular, MarkdownDelegateProvider, MarkdownText, Menu, MenuGroup, MenuItemButton, MenuSurface, Modal, PathLabel, PermissionIconFullAccessMedium, PermissionIconFullAccessRegular, PermissionIconReadOnlyMedium, PermissionIconReadOnlyRegular, PermissionIconWorkspaceWriteMedium, PermissionIconWorkspaceWriteRegular, Pill, PluginArtworkDefault, PluginArtworkLoop, PluginArtworkSearch, PluginArtworkSubagent, PluginArtworkTerminal, ReadBlock, ReferenceIconMedium, ReferenceIconRegular, RiskConfirmation, SHIELD_OUTLINE_PATH, SearchBlock, SegmentedControl, SegmentedTabs, SettingsForm, SettingsFormModel, SettingsSecretField, SettingsValueField, ShortcutKeys, StateDot, Switch, Tag, TerminalBlock, TextShimmer, Toast, Tooltip, WebBlock, classifyFileType, classifyLinkPath, closeTopModal, diffTotals, extractMarkdownPlainText, fileExtension, fileSizeText, focusWithoutRing, isBehindModal, isDarwinDesktop, languageForPath, modalSelector, observeComposition, observeStickyMenuGroups, pointerModality, projectUserText, rankByName, relativeTime, settingsNumberField, settingsTextField, useAnchoredMaxHeight, useAnchoredPosition, useCodeHighlighter, useDismissOnOutsidePointer, useModalLayer, writeClipboard };
+export { BrandWordmark, Button, CODE_HIGHLIGHT_EXTENSIONS, Checkbox, CodeBlock, CommandText, ConnectionIndicator, DEFAULT_DIFF_MAX_LINES, DEFAULT_READ_MAX_LINES, DEFAULT_SEARCH_MAX_LINES, DEFAULT_TERMINAL_MAX_LINES, DiffBlock, DisclosureRow, FISH_LOGO_PATH, FISH_LOGO_VIEWBOX, FileTypeIcon, FishLogo, GuideArtworkBrowser, GuideArtworkFiles, HoverCard, HoverCardGroup, ICON_MEDIUM_STROKE, ICON_REGULAR_STROKE, IconAgentPresetOutlineMedium, IconAgentPresetOutlineRegular, IconAlarmClockOutlineMedium, IconAlarmClockOutlineRegular, IconApiOutlineMedium, IconApiOutlineRegular, IconArchiveCheckOutlineMedium, IconArchiveCheckOutlineRegular, IconArchiveOffOutlineMedium, IconArchiveOffOutlineRegular, IconArchiveOutlineMedium, IconArchiveOutlineRegular, IconBranchOutlineMedium, IconBranchOutlineRegular, IconBrowseOutlineMedium, IconBrowseOutlineRegular, IconCheckCircleFillMedium, IconCheckCircleFillRegular, IconCheckCircleOutlineMedium, IconCheckCircleOutlineRegular, IconCheckOutlineMedium, IconCheckOutlineRegular, IconChecklistOutlineMedium, IconChecklistOutlineRegular, IconChevronDownOutlineMedium, IconChevronDownOutlineRegular, IconChevronLeftOutlineMedium, IconChevronLeftOutlineRegular, IconChevronRightOutlineMedium, IconChevronRightOutlineRegular, IconChevronUpOutlineMedium, IconChevronUpOutlineRegular, IconChevronsUpDownOutlineMedium, IconChevronsUpDownOutlineRegular, IconClockOutlineMedium, IconClockOutlineRegular, IconCloseCircleFillMedium, IconCloseCircleFillRegular, IconCloseFillMedium, IconCloseFillRegular, IconCloseOutlineMedium, IconCloseOutlineRegular, IconCodeOutlineMedium, IconCodeOutlineRegular, IconCompactOutlineMedium, IconCompactOutlineRegular, IconCompareSplitOutlineMedium, IconCompareSplitOutlineRegular, IconContextInjectionOutlineMedium, IconContextInjectionOutlineRegular, IconCopyOutlineMedium, IconCopyOutlineRegular, IconCordisPluginOutlineMedium, IconCordisPluginOutlineRegular, IconDarkOutlineMedium, IconDarkOutlineRegular, IconDataOutlineMedium, IconDataOutlineRegular, IconDatabaseOutlineMedium, IconDatabaseOutlineRegular, IconDeliverDocMedium, IconDeliverDocRegular, IconDislikeFillMedium, IconDislikeFillRegular, IconDislikeOutlineMedium, IconDislikeOutlineRegular, IconDownloadOutlineMedium, IconDownloadOutlineRegular, IconEditOutlineMedium, IconEditOutlineRegular, IconEllipsisOutlineMedium, IconEllipsisOutlineRegular, IconEnhanceOutlineMedium, IconEnhanceOutlineRegular, IconFlatListOutlineMedium, IconFlatListOutlineRegular, IconFolderCloseMedium, IconFolderCloseRegular, IconFolderOpenMedium, IconFolderOpenOutlineMedium, IconFolderOpenOutlineRegular, IconFolderOpenRegular, IconFollowsystemOutlineMedium, IconFollowsystemOutlineRegular, IconFullscreenOutlineMedium, IconFullscreenOutlineRegular, IconGaugeOutlineMedium, IconGaugeOutlineRegular, IconGlobeOutlineMedium, IconGlobeOutlineRegular, IconGoalOutlineMedium, IconGoalOutlineRegular, IconInfoOutlineMedium, IconInfoOutlineRegular, IconInspectOutlineMedium, IconInspectOutlineRegular, IconLightOutlineMedium, IconLightOutlineRegular, IconLikeFillMedium, IconLikeFillRegular, IconLikeOutlineMedium, IconLikeOutlineRegular, IconLinkOutlineMedium, IconLinkOutlineRegular, IconListPenOutlineMedium, IconListPenOutlineRegular, IconLoadingOutlineMedium, IconLoadingOutlineRegular, IconMicrophoneOutlineMedium, IconMicrophoneOutlineRegular, IconNewChatOutlineMedium, IconNewChatOutlineRegular, IconNowrapFillMedium, IconNowrapFillRegular, IconPanelLeftOutlineMedium, IconPanelLeftOutlineRegular, IconPaperPlaneOutlineMedium, IconPaperPlaneOutlineRegular, IconPaperclipOutlineMedium, IconPaperclipOutlineRegular, IconPauseOutlineMedium, IconPauseOutlineRegular, IconPersonalizationOutlineMedium, IconPersonalizationOutlineRegular, IconPinFillMedium, IconPinFillRegular, IconPinOutlineMedium, IconPinOutlineRegular, IconPlanOutlineMedium, IconPlanOutlineRegular, IconPlayOutlineMedium, IconPlayOutlineRegular, IconPluginPinwheelOutlineMedium, IconPluginPinwheelOutlineRegular, IconPlusOutlineMedium, IconPlusOutlineRegular, IconProjectAddOutlineMedium, IconProjectAddOutlineRegular, IconQuestionOutlineMedium, IconQuestionOutlineRegular, IconQueueOutlineMedium, IconQueueOutlineRegular, IconRefreshOutlineMedium, IconRefreshOutlineRegular, IconRightUpOutlineMedium, IconRightUpOutlineRegular, IconSearchOutlineMedium, IconSearchOutlineRegular, IconSendOutlineMedium, IconSendOutlineRegular, IconSettingsOutlineMedium, IconSettingsOutlineRegular, IconShareOutlineMedium, IconShareOutlineRegular, IconShieldOutlineMedium, IconShieldOutlineRegular, IconSkillOutlineMedium, IconSkillOutlineRegular, IconSlidersTwoOutlineMedium, IconSlidersTwoOutlineRegular, IconSparkleMedium, IconSparkleRegular, IconStopFillMedium, IconStopFillRegular, IconThinkOutlineMedium, IconThinkOutlineRegular, IconTrashOutlineMedium, IconTrashOutlineRegular, IconTreeCornerMedium, IconTreeCornerRegular, IconTriangleRightFillMedium, IconTriangleRightFillRegular, IconUnarchiveOutlineMedium, IconUnarchiveOutlineRegular, IconUserOutlineMedium, IconUserOutlineRegular, IconUsersOutlineMedium, IconUsersOutlineRegular, IconWarningOutlineMedium, IconWarningOutlineRegular, IconWarningTriangleOutlineMedium, IconWarningTriangleOutlineRegular, IconWorkspaceTreeOutlineMedium, IconWorkspaceTreeOutlineRegular, IconWrapFillMedium, IconWrapFillRegular, IconWrapLinesOutlineMedium, IconWrapLinesOutlineRegular, ImageLightbox, InlineEditor, Input, JsonBlock, JsonTree, LinkIconMedium, LinkIconRegular, MarkdownDelegateProvider, MarkdownText, Menu, MenuGroup, MenuItemButton, MenuSurface, Modal, PathLabel, PermissionIconAutoReviewMedium, PermissionIconAutoReviewRegular, PermissionIconFullAccessMedium, PermissionIconFullAccessRegular, PermissionIconReadOnlyMedium, PermissionIconReadOnlyRegular, PermissionIconWorkspaceWriteMedium, PermissionIconWorkspaceWriteRegular, Pill, PluginArtworkDefault, PluginArtworkLoop, PluginArtworkSearch, PluginArtworkSubagent, PluginArtworkTerminal, ReadBlock, ReferenceChip, ReferenceIconMedium, ReferenceIconRegular, RiskConfirmation, SHIELD_OUTLINE_PATH, SearchBlock, SegmentedControl, SegmentedTabs, SettingsForm, SettingsFormModel, SettingsSecretField, SettingsValueField, ShortcutKeys, StateDot, Switch, Tag, TerminalBlock, TextShimmer, Toast, Tooltip, UserTextRun, WebBlock, classifyFileType, classifyLinkPath, closeTopModal, diffTotals, extractMarkdownPlainText, fileExtension, fileSizeText, focusWithoutRing, isBehindModal, isDarwinDesktop, languageForPath, modalSelector, observeComposition, observeStickyMenuGroups, pointerModality, rankByName, relativeTime, settingsNumberField, settingsTextField, useAnchoredMaxHeight, useAnchoredPosition, useCodeHighlighter, useDismissOnOutsidePointer, useModalLayer, writeClipboard };
 
 //# sourceMappingURL=index.js.map