@openviking/react 0.1.3 → 0.1.5

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

@@ -1,3 +1,4 @@
 import type { AgentConnectLocale } from './types.js';
 export declare const INSTALLER_HARNESSES: Partial<Record<string, string>>;
+export declare function getInstallerCommand(harness: string, locale: AgentConnectLocale, apiKey: string, baseUrl: string): string;
 export declare function getInstallerInstructions(name: string, harness: string, locale: AgentConnectLocale, apiKey: string, baseUrl: string): string;

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

@@ -1,14 +1,12 @@
 import type { AgentConnectLocale } from './types.js';
+import type { getAgentConnectInstructions } from './agent-connect-instructions.js';
 interface InstructionsViewProps {
-    instructions: {
-        fixed: boolean;
-        display: string;
-        copy: string;
-    };
+    instructions: ReturnType<typeof getAgentConnectInstructions>;
+    apiKey: string;
     locale: AgentConnectLocale;
     agreementUrl?: string;
     onCopy?: (text: string) => void;
 }
 /** 由父视图的 key 隔离指南及凭据的复制生命周期。 */
-export declare function AgentConnectInstructionsView({ instructions, locale, agreementUrl, onCopy, }: InstructionsViewProps): import("react").JSX.Element;
+export declare function AgentConnectInstructionsView({ instructions, apiKey, locale, agreementUrl, onCopy, }: InstructionsViewProps): import("react").JSX.Element;
 export {};

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

@@ -136,10 +136,158 @@ export declare function getAgentConnectContent(locale: AgentConnectLocale): {
         markdown: string;
         guides: never[];
     };
+} | {
+    codex: {
+        name: string;
+        description: string;
+        tags: string[];
+        markdown: string;
+        guides: never[];
+    };
+    'claude-code': {
+        name: string;
+        description: string;
+        tags: string[];
+        markdown: string;
+        guides: never[];
+    };
+    doubao: {
+        name: string;
+        description: string;
+        tags: string[];
+        markdown: string;
+        guides: never[];
+    };
+    workbuddy: {
+        name: string;
+        description: string;
+        tags: string[];
+        markdown: string;
+        guides: never[];
+    };
+    trae: {
+        name: string;
+        description: string;
+        tags: string[];
+        markdown: string;
+        guides: never[];
+    };
+    cursor: {
+        name: string;
+        description: string;
+        tags: string[];
+        markdown: string;
+        guides: never[];
+    };
+    openclaw: {
+        name: string;
+        description: string;
+        tags: string[];
+        markdown: string;
+        guides: never[];
+    };
+    hermes: {
+        name: string;
+        description: string;
+        tags: string[];
+        markdown: string;
+        guides: never[];
+    };
+    opencode: {
+        name: string;
+        description: string;
+        tags: string[];
+        markdown: string;
+        guides: never[];
+    };
+    'deepseek-harness': {
+        name: string;
+        description: string;
+        tags: string[];
+        markdown: string;
+        guides: never[];
+    };
+    deerflow: {
+        name: string;
+        description: string;
+        tags: string[];
+        markdown: string;
+        guides: {
+            id: string;
+            label: string;
+            markdown: string;
+        }[];
+    };
+    pi: {
+        name: string;
+        description: string;
+        tags: string[];
+        markdown: string;
+        guides: never[];
+    };
+    zcode: {
+        name: string;
+        description: string;
+        tags: string[];
+        markdown: string;
+        guides: never[];
+    };
+    'kimi-code': {
+        name: string;
+        description: string;
+        tags: string[];
+        markdown: string;
+        guides: never[];
+    };
+    mcp: {
+        name: string;
+        description: string;
+        tags: never[];
+        markdown: string;
+        guides: never[];
+    };
+    cli: {
+        name: string;
+        description: string;
+        tags: never[];
+        markdown: string;
+        guides: {
+            id: string;
+            label: string;
+            markdown: string;
+        }[];
+    };
+    api: {
+        name: string;
+        description: string;
+        tags: never[];
+        markdown: string;
+        guides: never[];
+    };
+    sdk: {
+        name: string;
+        description: string;
+        tags: never[];
+        markdown: string;
+        guides: never[];
+    };
 };
 /** 使用回调替换，密钥中的 $& 等字符也保持原值；不递归替换注入值。 */
 export declare function getAgentConnectInstructions(id: keyof typeof contentZh, locale: AgentConnectLocale, apiKey: string, baseUrl: string, guideId?: string): {
     fixed: boolean;
     display: string;
     copy: string;
+    command: {
+        display: string;
+        copy: string;
+    };
+    markdown?: undefined;
+    keyToken?: undefined;
+} | {
+    command?: undefined;
+    fixed: boolean;
+    display: string;
+    copy: string;
+    markdown: string;
+    keyToken: string;
 };

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

@@ -0,0 +1,23 @@
+declare const messages: {
+    title: string;
+    mainstream: string;
+    custom: string;
+    integration: string;
+    instructions: string;
+    copy: string;
+    copyMarkdown: string;
+    copyCode: string;
+    showApiKey: string;
+    hideApiKey: string;
+    copied: string;
+    failed: string;
+    notice: string;
+    seeAgreement: string;
+    agreement: string;
+    apiKey: string;
+    overseas: string;
+    hermesCustomIntro: string;
+    hermesCustomStep: string;
+    installerInstructions: (name: string, command: string) => string;
+};
+export default messages;

package/dist/components/agent-connect/locales/zh-CN.d.ts

@@ -0,0 +1,3 @@
+import type enUS from './en-US.js';
+declare const messages: typeof enUS;
+export default messages;

package/dist/components/agent-connect/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,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));
@@ -409,7 +508,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;
 }
 
@@ -421,6 +520,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

@@ -1,5 +1,6 @@
+import type { Locale } from '../../shared/locale.js';
 import type { HTMLAttributes } from 'react';
-export type AgentConnectLocale = 'zh' | 'en';
+export type AgentConnectLocale = Locale;
 export type AgentConnectTabId = 'mainstream' | 'custom';
 /** 固定目录中选中的 Agent。Selected agent from the built-in catalog. */
 export interface AgentConnectItem {
@@ -10,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. */
@@ -24,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/directory-tour.d.ts

@@ -0,0 +1,3 @@
+import type { DirectoryTourProps } from './types.js';
+/** Data-free directory guidance. Unmounting a closed session resets its steps. */
+export declare function DirectoryTour(props: DirectoryTourProps): import("react").JSX.Element | null;

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

@@ -0,0 +1,3 @@
+export { DirectoryTour } from './directory-tour.js';
+export { openVikingDirectoryTourSteps } from './steps.js';
+export type { DirectoryTourProps, DirectoryTourStep, DirectoryTourTarget, DirectoryTourLabels, DirectoryTourResult, } from './types.js';

package/dist/components/directory-tour/locales/en-US.d.ts

@@ -0,0 +1,3 @@
+import type { DirectoryTourLabels } from '../types.js';
+declare const messages: Required<DirectoryTourLabels>;
+export default messages;

package/dist/components/directory-tour/locales/zh-CN.d.ts

@@ -0,0 +1,3 @@
+import type { DirectoryTourLabels } from '../types.js';
+declare const messages: Required<DirectoryTourLabels>;
+export default messages;

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

@@ -0,0 +1,5 @@
+import type { DirectoryTourStep, DirectoryTourTarget } from './types.js';
+/** Optional English preset; pass translated steps and illustrations in the host. */
+export declare const openVikingDirectoryTourSteps: readonly (DirectoryTourStep & {
+    target: DirectoryTourTarget;
+})[];