@wzrhine/agent 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog · @wzrhine/agent
+
+格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。本包为 **Experimental**，0.x 期间 API 可能调整。
+
+## [Unreleased]
+
+（暂无）
+
+## [0.1.0] - 2026-10-12
+
+首次发布。
+
+### Added
+- **M12（ADR-0010 / 0011 / 0012）**：新包。基座：`AgentMessagesProvider`（`agentZhCN` / `agentEnUS`）、`useAgentFormat`、`AgentIcon`、`StatusGlyph`、`AgentStatus`、`AgentSpark`、`AgentEntrance`、`useAgentLoop`。
+- 组件族（图册 46 个组件全覆盖）：
+  - Shell：AgentShell（自测宽度三档布局）、ResizeHandle、AgentHeader、ConversationList / ConversationRow、AgentSidePane、AgentEmptyState。
+  - Message：MessageList（跟随、锚点、`holdFollow`）、JumpToLatest、AgentMessage、MessagePart（13 类，未知类型兜底）、CodeBlock、ThinkingBlock、CitationChip、MessageActions（能力禁用原因、重新编辑本轮输入）、RunDetails、SkillUseList、AgentProcess、RunStatus。
+  - Tools：ToolActivity、ToolRecord、CodeModeToolTree、ToolOutput、ToolHistory、ChunkPager、DiffPreview / MultiFileDiff，以及 11 类工具专项详情。
+  - Composer：Composer、ComposerInput（token 镜像、IME 防护）、MentionMenu、SlashCommandMenu、AttachmentList、SendStopButton、ModelPicker、PermissionPicker、ComposerNotice。
+  - Intervention：ApprovalPanel（材料门禁、未知回执用同一 actionId 重试）、QuestionnaireCard、ErrorRecoveryNotice、InterventionDock、GrantList。
+  - Workspace 与产物：PersistentTerminal / TerminalTabs、TerminalRow / TerminalList、SubAgentCard / SubAgentList、ContextUsage、PinnedSummary、ActivityLedger、RunSummary、CompactionNotice、ArtifactCard / ArtifactList、FilePreview、FilePreviewTabs。
+- 动效（ADR-0012）：首次出现才入场、折叠高度过渡、Send ↔ Stop 交叉淡入、AgentSpark 分阶段节奏与静态帧；循环只在可见、在视口内且非减动时运行。
+- 文案：`agentZhCN` / `agentEnUS`（英文未经母语审校），按组件族拆分；数字与时间使用最近 `RhineProvider` 的 locale。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WhiteZhi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,29 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @wzrhine/agent
+
+WzRhineLab UI 的 **Agent 界面组件**：工作台外壳、会话索引、消息流与思考过程、工具记录（含十类工具专项与 Diff）、Composer（token 镜像、@ 引用、/ 命令、模型与权限选择）、审批与问卷、终端、子任务、上下文用量、产物与文件预览，以及配套的 Agent 动效。
+
+组件只接收 view-model 快照（类型来自 [`@wzrhine/agent-core`](../agent-core/README.md)，本包会重新导出）并发出动作回调；不包含任何运行时、请求、缓存、Markdown / 高亮库或桌面 API。
+
+> 实验性（0.x 期间 API 可能调整）；MIT 许可证。
+
+```sh
+pnpm add @wzrhine/agent @wzrhine/agent-core @wzrhine/react @wzrhine/tokens react react-dom motion
+```
+
+```tsx
+import '@wzrhine/tokens/styles.css';
+import '@wzrhine/react/styles.css';
+import '@wzrhine/agent/styles.css';
+import { RhineProvider } from '@wzrhine/react';
+import { AgentStatus, runStatusMeta } from '@wzrhine/agent';
+
+<RhineProvider>
+  <AgentStatus {...runStatusMeta.running} label="运行中" />
+</RhineProvider>;
+```
+
+- 范围与拆包：[ADR-0010](https://github.com/BaiZhi967/WzRhineLab-UI/blob/main/docs/development/adr/0010-m12-agent-ui-plan.md)；契约：[ADR-0011](https://github.com/BaiZhi967/WzRhineLab-UI/blob/main/docs/development/adr/0011-agent-contracts.md)；动效：[ADR-0012](https://github.com/BaiZhi967/WzRhineLab-UI/blob/main/docs/development/adr/0012-agent-motion.md)
+- 接入指南：[docs/planning/agent-ui-adoption.md](https://github.com/BaiZhi967/WzRhineLab-UI/blob/main/docs/planning/agent-ui-adoption.md)
+- API 参考（自动生成）：[docs/api/agent.md](https://github.com/BaiZhi967/WzRhineLab-UI/blob/main/docs/api/agent.md)
+- 变更记录：[CHANGELOG.md](./CHANGELOG.md)
+- 许可证：[MIT](./LICENSE)

package/dist/agent.css

@@ -0,0 +1,15 @@
+/*
+ * @wzrhine/agent · style entry (`@wzrhine/agent/styles.css`). Load after `@wzrhine/tokens/styles.css`
+ * and `@wzrhine/react/styles.css`; requires a `.rl-theme` ancestor (RhineProvider).
+ * Only `rl-agent-` classes and `--rl-*` tokens; host elements and :root stay untouched.
+ */
+@import './styles/base.css';
+@import './styles/shell.css';
+@import './styles/conversation.css';
+@import './styles/message.css';
+@import './styles/process.css';
+@import './styles/tools.css';
+@import './styles/composer.css';
+@import './styles/intervention.css';
+@import './styles/workspace.css';
+@import './styles/artifact.css';

package/dist/components/artifact/ArtifactCard.d.ts

@@ -0,0 +1,56 @@
+import * as React from 'react';
+import type { ArtifactKind, ArtifactView } from '@wzrhine/agent-core';
+import type { AgentIconName } from '../../primitives/icons.js';
+import type { HeadingLevel, WorkspaceMessagesProp } from '../workspace/shared.js';
+export declare const artifactKindIcon: Record<ArtifactKind, AgentIconName>;
+export type ArtifactCardProps = Omit<React.HTMLAttributes<HTMLElement>, 'children'> & {
+    artifact: ArtifactView;
+    onOpen?: (artifact: ArtifactView) => void;
+    onDownload?: (artifact: ArtifactView) => void;
+    /** Shows the file in its folder (host file manager). */
+    onReveal?: (artifact: ArtifactView) => void;
+    /** Retries a failed artifact. */
+    onRetry?: (artifact: ArtifactView) => void;
+    /** Custom preview (chart, rendered markdown…); default: image thumbnail, text excerpt or kind icon. */
+    renderPreview?: (artifact: ArtifactView) => React.ReactNode;
+    headingLevel?: HeadingLevel;
+    messages?: WorkspaceMessagesProp;
+};
+/**
+ * ArtifactCard (atlas 29): one generated file / report / image. 「已保存」 appears only for
+ * `status: 'saved'`; `generating` shows a Spinner without a percentage; `partial` and `failed`
+ * keep their reason as visible text. Actions render only with their callbacks; deleted or
+ * unavailable artifacts cannot be opened or downloaded.
+ *
+ * Accessibility: an `<article>` named by its title heading; image previews need `alt` (falls
+ * back to an empty alt plus the visible title, so nothing is read twice). Motion: none here;
+ * `ArtifactList` gives new items one AgentEntrance.
+ */
+export declare const ArtifactCard: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLElement>, "children"> & {
+    artifact: ArtifactView;
+    onOpen?: (artifact: ArtifactView) => void;
+    onDownload?: (artifact: ArtifactView) => void;
+    /** Shows the file in its folder (host file manager). */
+    onReveal?: (artifact: ArtifactView) => void;
+    /** Retries a failed artifact. */
+    onRetry?: (artifact: ArtifactView) => void;
+    /** Custom preview (chart, rendered markdown…); default: image thumbnail, text excerpt or kind icon. */
+    renderPreview?: (artifact: ArtifactView) => React.ReactNode;
+    headingLevel?: HeadingLevel;
+    messages?: WorkspaceMessagesProp;
+} & React.RefAttributes<HTMLElement>>;
+export type ArtifactListProps = Omit<React.HTMLAttributes<HTMLUListElement>, 'children'> & Pick<ArtifactCardProps, 'onOpen' | 'onDownload' | 'onReveal' | 'onRetry' | 'renderPreview' | 'headingLevel' | 'messages'> & {
+    artifacts: ArtifactView[];
+    /** The host listed only part of the artifacts: adds 「部分产物未列出」. */
+    truncated?: boolean;
+    /** Opens the full artifact list; drawn next to the truncated note. */
+    onShowAll?: () => void;
+};
+/**
+ * Artifacts as a list (`<ul>`). Duplicate ids are dropped; items present on first render are
+ * static, items added later enter once (AgentEntrance `row`, reduced → no movement).
+ * `truncated` adds a plain note after the list (「部分产物未列出」, never a count it does not know)
+ * with an optional 「查看全部产物」 button.
+ */
+export declare function ArtifactList({ artifacts, onOpen, onDownload, onReveal, onRetry, renderPreview, headingLevel, truncated, onShowAll, messages: override, className, ...rest }: ArtifactListProps): React.JSX.Element;
+//# sourceMappingURL=ArtifactCard.d.ts.map

package/dist/components/artifact/ArtifactCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactCard.d.ts","sourceRoot":"","sources":["../../../src/components/artifact/ArtifactCard.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAa,YAAY,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAKlG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAElF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,YAAY,EAAE,aAAa,CAShE,CAAC;AAgBF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,GAAG;IACpF,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAC1C,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAC9C,wDAAwD;IACxD,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5C,iCAAiC;IACjC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAC3C,uGAAuG;IACvG,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,KAAK,CAAC,SAAS,CAAC;IAC5D,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY;cAvBb,YAAY;aACb,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI;iBAC5B,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI;IAC7C,wDAAwD;eAC7C,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI;IAC3C,iCAAiC;cACvB,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI;IAC1C,uGAAuG;oBACvF,CAAC,QAAQ,EAAE,YAAY,KAAK,KAAK,CAAC,SAAS;mBAC5C,YAAY;eAChB,qBAAqB;qCAgGhC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,GACtF,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,eAAe,GAAG,cAAc,GAAG,UAAU,CAAC,GAAG;IAC1H,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB,CAAC;AAEJ;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,MAAM,EACN,UAAU,EACV,QAAQ,EACR,OAAO,EACP,aAAa,EACb,YAAY,EACZ,SAAS,EACT,SAAS,EACT,QAAQ,EAAE,QAAQ,EAClB,SAAS,EACT,GAAG,IAAI,EACR,EAAE,iBAAiB,qBA+CnB"}

package/dist/components/artifact/ArtifactCard.js

@@ -0,0 +1,78 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import { Button, IconButton, Spinner } from '@wzrhine/react';
+import { useAgentFormat } from '../../provider/AgentMessages.js';
+import { AgentEntrance } from '../../motion/agent-motion.js';
+import { StatusGlyph } from '../../primitives/StatusGlyph.js';
+import { AgentIcon } from '../../primitives/icons.js';
+import { cx } from '../../utils/cx.js';
+import { Heading, useIsNewId, useWorkspaceMessages } from '../workspace/shared.js';
+export const artifactKindIcon = {
+    text: 'file',
+    markdown: 'file',
+    code: 'code',
+    image: 'image',
+    file: 'file',
+    diff: 'layers',
+    data: 'database',
+    unknown: 'file',
+};
+const statusGlyph = {
+    generating: { glyph: 'pending', tone: 'info' },
+    partial: { glyph: 'unknown', tone: 'warning' },
+    saved: { glyph: 'done', tone: 'success' },
+    failed: { glyph: 'failed', tone: 'danger' },
+    unavailable: { glyph: 'stopped', tone: 'neutral' },
+    stale: { glyph: 'unknown', tone: 'warning' },
+};
+/** Only same-origin / data / blob thumbnails are drawn; anything else falls back to the kind icon. */
+function isSafeThumbnail(src) {
+    return /^(data:image\/|blob:|\/|\.\/)/.test(src);
+}
+/**
+ * ArtifactCard (atlas 29): one generated file / report / image. 「已保存」 appears only for
+ * `status: 'saved'`; `generating` shows a Spinner without a percentage; `partial` and `failed`
+ * keep their reason as visible text. Actions render only with their callbacks; deleted or
+ * unavailable artifacts cannot be opened or downloaded.
+ *
+ * Accessibility: an `<article>` named by its title heading; image previews need `alt` (falls
+ * back to an empty alt plus the visible title, so nothing is read twice). Motion: none here;
+ * `ArtifactList` gives new items one AgentEntrance.
+ */
+export const ArtifactCard = React.forwardRef(function ArtifactCard({ artifact, onOpen, onDownload, onReveal, onRetry, renderPreview, headingLevel = 3, messages: override, className, ...rest }, ref) {
+    const m = useWorkspaceMessages(override);
+    const format = useAgentFormat();
+    const id = React.useId();
+    const titleId = `${id}-title`;
+    const reasonId = `${id}-reason`;
+    const glyph = statusGlyph[artifact.status];
+    const gone = artifact.status === 'unavailable' || artifact.change === 'deleted';
+    const busy = artifact.status === 'generating';
+    const preview = renderPreview ? (renderPreview(artifact)) : artifact.kind === 'image' && artifact.preview && isSafeThumbnail(artifact.preview) ? (_jsx("img", { className: "rl-agent-artifact__thumb", src: artifact.preview, alt: artifact.alt ?? '', loading: "lazy" })) : artifact.preview && artifact.kind !== 'image' ? (_jsx("span", { className: "rl-agent-artifact__excerpt", "aria-hidden": "true", children: artifact.preview })) : (_jsx(AgentIcon, { name: artifactKindIcon[artifact.kind], className: "rl-agent-artifact__kind-icon" }));
+    return (_jsxs("article", { ...rest, ref: ref, className: cx('rl-agent-artifact', className), "aria-labelledby": titleId, "aria-describedby": artifact.reason ? reasonId : undefined, "aria-busy": busy || undefined, "data-status": artifact.status, "data-kind": artifact.kind, children: [_jsx("div", { className: "rl-agent-artifact__preview", children: preview }), _jsxs("div", { className: "rl-agent-artifact__body", children: [_jsx(Heading, { level: headingLevel, id: titleId, className: "rl-agent-artifact__title", title: artifact.path ?? artifact.title, children: artifact.title }), _jsxs("p", { className: "rl-agent-artifact__meta", children: [_jsx("span", { children: m.artifactKind[artifact.kind] }), artifact.size !== undefined && _jsx("span", { children: format.bytes(artifact.size) }), artifact.version && _jsx("span", { children: m.artifactVersion(artifact.version) }), artifact.change && (_jsx("span", { className: "rl-agent-artifact__change", "data-change": artifact.change, children: m.artifactChange[artifact.change] }))] }), _jsxs("p", { className: "rl-agent-artifact__status", "data-tone": glyph.tone, children: [busy ? _jsx(Spinner, { size: "sm" }) : _jsx(StatusGlyph, { name: glyph.glyph, tone: glyph.tone }), _jsx("span", { children: m.artifactStatus[artifact.status] })] }), artifact.reason && (_jsx("p", { id: reasonId, className: "rl-agent-artifact__reason", children: artifact.reason }))] }), (onOpen || onDownload || onReveal || (onRetry && artifact.status === 'failed')) && (_jsxs("div", { className: "rl-agent-artifact__actions", children: [artifact.status === 'failed' && onRetry && (_jsx(Button, { size: "sm", variant: "secondary", iconStart: _jsx(AgentIcon, { name: "retry" }), "aria-label": m.artifactRetryNamed(artifact.title), onClick: () => onRetry(artifact), children: m.artifactRetry })), onOpen && !gone && artifact.status !== 'failed' && (_jsx(Button, { size: "sm", variant: "secondary", "aria-label": m.artifactOpenNamed(artifact.title), onClick: () => onOpen(artifact), children: m.artifactOpen })), onDownload && !gone && !busy && artifact.status !== 'failed' && (_jsx(IconButton, { size: "sm", variant: "ghost", icon: _jsx(AgentIcon, { name: "download" }), label: m.artifactDownload(artifact.title), onClick: () => onDownload(artifact) })), onReveal && !gone && artifact.path && (_jsx(IconButton, { size: "sm", variant: "ghost", icon: _jsx(AgentIcon, { name: "folder" }), label: m.artifactReveal(artifact.title), onClick: () => onReveal(artifact) }))] }))] }));
+});
+/**
+ * Artifacts as a list (`<ul>`). Duplicate ids are dropped; items present on first render are
+ * static, items added later enter once (AgentEntrance `row`, reduced → no movement).
+ * `truncated` adds a plain note after the list (「部分产物未列出」, never a count it does not know)
+ * with an optional 「查看全部产物」 button.
+ */
+export function ArtifactList({ artifacts, onOpen, onDownload, onReveal, onRetry, renderPreview, headingLevel, truncated, onShowAll, messages: override, className, ...rest }) {
+    const m = useWorkspaceMessages(override);
+    const unique = React.useMemo(() => {
+        const seen = new Set();
+        return artifacts.filter((a) => (seen.has(a.id) ? false : (seen.add(a.id), true)));
+    }, [artifacts]);
+    const isNew = useIsNewId(unique.map((a) => a.id));
+    const note = truncated ? (_jsxs("p", { className: "rl-agent-artifact-list__truncated", children: [_jsx(AgentIcon, { name: "info" }), _jsx("span", { children: m.artifactTruncated }), onShowAll && (_jsx(Button, { size: "sm", variant: "ghost", onClick: onShowAll, children: m.artifactShowAll }))] })) : null;
+    if (unique.length === 0) {
+        // Nothing listed but more exists: 「暂无产物」 would be false, so only the note is shown.
+        return note ?? _jsx("p", { className: "rl-agent-artifact-list__empty", children: m.artifactEmpty });
+    }
+    const list = (_jsx("ul", { ...rest, className: cx('rl-agent-artifact-list', className), "aria-label": rest['aria-label'] ?? m.artifactList, children: unique.map((artifact) => (_jsx(AgentEntrance, { as: "li", kind: "row", animate: isNew(artifact.id), className: "rl-agent-artifact-list__item", children: _jsx(ArtifactCard, { artifact: artifact, onOpen: onOpen, onDownload: onDownload, onReveal: onReveal, onRetry: onRetry, renderPreview: renderPreview, headingLevel: headingLevel, messages: override }) }, artifact.id))) }));
+    if (!note)
+        return list;
+    return (_jsxs("div", { className: "rl-agent-artifact-list__wrap", children: [list, note] }));
+}
+//# sourceMappingURL=ArtifactCard.js.map

package/dist/components/artifact/ArtifactCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactCard.js","sourceRoot":"","sources":["../../../src/components/artifact/ArtifactCard.tsx"],"names":[],"mappings":"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"}

package/dist/components/artifact/FilePreview.d.ts

@@ -0,0 +1,117 @@
+import * as React from 'react';
+import type { BreadcrumbItem } from '@wzrhine/react';
+import type { FilePreviewMode, FilePreviewView } from '@wzrhine/agent-core';
+import type { HeadingLevel, WorkspaceMessagesProp } from '../workspace/shared.js';
+/** A zoom percentage of the image's natural width, or `fit` (scale to the preview width). */
+export type FilePreviewZoom = number | 'fit';
+/** One way to open the file, offered by the host (an editor, the system viewer, a folder). */
+export interface FileOpenTarget {
+    id: string;
+    label: string;
+    /** `app` opens the file; `reveal` shows it in a folder. Default `app`. */
+    group?: 'app' | 'reveal';
+}
+export type FilePreviewProps = Omit<React.HTMLAttributes<HTMLElement>, 'children'> & {
+    file: FilePreviewView;
+    /** Active tab (controlled). */
+    mode?: FilePreviewMode;
+    defaultMode?: FilePreviewMode;
+    onModeChange?: (mode: FilePreviewMode) => void;
+    /** Markdown renderer for the preview tab; default shows the source. */
+    renderMarkdown?: (source: string) => React.ReactNode;
+    /** Code renderer (highlighting); default is numbered plain lines. */
+    renderCode?: (code: string, language?: string) => React.ReactNode;
+    onRetry?: () => void;
+    onReload?: () => void;
+    /** Loads the next chunk of a partially loaded file. */
+    onLoadMore?: () => void;
+    onOpenExternal?: (file: FilePreviewView) => void;
+    /** Adds the file as a reference to the conversation. */
+    onReference?: (file: FilePreviewView) => void;
+    onClose?: () => void;
+    /** Ways to open the file. With `onOpenWith` they render a split button + menu. */
+    openTargets?: FileOpenTarget[];
+    /** Target used by the primary half of the split button; default the first `app` target. */
+    defaultOpenTarget?: string;
+    onOpenWith?: (targetId: string, file: FilePreviewView) => void;
+    /** Copies `file.path` (menu item 「复制路径」); default writes it to the clipboard. */
+    onCopyPath?: (path: string, file: FilePreviewView) => void | Promise<void>;
+    /** Image zoom percentages (of the natural width); a 「适应宽度」 option is always added. */
+    zoomLevels?: number[];
+    /** Initial image zoom; default `fit`. */
+    defaultZoom?: FilePreviewZoom;
+    /**
+     * Workspace root. Paths under it show as a workspace-relative breadcrumb (root name first);
+     * paths outside it get the 「外部」 badge.
+     */
+    breadcrumbRoot?: string;
+    /** Copy the loaded text. Default true for text-like files. */
+    copyable?: boolean;
+    headingLevel?: HeadingLevel;
+    messages?: WorkspaceMessagesProp;
+};
+/**
+ * FilePreview (atlas 30): read-only preview of a file the adapter loaded. Tabs (`@wzrhine/react`,
+ * arrow keys) switch preview / raw / metadata; text is real, selectable text in its own focusable
+ * scroll region, with decorative line numbers that are not copied. Images get their `alt` and a
+ * zoom group (`zoomLevels`, default 25–400% of the natural width, plus 「适应宽度」) inside a scroll
+ * container. Binary and unknown kinds say 「无法预览此类型」 and offer 「在外部打开」. Partial loads
+ * say how much is loaded and offer 「加载更多」; a changed file keeps the old content with
+ * 「文件已更新」 + 「重新加载」, and `onReload` is also always offered as 「重新读取」.
+ *
+ * The path is a `Breadcrumb` (`<nav>` + `<ol>`), workspace-relative under `breadcrumbRoot`.
+ * `openTargets` + `onOpenWith` draw a split control: the primary button opens with the default
+ * target, the menu button (`Menu`: arrow keys, Escape, focus return) lists every target plus
+ * 「复制路径」 and 「在对话中引用」.
+ *
+ * The component reads nothing itself; the clipboard is the only browser API it touches.
+ * Motion: none (tab indicator is the Tabs component's own CSS transition).
+ */
+export declare const FilePreview: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLElement>, "children"> & {
+    file: FilePreviewView;
+    /** Active tab (controlled). */
+    mode?: FilePreviewMode;
+    defaultMode?: FilePreviewMode;
+    onModeChange?: (mode: FilePreviewMode) => void;
+    /** Markdown renderer for the preview tab; default shows the source. */
+    renderMarkdown?: (source: string) => React.ReactNode;
+    /** Code renderer (highlighting); default is numbered plain lines. */
+    renderCode?: (code: string, language?: string) => React.ReactNode;
+    onRetry?: () => void;
+    onReload?: () => void;
+    /** Loads the next chunk of a partially loaded file. */
+    onLoadMore?: () => void;
+    onOpenExternal?: (file: FilePreviewView) => void;
+    /** Adds the file as a reference to the conversation. */
+    onReference?: (file: FilePreviewView) => void;
+    onClose?: () => void;
+    /** Ways to open the file. With `onOpenWith` they render a split button + menu. */
+    openTargets?: FileOpenTarget[];
+    /** Target used by the primary half of the split button; default the first `app` target. */
+    defaultOpenTarget?: string;
+    onOpenWith?: (targetId: string, file: FilePreviewView) => void;
+    /** Copies `file.path` (menu item 「复制路径」); default writes it to the clipboard. */
+    onCopyPath?: (path: string, file: FilePreviewView) => void | Promise<void>;
+    /** Image zoom percentages (of the natural width); a 「适应宽度」 option is always added. */
+    zoomLevels?: number[];
+    /** Initial image zoom; default `fit`. */
+    defaultZoom?: FilePreviewZoom;
+    /**
+     * Workspace root. Paths under it show as a workspace-relative breadcrumb (root name first);
+     * paths outside it get the 「外部」 badge.
+     */
+    breadcrumbRoot?: string;
+    /** Copy the loaded text. Default true for text-like files. */
+    copyable?: boolean;
+    headingLevel?: HeadingLevel;
+    messages?: WorkspaceMessagesProp;
+} & React.RefAttributes<HTMLElement>>;
+/**
+ * Breadcrumb items for a path. Under `root` the path is shown relative to it (root's last segment
+ * first); outside it (or for absolute paths without a root match) `outside` is true.
+ */
+export declare function pathCrumbs(path: string | undefined, root?: string): {
+    items: BreadcrumbItem[];
+    outside: boolean;
+} | undefined;
+//# sourceMappingURL=FilePreview.d.ts.map

package/dist/components/artifact/FilePreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilePreview.d.ts","sourceRoot":"","sources":["../../../src/components/artifact/FilePreview.tsx"],"names":[],"mappings":"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"}

package/dist/components/artifact/FilePreview.js

@@ -0,0 +1,207 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import { Alert, Breadcrumb, Button, IconButton, Menu, MenuGroup, MenuItem, MenuSeparator, Skeleton, Tab, TabList, TabPanel, Tabs } from '@wzrhine/react';
+import { useAgentFormat } from '../../provider/AgentMessages.js';
+import { AgentIcon } from '../../primitives/icons.js';
+import { cx } from '../../utils/cx.js';
+import { Heading, useWorkspaceMessages } from '../workspace/shared.js';
+const TEXT_KINDS = ['text', 'markdown', 'code'];
+const DEFAULT_ZOOMS = [25, 50, 100, 200, 400];
+/**
+ * FilePreview (atlas 30): read-only preview of a file the adapter loaded. Tabs (`@wzrhine/react`,
+ * arrow keys) switch preview / raw / metadata; text is real, selectable text in its own focusable
+ * scroll region, with decorative line numbers that are not copied. Images get their `alt` and a
+ * zoom group (`zoomLevels`, default 25–400% of the natural width, plus 「适应宽度」) inside a scroll
+ * container. Binary and unknown kinds say 「无法预览此类型」 and offer 「在外部打开」. Partial loads
+ * say how much is loaded and offer 「加载更多」; a changed file keeps the old content with
+ * 「文件已更新」 + 「重新加载」, and `onReload` is also always offered as 「重新读取」.
+ *
+ * The path is a `Breadcrumb` (`<nav>` + `<ol>`), workspace-relative under `breadcrumbRoot`.
+ * `openTargets` + `onOpenWith` draw a split control: the primary button opens with the default
+ * target, the menu button (`Menu`: arrow keys, Escape, focus return) lists every target plus
+ * 「复制路径」 and 「在对话中引用」.
+ *
+ * The component reads nothing itself; the clipboard is the only browser API it touches.
+ * Motion: none (tab indicator is the Tabs component's own CSS transition).
+ */
+export const FilePreview = React.forwardRef(function FilePreview({ file, mode, defaultMode = 'preview', onModeChange, renderMarkdown, renderCode, onRetry, onReload, onLoadMore, onOpenExternal, onReference, onClose, openTargets, defaultOpenTarget, onOpenWith, onCopyPath, zoomLevels, defaultZoom, breadcrumbRoot, copyable, headingLevel = 3, messages: override, className, ...rest }, ref) {
+    const m = useWorkspaceMessages(override);
+    const format = useAgentFormat();
+    const id = React.useId();
+    const titleId = `${id}-title`;
+    const textual = TEXT_KINDS.includes(file.kind);
+    const [innerMode, setInnerMode] = React.useState(defaultMode);
+    const modes = textual ? ['preview', 'raw', 'metadata'] : ['preview', 'metadata'];
+    const requested = mode ?? innerMode;
+    const active = modes.includes(requested) ? requested : 'preview';
+    const hasContent = file.content !== undefined && file.status !== 'loading' && file.status !== 'missing' && file.status !== 'unavailable' && file.status !== 'error';
+    const canCopy = (copyable ?? true) && textual && hasContent && Boolean(file.content);
+    const crumbs = React.useMemo(() => pathCrumbs(file.path, breadcrumbRoot), [file.path, breadcrumbRoot]);
+    const external = Boolean(file.external) || crumbs?.outside === true;
+    const changeMode = (next) => {
+        const key = next;
+        if (mode === undefined)
+            setInnerMode(key);
+        onModeChange?.(key);
+    };
+    return (_jsxs("section", { ...rest, ref: ref, className: cx('rl-agent-file', className), "aria-labelledby": titleId, "data-kind": file.kind, "data-status": file.status, children: [_jsxs("header", { className: "rl-agent-file__header", children: [_jsx(AgentIcon, { name: file.kind === 'image' ? 'image' : file.kind === 'code' ? 'code' : 'file', className: "rl-agent-file__icon" }), _jsxs("div", { className: "rl-agent-file__identity", children: [_jsx(Heading, { level: headingLevel, id: titleId, className: "rl-agent-file__name", title: file.name, children: file.name }), crumbs && (_jsx(Breadcrumb, { className: "rl-agent-file__crumbs", items: crumbs.items, label: m.fileBreadcrumb(file.name), expandLabel: m.fileBreadcrumbExpand, title: file.path })), (external || file.version) && (_jsxs("p", { className: "rl-agent-file__path", children: [external && _jsx("span", { className: "rl-agent-file__badge", children: m.fileExternal }), file.version && _jsx("span", { className: "rl-agent-file__version", children: m.artifactVersion(file.version) })] }))] }), onClose && _jsx(IconButton, { size: "sm", variant: "ghost", icon: _jsx(AgentIcon, { name: "close" }), label: m.fileClose, onClick: onClose })] }), _jsx(FileActions, { file: file, canCopy: canCopy, onOpenExternal: onOpenExternal, onReference: onReference, onReload: onReload, openTargets: openTargets, defaultOpenTarget: defaultOpenTarget, onOpenWith: onOpenWith, onCopyPath: onCopyPath, m: m }), _jsx(FileNotices, { file: file, onRetry: onRetry, onReload: onReload, onLoadMore: onLoadMore, m: m, format: format }), _jsxs(Tabs, { value: active, onValueChange: changeMode, size: "sm", className: "rl-agent-file__tabs", children: [_jsx(TabList, { "aria-label": m.fileModes, children: modes.map((key) => (_jsx(Tab, { value: key, children: m.fileMode[key] }, key))) }), _jsx(TabPanel, { value: "preview", className: "rl-agent-file__panel", children: _jsx(FileBody, { file: file, raw: false, renderMarkdown: renderMarkdown, renderCode: renderCode, onOpenExternal: onOpenExternal, zoomLevels: zoomLevels, defaultZoom: defaultZoom, m: m }) }), textual && (_jsx(TabPanel, { value: "raw", className: "rl-agent-file__panel", children: _jsx(FileBody, { file: file, raw: true, renderMarkdown: renderMarkdown, renderCode: renderCode, onOpenExternal: onOpenExternal, m: m }) })), _jsx(TabPanel, { value: "metadata", className: "rl-agent-file__panel", children: _jsx(FileMetadata, { file: file, m: m, format: format }) })] })] }));
+});
+async function writeClipboard(text) {
+    if (typeof navigator === 'undefined' || !navigator.clipboard)
+        throw new Error('clipboard');
+    await navigator.clipboard.writeText(text);
+}
+function FileActions({ file, canCopy, onOpenExternal, onReference, onReload, openTargets, defaultOpenTarget, onOpenWith, onCopyPath, m, }) {
+    const [copy, setCopy] = React.useState('idle');
+    const timer = React.useRef(undefined);
+    React.useEffect(() => () => clearTimeout(timer.current), []);
+    React.useEffect(() => setCopy('idle'), [file.content, file.path]);
+    const targets = onOpenWith ? (openTargets ?? []) : [];
+    const split = targets.length > 0;
+    if (!canCopy && !onOpenExternal && !onReference && !onReload && !split)
+        return null;
+    const run = async (write, ok, fail) => {
+        clearTimeout(timer.current);
+        try {
+            await write();
+            setCopy(ok);
+        }
+        catch {
+            setCopy(fail);
+        }
+        timer.current = setTimeout(() => setCopy('idle'), 2000);
+    };
+    const copyContent = () => run(() => writeClipboard(file.content ?? ''), 'copied', 'failed');
+    const copyPath = () => run(() => (onCopyPath ? onCopyPath(file.path, file) : writeClipboard(file.path)), 'path-copied', 'path-failed');
+    const announced = { idle: '', copied: m.fileCopied, failed: m.fileCopyFailed, 'path-copied': m.fileCopiedPath, 'path-failed': m.fileCopyPathFailed }[copy];
+    return (_jsxs("div", { className: "rl-agent-file__actions", children: [split && (_jsx(OpenWithSplit, { file: file, targets: targets, defaultTarget: defaultOpenTarget, onOpenWith: onOpenWith, onCopyPath: file.path ? () => void copyPath() : undefined, onReference: onReference, m: m })), canCopy && (_jsx(Button, { size: "sm", variant: "ghost", iconStart: _jsx(AgentIcon, { name: copy === 'copied' ? 'check' : 'copy' }), onClick: () => void copyContent(), children: copy === 'copied' ? m.fileCopied : copy === 'failed' ? m.fileCopyFailed : m.fileCopy })), onReference && (_jsx(Button, { size: "sm", variant: "ghost", iconStart: _jsx(AgentIcon, { name: "at" }), onClick: () => onReference(file), children: m.fileReference })), onReload && (_jsx(Button, { size: "sm", variant: "ghost", iconStart: _jsx(AgentIcon, { name: "retry" }), onClick: onReload, children: m.fileReread })), onOpenExternal && (_jsx(Button, { size: "sm", variant: "ghost", iconStart: _jsx(AgentIcon, { name: "external" }), onClick: () => onOpenExternal(file), children: m.fileOpenExternal })), _jsx("span", { className: "rl-agent-sr", role: "status", children: announced })] }));
+}
+/**
+ * Local split control: the primary button opens with the default target; the adjoining menu
+ * button (its own accessible name) opens a `Menu` with every target grouped by app / reveal,
+ * then 「复制路径」 and 「在对话中引用」. Both halves are real buttons in the tab order.
+ */
+function OpenWithSplit({ file, targets, defaultTarget, onOpenWith, onCopyPath, onReference, m, }) {
+    const apps = targets.filter((t) => (t.group ?? 'app') === 'app');
+    const reveals = targets.filter((t) => t.group === 'reveal');
+    const primary = targets.find((t) => t.id === defaultTarget) ?? apps[0] ?? targets[0];
+    const extras = Boolean(onCopyPath || onReference);
+    return (_jsxs("span", { className: "rl-agent-file__split", role: "group", "aria-label": m.fileOpenGroup.app, children: [_jsx(Button, { size: "sm", variant: "secondary", className: "rl-agent-file__split-main", iconStart: _jsx(AgentIcon, { name: primary.group === 'reveal' ? 'folder' : 'external' }), onClick: () => onOpenWith(primary.id, file), children: m.fileOpenWith(primary.label) }), _jsxs(Menu, { align: "end", trigger: _jsx(IconButton, { size: "sm", variant: "secondary", className: "rl-agent-file__split-menu", icon: _jsx(AgentIcon, { name: "chevron-down" }), label: m.fileOpenTargets(file.name) }), children: [apps.length > 0 && (_jsx(MenuGroup, { label: m.fileOpenGroup.app, children: apps.map((t) => (_jsx(MenuItem, { icon: _jsx(AgentIcon, { name: "external" }), onSelect: () => onOpenWith(t.id, file), children: t.label }, t.id))) })), reveals.length > 0 && (_jsx(MenuGroup, { label: m.fileOpenGroup.reveal, children: reveals.map((t) => (_jsx(MenuItem, { icon: _jsx(AgentIcon, { name: "folder" }), onSelect: () => onOpenWith(t.id, file), children: t.label }, t.id))) })), extras && _jsx(MenuSeparator, {}), onCopyPath && (_jsx(MenuItem, { icon: _jsx(AgentIcon, { name: "copy" }), onSelect: onCopyPath, children: m.fileCopyPath })), onReference && (_jsx(MenuItem, { icon: _jsx(AgentIcon, { name: "at" }), onSelect: () => onReference(file), children: m.fileReference }))] })] }));
+}
+/**
+ * Breadcrumb items for a path. Under `root` the path is shown relative to it (root's last segment
+ * first); outside it (or for absolute paths without a root match) `outside` is true.
+ */
+export function pathCrumbs(path, root) {
+    if (!path)
+        return undefined;
+    const norm = (p) => p.replace(/\\/g, '/').replace(/\/+$/, '');
+    const full = norm(path);
+    let segments;
+    let outside = false;
+    if (root) {
+        const base = norm(root);
+        const under = full === base || full.startsWith(`${base}/`) || (/^[a-z]:/i.test(base) && full.toLowerCase().startsWith(`${base.toLowerCase()}/`));
+        if (under) {
+            const rootName = base.split('/').filter(Boolean).pop() ?? base;
+            segments = [rootName, ...full.slice(base.length).split('/').filter(Boolean)];
+        }
+        else {
+            outside = true;
+            segments = full.split('/').filter(Boolean);
+        }
+    }
+    else {
+        segments = full.split('/').filter(Boolean);
+    }
+    if (segments.length === 0)
+        segments = [full];
+    return { items: segments.map((label) => ({ label })), outside };
+}
+function FileNotices({ file, onRetry, onReload, onLoadMore, m, format, }) {
+    const notices = [];
+    if (file.status === 'error') {
+        notices.push(_jsx(Alert, { tone: "danger", title: m.fileError, action: onRetry && _jsx(Button, { size: "sm", variant: "secondary", onClick: onRetry, children: m.fileRetry }), children: file.reason }, "error"));
+    }
+    if (file.status === 'missing' || file.status === 'unavailable') {
+        notices.push(_jsx(Alert, { tone: "warning", title: file.status === 'missing' ? m.fileMissing : m.fileUnavailable, children: file.reason }, "gone"));
+    }
+    if (file.status === 'changed') {
+        notices.push(_jsx(Alert, { tone: "info", title: m.fileChanged, action: onReload && _jsx(Button, { size: "sm", variant: "secondary", onClick: onReload, children: m.fileReload }), children: file.reason }, "changed"));
+    }
+    if (file.partial || file.status === 'large-file') {
+        const loaded = file.partial ? format.bytes(file.partial.loadedBytes) : undefined;
+        const total = file.partial?.totalBytes ?? file.size;
+        const text = loaded ? (total !== undefined ? m.fileLoaded(loaded, format.bytes(total)) : m.fileLoadedNoTotal(loaded)) : undefined;
+        notices.push(_jsx(Alert, { tone: "warning", title: m.fileLargeFile, action: onLoadMore && _jsx(Button, { size: "sm", variant: "secondary", onClick: onLoadMore, children: m.fileLoadMore }), children: text }, "partial"));
+    }
+    if (notices.length === 0)
+        return null;
+    return _jsx("div", { className: "rl-agent-file__notices", children: notices });
+}
+function FileBody({ file, raw, renderMarkdown, renderCode, onOpenExternal, zoomLevels, defaultZoom, m, }) {
+    if (file.status === 'loading') {
+        return (_jsxs("div", { className: "rl-agent-file__loading", "aria-busy": "true", children: [_jsx(Skeleton, { lines: 4 }), _jsx("span", { className: "rl-agent-sr", children: m.fileLoading })] }));
+    }
+    if (file.status === 'error' || file.status === 'missing' || file.status === 'unavailable') {
+        return _jsx("p", { className: "rl-agent-file__empty", children: m.fileNoContent });
+    }
+    if (file.kind === 'binary' || file.kind === 'unknown') {
+        return (_jsxs("div", { className: "rl-agent-file__unsupported", children: [_jsx(AgentIcon, { name: "file" }), _jsx("p", { children: m.fileUnsupported }), onOpenExternal && (_jsx(Button, { size: "sm", variant: "secondary", iconStart: _jsx(AgentIcon, { name: "external" }), onClick: () => onOpenExternal(file), children: m.fileOpenExternal }))] }));
+    }
+    if (file.content === undefined || file.content === '')
+        return _jsx("p", { className: "rl-agent-file__empty", children: m.fileNoContent });
+    if (file.kind === 'image')
+        return _jsx(ImagePreview, { file: file, levels: zoomLevels, defaultZoom: defaultZoom, m: m });
+    const label = m.fileContent(file.name);
+    if (!raw && file.kind === 'markdown' && renderMarkdown) {
+        return (_jsx("div", { className: "rl-agent-file__scroll rl-agent-file__markdown", role: "region", "aria-label": label, tabIndex: 0, children: renderMarkdown(file.content) }));
+    }
+    if (!raw && file.kind === 'code' && renderCode) {
+        return (_jsx("div", { className: "rl-agent-file__scroll", role: "region", "aria-label": label, tabIndex: 0, children: renderCode(file.content, file.language) }));
+    }
+    return _jsx(NumberedText, { text: file.content, label: label, numbered: !raw });
+}
+/** Plain text with decorative (not copied, not read) line numbers. */
+function NumberedText({ text, label, numbered }) {
+    const lines = React.useMemo(() => text.replace(/\n$/, '').split('\n'), [text]);
+    return (_jsx("div", { className: "rl-agent-file__scroll", role: "region", "aria-label": label, tabIndex: 0, children: _jsx("pre", { className: "rl-agent-file__code", "data-numbered": numbered || undefined, children: numbered
+                ? lines.map((line, i) => (_jsxs("span", { className: "rl-agent-file__line", children: [_jsx("span", { className: "rl-agent-file__ln", "aria-hidden": "true", children: i + 1 }), _jsx("span", { className: "rl-agent-file__text", children: line }), '\n'] }, i)))
+                : text }) }));
+}
+/**
+ * Image with a zoom group. Percentages are of the natural width (known after load); before the
+ * image has loaded, or when the browser reports no natural size, they fall back to a share of the
+ * preview width. `fit` scales the image down to the preview width, never up.
+ */
+function ImagePreview({ file, levels, defaultZoom = 'fit', m }) {
+    const options = React.useMemo(() => {
+        const list = (levels && levels.length > 0 ? levels : DEFAULT_ZOOMS).filter((z) => Number.isFinite(z) && z > 0);
+        return [...new Set(list)].sort((a, b) => a - b);
+    }, [levels]);
+    const [zoom, setZoom] = React.useState(defaultZoom);
+    const [natural, setNatural] = React.useState(undefined);
+    const style = zoom === 'fit'
+        ? {}
+        : natural
+            ? { width: `${(natural * zoom) / 100}px` }
+            : { '--rl-agent-file-zoom': zoom / 100 };
+    return (_jsxs("div", { className: "rl-agent-file__image", children: [_jsxs("div", { className: "rl-agent-file__zoom", role: "group", "aria-label": m.fileZoom, children: [_jsx("button", { type: "button", className: "rl-agent-file__zoom-option", "aria-pressed": zoom === 'fit', onClick: () => setZoom('fit'), children: m.fileZoomFit }), options.map((z) => (_jsxs("button", { type: "button", className: "rl-agent-file__zoom-option", "aria-pressed": zoom === z, onClick: () => setZoom(z), children: [z, "%"] }, z)))] }), _jsx("div", { className: "rl-agent-file__scroll rl-agent-file__canvas", role: "region", "aria-label": m.fileContent(file.name), tabIndex: 0, children: _jsx("img", { className: "rl-agent-file__img", src: file.content, alt: file.alt ?? file.name, style: style, "data-zoom": zoom, onLoad: (event) => setNatural(event.currentTarget.naturalWidth || undefined) }) })] }));
+}
+function FileMetadata({ file, m, format }) {
+    const rows = [{ label: m.fileMeta.name, value: file.name }];
+    if (file.path)
+        rows.push({ label: m.fileMeta.path, value: file.path });
+    rows.push({ label: m.fileMeta.type, value: file.mimeType ?? m.artifactKind[file.kind === 'binary' ? 'file' : file.kind] });
+    if (file.language)
+        rows.push({ label: m.fileMeta.language, value: file.language });
+    if (file.size !== undefined)
+        rows.push({ label: m.fileMeta.size, value: format.bytes(file.size) });
+    if (file.version)
+        rows.push({ label: m.fileMeta.version, value: file.version });
+    for (const extra of file.metadata ?? [])
+        rows.push(extra);
+    return (_jsx("dl", { className: "rl-agent-file__meta", children: rows.map((row, i) => (_jsxs("div", { className: "rl-agent-file__meta-row", children: [_jsx("dt", { children: row.label }), _jsx("dd", { children: row.value })] }, `${row.label}-${i}`))) }));
+}
+//# sourceMappingURL=FilePreview.js.map