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

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/ui-primitives/README.md
-README.md: 332845471056e718d49d79a077b76a02c79bafe2
-README.zh.md: 598b561e79e4a935f7f033002e68b91c3a3d84de
+README.md: fbb8ef676e55d1ef2c3c5c8a6c91a12a3c8fe556
+README.zh.md: 822ff17c3c4c6b02339cdacd03d9c52c67a738c7

package/README.md

@@ -49,11 +49,12 @@ Check this table before writing a control in a feature package. A plugin cannot
 | `StateDot` | Solid green `done`, amber `warning`, red `error`, and neutral-grey `idle` marks in a 10px slot, plus a tertiary-grey 14px rotating `ongoing` loader whose animations pin to document time zero so every visible loader rotates in phase. `aria-hidden`, so the render site owns the name. `appearance="step"` shows a filled check for completion and a hollow pending circle. |
 | `ConnectionIndicator` | Inline connection-recovery control across outage, retry, and recovered states. |
 | `DisclosureRow` | 24px compact disclosure that lays title and content side by side. Memoized with shallow prop comparison; keep callbacks and React-node props stable when their content is unchanged. |
-| `Modal` | Centered dialog over a page mask. |
+| `Modal` | Centered dialog over a page mask. A nested dialog can intercept keys with `onKeyDownCapture` before document Escape handlers. |
 | `RiskConfirmation` | Sensitive action gated behind an explicit checkbox. |
 | `OnboardingSurface` | First-run stage that holds the application root inert. |
-| `Tooltip` | Hover text anchored to a cloned child; optional `portal` rendering escapes clipping containers. |
+| `Tooltip` | Hover text anchored to a cloned child; optional `portal` rendering escapes clipping containers and ancestor stacking contexts that cap the bubble's z-index. |
 | `HoverCard` | Hover preview the pointer can rest on and select from; optional copy button. |
+| `ImageLightbox` | Shared image modal with focus restoration and Escape dismissal. |
 | `Toast` | Transient top-center banner held for the owner's `holdMs`. |
 | `SettingsForm`, `SettingsValueField`, `SettingsSecretField` | The frame and the controls of a plugin's settings page: the frame takes its copy as `labels`, saves only on its button, and discards on unmount; a value field shows staged text with the overridden badge and reset; a secret field starts blank and reports only whether a value is configured. |
 | `SettingsFormModel`, `settingsNumberField`, `settingsTextField` | The staged-edit model behind such a page over a settings scope: drafts are staged and written on save, a field is overridden by its presence in the user layer, and a save that did not land keeps its drafts. |
@@ -85,7 +86,7 @@ The catalog above lists what each export is for; this section covers the behavio
 
 The nearest `MarkdownDelegateProvider` supplies optional `openExternalLink` and `openFile` navigation callbacks. Nested providers replace the enclosing capabilities, and callback changes reach already-rendered links without rebuilding Markdown. Its `openFile` makes local Markdown links clickable after settlement. Absolute and workspace-relative paths support percent escapes and `#L24` / `#L24-L30` fragments; ranges open at their first line. Literal `?` and `#` in filenames must be percent-encoded. The tooltip uses the decoded path and supplies the accessible name when the label is empty. The callback receives the decoded path and optional line, while the renderer preserves the label and displays a file icon. Without a callback, local links remain text. URL schemes, queries, unsupported fragments, and malformed destinations never reach the file opener.
 
-`MarkdownText` renders untrusted GFM and TeX math, blocks unsafe links and images, and can turn resolved file mentions into explicit controls. A surrounding `MarkdownDelegateProvider` receives sanitized HTTP(S) URLs from ordinary clicks; modified clicks and links outside a provider retain native external-anchor behavior. When the owner passes a `pathImages` vocabulary, image destinations that are local media paths rewrite to displayable URLs on settled renders only (the same streaming gate as file mentions); without a vocabulary, local destinations remain inert alt text. A load or decode failure replaces the image with its authored alt text, or the original destination when alt is empty. Changing the image source permits a fresh load. While a reply streams, it freezes completed blocks, advances a top-level open fence by completed lines, and highlights that fence from saved Shiki grammar state. Completed token lines enter fixed-size React groups, so later chunks reconcile only the growing group; an unchanged fence retains that DOM when the final full parse resolves cross-document syntax. `TerminalBlock`, `ReadBlock`, `DiffBlock`, `SearchBlock`, and `WebBlock` render the matching tool-result intent with copy controls, overflow handling, and ANSI processing where applicable. `JsonTree` and `JsonBlock` inspect JSON values read-only, while `projectUserText` projects sent user text into inline plain runs and reference chips for the message bubble and queue rows. Reference labels inherit the consumer’s wrapping policy: long names wrap within a bubble, while queue previews retain their single-line layout. When supplied with `UserTextReferences`, file and skill references become keyboard-accessible preview buttons using the same hover and focus styling as prose file links; the first pointer click can open a preview, while subsequent clicks and existing text selections retain native selection handling. Keyboard activation opens previews even when text is selected.
+`MarkdownText` renders untrusted GFM and TeX math, blocks unsafe links and images, and can turn resolved file mentions into explicit controls. A surrounding `MarkdownDelegateProvider` receives sanitized HTTP(S) URLs from ordinary clicks; modified clicks and links outside a provider retain native external-anchor behavior. When the owner passes a `pathImages` vocabulary, image destinations that are local media paths rewrite to displayable URLs on settled renders only (the same streaming gate as file mentions); without a vocabulary, local destinations remain inert alt text. A load or decode failure replaces the image with its authored alt text, or the original destination when alt is empty; `fileImages` additionally supplies a localized failure prefix. Changing the image source permits a fresh load. While a reply streams, it freezes completed blocks, advances a top-level open fence by completed lines, and highlights that fence from saved Shiki grammar state. Completed token lines enter fixed-size React groups, so later chunks reconcile only the growing group; an unchanged fence retains that DOM when the final full parse resolves cross-document syntax. `TerminalBlock`, `ReadBlock`, `DiffBlock`, `SearchBlock`, and `WebBlock` render the matching tool-result intent with copy controls, overflow handling, and ANSI processing where applicable. `JsonTree` and `JsonBlock` inspect JSON values read-only, while `projectUserText` projects sent user text into inline plain runs and reference chips for the message bubble and queue rows. Reference labels inherit the consumer’s wrapping policy: long names wrap within a bubble, while queue previews retain their single-line layout. When supplied with `UserTextReferences`, file and skill references become keyboard-accessible preview buttons using the same hover and focus styling as prose file links; the first pointer click can open a preview, while subsequent clicks and existing text selections retain native selection handling. Keyboard activation opens previews even when text is selected.
 
 `MarkdownText` defaults to `variant="body"`. Use `variant="compact"` for secondary content: its 13px text and 20px line height follow the content-size setting, all heading levels use the same size with weight 600, and paragraphs and lists use tighter spacing. Text, links, and code keep the tertiary color; dotted underlines distinguish links. Code headers scroll with their blocks. Tables and math stay enabled at the surrounding text size and scroll horizontally within the available width. Both variants share the parser and streaming cache.
 
@@ -95,6 +96,8 @@ The nearest `MarkdownDelegateProvider` supplies optional `openExternalLink` and
 
 `JsonTree` clamps collapsed strings to `collapsedStringLines` (three by default). Expanded strings show raw text, retain sibling commas, and fit within the window and outer scrolling containers. Resize and ancestor-scroll events update that limit. Row copy feedback updates independently of JSON value rendering; pending clipboard writes cannot update a different row or an unmounted tree.
 
+`ImageLightbox` is the shared original-image modal with focus restoration and Escape dismissal. The internal thumbnail renderer receives loading/failure labels from its owner. `HoverCard.inline` keeps a file link in the text flow and uses the shared menu material, keyboard-visible focus, and placement above or below the anchor without covering it. Escape closes an open thumbnail even when focus is elsewhere; subsequent Escape presses reach the owner. `MarkdownDelegateProvider.fileImages` supplies a decoded-path resolver and complete image labels: settled image links gain hover previews, and standalone images gain lightbox activation. Image-only anchors retain their single navigation target. The parser recovers only complete, unescaped, standalone local image references with bare spaces and an unambiguous supported image suffix; code and ambiguous destinations remain literal.
+
 ### Localizing copy
 
 The atoms cannot read the application locale, so every piece of user-facing copy arrives through required label props. `HoverCard`, `TerminalBlock`, `JsonTree`, `CodeBlock`, `MarkdownText`, `JsonBlock`, `ConnectionIndicator`, `Modal`, `DiffBlock`, `ReadBlock`, `SearchBlock`, and `WebBlock` accept complete localized labels. The package owns no language fallback; omission fails typechecking, and each feature maps its typed `t` seat into the primitive's label interface.

package/README.zh.md

@@ -49,11 +49,12 @@ kind: "package-library"
 | `StateDot` | 10px 槽内的绿色 `done`、琥珀色 `warning`、红色 `error`、中性灰色 `idle` 圆点，以及 tertiary 灰色 14px 旋转 `ongoing` loading，其动画固定到文档时间零点，所以所有可见 loading 同相旋转。它是 `aria-hidden` 的，名称由渲染点提供。 `appearance="step"` 以实心勾表示完成、空心圆表示等待。 |
 | `ConnectionIndicator` | 行内连接恢复控件，覆盖断线、重试与已恢复三种状态。 |
 | `DisclosureRow` | 24px 紧凑折叠行，标题与内容左右排列。使用浅层 prop 比较进行 memo；内容未变时，保持回调与 React 节点 prop 的引用稳定。 |
-| `Modal` | 页面遮罩之上的居中对话框。 |
+| `Modal` | 页面遮罩之上的居中对话框。嵌套对话框可通过 `onKeyDownCapture` 在文档级 Escape 处理器之前拦截按键。 |
 | `RiskConfirmation` | 以显式复选框把关的敏感操作确认。 |
 | `OnboardingSurface` | 首次运行的引导舞台，期间保持应用根节点 inert。 |
-| `Tooltip` | 锚定在克隆子元素上的悬停文本；可通过 `portal` 渲染到外层，避免被容器裁剪。 |
+| `Tooltip` | 锚定在克隆子元素上的悬停文本；可通过 `portal` 渲染到外层，避免被容器裁剪，或受祖先层叠上下文限制其 z-index。 |
 | `HoverCard` | 指针可停留、可选中的悬停预览；可选带复制按钮。 |
+| `ImageLightbox` | 共享图片浮层，支持焦点恢复与 Esc 关闭。 |
 | `Toast` | 顶部居中的瞬时横幅，保持时长由所有者的 `holdMs` 决定。 |
 | `SettingsForm`、`SettingsValueField`、`SettingsSecretField` | 插件设置页的框架与控件：框架以 `labels` 接收文案，只在按钮点击时保存，卸载即丢弃；值字段显示暂存文本以及已覆盖标签和重置；密文字段每次为空，只报告是否已配置。 |
 | `SettingsFormModel`、`settingsNumberField`、`settingsTextField` | 这类页面背后基于设置 scope 的暂存编辑模型：草稿先暂存、保存时写入，字段是否被覆盖看用户层是否含有它，未落地的保存保留草稿。 |
@@ -85,7 +86,7 @@ kind: "package-library"
 
 最近的 `MarkdownDelegateProvider` 提供可选的 `openExternalLink` 和 `openFile` 导航回调。嵌套 Provider 替换外层能力，回调变化无需重新构建 Markdown 即可到达已渲染链接。其 `openFile` 使本地 Markdown 链接在落定后可点击。绝对路径和工作区相对路径支持百分号转义以及 `#L24` / `#L24-L30` 片段；范围定位到起始行。文件名中的字面 `?` 和 `#` 必须百分号编码。悬停提示使用解码后的路径，并在标签为空时提供可访问名称。回调接收解码后的路径和可选行号，渲染器保留标签并显示文件图标。不传回调时，本地链接仍为文本。URL 协议、查询串、不支持的片段及格式错误的目标不会传给文件打开器。
 
-`MarkdownText` 渲染不可信的 GFM 与 TeX 公式、阻止不安全的链接与图片，并可把已解析的文件提及转换为显式控件。外层 `MarkdownDelegateProvider` 会接收普通点击产生的已净化 HTTP(S) URL；带修饰键的点击和 Provider 外的链接保留原生外部 anchor 行为。当 owner 传入 `pathImages` 词表时，本地媒体路径的图片目标只在落定渲染阶段重写为可展示 URL（与 file mentions 相同的流式门）；不传词表时本地目标保持惰性 alt 文本。加载或解码失败后，图片替换为作者的 alt 文本；alt 为空时显示原始目标路径。图片源变化后可重新加载。回复流式输出时，它冻结已完成的块、按已完成行推进顶层未闭合 fence，并从保存的 Shiki grammar state 为该 fence 增量高亮。已完成的 token 行进入固定大小的 React 分组，后续分片只 reconcile 正在增长的分组；最终全量解析解决跨文档语法时，未变化的 fence 会保留该 DOM。`TerminalBlock`、`ReadBlock`、`DiffBlock`、`SearchBlock` 与 `WebBlock` 把对应的工具结果意图渲染为带复制控件、溢出处理及适用时 ANSI 处理的卡片。`JsonTree` 与 `JsonBlock` 以只读方式检查 JSON 值；`projectUserText` 把已发送的用户文本投影为行内普通文本段与引用 chip，供消息气泡和排队行使用。引用名称继承调用方的换行规则：长名称在气泡内换行，排队预览保持单行布局。传入 `UserTextReferences` 时，文件和 skill 引用成为支持键盘操作的预览按钮，复用正文文件链接的悬停和聚焦样式；第一次指针点击可以打开预览，后续点击和已有选区保留原生选择行为。键盘激活在存在选区时仍可打开预览。
+`MarkdownText` 渲染不可信的 GFM 与 TeX 公式、阻止不安全的链接与图片，并可把已解析的文件提及转换为显式控件。外层 `MarkdownDelegateProvider` 会接收普通点击产生的已净化 HTTP(S) URL；带修饰键的点击和 Provider 外的链接保留原生外部 anchor 行为。当 owner 传入 `pathImages` 词表时，本地媒体路径的图片目标只在落定渲染阶段重写为可展示 URL（与 file mentions 相同的流式门）；不传词表时本地目标保持惰性 alt 文本。加载或解码失败后，图片替换为作者的 alt 文本；alt 为空时显示原始目标路径；`fileImages` 还提供本地化的失败提示前缀。图片源变化后可重新加载。回复流式输出时，它冻结已完成的块、按已完成行推进顶层未闭合 fence，并从保存的 Shiki grammar state 为该 fence 增量高亮。已完成的 token 行进入固定大小的 React 分组，后续分片只 reconcile 正在增长的分组；最终全量解析解决跨文档语法时，未变化的 fence 会保留该 DOM。`TerminalBlock`、`ReadBlock`、`DiffBlock`、`SearchBlock` 与 `WebBlock` 把对应的工具结果意图渲染为带复制控件、溢出处理及适用时 ANSI 处理的卡片。`JsonTree` 与 `JsonBlock` 以只读方式检查 JSON 值；`projectUserText` 把已发送的用户文本投影为行内普通文本段与引用 chip，供消息气泡和排队行使用。引用名称继承调用方的换行规则：长名称在气泡内换行，排队预览保持单行布局。传入 `UserTextReferences` 时，文件和 skill 引用成为支持键盘操作的预览按钮，复用正文文件链接的悬停和聚焦样式；第一次指针点击可以打开预览，后续点击和已有选区保留原生选择行为。键盘激活在存在选区时仍可打开预览。
 
 `MarkdownText` 默认为 `variant="body"`。次级内容使用 `variant="compact"`：其 13px 字号与 20px 行高跟随内容字号设置，各级标题保持同一字号并使用 600 字重，段落与列表采用更紧凑的间距。正文、链接和代码均保持 tertiary 颜色，以点状下划线区分链接。代码标题栏随代码块滚动。表格和公式仍然启用，使用周围文字的字号，并在可用宽度内横向滚动。两个变体共享解析器与流式缓存。
 
@@ -95,6 +96,8 @@ kind: "package-library"
 
 `JsonTree` 把折叠字符串限制为 `collapsedStringLines` 行（默认三行）。展开后显示原始文本、保留同级逗号，并限制在窗口与外层滚动容器内；尺寸变化和祖先滚动事件会更新此限制。行复制反馈独立于 JSON 值渲染更新；尚未完成的剪贴板写入不会更新另一行或已卸载的树。
 
+`ImageLightbox` 是共享原图浮层，支持焦点恢复与 Esc 关闭。包内缩略图渲染器由调用方提供加载及失败文案。`HoverCard.inline` 使文件链接保持在文本流内，并使用共享菜单材质、键盘可见焦点，并在锚点上方或下方定位而不遮挡锚点。即使焦点位于其他位置，Esc 也会关闭已打开的缩略图；后续 Esc 按键继续传给 owner。`MarkdownDelegateProvider.fileImages` 提供已解码路径解析器与完整图片文案：消息落定后的图片链接支持悬停预览，独立图片支持点击放大。仅包含图片的链接保留单一导航目标。解析器仅恢复完整、未转义、独立成段且带明确图片扩展名的含裸空格本地图片引用；代码与有歧义的目标保持原文。
+
 ### 本地化文案
 
 这些原子组件无法读取应用 locale，因此每段面向用户的文案都必须通过 label prop 提供。`HoverCard`、`TerminalBlock`、`JsonTree`、`CodeBlock`、`MarkdownText`、`JsonBlock`、`ConnectionIndicator`、`Modal`、`DiffBlock`、`ReadBlock`、`SearchBlock` 与 `WebBlock` 接收完整的本地化 label。本包不拥有语言回退；遗漏会导致类型检查失败，各功能会把带类型的 `t` 席位映射到 primitive 的 label 接口。

package/lib/HoverCard.module.css

@@ -79,3 +79,16 @@
 @media (prefers-reduced-motion: reduce) {
   .preview { transition: none; }
 }
+
+.inline { display: inline; }
+.media {
+  --dsh-scrollbar-thumb: var(--dsw-alias-scrollbar-bg-l2);
+  --dsh-scrollbar-thumb-hover: var(--dsw-alias-scrollbar-hover-l2);
+  overflow: auto;
+  padding: 8px;
+  border: 0;
+  color: var(--dsw-alias-label-primary);
+  background: var(--dsw-specific-menu);
+  backdrop-filter: var(--dsw-menu-backdrop-filter);
+  box-shadow: var(--dsw-elevation-panel);
+}

package/lib/ImageLightbox.module.css

@@ -0,0 +1,48 @@
+.backdrop {
+  position: fixed;
+  inset: 0;
+  z-index: 1000;
+  display: grid;
+  place-items: center;
+  padding: 40px;
+}
+
+/* Same mask recipe as the Modal primitive and the settings dialog. A separate
+   layer, not a background on .backdrop: backdrop-filter there would blur the
+   previewed image and the close control along with the page. */
+.mask {
+  position: absolute;
+  inset: 0;
+  background: var(--dsw-alias-bg-mask-1);
+  backdrop-filter: var(--dsw-mask-blur);
+}
+
+.image {
+  position: relative;
+  max-width: min(100%, 1600px);
+  max-height: calc(100vh - 80px);
+  object-fit: contain;
+  border-radius: 12px;
+  background: var(--dsw-specific-input-major);
+  border: 0;
+  box-shadow: var(--dsw-elevation-prominent);
+}
+
+.close {
+  position: fixed;
+  top: 20px;
+  right: 20px;
+  z-index: 1;
+  display: grid;
+  place-items: center;
+  width: 36px;
+  height: 36px;
+  border: 0.5px solid var(--dsw-alias-border-l2-darkmode-thin);
+  border-radius: 999px;
+  corner-shape: round;
+  background: var(--dsw-specific-input-major);
+  color: var(--dsw-alias-label-primary);
+  cursor: pointer;
+}
+
+.close:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary); outline-offset: 3px; }

package/lib/ImagePreview.module.css

@@ -0,0 +1,24 @@
+.frame {
+  position: relative;
+  display: grid;
+  place-items: center;
+  width: 100%;
+  height: 180px;
+  overflow: hidden;
+  border-radius: 8px;
+  background: var(--dsw-alias-bg-base);
+}
+.image { width: 100%; height: 100%; min-height: 0; object-fit: contain; opacity: 0; }
+.image[data-ready] { opacity: 1; }
+.status {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 8px;
+  padding: 12px;
+  color: var(--dsw-alias-label-tertiary);
+  font-size: 12px;
+  line-height: 18px;
+}

package/lib/index.js

@@ -56,9 +56,11 @@ import { factorySpace } from "micromark-factory-space";
 import { normalizeUri } from "micromark-util-sanitize-uri";
 import css$29 from "./markdown/CodeBlock.module.css";
 import katex from "katex";
+import css$30 from "./ImageLightbox.module.css";
+import css$31 from "./ImagePreview.module.css";
 import "katex/dist/katex.min.css";
-import css$30 from "./WebBlock.module.css";
-import css$31 from "./markdown/JsonBlock.module.css";
+import css$32 from "./WebBlock.module.css";
+import css$33 from "./markdown/JsonBlock.module.css";
 //#region lib/types/icons/shared-artwork.js
 /**
 * Render shared new-conversation geometry for product and reference icons.
@@ -1243,10 +1245,10 @@ const IconUserOutlineArtwork = ({ size = 16, className, strokeWidth }) => jsxs("
 	"aria-hidden": "true",
 	strokeWidth,
 	children: [jsx("path", {
-		d: "M8 8.5C9.65685 8.5 11 7.15685 11 5.5C11 3.84315 9.65685 2.5 8 2.5C6.34315 2.5 5 3.84315 5 5.5C5 7.15685 6.34315 8.5 8 8.5Z",
+		d: "M8 8.25C9.51878 8.25 10.75 7.01878 10.75 5.5C10.75 3.98122 9.51878 2.75 8 2.75C6.48122 2.75 5.25 3.98122 5.25 5.5C5.25 7.01878 6.48122 8.25 8 8.25Z",
 		stroke: "currentColor"
 	}), jsx("path", {
-		d: "M1.5 14.5C1.5 11.25 4.25 10 8 10C11.75 10 14.5 11.25 14.5 14.5",
+		d: "M2.5 14.5C2.5 11.5 5.25 10.25 8 10.25C10.75 10.25 13.5 11.5 13.5 14.5",
 		stroke: "currentColor"
 	})]
 });
@@ -1260,6 +1262,44 @@ const IconUserOutlineMedium = (props) => jsx(IconUserOutlineArtwork, {
 	...props,
 	strokeWidth: ICON_MEDIUM_STROKE
 });
+const IconUsersOutlineArtwork = ({ size = 16, className, strokeWidth }) => 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 8.25C7.51878 8.25 8.75 7.01878 8.75 5.5C8.75 3.98122 7.51878 2.75 6 2.75C4.48122 2.75 3.25 3.98122 3.25 5.5C3.25 7.01878 4.48122 8.25 6 8.25Z",
+			stroke: "currentColor"
+		}),
+		jsx("path", {
+			d: "M1 14.5C1 11.5 3.5 10.25 6 10.25C8.5 10.25 11 11.5 11 14.5",
+			stroke: "currentColor"
+		}),
+		jsx("path", {
+			d: "M10.5 2.9C11.65 3.35 12.45 4.35 12.45 5.5C12.45 6.65 11.65 7.65 10.5 8.1",
+			stroke: "currentColor"
+		}),
+		jsx("path", {
+			d: "M12.4 10.6C13.9 11.3 15 12.6 15 14.5",
+			stroke: "currentColor"
+		})
+	]
+});
+/** Regular one-pixel IconUsersOutline artwork: a front person with a second person behind. */
+const IconUsersOutlineRegular = (props) => jsx(IconUsersOutlineArtwork, {
+	...props,
+	strokeWidth: 1
+});
+/** Medium IconUsersOutline artwork with a 1.3px stroke. */
+const IconUsersOutlineMedium = (props) => jsx(IconUsersOutlineArtwork, {
+	...props,
+	strokeWidth: ICON_MEDIUM_STROKE
+});
 const IconPaperPlaneOutlineArtwork = ({ size = 14, className, strokeWidth }) => jsxs("svg", {
 	width: size,
 	height: size,
@@ -4023,6 +4063,7 @@ async function writeClipboard(text) {
 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;
 /**
@@ -4034,6 +4075,7 @@ const VIEWPORT_MARGIN = 8;
 * @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.
@@ -4041,7 +4083,7 @@ const VIEWPORT_MARGIN = 8;
 * @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 }) {
+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);
@@ -4108,19 +4150,22 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 		};
 	}, []);
 	useEffect(() => {
-		if (!open || variant !== "preview") return;
+		if (!open || variant !== "preview" && !inline) return;
 		const dismiss = (event) => {
 			if (event.key !== "Escape") return;
+			if (inline) event.stopPropagation();
+			clearTimer();
 			cancelClose();
 			close();
 		};
-		window.addEventListener("keydown", dismiss);
+		window.addEventListener("keydown", dismiss, inline);
 		return () => {
-			window.removeEventListener("keydown", dismiss);
+			window.removeEventListener("keydown", dismiss, inline);
 		};
 	}, [
 		open,
 		variant,
+		inline,
 		cancelClose,
 		close
 	]);
@@ -4152,6 +4197,23 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 				});
 				return;
 			}
+			if (inline) {
+				const height = Math.max(h, cardRef.current?.scrollHeight ?? 0);
+				const width = Math.max(0, Math.min(INLINE_PREVIEW_WIDTH, window.innerWidth - VIEWPORT_MARGIN * 2));
+				const topMargin = overlayTopMargin(VIEWPORT_MARGIN);
+				const belowTop = Math.max(topMargin, r.bottom + ANCHOR_GAP);
+				const above = Math.max(0, r.top - ANCHOR_GAP - topMargin);
+				const below = Math.max(0, window.innerHeight - belowTop - VIEWPORT_MARGIN);
+				const onTop = height > below && above > below;
+				const maxHeight = onTop ? above : below;
+				setPos({
+					left: Math.max(VIEWPORT_MARGIN, Math.min(r.left, window.innerWidth - width - VIEWPORT_MARGIN)),
+					top: onTop ? r.top - ANCHOR_GAP - Math.min(height, maxHeight) : belowTop,
+					width,
+					maxHeight
+				});
+				return;
+			}
 			const top = r.top + h > window.innerHeight - VIEWPORT_MARGIN ? window.innerHeight - h - VIEWPORT_MARGIN : r.top;
 			setPos({
 				left: r.right + ANCHOR_GAP,
@@ -4159,7 +4221,7 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 			});
 		};
 		place();
-		const observer = variant === "preview" && typeof ResizeObserver !== "undefined" ? new ResizeObserver(place) : null;
+		const observer = (variant === "preview" || inline) && typeof ResizeObserver !== "undefined" ? new ResizeObserver(place) : null;
 		for (const element of [
 			cardRef.current,
 			rootRef.current,
@@ -4176,10 +4238,11 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 		open,
 		variant,
 		widthAnchorRef,
-		positioned
+		positioned,
+		inline
 	]);
 	useLayoutEffect(() => {
-		if (!open || pos === null || variant === "preview") 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({
@@ -4189,7 +4252,8 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 	}, [
 		open,
 		pos,
-		variant
+		variant,
+		inline
 	]);
 	const copy = async (text) => {
 		if (copied || copyingRef.current) return;
@@ -4213,7 +4277,7 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 	};
 	const card = open && pos !== null && jsx("div", {
 		ref: cardRef,
-		className: clsx(css$13.card, variant === "preview" && css$13.preview, copyable && css$13.copyable, copied && css$13.feedback),
+		className: clsx(css$13.card, variant === "preview" && css$13.preview, inline && css$13.media, copyable && css$13.copyable, copied && css$13.feedback),
 		"data-closing": closing || void 0,
 		style: {
 			...pos,
@@ -4243,9 +4307,22 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 	});
 	return jsxs("span", {
 		ref: rootRef,
-		className: css$13.root,
-		onPointerEnter: () => {
-			if (disabled) return;
+		className: clsx(css$13.root, inline && css$13.inline),
+		onFocus: inline ? (event) => {
+			if (!disabled && event.target.matches(":focus-visible")) {
+				cancelClose();
+				setPhase("open");
+			}
+		} : void 0,
+		onBlur: inline ? (event) => {
+			if (!event.currentTarget.contains(event.relatedTarget)) {
+				clearTimer();
+				cancelClose();
+				close();
+			}
+		} : void 0,
+		onPointerEnter: (event) => {
+			if (disabled || inline && event.pointerType === "touch") return;
 			cancelClose();
 			if (open) {
 				setPhase("open");
@@ -4288,9 +4365,10 @@ function HoverCard({ anchor, content, openDelayMs = 500, disabled = false, copyT
 * @param props.contentClassName - optional class for a scrollable content region.
 * @param props.headless - render children directly in the card (no default
 * header/close/body chrome); mask, card, Escape, and aria-label remain.
+* @param props.onKeyDownCapture - handle a nested dialog's keys before the document Escape listeners.
 * @returns null when closed; otherwise the overlay tree.
 */
-function Modal({ open, onClose, title, closeLabel, description, children, footer, className, contentClassName, headless = false }) {
+function Modal({ open, onClose, title, closeLabel, description, children, footer, className, contentClassName, onKeyDownCapture, headless = false }) {
 	useEffect(() => {
 		if (!open) return;
 		const onKeyDown = (e) => {
@@ -4305,6 +4383,7 @@ function Modal({ open, onClose, title, closeLabel, description, children, footer
 	return createPortal(jsxs("div", {
 		className: css$14.root,
 		role: "presentation",
+		onKeyDownCapture,
 		children: [jsx("div", {
 			className: css$14.mask,
 			"aria-hidden": "true",
@@ -5896,7 +5975,7 @@ function projectUserText(text, sessionLabels, slashNames = [], slashKind = "skil
 }
 //#endregion
 //#region lib/types/Tooltip.js
-/** Anchor-preserving tooltips with optional body portals for clipping containers. */
+/** Anchor-preserving tooltips; an optional body portal escapes clipping containers and stacking contexts that cap the bubble's z-index. */
 /**
 * 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
@@ -5919,8 +5998,11 @@ if (typeof window !== "undefined") {
 * @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 to escape containing blocks and clipping ancestors.
+* @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; keyboard focus remains immediate.
+* @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
@@ -5931,7 +6013,7 @@ if (typeof window !== "undefined") {
 * anchor dismisses the bubble until the next trigger, and focus arriving after a pointer
 * interaction (a closing menu refocusing its trigger) never raises it.
 */
-function Tooltip({ label, side = "right", align = "center", delayMs = 0, disabled = false, portal = false, maxWidth, children }) {
+function Tooltip({ label, side = "right", align = "center", delayMs = 0, gap = 8, disabled = false, portal = false, maxWidth, children }) {
 	const anchor = useRef(null);
 	const childRef = children.ref;
 	const mergedRef = useCallback((el) => {
@@ -5942,7 +6024,7 @@ function Tooltip({ label, side = "right", align = "center", delayMs = 0, disable
 	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 - 8 : pos.bottom + 8;
+	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,
@@ -5965,12 +6047,12 @@ function Tooltip({ label, side = "right", align = "center", delayMs = 0, disable
 			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 + 8 + height <= window.innerHeight - edgeMargin;
-			const fitsAbove = pos.top - 8 - height >= edgeMargin;
+			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 - 8 : pos.bottom + 8}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";
 		};
@@ -5986,6 +6068,7 @@ function Tooltip({ label, side = "right", align = "center", delayMs = 0, disable
 		};
 	}, [
 		align,
+		gap,
 		pos,
 		side,
 		suppressed,
@@ -9626,6 +9709,32 @@ var IncrementalMarkdownParser = class {
 	}
 };
 //#endregion
+//#region lib/types/markdown/local-image-syntax.js
+/**
+* Recover only unambiguous, unescaped image-only paragraphs containing a local path with spaces.
+* @param root - Parsed Markdown tree, modified in place.
+* @param source - Original source used to distinguish authored syntax from escaped examples.
+* @returns The same root with recovered image nodes.
+*/
+function recoverLocalImages(root, source) {
+	const visit = (node) => {
+		if (node.type === "paragraph" && node.children.length === 1) {
+			const [child] = node.children;
+			if (child.type === "text" && child.position !== void 0 && source.slice(child.position.start.offset, child.position.end.offset) === child.value) {
+				const match = /^!\[([^\]\n]*)\]\(((?:\/(?!\/)|\.{1,2}\/|[a-z]:[\\/])[^\n<>()[\]"']+\.[a-z\d]+)\)$/iu.exec(child.value);
+				if (match !== null && match[2].includes(" ") && classifyFileType(match[2]) === "image") node.children = [{
+					type: "image",
+					alt: match[1],
+					url: match[2],
+					position: child.position
+				}];
+			}
+		} else if ("children" in node) for (const child of node.children) visit(child);
+	};
+	visit(root);
+	return root;
+}
+//#endregion
 //#region lib/types/markdown/cjkFriendlyStrong.js
 /** Let asterisk strong emphasis close after punctuation when CJK prose continues without whitespace. */
 const cjkCharacter = new RegExp([
@@ -9972,10 +10081,10 @@ function mathCompatibility() {
 * @returns The mdast root.
 */
 function parseGfm(text) {
-	return fromMarkdown(text, {
+	return recoverLocalImages(fromMarkdown(text, {
 		extensions: [gfm(), cjkFriendlyStrong()],
 		mdastExtensions: [gfmFromMarkdown()]
-	});
+	}), text);
 }
 /**
 * Parse GFM markdown plus TeX math with the compatibility delimiters
@@ -9984,7 +10093,7 @@ function parseGfm(text) {
 * @returns The mdast root.
 */
 function parseGfmWithMath(text) {
-	return fromMarkdown(text, {
+	return recoverLocalImages(fromMarkdown(text, {
 		extensions: [
 			gfm(),
 			cjkFriendlyStrong(),
@@ -9992,7 +10101,7 @@ function parseGfmWithMath(text) {
 			math()
 		],
 		mdastExtensions: [gfmFromMarkdown(), mathFromMarkdown()]
-	});
+	}), text);
 }
 //#endregion
 //#region lib/types/markdown/CodeBlock.js
@@ -10292,11 +10401,16 @@ const MarkdownDelegateContext = createContext({});
 * @param props - Child tree and its file and HTTP(S) link handlers.
 * @returns the scoped child tree.
 */
-function MarkdownDelegateProvider({ children, openExternalLink, openFile }) {
+function MarkdownDelegateProvider({ children, openExternalLink, openFile, fileImages }) {
 	const delegate = useMemo(() => ({
 		openExternalLink,
-		openFile
-	}), [openExternalLink, openFile]);
+		openFile,
+		fileImages
+	}), [
+		openExternalLink,
+		openFile,
+		fileImages
+	]);
 	return jsx(MarkdownDelegateContext.Provider, {
 		value: delegate,
 		children
@@ -10310,6 +10424,111 @@ function useMarkdownDelegate() {
 	return useContext(MarkdownDelegateContext);
 }
 //#endregion
+//#region lib/types/ImageLightbox.js
+/**
+* Document-level original-image preview opened by clicking a thumbnail.
+* Closes on Escape, backdrop press, or the close control, and restores focus
+* to the opener on unmount. Rendered through a body portal: an opener inside
+* a transformed or filtered ancestor would otherwise trap the fixed backdrop
+* in that ancestor's box instead of covering the viewport.
+*
+* @param props.src - the original image URL.
+* @param props.alt - the image's alt text.
+* @param props.labels - dialog and close-control strings.
+* @param props.onClose - dismiss callback owned by the opener.
+* @returns the modal preview dialog.
+*/
+function ImageLightbox({ src, alt, labels, onClose }) {
+	const closeRef = useRef(null);
+	const restoreRef = useRef(null);
+	useEffect(() => {
+		restoreRef.current = document.activeElement instanceof HTMLElement ? document.activeElement : null;
+		closeRef.current?.focus();
+		const onKeyDown = (event) => {
+			if (event.key === "Escape") {
+				event.stopPropagation();
+				onClose();
+			}
+			if (event.key === "Tab") {
+				event.preventDefault();
+				closeRef.current?.focus();
+			}
+		};
+		window.addEventListener("keydown", onKeyDown, true);
+		return () => {
+			window.removeEventListener("keydown", onKeyDown, true);
+			restoreRef.current?.focus();
+		};
+	}, [onClose]);
+	return createPortal(jsxs("div", {
+		className: css$30.backdrop,
+		role: "dialog",
+		"aria-modal": "true",
+		"aria-label": labels.dialog,
+		children: [
+			jsx("div", {
+				className: css$30.mask,
+				"aria-hidden": "true",
+				onMouseDown: onClose
+			}),
+			jsx("img", {
+				className: css$30.image,
+				src,
+				alt
+			}),
+			jsx("button", {
+				ref: closeRef,
+				type: "button",
+				className: css$30.close,
+				"aria-label": labels.close,
+				onClick: onClose,
+				children: jsx(IconCloseOutlineRegular, { size: 16 })
+			})
+		]
+	}), document.body);
+}
+//#endregion
+//#region lib/types/ImagePreview.js
+/** Passive, contained image preview for Markdown image links. */
+/**
+* Render an image without introducing a second activation target.
+* @param props - Source, accessible description, localized status.
+* @returns A contained preview with loading or failure status.
+*/
+function ImagePreview({ src, alt, loadingLabel, failedLabel }) {
+	return jsx(Preview, {
+		src,
+		alt,
+		loadingLabel,
+		failedLabel
+	}, src);
+}
+function Preview({ src, alt, loadingLabel, failedLabel }) {
+	const [state, setState] = useState("loading");
+	return jsxs("span", {
+		className: css$31.frame,
+		children: [state !== "failed" && jsx("img", {
+			src,
+			alt,
+			loading: "lazy",
+			decoding: "async",
+			referrerPolicy: "no-referrer",
+			className: css$31.image,
+			"data-ready": state === "ready" || void 0,
+			onLoad: () => {
+				setState("ready");
+			},
+			onError: () => {
+				setState("failed");
+			}
+		}), state !== "ready" && jsxs("span", {
+			className: css$31.status,
+			role: "status",
+			children: [state === "loading" && jsx(IconLoadingOutlineRegular, { size: 16 }), jsx("span", { children: state === "loading" ? loadingLabel : failedLabel })]
+		})]
+	});
+}
+//#endregion
 //#region lib/types/markdown/render.js
 /**
 * Direct mdast→React markdown renderer. Replaces the react-markdown /
@@ -10631,12 +10850,14 @@ function renderAnchor(url, children, key, glyph = true, streaming = false) {
 	return renderSafeLink(normalizeUri(url), children, key, glyph);
 }
 function MarkdownFileLink({ file, glyph, children }) {
-	const { openFile } = useMarkdownDelegate();
+	const { openFile, fileImages } = useMarkdownDelegate();
 	if (openFile === void 0) return jsx(Fragment, { children });
-	return jsxs("button", {
+	const preview = glyph && classifyLinkPath(file.path) === "image" ? fileImages : void 0;
+	const src = preview?.resolve(file.path);
+	const anchor = jsxs("button", {
 		type: "button",
 		className: clsx(markdownCss.fileMention, markdownCss.fileLink),
-		title: file.path,
+		title: src === void 0 ? file.path : void 0,
 		onClick: () => {
 			openFile(file.path, file.line === void 0 ? void 0 : { line: file.line });
 		},
@@ -10645,6 +10866,20 @@ function MarkdownFileLink({ file, glyph, children }) {
 			className: markdownCss.linkIcon
 		}), children]
 	});
+	if (src === void 0 || preview === void 0) return anchor;
+	return jsx(HoverCard, {
+		inline: true,
+		anchor,
+		content: jsxs(Fragment, { children: [jsx(ImagePreview, {
+			src,
+			alt: file.path,
+			loadingLabel: preview.labels.loading,
+			failedLabel: preview.labels.failed
+		}), jsx("span", {
+			className: markdownCss.previewName,
+			children: file.path.split(/[\\/]/u).pop()
+		})] })
+	});
 }
 /**
 * The complete inline-code value when it is exactly an absolute HTTP(S) URL
@@ -10660,25 +10895,40 @@ function inlineCodeHttpUrl(value) {
 	}
 }
 function renderImage(url, alt, key, context) {
-	const imageSrc = imageSource(url, context.pathImages);
-	if (imageSrc === void 0) return jsx("span", {
+	return jsx(MarkdownImage, {
+		destination: url,
+		alt,
+		pathImages: context.pathImages,
+		streaming: context.streaming,
+		inLink: context.inLink === true
+	}, `${key}:${url}`);
+}
+function MarkdownImage({ destination, alt, pathImages, streaming, inLink }) {
+	const { fileImages } = useMarkdownDelegate();
+	const file = streaming ? void 0 : parseFileLink(destination);
+	const src = (file === void 0 ? void 0 : fileImages?.resolve(file.path)) ?? imageSource(destination, pathImages);
+	if (src === void 0) return jsx("span", {
 		className: markdownCss.imageAlt,
 		children: alt
-	}, key);
-	return jsx(MarkdownImage, {
-		src: imageSrc,
+	});
+	return jsx(LoadedMarkdownImage, {
+		src,
 		alt,
-		destination: url
-	}, `${key}:${imageSrc}`);
+		destination,
+		preview: inLink ? void 0 : fileImages
+	}, src);
 }
-/** Failed loads retain the authored alt or destination; a new source remounts the image. */
-function MarkdownImage({ src, alt, destination }) {
+function LoadedMarkdownImage({ src, alt, destination, preview }) {
 	const [failed, setFailed] = useState(false);
-	if (failed) return jsx("span", {
+	const [open, setOpen] = useState(false);
+	const close = useCallback(() => {
+		setOpen(false);
+	}, []);
+	if (failed) return jsxs("span", {
 		className: markdownCss.imageAlt,
-		children: alt || destination
+		children: [preview === void 0 ? "" : `${preview.labels.failed} · `, alt || destination]
 	});
-	return jsx("img", {
+	const img = jsx("img", {
 		className: markdownCss.image,
 		src,
 		alt,
@@ -10689,6 +10939,22 @@ function MarkdownImage({ src, alt, destination }) {
 		decoding: "async",
 		referrerPolicy: "no-referrer"
 	});
+	if (preview === void 0) return img;
+	return jsxs(Fragment, { children: [jsx("button", {
+		type: "button",
+		className: markdownCss.imageButton,
+		title: preview.labels.open,
+		"aria-label": alt ? `${preview.labels.open}: ${alt}` : preview.labels.open,
+		onClick: () => {
+			setOpen(true);
+		},
+		children: img
+	}), open && jsx(ImageLightbox, {
+		src,
+		alt,
+		labels: preview.labels,
+		onClose: close
+	})] });
 }
 /** The bracketed source text a reference reverts to when its definition is missing. */
 function referenceSuffix(node) {
@@ -10995,7 +11261,7 @@ function SafeLink({ url, label, className }) {
 		children: [jsx(LinkIconMedium, {
 			kind: "url",
 			href,
-			className: css$30.linkIcon
+			className: css$32.linkIcon
 		}), label]
 	});
 }
@@ -11010,20 +11276,20 @@ function SafeLink({ url, label, className }) {
 */
 function SourceItem({ source, ordinal }) {
 	return jsxs("li", {
-		className: css$30.source,
+		className: css$32.source,
 		value: ordinal,
 		children: [
 			jsx(SafeLink, {
 				url: source.url,
 				label: linkLabel(source.url, source.title),
-				className: css$30.sourceLink
+				className: css$32.sourceLink
 			}),
 			source.snippet !== void 0 && source.snippet !== "" && jsx("div", {
-				className: css$30.snippet,
+				className: css$32.snippet,
 				children: source.snippet
 			}),
 			source.publishedAt !== void 0 && source.publishedAt !== "" && jsx("div", {
-				className: css$30.published,
+				className: css$32.published,
 				children: source.publishedAt
 			})
 		]
@@ -11038,28 +11304,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$30.block, className),
+		className: clsx(css$32.block, className),
 		"data-web": "search",
 		children: [
 			answer !== void 0 && answer !== "" && jsx("div", {
-				className: css$30.answer,
+				className: css$32.answer,
 				children: jsx(MarkdownText, {
 					text: answer,
 					labels: labels.markdown
 				})
 			}),
 			empty ? jsx("div", {
-				className: css$30.empty,
+				className: css$32.empty,
 				children: labels.noResults
 			}) : jsx("ol", {
-				className: css$30.sources,
+				className: css$32.sources,
 				children: sources.map((source, index) => jsx(SourceItem, {
 					source,
 					ordinal: index + 1
 				}, index))
 			}),
 			truncated && jsx("div", {
-				className: css$30.truncated,
+				className: css$32.truncated,
 				children: labels.sourcesTruncated
 			})
 		]
@@ -11072,23 +11338,23 @@ function WebSearchBlock({ answer, sources, truncated, labels, className }) {
 */
 function WebFetchBlock({ url, statusCode, truncated, labels, className }) {
 	return jsxs("div", {
-		className: clsx(css$30.block, css$30.fetch, className),
+		className: clsx(css$32.block, css$32.fetch, className),
 		"data-web": "fetch",
 		children: [jsx(SafeLink, {
 			url,
 			label: url,
-			className: css$30.fetchUrl
+			className: css$32.fetchUrl
 		}), jsxs("div", {
-			className: css$30.fetchMeta,
+			className: css$32.fetchMeta,
 			children: [jsxs("span", {
-				className: css$30.status,
+				className: css$32.status,
 				children: [
 					labels.http,
 					" ",
 					statusCode
 				]
 			}), truncated && jsx("span", {
-				className: css$30.truncated,
+				className: css$32.truncated,
 				children: labels.contentTruncated
 			})]
 		})]
@@ -11122,10 +11388,10 @@ function JsonBlock({ label, payload, defaultOpen = false, truncatedLabel }) {
 		truncatedLabel
 	]);
 	return jsxs("div", {
-		className: css$31.root,
+		className: css$33.root,
 		children: [jsxs("button", {
 			type: "button",
-			className: css$31.toggle,
+			className: css$33.toggle,
 			onClick: () => {
 				setOpen((v) => !v);
 			},
@@ -11135,7 +11401,7 @@ function JsonBlock({ label, payload, defaultOpen = false, truncatedLabel }) {
 				label
 			]
 		}), open && jsx("pre", {
-			className: css$31.body,
+			className: css$33.body,
 			children: body
 		})]
 	});
@@ -11411,6 +11677,6 @@ const PluginArtworkDefault = ({ size = 36, className }) => {
 	});
 };
 //#endregion
-export { BrandWordmark, Button, CODE_HIGHLIGHT_EXTENSIONS, 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, ICON_MEDIUM_STROKE, ICON_REGULAR_STROKE, IconAgentPresetOutlineMedium, IconAgentPresetOutlineRegular, IconAlarmClockOutlineMedium, IconAlarmClockOutlineRegular, IconApiOutlineMedium, IconApiOutlineRegular, IconArchiveCheckOutlineMedium, IconArchiveCheckOutlineRegular, 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, IconWarningOutlineMedium, IconWarningOutlineRegular, IconWarningTriangleOutlineMedium, IconWarningTriangleOutlineRegular, IconWorkspaceTreeOutlineMedium, IconWorkspaceTreeOutlineRegular, IconWrapFillMedium, IconWrapFillRegular, IconWrapLinesOutlineMedium, IconWrapLinesOutlineRegular, Input, JsonBlock, JsonTree, LinkIconMedium, LinkIconRegular, MarkdownDelegateProvider, MarkdownText, Menu, MenuItemButton, Modal, OnboardingSurface, 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, StateDot, Switch, Tag, TerminalBlock, TextShimmer, Toast, Tooltip, WebBlock, classifyFileType, classifyLinkPath, diffTotals, extractMarkdownPlainText, fileExtension, fileSizeText, isDarwinDesktop, languageForPath, projectUserText, rankByName, relativeTime, settingsNumberField, settingsTextField, useAnchoredMaxHeight, useAnchoredPosition, useCodeHighlighter, useDismissOnOutsidePointer, writeClipboard };
+export { BrandWordmark, Button, CODE_HIGHLIGHT_EXTENSIONS, 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, ICON_MEDIUM_STROKE, ICON_REGULAR_STROKE, IconAgentPresetOutlineMedium, IconAgentPresetOutlineRegular, IconAlarmClockOutlineMedium, IconAlarmClockOutlineRegular, IconApiOutlineMedium, IconApiOutlineRegular, IconArchiveCheckOutlineMedium, IconArchiveCheckOutlineRegular, 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, Input, JsonBlock, JsonTree, LinkIconMedium, LinkIconRegular, MarkdownDelegateProvider, MarkdownText, Menu, MenuItemButton, Modal, OnboardingSurface, 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, StateDot, Switch, Tag, TerminalBlock, TextShimmer, Toast, Tooltip, WebBlock, classifyFileType, classifyLinkPath, diffTotals, extractMarkdownPlainText, fileExtension, fileSizeText, isDarwinDesktop, languageForPath, projectUserText, rankByName, relativeTime, settingsNumberField, settingsTextField, useAnchoredMaxHeight, useAnchoredPosition, useCodeHighlighter, useDismissOnOutsidePointer, writeClipboard };
 
 //# sourceMappingURL=index.js.map

package/lib/markdown/MarkdownText.module.css

@@ -442,3 +442,26 @@
 .compact :global(.katex-display) {
   margin: 4px 0;
 }
+
+.imageButton {
+  display: inline-block;
+  max-width: 100%;
+  padding: 0;
+  border: 0;
+  border-radius: 8px;
+  background: transparent;
+  vertical-align: middle;
+  cursor: zoom-in;
+}
+.imageButton .image { max-width: min(100%, 640px); max-height: 360px; }
+.imageButton:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary); outline-offset: 3px; }
+.previewName {
+  display: block;
+  margin-top: 8px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  color: var(--dsw-alias-label-secondary);
+  font-size: 12px;
+  line-height: 18px;
+}

package/lib/types/HoverCard.d.ts

@@ -8,6 +8,7 @@ import type { ReactNode, RefObject } from 'react';
  * @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.
@@ -15,8 +16,10 @@ import type { ReactNode, RefObject } from 'react';
  * @param props.copiedLabel - localized visible success label.
  * @returns anchor wrapper with the conditional portaled card.
  */
-export declare function HoverCard({ anchor, content, openDelayMs, disabled, copyText, copyLabel, copiedLabel, variant, widthAnchorRef, }: {
+export declare function HoverCard({ anchor, content, openDelayMs, disabled, copyText, copyLabel, copiedLabel, variant, widthAnchorRef, inline, }: {
     anchor: ReactNode;
+    /** Inline media preview using the shared menu material and keyboard focus. */
+    inline?: boolean;
     content: ReactNode;
     openDelayMs?: number;
     disabled?: boolean;

package/lib/types/ImageLightbox.d.ts

@@ -0,0 +1,27 @@
+/** Lightbox strings the owner resolves from its own locale namespace. */
+export interface ImageLightboxLabels {
+    /** Accessible name of the preview dialog. */
+    dialog: string;
+    /** Accessible label of the close control. */
+    close: string;
+}
+/**
+ * Document-level original-image preview opened by clicking a thumbnail.
+ * Closes on Escape, backdrop press, or the close control, and restores focus
+ * to the opener on unmount. Rendered through a body portal: an opener inside
+ * a transformed or filtered ancestor would otherwise trap the fixed backdrop
+ * in that ancestor's box instead of covering the viewport.
+ *
+ * @param props.src - the original image URL.
+ * @param props.alt - the image's alt text.
+ * @param props.labels - dialog and close-control strings.
+ * @param props.onClose - dismiss callback owned by the opener.
+ * @returns the modal preview dialog.
+ */
+export declare function ImageLightbox({ src, alt, labels, onClose }: {
+    src: string;
+    alt: string;
+    labels: ImageLightboxLabels;
+    onClose: () => void;
+}): import("react").ReactPortal;
+//# sourceMappingURL=ImageLightbox.d.ts.map

package/lib/types/ImagePreview.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Render an image without introducing a second activation target.
+ * @param props - Source, accessible description, localized status.
+ * @returns A contained preview with loading or failure status.
+ */
+export declare function ImagePreview({ src, alt, loadingLabel, failedLabel }: {
+    src: string;
+    alt: string;
+    loadingLabel: string;
+    failedLabel: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=ImagePreview.d.ts.map

package/lib/types/Modal.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from 'react';
+import type { KeyboardEventHandler, ReactNode } from 'react';
 interface ModalBaseProps {
     open: boolean;
     onClose: () => void;
@@ -8,6 +8,7 @@ interface ModalBaseProps {
     footer?: ReactNode;
     className?: string;
     contentClassName?: string;
+    onKeyDownCapture?: KeyboardEventHandler<HTMLDivElement>;
 }
 type ModalProps = ModalBaseProps & ({
     headless: true;
@@ -29,8 +30,9 @@ type ModalProps = ModalBaseProps & ({
  * @param props.contentClassName - optional class for a scrollable content region.
  * @param props.headless - render children directly in the card (no default
  * header/close/body chrome); mask, card, Escape, and aria-label remain.
+ * @param props.onKeyDownCapture - handle a nested dialog's keys before the document Escape listeners.
  * @returns null when closed; otherwise the overlay tree.
  */
-export declare function Modal({ open, onClose, title, closeLabel, description, children, footer, className, contentClassName, headless, }: ModalProps): import("react").ReactPortal | null;
+export declare function Modal({ open, onClose, title, closeLabel, description, children, footer, className, contentClassName, onKeyDownCapture, headless, }: ModalProps): import("react").ReactPortal | null;
 export {};
 //# sourceMappingURL=Modal.d.ts.map

package/lib/types/Tooltip.d.ts

@@ -1,4 +1,4 @@
-/** Anchor-preserving tooltips with optional body portals for clipping containers. */
+/** Anchor-preserving tooltips; an optional body portal escapes clipping containers and stacking contexts that cap the bubble's z-index. */
 import type { FocusEventHandler, MouseEventHandler, ReactElement, Ref } from 'react';
 /** Bubble placement relative to the anchor. */
 export type TooltipSide = 'right' | 'bottom' | 'top';
@@ -19,8 +19,11 @@ type TooltipLabel = string | (() => string);
  * @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 to escape containing blocks and clipping ancestors.
+ * @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; keyboard focus remains immediate.
+ * @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
@@ -31,11 +34,12 @@ type TooltipLabel = string | (() => string);
  * anchor dismisses the bubble until the next trigger, and focus arriving after a pointer
  * interaction (a closing menu refocusing its trigger) never raises it.
  */
-export declare function Tooltip({ label, side, align, delayMs, disabled, portal, maxWidth, children }: {
+export declare function Tooltip({ label, side, align, delayMs, gap, disabled, portal, maxWidth, children }: {
     label: TooltipLabel;
     side?: TooltipSide;
     align?: 'center' | 'end';
     delayMs?: number;
+    gap?: number;
     disabled?: boolean;
     portal?: boolean;
     maxWidth?: number;

package/lib/types/icons/index.d.ts

@@ -162,6 +162,10 @@ export declare const IconWarningTriangleOutlineMedium: (props: IconProps) => imp
 export declare const IconUserOutlineRegular: (props: IconProps) => import("react").JSX.Element;
 /** Medium IconUserOutline artwork with a 1.3px stroke. */
 export declare const IconUserOutlineMedium: (props: IconProps) => import("react").JSX.Element;
+/** Regular one-pixel IconUsersOutline artwork: a front person with a second person behind. */
+export declare const IconUsersOutlineRegular: (props: IconProps) => import("react").JSX.Element;
+/** Medium IconUsersOutline artwork with a 1.3px stroke. */
+export declare const IconUsersOutlineMedium: (props: IconProps) => import("react").JSX.Element;
 /** Regular one-pixel IconPaperPlaneOutline artwork. */
 export declare const IconPaperPlaneOutlineRegular: (props: IconProps) => import("react").JSX.Element;
 /** Medium IconPaperPlaneOutline artwork with a 1.3px stroke. */

package/lib/types/index.d.ts

@@ -85,4 +85,6 @@ export { extractMarkdownPlainText } from './markdown/plain-text.ts';
 export type { MarkdownPlainTextMode, MarkdownPlainTextOptions } from './markdown/plain-text.ts';
 export * from './icons/index.tsx';
 export { PluginArtworkTerminal, PluginArtworkLoop, PluginArtworkSubagent, PluginArtworkSearch, PluginArtworkDefault, } from './plugin-artwork.tsx';
+export { ImageLightbox } from './ImageLightbox.tsx';
+export type { ImageLightboxLabels } from './ImageLightbox.tsx';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/markdown/MarkdownDelegate.d.ts

@@ -1,4 +1,5 @@
 import type { ReactNode } from 'react';
+import type { ImageLightboxLabels } from '../ImageLightbox.tsx';
 /**
  * Handle one sanitized absolute HTTP(S) URL selected from Markdown.
  * @param href - destination URL.
@@ -6,6 +7,15 @@ import type { ReactNode } from 'react';
 export type MarkdownExternalLinkHandler = (href: string) => void;
 /** Navigation capabilities supplied by the nearest Markdown owner. */
 export interface MarkdownDelegate {
+    /** Image previews for decoded local paths in this owner's workspace. */
+    readonly fileImages?: {
+        resolve: (path: string) => string | undefined;
+        labels: ImageLightboxLabels & {
+            open: string;
+            loading: string;
+            failed: string;
+        };
+    } | undefined;
     /** Ordinary HTTP(S) activation; absent handlers retain native anchor behavior. */
     readonly openExternalLink?: MarkdownExternalLinkHandler | undefined;
     /**
@@ -27,7 +37,7 @@ export interface MarkdownDelegateProviderProps extends MarkdownDelegate {
  * @param props - Child tree and its file and HTTP(S) link handlers.
  * @returns the scoped child tree.
  */
-export declare function MarkdownDelegateProvider({ children, openExternalLink, openFile, }: MarkdownDelegateProviderProps): ReactNode;
+export declare function MarkdownDelegateProvider({ children, openExternalLink, openFile, fileImages, }: MarkdownDelegateProviderProps): ReactNode;
 /**
  * Read the nearest Markdown navigation capabilities.
  * @returns Owner callbacks, or an empty delegate outside a provider.

package/lib/types/markdown/local-image-syntax.d.ts

@@ -0,0 +1,10 @@
+/** Recover standalone local image references with bare spaces without changing code or source offsets. */
+import type { Root } from 'mdast';
+/**
+ * Recover only unambiguous, unescaped image-only paragraphs containing a local path with spaces.
+ * @param root - Parsed Markdown tree, modified in place.
+ * @param source - Original source used to distinguish authored syntax from escaped examples.
+ * @returns The same root with recovered image nodes.
+ */
+export declare function recoverLocalImages(root: Root, source: string): Root;
+//# sourceMappingURL=local-image-syntax.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-primitives",
   "description": "Pure React atoms for the dsh web UI: controls, icons, markdown, and JSON inspectors (zero cordis)",
-  "version": "0.1.7-alpha.2",
+  "version": "0.1.7-rc.1",
   "publishConfig": {
     "access": "public"
   },
@@ -47,9 +47,9 @@
     "micromark-extension-gfm": "^3.0.0",
     "micromark-util-sanitize-uri": "^2.0.1",
     "simple-icons": "16.31.0",
+    "@deepseek-ai/dsh-client-store": "0.1.7-rc.1",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-store": "0.1.7-alpha.2"
+    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-rc.1"
   },
   "files": [
     "lib/index.js",