@openviking/react 0.1.2 → 0.1.4

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

@@ -1,7 +1,11 @@
-.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-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-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 {
+.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;
@@ -258,7 +270,6 @@
 }
 
 .ov-file-preview__header {
-  border-bottom: 1px solid var(--ov-ui-file-preview-border);
   flex: none;
   justify-content: space-between;
   align-items: center;
@@ -593,6 +604,80 @@
   font-size: 12px;
 }
 
+.ov-file-preview__levels {
+  flex: none;
+  align-items: stretch;
+  gap: 32px;
+  height: 34px;
+  padding: 0 16px;
+  display: flex;
+  position: relative;
+}
+
+.ov-file-preview__level {
+  color: var(--ov-ui-file-preview-text-muted);
+  font: inherit;
+  letter-spacing: .039px;
+  cursor: pointer;
+  background: none;
+  border: 0;
+  align-items: center;
+  padding: 0 0 2px;
+  font-size: 13px;
+  line-height: 22px;
+  transition: color .16s;
+  display: inline-flex;
+}
+
+.ov-file-preview__level:hover {
+  color: var(--ov-ui-file-preview-text);
+}
+
+.ov-file-preview__level[data-active] {
+  color: var(--ov-ui-file-preview-text);
+  font-weight: 500;
+}
+
+.ov-file-preview__level-indicator {
+  background: var(--ov-ui-file-preview-text);
+  border-radius: 1px;
+  height: 2px;
+  transition: transform .2s cubic-bezier(.2, 0, 0, 1), width .2s cubic-bezier(.2, 0, 0, 1);
+  position: absolute;
+  bottom: 0;
+  left: 0;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ov-file-preview__level-indicator {
+    transition: none;
+  }
+}
+
+.ov-file-preview__spinner {
+  box-sizing: border-box;
+  border: 2px solid var(--ov-ui-file-preview-border);
+  border-top-color: var(--ov-ui-file-preview-text-muted);
+  border-radius: 50%;
+  flex: none;
+  width: 16px;
+  height: 16px;
+  animation: .9s linear infinite ov-file-preview-spin;
+  display: inline-block;
+}
+
+@keyframes ov-file-preview-spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ov-file-preview__spinner {
+    animation-duration: 2s;
+  }
+}
+
 /*!
  * Copyright (c) 2026 Bytedance, Inc. and its affiliates.
  * SPDX-License-Identifier: MIT
@@ -4137,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';
 /**
@@ -112,7 +113,7 @@ export interface FilePreviewTabBase {
  * 文件预览页签或宿主自定义内容页签。
  * A file-preview tab or a tab with host-provided content.
  */
-export type FilePreviewTab = FilePreviewFileTab | FilePreviewContentTab;
+export type FilePreviewTab = FilePreviewFileTab | FilePreviewContentTab | FilePreviewDirectoryTab;
 /**
  * 按文件格式预览 `source` 的页签。
  * A tab that previews `source` according to its file format.
@@ -123,6 +124,18 @@ export interface FilePreviewFileTab extends FilePreviewTabBase {
      * Tab kind discriminator, always `file`.
      */
     kind: 'file';
+    /**
+     * 正文是否还在读取。为真时组件渲染加载态而不是正文，外壳（页签行、路径行）
+     * 照常显示——宿主切换文件时外壳因此不闪，只有正文区在等。
+     *
+     * `source` 在加载中可以为空；组件不会把它判成「空文件」。
+     *
+     * Whether the body is still being read. When true the component renders its
+     * loading state instead of the body while the shell — tab row, path row — stays
+     * put, so a host switching files does not flash the whole area. `source` may be
+     * empty while loading; it is not treated as an empty file.
+     */
+    loading?: boolean;
     /**
      * 要预览的内容及文件信息。
      * The content and file information to preview.
@@ -139,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.
@@ -171,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;
+}
 /**
  * 展示宿主自定义内容的页签，例如看板或图谱。
  *
@@ -203,6 +235,99 @@ export interface FilePreviewContentTab extends FilePreviewTabBase {
      */
     content: ReactNode;
 }
+/**
+ * 目录页签：一个目录的若干级摘要，例如 L0 摘要与 L1 总览。
+ *
+ * 它和文件页签的区别在于**正文的层级**：文件页签只有正文；目录页签在标题行
+ * 之下、正文之上还有一层同级视图切换（下划线页签），每一级各自是一份
+ * Markdown。这一层属于目录这种实体，不属于所有文件页签，因此单独开一类，
+ * 而不是给文件页签加一个通用插槽——那样每个文件页签都会多一个它用不到的
+ * 空位。
+ *
+ * A tab for a directory's summary levels, for example its L0 abstract and L1
+ * overview.
+ *
+ * It differs from a file tab in the layering of the body: a file tab has a body
+ * and nothing else, while a directory tab has one more level between the header
+ * and the body — an underlined switch between sibling views, each holding its own
+ * Markdown. That level belongs to the directory entity rather than to every file
+ * tab, so it gets its own kind instead of a generic slot on file tabs, which would
+ * leave every file tab with an empty space it never uses.
+ */
+export interface FilePreviewDirectoryTab extends FilePreviewTabBase {
+    /**
+     * 页签类型标记，固定为 `directory`。
+     * Tab kind discriminator, always `directory`.
+     */
+    kind: 'directory';
+    /**
+     * 摘要是否还在读取。与文件页签同义：为真时正文区显示加载态，外壳照常。
+     * Whether the summary is still being read. Same as a file tab: the body shows
+     * the loading state while the shell stays put.
+     */
+    loading?: boolean;
+    /**
+     * 可切换的摘要层级，至少一级。每级用 `source` 交给组件按格式渲染，与文件
+     * 页签的正文同一条渲染路径。
+     * The summary levels to switch between, at least one. Each level's `source` goes
+     * through the same rendering path as a file tab's body.
+     */
+    levels: readonly [FilePreviewDirectoryLevel, ...FilePreviewDirectoryLevel[]];
+    /**
+     * 受控的当前层级 key。传入时由宿主决定层级，组件只上报切换意图。
+     * The controlled active level key. When given, the host owns the level and the
+     * component only reports switch intent.
+     */
+    activeLevelKey?: string;
+    /**
+     * 非受控时的初始层级 key，省略时选中第一级。
+     * 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.
+     */
+    onActiveLevelChange?: (key: string) => void;
+    /**
+     * 目录操作的执行能力，例如沿路径向上打开。省略对应方法时该操作不可用。
+     * Directory operation capabilities, for example opening an ancestor. Omitting a
+     * method makes its operation unavailable.
+     */
+    operations?: FilePreviewOperations;
+    /**
+     * 目录页签的插槽。标题行动作与状态兜底与文件页签一致。
+     * Slots of a directory tab. Header actions and state fallbacks match a file tab.
+     */
+    slots?: FilePreviewFileTabSlots;
+}
+/**
+ * 目录的一级摘要。One summary level of a directory.
+ */
+export interface FilePreviewDirectoryLevel {
+    /**
+     * 层级唯一标识，用于切换与受控状态。
+     * Unique level key, used for switching and controlled state.
+     */
+    key: string;
+    /**
+     * 页签行显示的名称，例如「L0 摘要」。
+     * What the level switch shows, for example "L0 Summary".
+     */
+    label: ReactNode;
+    /**
+     * 该级的正文来源，与文件页签的 `source` 同形，交给组件按格式渲染。
+     * The body source of this level, the same shape as a file tab's `source`, handed
+     * to the component for format rendering.
+     */
+    source: FilePreviewSource;
+    /** 该级独立的伴随资源。 Companion resources specific to this level. */
+    resources?: readonly FileViewerResource[];
+}
 /**
  * 文件操作的执行能力。方法返回的 Promise 完成后才触发对应的成功通知。
  * File operation capabilities. The matching success notification fires only
@@ -396,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` 里自绘，文案也归宿主。
@@ -470,6 +597,8 @@ export interface FilePreviewProps extends Omit<HTMLAttributes<HTMLDivElement>, '
      * component for format rendering or renders fully custom `content`.
      */
     tabs: readonly [FilePreviewTab, ...FilePreviewTab[]];
+    /** 内置中英文文案的语言。Language of the built-in interface copy. */
+    locale: Locale;
     /**
      * 受控的当前页签 key。传入时由宿主决定当前页签，组件只上报切换意图。
      * The controlled active tab key. When given, the host owns the active tab and
@@ -481,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-directory-level.d.ts

@@ -0,0 +1,30 @@
+import type { FilePreviewDirectoryTab, FilePreviewSource } from './types.js';
+/**
+ * 目录页签当前看的是哪一级摘要。
+ *
+ * 它必须由预览外壳持有，而不是留在正文组件内部：复制正文取的是「用户正在看的
+ * 那一份」，标题行的路径也来自同一级，两处都在外壳这一层取值；留在正文里，复制
+ * 到的永远是第一级。
+ *
+ * 宿主给了 `activeLevelKey` 时以宿主的为准，这里只记非受控页签自己的选择。
+ *
+ * Which summary level of a directory tab is on screen.
+ *
+ * It belongs to the preview shell rather than inside the body component: copy-content
+ * takes "what the user is looking at" and the header path comes from the same level,
+ * both read at this layer — kept in the body, a copy would always take the first
+ * level.
+ *
+ * A host-supplied `activeLevelKey` wins; this only records the choice of an
+ * uncontrolled tab.
+ */
+export interface DirectoryLevelState {
+    /** 实际渲染的那一级。The level actually rendered. */
+    activeLevel?: FilePreviewDirectoryTab['levels'][number];
+    /** 把当前层级固定下来的目录页签，交给正文组件。 */
+    /** The directory tab with the level pinned, handed to the body. */
+    directoryTab?: FilePreviewDirectoryTab;
+    /** 复制路径与复制正文共用的来源。The source shared by copy-path and copy-content. */
+    source?: FilePreviewSource;
+}
+export declare function useDirectoryLevel(tab: FilePreviewDirectoryTab | undefined): DirectoryLevelState;

package/dist/components/file-preview/use-file-preview-actions-context.d.ts

@@ -1,6 +1,6 @@
 import type { useFilePreviewActions } from './use-file-preview-actions.js';
 import type { useFilePreviewEditing } from './use-file-preview-editing.js';
-import type { FilePreviewActions, FilePreviewFileTab, FilePreviewTab, FilePreviewViewMode } from './types.js';
+import type { FilePreviewActions, FilePreviewFileTab, FilePreviewSource, FilePreviewTab, FilePreviewViewMode } from './types.js';
 type Operations = ReturnType<typeof useFilePreviewActions>;
 type Editing = ReturnType<typeof useFilePreviewEditing>;
 /**
@@ -11,9 +11,13 @@ type Editing = ReturnType<typeof useFilePreviewEditing>;
  * and operation state together with the methods that change them, so a
  * `slots.actions` renderer can build its own buttons.
  */
-export declare function useFilePreviewActionsContext({ activeTab, fileTab, viewMode, canSwitchView, setViewMode, editing, operations, }: {
+export declare function useFilePreviewActionsContext({ activeTab, fileTab, currentPath, currentSource, viewMode, canSwitchView, setViewMode, editing, operations, }: {
     activeTab: FilePreviewTab;
     fileTab?: FilePreviewFileTab;
+    /** 当前页签的路径；目录页签也有。The current tab's path; a directory has one too. */
+    currentPath?: string;
+    /** 当前页签的正文来源；目录页签取当前那一级。The body source; a directory uses its active level. */
+    currentSource?: FilePreviewSource;
     viewMode: FilePreviewViewMode;
     canSwitchView: boolean;
     setViewMode: (mode: FilePreviewViewMode) => void;

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

@@ -15,5 +15,5 @@ export declare function useFilePreviewActions(): {
     download: (tab: FilePreviewFileTab) => Promise<void>;
     openUri: (tab: FilePreviewFileTab, uri: string) => Promise<void>;
     copyPath: (tab: FilePreviewTab, path: string) => Promise<boolean>;
-    copyContent: (tab: FilePreviewFileTab, text: string) => Promise<boolean>;
+    copyContent: (tab: FilePreviewTab, text: string) => Promise<boolean>;
 };

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;
+};

package/dist/components/file-preview/use-file-preview-view-state.d.ts

@@ -0,0 +1,15 @@
+import type { ViewerHandle, ViewerViewModeOption } from '@ark-design/ui/file-viewer/core';
+import type { FilePreviewViewMode } from './types.js';
+/** Scope modes and handles to the actual file/level, including controlled navigation. */
+export declare function useFilePreviewViewState(identity: string): {
+    viewMode: FilePreviewViewMode;
+    setViewMode: import("react").Dispatch<import("react").SetStateAction<FilePreviewViewMode>>;
+    viewModes: readonly string[];
+    setViewModes: import("react").Dispatch<import("react").SetStateAction<readonly string[]>>;
+    viewerHandle: {
+        identity: string;
+        current: ViewerHandle | null;
+    };
+    onHandleChange: (handle: ViewerHandle | null) => void;
+    onViewModesChange: (modes: readonly ViewerViewModeOption[]) => void;
+};

package/dist/components/file-preview.js

@@ -1 +1 @@
-export { FilePreview } from "../g~0.js";
+export { FilePreview, LoadingState } from "../3~0.js";

package/dist/components/file-tree/file-tree-info-labels.d.ts

@@ -1,20 +1,5 @@
 import type { FileTreeInfoKey, FileTreeInfoLabels } from './types.js';
-/**
- * 内置英文文案。`FileTreeLabels.info` 未提供的键沿用这里的值。
- *
- * Built-in English copy. Keys missing from `FileTreeLabels.info` fall back here.
- */
 export declare const DEFAULT_INFO_LABELS: FileTreeInfoLabels;
-/**
- * 按宿主的覆盖合并内置文案，键为单位。宿主的空字符串表示该键不显示，因此
- * 合并时保留空串，由渲染方判断。
- *
- * Merges host overrides over the built-in copy, key by key. An empty host string
- * means "hide this key", so it is kept and the renderer decides.
- *
- * Returns the copy of one key, or `undefined` when the key is hidden or has no
- * copy.
- */
 export declare function resolveInfoCopy(key: FileTreeInfoKey, hostLabels: FileTreeInfoLabels | undefined): {
     description?: string;
     triggerBehavior?: string;

package/dist/components/file-tree/file-tree-info-tooltip.d.ts

@@ -1,14 +1,14 @@
 import type { FileTreeEntryRow, FileTreeInfoLabels } from './types.js';
 export interface FileTreeInfoCopy {
-    /** 行名称，作为浮层标题。Row name, used as the tooltip title. */
+    /** 行名称，作为浮层标题。Row name, used as the popover title. */
     title: string;
     /** 说明，已按行内同样的优先级解析。Description, resolved with the same precedence as inline. */
     description?: string;
-    /** 触发行为，只出现在浮层。Trigger copy, tooltip only. */
+    /** 触发行为，只出现在浮层。Trigger copy, popover only. */
     triggerBehavior?: string;
     /** 完整路径。Full path. */
     path: string;
-    /** 浮层里各行的字段名。Field names used inside the tooltip. */
+    /** 浮层里各行的字段名。Field names used inside the popover. */
     fields: {
         description: string;
         triggerBehavior: string;
@@ -22,21 +22,21 @@ export interface FileTreeInfoCopy {
  * （含显式空串），没给才用内置。调用方据此决定是否创建浮层外壳，避免留下一个
  * 只有背景和内边距的空壳。
  *
- * Resolves what a directory tooltip should show, or `null` when there is nothing.
+ * Resolves what a directory popover should show, or `null` when there is nothing.
  *
  * The description resolves as `row.description` then built-in copy, matching the
  * inline behaviour: a host value wins, including an explicit empty string, and
  * the built-in copy applies only when absent. The caller uses this to decide
- * whether to create the tooltip shell, so no empty shell is left behind.
+ * whether to create the surface, so no empty shell is left behind.
  */
 export declare function resolveFileTreeInfoCopy(row: FileTreeEntryRow, infoLabels?: FileTreeInfoLabels): FileTreeInfoCopy | null;
 /**
  * 目录的默认浮层内容：说明、触发行为与路径。九类长期记忆的说明只出现在这里，
  * 因此这个浮层是它们唯一的展示位置。
  *
- * The default tooltip content for a directory: description, trigger copy and
+ * The default popover content for a directory: description, trigger copy and
  * path. The nine long-term-memory keys describe themselves here only, so this
- * tooltip is the sole place their copy appears.
+ * surface is the sole place their copy appears.
  */
 export declare function FileTreeInfoTooltip({ copy }: {
     copy: FileTreeInfoCopy;

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

@@ -0,0 +1,4 @@
+import type { FileTreeLabels } from './types.js';
+import type { ResolvedLabels } from './file-tree-row-context.js';
+import { type Locale } from '../../shared/locale.js';
+export declare function resolveFileTreeLabels(locale?: Locale, labels?: FileTreeLabels): ResolvedLabels;

package/dist/components/file-tree/file-tree-row-context.d.ts

@@ -16,7 +16,6 @@ export interface FileTreeRowContext {
     /** 当前选中的行 id。Currently selected row id. */
     selectedId?: string | null;
     /** 当前展示浮层的行 id。Row whose tooltip is showing. */
-    tooltipRowId: string | null;
     /** 为行追加属性。Extra attributes for a row. */
     getRowAttributes?: (row: FileTreeRow) => HTMLAttributes<HTMLDivElement>;
     /** 行尾指示器。Row-end indicator. */
@@ -39,8 +38,4 @@ export interface FileTreeRowContext {
     onOpenRetentionSettings?: (uri: string) => void;
     /** 行的键盘处理。Key handling for a row. */
     onRowKeyDown: (event: KeyboardEvent<HTMLDivElement>, row: FileTreeEntryRow) => void;
-    /** 指针进入行。Pointer enters a row. */
-    onRowEnter: (rowId: string) => void;
-    /** 指针离开行。Pointer leaves a row. */
-    onRowLeave: () => void;
 }