@openviking/react 0.1.4 → 0.1.6

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

@@ -1,3 +1,9 @@
-export declare function AgentConnectMarkdown({ text }: {
+import { type CodeBlockControls } from './agent-connect-code-block.js';
+/** 先解析原始 HTML，再清理不允许的标签、属性与协议。 */
+interface MarkdownProps extends CodeBlockControls {
     text: string;
-}): import("react").JSX.Element;
+    keyToken: string;
+    apiKey: string;
+}
+export declare function AgentConnectMarkdown({ text, ...context }: MarkdownProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,10 @@
+interface MarkdownNode {
+    type: string;
+    value?: string;
+    children?: MarkdownNode[];
+}
+/** 正文及行内代码只显示脱敏值；代码块由专用视图处理占位符。 */
+export declare function remarkMaskApiKey({ keyToken }: {
+    keyToken: string;
+}): (tree: MarkdownNode) => void;
+export {};

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

@@ -1,4 +1,4 @@
 import type { AgentConnectProps } from './types.js';
 export type { AgentConnectItem, AgentConnectProps, AgentConnectLocale, AgentConnectTabId, } from './types.js';
 /** 按设计稿固定文案与图标；选择与复制保持实例内交互。 */
-export declare function AgentConnect({ apiKey, locale, baseUrl, agreementUrl, activeTabId: controlledTabId, selectedId: controlledSelectedId, onTabChange, onSelect, onCopy, className, ...rest }: AgentConnectProps): import("react").JSX.Element;
+export declare function AgentConnect({ apiKey, locale: localeProp, baseUrl, agreementUrl, showOverseasTag, activeTabId: controlledTabId, selectedId: controlledSelectedId, onTabChange, onSelect, onCopy, className, ...rest }: AgentConnectProps): import("react").JSX.Element;

package/dist/components/agent-connect/locales/en-US.d.ts

@@ -6,6 +6,9 @@ declare const messages: {
     instructions: string;
     copy: string;
     copyMarkdown: string;
+    copyCode: string;
+    showApiKey: string;
+    hideApiKey: string;
     copied: string;
     failed: string;
     notice: string;

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

@@ -1,4 +1,4 @@
-.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-directory-tour, .ov-wiki-dashboard, .ov-experience-dashboard, .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;
@@ -35,9 +35,29 @@
   --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-library-swatch-1-default: linear-gradient(145deg,
+    #ffd8ec 8%,
+    #ffabc8 46%,
+    #d8cbff 100%);
+  --ov-ui-library-swatch-2-default: linear-gradient(145deg,
+    #d9e8ff 8%,
+    #b8a6ff 52%,
+    #f3d6ff 100%);
+  --ov-ui-library-swatch-3-default: linear-gradient(145deg,
+    #ffe6bc 8%,
+    #ffaf96 48%,
+    #ff8bc5 100%);
+  --ov-ui-library-swatch-4-default: linear-gradient(145deg,
+    #eaf7ba 8%,
+    #b5efb8 52%,
+    #73d9c6 100%);
+  --ov-ui-library-swatch-5-default: linear-gradient(145deg,
+    #fff1ba 8%,
+    #ffc776 52%,
+    #bd9cff 100%);
+}
+
+.dark .ov-directory-tour, html.dark .ov-wiki-dashboard, html.dark .ov-experience-dashboard, .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;
@@ -91,6 +111,117 @@
   --ov-ui-connect-notice-default: var(--ov-ui-text-2-default);
 }
 
+.ov-wiki-dashboard, .ov-experience-dashboard, .ov-file-browser {
+  --ov-ui-dashboard-surface-default: #f8f8f8;
+  --ov-ui-dashboard-card-default: #fafafa;
+  --ov-ui-dashboard-muted-default: #787c91;
+  --ov-ui-dashboard-border-default: #edeef2;
+  --ov-ui-dashboard-warning-default: #eb7d00;
+  --ov-ui-dashboard-warning-light-default: #fff0e5;
+  --ov-ui-dashboard-danger-default: #d92d54;
+  --ov-ui-dashboard-danger-light-default: #ffecee;
+  --ov-ui-dashboard-success-default: #4f9c70;
+}
+
+html.dark .ov-wiki-dashboard, html.dark .ov-experience-dashboard, html.dark .ov-file-browser {
+  --ov-ui-dashboard-surface-default: var(--ov-ui-bg-3-default);
+  --ov-ui-dashboard-card-default: var(--ov-ui-bg-3-default);
+  --ov-ui-dashboard-muted-default: var(--ov-ui-text-3-default);
+  --ov-ui-dashboard-border-default: var(--ov-ui-border-1-default);
+  --ov-ui-dashboard-warning-default: var(--ov-ui-warning-default);
+  --ov-ui-dashboard-warning-light-default: var(--ov-ui-warning-light-default);
+  --ov-ui-dashboard-danger-default: var(--ov-ui-status-error-default);
+  --ov-ui-dashboard-danger-light-default: var(--ov-ui-bg-5-default);
+  --ov-ui-dashboard-success-default: var(--ov-ui-status-success-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));
@@ -421,7 +552,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;
 }
 
@@ -433,6 +564,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/agent-connect/types.d.ts

@@ -11,12 +11,14 @@ export interface AgentConnectItem {
 export interface AgentConnectProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onSelect' | 'onCopy'> {
     /** 调用方提供的密钥；展示脱敏，复制保留原值。Host API key. */
     apiKey: string;
-    /** 内置文案语言；必须由调用方指定。Required content locale. */
-    locale: AgentConnectLocale;
+    /** 内置文案语言；省略时继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+    locale?: AgentConnectLocale;
     /** 服务地址，默认 OpenViking 云服务。Optional service endpoint. */
     baseUrl?: string;
     /** 宿主提供的用户协议链接；未传时不显示协议引用。Host agreement URL. */
     agreementUrl?: string;
+    /** 是否展示境外标签，默认 false。Show Overseas tags; defaults to false. */
+    showOverseasTag?: boolean;
     /** 受控页签；默认 mainstream。Controlled tab; defaults to mainstream. */
     activeTabId?: AgentConnectTabId;
     /** 受控 Agent；默认 codex。Controlled agent; defaults to codex. */
@@ -25,6 +27,6 @@ export interface AgentConnectProps extends Omit<HTMLAttributes<HTMLDivElement>,
     onTabChange?: (tabId: AgentConnectTabId) => void;
     /** 返回内置目录条目的 id 和 name。Reports the built-in item id and name. */
     onSelect?: (item: AgentConnectItem) => void;
-    /** 复制成功后通知；不负责写入剪贴板。Success notification, not clipboard writing. */
+    /** 复制成功后返回代码块或完整正文。Reports copied block or full-guide text. */
     onCopy?: (text: string) => void;
 }

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/style.css

@@ -1,4 +1,4 @@
-.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-directory-tour, .ov-wiki-dashboard, .ov-experience-dashboard, .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;
@@ -35,9 +35,29 @@
   --ov-ui-overlay-default: #0006;
   --ov-ui-tooltip-bg-default: #1f2329;
   --ov-ui-tooltip-text-default: #fff;
+  --ov-ui-library-swatch-1-default: linear-gradient(145deg,
+    #ffd8ec 8%,
+    #ffabc8 46%,
+    #d8cbff 100%);
+  --ov-ui-library-swatch-2-default: linear-gradient(145deg,
+    #d9e8ff 8%,
+    #b8a6ff 52%,
+    #f3d6ff 100%);
+  --ov-ui-library-swatch-3-default: linear-gradient(145deg,
+    #ffe6bc 8%,
+    #ffaf96 48%,
+    #ff8bc5 100%);
+  --ov-ui-library-swatch-4-default: linear-gradient(145deg,
+    #eaf7ba 8%,
+    #b5efb8 52%,
+    #73d9c6 100%);
+  --ov-ui-library-swatch-5-default: linear-gradient(145deg,
+    #fff1ba 8%,
+    #ffc776 52%,
+    #bd9cff 100%);
 }
 
-.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 {
+.dark .ov-directory-tour, html.dark .ov-wiki-dashboard, html.dark .ov-experience-dashboard, .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;
@@ -91,6 +111,30 @@
   --ov-ui-connect-notice-default: var(--ov-ui-text-2-default);
 }
 
+.ov-wiki-dashboard, .ov-experience-dashboard, .ov-file-browser {
+  --ov-ui-dashboard-surface-default: #f8f8f8;
+  --ov-ui-dashboard-card-default: #fafafa;
+  --ov-ui-dashboard-muted-default: #787c91;
+  --ov-ui-dashboard-border-default: #edeef2;
+  --ov-ui-dashboard-warning-default: #eb7d00;
+  --ov-ui-dashboard-warning-light-default: #fff0e5;
+  --ov-ui-dashboard-danger-default: #d92d54;
+  --ov-ui-dashboard-danger-light-default: #ffecee;
+  --ov-ui-dashboard-success-default: #4f9c70;
+}
+
+html.dark .ov-wiki-dashboard, html.dark .ov-experience-dashboard, html.dark .ov-file-browser {
+  --ov-ui-dashboard-surface-default: var(--ov-ui-bg-3-default);
+  --ov-ui-dashboard-card-default: var(--ov-ui-bg-3-default);
+  --ov-ui-dashboard-muted-default: var(--ov-ui-text-3-default);
+  --ov-ui-dashboard-border-default: var(--ov-ui-border-1-default);
+  --ov-ui-dashboard-warning-default: var(--ov-ui-warning-default);
+  --ov-ui-dashboard-warning-light-default: var(--ov-ui-warning-light-default);
+  --ov-ui-dashboard-danger-default: var(--ov-ui-status-error-default);
+  --ov-ui-dashboard-danger-light-default: var(--ov-ui-bg-5-default);
+  --ov-ui-dashboard-success-default: var(--ov-ui-status-success-default);
+}
+
 .ov-directory-tour {
   --ov-ui-directory-tour-primary: var(--ov-ui-color-primary, var(--ov-ui-primary-default));
   --ov-ui-directory-tour-background: var(--ov-ui-color-bg-1, var(--ov-ui-bg-1-default));

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/experience-dashboard/dashboard-tabs.d.ts

@@ -0,0 +1,11 @@
+import type { ReactNode } from 'react';
+export declare function DashboardTabs<T extends string>({ tabs, active, label, onChange, children, }: {
+    tabs: readonly {
+        key: T;
+        title: string;
+    }[];
+    active: T;
+    label: string;
+    onChange: (key: T) => void;
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/components/experience-dashboard/experience-dashboard.d.ts

@@ -0,0 +1,2 @@
+import type { ExperienceDashboardProps } from './types.js';
+export declare function ExperienceDashboard(props: ExperienceDashboardProps): import("react").JSX.Element;

package/dist/components/experience-dashboard/experience-impact.d.ts

@@ -0,0 +1,11 @@
+import type { DashboardStatus } from '../../shared/dashboard/dashboard-state.js';
+import type { ExperienceDashboardData, ExperienceDashboardLabels } from './types.js';
+export declare function ExperienceImpact({ data, labels: t, days, onDaysChange, outcomesState, trajectoriesState, onOpenUri, }: {
+    data: ExperienceDashboardData;
+    labels: ExperienceDashboardLabels;
+    days: number;
+    onDaysChange: (days: number) => void;
+    outcomesState: DashboardStatus;
+    trajectoriesState: DashboardStatus;
+    onOpenUri?: (uri: string) => void;
+}): import("react").JSX.Element;

package/dist/components/experience-dashboard/experience-list.d.ts

@@ -0,0 +1,9 @@
+import type { ExperienceDashboardLabels, ExperienceItem } from './types.js';
+export declare function ExperienceList({ items, total, startIndex, locale, labels: t, onOpenUri, }: {
+    items: readonly ExperienceItem[];
+    total?: number;
+    startIndex?: number;
+    locale?: 'en-US' | 'zh-CN';
+    labels: ExperienceDashboardLabels;
+    onOpenUri?: (uri: string) => void;
+}): import("react").JSX.Element;

package/dist/components/experience-dashboard/experience-pagination.d.ts

@@ -0,0 +1,8 @@
+import type { ExperienceDashboardLabels } from './types.js';
+export declare function ExperiencePagination({ page, hasMore, loading, labels: t, onPageChange, }: {
+    page: number;
+    hasMore: boolean;
+    loading?: boolean;
+    labels: ExperienceDashboardLabels;
+    onPageChange?: (page: number) => void;
+}): import("react").JSX.Element | null;

package/dist/components/experience-dashboard/experience-tests.d.ts

@@ -0,0 +1,6 @@
+import type { ExperienceDashboardData, ExperienceDashboardLabels } from './types.js';
+export declare function ExperienceTests({ items, labels: t, onOpenUri, }: {
+    items: NonNullable<ExperienceDashboardData['testMaterials']>;
+    labels: ExperienceDashboardLabels;
+    onOpenUri?: (uri: string) => void;
+}): import("react").JSX.Element;

package/dist/components/experience-dashboard/experience-trajectories.d.ts

@@ -0,0 +1,6 @@
+import type { ExperienceTrajectory } from './types.js';
+export declare function ExperienceTrajectories({ items, onOpenUri, source, }: {
+    items: readonly ExperienceTrajectory[];
+    onOpenUri?: (uri: string) => void;
+    source?: boolean;
+}): import("react").JSX.Element;

package/dist/components/experience-dashboard/index.d.ts

@@ -0,0 +1,2 @@
+export { ExperienceDashboard } from './experience-dashboard.js';
+export type { ExperienceDashboardProps, ExperienceDashboardTab, ExperienceDashboardState, ExperienceDashboardData, ExperienceDashboardLabels, ExperienceItem, ExperienceOutcome, ExperienceTrajectory, } from './types.js';

package/dist/components/experience-dashboard/labels.d.ts

@@ -0,0 +1,2 @@
+import type { ExperienceDashboardLabels } from './types.js';
+export declare const experienceLabels: (locale?: string, labels?: Partial<ExperienceDashboardLabels>) => ExperienceDashboardLabels;