@openviking/react 0.1.3 → 0.1.5

package/dist/components/tui/locales/en-US.d.ts

@@ -0,0 +1,35 @@
+declare const messages: {
+    placeholder: string;
+    unavailableMessage: string;
+    send: string;
+    allCommands: string;
+    historyCommands: string;
+    suggestions: string;
+    noSuggestions: string;
+    pending: string;
+    success: string;
+    error: string;
+    copy: string;
+    copied: string;
+    emptyTitle: string;
+    emptyDescription: string;
+    quickStart: string;
+    noResult: string;
+    justNow: string;
+    formatMinutesAgo: (minutes: number) => string;
+    formatHoursAgo: (hours: number) => string;
+    availableCommands: string;
+    helpHint: string;
+    parameters: string;
+    examples: string;
+    noParameters: string;
+    loadMore: string;
+    resource: string;
+    parameter: string;
+    required: string;
+    description: string;
+    defaultValue: string;
+    yes: string;
+    no: string;
+};
+export default messages;

package/dist/components/tui/locales/zh-CN.d.ts

@@ -0,0 +1,35 @@
+declare const messages: {
+    placeholder: string;
+    unavailableMessage: string;
+    send: string;
+    allCommands: string;
+    historyCommands: string;
+    suggestions: string;
+    noSuggestions: string;
+    pending: string;
+    success: string;
+    error: string;
+    copy: string;
+    copied: string;
+    emptyTitle: string;
+    emptyDescription: string;
+    quickStart: string;
+    noResult: string;
+    justNow: string;
+    formatMinutesAgo: (minutes: number) => string;
+    formatHoursAgo: (hours: number) => string;
+    availableCommands: string;
+    helpHint: string;
+    parameters: string;
+    examples: string;
+    noParameters: string;
+    loadMore: string;
+    resource: string;
+    parameter: string;
+    required: string;
+    description: string;
+    defaultValue: string;
+    yes: string;
+    no: string;
+};
+export default messages;

package/dist/components/tui/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;
@@ -79,6 +91,150 @@
   --ov-ui-connect-notice-default: var(--ov-ui-text-2-default);
 }
 
+.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;
+  --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-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-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;
+  --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-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;
+  --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-tooltip {
+  --ov-ui-tooltip-bg: var(--ov-ui-color-tooltip-bg, var(--ov-ui-tooltip-bg-default, #1f2329));
+  --ov-ui-tooltip-text: var(--ov-ui-color-tooltip-text, var(--ov-ui-tooltip-text-default, #fff));
+  --ov-ui-tooltip-border: transparent;
+  --ov-ui-tooltip-radius: var(--ov-ui-radius, 6px);
+  --ov-ui-tooltip-offset: 6px;
+  z-index: 1000;
+  box-sizing: border-box;
+  border: 1px solid var(--ov-ui-tooltip-border);
+  border-radius: var(--ov-ui-tooltip-radius);
+  background: var(--ov-ui-tooltip-bg);
+  max-width: 320px;
+  color: var(--ov-ui-tooltip-text);
+  overflow-wrap: break-word;
+  padding: 6px 8px;
+  font-family: inherit;
+  font-size: 12px;
+  line-height: 18px;
+  animation: .12s ease-out ov-tooltip-enter;
+  position: fixed;
+  box-shadow: 0 4px 12px #0000001f;
+}
+
+.ov-tooltip[role="dialog"] {
+  --ov-ui-tooltip-bg: var(--ov-ui-color-bg-1, var(--ov-ui-bg-1-default, #fff));
+  --ov-ui-tooltip-text: var(--ov-ui-color-text-1, var(--ov-ui-text-1-default, #0b0b0f));
+  --ov-ui-tooltip-border: var(--ov-ui-color-border-2, var(--ov-ui-border-2-default, #e1e4f2));
+  min-width: 120px;
+  max-width: 360px;
+  padding: 4px;
+  box-shadow: 0 6px 16px #0000001f;
+}
+
+@keyframes ov-tooltip-enter {
+  from {
+    opacity: 0;
+  }
+
+  to {
+    opacity: 1;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ov-tooltip {
+    animation: none;
+  }
+}
+
+
+
 .ov-tui {
   --ov-ui-tui-gap: 16px;
   --ov-ui-tui-text: var(--ov-ui-color-text-1, var(--ov-ui-text, var(--ov-ui-text-1-default)));
@@ -287,19 +443,23 @@
 }
 
 .ov-tui__copy {
-  border: 1px solid var(--ov-ui-tui-card-border);
-  color: var(--ov-ui-tui-muted);
-  font: inherit;
+  box-sizing: border-box;
+  background: var(--ov-ui-tui-card-bg);
+  width: 32px;
+  height: 32px;
+  color: var(--ov-ui-color-text-2);
   cursor: pointer;
-  background: none;
+  border: 0;
   border-radius: 6px;
   flex: none;
-  padding: 2px 8px;
-  font-size: 12px;
+  justify-content: center;
+  align-items: center;
+  padding: 0;
+  display: inline-flex;
 }
 
 .ov-tui__copy:hover {
-  color: inherit;
+  color: var(--ov-ui-tui-text);
   background: var(--ov-ui-tui-hover);
 }
 
@@ -343,17 +503,11 @@
 }
 
 .ov-tui__copy--inline {
-  opacity: 0;
-  transition: opacity .12s;
   position: absolute;
   top: -2px;
   right: 0;
 }
 
-.ov-tui__code-block:hover .ov-tui__copy--inline, .ov-tui__copy--inline:focus-visible {
-  opacity: 1;
-}
-
 .ov-tui__markdown {
   overflow-wrap: anywhere;
   min-width: 0;
@@ -443,6 +597,7 @@
   max-inline-size: 100%;
   font-family: var(--ov-ui-font-mono, "Roboto Mono", monospace);
   margin: 0;
+  padding-inline-end: 36px;
   font-size: 13px;
   line-height: 20px;
   overflow: auto;
@@ -883,7 +1038,7 @@
 
 .ov-tui__help {
   flex-direction: column;
-  gap: 12px;
+  gap: 16px;
   display: flex;
 }
 
@@ -901,7 +1056,7 @@
 
 .ov-tui__help-section {
   flex-direction: column;
-  gap: 6px;
+  gap: 12px;
   display: flex;
 }
 
@@ -913,7 +1068,7 @@
 
 .ov-tui__help-items {
   flex-direction: column;
-  gap: 2px;
+  gap: 8px;
   display: flex;
 }
 
@@ -1550,5 +1705,142 @@
   }
 }
 
+.ov-tui__empty--hero {
+  inline-size: 100%;
+  min-inline-size: 0;
+  min-height: 0;
+  color: var(--ov-ui-color-text-2, var(--ov-ui-text-2-default));
+  text-align: start;
+  align-self: stretch;
+  padding: 32px 4px;
+  display: block;
+}
+
+.ov-tui__empty--hero .ov-tui__empty-title {
+  font-family: var(--ov-ui-font-display, "Trebuchet MS", sans-serif);
+  letter-spacing: .035em;
+  align-items: center;
+  margin: 0;
+  font-size: clamp(1.5rem, 1.25rem + 2.5cqi, 2.25rem);
+  font-weight: 400;
+  line-height: 1.2;
+  display: flex;
+}
+
+.ov-tui__empty-title:after {
+  content: "";
+  opacity: .16;
+  background: currentColor;
+  block-size: .9em;
+  inline-size: .32em;
+  margin-inline-start: .15em;
+}
+
+.ov-tui__empty--hero .ov-tui__empty-subtitle {
+  color: var(--ov-ui-tui-muted);
+  margin: 16px 0 40px;
+  font-size: 15px;
+}
+
+.ov-tui__empty--hero .ov-tui__empty-quick-label {
+  color: var(--ov-ui-tui-muted);
+  margin: 0 0 12px;
+}
+
+.ov-tui__empty-list {
+  flex-direction: column;
+  gap: 8px;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  display: flex;
+}
+
+.ov-tui__empty-list > .ov-tui__empty-item {
+  margin: 0;
+}
+
+.ov-tui__empty-action {
+  background: var(--ov-ui-tui-card-bg);
+  min-block-size: 52px;
+  inline-size: 100%;
+  color: inherit;
+  font: inherit;
+  text-align: start;
+  cursor: pointer;
+  border: 0;
+  border-radius: 16px;
+  grid-template-columns: 14px minmax(132px, .8fr) minmax(0, 1.2fr);
+  align-items: center;
+  gap: 12px;
+  padding: 12px 16px;
+  display: grid;
+}
+
+.ov-tui__empty-action:hover:not(:disabled) {
+  background: var(--ov-ui-tui-bubble-bg);
+}
+
+.ov-tui__empty-action:disabled {
+  color: var(--ov-ui-tui-muted);
+  cursor: not-allowed;
+}
+
+.ov-tui__empty-action > svg {
+  translate: 0;
+}
+
+@keyframes ov-tui-empty-arrow-nudge {
+  0%, 100% {
+    translate: 0;
+  }
+
+  30% {
+    translate: -2px;
+  }
+
+  65% {
+    translate: 3px;
+  }
+}
+
+@media (hover: hover) and (prefers-reduced-motion: no-preference) {
+  .ov-tui__empty-action:hover:not(:disabled) > svg {
+    animation: .36s ease-in-out ov-tui-empty-arrow-nudge;
+  }
+}
+
+.ov-tui__empty-action:focus-visible {
+  outline: 2px solid var(--ov-ui-tui-link);
+  outline-offset: 3px;
+}
+
+.ov-tui__empty-name {
+  color: var(--ov-ui-color-text-1, var(--ov-ui-text-1-default));
+  font-family: var(--ov-ui-font-mono, ui-monospace, monospace);
+  overflow-wrap: anywhere;
+  font-size: 15px;
+}
+
+.ov-tui__empty-desc {
+  color: var(--ov-ui-color-text-description, var(--ov-ui-text-description-default));
+  overflow-wrap: anywhere;
+}
+
+@container (width <= 420px) {
+  .ov-tui__empty--hero {
+    padding-block: 16px;
+  }
+
+  .ov-tui__empty-action {
+    grid-template-columns: 14px minmax(0, 1fr);
+    gap: 4px 12px;
+  }
+
+  .ov-tui__empty-desc {
+    grid-column: 2;
+  }
+}
+
 
 

package/dist/components/tui/tui-copy-button.d.ts

@@ -5,5 +5,5 @@ export interface TuiCopyButtonProps {
     onCopy?: (text: string) => void;
     className?: string;
 }
-/** 复制按钮：成功后短暂显示已复制，并通知宿主。 */
+/** 纯图标复制按钮：Tooltip 展示动作与复制成功反馈。 */
 export declare function TuiCopyButton({ text, label, copiedLabel, onCopy, className, }: TuiCopyButtonProps): import("react").JSX.Element;

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

@@ -0,0 +1,25 @@
+import type { ReactNode } from 'react';
+import type { TuiCommandDefinition } from './command-catalog.js';
+import type { ResolvedTuiLabels } from './tui-labels.js';
+/**
+ * 按名称从宿主目录中取快捷命令，保持传入顺序，未命中的名称直接跳过。
+ * 重复名称只保留首次出现，避免同一命令渲染成多个相同 key 的兄弟节点。
+ * Resolves quick commands from the host catalogue in the given order, skipping
+ * names the catalogue does not contain. Repeated names keep their first
+ * occurrence so one command never renders as sibling nodes with the same key.
+ */
+export declare function pickTuiCommands(names: readonly string[] | undefined, commands: readonly TuiCommandDefinition[]): readonly TuiCommandDefinition[];
+/**
+ * 无记录时的空态区域。宿主节点优先；否则展示内置空态，没有可用快捷命令时
+ * 不渲染任何内容。
+ *
+ * Empty region shown without records. A host node wins; otherwise the built-in
+ * empty state renders, and nothing is shown when no quick command resolves.
+ */
+export declare function TuiEmptyRegion({ emptyState, commands, labels, disabled, onPick, }: {
+    emptyState?: ReactNode;
+    commands: readonly TuiCommandDefinition[];
+    labels: ResolvedTuiLabels;
+    disabled?: boolean;
+    onPick: (command: TuiCommandDefinition) => void;
+}): import("react").JSX.Element | null;

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

@@ -1,5 +1,5 @@
 import type { TuiLabels } from './types.js';
-/** 补齐当前语言的默认界面文案。 */
+import { type Locale } from '../../shared/locale.js';
 export type ResolvedTuiLabels = Required<TuiLabels>;
 export declare const DEFAULT_TUI_LABELS: ResolvedTuiLabels;
-export declare function resolveTuiLabels(labels?: TuiLabels, locale?: 'en' | 'zh'): ResolvedTuiLabels;
+export declare function resolveTuiLabels(labels?: TuiLabels, locale?: Locale): ResolvedTuiLabels;

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, 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

@@ -1,3 +1,4 @@
+import type { Locale } from '../../shared/locale.js';
 import type { HTMLAttributes, ReactNode } from 'react';
 import type { TuiCommandDefinition, TuiCommandGroup } from './command-catalog.js';
 /**
@@ -363,8 +364,8 @@ export interface TuiRecord {
     createdAtMs?: number;
 }
 /**
- * 可替换的界面文案，默认英文。
- * Replaceable interface copy, defaulting to English.
+ * 可替换的界面文案，默认跟随 locale。
+ * Replaceable interface copy, following locale.
  */
 export interface TuiLabels {
     /**
@@ -423,10 +424,20 @@ export interface TuiLabels {
      */
     copied?: string;
     /**
-     * 无记录时的提示。
-     * Message shown when there are no records.
+     * 内置空态的标题。
+     * Heading of the built-in empty state.
      */
-    empty?: string;
+    emptyTitle?: string;
+    /**
+     * 内置空态的说明。
+     * Description of the built-in empty state.
+     */
+    emptyDescription?: string;
+    /**
+     * 快捷命令列表上方的引导文案。
+     * Label above the quick command list.
+     */
+    quickStart?: string;
     /** 无返回结果时的提示。Message for an empty command result. */
     noResult?: string;
     /** 刚刚发送的时间文案。Time label for a just-sent record. */
@@ -473,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` 提供。
@@ -481,15 +494,25 @@ export interface TuiProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onCopy'
      */
     disabled?: boolean;
     /**
-     * 无记录时展示的完整空态节点，可包含标题、说明与快捷入口。
-     * 省略时展示 `labels.empty`，传 `null` 时隐藏空态内容。
-     * Complete empty-state node when there are no records; may include a
-     * heading, description and shortcuts. Omission shows `labels.empty`;
-     * passing `null` hides empty-state content.
+     * 无记录时展示的空态节点，完全替换内置空态。
+     * 省略时按 `quickCommands` 展示内置空态，没有可用快捷命令时不显示任何空态内容；
+     * 传 `null` 时同样不显示。
+     * Empty-state node shown when there are no records, replacing the built-in
+     * empty state. When omitted, the built-in empty state renders the resolved
+     * `quickCommands`; without any resolved command nothing is shown. Passing
+     * `null` also shows nothing.
      */
     emptyState?: ReactNode;
-    /** 内置界面文案的语言，默认英文；命令文案由宿主提供。 */
-    locale?: 'en' | 'zh';
+    /**
+     * 内置空态展示的快捷命令名称，按数组顺序取自 `commands`，未命中的名称跳过，
+     * 重复名称只保留首次出现。
+     * 点击后填入输入框并聚焦，不提交命令。
+     * Quick command names rendered by the built-in empty state, resolved from
+     * `commands` in array order; unknown names are skipped and repeats keep their
+     * first occurrence. Selecting one fills
+     * and focuses the input without submitting.
+     */
+    quickCommands?: readonly string[];
     /** 宿主提供的命令目录；省略时无候选和参数帮助，仍可提交文本。 */
     commands?: readonly TuiCommandDefinition[];
     /** 宿主提供的分组名称与顺序；未声明的组按目录顺序追加。 */

package/dist/components/tui.js

@@ -1 +1 @@
-export { Tui } from "../3~0.js";
+export { Tui } from "../3c~0.js";

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

@@ -24,6 +24,8 @@ export interface VikingBotActivityGroup {
     /** 条目。Items. */
     items: ActivityTimelineItem[];
 }
+/** Pair separately delivered results by id, keeping the original call position. */
+export declare function mergeToolResults(parts: readonly VikingBotMessagePart[]): VikingBotMessagePart[];
 /**
  * 把片段聚合成执行块：带 `groupId` 的相邻推理与工具片段归为一组，
  * 其余片段原样保留，由调用方按类型分别渲染。

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

@@ -1,13 +1,7 @@
 import type { VikingBotMessage } from './model.js';
 import type { VikingBotMessageListProps } from './types.js';
 type Labels = NonNullable<VikingBotMessageListProps['labels']>;
-/** Markdown 或纯文本正文。A Markdown or plain-text body. */
-export declare function MessageText({ text, streaming, format, }: {
-    text: string;
-    streaming?: boolean;
-    format?: 'plain' | 'markdown';
-}): import("react").JSX.Element;
-/** 消息正文：执行块在前，其余片段按顺序渲染。 */
+/** Keep activity blocks and answer segments in their original arrival order. */
 export declare function MessageBody({ message, labels, onOpenUri, }: {
     message: VikingBotMessage;
     labels: Labels;

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, 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;