@openviking/react 0.1.3 → 0.1.5

package/dist/components/file-browser-entries/types.d.ts

@@ -1,45 +1,63 @@
-import type { HTMLAttributes } from 'react';
+import type { Locale } from '../../shared/locale.js';
+import type { ComponentPropsWithRef, HTMLAttributes, ReactElement, ReactNode } from 'react';
+import type { AgentConnectProps } from '../agent-connect/index.js';
 /**
- * 文件浏览入口条的文案。两项的文案都可替换，缺省为英文。
- * Copy of the file browser entry row. Both labels are replaceable, English by
- * default.
+ * 文件浏览入口条与抽屉的文案。未覆盖项跟随 locale。
+ * Copy of the file browser entries and drawer. Omitted fields follow locale.
  */
 export interface FileBrowserEntriesLabels {
     /** 连接 Agent 的文案。Label of the connect-agent entry. */
     connectAgent?: string;
     /** 导入资源的文案。Label of the import-resources entry. */
     importResources?: string;
+    /** 右侧接入抽屉的关闭文案。Close label of the connection drawer. */
+    close?: string;
 }
 /**
  * 文件浏览入口条的属性。
  *
- * 它固定是两个入口：连接 Agent 与导入资源。宿主只决定显示哪几个、点击后做
- * 什么，图标、文案、等分排布与两者之间的分隔线都由组件负责——这两项在每个
- * 宿主下外观都相同，差别只在点击行为。
+ * 固定两个入口：连接 Agent 与导入资源。agentConnect 可启用内置右侧接入抽屉，
+ * 也可仅通过回调接入宿主流程。宿主可包装或替换默认导入按钮。
+ * 图标、文案、等分排布与分隔线由组件负责。
  *
  * 只显示一个入口时不画分隔线：线分隔的是两个相邻项，只剩一个就无从分隔。
  *
  * Props of the file browser entry row.
  *
- * It is fixed to two entries: connect an agent, import resources. The host only
- * decides which appear and what a click does; the icons, copy, equal-width layout
- * and the divider between them belong to the component, because both look the same
- * under every host and differ only in behaviour.
+ * Two fixed entries: connect an agent and import resources. agentConnect enables
+ * the built-in connection drawer; callbacks also support host-owned flows.
+ * Hosts can wrap or replace the default import button. The component owns the
+ * icons, copy, equal-width layout and divider.
  *
  * With a single entry no divider is drawn: a divider separates two neighbours, and
  * there is nothing left to separate.
  */
 export interface FileBrowserEntriesProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** 可选文案语言；继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+    locale?: Locale;
     /**
-     * 连接 Agent 成功后触发。省略时不显示该入口。
-     * Called after the connect-agent entry is clicked. Omit it to hide that entry.
+     * 内置 AgentConnect 右侧抽屉的参数；传入后显示连接入口。
+     * Options for the built-in AgentConnect drawer; enables the connect entry.
+     */
+    agentConnect?: AgentConnectProps;
+    /**
+     * 点击连接入口时通知；未传 agentConnect 时由宿主处理接入。
+     * Click notification; the host owns connection when agentConnect is omitted.
      */
     onConnectAgent?: () => void;
     /**
-     * 导入资源成功后触发。省略时不显示该入口。
-     * Called after the import-resources entry is clicked. Omit it to hide that entry.
+     * 默认导入按钮被点击时触发；未提供导入回调和渲染插槽时隐藏入口。
+     * Called when the default import button is clicked; omit both import props to hide it.
      */
     onImportResources?: () => void;
-    /** 可替换文案，缺省为英文。Replaceable copy; English by default. */
+    /**
+     * 自定义导入入口；参数是带有图标、文案和点击回调的默认原生按钮。
+     * 传入后显示入口，返回 null 时隐藏；不传时按 onImportResources 渲染默认按钮。
+     * Renders the import entry using its default native button, including icon, label
+     * and click handler. Enables the entry; return null to hide it. When omitted,
+     * onImportResources enables the default button.
+     */
+    renderImportResources?: (trigger: ReactElement<ComponentPropsWithRef<'button'>>) => ReactNode;
+    /** 可替换文案，未提供的项使用当前 locale 的内置文案。Replaceable copy; omitted fields follow locale. */
     labels?: FileBrowserEntriesLabels;
 }

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

@@ -20,7 +20,7 @@ import type { FileViewerCoreProps } from '@ark-design/ui/file-viewer/core';
  * pulls in browser-only packages, and a top-level import would break server
  * rendering.
  */
-export declare function createFilePreviewAdapterList({ onLinkClick, }?: {
+export declare function createFilePreviewAdapterList({ onLinkClick, resolveImage, }?: {
     /**
      * Markdown 正文里的链接被点击时调用。传入后由回调接管导航，底座不再自行
      * 跳转；只有 Markdown Adapter 支持这个回调，其余格式忽略它。
@@ -30,4 +30,5 @@ export declare function createFilePreviewAdapterList({ onLinkClick, }?: {
      * Markdown adapter supports this; other formats ignore it.
      */
     onLinkClick?: MarkdownAdapterOptions['onLinkClick'];
+    resolveImage?: (src: string) => Promise<string>;
 }): FileViewerCoreProps['adapters'];

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

@@ -1,3 +1,4 @@
+import type { Locale } from '../../shared/locale.js';
 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';
@@ -5,7 +6,7 @@ import type { FilePreviewFileTab, FilePreviewLabels, FilePreviewViewMode } from
 export interface FilePreviewBodyProps {
     fileTab: FilePreviewFileTab;
     text: Required<FilePreviewLabels>;
-    locale?: 'en-US' | 'zh-CN';
+    locale?: Locale;
     viewMode: FilePreviewViewMode;
     editing: ReturnType<typeof useFilePreviewEditing>;
     onViewModeChange: (mode: FilePreviewViewMode) => void;

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

@@ -1,5 +1,6 @@
 import type { PathSegment } from './file-preview-path.js';
 export interface FilePreviewBreadcrumbMenuProps {
+    hiddenPathLabel: string;
     segments: readonly PathSegment[];
     canOpen: boolean;
     disabled: boolean;
@@ -13,4 +14,4 @@ export interface FilePreviewBreadcrumbMenuProps {
  * 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;
+export declare function FilePreviewBreadcrumbMenu({ hiddenPathLabel, segments, canOpen, disabled, onOpen, }: FilePreviewBreadcrumbMenuProps): import("react").JSX.Element;

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

@@ -1,5 +1,6 @@
 import type { PathSegment } from './file-preview-path.js';
 export interface FilePreviewBreadcrumbProps {
+    hiddenPathLabel: string;
     segments: readonly PathSegment[];
     title: string;
     canOpen: boolean;
@@ -18,4 +19,4 @@ export interface FilePreviewBreadcrumbProps {
  * 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;
+export declare function FilePreviewBreadcrumb({ hiddenPathLabel, segments, title, canOpen, disabled, onOpen, }: FilePreviewBreadcrumbProps): import("react").JSX.Element;

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

@@ -1,3 +1,4 @@
+import type { Locale } from '../../shared/locale.js';
 import type { ViewerHandle, ViewerViewModeOption } from '@ark-design/ui/file-viewer/core';
 import type { FilePreviewActions } from './types.js';
 import type { useFilePreviewEditing } from './use-file-preview-editing.js';
@@ -19,7 +20,7 @@ import type { FilePreviewDirectoryTab, FilePreviewLabels, FilePreviewViewMode }
 export interface FilePreviewDirectoryBodyProps {
     tab: FilePreviewDirectoryTab;
     text: Required<FilePreviewLabels>;
-    locale?: 'en-US' | 'zh-CN';
+    locale?: Locale;
     actions: FilePreviewActions;
     editing: ReturnType<typeof useFilePreviewEditing>;
     viewMode: FilePreviewViewMode;

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

@@ -7,6 +7,7 @@ export interface FilePreviewAdapterOptions {
     onViewModesChange: (modes: readonly ViewerViewModeOption[]) => void;
     /** Markdown 正文里的链接被点击时调用；传入即由宿主接管导航。 */
     onLinkClick?: MarkdownAdapterOptions['onLinkClick'];
+    resolveImage?: (src: string) => Promise<string>;
 }
 /**
  * 给每个 Adapter 套一层：接住底座交出来的命令式句柄，并上报命中格式支持
@@ -23,4 +24,4 @@ export interface FilePreviewAdapterOptions {
  * this file supports", and the component uses it to decide whether to render the
  * preview/source switch.
  */
-export declare function createFilePreviewAdapters({ onHandleChange, onViewModesChange, onLinkClick, }: FilePreviewAdapterOptions): FileViewerCoreProps['adapters'];
+export declare function createFilePreviewAdapters({ onHandleChange, onViewModesChange, onLinkClick, resolveImage, }: FilePreviewAdapterOptions): FileViewerCoreProps['adapters'];

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

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { FilePreviewActions } from './types.js';
+import type { FilePreviewActions, FilePreviewLevel } from './types.js';
 /**
  * 标题行需要的最少信息。它按字段而不是按页签类型取值，文件页签与目录页签因此
  * 共用同一条渲染路径——两者的路径行本来就一样。
@@ -20,8 +20,12 @@ export interface FilePreviewHeaderProps {
     /** The header action area: a node, or a function of the actions context. */
     slotActions?: ReactNode | ((actions: FilePreviewActions) => ReactNode);
     actions: FilePreviewActions;
+    levels?: readonly FilePreviewLevel[];
+    levelKey?: string;
+    onLevelChange?: (key: string) => void;
     text: {
         copyPath: string;
+        showHiddenPath: string;
     };
     onOpenParent: (uri: string) => void;
 }
@@ -40,4 +44,4 @@ export interface FilePreviewHeaderProps {
  * body, download, view switch, edit) carry host product semantics and copy, and
  * the host renders them in `slots.actions` from the `actions` context.
  */
-export declare function FilePreviewHeader({ path, fileName, canOpenParent, titleExtra, slotActions, actions, text, onOpenParent, }: FilePreviewHeaderProps): import("react").JSX.Element;
+export declare function FilePreviewHeader({ levels, levelKey, onLevelChange, path, fileName, canOpenParent, titleExtra, slotActions, actions, text, onOpenParent, }: FilePreviewHeaderProps): import("react").JSX.Element;

package/dist/components/file-preview/file-preview-image-frame.d.ts

@@ -0,0 +1,5 @@
+import type { ReactNode } from 'react';
+/** Observe the renderer's native image load; no extra file request or decoding. */
+export declare function FilePreviewImageFrame({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;

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

@@ -1,16 +1,4 @@
 import type { FilePreviewLabels } from './types.js';
-/**
- * 组件内置文案，宿主可通过 `labels` 逐项覆盖。
- *
- * 只包含组件自己渲染的文案：复制路径按钮、加载与失败态、格式不支持、空文件
- * 与截断提示。其余动作按钮（复制正文、下载、预览/源码切换、编辑）由宿主在
- * `slots.actions` 里自绘，文案归宿主，这里不重复提供。
- *
- * Built-in copy, overridable field by field through `labels`.
- *
- * Only what the component renders itself: the copy-path button, loading and
- * failure states, unsupported formats, empty files and the truncation notice.
- * Every other action button (copy content, download, preview/source, edit) is
- * drawn by the host in `slots.actions` and carries its own copy.
- */
+import { type Locale } from '../../shared/locale.js';
 export declare const DEFAULT_LABELS: Required<FilePreviewLabels>;
+export declare function resolveFilePreviewLabels(locale: Locale, labels?: FilePreviewLabels): Required<FilePreviewLabels>;

package/dist/components/file-preview/file-preview-level-tabs.d.ts

@@ -0,0 +1,7 @@
+import type { FilePreviewLevel } from './types.js';
+export declare function FilePreviewLevelTabs({ levels, activeKey, disabled, onSelect, }: {
+    levels?: readonly FilePreviewLevel[];
+    activeKey?: string;
+    disabled: boolean;
+    onSelect: (key: string) => void;
+}): import("react").JSX.Element | null;

package/dist/components/file-preview/file-preview-markdown-images.d.ts

@@ -0,0 +1,13 @@
+export declare function imagePreviewTarget(url: string): string;
+export declare function originalImageTarget(url: string): string;
+type Node = {
+    type: string;
+    url?: string;
+    identifier?: string;
+    alt?: string | null;
+    title?: string | null;
+    children?: Node[];
+};
+/** Rewrite image nodes only. Fenced code and normal links remain untouched. */
+export declare function preserveVikingImages(root: Node): void;
+export {};

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

@@ -1,3 +1,4 @@
+import type { Locale } from '../../shared/locale.js';
 import type { MarkdownAdapterOptions } from '@ark-design/ui/file-viewer/adapters/markdown';
 import type { ViewerHandle, ViewerViewModeOption } from '@ark-design/ui/file-viewer/core';
 import type { HTMLAttributes } from 'react';
@@ -24,10 +25,12 @@ export interface FilePreviewPanelsProps {
     contentTab?: FilePreviewContentTab;
     directoryTab?: FilePreviewDirectoryTab;
     fileTab?: FilePreviewFileTab;
+    levelKey?: string;
+    onLevelChange: (key: string) => void;
     panelProps: HTMLAttributes<HTMLDivElement>;
     panelClass: string;
     text: Required<FilePreviewLabels>;
-    locale?: 'en-US' | 'zh-CN';
+    locale?: Locale;
     actions: ReturnType<typeof useFilePreviewActions>;
     actionContext: FilePreviewActions;
     editing: ReturnType<typeof useFilePreviewEditing>;
@@ -38,4 +41,4 @@ export interface FilePreviewPanelsProps {
     linkClickHandler?: MarkdownAdapterOptions['onLinkClick'];
     activeTab: FilePreviewTab;
 }
-export declare function FilePreviewPanels({ contentTab, directoryTab, fileTab, panelProps, panelClass, text, locale, actions, actionContext, editing, viewMode, setViewMode, onHandleChange, onViewModesChange, linkClickHandler, activeTab, }: FilePreviewPanelsProps): import("react").JSX.Element | null;
+export declare function FilePreviewPanels({ levelKey, onLevelChange, contentTab, directoryTab, fileTab, panelProps, panelClass, text, locale, actions, actionContext, editing, viewMode, setViewMode, onHandleChange, onViewModesChange, linkClickHandler, activeTab, }: FilePreviewPanelsProps): import("react").JSX.Element | null;

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

@@ -1,10 +1,11 @@
+import type { Locale } from '../../shared/locale.js';
 import type { ViewerHandle, ViewerViewModeOption } from '@ark-design/ui/file-viewer/core';
 import type { MarkdownAdapterOptions } from '@ark-design/ui/file-viewer/adapters/markdown';
 import type { FilePreviewFileTab, FilePreviewLabels, FilePreviewViewMode } from './types.js';
 export interface FilePreviewViewerProps {
     tab: FilePreviewFileTab;
     text: Required<FilePreviewLabels>;
-    locale?: 'en-US' | 'zh-CN';
+    locale?: Locale;
     viewMode: FilePreviewViewMode;
     onViewModeChange: (mode: FilePreviewViewMode) => void;
     onDownload: () => void;

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

@@ -1,6 +1,5 @@
 import type { FilePreviewComponent } from './types.js';
 export { LoadingState } from './file-preview-state.js';
-export type { FilePreviewActions, FilePreviewComponent, FilePreviewContentTab, FilePreviewDirectoryLevel, FilePreviewDirectoryTab, FilePreviewEditing, FilePreviewFileTab, FilePreviewFileTabSlots, FilePreviewHandle, FilePreviewHeaderSlots, FilePreviewLabels, FilePreviewOperations, FilePreviewProps, FilePreviewSource, FilePreviewTab, FilePreviewTabBase, FilePreviewViewMode, } from './types.js';
 /**
  * 文件预览：页签行、内容区标题行与正文组成的外壳，正文由底座按格式渲染。
  *

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

@@ -1 +1,2 @@
-export * from './file-preview.js';
+export { FilePreview, LoadingState } from './file-preview.js';
+export type * from './types.js';

package/dist/components/file-preview/locales/en-US.d.ts

@@ -0,0 +1,16 @@
+declare const messages: {
+    showHiddenPath: string;
+    copyPath: string;
+    editor: string;
+    leaveEditing: string;
+    retry: string;
+    loadFailed: string;
+    saveFailed: string;
+    unsupported: string;
+    loading: string;
+    download: string;
+    fileEmpty: string;
+    noContent: string;
+    truncated: string;
+};
+export default messages;

package/dist/components/file-preview/locales/zh-CN.d.ts

@@ -0,0 +1,16 @@
+declare const messages: {
+    showHiddenPath: string;
+    copyPath: string;
+    editor: string;
+    leaveEditing: string;
+    retry: string;
+    loadFailed: string;
+    saveFailed: string;
+    unsupported: string;
+    loading: string;
+    download: string;
+    fileEmpty: string;
+    noContent: string;
+    truncated: string;
+};
+export default messages;

package/dist/components/file-preview/style.css

@@ -1,7 +1,11 @@
-.ov-agent-connect, .ov-divider, .ov-file-browser, .ov-file-browser-entries, .ov-file-preview, .ov-file-tree, .ov-module-placeholder, .ov-popover, .ov-scope-switcher, .ov-tooltip, .ov-tui, .ov-viking-bot, .ov-viking-bot__interaction {
+.ov-directory-tour, .ov-agent-connect, .ov-console, .ov-divider, .ov-file-browser-entries, .ov-drawer, .ov-file-browser, .ov-file-preview, .ov-file-tree, .ov-module-placeholder, .ov-popover, .ov-scope-switcher, .ov-tooltip, .ov-tui, .ov-viking-bot, .ov-viking-bot__popover, .ov-viking-bot__reference-picker--mention, .ov-viking-bot__interaction {
+  --ov-ui-tour-shadow-default: 0 15px 35px #0000000d, 0 5px 15px #0000000d;
+  --ov-ui-tour-highlight-default: #5252ff14;
   --ov-ui-primary-default: #5252ff;
   --ov-ui-primary-hover-default: #7075ff;
   --ov-ui-primary-active-default: #3833d2;
+  --ov-ui-primary-disabled-default: #acb4ff;
+  --ov-ui-text-on-primary-default: #fff;
   --ov-ui-primary-light-default: #f5f7ff;
   --ov-ui-connect-glow-warm-default: #ff952b0a;
   --ov-ui-connect-glow-pink-default: #fb4fbc0f;
@@ -19,18 +23,21 @@
   --ov-ui-bg-3-default: #f7f8fd;
   --ov-ui-bg-4-default: #f6f7fa;
   --ov-ui-bg-5-default: #f1f2f9;
+  --ov-ui-code-bg-default: #fbfbfc;
   --ov-ui-status-success-default: #1f9d55;
   --ov-ui-shadow-default: #0f172a;
+  --ov-ui-shadow-control-default: #0000000d;
   --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-overlay-default: #0006;
   --ov-ui-tooltip-bg-default: #1f2329;
   --ov-ui-tooltip-text-default: #fff;
 }
 
-.dark .ov-agent-connect, .dark .ov-divider, .dark .ov-file-browser, .dark .ov-file-browser-entries, .dark .ov-file-preview, .dark .ov-file-tree, .dark .ov-module-placeholder, .dark .ov-popover, .dark .ov-scope-switcher, .dark .ov-tooltip, .dark .ov-tui, .dark .ov-viking-bot, .dark .ov-viking-bot__interaction {
+.dark .ov-directory-tour, .dark .ov-agent-connect, .dark .ov-console, .dark .ov-divider, .dark .ov-file-browser-entries, .dark .ov-drawer, .dark .ov-file-browser, .dark .ov-file-preview, .dark .ov-file-tree, .dark .ov-module-placeholder, .dark .ov-popover, .dark .ov-scope-switcher, .dark .ov-tooltip, .dark .ov-tui, .dark .ov-viking-bot, .dark .ov-viking-bot__popover, .dark .ov-viking-bot__reference-picker--mention, .dark .ov-viking-bot__interaction {
   --ov-ui-primary-default: #5f5fff;
   --ov-ui-primary-hover-default: #7075ff;
   --ov-ui-primary-active-default: #4242ba;
@@ -56,9 +63,14 @@
   --ov-ui-warning-default: #e0a04a;
   --ov-ui-warning-light-default: #3a2f14;
   --ov-ui-tooltip-bg-default: #2a2d33;
+  --ov-ui-overlay-default: #000000a3;
   --ov-ui-tooltip-text-default: #f0f1f3;
 }
 
+.dark .ov-viking-bot {
+  --ov-ui-code-bg-default: var(--ov-ui-bg-3-default);
+}
+
 .ov-agent-connect {
   --ov-ui-connect-card-default: #fbfbfc;
   --ov-ui-connect-tabs-default: #f7f7f9;
@@ -4210,5 +4222,151 @@ button.ark-agentic-file-viewer-diff__gutter {
   }
 }
 
+.ov-file-preview {
+  background: var(--ov-ui-file-preview-surface);
+  color: var(--ov-ui-file-preview-text);
+}
+
+.ov-file-preview__header {
+  border-bottom: 0;
+  padding: 8px;
+}
+
+.ov-file-preview__footer {
+  background: var(--ov-ui-color-bg-3, var(--ov-ui-bg-3-default));
+  border: 0;
+  justify-content: space-between;
+  align-items: center;
+  gap: 8px;
+  padding: 4px 8px;
+  display: flex;
+}
+
+.ov-file-preview__levels--file {
+  border-bottom: 1px solid
+    var(--ov-ui-color-border-1, var(--ov-ui-border-1-default));
+  flex: none;
+  gap: 24px;
+  min-width: 0;
+  padding: 0 16px;
+  display: flex;
+  overflow-x: auto;
+}
+
+.ov-file-preview__levels--file .ov-file-preview__level {
+  color: var(--ov-ui-file-preview-text-muted);
+  font: inherit;
+  cursor: pointer;
+  background: none;
+  border: 0;
+  flex: none;
+  padding: 8px 0;
+  position: relative;
+}
+
+.ov-file-preview__levels--file .ov-file-preview__level[aria-pressed="true"] {
+  color: var(--ov-ui-file-preview-accent);
+  font-weight: 500;
+}
+
+.ov-file-preview__levels--file .ov-file-preview__level[aria-pressed="true"]:after {
+  content: "";
+  background: currentColor;
+  width: 14px;
+  height: 2px;
+  position: absolute;
+  bottom: 0;
+  left: calc(50% - 7px);
+}
+
+.ov-file-preview__levels--file .ov-file-preview__level:disabled {
+  opacity: .5;
+  cursor: not-allowed;
+}
+
+.ov-file-preview__levels--file .ov-file-preview__level:focus-visible {
+  outline: 2px solid var(--ov-ui-file-preview-focus-ring);
+  outline-offset: -2px;
+}
+
+.ov-file-preview .ov-file-preview__viewer {
+  background: var(--ov-ui-file-preview-surface);
+  min-height: 0;
+  color: inherit;
+  border: 0;
+  border-radius: 0;
+}
+
+.ov-file-preview .ark-agentic-file-viewer-image {
+  background: var(--ov-ui-file-preview-surface);
+  min-height: 0;
+  overflow: hidden;
+}
+
+.ov-file-preview .ark-agentic-file-viewer-image__stage {
+  padding: 24px;
+  overflow: hidden;
+}
+
+.ov-file-preview .ark-agentic-file-viewer-markdown {
+  background: var(--ov-ui-file-preview-surface);
+  color: inherit;
+}
+
+.ov-file-preview .ark-agentic-file-viewer-markdown__content img {
+  object-fit: contain;
+  max-width: 100%;
+  height: auto;
+}
+
+@media (width <= 480px) {
+  .ov-file-preview__header {
+    flex-wrap: wrap;
+  }
+
+  .ov-file-preview__path-row {
+    flex-basis: 100%;
+  }
+
+  .ov-file-preview__header-actions {
+    flex-wrap: wrap;
+    max-width: 100%;
+    margin-left: auto;
+  }
+
+  .ov-file-preview .ark-agentic-file-viewer-image__stage {
+    padding: 12px;
+  }
+
+  .ov-file-preview .ark-agentic-file-viewer-markdown {
+    padding: 16px;
+  }
+
+  .ov-file-preview__footer {
+    flex-wrap: wrap;
+  }
+}
+
+.ov-file-preview__image-frame {
+  flex: auto;
+  min-width: 0;
+  min-height: 0;
+  display: flex;
+  position: relative;
+  overflow: hidden;
+}
+
+.ov-file-preview__image-size {
+  background: var(--ov-ui-file-preview-surface);
+  color: var(--ov-ui-file-preview-text-muted);
+  font-variant-numeric: tabular-nums;
+  pointer-events: none;
+  padding: 0 2px;
+  font-size: 12px;
+  position: absolute;
+  bottom: 8px;
+  right: 8px;
+}
+
 
 

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

@@ -1,3 +1,4 @@
+import type { Locale } from '../../shared/locale.js';
 import type { ConfirmSlotProps, DownloadSlotProps, FileViewerResource, ViewerHandle } from '@ark-design/ui/file-viewer/core';
 import type { ComponentType, ForwardRefExoticComponent, HTMLAttributes, PropsWithoutRef, ReactNode, RefAttributes } from 'react';
 /**
@@ -151,6 +152,15 @@ export interface FilePreviewFileTab extends FilePreviewTabBase {
      * textures of a 3D model.
      */
     resources?: readonly FileViewerResource[];
+    /** 可选的分级内容，宿主提供 L0/L1/L2 等视图与内容。 Optional host-supplied content levels. */
+    levels?: readonly FilePreviewLevel[];
+    /** 受控分级 key。 Controlled content-level key. */
+    activeLevelKey?: string;
+    /** Markdown 图片地址解析；宿主负责相对路径、鉴权与 URL 生命周期。
+     * Resolves Markdown images; the host owns relative paths, authentication and URL lifetime. */
+    resolveImage?: (src: string, source: FilePreviewSource) => Promise<string>;
+    /** 分级切换意图；受控时宿主更新 activeLevelKey。 Content-level selection intent. */
+    onLevelChange?: (key: string) => void;
     /**
      * 文件编辑配置；省略时只读。
      * File-editing options; omit them for a read-only preview.
@@ -183,6 +193,16 @@ export interface FilePreviewFileTab extends FilePreviewTabBase {
      */
     onOpenUri?: (uri: string) => void;
 }
+/** 一个资源的内容层级，使用独立 source 与资源表。 One content level with its own source and resources. */
+export interface FilePreviewLevel {
+    key: string;
+    label: ReactNode;
+    source: FilePreviewSource;
+    resources?: readonly FileViewerResource[];
+    disabled?: boolean;
+    /** 摘要默认只读；只有明确提供此能力时才可编辑。 Summaries are read-only unless explicitly editable. */
+    editing?: FilePreviewEditing;
+}
 /**
  * 展示宿主自定义内容的页签，例如看板或图谱。
  *
@@ -264,6 +284,10 @@ export interface FilePreviewDirectoryTab extends FilePreviewTabBase {
      * Initial level key when uncontrolled; the first level is selected when omitted.
      */
     defaultLevelKey?: string;
+    /** 目录摘要的伴随图片资源。 Companion images shared by directory summary levels. */
+    resources?: readonly FileViewerResource[];
+    /** 宿主解析当前摘要的 Markdown 图片。 Host resolution of Markdown images in the active summary. */
+    resolveImage?: FilePreviewFileTab['resolveImage'];
     /**
      * 当前层级变化后触发，参数为新的层级 key。
      * Called after the active level changes, with the new level key.
@@ -301,6 +325,8 @@ export interface FilePreviewDirectoryLevel {
      * to the component for format rendering.
      */
     source: FilePreviewSource;
+    /** 该级独立的伴随资源。 Companion resources specific to this level. */
+    resources?: readonly FileViewerResource[];
 }
 /**
  * 文件操作的执行能力。方法返回的 Promise 完成后才触发对应的成功通知。
@@ -495,10 +521,12 @@ export interface FilePreviewFileTabSlots extends FilePreviewHeaderSlots {
     downloadFallback?: ComponentType<DownloadSlotProps>;
 }
 /**
- * 可替换文案，组件内置英文默认值。
- * Replaceable copy; the component ships English defaults.
+ * 可替换文案，组件内置中英文文案。
+ * Replaceable copy with built-in Chinese and English defaults.
  */
 export interface FilePreviewLabels {
+    /** 展开折叠路径层级的无障碍名称。Accessible name for hidden path levels. */
+    showHiddenPath?: string;
     /**
      * 复制路径按钮的文案。这是组件自己渲染的唯一按钮——其余动作按钮由宿主在
      * `slots.actions` 里自绘，文案也归宿主。
@@ -569,6 +597,8 @@ export interface FilePreviewProps extends Omit<HTMLAttributes<HTMLDivElement>, '
      * component for format rendering or renders fully custom `content`.
      */
     tabs: readonly [FilePreviewTab, ...FilePreviewTab[]];
+    /** 可选文案语言；继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+    locale?: Locale;
     /**
      * 受控的当前页签 key。传入时由宿主决定当前页签，组件只上报切换意图。
      * The controlled active tab key. When given, the host owns the active tab and
@@ -580,20 +610,14 @@ export interface FilePreviewProps extends Omit<HTMLAttributes<HTMLDivElement>, '
      * Initial tab key when uncontrolled; the first tab is selected when omitted.
      */
     defaultActiveKey?: string;
-    /**
-     * 底座内置文案的语言。组件自身文案仍由 `labels` 控制。
-     * Language of the base component's built-in copy. The component's own copy is
-     * still controlled by `labels`.
-     */
-    locale?: 'en-US' | 'zh-CN';
     /**
      * 当前页签变化后触发，参数为新的页签 key。
      * Called after the active tab changes, with the new tab key.
      */
     onActiveKeyChange?: (key: string) => void;
     /**
-     * 所有页签的默认文案，缺省为英文。页签可以逐项覆盖。
-     * Default copy for every tab, English by default. A tab can override it field
+     * 所有页签的默认文案，跟随 locale。页签可以逐项覆盖。
+     * Default copy for every tab, following locale. A tab can override it field
      * by field.
      */
     labels?: FilePreviewLabels;

package/dist/components/file-preview/use-file-preview-levels.d.ts

@@ -0,0 +1,7 @@
+import type { FilePreviewTab } from './types.js';
+/** Level data stays with the host; only the uncontrolled selection lives here. */
+export declare function useFilePreviewLevels(selected: FilePreviewTab): {
+    tab: FilePreviewTab;
+    levelKey: string | undefined;
+    selectLevel: (key: string) => void;
+};