@openviking/react 0.0.0-stage → 0.1.1

package/dist/client.js

@@ -0,0 +1,239 @@
+import { jsx } from "react/jsx-runtime";
+import { createContext, useContext as external_react_useContext, useMemo } from "react";
+class OvClientError extends Error {
+    code;
+    statusCode;
+    details;
+    requestId;
+    responseBody;
+    constructor(options){
+        super(options.message, void 0 === options.cause ? void 0 : {
+            cause: options.cause
+        });
+        this.name = 'OvClientError';
+        this.code = options.code;
+        this.statusCode = options.statusCode;
+        this.details = options.details;
+        this.requestId = options.requestId;
+        this.responseBody = options.responseBody;
+    }
+}
+function isOvClientError(value) {
+    return value instanceof OvClientError;
+}
+const IDENTITY_HEADERS = {
+    apiKey: 'X-API-Key',
+    accountId: 'X-OpenViking-Account',
+    userId: 'X-OpenViking-User',
+    resourceId: 'V-Resource-Id'
+};
+async function evaluate(value) {
+    if (void 0 === value) return;
+    return 'function' == typeof value ? await value() : value;
+}
+async function resolveIdentityLayer(options) {
+    const layer = {};
+    for (const field of Object.keys(IDENTITY_HEADERS)){
+        const value = await evaluate(options?.[field]);
+        if (void 0 !== value) layer[field] = value;
+    }
+    return layer;
+}
+function mergeIdentityLayers(far, near) {
+    return {
+        ...far,
+        ...near
+    };
+}
+function toHeaders(layer) {
+    const out = {};
+    for (const field of Object.keys(IDENTITY_HEADERS)){
+        const value = layer[field]?.trim();
+        if (value) out[IDENTITY_HEADERS[field].toLowerCase()] = value;
+    }
+    return out;
+}
+function resolveClientOptions(options, identity) {
+    return {
+        baseURL: options.baseURL ?? '',
+        credentials: options.credentials ?? 'same-origin',
+        headers: toHeaders(identity),
+        signal: options.signal
+    };
+}
+function resolveRequestOptions(local, parent, mergedLayer) {
+    const headers = {
+        ...parent.headers
+    };
+    for (const field of Object.keys(IDENTITY_HEADERS)){
+        const value = mergedLayer[field];
+        if (void 0 === value) continue;
+        const name = IDENTITY_HEADERS[field].toLowerCase();
+        if (value.trim()) headers[name] = value;
+        else delete headers[name];
+    }
+    return {
+        baseURL: local?.baseURL ?? parent.baseURL,
+        credentials: parent.credentials,
+        headers,
+        signal: local?.signal ?? parent.signal
+    };
+}
+function joinUrl(baseURL, path) {
+    const prefix = baseURL.replace(/\/+$/, '');
+    return `${prefix}${path.startsWith('/') ? path : `/${path}`}`;
+}
+function buildQuery(query) {
+    if (!query) return '';
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query))if (null != value) {
+        if (Array.isArray(value)) {
+            for (const item of value)params.append(key, String(item));
+            continue;
+        }
+        params.set(key, String(value));
+    }
+    const text = params.toString();
+    return text ? `?${text}` : '';
+}
+function mergeProviderConfig(inherited, local) {
+    const declared = {};
+    if (void 0 !== local.apiKey) declared.apiKey = local.apiKey;
+    if (void 0 !== local.accountId) declared.accountId = local.accountId;
+    if (void 0 !== local.userId) declared.userId = local.userId;
+    if (void 0 !== local.resourceId) declared.resourceId = local.resourceId;
+    return {
+        baseURL: local.baseURL ?? inherited?.baseURL,
+        credentials: local.credentials ?? inherited?.credentials,
+        signal: local.signal ?? inherited?.signal,
+        fetch: local.fetch ?? inherited?.fetch,
+        identity: {
+            ...inherited?.identity,
+            ...declared
+        }
+    };
+}
+function isRecord(value) {
+    return 'object' == typeof value && null !== value && !Array.isArray(value);
+}
+function readEnvelope(value) {
+    return isRecord(value) ? value : {};
+}
+function isAbortError(error) {
+    return isRecord(error) && ('AbortError' === error.name || 'ABORT_ERR' === error.code);
+}
+function normalizeTransportError(error, signal) {
+    if (isAbortError(error) || signal?.aborted) throw error;
+    throw new OvClientError({
+        code: 'NETWORK_ERROR',
+        message: error instanceof Error ? error.message : 'Network request failed',
+        cause: error
+    });
+}
+function createOvClient(options = {}) {
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    if (!fetchImpl) throw new Error('createOvClient needs a fetch implementation. Pass `fetch` on platforms without a global one.');
+    const defaults = options;
+    const client = {
+        get baseURL () {
+            return defaults.baseURL ?? '';
+        },
+        async request (spec) {
+            const baseLayer = await resolveIdentityLayer(defaults);
+            const localLayer = await resolveIdentityLayer(spec.options);
+            const parent = resolveClientOptions(defaults, baseLayer);
+            const effective = resolveRequestOptions(spec.options, parent, mergeIdentityLayers(baseLayer, localLayer));
+            const url = joinUrl(effective.baseURL, spec.path) + buildQuery(spec.query);
+            const hasBody = void 0 !== spec.body;
+            const headers = hasBody ? {
+                'content-type': 'application/json',
+                ...effective.headers
+            } : effective.headers;
+            let response;
+            try {
+                response = await fetchImpl(url, {
+                    method: spec.method,
+                    headers,
+                    body: hasBody ? JSON.stringify(spec.body) : void 0,
+                    credentials: effective.credentials,
+                    signal: effective.signal
+                });
+            } catch (error) {
+                normalizeTransportError(error, effective.signal);
+            }
+            let raw;
+            try {
+                raw = await response.text();
+            } catch (error) {
+                normalizeTransportError(error, effective.signal);
+            }
+            let body;
+            if (raw.trim()) try {
+                body = JSON.parse(raw);
+            } catch  {
+                body = raw;
+            }
+            const envelope = readEnvelope(body);
+            const requestId = response.headers.get('x-request-id') ?? void 0;
+            if (!response.ok) throw new OvClientError({
+                code: envelope.error?.code ?? `HTTP_${response.status}`,
+                message: envelope.error?.message ?? response.statusText,
+                statusCode: response.status,
+                details: envelope.error?.details,
+                requestId,
+                responseBody: body
+            });
+            if ('error' === envelope.status) throw new OvClientError({
+                code: envelope.error?.code ?? 'UNKNOWN',
+                message: envelope.error?.message ?? 'Request failed',
+                statusCode: response.status,
+                details: envelope.error?.details,
+                requestId,
+                responseBody: body
+            });
+            return 'result' in envelope ? envelope.result : body;
+        }
+    };
+    return client;
+}
+const OvClientContext = /*#__PURE__*/ createContext(null);
+function OpenVikingProvider({ baseURL, apiKey, accountId, userId, resourceId, credentials, signal, fetch, children }) {
+    const parent = external_react_useContext(OvClientContext);
+    const value = useMemo(()=>{
+        const base = mergeProviderConfig(parent?.base, {
+            baseURL,
+            apiKey,
+            accountId,
+            userId,
+            resourceId,
+            credentials,
+            signal,
+            fetch
+        });
+        return {
+            base,
+            client: createOvClient({
+                ...base.identity,
+                baseURL: base.baseURL,
+                credentials: base.credentials,
+                signal: base.signal,
+                fetch: base.fetch
+            })
+        };
+    }, [
+        parent,
+        baseURL,
+        apiKey,
+        accountId,
+        userId,
+        resourceId,
+        credentials,
+        signal,
+        fetch
+    ]);
+    return /*#__PURE__*/ jsx(OvClientContext.Provider, {
+        value: value,
+        children: children
+    });
+}
+export { OpenVikingProvider, OvClientError, createOvClient, isOvClientError };

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

@@ -0,0 +1,4 @@
+import type { AgentConnectProps } from './types.js';
+export type { AgentConnectDetail, AgentConnectItem, AgentConnectLabels, AgentConnectProps, AgentConnectTab, } from './types.js';
+/** 占位组件：仅渲染固定尺寸的空壳，真实实现按 props 契约重写。 */
+export declare function AgentConnect(_props: AgentConnectProps): import("react").JSX.Element;

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

@@ -0,0 +1 @@
+export * from './agent-connect.js';

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

@@ -0,0 +1,16 @@
+.ov-agent-connect {
+  box-sizing: border-box;
+  border-radius: var(--ov-ui-radius, 6px);
+  background: var(--ov-ui-placeholder, #f3f4f7);
+  width: 960px;
+  height: 640px;
+  color: var(--ov-ui-text-muted, #8f959e);
+  justify-content: center;
+  align-items: center;
+  font-family: inherit;
+  font-size: 12px;
+  display: flex;
+}
+
+
+

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

@@ -0,0 +1,175 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+/**
+ * 顶部的一个接入分组，例如「接入主流 Agent」「接入应用」「开发自己的 Agent」。
+ * 分组名称与数量由宿主决定，组件只按顺序渲染页签。
+ *
+ * One tab of the view, for example "Mainstream agents", "Apps" or "Build your
+ * own agent". The host decides how many groups exist and what they are called;
+ * the component renders them in order.
+ */
+export interface AgentConnectTab {
+    /**
+     * 页签唯一标识。
+     * Unique tab key.
+     */
+    id: string;
+    /**
+     * 页签显示文本。
+     * Tab label.
+     */
+    label: string;
+}
+/**
+ * 左侧列表中的一个条目，例如某个 Agent 或某种接入方式。
+ *
+ * One entry in the left list, for example an agent or an access method.
+ */
+export interface AgentConnectItem {
+    /**
+     * 条目唯一标识。
+     * Unique item key.
+     */
+    id: string;
+    /**
+     * 条目名称。
+     * Item name.
+     */
+    name: string;
+    /**
+     * 列表中的一句话说明。
+     * One-line summary shown in the list.
+     */
+    description?: string;
+    /**
+     * 条目图标，可以是图片或图标节点。
+     * Item icon, which can be an image or an icon node.
+     */
+    icon?: ReactNode;
+}
+/**
+ * 右侧详情的正文。正文由宿主提供，组件只负责排版与复制，不解析业务含义。
+ *
+ * The detail body. The host supplies it; the component only lays it out and
+ * copies it, without interpreting its meaning.
+ */
+export interface AgentConnectDetail {
+    /**
+     * 详情标题，通常与选中条目同名。
+     * Detail title, usually the selected item's name.
+     */
+    title?: string;
+    /**
+     * 标题旁的图标。
+     * Icon shown next to the title.
+     */
+    icon?: ReactNode;
+    /**
+     * 标题下方的说明文字。
+     * Description under the title.
+     */
+    description?: string;
+    /**
+     * 标题下方的标签，例如「SDK」「境外」。
+     * Tags under the title, for example "SDK" or "Overseas".
+     */
+    tags?: readonly string[];
+    /**
+     * 正文内容，可以是 Markdown 渲染后的节点。
+     * Body content, which can be the rendered Markdown node.
+     */
+    content?: ReactNode;
+    /**
+     * 复制按钮要写入剪贴板的纯文本。组件负责写入并提示成功；不传时不渲染复制按钮。
+     * Plain text the copy control writes to the clipboard. The component performs
+     * the write and reports success; no copy control is rendered when omitted.
+     */
+    copyText?: string;
+}
+/**
+ * 可替换文案，组件内置英文默认值。
+ * Replaceable copy; the component ships English defaults.
+ */
+export interface AgentConnectLabels {
+    /**
+     * 正文区域的标题，例如「完整指令」。
+     * Heading of the body area, for example "Complete instructions".
+     */
+    instructions?: string;
+    /**
+     * 复制按钮文案。
+     * Copy control label.
+     */
+    copy?: string;
+    /**
+     * 复制成功后的提示。
+     * Message shown after a successful copy.
+     */
+    copied?: string;
+    /**
+     * 没有条目时的提示。
+     * Message shown when there are no items.
+     */
+    empty?: string;
+}
+/**
+ * Agent 接入视图的公开接口。
+ *
+ * 组件只渲染页签、左侧列表与右侧详情，并上报切换与复制意图；目录数据、正文
+ * 内容、权限与跳转都由宿主提供。
+ *
+ * Public interface of the agent connection view.
+ *
+ * The component renders the tabs, the left list and the right detail, and
+ * reports switch and copy intent. Catalog data, body content, permissions and
+ * navigation all come from the host.
+ */
+export interface AgentConnectProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onSelect' | 'onCopy'> {
+    /**
+     * 顶部页签。
+     * Tabs at the top.
+     */
+    tabs: readonly AgentConnectTab[];
+    /**
+     * 当前页签 id，由宿主持有。
+     * Active tab id, owned by the host.
+     */
+    activeTabId: string;
+    /**
+     * 当前页签下的条目，按宿主给定顺序渲染。
+     * Items of the active tab, rendered in the order the host gives.
+     */
+    items: readonly AgentConnectItem[];
+    /**
+     * 当前选中条目 id，由宿主持有。
+     * Selected item id, owned by the host.
+     */
+    selectedId?: string;
+    /**
+     * 当前选中条目的详情。不传时右侧不渲染正文。
+     * Detail of the selected item. No body is rendered when omitted.
+     */
+    detail?: AgentConnectDetail;
+    /**
+     * 切换页签时触发。
+     * Invoked when a tab is selected.
+     */
+    onTabChange?: (tabId: string) => void;
+    /**
+     * 选中一个条目时触发。
+     * Invoked when an item is selected.
+     */
+    onSelect?: (item: AgentConnectItem) => void;
+    /**
+     * 复制成功后触发，用于埋点或额外反馈。复制本身由组件完成，回调不承担写入。
+     * 不传时仍渲染复制按钮，只是不通知。
+     * Invoked after the body has been copied, for analytics or extra feedback.
+     * The component performs the write; this callback never does. The copy
+     * control still renders when omitted, it just reports nothing.
+     */
+    onCopy?: (text: string) => void;
+    /**
+     * 可替换文案，缺省为英文。
+     * Replaceable copy; English by default.
+     */
+    labels?: AgentConnectLabels;
+}

package/dist/components/agent-connect.js

@@ -0,0 +1 @@
+export { AgentConnect } from "../u~0.js";

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

@@ -0,0 +1,15 @@
+import type { FilePreviewContentTab, FilePreviewFileTab, FilePreviewLabels } from './types.js';
+export interface FilePreviewBodyProps {
+    fileTab?: FilePreviewFileTab;
+    contentTab?: FilePreviewContentTab;
+    text: Required<FilePreviewLabels>;
+    editing: boolean;
+    loadingEdit: boolean;
+    editFailed: boolean;
+    saving: boolean;
+    saveFailed: boolean;
+    draft: string;
+    onDraftChange: (value: string) => void;
+}
+/** 内容区：内容页签原样渲染，文件页签按编辑态、取正文状态与文本降级依次分支。 */
+export declare function FilePreviewBody({ fileTab, contentTab, text, editing, loadingEdit, editFailed, saving, saveFailed, draft, onDraftChange, }: FilePreviewBodyProps): string | number | bigint | boolean | import("react").JSX.Element | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | Iterable<import("react").ReactNode> | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | import("react").ReactPortal | null | undefined> | null | undefined;

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

@@ -0,0 +1,16 @@
+import type { FilePreviewFileTab, FilePreviewLabels, FilePreviewTab } from './types.js';
+export interface FilePreviewHeaderProps {
+    activeTab: FilePreviewTab;
+    fileTab?: FilePreviewFileTab;
+    text: Required<FilePreviewLabels>;
+    viewMode: 'preview' | 'source';
+    editing: boolean;
+    loadingEdit: boolean;
+    saving: boolean;
+    onViewModeChange: (mode: 'preview' | 'source') => void;
+    onEditStart: () => void;
+    onEditCancel: () => void;
+    onEditSave: () => void;
+}
+/** 内容区标题行：路径面包屑、复制、视图切换、编辑与页签级插槽。 */
+export declare function FilePreviewHeader({ activeTab, fileTab, text, viewMode, editing, loadingEdit, saving, onViewModeChange, onEditStart, onEditCancel, onEditSave, }: FilePreviewHeaderProps): import("react").JSX.Element;

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

@@ -0,0 +1,2 @@
+export declare function FileIcon(): import("react").JSX.Element;
+export declare function CopyIcon(): import("react").JSX.Element;

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

@@ -0,0 +1,5 @@
+import type { FilePreviewFileTab, FilePreviewLabels } from './types.js';
+/** 组件内置文案，宿主可通过面板或页签级 `labels` 覆盖。 */
+export declare const DEFAULT_LABELS: Required<FilePreviewLabels>;
+/** 从文件页签的 `source` 里取出可复制的纯文本；拿不到时返回 `undefined`。 */
+export declare function readCopyableText(tab: FilePreviewFileTab): string | undefined;

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

@@ -0,0 +1 @@
+export declare function performPreviewOperation(execute: (() => Promise<void>) | undefined, notify: (() => void) | undefined): Promise<void>;

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

@@ -0,0 +1,17 @@
+import type { FilePreviewComponent } from './types.js';
+export type { FilePreviewComponent, FilePreviewContentTab, FilePreviewEditing, FilePreviewFileTab, FilePreviewFileTabSlots, FilePreviewHandle, FilePreviewHeaderSlots, FilePreviewLabels, FilePreviewOperations, FilePreviewProps, FilePreviewSource, FilePreviewTab, FilePreviewTabBase, } from './types.js';
+/**
+ * 文件预览的占位实现。
+ *
+ * 外壳（页签行、内容区标题行、页签切换与 ref 句柄）按最终形态实现，可直接
+ * 交互；文件正文尚未接入 FileViewer，文件页签先以纯文本降级展示，内容页签
+ * 按宿主给的节点渲染。
+ *
+ * Placeholder implementation of the file preview.
+ *
+ * The shell — tab row, content header row, tab switching and the ref handle — is
+ * implemented as it will ship and is fully interactive. The file body is not
+ * wired to FileViewer yet: a file tab falls back to plain text, while a content
+ * tab renders the node the host supplies.
+ */
+export declare const FilePreview: FilePreviewComponent;

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

@@ -0,0 +1 @@
+export * from './file-preview.js';