@openviking/react 0.1.4 → 0.1.5

package/dist/components/agent-connect/use-agent-connect-copy.d.ts

@@ -0,0 +1,6 @@
+/** 提交阶段切断过期结果；每个复制按钮拥有独立的反馈和请求状态。 */
+export declare function useAgentConnectCopy(text: string, onCopy?: (text: string) => void): {
+    status: "copied" | "failed" | "idle" | "pending";
+    setRoot: (node: HTMLElement | null) => void;
+    copy: () => Promise<void>;
+};

package/dist/components/directory-tour/types.d.ts

@@ -23,9 +23,10 @@ export interface DirectoryTourLabels {
     progress?: (current: number, total: number) => string;
 }
 export interface DirectoryTourProps {
-    locale: Locale;
     open: boolean;
     steps: readonly DirectoryTourStep[];
+    /** Inherits the nearest language scope, otherwise en-US. */
+    locale?: Locale;
     currentStep?: number;
     defaultStep?: number;
     placement?: 'right' | 'left';

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

@@ -11,4 +11,4 @@ export type { FileBrowserEntriesLabels, FileBrowserEntriesProps, } from './types
  * agentConnect enables the right-side drawer; callbacks also support host-owned flows.
  * Nothing renders without visible entries; hosts can wrap the default import button.
  */
-export declare function FileBrowserEntries({ locale, agentConnect, onConnectAgent, onImportResources, renderImportResources, labels, className, ...rest }: FileBrowserEntriesProps): import("react").JSX.Element | null;
+export declare function FileBrowserEntries({ locale: localeProp, agentConnect, onConnectAgent, onImportResources, renderImportResources, labels, className, ...rest }: FileBrowserEntriesProps): import("react").JSX.Element | null;

package/dist/components/file-browser-entries/style.css

@@ -379,6 +379,93 @@
   --ov-ui-connect-notice-default: var(--ov-ui-text-2-default);
 }
 
+.ov-agent-connect__code-block {
+  border: 1px solid var(--ov-ui-agent-connect-border);
+  background: var(--ov-ui-agent-connect-bg);
+  white-space: normal;
+  border-radius: 8px;
+  margin-bottom: 12px;
+  overflow: hidden;
+}
+
+.ov-agent-connect__code-block:last-child {
+  margin-bottom: 0;
+}
+
+.ov-agent-connect__code-header {
+  border-bottom: 1px solid var(--ov-ui-agent-connect-border);
+  color: var(--ov-ui-agent-connect-muted);
+  justify-content: space-between;
+  align-items: center;
+  gap: 8px;
+  padding: 6px 12px;
+  font-size: 12px;
+  display: flex;
+}
+
+.ov-agent-connect__code-actions {
+  align-items: center;
+  gap: 12px;
+  display: flex;
+}
+
+.ov-agent-connect__code-actions button {
+  width: 24px;
+  height: 24px;
+  color: var(--ov-ui-agent-connect-secondary);
+  background: none;
+  border: 0;
+  border-radius: 4px;
+  justify-content: center;
+  align-items: center;
+  padding: 4px;
+  font-size: 12px;
+  display: inline-flex;
+}
+
+.ov-agent-connect__code-actions button:hover {
+  color: var(--ov-ui-agent-connect-primary);
+}
+
+.ov-agent-connect__code-actions button:disabled {
+  opacity: .6;
+  cursor: wait;
+}
+
+.ov-agent-connect__code-actions svg {
+  width: 16px;
+  height: 16px;
+}
+
+.ov-agent-connect .ov-agent-connect__code-block pre {
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  background: none;
+  border-radius: 0;
+  margin: 0;
+  padding: 12px;
+  font-size: 12px;
+  line-height: 20px;
+}
+
+.ov-agent-connect__code-block code {
+  font-family: ui-monospace, SFMono-Regular, Consolas, monospace;
+}
+
+.ov-agent-connect__code-block > .ov-agent-connect__feedback:not(:empty) {
+  padding: 0 12px 8px;
+  display: block;
+}
+
+.ov-agent-connect__code-feedback {
+  clip-path: inset(50%);
+  white-space: nowrap;
+  width: 1px;
+  height: 1px;
+  position: absolute;
+  overflow: hidden;
+}
+
 .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));
@@ -709,7 +796,7 @@
   white-space: normal;
 }
 
-.ov-agent-connect__markdown :where(p, pre, h5, table) {
+.ov-agent-connect__markdown :where(p, pre, h5, table, ul, ol, blockquote, details) {
   margin: 0 0 12px;
 }
 
@@ -721,6 +808,33 @@
   white-space: pre-wrap;
 }
 
+.ov-agent-connect__markdown :where(ul, ol) {
+  padding-left: 24px;
+}
+
+.ov-agent-connect__markdown ul {
+  list-style-type: disc;
+}
+
+.ov-agent-connect__markdown ol {
+  list-style-type: decimal;
+}
+
+.ov-agent-connect__markdown blockquote {
+  border-left: 2px solid var(--ov-ui-agent-connect-border);
+  margin-left: 0;
+  padding-left: 12px;
+}
+
+.ov-agent-connect__markdown summary {
+  cursor: pointer;
+}
+
+.ov-agent-connect__markdown summary:focus-visible {
+  outline: 2px solid var(--ov-ui-agent-connect-primary);
+  outline-offset: 2px;
+}
+
 .ov-agent-connect__markdown h5 {
   color: var(--ov-ui-agent-connect-text);
   font-size: 14px;

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

@@ -33,8 +33,8 @@ export interface FileBrowserEntriesLabels {
  * there is nothing left to separate.
  */
 export interface FileBrowserEntriesProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
-    /** 内置中英文文案的语言。Language of the built-in interface copy. */
-    locale: Locale;
+    /** 可选文案语言；继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+    locale?: Locale;
     /**
      * 内置 AgentConnect 右侧抽屉的参数；传入后显示连接入口。
      * Options for the built-in AgentConnect drawer; enables the connect entry.

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

@@ -597,8 +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;
+    /** 可选文案语言；继承上层，最终默认英文。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

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

@@ -510,8 +510,8 @@ export interface FileTreeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'chi
      * Visible rows in render order.
      */
     rows: readonly FileTreeRow[];
-    /** 内置中英文文案的语言。Language of the built-in interface copy. */
-    locale: Locale;
+    /** 可选文案语言；继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+    locale?: Locale;
     /**
      * 操作的执行能力；省略对应方法时禁用该操作。
      * Operation capabilities; omitting a method disables its operation.

package/dist/components/scope-switcher/scope-switcher.d.ts

@@ -2,5 +2,5 @@ import type { ScopeSwitcherProps } from './types.js';
 export { ScopeSelector } from './scope-selector.js';
 export { SCOPE_SWITCHER_SEARCH_THRESHOLD } from './types.js';
 export type { ScopeSelectorBaseProps, ScopeSelectorFixedProps, ScopeSelectorProps, ScopeSelectorSelectableProps, ScopeSwitcherActions, ScopeSwitcherData, ScopeSwitcherIdentity, ScopeSwitcherLabels, ScopeSwitcherOption, ScopeSwitcherPanelContent, ScopeSwitcherProps, ScopeSwitcherScrollMetrics, ScopeSwitcherSlots, ScopeSwitcherState, ScopeSwitcherTrigger, } from './types.js';
-/** No shared state, data aggregation or subscription in the layout root. */
-export declare function ScopeSwitcher({ locale, children, className, ...props }: ScopeSwitcherProps): import("react").JSX.Element;
+/** Layout and language scope only; selectors own data and interaction state. */
+export declare function ScopeSwitcher({ locale: localeProp, children, className, ...props }: ScopeSwitcherProps): import("react").JSX.Element;

package/dist/components/scope-switcher/types.d.ts

@@ -391,10 +391,10 @@ export interface ScopeSwitcherLabels {
      */
     error?: string;
 }
-/** Layout only: each child owns its state and data subscription. */
+/** Layout and language scope: each child owns its state and data subscription. */
 export interface ScopeSwitcherProps extends HTMLAttributes<HTMLDivElement> {
-    /** 内置中英文文案的语言。Language of the built-in interface copy. */
-    locale: Locale;
+    /** 可选文案语言；继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+    locale?: Locale;
 }
 /**
  * 两种层级共有的入参：身份与触发器内容。
@@ -402,13 +402,13 @@ export interface ScopeSwitcherProps extends HTMLAttributes<HTMLDivElement> {
  * Props shared by both level forms: identity and what the trigger shows.
  */
 export interface ScopeSelectorBaseProps {
-    /** 内置中英文文案的语言。Language of the built-in interface copy. */
-    locale: Locale;
     /**
      * 层级身份：稳定标识、无障碍名与末尾标记。
      * Level identity: stable key, accessible name and trailing marker.
      */
     identity: ScopeSwitcherIdentity;
+    /** 可选文案语言；继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+    locale?: Locale;
     /**
      * 触发器展示的当前值文本与图标。不传时从 `data.options` 里按 `data.selectedId`
      * 取对应项；固定层级没有 `data`，因此固定层级需要在这里给出 `label`。

package/dist/components/style.css

@@ -5421,6 +5421,93 @@ button.ark-agentic-file-viewer-diff__gutter {
   --ov-ui-connect-notice-default: var(--ov-ui-text-2-default);
 }
 
+.ov-agent-connect__code-block {
+  border: 1px solid var(--ov-ui-agent-connect-border);
+  background: var(--ov-ui-agent-connect-bg);
+  white-space: normal;
+  border-radius: 8px;
+  margin-bottom: 12px;
+  overflow: hidden;
+}
+
+.ov-agent-connect__code-block:last-child {
+  margin-bottom: 0;
+}
+
+.ov-agent-connect__code-header {
+  border-bottom: 1px solid var(--ov-ui-agent-connect-border);
+  color: var(--ov-ui-agent-connect-muted);
+  justify-content: space-between;
+  align-items: center;
+  gap: 8px;
+  padding: 6px 12px;
+  font-size: 12px;
+  display: flex;
+}
+
+.ov-agent-connect__code-actions {
+  align-items: center;
+  gap: 12px;
+  display: flex;
+}
+
+.ov-agent-connect__code-actions button {
+  width: 24px;
+  height: 24px;
+  color: var(--ov-ui-agent-connect-secondary);
+  background: none;
+  border: 0;
+  border-radius: 4px;
+  justify-content: center;
+  align-items: center;
+  padding: 4px;
+  font-size: 12px;
+  display: inline-flex;
+}
+
+.ov-agent-connect__code-actions button:hover {
+  color: var(--ov-ui-agent-connect-primary);
+}
+
+.ov-agent-connect__code-actions button:disabled {
+  opacity: .6;
+  cursor: wait;
+}
+
+.ov-agent-connect__code-actions svg {
+  width: 16px;
+  height: 16px;
+}
+
+.ov-agent-connect .ov-agent-connect__code-block pre {
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  background: none;
+  border-radius: 0;
+  margin: 0;
+  padding: 12px;
+  font-size: 12px;
+  line-height: 20px;
+}
+
+.ov-agent-connect__code-block code {
+  font-family: ui-monospace, SFMono-Regular, Consolas, monospace;
+}
+
+.ov-agent-connect__code-block > .ov-agent-connect__feedback:not(:empty) {
+  padding: 0 12px 8px;
+  display: block;
+}
+
+.ov-agent-connect__code-feedback {
+  clip-path: inset(50%);
+  white-space: nowrap;
+  width: 1px;
+  height: 1px;
+  position: absolute;
+  overflow: hidden;
+}
+
 .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));
@@ -5751,7 +5838,7 @@ button.ark-agentic-file-viewer-diff__gutter {
   white-space: normal;
 }
 
-.ov-agent-connect__markdown :where(p, pre, h5, table) {
+.ov-agent-connect__markdown :where(p, pre, h5, table, ul, ol, blockquote, details) {
   margin: 0 0 12px;
 }
 
@@ -5763,6 +5850,33 @@ button.ark-agentic-file-viewer-diff__gutter {
   white-space: pre-wrap;
 }
 
+.ov-agent-connect__markdown :where(ul, ol) {
+  padding-left: 24px;
+}
+
+.ov-agent-connect__markdown ul {
+  list-style-type: disc;
+}
+
+.ov-agent-connect__markdown ol {
+  list-style-type: decimal;
+}
+
+.ov-agent-connect__markdown blockquote {
+  border-left: 2px solid var(--ov-ui-agent-connect-border);
+  margin-left: 0;
+  padding-left: 12px;
+}
+
+.ov-agent-connect__markdown summary {
+  cursor: pointer;
+}
+
+.ov-agent-connect__markdown summary:focus-visible {
+  outline: 2px solid var(--ov-ui-agent-connect-primary);
+  outline-offset: 2px;
+}
+
 .ov-agent-connect__markdown h5 {
   color: var(--ov-ui-agent-connect-text);
   font-size: 14px;
@@ -8350,6 +8464,93 @@ button.ov-scope-switcher__trigger:hover:not(:disabled), button.ov-scope-switcher
   --ov-ui-connect-notice-default: var(--ov-ui-text-2-default);
 }
 
+.ov-agent-connect__code-block {
+  border: 1px solid var(--ov-ui-agent-connect-border);
+  background: var(--ov-ui-agent-connect-bg);
+  white-space: normal;
+  border-radius: 8px;
+  margin-bottom: 12px;
+  overflow: hidden;
+}
+
+.ov-agent-connect__code-block:last-child {
+  margin-bottom: 0;
+}
+
+.ov-agent-connect__code-header {
+  border-bottom: 1px solid var(--ov-ui-agent-connect-border);
+  color: var(--ov-ui-agent-connect-muted);
+  justify-content: space-between;
+  align-items: center;
+  gap: 8px;
+  padding: 6px 12px;
+  font-size: 12px;
+  display: flex;
+}
+
+.ov-agent-connect__code-actions {
+  align-items: center;
+  gap: 12px;
+  display: flex;
+}
+
+.ov-agent-connect__code-actions button {
+  width: 24px;
+  height: 24px;
+  color: var(--ov-ui-agent-connect-secondary);
+  background: none;
+  border: 0;
+  border-radius: 4px;
+  justify-content: center;
+  align-items: center;
+  padding: 4px;
+  font-size: 12px;
+  display: inline-flex;
+}
+
+.ov-agent-connect__code-actions button:hover {
+  color: var(--ov-ui-agent-connect-primary);
+}
+
+.ov-agent-connect__code-actions button:disabled {
+  opacity: .6;
+  cursor: wait;
+}
+
+.ov-agent-connect__code-actions svg {
+  width: 16px;
+  height: 16px;
+}
+
+.ov-agent-connect .ov-agent-connect__code-block pre {
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  background: none;
+  border-radius: 0;
+  margin: 0;
+  padding: 12px;
+  font-size: 12px;
+  line-height: 20px;
+}
+
+.ov-agent-connect__code-block code {
+  font-family: ui-monospace, SFMono-Regular, Consolas, monospace;
+}
+
+.ov-agent-connect__code-block > .ov-agent-connect__feedback:not(:empty) {
+  padding: 0 12px 8px;
+  display: block;
+}
+
+.ov-agent-connect__code-feedback {
+  clip-path: inset(50%);
+  white-space: nowrap;
+  width: 1px;
+  height: 1px;
+  position: absolute;
+  overflow: hidden;
+}
+
 .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));
@@ -8680,7 +8881,7 @@ button.ov-scope-switcher__trigger:hover:not(:disabled), button.ov-scope-switcher
   white-space: normal;
 }
 
-.ov-agent-connect__markdown :where(p, pre, h5, table) {
+.ov-agent-connect__markdown :where(p, pre, h5, table, ul, ol, blockquote, details) {
   margin: 0 0 12px;
 }
 
@@ -8692,6 +8893,33 @@ button.ov-scope-switcher__trigger:hover:not(:disabled), button.ov-scope-switcher
   white-space: pre-wrap;
 }
 
+.ov-agent-connect__markdown :where(ul, ol) {
+  padding-left: 24px;
+}
+
+.ov-agent-connect__markdown ul {
+  list-style-type: disc;
+}
+
+.ov-agent-connect__markdown ol {
+  list-style-type: decimal;
+}
+
+.ov-agent-connect__markdown blockquote {
+  border-left: 2px solid var(--ov-ui-agent-connect-border);
+  margin-left: 0;
+  padding-left: 12px;
+}
+
+.ov-agent-connect__markdown summary {
+  cursor: pointer;
+}
+
+.ov-agent-connect__markdown summary:focus-visible {
+  outline: 2px solid var(--ov-ui-agent-connect-primary);
+  outline-offset: 2px;
+}
+
 .ov-agent-connect__markdown h5 {
   color: var(--ov-ui-agent-connect-text);
   font-size: 14px;

package/dist/components/tui/tui.d.ts

@@ -8,4 +8,4 @@ export type { TuiCommandHelpContent, TuiCommandHelpItem, TuiCommandHelpSection,
  * Command records, results and input. The host owns execution and sessions; the
  * component renders supplied records and reports submission intent and successful copies.
  */
-export declare function Tui({ records, value, disabled, emptyState, quickCommands, locale, commands, commandGroups, onValueChange, onSubmit, onOpenUri, onCopy, labels, className, ...rest }: TuiProps): import("react").JSX.Element;
+export declare function Tui({ records, value, disabled, emptyState, quickCommands, locale: localeProp, commands, commandGroups, onValueChange, onSubmit, onOpenUri, onCopy, labels, className, ...rest }: TuiProps): import("react").JSX.Element;

package/dist/components/tui/types.d.ts

@@ -473,8 +473,6 @@ export interface TuiLabels {
  * Provides command completion, parameter hints and help.
  */
 export interface TuiProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onCopy' | 'onSubmit'> {
-    /** 内置中英文文案的语言。Language of the built-in interface copy. */
-    locale: Locale;
     /**
      * 当前展示的执行记录，按提交顺序排列；会话与历史切换后由宿主更新。
      * Currently displayed execution records in submission order, updated by the
@@ -486,6 +484,8 @@ export interface TuiProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onCopy'
      * Controlled input value.
      */
     value: string;
+    /** 可选文案语言；继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+    locale?: Locale;
     /**
      * 是否禁用命令输入与提交，缺省为 `false`。
      * 禁用时的提示文案由 `labels.unavailableMessage` 提供。

package/dist/components/viking-bot/ark-message-list-view.d.ts

@@ -1,7 +1,10 @@
+import type { Locale } from '../../shared/locale.js';
 import type { VikingBotMessageListProps } from './types.js';
 /**
  * Ark 渲染的消息列表。只在懒加载边界之后加载，因此可以静态引用 Ark。
  * The Ark-rendered message list. Loaded behind the lazy boundary, so it may
  * import Ark statically.
  */
-export declare function VikingBotMessageListView({ messages, className, streaming, footer, listKey, onOpenUri, onCopy, onMessageAction, renderMessage, locale, labels: overrides, }: VikingBotMessageListProps): import("react").JSX.Element;
+export declare function VikingBotMessageListView({ messages, className, streaming, footer, listKey, onOpenUri, onCopy, onMessageAction, renderMessage, locale, labels: overrides, }: VikingBotMessageListProps & {
+    locale: Locale;
+}): import("react").JSX.Element;

package/dist/components/viking-bot/interaction/types.d.ts

@@ -164,8 +164,8 @@ export interface VikingBotInteractionLabels {
 export interface VikingBotInteractionProps {
     /** 当前问题。The current question. */
     request: VikingBotInteractionRequest;
-    /** 内置中英文文案的语言。Language of the built-in interface copy. */
-    locale: Locale;
+    /** 可选文案语言；继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+    locale?: Locale;
     /**
      * 问题的稳定身份；变化时重置表单状态。省略时按 `request.kind` 与序号判定。
      * Stable identity of the question; changes reset the form state. Defaults to

package/dist/components/viking-bot/interaction/viking-bot-interaction.d.ts

@@ -6,4 +6,4 @@ import type { VikingBotInteractionProps } from './types.js';
  * The pending-interaction area. Ark's AskHuman renders the form; when a question
  * needs a tree picker or an uploader, `custom` hands rendering to the host.
  */
-export declare function VikingBotInteractionView({ request, className, requestKey, index, total, disabled, submitting, error, onSubmit, onCancel, locale, labels: overrides, }: VikingBotInteractionProps): import("react").JSX.Element;
+export declare function VikingBotInteractionView({ request, className, requestKey, index, total, disabled, submitting, error, onSubmit, onCancel, locale: localeProp, labels: overrides, }: VikingBotInteractionProps): import("react").JSX.Element;

package/dist/components/viking-bot/session-actions.d.ts

@@ -3,9 +3,9 @@ import type { ReactNode } from 'react';
 import type { VikingBotLabels } from './model.js';
 import type { VikingBotSessions } from './capabilities.js';
 /** Session controls can be used alone by a host's shared header. */
-export declare function VikingBotSessionActions({ sessions, extra, labels: overrides, locale, }: {
+export declare function VikingBotSessionActions({ sessions, extra, labels: overrides, locale: localeProp, }: {
     sessions?: VikingBotSessions;
     extra?: ReactNode;
     labels?: VikingBotLabels;
-    locale: Locale;
+    locale?: Locale;
 }): import("react").JSX.Element;

package/dist/components/viking-bot/types.d.ts

@@ -7,8 +7,8 @@ import type { VikingBotAttachment, VikingBotDraft, VikingBotLabels, VikingBotMes
 export interface VikingBotMessageListProps {
     /** 当前会话的消息。Messages in the current session. */
     messages: readonly VikingBotMessage[];
-    /** 内置中英文文案的语言。Language of the built-in interface copy. */
-    locale: Locale;
+    /** 可选文案语言；继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+    locale?: Locale;
     /** 附加到根元素的类名。Class name applied to the root element. */
     className?: string;
     /** 助手仍在生成时追加的片段。Parts appended while the assistant is still streaming. */
@@ -47,8 +47,8 @@ export interface VikingBotComposerRef {
 export interface VikingBotComposerProps extends VikingBotInputFeatures {
     /** 受控的草稿文本。Controlled draft text. */
     value: string;
-    /** 内置中英文文案的语言。Language of the built-in interface copy. */
-    locale: Locale;
+    /** 可选文案语言；继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+    locale?: Locale;
     /** 附加到根元素的类名。Class name applied to the root element. */
     className?: string;
     /** 宿主已选中的附件。Attachments already selected by the host. */
@@ -84,8 +84,8 @@ export interface VikingBotComposerProps extends VikingBotInputFeatures {
 export interface VikingBotProps extends VikingBotInputFeatures, Omit<HTMLAttributes<HTMLDivElement>, 'onCopy' | 'onSubmit'> {
     /** 当前会话的消息。Messages in the current session. */
     messages: readonly VikingBotMessage[];
-    /** 内置中英文文案的语言。Language of the built-in interface copy. */
-    locale: Locale;
+    /** 可选文案语言；继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+    locale?: Locale;
     /** Host-owned session history and actions. */
     sessions?: VikingBotSessions;
     /** Optional extension controls, such as a host-provided More menu. */
@@ -120,7 +120,7 @@ export interface VikingBotProps extends VikingBotInputFeatures, Omit<HTMLAttribu
      * 待确认交互的配置；存在时替代输入区。
      * Configuration of a pending interaction; replaces the composer.
      */
-    interaction?: Omit<VikingBotInteractionProps, 'locale'>;
+    interaction?: VikingBotInteractionProps;
     /**
      * 整块替换交互区；传值时忽略 `interaction` 的内置渲染，宿主自行渲染。
      * Replaces the whole interaction area; when set, the built-in rendering of

package/dist/components/viking-bot/viking-bot.d.ts

@@ -8,4 +8,4 @@ import type { VikingBotProps } from './types.js';
  * interaction can each be replaced by the host; the built-in implementations
  * are used when they are omitted.
  */
-export declare function VikingBot({ messages, className, streaming, draft, attachments, isSending, isAvailable, unavailableMessage, emptyState, header, sessions, headerActions, locale, quickInputs, onQuickInputSelect, references, footer, children, messageList, composer, interaction, interactionSlot, listKey, composerRef, onDraftChange, onFilesAdded, onAttachmentRemove, onSend, onCancel, onOpenUri, onCopy, onMessageAction, labels: overrides, ...rest }: VikingBotProps): import("react").JSX.Element;
+export declare function VikingBot({ messages, className, streaming, draft, attachments, isSending, isAvailable, unavailableMessage, emptyState, header, sessions, headerActions, locale: localeProp, quickInputs, onQuickInputSelect, references, footer, children, messageList, composer, interaction, interactionSlot, listKey, composerRef, onDraftChange, onFilesAdded, onAttachmentRemove, onSend, onCancel, onOpenUri, onCopy, onMessageAction, labels: overrides, ...rest }: VikingBotProps): import("react").JSX.Element;