@openviking/react 0.1.0 → 0.1.2

package/dist/components/agent-connect/style.css

@@ -1,2 +1,505 @@
+.ov-agent-connect, .ov-file-browser, .ov-file-preview, .ov-file-tree, .ov-module-placeholder, .ov-scope-switcher, .ov-tooltip, .ov-tui, .ov-viking-bot, .ov-viking-bot__interaction {
+  --ov-ui-primary-default: #5252ff;
+  --ov-ui-primary-hover-default: #7075ff;
+  --ov-ui-primary-active-default: #3833d2;
+  --ov-ui-primary-light-default: #f5f7ff;
+  --ov-ui-connect-glow-warm-default: #ff952b0a;
+  --ov-ui-connect-glow-pink-default: #fb4fbc0f;
+  --ov-ui-connect-glow-pink-soft-default: #fb4fbc0a;
+  --ov-ui-on-primary-default: #fff;
+  --ov-ui-text-1-default: #0b0b0f;
+  --ov-ui-text-2-default: #3f3f51;
+  --ov-ui-text-3-default: #6e718c;
+  --ov-ui-text-description-default: #0006;
+  --ov-ui-text-disabled-default: #a5a7bb;
+  --ov-ui-border-1-default: #f0f2fa;
+  --ov-ui-border-2-default: #e1e4f2;
+  --ov-ui-border-3-default: #d7daea;
+  --ov-ui-bg-1-default: #fff;
+  --ov-ui-bg-3-default: #f7f8fd;
+  --ov-ui-bg-4-default: #f6f7fa;
+  --ov-ui-bg-5-default: #f1f2f9;
+  --ov-ui-status-success-default: #1f9d55;
+  --ov-ui-shadow-default: #0f172a;
+  --ov-ui-focus-default: #5252ff;
+  --ov-ui-fill-hover-default: #f1f2f9;
+  --ov-ui-status-error-default: #c43838;
+  --ov-ui-warning-default: #b26a00;
+  --ov-ui-warning-light-default: #fff0b3;
+  --ov-ui-tooltip-bg-default: #1f2329;
+  --ov-ui-tooltip-text-default: #fff;
+}
+
+.dark .ov-agent-connect, .dark .ov-file-browser, .dark .ov-file-preview, .dark .ov-file-tree, .dark .ov-module-placeholder, .dark .ov-scope-switcher, .dark .ov-tooltip, .dark .ov-tui, .dark .ov-viking-bot, .dark .ov-viking-bot__interaction {
+  --ov-ui-primary-default: #5f5fff;
+  --ov-ui-primary-hover-default: #7075ff;
+  --ov-ui-primary-active-default: #4242ba;
+  --ov-ui-primary-light-default: #1a1632;
+  --ov-ui-connect-glow-warm-default: #ff952b05;
+  --ov-ui-connect-glow-pink-default: #fb4fbc08;
+  --ov-ui-connect-glow-pink-soft-default: #fb4fbc05;
+  --ov-ui-text-1-default: #c7ccd6;
+  --ov-ui-text-2-default: #9da3af;
+  --ov-ui-text-3-default: #737a87;
+  --ov-ui-text-description-default: #fff6;
+  --ov-ui-text-disabled-default: #42464e;
+  --ov-ui-border-1-default: #23252a;
+  --ov-ui-border-2-default: #2e3138;
+  --ov-ui-border-3-default: #3a3d45;
+  --ov-ui-bg-1-default: #131416;
+  --ov-ui-bg-3-default: #1b1d21;
+  --ov-ui-bg-4-default: #202227;
+  --ov-ui-bg-5-default: #23252a;
+  --ov-ui-focus-default: #5f5fff;
+  --ov-ui-fill-hover-default: #23252a;
+  --ov-ui-status-error-default: #ff9595;
+  --ov-ui-warning-default: #e0a04a;
+  --ov-ui-warning-light-default: #3a2f14;
+  --ov-ui-tooltip-bg-default: #2a2d33;
+  --ov-ui-tooltip-text-default: #f0f1f3;
+}
+
+.ov-agent-connect {
+  --ov-ui-connect-card-default: #fbfbfc;
+  --ov-ui-connect-tabs-default: #f7f7f9;
+  --ov-ui-connect-selected-default: #f3f4f7;
+  --ov-ui-connect-border-default: #edeef2;
+  --ov-ui-connect-outline-default: #e1e3ea;
+  --ov-ui-connect-muted-default: #787c91;
+  --ov-ui-connect-notice-default: #2e2984;
+}
+
+.dark .ov-agent-connect {
+  --ov-ui-connect-card-default: var(--ov-ui-bg-3-default);
+  --ov-ui-connect-tabs-default: var(--ov-ui-bg-3-default);
+  --ov-ui-connect-selected-default: var(--ov-ui-bg-4-default);
+  --ov-ui-connect-border-default: var(--ov-ui-border-1-default);
+  --ov-ui-connect-outline-default: var(--ov-ui-border-2-default);
+  --ov-ui-connect-muted-default: var(--ov-ui-text-3-default);
+  --ov-ui-connect-notice-default: var(--ov-ui-text-2-default);
+}
+
+.ov-agent-connect {
+  --ov-ui-agent-connect-text: var(--ov-ui-color-text-1, var(--ov-ui-text-1-default));
+  --ov-ui-agent-connect-secondary: var(--ov-ui-color-text-2, var(--ov-ui-text-2-default));
+  --ov-ui-agent-connect-muted: var(--ov-ui-color-connect-muted, var(--ov-ui-connect-muted-default));
+  --ov-ui-agent-connect-bg: var(--ov-ui-color-bg-1, var(--ov-ui-bg-1-default));
+  --ov-ui-agent-connect-card: var(--ov-ui-color-connect-card, var(--ov-ui-connect-card-default));
+  --ov-ui-agent-connect-tabs: var(--ov-ui-color-connect-tabs, var(--ov-ui-connect-tabs-default));
+  --ov-ui-agent-connect-selected: var(--ov-ui-color-connect-selected, var(--ov-ui-connect-selected-default));
+  --ov-ui-agent-connect-border: var(--ov-ui-color-connect-border, var(--ov-ui-connect-border-default));
+  --ov-ui-agent-connect-primary: var(--ov-ui-color-primary, var(--ov-ui-primary-default));
+  box-sizing: border-box;
+  background: var(--ov-ui-agent-connect-bg);
+  width: 1000px;
+  max-width: 100%;
+  color: var(--ov-ui-agent-connect-text);
+  letter-spacing: .003em;
+  -webkit-font-smoothing: antialiased;
+  font-family: PingFang SC, -apple-system, BlinkMacSystemFont, Segoe UI, sans-serif;
+  font-size: 14px;
+  line-height: 22px;
+  overflow-x: auto;
+}
+
+.ov-agent-connect__canvas {
+  isolation: isolate;
+  width: 1000px;
+  min-height: 949px;
+  box-shadow: inset 0 0 0 .5px
+    var(--ov-ui-color-connect-outline, var(--ov-ui-connect-outline-default));
+  position: relative;
+  overflow: hidden;
+}
+
+.ov-agent-connect__canvas:before {
+  z-index: -1;
+  background: radial-gradient(ellipse 466.5px 159.5px at 379.5px -6.5px,
+      var(--ov-ui-color-connect-glow-warm, var(--ov-ui-connect-glow-warm-default)),
+      transparent),
+    radial-gradient(ellipse 286.5px 159.5px at 725.5px 4.5px,
+      var(--ov-ui-color-connect-glow-pink, var(--ov-ui-connect-glow-pink-default)),
+      transparent),
+    radial-gradient(ellipse 230.5px 212px at -63.5px 869px,
+      var(--ov-ui-color-connect-glow-warm, var(--ov-ui-connect-glow-warm-default)),
+      transparent),
+    radial-gradient(ellipse 173.5px 159.5px at 236.5px 947.5px,
+      var(--ov-ui-color-connect-glow-pink-soft, var(--ov-ui-connect-glow-pink-soft-default)),
+      transparent);
+  content: "";
+  pointer-events: none;
+  position: absolute;
+  inset: 0;
+}
+
+.ov-agent-connect *, .ov-agent-connect :before, .ov-agent-connect :after {
+  box-sizing: border-box;
+}
+
+.ov-agent-connect :where(button) {
+  font: inherit;
+  cursor: pointer;
+}
+
+.ov-agent-connect button:focus-visible, .ov-agent-connect a:focus-visible {
+  outline: 2px solid var(--ov-ui-color-focus, var(--ov-ui-focus-default));
+  outline-offset: 2px;
+}
+
+.ov-agent-connect__header {
+  flex-direction: column;
+  align-items: center;
+  gap: 20px;
+  padding: 24px 0;
+  display: flex;
+}
+
+.ov-agent-connect__title {
+  color: inherit;
+  margin: 0;
+  font-size: 24px;
+  font-weight: 600;
+  line-height: 32px;
+}
+
+.ov-agent-connect__tabs {
+  background: var(--ov-ui-agent-connect-tabs);
+  border-radius: 34px;
+  height: 36px;
+  padding: 2px;
+  display: flex;
+}
+
+.ov-agent-connect__tab {
+  color: var(--ov-ui-agent-connect-secondary);
+  white-space: nowrap;
+  background: none;
+  border: 1px solid #0000;
+  border-radius: 35px;
+  justify-content: center;
+  align-items: center;
+  padding: 4px 16px;
+  display: flex;
+}
+
+.ov-agent-connect__tab[aria-selected="true"] {
+  border-color: var(--ov-ui-agent-connect-border);
+  background: var(--ov-ui-agent-connect-bg);
+  color: var(--ov-ui-agent-connect-text);
+  font-weight: 500;
+}
+
+.ov-agent-connect__layout {
+  grid-template-columns: 200px minmax(0, 1fr);
+  gap: 40px;
+  padding: 0 60px 24px 40px;
+  display: grid;
+}
+
+.ov-agent-connect__list {
+  flex-direction: column;
+  gap: 4px;
+  min-width: 0;
+  margin: 0;
+  padding: 24px 0;
+  list-style: none;
+  display: flex;
+}
+
+.ov-agent-connect__item {
+  width: 100%;
+  height: 36px;
+  color: var(--ov-ui-agent-connect-secondary);
+  text-align: left;
+  background: none;
+  border: 0;
+  border-radius: 6px;
+  align-items: center;
+  gap: 8px;
+  padding: 7px 12px;
+  display: flex;
+}
+
+.ov-agent-connect__item:hover {
+  background: var(--ov-ui-agent-connect-tabs);
+}
+
+.ov-agent-connect__item[aria-pressed="true"] {
+  background: var(--ov-ui-agent-connect-selected);
+  color: var(--ov-ui-agent-connect-text);
+  font-weight: 500;
+}
+
+.ov-agent-connect__item-icon {
+  flex: 0 0 20px;
+  width: 20px;
+  height: 20px;
+}
+
+.ov-agent-connect__item-name {
+  white-space: nowrap;
+}
+
+.ov-agent-connect__detail {
+  flex-direction: column;
+  gap: 24px;
+  min-width: 0;
+  padding-top: 24px;
+  display: flex;
+}
+
+.ov-agent-connect__identity {
+  align-items: flex-start;
+  gap: 12px;
+  display: flex;
+}
+
+.ov-agent-connect__detail-icon {
+  flex: 0 0 56px;
+  justify-content: center;
+  align-items: center;
+  width: 56px;
+  height: 56px;
+  display: flex;
+}
+
+.ov-agent-connect__detail-icon--frame {
+  border: 1px solid var(--ov-ui-agent-connect-border);
+  border-radius: 12px;
+}
+
+.ov-agent-connect__detail-icon--frame > svg {
+  width: 48px;
+  height: 48px;
+}
+
+.ov-agent-connect__summary {
+  flex-direction: column;
+  gap: 4px;
+  min-width: 0;
+  display: flex;
+}
+
+.ov-agent-connect__detail-title {
+  color: inherit;
+  margin: 0;
+  font-size: 18px;
+  font-weight: 500;
+  line-height: 26px;
+}
+
+.ov-agent-connect__description {
+  min-height: 40px;
+  color: var(--ov-ui-agent-connect-muted);
+  margin: 0;
+  font-size: 12px;
+  line-height: 20px;
+}
+
+.ov-agent-connect__tags {
+  gap: 8px;
+  margin-top: 4px;
+  display: flex;
+}
+
+.ov-agent-connect__tag {
+  background: var(--ov-ui-agent-connect-selected);
+  color: var(--ov-ui-agent-connect-secondary);
+  border-radius: 4px;
+  padding: 0 6px;
+  font-size: 12px;
+  line-height: 20px;
+}
+
+.ov-agent-connect__instructions {
+  flex-direction: column;
+  gap: 12px;
+  display: flex;
+}
+
+.ov-agent-connect__instructions-header {
+  justify-content: space-between;
+  align-items: center;
+  height: 34px;
+  display: flex;
+}
+
+.ov-agent-connect__instructions-title {
+  color: inherit;
+  margin: 0;
+  font-size: 14px;
+  font-weight: 500;
+  line-height: 22px;
+}
+
+.ov-agent-connect__copy {
+  background: var(--ov-ui-agent-connect-primary);
+  height: 34px;
+  color: var(--ov-ui-color-on-primary, var(--ov-ui-on-primary-default));
+  border: 0;
+  border-radius: 8px;
+  justify-content: center;
+  align-items: center;
+  gap: 6px;
+  padding: 5px 16px;
+  font-size: 13px;
+  line-height: 22px;
+  display: inline-flex;
+}
+
+.ov-agent-connect__copy svg {
+  flex: 0 0 16px;
+  width: 16px;
+  height: 16px;
+}
+
+.ov-agent-connect__copy:hover {
+  background: var(--ov-ui-color-primary-hover, var(--ov-ui-primary-hover-default));
+}
+
+.ov-agent-connect__copy:active {
+  background: var(--ov-ui-color-primary-active, var(--ov-ui-primary-active-default));
+}
+
+.ov-agent-connect__copy:disabled {
+  opacity: .6;
+  cursor: wait;
+}
+
+.ov-agent-connect__body {
+  box-shadow: inset 0 0 0 1px var(--ov-ui-agent-connect-border);
+  background: var(--ov-ui-agent-connect-card);
+  color: var(--ov-ui-agent-connect-secondary);
+  overflow-wrap: anywhere;
+  white-space: pre-wrap;
+  border-radius: 12px;
+  padding: 12px 16px;
+  font-size: 13px;
+  line-height: 22px;
+}
+
+.ov-agent-connect__feedback {
+  color: var(--ov-ui-agent-connect-muted);
+  font-size: 12px;
+}
+
+.ov-agent-connect__feedback:empty {
+  display: none;
+}
+
+.ov-agent-connect__feedback--error {
+  color: var(--ov-ui-color-status-error, var(--ov-ui-status-error-default));
+}
+
+.ov-agent-connect__footer {
+  color: var(--ov-ui-agent-connect-muted);
+  margin: 0;
+  font-size: 12px;
+  line-height: 20px;
+}
+
+.ov-agent-connect__agreement {
+  color: inherit;
+  text-decoration: underline dotted;
+  text-decoration-color: var(--ov-ui-color-connect-notice, var(--ov-ui-connect-notice-default));
+  text-underline-offset: 3px;
+}
+
+.ov-agent-connect__markdown {
+  white-space: normal;
+}
+
+.ov-agent-connect__markdown :where(p, pre, h5, table) {
+  margin: 0 0 12px;
+}
+
+.ov-agent-connect__markdown > :last-child {
+  margin-bottom: 0;
+}
+
+.ov-agent-connect__markdown p {
+  white-space: pre-wrap;
+}
+
+.ov-agent-connect__markdown h5 {
+  color: var(--ov-ui-agent-connect-text);
+  font-size: 14px;
+  line-height: 22px;
+}
+
+.ov-agent-connect__markdown pre {
+  background: var(--ov-ui-agent-connect-bg);
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  border-radius: 6px;
+  padding: 12px;
+  font-size: 12px;
+  line-height: 20px;
+}
+
+.ov-agent-connect__markdown code {
+  font-family: ui-monospace, SFMono-Regular, Consolas, monospace;
+}
+
+.ov-agent-connect__markdown a {
+  color: var(--ov-ui-agent-connect-primary);
+  overflow-wrap: anywhere;
+}
+
+.ov-agent-connect__markdown table {
+  border-collapse: collapse;
+  width: 100%;
+}
+
+.ov-agent-connect__markdown :where(td, th) {
+  border: 1px solid var(--ov-ui-agent-connect-border);
+  text-align: left;
+  padding: 6px;
+}
+
+.ov-agent-connect__guides {
+  gap: 8px;
+  display: flex;
+}
+
+.ov-agent-connect__guide {
+  border: 1px solid var(--ov-ui-agent-connect-border);
+  background: var(--ov-ui-agent-connect-bg);
+  color: var(--ov-ui-agent-connect-secondary);
+  border-radius: 6px;
+  padding: 4px 12px;
+}
+
+.ov-agent-connect__guide[aria-pressed="true"] {
+  background: var(--ov-ui-agent-connect-selected);
+  color: var(--ov-ui-agent-connect-text);
+  font-weight: 500;
+}
+
+.ov-agent-connect__guides--cli {
+  border-bottom: 1px solid var(--ov-ui-agent-connect-border);
+  gap: 0;
+}
+
+.ov-agent-connect__guides--cli .ov-agent-connect__guide {
+  color: var(--ov-ui-agent-connect-muted);
+  background: none;
+  border: 0;
+  border-bottom: 2px solid #0000;
+  border-radius: 0;
+  margin-bottom: -1px;
+  margin-right: 24px;
+  padding: 0 4px 12px;
+  font-size: 14px;
+  font-weight: 400;
+  transition: color .15s, border-color .15s;
+}
+
+.ov-agent-connect__guides--cli .ov-agent-connect__guide[aria-pressed="true"] {
+  border-bottom-color: var(--ov-ui-agent-connect-primary);
+  color: var(--ov-ui-agent-connect-text);
+  font-weight: 600;
+}
+
 
 

package/dist/components/agent-connect/types.d.ts

@@ -0,0 +1,29 @@
+import type { HTMLAttributes } from 'react';
+export type AgentConnectLocale = 'zh' | 'en';
+export type AgentConnectTabId = 'mainstream' | 'custom';
+/** 固定目录中选中的 Agent。Selected agent from the built-in catalog. */
+export interface AgentConnectItem {
+    id: string;
+    name: string;
+}
+/** 固定设计视图；文案、图标与正文均内置。Fixed view with built-in copy and icons. */
+export interface AgentConnectProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onSelect' | 'onCopy'> {
+    /** 调用方提供的密钥；展示脱敏，复制保留原值。Host API key. */
+    apiKey: string;
+    /** 内置文案语言；必须由调用方指定。Required content locale. */
+    locale: AgentConnectLocale;
+    /** 服务地址，默认 OpenViking 云服务。Optional service endpoint. */
+    baseUrl?: string;
+    /** 宿主提供的用户协议链接；未传时不显示协议引用。Host agreement URL. */
+    agreementUrl?: string;
+    /** 受控页签；默认 mainstream。Controlled tab; defaults to mainstream. */
+    activeTabId?: AgentConnectTabId;
+    /** 受控 Agent；默认 codex。Controlled agent; defaults to codex. */
+    selectedId?: string;
+    /** 页签切换通知。Tab selection notification. */
+    onTabChange?: (tabId: AgentConnectTabId) => void;
+    /** 返回内置目录条目的 id 和 name。Reports the built-in item id and name. */
+    onSelect?: (item: AgentConnectItem) => void;
+    /** 复制成功后通知；不负责写入剪贴板。Success notification, not clipboard writing. */
+    onCopy?: (text: string) => void;
+}

package/dist/components/agent-connect.js

@@ -0,0 +1 @@
+export { AgentConnect } from "../u~0.js";

package/dist/components/file-preview/file-preview-adapters.d.ts

@@ -0,0 +1,33 @@
+import type { MarkdownAdapterOptions } from '@ark-design/ui/file-viewer/adapters/markdown';
+import type { FileViewerCoreProps } from '@ark-design/ui/file-viewer/core';
+/**
+ * 组件内置的格式集合：文本、文档、图片与音视频。
+ *
+ * 图片是内容式 Adapter，音视频是引用式 Adapter；底座会按 Adapter 声明的读取
+ * 方式自动转换 `source`，宿主只需给出内容、文件或链接，不用区分。
+ *
+ * CAD 与 3D 需要额外的引擎与伴随资源，不放进公共组件。
+ *
+ * 本模块会静态引入底座，因此只能被懒加载的正文模块引用，不能进入包的顶层
+ * 导入链——底座会静态引入浏览器专用组件，顶层导入会破坏服务端渲染。
+ *
+ * The formats the component ships: text, documents, images and media. The image
+ * adapter reads content while the media adapter reads a reference; the base
+ * converts `source` according to the adapter's declared mode, so the host only
+ * supplies content, a file or a URL. CAD and 3D need extra engines and companion
+ * resources, so they stay out of the shared component. This module statically
+ * imports the base, so only the lazily loaded body may reference it: the base
+ * pulls in browser-only packages, and a top-level import would break server
+ * rendering.
+ */
+export declare function createFilePreviewAdapterList({ onLinkClick, }?: {
+    /**
+     * Markdown 正文里的链接被点击时调用。传入后由回调接管导航，底座不再自行
+     * 跳转；只有 Markdown Adapter 支持这个回调，其余格式忽略它。
+     *
+     * Called when a link inside a Markdown body is clicked. Supplying it hands
+     * navigation to the callback and the base no longer jumps on its own. Only the
+     * Markdown adapter supports this; other formats ignore it.
+     */
+    onLinkClick?: MarkdownAdapterOptions['onLinkClick'];
+}): FileViewerCoreProps['adapters'];

package/dist/components/file-preview/file-preview-body.d.ts

@@ -0,0 +1,27 @@
+import type { ViewerHandle, ViewerViewModeOption } from '@ark-design/ui/file-viewer/core';
+import type { MarkdownAdapterOptions } from '@ark-design/ui/file-viewer/adapters/markdown';
+import type { useFilePreviewEditing } from './use-file-preview-editing.js';
+import type { FilePreviewFileTab, FilePreviewLabels, FilePreviewViewMode } from './types.js';
+export interface FilePreviewBodyProps {
+    fileTab: FilePreviewFileTab;
+    text: Required<FilePreviewLabels>;
+    locale?: 'en-US' | 'zh-CN';
+    viewMode: FilePreviewViewMode;
+    editing: ReturnType<typeof useFilePreviewEditing>;
+    onViewModeChange: (mode: FilePreviewViewMode) => void;
+    onHandleChange: (handle: ViewerHandle | null) => void;
+    onViewModesChange: (modes: readonly ViewerViewModeOption[]) => void;
+    onDownload: () => void;
+    /** Markdown 正文里的链接被点击时调用。 */
+    onLinkClick?: MarkdownAdapterOptions['onLinkClick'];
+    /** 读取失败后退出编辑态。Leaves editing after a failed load. */
+    onCancelEditing: () => void;
+}
+/**
+ * 文件页签的正文：按编辑态、空文件、底座依次短路。内容页签不走这里——它的
+ * 正文整块由宿主渲染。
+ *
+ * The body of a file tab: it short-circuits through editing, empty file and then
+ * the base component. A content tab never reaches this — its body is the host's.
+ */
+export declare function FilePreviewBody({ fileTab, text, locale, viewMode, editing, onViewModeChange, onHandleChange, onViewModesChange, onDownload, onLinkClick, onCancelEditing, }: FilePreviewBodyProps): import("react").JSX.Element;

package/dist/components/file-preview/file-preview-breadcrumb-menu.d.ts

@@ -0,0 +1,16 @@
+import type { PathSegment } from './file-preview-path.js';
+export interface FilePreviewBreadcrumbMenuProps {
+    segments: readonly PathSegment[];
+    canOpen: boolean;
+    disabled: boolean;
+    onOpen: (uri: string) => void;
+}
+/**
+ * 折叠层级的菜单。用 Tooltip 的 `click` 形态承载：点击「…」展开，按 Esc 或
+ * 点外部关闭，浮层渲染到 body，因此不受面包屑容器的布局约束。
+ *
+ * The menu of collapsed levels, carried by Tooltip's `click` shape: clicking "…"
+ * opens it, Escape or a press outside closes it, and because the surface renders
+ * into `body` the breadcrumb's own layout cannot clip it.
+ */
+export declare function FilePreviewBreadcrumbMenu({ segments, canOpen, disabled, onOpen, }: FilePreviewBreadcrumbMenuProps): import("react").JSX.Element;

package/dist/components/file-preview/file-preview-breadcrumb.d.ts

@@ -0,0 +1,21 @@
+import type { PathSegment } from './file-preview-path.js';
+export interface FilePreviewBreadcrumbProps {
+    segments: readonly PathSegment[];
+    title: string;
+    canOpen: boolean;
+    disabled: boolean;
+    onOpen: (uri: string) => void;
+}
+/**
+ * 路径面包屑：祖先逐段可点，放不下时按「保两端、缩中间」折叠。
+ *
+ * 折叠顺序与内部版一致：先保留首段与末段，从紧邻首段的那一级开始逐级收进
+ * 「…」；中间全部收起后仍放不下，才连首段一起收起，只留末段。
+ *
+ * Path breadcrumb: every ancestor is clickable, and overflow collapses by keeping
+ * both ends and shrinking the middle. The first level and the trailing name stay
+ * as long as possible; ancestors are folded into a "…" menu starting next to the
+ * first level, and only when even that does not fit is the first level dropped
+ * too, leaving the trailing name alone.
+ */
+export declare function FilePreviewBreadcrumb({ segments, title, canOpen, disabled, onOpen, }: FilePreviewBreadcrumbProps): import("react").JSX.Element;

package/dist/components/file-preview/file-preview-copy-path.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 路径旁的复制按钮。有 `source.path` 的文件在任何宿主下都需要它，因此内置在
+ * 外壳里，而不是交给宿主渲染。
+ *
+ * The copy-path button beside the path. Any file with a `source.path` needs it
+ * under every host, so it lives in the shell rather than being left to the host.
+ */
+export declare function FilePreviewCopyPath({ label, disabled, onClick, }: {
+    label: string;
+    disabled: boolean;
+    onClick: () => void;
+}): import("react").JSX.Element;

package/dist/components/file-preview/file-preview-editor.d.ts

@@ -0,0 +1,22 @@
+import type { FilePreviewLabels } from './types.js';
+export interface FilePreviewEditorProps {
+    draft: string;
+    text: Required<FilePreviewLabels>;
+    loading: boolean;
+    failed: boolean;
+    saveFailed: boolean;
+    saving: boolean;
+    onChange: (value: string) => void;
+    onCancel: () => void;
+}
+/**
+ * 编辑态正文：纯文本编辑区，不经过底座。
+ *
+ * 编辑区独立于 `FileViewerCore`，因此进入编辑不会重建渲染器，退出编辑也
+ * 不会重新解析内容。
+ *
+ * The editing body: a plain-text area that bypasses the base component. Keeping
+ * it separate means entering or leaving editing never remounts the renderer nor
+ * reparses the content.
+ */
+export declare function FilePreviewEditor({ draft, text, loading, failed, saveFailed, saving, onChange, onCancel, }: FilePreviewEditorProps): import("react").JSX.Element;