@deepseek-ai/dsh-client-ui-primitives 0.1.6-alpha.1 → 0.1.6-alpha.2

package/lib/index.js

@@ -6,32 +6,34 @@ import css$2 from "./Button.module.css";
 import css$3 from "./Pill.module.css";
 import css$4 from "./Tag.module.css";
 import css$5 from "./Switch.module.css";
-import css$6 from "./Input.module.css";
-import { Fragment as Fragment$1, cloneElement, createElement, memo, useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import css$6 from "./Checkbox.module.css";
+import css$7 from "./Input.module.css";
+import { Fragment as Fragment$1, cloneElement, createContext, createElement, memo, useCallback, useContext, useEffect, useId, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { createPortal } from "react-dom";
-import css$7 from "./Menu.module.css";
-import css$8 from "./HoverCard.module.css";
-import css$9 from "./Modal.module.css";
-import css$10 from "./OnboardingSurface.module.css";
-import css$11 from "./RiskConfirmation.module.css";
-import css$12 from "./ConnectionIndicator.module.css";
-import css$13 from "./FileTypeIcon.module.css";
-import css$14 from "./user-text.module.css";
+import css$8 from "./Menu.module.css";
+import css$9 from "./HoverCard.module.css";
+import css$10 from "./Modal.module.css";
+import css$11 from "./OnboardingSurface.module.css";
+import css$12 from "./RiskConfirmation.module.css";
+import css$13 from "./ConnectionIndicator.module.css";
+import css$14 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$15 from "./user-text.module.css";
 import markdownCss from "./markdown/MarkdownText.module.css";
-import css$15 from "./Tooltip.module.css";
-import css$16 from "./Toast.module.css";
-import css$17 from "./JsonTree.module.css";
+import css$16 from "./Tooltip.module.css";
+import css$17 from "./Toast.module.css";
+import css$18 from "./JsonTree.module.css";
 import Anser from "anser";
-import css$18 from "./TerminalBlock.module.css";
+import css$19 from "./TerminalBlock.module.css";
 import { createCssVariablesTheme, createHighlighterCoreSync } from "shiki/core";
 import { createJavaScriptRegexEngine, defaultJavaScriptRegexConstructor } from "shiki/engine/javascript";
 import langTs from "@shikijs/langs/typescript";
 import langBash from "@shikijs/langs/shellscript";
 import langJson from "@shikijs/langs/json";
-import css$19 from "./ReadBlock.module.css";
+import css$20 from "./ReadBlock.module.css";
 import { structuredPatch } from "diff";
-import css$20 from "./DiffBlock.module.css";
-import css$21 from "./SearchBlock.module.css";
+import css$21 from "./DiffBlock.module.css";
+import css$22 from "./SearchBlock.module.css";
 import { fromMarkdown } from "mdast-util-from-markdown";
 import { gfmFromMarkdown } from "mdast-util-gfm";
 import { mathFromMarkdown } from "mdast-util-math";
@@ -43,11 +45,11 @@ import { classifyCharacter } from "micromark-util-classify-character";
 import { codes, constants, types } from "micromark-util-symbol";
 import { factorySpace } from "micromark-factory-space";
 import { normalizeUri } from "micromark-util-sanitize-uri";
-import css$22 from "./markdown/CodeBlock.module.css";
+import css$23 from "./markdown/CodeBlock.module.css";
 import katex from "katex";
 import "katex/dist/katex.min.css";
-import css$23 from "./WebBlock.module.css";
-import css$24 from "./markdown/JsonBlock.module.css";
+import css$24 from "./WebBlock.module.css";
+import css$25 from "./markdown/JsonBlock.module.css";
 //#region lib/types/StateDot.js
 /** Outer 3x3 matrix cells (2px pixels on a 10px grid), clockwise from top-left. */
 const MATRIX_CELLS = [
@@ -1429,6 +1431,29 @@ const IconQuestionOutline14 = ({ size = 14, className }) => jsxs("svg", {
 		})
 	]
 });
+/** Info companion to the question outline: the same ring with an "i" glyph. */
+const IconInfoOutline14 = ({ size = 14, className }) => jsxs("svg", {
+	width: size,
+	height: size,
+	className,
+	viewBox: "0 0 14 14",
+	fill: "none",
+	xmlns: "http://www.w3.org/2000/svg",
+	children: [
+		jsx("path", {
+			d: "M12.5757 7.00012C12.5757 3.92085 10.0794 1.42463 7.00012 1.42456C3.9208 1.42456 1.42456 3.9208 1.42456 7.00012C1.42463 10.0794 3.92085 12.5757 7.00012 12.5757C10.0793 12.5756 12.5756 10.0793 12.5757 7.00012ZM13.8002 7.00012C13.8001 10.7559 10.7559 13.8001 7.00012 13.8002C3.2443 13.8002 0.199291 10.7559 0.199219 7.00012C0.199219 3.24426 3.24426 0.199219 7.00012 0.199219C10.7559 0.199291 13.8002 3.2443 13.8002 7.00012Z",
+			fill: "currentColor"
+		}),
+		jsx("path", {
+			d: "M7.6127 3.18921V4.55986H6.38735V3.18921H7.6127Z",
+			fill: "currentColor"
+		}),
+		jsx("path", {
+			d: "M7.6127 5.68921V10.8109H6.38735V5.68921H7.6127Z",
+			fill: "currentColor"
+		})
+	]
+});
 /** Alarm clock outline for active scheduled-task indicators. */
 const IconAlarmClockOutline16 = ({ size = 16, className }) => jsxs("svg", {
 	"aria-hidden": "true",
@@ -1602,6 +1627,37 @@ const IconShieldOutline16 = ({ size = 16, className }) => jsx("svg", {
 		strokeLinejoin: "round"
 	})
 });
+/** Plugin pinwheel (design handoff for the plugin manager): four interleaved arcs on the 16 grid. */
+const IconPluginPinwheelOutline16 = ({ size = 16, className }) => jsxs("svg", {
+	width: size,
+	height: size,
+	className,
+	viewBox: "0 0 16 16",
+	fill: "none",
+	xmlns: "http://www.w3.org/2000/svg",
+	children: [
+		jsx("path", {
+			d: "M7.84457 5.06199C11.6605 4.93876 14.7962 6.14848 14.8484 7.76397C14.8875 8.97461 13.1838 10.0696 10.7215 10.5942",
+			stroke: "currentColor",
+			strokeWidth: "1.2"
+		}),
+		jsx("path", {
+			d: "M5.12742 8.07731C5.00419 4.26138 6.21391 1.12568 7.8294 1.07351C9.04004 1.03441 10.135 2.73808 10.6596 5.20037",
+			stroke: "currentColor",
+			strokeWidth: "1.2"
+		}),
+		jsx("path", {
+			d: "M8.02457 10.6802C4.20865 10.8034 1.07294 9.5937 1.02077 7.97821C0.981678 6.76758 2.68535 5.67262 5.14763 5.14798",
+			stroke: "currentColor",
+			strokeWidth: "1.2"
+		}),
+		jsx("path", {
+			d: "M10.7476 7.89535C10.8708 11.7113 9.66109 14.847 8.0456 14.8991C6.83496 14.9382 5.74 13.2346 5.21536 10.7723",
+			stroke: "currentColor",
+			strokeWidth: "1.2"
+		})
+	]
+});
 //#endregion
 //#region lib/types/DisclosureRow.js
 /**
@@ -1743,6 +1799,33 @@ function Switch({ checked, onChange, label, disabled = false, title, className }
 	});
 }
 //#endregion
+//#region lib/types/Checkbox.js
+/** Controlled native checkbox with a caller-owned visible and accessible label. */
+/**
+* Render a labeled checkbox with native keyboard and form semantics.
+* @param props.checked - current checked state.
+* @param props.onChange - receives the requested checked state.
+* @param props.label - localized visible and accessible label.
+* @param props.disabled - whether the control refuses changes.
+* @param props.title - optional localized hover text.
+* @param props.className - extra class for the label's placement.
+* @returns the label containing its checkbox.
+*/
+function Checkbox({ checked, onChange, label, disabled = false, title, className }) {
+	return jsxs("label", {
+		className: clsx(css$6.checkbox, className),
+		title,
+		children: [jsx("input", {
+			type: "checkbox",
+			checked,
+			disabled,
+			onChange: (event) => {
+				onChange(event.target.checked);
+			}
+		}), jsx("span", { children: label })]
+	});
+}
+//#endregion
 //#region lib/types/Input.js
 /**
 * Render a text input with an optional leading icon.
@@ -1751,12 +1834,12 @@ function Switch({ checked, onChange, label, disabled = false, title, className }
 */
 function Input({ icon, className, ...rest }) {
 	return jsxs("span", {
-		className: clsx(css$6.wrap, className),
+		className: clsx(css$7.wrap, className),
 		children: [icon != null && jsx("span", {
-			className: css$6.icon,
+			className: css$7.icon,
 			children: icon
 		}), jsx("input", {
-			className: css$6.input,
+			className: css$7.input,
 			...rest
 		})]
 	});
@@ -1805,8 +1888,13 @@ const MEASURE_STYLE = {
 	top: 0
 };
 /**
-* Render an anchored dropdown menu.
-* @param props.autoFocus - focus the first item on open and enable arrow-key navigation; Escape focuses the anchor's first button.
+* Render an anchored dropdown menu. While the list is open its keys mirror the
+* composer's: Tab settles the focused row — from the trigger, Tab enters the
+* list instead — and Escape or Shift+Tab close it and return focus to the
+* anchor's first button, and selecting a row does the same — the rows unmount
+* with the list. Only a keyboard on the trigger or inside the list is
+* intercepted; Tab presses elsewhere on the page stay the browser's.
+* @param props.autoFocus - focus the first item on open; the arrow keys walk the list either way.
 * @param props.open - whether the list is showing (owner-controlled).
 * @param props.anchor - the trigger element (rendered in place).
 * @param props.items - selectable rows and optional separators.
@@ -1845,6 +1933,44 @@ const MEASURE_STYLE = {
 function Menu({ open, anchor, items, selectedId, selectedIds, onSelect, onClose, align = "start", side = "bottom", portal = false, closeOnPointerLeave = false, dense = false, compact = false, autoFocus = false, selection = "check", getAnchorRect, footer, className }) {
 	const rootRef = useRef(null);
 	const listRef = useRef(null);
+	/** Index the arrow walk last focused, the resume point when focus left the rows. */
+	const walkIndex = useRef(null);
+	/**
+	* The control that had the keyboard when this menu opened — its own trigger,
+	* which an anchor that wraps several controls (a split button) would not be
+	* able to name by position.
+	*/
+	const triggerRef = useRef(null);
+	/**
+	* Hand the keyboard back to the trigger that opened the menu — or, when the
+	* anchor never held it, to the anchor's first button. Focus left on a removed
+	* row otherwise falls to the page body, where the next Tab restarts from the
+	* top of the page.
+	*/
+	const refocusAnchor = () => {
+		const trigger = triggerRef.current;
+		if (trigger !== null && document.contains(trigger) && !trigger.disabled) {
+			trigger.focus();
+			return;
+		}
+		rootRef.current?.querySelector("button:not(:disabled)")?.focus();
+	};
+	/**
+	* Post-selection focus, for the paths where the rows unmount with the list.
+	* A selection whose owner keeps the menu open is left alone, and so is an
+	* owner that moved focus itself (a presented file card hands it to its
+	* preview button): only a keyboard left on the closing list (or on the body
+	* its removal produced) comes back to the trigger.
+	*/
+	const refocusAfterSelection = () => {
+		queueMicrotask(() => {
+			if (openRef.current) return;
+			const active = document.activeElement;
+			if (active === null || active === document.body || listRef.current?.contains(active) === true) refocusAnchor();
+		});
+	};
+	const openRef = useRef(open);
+	openRef.current = open;
 	const [openSubmenuId, setOpenSubmenuId] = useState(null);
 	const [fixedPos, setFixedPos] = useState(null);
 	const { arm: armClose, cancel: cancelClose } = usePointerGrace(onClose);
@@ -1900,11 +2026,23 @@ function Menu({ open, anchor, items, selectedId, selectedIds, onSelect, onClose,
 		getAnchorRect
 	]);
 	useEffect(() => {
-		if (open && autoFocus) listRef.current?.querySelector("button:not(:disabled)")?.focus();
+		if (!open) {
+			triggerRef.current = null;
+			return;
+		}
+		const active = document.activeElement;
+		triggerRef.current = active instanceof HTMLElement && rootRef.current?.contains(active) === true ? active : null;
+	}, [open]);
+	useEffect(() => {
+		if (!open || !autoFocus) return;
+		const first = listRef.current?.querySelector("button:not(:disabled)");
+		walkIndex.current = first === void 0 || first === null ? null : 0;
+		first?.focus();
 	}, [open, autoFocus]);
 	useEffect(() => {
 		if (!open) {
 			setOpenSubmenuId(null);
+			walkIndex.current = null;
 			return;
 		}
 		const onPointerDown = (e) => {
@@ -1914,21 +2052,52 @@ function Menu({ open, anchor, items, selectedId, selectedIds, onSelect, onClose,
 			onClose();
 		};
 		const onKeyDown = (e) => {
+			const focused = document.activeElement;
+			const insideList = listRef.current?.contains(focused) === true;
+			const anchored = rootRef.current?.contains(focused) === true || insideList;
 			if (e.key === "Escape") {
 				onClose();
-				if (autoFocus) rootRef.current?.querySelector("button")?.focus();
+				if (anchored || autoFocus) refocusAnchor();
+			}
+			if (e.key === "Tab") {
+				const list = listRef.current;
+				if (list === null || !anchored) return;
+				if (e.shiftKey) {
+					e.preventDefault();
+					onClose();
+					refocusAnchor();
+					return;
+				}
+				if (insideList) {
+					if (focused instanceof Element && focused.getAttribute("role") === "menuitem") {
+						e.preventDefault();
+						focused.click();
+					}
+					return;
+				}
+				const row = list.querySelector("button:not(:disabled)");
+				if (row === null) return;
+				e.preventDefault();
+				row.focus();
+				walkIndex.current = 0;
+				return;
 			}
-			if (!autoFocus || ![
+			if (![
 				"ArrowDown",
 				"ArrowUp",
 				"Home",
 				"End"
 			].includes(e.key)) return;
-			const buttons = Array.from(listRef.current?.querySelectorAll("button:not(:disabled)") ?? []);
-			const index = buttons.indexOf(document.activeElement);
-			if (index < 0) return;
+			const list = listRef.current;
+			if (list === null || !anchored) return;
+			const buttons = Array.from(list.querySelectorAll("button:not(:disabled)"));
+			if (buttons.length === 0) return;
+			const index = buttons.indexOf(focused);
+			const from = index >= 0 ? index : walkIndex.current;
+			const next = e.key === "Home" ? 0 : e.key === "End" ? buttons.length - 1 : from === null ? e.key === "ArrowDown" ? 0 : buttons.length - 1 : (from + (e.key === "ArrowDown" ? 1 : -1) + buttons.length) % buttons.length;
 			e.preventDefault();
-			buttons[e.key === "Home" ? 0 : e.key === "End" ? buttons.length - 1 : (index + (e.key === "ArrowDown" ? 1 : -1) + buttons.length) % buttons.length]?.focus();
+			walkIndex.current = next;
+			buttons[next]?.focus();
 		};
 		const onWindowBlur = () => {
 			if (document.activeElement instanceof HTMLIFrameElement) onClose();
@@ -1952,11 +2121,11 @@ function Menu({ open, anchor, items, selectedId, selectedIds, onSelect, onClose,
 	const scrollable = !items.some((entry) => !isSeparator(entry) && !isLabel(entry) && entry.submenu !== void 0 && entry.submenu.length > 0);
 	const renderEntry = (entry) => {
 		if (isSeparator(entry)) return jsx("div", {
-			className: css$7.separator,
+			className: css$8.separator,
 			role: "separator"
 		}, entry.id);
 		if (isLabel(entry)) return jsx("div", {
-			className: css$7.label,
+			className: css$8.label,
 			role: "presentation",
 			children: entry.text
 		}, entry.id);
@@ -1964,7 +2133,7 @@ function Menu({ open, anchor, items, selectedId, selectedIds, onSelect, onClose,
 		const subOpen = hasSub && openSubmenuId === entry.id;
 		const selected = entry.id === selectedId || selectedIds?.includes(entry.id) === true;
 		return jsxs("div", {
-			className: css$7.itemWrap,
+			className: css$8.itemWrap,
 			onMouseEnter: () => {
 				setOpenSubmenuId(hasSub ? entry.id : null);
 			},
@@ -1974,7 +2143,7 @@ function Menu({ open, anchor, items, selectedId, selectedIds, onSelect, onClose,
 			children: [jsxs("button", {
 				type: "button",
 				role: "menuitem",
-				className: clsx(css$7.item, selected && (selection === "fill" ? css$7.selectedFill : css$7.selected), entry.danger === true && css$7.danger),
+				className: clsx(css$8.item, selected && (selection === "fill" ? css$8.selectedFill : css$8.selected), entry.danger === true && css$8.danger),
 				disabled: entry.disabled,
 				"aria-haspopup": hasSub ? "menu" : void 0,
 				"aria-expanded": hasSub ? subOpen : void 0,
@@ -1987,34 +2156,36 @@ function Menu({ open, anchor, items, selectedId, selectedIds, onSelect, onClose,
 						return;
 					}
 					onSelect(entry.id);
+					refocusAfterSelection();
 				},
 				children: [
 					entry.icon !== void 0 && jsx("span", {
-						className: css$7.itemIcon,
+						className: css$8.itemIcon,
 						children: entry.icon
 					}),
 					jsx("span", {
-						className: css$7.itemLabel,
+						className: css$8.itemLabel,
 						children: entry.label
 					}),
-					selected && selection === "check" && jsx(IconCheckOutline16, { className: css$7.check })
+					selected && selection === "check" && jsx(IconCheckOutline16, { className: css$8.check })
 				]
 			}), subOpen && entry.submenu !== void 0 && jsx("div", {
-				className: clsx(css$7.submenu, compact && css$7.compactList),
+				className: clsx(css$8.submenu, compact && css$8.compactList),
 				role: "menu",
 				children: entry.submenu.map((sub) => jsxs("button", {
 					type: "button",
 					role: "menuitem",
-					className: css$7.item,
+					className: css$8.item,
 					disabled: sub.disabled,
 					onClick: () => {
 						onSelect(sub.id);
+						refocusAfterSelection();
 					},
 					children: [sub.icon !== void 0 && jsx("span", {
-						className: css$7.itemIcon,
+						className: css$8.itemIcon,
 						children: sub.icon
 					}), jsx("span", {
-						className: css$7.itemLabel,
+						className: css$8.itemLabel,
 						children: sub.label
 					})]
 				}, sub.id))
@@ -2023,25 +2194,25 @@ function Menu({ open, anchor, items, selectedId, selectedIds, onSelect, onClose,
 	};
 	const list = open && jsxs("div", {
 		ref: listRef,
-		className: clsx(css$7.list, dense && css$7.denseList, compact && css$7.compactList, scrollable && css$7.scrollable, portal && css$7.portal, side === "top" && !portal && css$7.sideTop, align === "end" && !portal && css$7.alignEnd),
+		className: clsx(css$8.list, dense && css$8.denseList, compact && css$8.compactList, scrollable && css$8.scrollable, portal && css$8.portal, side === "top" && !portal && css$8.sideTop, align === "end" && !portal && css$8.alignEnd),
 		style: portal ? fixedPos ?? MEASURE_STYLE : void 0,
 		role: "menu",
 		onClick: (e) => {
 			e.stopPropagation();
 		},
 		children: [jsx("div", {
-			className: css$7.viewport,
+			className: css$8.viewport,
 			role: "presentation",
 			children: items.map(renderEntry)
 		}), footer !== void 0 && footer.length > 0 && jsx("div", {
-			className: css$7.footer,
+			className: css$8.footer,
 			role: "presentation",
 			children: footer.map(renderEntry)
 		})]
 	});
 	return jsxs("span", {
 		ref: rootRef,
-		className: clsx(css$7.root, className),
+		className: clsx(css$8.root, className),
 		onPointerEnter: closeOnPointerLeave ? cancelClose : void 0,
 		onPointerLeave: closeOnPointerLeave ? () => {
 			if (open) armClose();
@@ -2341,7 +2512,7 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 	const copyable = copyText !== void 0;
 	const card = open && pos !== null && jsx("div", {
 		ref: cardRef,
-		className: `${css$8.card}${copyable ? ` ${css$8.copyable}` : ""}${copied ? ` ${css$8.feedback}` : ""}`,
+		className: `${css$9.card}${copyable ? ` ${css$9.copyable}` : ""}${copied ? ` ${css$9.feedback}` : ""}`,
 		style: {
 			...pos,
 			minHeight: copied && copyHeightRef.current !== null ? copyHeightRef.current : void 0
@@ -2362,14 +2533,14 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 			copy(copyText);
 		} : void 0,
 		children: copied ? jsx("span", {
-			className: css$8.copied,
+			className: css$9.copied,
 			"aria-hidden": "true",
 			children: copiedLabel
 		}) : content
 	});
 	return jsxs("span", {
 		ref: rootRef,
-		className: css$8.root,
+		className: css$9.root,
 		onPointerEnter: () => {
 			if (disabled) return;
 			cancelClose();
@@ -2392,7 +2563,7 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 		children: [
 			anchor,
 			open && copyable && jsx("span", {
-				className: css$8.status,
+				className: css$9.status,
 				role: "status",
 				children: copied ? copiedLabel : ""
 			}),
@@ -2405,7 +2576,8 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 /**
 * Render a centered, body-portaled modal over a blurred page mask.
 * @param props.open - whether the dialog is showing.
-* @param props.onClose - Escape or mask click.
+* @param props.onClose - Escape or mask click; while a menu is open inside the
+* dialog, Escape belongs to that menu first.
 * @param props.title - dialog heading (aria-label in every mode).
 * @param props.closeLabel - localized accessible close-button label.
 * @param props.description - optional supporting sentence under the title.
@@ -2429,44 +2601,44 @@ function Modal({ open, onClose, title, closeLabel, description, children, footer
 	}, [open, onClose]);
 	if (!open) return null;
 	return createPortal(jsxs("div", {
-		className: css$9.root,
+		className: css$10.root,
 		role: "presentation",
 		children: [jsx("div", {
-			className: css$9.mask,
+			className: css$10.mask,
 			"aria-hidden": "true",
 			onClick: onClose
 		}), jsx("div", {
-			className: clsx(css$9.dialog, className),
+			className: clsx(css$10.dialog, className),
 			role: "dialog",
 			"aria-modal": "true",
 			"aria-label": title,
 			children: headless ? children : jsxs(Fragment, { children: [jsxs("div", {
-				className: clsx(css$9.content, contentClassName),
+				className: clsx(css$10.content, contentClassName),
 				children: [
 					jsxs("div", {
-						className: css$9.header,
+						className: css$10.header,
 						children: [jsx("h2", {
-							className: css$9.title,
+							className: css$10.title,
 							children: title
 						}), jsx("button", {
 							type: "button",
-							className: css$9.close,
+							className: css$10.close,
 							"aria-label": closeLabel,
 							onClick: onClose,
 							children: jsx(IconCloseOutline16, { size: 14 })
 						})]
 					}),
 					description !== void 0 && description !== "" && jsx("p", {
-						className: css$9.description,
+						className: css$10.description,
 						children: description
 					}),
 					children !== void 0 && jsx("div", {
-						className: css$9.body,
+						className: css$10.body,
 						children
 					})
 				]
 			}), footer !== void 0 && jsx("div", {
-				className: css$9.footer,
+				className: css$10.footer,
 				children: footer
 			})] })
 		})]
@@ -2490,13 +2662,13 @@ function OnboardingSurface({ children }) {
 		};
 	}, []);
 	return createPortal(jsxs("div", {
-		className: css$10.onboardingOverlay,
+		className: css$11.onboardingOverlay,
 		role: "presentation",
 		children: [jsx("div", {
-			className: css$10.onboardingMask,
+			className: css$11.onboardingMask,
 			"aria-hidden": "true"
 		}), jsx("div", {
-			className: css$10.onboardingStage,
+			className: css$11.onboardingStage,
 			children
 		})]
 	}), document.body);
@@ -2517,28 +2689,28 @@ function RiskConfirmation({ open, title, description, acknowledgeLabel, cancelLa
 		onClose: onCancel,
 		title,
 		closeLabel,
-		className: css$11.confirmation ?? "",
-		contentClassName: css$11.confirmationContent ?? "",
+		className: css$12.confirmation ?? "",
+		contentClassName: css$12.confirmationContent ?? "",
 		footer: jsxs(Fragment, { children: [jsx(Button, {
 			variant: "outline",
-			className: css$11.modalAction,
+			className: css$12.modalAction,
 			onClick: onCancel,
 			children: cancelLabel
 		}), jsx(Button, {
 			variant: "primary",
-			className: css$11.confirmAction,
+			className: css$12.confirmAction,
 			disabled: disabled || !acknowledged,
 			onClick: onConfirm,
 			children: confirmLabel
 		})] }),
 		children: [jsxs("div", {
-			className: css$11.warning,
+			className: css$12.warning,
 			children: [jsx(IconWarningOutline16, {
 				size: 18,
-				className: css$11.warningIcon
+				className: css$12.warningIcon
 			}), jsx("p", { children: description })]
 		}), jsxs("label", {
-			className: css$11.acknowledgement,
+			className: css$12.acknowledgement,
 			children: [jsx("input", {
 				type: "checkbox",
 				checked: acknowledged,
@@ -2586,47 +2758,47 @@ function ConnectionIndicator({ state, disconnectedLabel, connectingLabel, recove
 		};
 	}, [state, rendered]);
 	if (rendered === void 0) return null;
-	const leavingClass = leaving ? ` ${css$12.leaving}` : "";
+	const leavingClass = leaving ? ` ${css$13.leaving}` : "";
 	if (rendered === "recovered") return jsxs("div", {
-		className: `${css$12.indicator} ${css$12.success}${leavingClass}`,
+		className: `${css$13.indicator} ${css$13.success}${leavingClass}`,
 		role: "status",
 		"aria-label": recoveredLabel,
 		children: [jsx("span", {
-			className: css$12.icon,
+			className: css$13.icon,
 			"aria-hidden": "true",
 			children: jsx(IconCheckOutline16, { size: 14 })
 		}), jsx("span", {
-			className: css$12.label,
+			className: css$13.label,
 			children: recoveredLabel
 		})]
 	});
 	const connecting = rendered === "connecting";
 	return jsxs("button", {
 		type: "button",
-		className: `${css$12.indicator} ${css$12.warning}${leavingClass}`,
+		className: `${css$13.indicator} ${css$13.warning}${leavingClass}`,
 		"data-phase": rendered,
 		"aria-label": connecting ? restartActionLabel : reconnectActionLabel,
 		onClick: onReconnect,
 		children: [jsx("span", {
-			className: css$12.icon,
+			className: css$13.icon,
 			"aria-hidden": "true",
 			children: connecting ? jsx(IconLoadingOutline16, {
 				size: 14,
-				className: css$12.spinner
+				className: css$13.spinner
 			}) : jsx(IconRefreshOutline14, { size: 14 })
 		}), jsx("span", {
-			className: css$12.label,
+			className: css$13.label,
 			children: connecting ? jsxs(Fragment, { children: [connectingLabel, jsxs("span", {
-				className: css$12.dots,
+				className: css$13.dots,
 				"aria-hidden": "true",
 				children: [
 					jsx("span", { children: "." }),
 					jsx("span", {
-						className: css$12.secondDot,
+						className: css$13.secondDot,
 						children: "."
 					}),
 					jsx("span", {
-						className: css$12.thirdDot,
+						className: css$13.thirdDot,
 						children: "."
 					})
 				]
@@ -3467,7 +3639,103 @@ function FileTypeIcon(props) {
 		type: resolvedType,
 		size,
 		className
-	}) : glyph(resolvedType, size, clsx(css$13.icon, css$13[resolvedType], className));
+	}) : glyph(resolvedType, size, clsx(css$14.icon, css$14[resolvedType], className));
+}
+//#endregion
+//#region lib/types/SiteGlyph.js
+/**
+* Host suffix to site mark, covering the developer sites the transcript
+* usually cites plus the mainstream search, video, social, shopping, and
+* reference sites a general audience links. A host matches a suffix when it
+* equals it or is a subdomain of it, and the longest matching suffix wins, so
+* `weixin.qq.com` keeps WeChat while `qq.com` keeps QQ and `gist.github.com`
+* needs no entry of its own.
+*/
+const SITE_HOSTS = {
+	"github.com": siGithub,
+	"github.io": siGithub,
+	"raw.githubusercontent.com": siGithub,
+	"gitlab.com": siGitlab,
+	"npmjs.com": siNpm,
+	"pypi.org": siPypi,
+	"stackoverflow.com": siStackoverflow,
+	"developer.mozilla.org": siMdnwebdocs,
+	"wikipedia.org": siWikipedia,
+	"news.ycombinator.com": siYcombinator,
+	"youtube.com": siYoutube,
+	"youtu.be": siYoutube,
+	"x.com": siX,
+	"twitter.com": siX,
+	"bilibili.com": siBilibili,
+	"zhihu.com": siZhihu,
+	"juejin.cn": siJuejin,
+	"csdn.net": siCsdn,
+	"google.com": siGoogle,
+	"baidu.com": siBaidu,
+	"duckduckgo.com": siDuckduckgo,
+	"tiktok.com": siTiktok,
+	"netflix.com": siNetflix,
+	"spotify.com": siSpotify,
+	"facebook.com": siFacebook,
+	"instagram.com": siInstagram,
+	"reddit.com": siReddit,
+	"telegram.org": siTelegram,
+	"t.me": siTelegram,
+	"weixin.qq.com": siWechat,
+	"qq.com": siQq,
+	"whatsapp.com": siWhatsapp,
+	"wa.me": siWhatsapp,
+	"weibo.com": siSinaweibo,
+	"taobao.com": siTaobao,
+	"aliexpress.com": siAliexpress,
+	"ebay.com": siEbay,
+	"quora.com": siQuora,
+	"v2ex.com": siV2ex,
+	"apple.com": siApple
+};
+/**
+* Resolve the mark named by an external destination.
+* @param href - The link destination; only an absolute http(s) URL can name a host.
+* @returns The matched site mark, or undefined when the host is unknown or not http(s).
+*/
+function siteIcon(href) {
+	let host;
+	try {
+		const url = new URL(href);
+		if (url.protocol !== "http:" && url.protocol !== "https:") return void 0;
+		host = url.hostname.toLowerCase();
+	} catch {
+		return;
+	}
+	let match;
+	let matched = 0;
+	for (const [suffix, icon] of Object.entries(SITE_HOSTS)) if ((host === suffix || host.endsWith(`.${suffix}`)) && suffix.length > matched) {
+		match = icon;
+		matched = suffix.length;
+	}
+	return match;
+}
+/**
+* Render the site mark for a known external destination.
+* @param props - The destination and the icon sizing seat.
+* @returns The site's mark riding currentColor, or undefined for an unknown site.
+*/
+function siteGlyph({ href, size, className }) {
+	const icon = href === void 0 ? void 0 : siteIcon(href);
+	if (icon === void 0) return void 0;
+	return jsx("svg", {
+		width: size,
+		height: size,
+		className,
+		viewBox: "-2 -2 28 28",
+		fill: "none",
+		xmlns: "http://www.w3.org/2000/svg",
+		"aria-hidden": true,
+		children: jsx("path", {
+			d: icon.path,
+			fill: "currentColor"
+		})
+	});
 }
 //#endregion
 //#region lib/types/LinkIcon.js
@@ -3614,13 +3882,18 @@ function assertNever$1(value) {
 }
 /**
 * Render the leading glyph for one clickable artifact link.
-* @param props - The link category, optional size (default 14px — the inline
-* link text size these glyphs sit beside), and optional CSS class.
+* @param props - The link category, the optional destination that can select a
+* site mark, optional size (default 14px — the inline link text size these
+* glyphs sit beside), and optional CSS class.
 * @returns The category's SVG glyph, riding currentColor.
 */
-function LinkIcon({ kind, size = 14, className }) {
+function LinkIcon({ kind, href, size = 14, className }) {
 	switch (kind) {
-		case "url": return jsx(GlobeGlyph, {
+		case "url": return siteGlyph({
+			href,
+			size,
+			className
+		}) ?? jsx(GlobeGlyph, {
 			size,
 			className
 		});
@@ -3710,7 +3983,7 @@ function projectUserText(text, sessionLabels, slashNames = [], slashKind = "skil
 	let cursor = 0;
 	const pushPlain = (from, to) => {
 		parts.push(jsx("span", {
-			className: css$14.plainRun,
+			className: css$15.plainRun,
 			children: text.slice(from, to)
 		}, `t${from}`));
 	};
@@ -3723,14 +3996,14 @@ function projectUserText(text, sessionLabels, slashNames = [], slashKind = "skil
 		const contents = jsxs(Fragment, { children: [referenceKind !== void 0 && jsx(ReferenceIcon, {
 			kind: referenceKind,
 			size: 16,
-			className: css$14.refIcon
+			className: css$15.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$14.refChip, referenceKind === void 0 && css$14.slashChip);
+		const className = clsx(css$15.refChip, referenceKind === void 0 && css$15.slashChip);
 		parts.push(open === void 0 ? jsx("span", {
 			className,
 			"data-ref-chip": referenceKind ?? slashKind,
@@ -3750,7 +4023,7 @@ function projectUserText(text, sessionLabels, slashNames = [], slashKind = "skil
 		cursor = end;
 	}
 	if (parts.length === 0) return jsx("span", {
-		className: css$14.plainRun,
+		className: css$15.plainRun,
 		children: text
 	});
 	if (cursor < text.length) pushPlain(cursor, text.length);
@@ -3759,6 +4032,12 @@ function projectUserText(text, sessionLabels, slashNames = [], slashKind = "skil
 //#endregion
 //#region lib/types/Tooltip.js
 /**
+* Suppression channel from a tooltip to the tooltips above it: a tooltip hands
+* this setter to its own descendants, and a visible descendant bubble calls it
+* so the ancestor withdraws its bubble for as long as the descendant shows one.
+*/
+const TooltipSuppression = createContext(null);
+/**
 * Attach a hover/focus tooltip to an anchor element.
 * @param props.label - bubble text, or a resolver evaluated only while the bubble is visible.
 * @param props.side - placement relative to the anchor (default 'right').
@@ -3818,6 +4097,18 @@ function Tooltip({ label, side = "right", delayMs = 0, disabled = false, maxWidt
 		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(() => {
+		announce(visible);
+		return () => {
+			announce(false);
+		};
+	}, [announce, visible]);
 	const cancelShow = useCallback(() => {
 		if (showTimer.current === null) return;
 		clearTimeout(showTimer.current);
@@ -3846,6 +4137,7 @@ function Tooltip({ label, side = "right", delayMs = 0, disabled = false, maxWidt
 			top: r.top,
 			bottom: r.bottom
 		});
+		announce(true);
 	};
 	const showAfterHoverDelay = () => {
 		cancelShow();
@@ -3858,46 +4150,53 @@ function Tooltip({ label, side = "right", delayMs = 0, disabled = false, maxWidt
 			show();
 		}, delayMs);
 	};
+	const withdraw = () => {
+		setPos(null);
+		announce(false);
+	};
 	const hide = () => {
 		cancelShow();
-		if (!triggers.current.hover && !triggers.current.focus) setPos(null);
+		if (!triggers.current.hover && !triggers.current.focus) withdraw();
 	};
-	return jsxs(Fragment, { children: [cloneElement(children, {
-		ref: mergedRef,
-		onMouseEnter: (e) => {
-			children.props.onMouseEnter?.(e);
-			triggers.current.hover = true;
-			showAfterHoverDelay();
-		},
-		onMouseLeave: (e) => {
-			children.props.onMouseLeave?.(e);
-			triggers.current.hover = false;
-			cancelShow();
-			setPos(null);
-		},
-		onFocus: (e) => {
-			children.props.onFocus?.(e);
-			triggers.current.focus = true;
-			cancelShow();
-			show();
-		},
-		onBlur: (e) => {
-			children.props.onBlur?.(e);
-			triggers.current.focus = false;
-			hide();
-		}
-	}), pos !== null && jsx("span", {
-		ref: bubble,
-		className: css$15.bubble,
-		"data-side": placement,
-		style: {
-			left: pos.x,
-			top: y,
-			...maxWidth === void 0 ? {} : { maxWidth }
-		},
-		role: "tooltip",
-		children: resolvedLabel
-	})] });
+	return jsxs(TooltipSuppression.Provider, {
+		value: setSuppressed,
+		children: [cloneElement(children, {
+			ref: mergedRef,
+			onMouseEnter: (e) => {
+				children.props.onMouseEnter?.(e);
+				triggers.current.hover = true;
+				showAfterHoverDelay();
+			},
+			onMouseLeave: (e) => {
+				children.props.onMouseLeave?.(e);
+				triggers.current.hover = false;
+				cancelShow();
+				withdraw();
+			},
+			onFocus: (e) => {
+				children.props.onFocus?.(e);
+				triggers.current.focus = true;
+				cancelShow();
+				show();
+			},
+			onBlur: (e) => {
+				children.props.onBlur?.(e);
+				triggers.current.focus = false;
+				hide();
+			}
+		}), visible && !suppressed && jsx("span", {
+			ref: bubble,
+			className: css$16.bubble,
+			"data-side": placement,
+			style: {
+				left: pos.x,
+				top: y,
+				...maxWidth === void 0 ? {} : { maxWidth }
+			},
+			role: "tooltip",
+			children: resolvedLabel
+		})]
+	});
 }
 //#endregion
 //#region lib/types/Toast.js
@@ -3949,18 +4248,18 @@ function Toast({ text, icon, anchor, holdMs = HOLD_MS, onDone }) {
 		};
 	}, [anchor]);
 	return createPortal(jsxs("div", {
-		className: css$16.toast,
+		className: css$17.toast,
 		role: "alert",
 		style: {
 			...left === null ? {} : { left },
 			"--dsh-toast-hold": `${String(holdMs)}ms`
 		},
 		children: [icon !== void 0 && jsx("span", {
-			className: css$16.icon,
+			className: css$17.icon,
 			"aria-hidden": true,
 			children: icon
 		}), jsx("span", {
-			className: css$16.text,
+			className: css$17.text,
 			children: text
 		})]
 	}), document.body);
@@ -4110,6 +4409,18 @@ function rankByName(items, rawQuery) {
 	return ranked.map((match) => match.item);
 }
 //#endregion
+//#region lib/types/darwin-desktop.js
+/** macOS desktop detection for hiddenInset-titlebar layout variants. */
+/**
+* Whether the client runs in the macOS desktop shell: the Electron preload
+* marks `<html>` with `data-platform="darwin"`; plain web never sets it.
+* Read at render time — the mark may arrive as late as DOMContentLoaded.
+* @returns true only inside the macOS Electron shell.
+*/
+function isDarwinDesktop() {
+	return document.documentElement.dataset.platform === "darwin";
+}
+//#endregion
 //#region lib/types/JsonTree.js
 const OBJECT_PREVIEW_LIMIT = 4;
 const ARRAY_PREVIEW_LIMIT = 5;
@@ -4184,7 +4495,7 @@ function JsonCopyAction({ store, target, persistent, labels, onCopy, onClose })
 	const object = typeof target.value === "object" && target.value !== null;
 	const copyTitle = state === "copied" ? labels.copied : state === "failed" ? labels.copyFailed : object ? labels.copyPrettyJson : labels.copyValue;
 	return jsx("span", {
-		className: css$17.copySlot,
+		className: css$18.copySlot,
 		children: (persistent || snapshot !== void 0) && jsx(Menu, {
 			open: snapshot?.menuOpen === true,
 			compact: true,
@@ -4193,7 +4504,7 @@ function JsonCopyAction({ store, target, persistent, labels, onCopy, onClose })
 			anchor: jsx("button", {
 				ref: buttonRef,
 				type: "button",
-				className: css$17.actionButton,
+				className: css$18.actionButton,
 				"data-json-copy-button": true,
 				"data-state": state,
 				"aria-label": copyTitle,
@@ -4232,35 +4543,35 @@ function bracketOf(value) {
 }
 function previewPrimitive(value) {
 	if (value === null) return jsx("span", {
-		className: css$17.keywordValue,
+		className: css$18.keywordValue,
 		children: "null"
 	});
 	if (typeof value === "string") return jsx("span", {
-		className: css$17.stringValue,
+		className: css$18.stringValue,
 		children: JSON.stringify(value)
 	});
 	if (typeof value === "number") return jsx("span", {
-		className: css$17.numberValue,
+		className: css$18.numberValue,
 		children: String(value)
 	});
 	if (typeof value === "boolean") return jsx("span", {
-		className: css$17.keywordValue,
+		className: css$18.keywordValue,
 		children: String(value)
 	});
 	if (typeof value === "bigint") return jsx("span", {
-		className: css$17.otherValue,
+		className: css$18.otherValue,
 		children: value.toString()
 	});
 	if (typeof value === "undefined") return jsx("span", {
-		className: css$17.otherValue,
+		className: css$18.otherValue,
 		children: "undefined"
 	});
 	if (typeof value === "symbol") return jsx("span", {
-		className: css$17.otherValue,
+		className: css$18.otherValue,
 		children: value.description ?? "Symbol"
 	});
 	if (typeof value === "function") return jsx("span", {
-		className: css$17.otherValue,
+		className: css$18.otherValue,
 		children: value.name || "Function"
 	});
 	return null;
@@ -4274,71 +4585,71 @@ function previewValue(value, depth) {
 	const [open, close] = bracketOf(value);
 	return jsxs(Fragment, { children: [
 		jsx("span", {
-			className: css$17.punctuation,
+			className: css$18.punctuation,
 			children: open
 		}),
 		depth >= PREVIEW_DEPTH_LIMIT ? jsx("span", {
-			className: css$17.previewEllipsis,
+			className: css$18.previewEllipsis,
 			children: "…"
 		}) : visible.map(([key, item], index) => jsxs("span", { children: [
 			index > 0 && jsx("span", {
-				className: css$17.punctuation,
+				className: css$18.punctuation,
 				children: ", "
 			}),
 			!array && jsxs(Fragment, { children: [jsx("span", {
-				className: css$17.previewProperty,
+				className: css$18.previewProperty,
 				children: key
 			}), jsx("span", {
-				className: css$17.punctuation,
+				className: css$18.punctuation,
 				children: ": "
 			})] }),
 			previewValue(item, depth + 1)
 		] }, key)),
 		depth < PREVIEW_DEPTH_LIMIT && entries.length > limit && jsx("span", {
-			className: css$17.previewEllipsis,
+			className: css$18.previewEllipsis,
 			children: ", …"
 		}),
 		jsx("span", {
-			className: css$17.punctuation,
+			className: css$18.punctuation,
 			children: close
 		})
 	] });
 }
 function primitiveValue(value) {
 	if (value === null) return jsx("span", {
-		className: css$17.keywordValue,
+		className: css$18.keywordValue,
 		children: "null"
 	});
 	if (typeof value === "string") return jsx("span", {
-		className: css$17.stringValue,
+		className: css$18.stringValue,
 		children: JSON.stringify(value)
 	});
 	if (typeof value === "boolean") return jsx("span", {
-		className: css$17.keywordValue,
+		className: css$18.keywordValue,
 		children: String(value)
 	});
 	if (typeof value === "number") return jsx("span", {
-		className: css$17.numberValue,
+		className: css$18.numberValue,
 		children: String(value)
 	});
 	if (typeof value === "bigint") return jsx("span", {
-		className: css$17.numberValue,
+		className: css$18.numberValue,
 		children: `${value.toString()}n`
 	});
 	if (value instanceof Date) return jsx("span", {
-		className: css$17.otherValue,
+		className: css$18.otherValue,
 		children: value.toISOString()
 	});
 	if (typeof value === "function") return jsxs("span", {
-		className: css$17.otherValue,
+		className: css$18.otherValue,
 		children: ["function() ", "{ }"]
 	});
 	if (typeof value === "undefined") return jsx("span", {
-		className: css$17.otherValue,
+		className: css$18.otherValue,
 		children: "undefined"
 	});
 	return jsx("span", {
-		className: css$17.otherValue,
+		className: css$18.otherValue,
 		children: value.toString()
 	});
 }
@@ -4366,7 +4677,7 @@ function moveFocus(button, direction) {
 function NodeField({ field, expandable, onToggle }) {
 	if (field === void 0) return null;
 	return jsxs("span", {
-		className: clsx(css$17.label, expandable && css$17.clickableLabel),
+		className: clsx(css$18.label, expandable && css$18.clickableLabel),
 		onClick: expandable ? onToggle : void 0,
 		children: [fieldText(field), ":"]
 	});
@@ -4403,7 +4714,7 @@ function JsonString({ collapsedStringLines, stringWrapping, field, labels, lastE
 		if (!expanded) return;
 		const raw = rawRef.current;
 		const clips = [];
-		const tree = raw.closest(`.${css$17.root}`);
+		const tree = raw.closest(`.${css$18.root}`);
 		for (let parent = tree.parentElement; parent !== null; parent = parent.parentElement) if (/auto|scroll|hidden|clip/.test(getComputedStyle(parent).overflowY)) clips.push(parent);
 		const measure = () => {
 			let top = 0;
@@ -4432,33 +4743,33 @@ function JsonString({ collapsedStringLines, stringWrapping, field, labels, lastE
 	if (expanded) {
 		const fieldId = `${contentsId}-field`;
 		return jsxs("div", {
-			className: css$17.stringField,
+			className: css$18.stringField,
 			"data-expanded": true,
 			children: [
 				field !== void 0 && jsxs("span", {
 					id: fieldId,
-					className: css$17.label,
+					className: css$18.label,
 					children: [fieldText(field), ":"]
 				}),
 				jsx("pre", {
 					ref: rawRef,
 					id: contentsId,
-					className: css$17.stringRaw,
+					className: css$18.stringRaw,
 					"data-wrap": wrapped,
 					tabIndex: 0,
 					"aria-labelledby": field === void 0 ? void 0 : fieldId,
 					children: value
 				}),
 				!lastElement && jsx("span", {
-					className: css$17.punctuation,
+					className: css$18.punctuation,
 					children: ","
 				}),
 				jsxs("div", {
-					className: css$17.stringActions,
+					className: css$18.stringActions,
 					children: [
 						stringWrapping !== void 0 && jsx("button", {
 							type: "button",
-							className: css$17.actionButton,
+							className: css$18.actionButton,
 							"aria-label": stringWrapping.label,
 							title: stringWrapping.label,
 							"aria-pressed": wrapped,
@@ -4472,7 +4783,7 @@ function JsonString({ collapsedStringLines, stringWrapping, field, labels, lastE
 						}),
 						jsx("button", {
 							type: "button",
-							className: css$17.actionButton,
+							className: css$18.actionButton,
 							"aria-label": labels.collapseNode,
 							title: labels.collapseNode,
 							"aria-expanded": true,
@@ -4498,18 +4809,18 @@ function JsonString({ collapsedStringLines, stringWrapping, field, labels, lastE
 		});
 	}
 	return jsxs(Fragment, { children: [renderCopy?.(), jsx("span", {
-		className: css$17.stringField,
+		className: css$18.stringField,
 		"data-expanded": expanded,
 		children: jsxs("span", {
 			ref: contentRef,
 			id: contentsId,
-			className: css$17.stringText,
+			className: css$18.stringText,
 			children: [
 				truncated && jsx("span", {
-					className: css$17.stringToggleSlot,
+					className: css$18.stringToggleSlot,
 					children: jsxs("button", {
 						type: "button",
-						className: css$17.stringToggle,
+						className: css$18.stringToggle,
 						"aria-label": labels.expandNode,
 						"aria-expanded": false,
 						"aria-controls": contentsId,
@@ -4524,12 +4835,12 @@ function JsonString({ collapsedStringLines, stringWrapping, field, labels, lastE
 					})
 				}),
 				field !== void 0 && jsxs("span", {
-					className: css$17.label,
+					className: css$18.label,
 					children: [fieldText(field), ":"]
 				}),
 				primitiveValue(value),
 				!lastElement && jsx("span", {
-					className: css$17.punctuation,
+					className: css$18.punctuation,
 					children: ","
 				})
 			]
@@ -4560,7 +4871,7 @@ function JsonTreeNode({ collapsedStringLines, stringWrapping, field, initialExpa
 		}
 	};
 	const row = (children, ariaExpanded) => jsxs("div", {
-		className: css$17.row,
+		className: css$18.row,
 		role: "treeitem",
 		"aria-expanded": ariaExpanded,
 		onMouseOver: (event) => {
@@ -4595,7 +4906,7 @@ function JsonTreeNode({ collapsedStringLines, stringWrapping, field, initialExpa
 		}),
 		primitiveValue(value),
 		!lastElement && jsx("span", {
-			className: css$17.punctuation,
+			className: css$18.punctuation,
 			children: ","
 		})
 	] }));
@@ -4607,22 +4918,22 @@ function JsonTreeNode({ collapsedStringLines, stringWrapping, field, initialExpa
 			onToggle: toggle
 		}),
 		jsx("span", {
-			className: css$17.punctuation,
+			className: css$18.punctuation,
 			children: open
 		}),
 		jsx("span", {
-			className: css$17.punctuation,
+			className: css$18.punctuation,
 			children: close
 		}),
 		!lastElement && jsx("span", {
-			className: css$17.punctuation,
+			className: css$18.punctuation,
 			children: ","
 		})
 	] }));
 	return row(jsxs(Fragment, { children: [
 		jsx("span", {
 			ref: expanderRef,
-			className: clsx(css$17.expander, expanded ? css$17.collapseIcon : css$17.expandIcon),
+			className: clsx(css$18.expander, expanded ? css$18.collapseIcon : css$18.expandIcon),
 			"data-json-expander": true,
 			role: "button",
 			"aria-label": expanded ? labels.collapseNode : labels.expandNode,
@@ -4636,7 +4947,7 @@ function JsonTreeNode({ collapsedStringLines, stringWrapping, field, initialExpa
 			onKeyDown: onExpanderKeyDown
 		}),
 		jsxs("span", {
-			className: css$17.summary,
+			className: css$18.summary,
 			children: [
 				jsx(NodeField, {
 					field,
@@ -4644,11 +4955,11 @@ function JsonTreeNode({ collapsedStringLines, stringWrapping, field, initialExpa
 					onToggle: toggle
 				}),
 				jsx("span", {
-					className: css$17.preview,
+					className: css$18.preview,
 					children: previewValue(value, 0)
 				}),
 				!lastElement && jsx("span", {
-					className: css$17.punctuation,
+					className: css$18.punctuation,
 					children: ","
 				})
 			]
@@ -4656,7 +4967,7 @@ function JsonTreeNode({ collapsedStringLines, stringWrapping, field, initialExpa
 		expanded && jsx("ul", {
 			id: contentsId,
 			role: "group",
-			className: css$17.children,
+			className: css$18.children,
 			children: entries.map(([key, item], index) => jsx(JsonTreeNode, {
 				collapsedStringLines,
 				stringWrapping,
@@ -4788,17 +5099,17 @@ function JsonTree({ data, label, className, collapsedStringLines = 3, stringWrap
 		onClose: clearCopyTarget
 	}) : void 0;
 	return jsx("div", {
-		className: clsx(css$17.root, className),
+		className: clsx(css$18.root, className),
 		style: { "--json-tree-collapsed-lines": collapsedStringLines },
 		onMouseOver: handleRootMouseOver,
 		onMouseLeave: () => {
 			if (!copyStore.get()?.menuOpen) clearCopyTarget();
 		},
 		children: expandTopLevel ? jsxs("div", {
-			className: css$17.expandedTopLevel,
+			className: css$18.expandedTopLevel,
 			children: [
 				jsxs("div", {
-					className: clsx(css$17.row, css$17.topLevelBracket),
+					className: clsx(css$18.row, css$18.topLevelBracket),
 					"data-json-root-row": true,
 					onMouseOver: (event) => {
 						event.stopPropagation();
@@ -4811,13 +5122,13 @@ function JsonTree({ data, label, className, collapsedStringLines = 3, stringWrap
 						path: [],
 						value: data
 					}), jsx("span", {
-						className: css$17.punctuation,
+						className: css$18.punctuation,
 						children: rootOpen
 					})]
 				}),
 				jsx("div", {
 					"aria-label": label,
-					className: clsx(css$17.container, css$17.expandedTopLevelContainer),
+					className: clsx(css$18.container, css$18.expandedTopLevelContainer),
 					role: "tree",
 					children: rootEntries.map(([key, value], index) => jsx(JsonTreeNode, {
 						collapsedStringLines,
@@ -4835,16 +5146,16 @@ function JsonTree({ data, label, className, collapsedStringLines = 3, stringWrap
 					}, key))
 				}),
 				jsx("div", {
-					className: clsx(css$17.row, css$17.topLevelBracket),
+					className: clsx(css$18.row, css$18.topLevelBracket),
 					children: jsx("span", {
-						className: css$17.punctuation,
+						className: css$18.punctuation,
 						children: rootClose
 					})
 				})
 			]
 		}) : jsx("div", {
 			"aria-label": label,
-			className: css$17.container,
+			className: css$18.container,
 			role: "tree",
 			children: jsx(JsonTreeNode, {
 				collapsedStringLines,
@@ -4870,8 +5181,10 @@ function JsonTree({ data, label, className, collapsedStringLines = 3, stringWrap
 * semantic. Black and white both resolve to the primary label color so text
 * stays legible under either theme instead of matching the surface it sits
 * on; bright black takes the tertiary label color (the muted-gray role).
-* Magenta and cyan have no token equivalent in this design system and fall
-* through to anser's literal rgb, as do all 256-palette and truecolor values.
+* Cyan and bright cyan take two static blues: the design system has no cyan,
+* and anser's literal bright cyan is unreadable on the light theme's code
+* surface. Magenta has no token equivalent and falls through to anser's
+* literal rgb, as do all 256-palette and truecolor values.
 */
 const TOKEN_BY_BASIC_RGB = {
 	"0,0,0": "var(--dsw-alias-label-primary)",
@@ -4884,7 +5197,9 @@ const TOKEN_BY_BASIC_RGB = {
 	"187,187,0": "var(--dsw-alias-state-warn-primary)",
 	"255,255,85": "var(--dsw-alias-state-warn-secondary)",
 	"0,0,187": "var(--dsw-alias-state-business-primary)",
-	"85,85,255": "var(--dsw-static-blue-400)"
+	"85,85,255": "var(--dsw-static-blue-400)",
+	"0,187,187": "var(--dsw-static-blue-600)",
+	"85,255,255": "var(--dsw-static-blue-500)"
 };
 /**
 * CSS for each SGR attribute anser reports. `blink` is deliberately absent —
@@ -5324,13 +5639,14 @@ function promptLabel(cwd, home) {
 * Status pill text for a settled command, or undefined when the command
 * settled cleanly (exit 0, no signal) and needs no pill — the same
 * distinction the bash tool's own exit-status markers draw.
-* @param exitCode - settled exit code, when known.
+* @param exitCode - settled exit code, when known; null when the command settled without one.
 * @param signal - settled terminating signal name, when known.
 * @param labels - display copy for the pill text.
 * @returns the pill text, or undefined for a clean exit.
 */
 function statusText(exitCode, signal, labels) {
 	if (signal !== void 0) return labels.signal(signal);
+	if (exitCode === null) return labels.noExitCode;
 	if (exitCode !== void 0 && exitCode !== 0) return labels.exitCode(exitCode);
 }
 /**
@@ -5344,7 +5660,7 @@ function statusText(exitCode, signal, labels) {
 * settled command whose exit status never reached the view counts as a clean
 * settle: the view says it finished and says nothing went wrong.
 * @param running - the command has not settled.
-* @param exitCode - settled exit code, when known.
+* @param exitCode - settled exit code, when known; null when the command settled without one.
 * @param signal - settled terminating signal name, when known.
 * @param labels - display copy for the text label.
 * @returns the dot's state and its text label, since the dot is aria-hidden.
@@ -5400,67 +5716,69 @@ function TerminalBlock({ command, cwd, home, output, exitCode, signal, running =
 	}, [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;
 	return jsxs("div", {
-		className: clsx(css$18.block, className),
+		className: clsx(css$19.block, className),
 		"data-terminal": "",
 		"data-running": running ? "" : void 0,
+		"data-body": body ? "" : void 0,
 		children: [jsxs("div", {
-			className: css$18.header,
+			className: css$19.header,
 			children: [
 				jsxs("div", {
-					className: css$18.prompt,
+					className: css$19.prompt,
 					children: [jsx("span", {
-						className: css$18.runStateLabel,
+						className: css$19.runStateLabel,
 						children: state.label
 					}), commandLines.map((line, index) => jsxs("div", {
-						className: css$18.promptLine,
+						className: css$19.promptLine,
 						children: [
 							index === 0 && jsx(StateDot, {
 								state: state.state,
-								className: css$18.runState
+								className: css$19.runState
 							}),
 							jsx("span", {
-								className: css$18.cwd,
+								className: css$19.cwd,
 								children: index > 0 || cwd === void 0 ? "$" : promptLabel(cwd, home)
 							}),
 							jsx("span", {
-								className: css$18.command,
+								className: css$19.command,
 								children: line
 							})
 						]
 					}, index))]
 				}),
 				status !== void 0 && jsx(Pill, {
-					className: css$18.status,
+					className: css$19.status,
 					children: status
 				}),
 				!running && !empty && jsx("button", {
 					type: "button",
-					className: css$18.copyButton,
+					className: css$19.copyButton,
 					onClick: onCopy,
 					children: copied ? copy.copied : copy.copy
 				})
 			]
-		}), !running && (empty ? jsx("div", {
-			className: css$18.empty,
+		}), body && (empty ? jsx("div", {
+			className: css$19.empty,
 			children: copy.noOutput
 		}) : jsxs("div", {
-			className: css$18.output,
+			className: css$19.output,
 			children: [
 				(capped ? lines.slice(0, headLines) : lines).map((line, index) => jsx("div", {
-					className: css$18.line,
+					className: css$19.line,
 					children: renderLine$1(line)
 				}, index)),
 				hidden > 0 && jsx("button", {
 					type: "button",
-					className: css$18.expand,
+					className: css$19.expand,
 					"aria-expanded": expanded,
 					"aria-label": expanded ? copy.collapseAria : copy.expandAria(hidden),
 					onClick: onToggle,
 					children: expanded ? copy.collapse : copy.expand(hidden)
 				}),
 				capped && lines.slice(lines.length - tailLines).map((line, index) => jsx("div", {
-					className: css$18.line,
+					className: css$19.line,
 					children: renderLine$1(line)
 				}, index))
 			]
@@ -6038,51 +6356,51 @@ function ReadBlock({ label, labels, lines, totalLines, lang, maxLines = 16, clas
 	const tailLines = maxLines - headLines;
 	const windowed = lines.length < totalLines;
 	const rows = (slice) => slice.map(([line, spans]) => jsxs("div", {
-		className: css$19.line,
+		className: css$20.line,
 		children: [jsx("span", {
-			className: css$19.gutter,
+			className: css$20.gutter,
 			"aria-hidden": true,
 			children: line.number
 		}), jsx("span", {
-			className: css$19.content,
+			className: css$20.content,
 			children: spans === void 0 ? line.text : renderSpans(spans)
 		})]
 	}, line.number));
 	const paired = lines.map((line, index) => [line, highlighted?.[index]]);
 	return jsxs("div", {
 		ref: rootRef,
-		className: clsx(css$19.block, className),
+		className: clsx(css$20.block, className),
 		"data-read": "",
 		children: [jsxs("div", {
-			className: css$19.banner,
+			className: css$20.banner,
 			children: [jsx("div", {
-				className: css$19.label,
+				className: css$20.label,
 				children: label ?? ""
 			}), jsxs("div", {
-				className: css$19.action,
+				className: css$20.action,
 				children: [
 					windowed && jsx("span", {
-						className: css$19.count,
+						className: css$20.count,
 						children: labels.window(lines.length, totalLines)
 					}),
 					jsx("span", {
-						className: css$19.lang,
+						className: css$20.lang,
 						children: lang ?? ""
 					}),
 					lines.length > 0 && jsx("button", {
 						type: "button",
-						className: css$19.copyButton,
+						className: css$20.copyButton,
 						onClick: onCopy,
 						children: copied ? labels.copied : labels.copy
 					})
 				]
 			})]
 		}), jsxs("div", {
-			className: css$19.body,
+			className: css$20.body,
 			children: [
 				rows(capped ? paired.slice(0, headLines) : paired),
 				hidden > 0 && jsx(FoldToggle, {
-					className: css$19.expand,
+					className: css$20.expand,
 					expanded,
 					hidden,
 					labels,
@@ -6104,11 +6422,11 @@ function assertNever(value) {
 }
 /** The dim class per row kind (path/gap chrome vs the diff's own +/- colors). */
 const ROW_CLASS = {
-	path: css$20.path,
-	del: css$20.del,
-	add: css$20.add,
-	context: css$20.context,
-	gap: css$20.gap
+	path: css$21.path,
+	del: css$21.del,
+	add: css$21.add,
+	context: css$21.context,
+	gap: css$21.gap
 };
 /** Bound synchronous edit-graph search; one replacement consumes two edits. */
 const MAX_DIFF_EDIT_LENGTH = 256;
@@ -6246,37 +6564,37 @@ function DiffBlock({ diffs, labels, maxLines = 16, className }) {
 	const head = capped ? rows.slice(0, headLines) : rows;
 	const tail = capped ? rows.slice(rows.length - tailLines) : [];
 	return jsxs("div", {
-		className: clsx(css$20.block, className),
+		className: clsx(css$21.block, className),
 		"data-diff": "",
 		children: [
 			jsx("button", {
 				type: "button",
-				className: css$20.copyButton,
+				className: css$21.copyButton,
 				onClick: onCopy,
 				children: copied ? labels.copied : labels.copy
 			}),
 			jsxs("div", {
-				className: css$20.body,
+				className: css$21.body,
 				children: [
 					head.map((row, index) => jsx("div", {
-						className: clsx(css$20.line, ROW_CLASS[row.kind]),
+						className: clsx(css$21.line, ROW_CLASS[row.kind]),
 						children: row.text
 					}, index)),
 					hidden > 0 && jsx(FoldToggle, {
-						className: css$20.expand,
+						className: css$21.expand,
 						expanded,
 						hidden,
 						labels,
 						onToggle
 					}),
 					tail.map((row, index) => jsx("div", {
-						className: clsx(css$20.line, ROW_CLASS[row.kind]),
+						className: clsx(css$21.line, ROW_CLASS[row.kind]),
 						children: row.text
 					}, index))
 				]
 			}),
 			jsxs("div", {
-				className: css$20.footer,
+				className: css$21.footer,
 				children: [
 					"└ +",
 					added,
@@ -6412,56 +6730,56 @@ function SearchBlock(props) {
 	const tail = tailHeader === void 0 ? naturalTail : naturalTail.slice(1);
 	const renderRow = (row) => {
 		if (row.type === "path") return jsx("div", {
-			className: css$21.line,
+			className: css$22.line,
 			children: row.path
 		});
 		if (row.type === "match") return jsxs("div", {
-			className: css$21.line,
+			className: css$22.line,
 			children: [jsxs("span", {
-				className: css$21.lineNumber,
+				className: css$22.lineNumber,
 				children: [row.lineNumber, ": "]
 			}), row.line]
 		});
 		return jsxs("button", {
 			type: "button",
-			className: css$21.fileHeader,
+			className: css$22.fileHeader,
 			"aria-expanded": !row.collapsed,
 			onClick: () => {
 				toggleFile(row.index);
 			},
 			children: [jsx("span", {
-				className: css$21.filePath,
+				className: css$22.filePath,
 				children: row.path
 			}), jsx("span", {
-				className: css$21.fileCount,
+				className: css$22.fileCount,
 				children: row.count
 			})]
 		});
 	};
 	return jsxs("div", {
-		className: clsx(css$21.block, className),
+		className: clsx(css$22.block, className),
 		"data-search": props.kind,
 		children: [jsxs("div", {
-			className: css$21.header,
+			className: css$22.header,
 			children: [jsx("span", {
-				className: css$21.summary,
+				className: css$22.summary,
 				children: summaryText(props, shown, truncated, total)
 			}), !empty && jsx("button", {
 				type: "button",
-				className: css$21.copyButton,
+				className: css$22.copyButton,
 				onClick: onCopy,
 				children: copied ? props.labels.copied : props.labels.copy
 			})]
 		}), empty ? jsx("div", {
-			className: css$21.empty,
+			className: css$22.empty,
 			children: props.labels.noResults
 		}) : jsxs("div", {
-			className: css$21.body,
+			className: css$22.body,
 			children: [
 				head.map((row) => jsx("div", { children: renderRow(row) }, rowKey(row))),
 				hidden > 0 && jsx("button", {
 					type: "button",
-					className: css$21.expand,
+					className: css$22.expand,
 					"aria-expanded": expanded,
 					"aria-label": expanded ? props.labels.collapseAria : props.labels.expandAria(hidden),
 					onClick: onToggle,
@@ -7263,7 +7581,7 @@ function CodeBlock({ code, lang, streaming, className, contentRef, lineNumbers =
 		});
 	}, [copied, trimmed]);
 	const body = streamedBody !== void 0 ? streamedBody : html === void 0 ? jsx("pre", {
-		className: css$22.plain,
+		className: css$23.plain,
 		children: jsx("code", { children: sourceLines === void 0 ? trimmed : sourceLines.map((line, index) => jsxs(Fragment$1, { children: [index > 0 && "\n", jsx("span", {
 			className: "line",
 			children: line
@@ -7271,22 +7589,22 @@ function CodeBlock({ code, lang, streaming, className, contentRef, lineNumbers =
 	}) : jsx("div", { dangerouslySetInnerHTML: { __html: html } });
 	return jsxs("div", {
 		ref: rootRef,
-		className: clsx(css$22.block, "md-code-block", lineNumbers && css$22.numbered, className),
+		className: clsx(css$23.block, "md-code-block", lineNumbers && css$23.numbered, className),
 		"data-line-numbers": lineNumbers || void 0,
 		style: sourceLines === void 0 ? void 0 : { "--dsl-code-block-line-number-width": `${Math.max(2, String(sourceLines.length).length)}ch` },
 		children: [showHeader && jsx("div", {
-			className: css$22.bannerWrap,
+			className: css$23.bannerWrap,
 			children: jsxs("div", {
-				className: css$22.banner,
+				className: css$23.banner,
 				"data-code-block-banner": true,
 				children: [jsx("div", {
-					className: css$22.infostring,
+					className: css$23.infostring,
 					children: lang ?? ""
 				}), jsx("div", {
-					className: css$22.action,
+					className: css$23.action,
 					children: jsx("button", {
 						type: "button",
-						className: css$22.copyButton,
+						className: css$23.copyButton,
 						onClick: onCopy,
 						children: copied ? copiedLabel : copyLabel
 					})
@@ -7294,13 +7612,46 @@ function CodeBlock({ code, lang, streaming, className, contentRef, lineNumbers =
 			})
 		}), jsx("div", {
 			ref: contentRef,
-			className: css$22.content,
+			className: css$23.content,
 			"data-code-block-content": true,
 			children: body
 		})]
 	});
 }
 //#endregion
+//#region lib/types/markdown/file-link.js
+/** Local Markdown destinations accepted by the file-preview callback. */
+/**
+* Decode a file destination and its optional GitHub-style line fragment.
+* Literal `?` and `#` in filenames must be percent-encoded.
+* @param value - Parsed Markdown link destination.
+* @returns A local path and optional first line, or undefined for URLs,
+* fragment-only links, queries, malformed escapes, or invalid line ranges.
+*/
+function parseFileLink(value) {
+	const hash = value.indexOf("#");
+	const destination = hash < 0 ? value : value.slice(0, hash);
+	if (destination.includes("?")) return void 0;
+	let path;
+	try {
+		path = decodeURIComponent(destination);
+	} catch (_error) {
+		return;
+	}
+	if (path.length === 0 || /[\u0000-\u001f\u007f]/.test(path) || /^[\\/]{2}/.test(path) || /^[a-z][a-z\d+.-]*:/i.test(path) && !/^[a-z]:[\\/]/i.test(path)) return void 0;
+	if (hash < 0) return { path };
+	const fragment = value.slice(hash + 1);
+	const match = /^L([1-9]\d*)(?:-L([1-9]\d*))?$/.exec(fragment);
+	if (match === null) return void 0;
+	const line = Number(match[1]);
+	const end = match[2] === void 0 ? line : Number(match[2]);
+	if (!Number.isSafeInteger(line) || !Number.isSafeInteger(end) || end < line) return void 0;
+	return {
+		path,
+		line
+	};
+}
+//#endregion
 //#region lib/types/markdown/katex.js
 /**
 * TeX-to-React via KaTeX, replicating the rehype-katex pipeline this renderer
@@ -7382,6 +7733,33 @@ function renderTexToReact(value, displayMode) {
 	return [...new DOMParser().parseFromString(html, "text/html").body.childNodes].map(domToReact);
 }
 //#endregion
+//#region lib/types/markdown/MarkdownDelegate.js
+/** Consumer-owned navigation for Markdown links. */
+const MarkdownDelegateContext = createContext({});
+/**
+* Scope Markdown navigation without threading callbacks through renderers.
+* Nested providers replace the enclosing capabilities. Handler changes reach cached links.
+* @param props - Child tree and its file and HTTP(S) link handlers.
+* @returns the scoped child tree.
+*/
+function MarkdownDelegateProvider({ children, openExternalLink, openFile }) {
+	const delegate = useMemo(() => ({
+		openExternalLink,
+		openFile
+	}), [openExternalLink, openFile]);
+	return jsx(MarkdownDelegateContext.Provider, {
+		value: delegate,
+		children
+	});
+}
+/**
+* Read the nearest Markdown navigation capabilities.
+* @returns Owner callbacks, or an empty delegate outside a provider.
+*/
+function useMarkdownDelegate() {
+	return useContext(MarkdownDelegateContext);
+}
+//#endregion
 //#region lib/types/markdown/render.js
 /**
 * Direct mdast→React markdown renderer. Replaces the react-markdown /
@@ -7389,8 +7767,8 @@ function renderTexToReact(value, displayMode) {
 * cache frozen blocks as React elements; the rendered DOM is pinned
 * byte-for-byte by `tests/fixtures/markdown-dom` and must not drift.
 *
-* Untrusted-output policy (unchanged from the replaced pipeline): link and
-* image destinations pass a protocol allowlist, images additionally require
+* External link and image destinations pass a protocol allowlist; settled
+* local file links use an explicit owner callback. Images additionally require
 * absolute HTTP(S), raw HTML renders as literal text (no HTML enters the
 * DOM), and KaTeX runs without trusted commands. Fragment-anchor URLs fail
 * the allowlist, so footnote references and back-references render as plain
@@ -7556,7 +7934,7 @@ function renderNode(node, key, context) {
 		case "link": return renderAnchor(node.url, renderChildren(node.children, {
 			...context,
 			inLink: true
-		}), key, !anchorWrapsOnlyImages(node.children));
+		}), key, !anchorWrapsOnlyImages(node.children), context.streaming);
 		case "linkReference": return renderLinkReference(node, key, context);
 		case "image": return renderImage(node.url, node.alt ?? "", key, context);
 		case "imageReference": return renderImageReference(node, key, context);
@@ -7659,26 +8037,64 @@ function renderTableRow(row, cellTag, align, key, context) {
 function anchorWrapsOnlyImages(children) {
 	return children.length > 0 && children.every((child) => child.type === "image" || child.type === "imageReference");
 }
-/** Anchor over an already-authored href: allowlisted or unwrapped, external links get the safe attributes. */
+/** Anchor over an already-authored href: allowlisted or unwrapped, with optional owner navigation for HTTP(S). */
 function renderSafeLink(href, children, key, glyph = true) {
 	const safeHref = sanitizeUrl(href);
 	if (safeHref === "") return jsx(Fragment$1, { children }, key);
-	return jsxs("a", {
+	return jsx(MarkdownAnchor, {
 		href: safeHref,
-		...["http:", "https:"].includes(new URL(safeHref).protocol) ? {
+		glyph,
+		children
+	}, key);
+}
+function MarkdownAnchor({ href, glyph, children }) {
+	const { openExternalLink } = useMarkdownDelegate();
+	const external = ["http:", "https:"].includes(new URL(href).protocol);
+	const open = external ? openExternalLink : void 0;
+	return jsxs("a", {
+		href,
+		...external ? {
 			target: "_blank",
 			rel: "noopener noreferrer"
 		} : {},
+		onClick: open === void 0 ? void 0 : (event) => {
+			if (event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return;
+			event.preventDefault();
+			open(href);
+		},
 		children: [glyph && jsx(LinkIcon, {
 			kind: "url",
+			href,
 			className: markdownCss.linkIcon
 		}), children]
-	}, key);
+	});
 }
-/** Anchor over a parsed markdown destination, which hast normalized before the allowlist saw it. */
-function renderAnchor(url, children, key, glyph = true) {
+/** Local destinations use the scoped file delegate after settlement. */
+function renderAnchor(url, children, key, glyph = true, streaming = false) {
+	const file = streaming ? void 0 : parseFileLink(url);
+	if (file !== void 0) return jsx(MarkdownFileLink, {
+		file,
+		glyph,
+		children
+	}, key);
 	return renderSafeLink(normalizeUri(url), children, key, glyph);
 }
+function MarkdownFileLink({ file, glyph, children }) {
+	const { openFile } = useMarkdownDelegate();
+	if (openFile === void 0) return jsx(Fragment, { children });
+	return jsxs("button", {
+		type: "button",
+		className: clsx(markdownCss.fileMention, markdownCss.fileLink),
+		title: file.path,
+		onClick: () => {
+			openFile(file.path, file.line === void 0 ? void 0 : { line: file.line });
+		},
+		children: [glyph && jsx(LinkIcon, {
+			kind: classifyLinkPath(file.path),
+			className: markdownCss.linkIcon
+		}), children]
+	});
+}
 /**
 * The complete inline-code value when it is exactly an absolute HTTP(S) URL
 * (no surrounding whitespace); anything else stays inert code.
@@ -7740,7 +8156,7 @@ function renderLinkReference(node, key, context) {
 		...context,
 		inLink: true
 	});
-	return renderAnchor(definition.url, rendered, key, !anchorWrapsOnlyImages(node.children));
+	return renderAnchor(definition.url, rendered, key, !anchorWrapsOnlyImages(node.children), context.streaming);
 }
 function renderImageReference(node, key, context) {
 	const definition = context.targets.definitions.get(node.identifier.toUpperCase());
@@ -7928,15 +8344,21 @@ var StreamingRenderer = class {
 * identity discards the streaming render cache mid-message. `fileMentions`
 * links inline-code tokens its resolver recognizes as real files, and
 * `pathImages` rewrites image destinations that are local file paths into
-* displayable URLs its resolver vouches for; both vocabularies are the
+* displayable URLs its resolver vouches for. Those two vocabularies are the
 * single streaming gate — they apply to settled renders only, because a
 * streaming message's vocabulary is not final and frozen cached elements
-* must not bake in handlers that could go stale.
-* @returns A GFM document with TeX math rendered through KaTeX; raw HTML,
-* relative links, and unsafe protocols are disabled, while absolute HTTP(S)
-* images render directly.
-*/
-const MarkdownText = memo(function MarkdownText({ text, streaming = false, labels, fileMentions, pathImages }) {
+* must not bake in handlers that could go stale. A surrounding
+* `MarkdownDelegateProvider` can delegate ordinary HTTP(S) activation while
+* modified clicks retain native behavior. `variant="compact"` uses secondary
+* text sizing, uniform bold headings, and tight block spacing; the default
+* `body` variant uses the full document typography.
+* The provider's `openFile` enables local Markdown links in settled messages,
+* including `#L24` and `#L24-L30` destinations (ranges open at their first line).
+* @returns A GFM document with TeX math rendered through KaTeX; raw HTML and
+* unsafe protocols are disabled. Local links without an opener remain text;
+* absolute HTTP(S) images render directly.
+*/
+const MarkdownText = memo(function MarkdownText({ text, streaming = false, labels, fileMentions, pathImages, variant = "body" }) {
 	const streamRef = useRef(null);
 	const streamLabelsRef = useRef(labels);
 	const children = useMemo(() => {
@@ -7957,7 +8379,8 @@ const MarkdownText = memo(function MarkdownText({ text, streaming = false, label
 		pathImages
 	]);
 	return jsx("div", {
-		className: markdownCss.markdown,
+		className: clsx(markdownCss.markdown, variant === "compact" && markdownCss.compact),
+		"data-markdown-variant": variant === "compact" ? variant : void 0,
 		children
 	});
 });
@@ -8020,7 +8443,8 @@ function SafeLink({ url, label, className }) {
 		rel: "noopener noreferrer",
 		children: [jsx(LinkIcon, {
 			kind: "url",
-			className: css$23.linkIcon
+			href,
+			className: css$24.linkIcon
 		}), label]
 	});
 }
@@ -8035,20 +8459,20 @@ function SafeLink({ url, label, className }) {
 */
 function SourceItem({ source, ordinal }) {
 	return jsxs("li", {
-		className: css$23.source,
+		className: css$24.source,
 		value: ordinal,
 		children: [
 			jsx(SafeLink, {
 				url: source.url,
 				label: linkLabel(source.url, source.title),
-				className: css$23.sourceLink
+				className: css$24.sourceLink
 			}),
 			source.snippet !== void 0 && source.snippet !== "" && jsx("div", {
-				className: css$23.snippet,
+				className: css$24.snippet,
 				children: source.snippet
 			}),
 			source.publishedAt !== void 0 && source.publishedAt !== "" && jsx("div", {
-				className: css$23.published,
+				className: css$24.published,
 				children: source.publishedAt
 			})
 		]
@@ -8063,28 +8487,28 @@ function SourceItem({ source, ordinal }) {
 function WebSearchBlock({ answer, sources, truncated, labels, className }) {
 	const empty = (answer === void 0 || answer === "") && sources.length === 0;
 	return jsxs("div", {
-		className: clsx(css$23.block, className),
+		className: clsx(css$24.block, className),
 		"data-web": "search",
 		children: [
 			answer !== void 0 && answer !== "" && jsx("div", {
-				className: css$23.answer,
+				className: css$24.answer,
 				children: jsx(MarkdownText, {
 					text: answer,
 					labels: labels.markdown
 				})
 			}),
 			empty ? jsx("div", {
-				className: css$23.empty,
+				className: css$24.empty,
 				children: labels.noResults
 			}) : jsx("ol", {
-				className: css$23.sources,
+				className: css$24.sources,
 				children: sources.map((source, index) => jsx(SourceItem, {
 					source,
 					ordinal: index + 1
 				}, index))
 			}),
 			truncated && jsx("div", {
-				className: css$23.truncated,
+				className: css$24.truncated,
 				children: labels.sourcesTruncated
 			})
 		]
@@ -8097,23 +8521,23 @@ function WebSearchBlock({ answer, sources, truncated, labels, className }) {
 */
 function WebFetchBlock({ url, statusCode, truncated, labels, className }) {
 	return jsxs("div", {
-		className: clsx(css$23.block, css$23.fetch, className),
+		className: clsx(css$24.block, css$24.fetch, className),
 		"data-web": "fetch",
 		children: [jsx(SafeLink, {
 			url,
 			label: url,
-			className: css$23.fetchUrl
+			className: css$24.fetchUrl
 		}), jsxs("div", {
-			className: css$23.fetchMeta,
+			className: css$24.fetchMeta,
 			children: [jsxs("span", {
-				className: css$23.status,
+				className: css$24.status,
 				children: [
 					labels.http,
 					" ",
 					statusCode
 				]
 			}), truncated && jsx("span", {
-				className: css$23.truncated,
+				className: css$24.truncated,
 				children: labels.contentTruncated
 			})]
 		})]
@@ -8147,10 +8571,10 @@ function JsonBlock({ label, payload, defaultOpen = false, truncatedLabel }) {
 		truncatedLabel
 	]);
 	return jsxs("div", {
-		className: css$24.root,
+		className: css$25.root,
 		children: [jsxs("button", {
 			type: "button",
-			className: css$24.toggle,
+			className: css$25.toggle,
 			onClick: () => {
 				setOpen((v) => !v);
 			},
@@ -8160,7 +8584,7 @@ function JsonBlock({ label, payload, defaultOpen = false, truncatedLabel }) {
 				label
 			]
 		}), open && jsx("pre", {
-			className: css$24.body,
+			className: css$25.body,
 			children: body
 		})]
 	});
@@ -8237,6 +8661,6 @@ function extractMarkdownPlainText(markdown, options = {}) {
 	}
 }
 //#endregion
-export { BrandWordmark, Button, CodeBlock, 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, HoverCard, IconAgentPresetOutline16, IconAlarmClockOutline16, IconApiOutline14, IconArchiveOutline20, IconBranchOutline16, IconBrowseOutline16, IconCheckOutline14, IconCheckOutline16, IconChecklistOutline14, IconChevronDownOutline14, IconChevronLeftOutline14, IconChevronRightOutline14, IconChevronUpOutline14, IconClockOutline16, IconCloseFill14, IconCloseOutline16, IconCodeOutline16, IconCompactOutline16, IconContextInjectionOutline16, IconCopyOutline16, IconCordisPluginOutline14, IconDarkOutline16, IconDataOutline16, IconDatabaseOutline16, IconDislikeFill16, IconDislikeOutline16, IconDownloadOutline16, IconEditOutline16, IconEllipsisOutline16, IconEnhanceOutline16, IconFolderClose16, IconFolderOpen16, IconFolderOpenOutline16, IconFollowsystemOutline16, IconFullscreenOutline16, IconGaugeOutline16, IconGlobeOutline14, IconGoalOutline16, IconInspectOutline12, IconLightOutline16, IconLikeFill16, IconLikeOutline16, IconLinkOutline14, IconLinkOutline16, IconListPenOutline16, IconLoadingOutline16, IconNewChatOutline16, IconPanelLeftOutline16, IconPaperPlaneOutline14, IconPaperclipOutline16, IconPauseOutline16, IconPersonalizationOutline16, IconPlanOutline14, IconPlayOutline16, IconPlusOutline16, IconProjectAddOutline16, IconQuestionOutline14, IconQueueOutline14, IconRefreshOutline14, IconRefreshOutline16, IconRightUpOutline14, IconRightUpOutline16, IconSearchOutline16, IconSendOutline14, IconSettingsOutline14, IconSettingsOutline16, IconShareOutline16, IconShieldOutline16, IconSkillOutline16, IconSparkle16, IconStopFill16, IconThinkOutline14, IconThinkOutline16, IconTrashOutline16, IconTreeCorner8x10, IconTriangleRightFill14, IconUserOutline16, IconWarningOutline16, IconWrapLinesOutline16, Input, JsonBlock, JsonTree, LinkIcon, MarkdownText, Menu, Modal, OnboardingSurface, Pill, ReadBlock, ReferenceIcon, RiskConfirmation, SHIELD_OUTLINE_PATH, SHIELD_OUTLINE_STROKE, SearchBlock, StateDot, Switch, Tag, TerminalBlock, Toast, Tooltip, WebBlock, classifyFileType, classifyLinkPath, diffTotals, extractMarkdownPlainText, fileExtension, fileSizeText, projectUserText, rankByName, relativeTime, useAnchoredMaxHeight, useAnchoredPosition, useDismissOnOutsidePointer, writeClipboard };
+export { BrandWordmark, Button, Checkbox, CodeBlock, 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, HoverCard, IconAgentPresetOutline16, IconAlarmClockOutline16, IconApiOutline14, IconArchiveOutline20, IconBranchOutline16, IconBrowseOutline16, IconCheckOutline14, IconCheckOutline16, IconChecklistOutline14, IconChevronDownOutline14, IconChevronLeftOutline14, IconChevronRightOutline14, IconChevronUpOutline14, IconClockOutline16, IconCloseFill14, IconCloseOutline16, IconCodeOutline16, IconCompactOutline16, IconContextInjectionOutline16, IconCopyOutline16, IconCordisPluginOutline14, IconDarkOutline16, IconDataOutline16, IconDatabaseOutline16, IconDislikeFill16, IconDislikeOutline16, IconDownloadOutline16, IconEditOutline16, IconEllipsisOutline16, IconEnhanceOutline16, IconFolderClose16, IconFolderOpen16, IconFolderOpenOutline16, IconFollowsystemOutline16, IconFullscreenOutline16, IconGaugeOutline16, IconGlobeOutline14, IconGoalOutline16, IconInfoOutline14, IconInspectOutline12, IconLightOutline16, IconLikeFill16, IconLikeOutline16, IconLinkOutline14, IconLinkOutline16, IconListPenOutline16, IconLoadingOutline16, IconNewChatOutline16, IconPanelLeftOutline16, IconPaperPlaneOutline14, IconPaperclipOutline16, IconPauseOutline16, IconPersonalizationOutline16, IconPlanOutline14, IconPlayOutline16, IconPluginPinwheelOutline16, IconPlusOutline16, IconProjectAddOutline16, IconQuestionOutline14, IconQueueOutline14, IconRefreshOutline14, IconRefreshOutline16, IconRightUpOutline14, IconRightUpOutline16, IconSearchOutline16, IconSendOutline14, IconSettingsOutline14, IconSettingsOutline16, IconShareOutline16, IconShieldOutline16, IconSkillOutline16, IconSparkle16, IconStopFill16, IconThinkOutline14, IconThinkOutline16, IconTrashOutline16, IconTreeCorner8x10, IconTriangleRightFill14, IconUserOutline16, IconWarningOutline16, IconWrapLinesOutline16, Input, JsonBlock, JsonTree, LinkIcon, MarkdownDelegateProvider, MarkdownText, Menu, Modal, OnboardingSurface, Pill, ReadBlock, ReferenceIcon, RiskConfirmation, SHIELD_OUTLINE_PATH, SHIELD_OUTLINE_STROKE, SearchBlock, StateDot, Switch, Tag, TerminalBlock, Toast, Tooltip, WebBlock, classifyFileType, classifyLinkPath, diffTotals, extractMarkdownPlainText, fileExtension, fileSizeText, isDarwinDesktop, projectUserText, rankByName, relativeTime, useAnchoredMaxHeight, useAnchoredPosition, useDismissOnOutsidePointer, writeClipboard };
 
 //# sourceMappingURL=index.js.map