clickgo 7.3.1 → 7.4.0

package/dist/lib/command/file.d.ts

@@ -0,0 +1,87 @@
+/** --- 文件读取命令由框架保留，网页、WebMCP 和 Native 使用相同入口 --- */
+export declare const READ_COMMAND = "clickgo.file.read";
+/** --- 默认及最大分段大小，单位为原始字节 --- */
+export declare const DEFAULT_CHUNK_BYTES = 49152;
+export declare const MAX_CHUNK_BYTES = 393216;
+/** --- 命令执行范围；文件随所属 Panel、Form 或 App 销毁 --- */
+export interface IOwner {
+    'taskId': string;
+    'formId': string;
+    'panelId': string;
+}
+/** --- 发布的是已生成 Blob，不读取路径、不上传或重新生成文件 --- */
+export interface IFileOptions {
+    'fileName': string;
+    /** --- 默认使用 Blob.type；为空时使用 application/octet-stream --- */
+    'mimeType'?: string;
+}
+/** --- 文件快照元数据；时间为 Unix 毫秒，URI 仅在所属页面生命周期内有效 --- */
+export interface IFileInfo {
+    'fileId': string;
+    'fileName': string;
+    'mimeType': string;
+    'byteLength': number;
+    'createdAt': number;
+    'expiresAt': number;
+    'uri': string;
+    'readCommand': string;
+    'readChunkSize': number;
+}
+/** --- offset/length 使用原始字节；逐段解码 Base64，nextOffset 为 null 时结束 --- */
+export interface IFileReadOptions {
+    'offset'?: number;
+    'length'?: number;
+    'signal'?: AbortSignal;
+}
+/** --- 每段携带同一份快照信息，便于客户端校验文件及交付状态 --- */
+export interface IFileChunk {
+    'file': IFileInfo;
+    'offset': number;
+    'nextOffset': number | null;
+    'encoding': 'base64';
+    'data': string;
+}
+/**
+ * --- 建立尚未对代理公开的文件快照，由命令成功结果决定是否交付 ---
+ * @param owner 已通过命令生命周期检查的所属范围
+ * @param blob 应用已生成的文件内容，最多 64 MiB；同一 App 最多保留 8 份、合计 128 MiB
+ * @param options 文件名及 MIME
+ * @returns 十分钟有效的独立元数据；参数、容量或计时器不可用时返回 false
+ */
+export declare function create(owner: IOwner, blob: Blob, options: IFileOptions): IFileInfo | false;
+/**
+ * --- 按内部快照校验所有文件，再一次性标记命令交付，拒绝伪造或跨 App 句柄 ---
+ * @param taskId 当前命令所属 App
+ * @param requested 业务结果声明的文件
+ * @param exposed 当前命令是否允许代理调用
+ * @returns 可信的独立元数据；任一文件已失效或不属于本 App 时返回 false
+ */
+export declare function commit(taskId: string, requested: IFileInfo[], exposed: boolean): IFileInfo[] | false;
+/**
+ * --- 只读取已由公开命令交付的文件；异步读取后再次核对取消、到期及销毁 ---
+ * @param taskId 所属 App
+ * @param fileId 文件标识
+ * @param options 分段范围及取消信号
+ * @returns 不可变文件的 Base64 字节段；不可用或范围错误返回 false
+ */
+export declare function read(taskId: string, fileId: string, options?: IFileReadOptions): Promise<IFileChunk | false>;
+/**
+ * --- 释放一个文件及其到期计时器 ---
+ * @param taskId 所属 App
+ * @param fileId 文件标识
+ * @returns 无返回值
+ */
+export declare function remove(taskId: string, fileId: string): void;
+/**
+ * --- 应用主动释放自己所属范围的旧文件，不影响其他 Form 或 Panel ---
+ * @param owner 调用者所属范围，App 级对象可管理整个 App
+ * @param fileId 要释放的缓存句柄，不是文件路径
+ * @returns 是否找到并释放文件，已释放或范围不符为 false
+ */
+export declare function release(owner: IOwner, fileId: string): boolean;
+/**
+ * --- 随命令所属范围销毁文件，Panel 不影响同 Form 的其他文件 ---
+ * @param owner 要清理的任务、Form 或 Panel
+ * @returns 无返回值
+ */
+export declare function clear(owner: IOwner): void;

package/dist/lib/command/runtime.d.ts

@@ -0,0 +1,37 @@
+import type * as lCore from '../core';
+import type * as lTask from '../task';
+import type * as lNative from '../native';
+import type * as lFile from './file';
+import type * as lData from './data';
+import type * as lWebMcp from './webmcp';
+import type * as lGuide from './guide';
+import type * as lTool from '../tool';
+/** --- 命令运行时所需的框架机制；不自行创建任务、授权窗口或 Native 服务 --- */
+export interface IRuntimeOptions {
+    /** --- 页面接入状态变化通知，沿用框架全局事件 --- */
+    'core': Pick<typeof lCore, 'trigger'>;
+    /** --- 实时任务状态、任务发现及已有权限检查 --- */
+    'task': Pick<typeof lTask, 'getOrigin' | 'getList' | 'checkPermission'>;
+    /** --- Native 接入发现及显式、受权限保护的凭据导出 --- */
+    'native': Pick<typeof lNative, 'getCommandEntry' | 'getMcpInfo'>;
+    /** --- 文件句柄与容量、分段、有效期及所属范围契约 --- */
+    'files': typeof lFile;
+    /** --- 输入、元数据和结果的校验与独立快照 --- */
+    'data': typeof lData;
+    /** --- 公开命令的浏览器发布及撤销机制 --- */
+    'webMcp': Pick<typeof lWebMcp, 'create'>;
+    /** --- 从接入信息生成说明，不主动读取凭据 --- */
+    'guide': Pick<typeof lGuide, 'format'>;
+}
+/** --- 文件缓存的外部机制与公开读取协议；每次创建得到独立缓存 --- */
+export interface IFileStoreOptions {
+    /** --- 文件随所属 App/Form 生命周期清理的框架计时器 --- */
+    'task': Pick<typeof lTask, 'createTimer' | 'removeTimer'>;
+    /** --- 把有界 Blob 分段编码为 Data URL，结果只取 Base64 数据部分 --- */
+    'tool': Pick<typeof lTool, 'blob2DataUrl'>;
+    /** --- 交付元数据中的框架读取命令名 --- */
+    'readCommand': string;
+    /** --- 默认读取长度与单段上限，单位为原始字节 --- */
+    'defaultChunkBytes': number;
+    'maxChunkBytes': number;
+}

package/dist/lib/command/types.d.ts

@@ -0,0 +1,161 @@
+import type * as lTool from '../tool';
+import type * as lFile from './file';
+import type * as lNative from '../native';
+/** --- 命令输入与输出可跨浏览器、Native 和协议传输的 JSON 值 --- */
+export type TJson = lTool.TJson;
+/** --- JSON Schema 2020-12 的命令校验子集；不支持的关键字在注册时拒绝 --- */
+export interface ISchema {
+    '$schema'?: string;
+    '$ref'?: string;
+    '$defs'?: Record<string, ISchema | boolean>;
+    'title'?: string;
+    'description'?: string;
+    'default'?: TJson;
+    'examples'?: TJson[];
+    'type'?: 'object' | 'array' | 'string' | 'number' | 'integer' | 'boolean' | 'null';
+    'properties'?: Record<string, ISchema | boolean>;
+    'required'?: string[];
+    'additionalProperties'?: ISchema | boolean;
+    'items'?: ISchema | boolean;
+    'minItems'?: number;
+    'maxItems'?: number;
+    'uniqueItems'?: boolean;
+    'minLength'?: number;
+    'maxLength'?: number;
+    'pattern'?: string;
+    'minimum'?: number;
+    'maximum'?: number;
+    'exclusiveMinimum'?: number;
+    'exclusiveMaximum'?: number;
+    'enum'?: TJson[];
+    'const'?: TJson;
+    'allOf'?: Array<ISchema | boolean>;
+    'anyOf'?: Array<ISchema | boolean>;
+    'oneOf'?: Array<ISchema | boolean>;
+    'not'?: ISchema | boolean;
+}
+/** --- 所有入口共用的结果；错误码用于程序判断，message 用于说明 --- */
+export type TResult<T extends TJson = TJson> = {
+    'ok': true;
+    'data': T;
+    'files'?: lFile.IFileInfo[];
+} | {
+    'ok': false;
+    'error': {
+        'code': string;
+        'message': string;
+    };
+};
+/** --- 执行来源仅用于展示与记录，不是授权凭证 --- */
+export interface IContext {
+    'taskId': string;
+    'formId': string;
+    'panelId': string;
+    'source': 'user' | 'agent';
+    'signal': AbortSignal;
+    /**
+     * --- 保留已生成文件；用 success(data, [file]) 明确交付，不读取路径或重新生成 ---
+     * @param blob 原文件，单份最多 64 MiB；每个 App 最多 8 份、合计 128 MiB
+     * @param options 文件名及可选 MIME，默认使用 Blob.type 或 application/octet-stream
+     * @returns 十分钟有效的独立句柄，随所属范围销毁；参数/容量无效返回 false
+     * 仅在本次执行中有效；失败、取消、无效输出及未交付的文件自动释放，私有命令不公开文件
+     */
+    'createFile': (blob: Blob, options: lFile.IFileOptions) => lFile.IFileInfo | false;
+}
+/** --- 与 MCP 工具描述对齐的公开命令元数据 --- */
+export interface IMetadata {
+    'name': string;
+    'title'?: string;
+    'description': string;
+    'inputSchema': ISchema & {
+        'type': 'object';
+    };
+    'outputSchema'?: ISchema;
+    /** --- 行为说明，不代替校验或授权 --- */
+    'annotations'?: {
+        'readOnlyHint'?: boolean;
+        'destructiveHint'?: boolean;
+        'idempotentHint'?: boolean;
+        'openWorldHint'?: boolean;
+        /** --- WebMCP 的重要或不可逆现实效果说明 --- */
+        'consequentialHint'?: boolean;
+        'untrustedContentHint'?: boolean;
+    };
+}
+/** --- 应用声明一次，界面、浏览器代理和 Native 适配器共享执行函数 --- */
+export interface IDefinition<T extends Record<string, TJson> = Record<string, TJson>> extends IMetadata {
+    /** --- 明确允许代理发现并调用；默认只允许应用内部调用 --- */
+    'exposed'?: boolean;
+    /** --- 默认拒绝同一命令并发；业务确认可并行时才开启 --- */
+    'concurrent'?: boolean;
+    /** --- 必须已经取得的框架权限；执行入口不弹授权窗 --- */
+    'permissions'?: string[];
+    /** --- true 为可用，false 或原因文本为不可用；每次执行重新检查 --- */
+    'enabled'?: () => boolean | string;
+    'execute': (args: T, context: IContext) => TResult | Promise<TResult>;
+}
+/** --- 不包含函数或内部对象的独立快照 --- */
+export interface IInfo extends IMetadata {
+    'taskId': string;
+    'formId': string;
+    'panelId': string;
+    'exposed': boolean;
+    'enabled': boolean;
+    'disabledReason': string;
+    'running': number;
+}
+/** --- 绑定一个应用实例，只能调用该实例明确公开的命令 --- */
+export interface IBridge {
+    'taskId': string;
+    'list': () => IInfo[];
+    'execute': (name: string, args?: Record<string, TJson>, options?: {
+        'signal'?: AbortSignal;
+    }) => Promise<TResult>;
+}
+/** --- 框架向网页发布的统一入口；按任务选择应用，只访问明确公开的命令 --- */
+export interface IPageBridge {
+    'getAgentInfo': (taskId?: string) => Promise<IAgentInfo | null | false>;
+    'getAgentGuide': (taskId?: string) => Promise<string | null | false>;
+    'listTasks': () => Array<{
+        'id': string;
+        'name': string;
+    }>;
+    'list': (taskId: string) => IInfo[];
+    'execute': (taskId: string, name: string, args?: Record<string, TJson>, options?: {
+        'signal'?: AbortSignal;
+    }) => Promise<TResult>;
+}
+/** --- 统一接入说明的生成选项；默认不读取或包含 HTTP 凭据 --- */
+export interface IAgentOptions {
+    /** --- 仅供应用主动导出 HTTP 连接设置，仍要求当前 App 已有 root 权限 --- */
+    'includeMcpCredentials'?: boolean;
+}
+/** --- 页面级 WebMCP 接入状态；ready 表示浏览器接口可用，不表示某个 App 的工具已发布 --- */
+export type TWebMcpStatus = 'unsupported' | 'ready';
+/** --- 工具发布诊断状态，不参与页面级接入事件 --- */
+export type TWebMcpRegistrationStatus = 'idle' | 'registering' | 'ready' | 'failed';
+/** --- 可展示或导出的接入信息；命令列表始终从对应入口实时查询 --- */
+export interface IAgentInfo {
+    'schemaVersion': 1;
+    'apps': Array<{
+        'id': string;
+        'name': string;
+    }>;
+    'targetTaskId': string | null;
+    'browser': {
+        'url': string | null;
+        'api': string;
+    };
+    'webMcp': {
+        'supported': boolean;
+        /** --- 全页面共用的浏览器接入状态，不受目标 App 或工具数量影响 --- */
+        'status': TWebMcpStatus;
+        /** --- 所选 App 的发布诊断；多个 App 时优先报告失败及进行中的注册，不支持时为 null --- */
+        'registrationStatus': TWebMcpRegistrationStatus | null;
+        /** --- 已完成工具发布的 App，不表示这些 App 分别建立了浏览器连接 --- */
+        'publishedTaskIds': string[];
+    };
+    'native': lNative.ICommandEntry | null;
+    /** --- 只有显式导出且通过 root 检查时才包含 HTTP 凭据 --- */
+    'http': lNative.IMcpInfo | null;
+}

package/dist/lib/command.d.ts

@@ -1,153 +1,9 @@
 import * as lCore from './core';
-import * as lTool from './tool';
-import * as lNative from './native';
+import * as lFile from './command/file';
+import type { TJson, TResult, IDefinition, IInfo, IAgentOptions, IAgentInfo, IBridge, IPageBridge } from './command/types';
 export { showPalette } from './command/palette';
-/** --- 命令输入与输出可跨浏览器、Native 和协议传输的 JSON 值 --- */
-export type TJson = lTool.TJson;
-/** --- JSON Schema 2020-12 的命令校验子集；不支持的关键字在注册时拒绝 --- */
-export interface ISchema {
-    '$schema'?: string;
-    '$ref'?: string;
-    '$defs'?: Record<string, ISchema | boolean>;
-    'title'?: string;
-    'description'?: string;
-    'default'?: TJson;
-    'examples'?: TJson[];
-    'type'?: 'object' | 'array' | 'string' | 'number' | 'integer' | 'boolean' | 'null';
-    'properties'?: Record<string, ISchema | boolean>;
-    'required'?: string[];
-    'additionalProperties'?: ISchema | boolean;
-    'items'?: ISchema | boolean;
-    'minItems'?: number;
-    'maxItems'?: number;
-    'uniqueItems'?: boolean;
-    'minLength'?: number;
-    'maxLength'?: number;
-    'pattern'?: string;
-    'minimum'?: number;
-    'maximum'?: number;
-    'exclusiveMinimum'?: number;
-    'exclusiveMaximum'?: number;
-    'enum'?: TJson[];
-    'const'?: TJson;
-    'allOf'?: Array<ISchema | boolean>;
-    'anyOf'?: Array<ISchema | boolean>;
-    'oneOf'?: Array<ISchema | boolean>;
-    'not'?: ISchema | boolean;
-}
-/** --- 所有入口共用的结果；错误码用于程序判断，message 用于说明 --- */
-export type TResult<T extends TJson = TJson> = {
-    'ok': true;
-    'data': T;
-} | {
-    'ok': false;
-    'error': {
-        'code': string;
-        'message': string;
-    };
-};
-/** --- 执行来源仅用于展示与记录，不是授权凭证 --- */
-export interface IContext {
-    'taskId': string;
-    'formId': string;
-    'panelId': string;
-    'source': 'user' | 'agent';
-    'signal': AbortSignal;
-}
-/** --- 与 MCP 工具描述对齐的公开命令元数据 --- */
-export interface IMetadata {
-    'name': string;
-    'title'?: string;
-    'description': string;
-    'inputSchema': ISchema & {
-        'type': 'object';
-    };
-    'outputSchema'?: ISchema;
-    /** --- 行为说明，不代替校验或授权 --- */
-    'annotations'?: {
-        'readOnlyHint'?: boolean;
-        'destructiveHint'?: boolean;
-        'idempotentHint'?: boolean;
-        'openWorldHint'?: boolean;
-        /** --- WebMCP 的重要或不可逆现实效果说明 --- */
-        'consequentialHint'?: boolean;
-        'untrustedContentHint'?: boolean;
-    };
-}
-/** --- 应用声明一次，界面、浏览器代理和 Native 适配器共享执行函数 --- */
-export interface IDefinition<T extends Record<string, TJson> = Record<string, TJson>> extends IMetadata {
-    /** --- 明确允许代理发现并调用；默认只允许应用内部调用 --- */
-    'exposed'?: boolean;
-    /** --- 默认拒绝同一命令并发；业务确认可并行时才开启 --- */
-    'concurrent'?: boolean;
-    /** --- 必须已经取得的框架权限；执行入口不弹授权窗 --- */
-    'permissions'?: string[];
-    /** --- true 为可用，false 或原因文本为不可用；每次执行重新检查 --- */
-    'enabled'?: () => boolean | string;
-    'execute': (args: T, context: IContext) => TResult | Promise<TResult>;
-}
-/** --- 不包含函数或内部对象的独立快照 --- */
-export interface IInfo extends IMetadata {
-    'taskId': string;
-    'formId': string;
-    'panelId': string;
-    'exposed': boolean;
-    'enabled': boolean;
-    'disabledReason': string;
-    'running': number;
-}
-/** --- 绑定一个应用实例，只能调用该实例明确公开的命令 --- */
-export interface IBridge {
-    'taskId': string;
-    'list': () => IInfo[];
-    'execute': (name: string, args?: Record<string, TJson>, options?: {
-        'signal'?: AbortSignal;
-    }) => Promise<TResult>;
-}
-/** --- 框架向网页发布的统一入口；按任务选择应用，只访问明确公开的命令 --- */
-export interface IPageBridge {
-    'getAgentInfo': (taskId?: string) => Promise<IAgentInfo | null | false>;
-    'getAgentGuide': (taskId?: string) => Promise<string | null | false>;
-    'listTasks': () => Array<{
-        'id': string;
-        'name': string;
-    }>;
-    'list': (taskId: string) => IInfo[];
-    'execute': (taskId: string, name: string, args?: Record<string, TJson>, options?: {
-        'signal'?: AbortSignal;
-    }) => Promise<TResult>;
-}
-/** --- 统一接入说明的生成选项；默认不读取或包含 HTTP 凭据 --- */
-export interface IAgentOptions {
-    /** --- 仅供应用主动导出 HTTP 连接设置，仍要求当前 App 已有 root 权限 --- */
-    'includeMcpCredentials'?: boolean;
-}
-/** --- 页面级 WebMCP 接入状态；ready 表示浏览器接口可用，不表示某个 App 的工具已发布 --- */
-export type TWebMcpStatus = 'unsupported' | 'ready';
-/** --- 工具发布诊断状态，不参与页面级接入事件 --- */
-export type TWebMcpRegistrationStatus = 'idle' | 'registering' | 'ready' | 'failed';
-/** --- 可展示或导出的接入信息；命令列表始终从对应入口实时查询 --- */
-export interface IAgentInfo {
-    'schemaVersion': 1;
-    'apps': ReturnType<typeof listTasks>;
-    'targetTaskId': string | null;
-    'browser': {
-        'url': string | null;
-        'api': string;
-    };
-    'webMcp': {
-        'supported': boolean;
-        /** --- 全页面共用的浏览器接入状态，不受目标 App 或工具数量影响 --- */
-        'status': TWebMcpStatus;
-        /** --- 所选 App 的发布诊断；多个 App 时优先报告失败及进行中的注册，不支持时为 null --- */
-        'registrationStatus': TWebMcpRegistrationStatus | null;
-        /** --- 已完成工具发布的 App，不表示这些 App 分别建立了浏览器连接 --- */
-        'publishedTaskIds': string[];
-    };
-    'native': lNative.ICommandEntry | null;
-    /** --- 只有显式导出且通过 root 检查时才包含 HTTP 凭据 --- */
-    'http': lNative.IMcpInfo | null;
-}
+export type { IFileInfo, IFileOptions, IFileChunk } from './command/file';
+export type { TJson, ISchema, TResult, IContext, IMetadata, IDefinition, IInfo, IBridge, IPageBridge, IAgentOptions, TWebMcpStatus, TWebMcpRegistrationStatus, IAgentInfo, } from './command/types';
 /**
  * --- 初始化页面级 WebMCP 接入状态，由框架在执行 Boot.main 前自动调用 ---
  * @returns 无返回值
@@ -156,9 +12,10 @@ export declare function init(): void;
 /**
  * --- 构造成功结果 ---
  * @param data 可跨入口传输的 JSON 数据
+ * @param files 本次命令明确交付的框架文件，可省略；不能传入其他 App 的文件
  * @returns 成功结果
  */
-export declare function success<T extends TJson>(data: T): TResult<T>;
+export declare function success<T extends TJson>(data: T, files?: lFile.IFileInfo[]): TResult<T>;
 /**
  * --- 构造业务失败结果，不抛异常 ---
  * @param code 稳定的业务错误码
@@ -166,6 +23,13 @@ export declare function success<T extends TJson>(data: T): TResult<T>;
  * @returns 失败结果
  */
 export declare function failure(code: string, message: string): TResult<never>;
+/**
+ * --- 主动释放旧导出的缓存，释放后代理不能继续读取；不删除磁盘文件 ---
+ * @param current 文件所属的 App/Form/Panel，Form/Panel 只能释放自身范围
+ * @param fileId 先前交付的文件标识
+ * @returns 是否找到并释放，已释放或不属于当前范围为 false
+ */
+export declare function releaseFile(current: lCore.TCurrent, fileId: string): boolean;
 /**
  * --- 注册命令；重复名称、不支持的 schema 或已销毁的实例返回 false ---
  * @param current 所属任务/Form/Panel；销毁时自动移除其命令
@@ -257,9 +121,12 @@ export declare function createBridge(current: lCore.TCurrent): IBridge;
  */
 export declare function createPageBridge(): IPageBridge;
 /**
- * --- 显式重同步或重试当前 App 的工具发布；页面接入由框架自动管理 ---
+ * --- 手动将当前 App 已公开的命令发布到浏览器 WebMCP ---
+ * 公开命令注册或移除时框架自动同步，通常无需调用。
+ * 仅在发布失败需重试、主动撤销后需恢复，或浏览器稍后才提供 WebMCP 接口时调用。
+ * 同一浏览器接口下保留已发布工具，只补齐缺失项；不重置 App 的命令或业务状态。
  * @param current 所属应用
- * @returns 是否同步成功；浏览器不支持、App 已退出或注册失败时返回 false
+ * @returns 是否发布成功；浏览器不支持、App 已退出、发布中途撤销或注册失败时返回 false
  */
 export declare function connectWebMcp(current: lCore.TCurrent): Promise<boolean>;
 /**

package/dist/lib/control.d.ts

@@ -819,18 +819,28 @@ export interface IFabricObjectchangeEvent {
         'height': number;
     };
 }
-export interface IObjviewerLine {
-    /** -- 可自定义线段的名称 --- */
-    'name'?: string;
-    'start': clickgo.control.IObjviewerLineObj;
-    'end': clickgo.control.IObjviewerLineObj;
-    /** --- 默认 255 --- */
-    'hue'?: string;
-    'path'?: string;
-    /** --- 默认 solid --- */
-    'stroke'?: 'solid' | 'dashed' | 'up' | 'down';
-}
-export interface IObjviewerLineObj {
-    'obj': HTMLElement | AbstractControl;
-    'pos': 'lt' | 't' | 'tr' | 'r' | 'rb' | 'b' | 'bl' | 'l';
+/** --- 节点和连接的语义状态，不依赖主题的具体颜色 --- */
+export type TObjviewerStatus = 'default' | 'online' | 'warning' | 'offline';
+/** --- 按稳定节点 ID 声明的连接，节点暂不存在时不绘制，不保存 DOM 引用 --- */
+export interface IObjviewerEdge {
+    'source': string;
+    'target': string;
+    'label'?: string;
+    /** --- 默认 default，连接状态由应用明确提供 --- */
+    'status'?: TObjviewerStatus;
+    /** --- 默认 none，dash 为流动虚线，dots 为静止底线上的移动圆点 --- */
+    'animation'?: 'none' | 'dash' | 'dots';
+    /** --- 默认 forward，沿 source 到 target；reverse 反向，both 双向 --- */
+    'direction'?: 'forward' | 'reverse' | 'both';
+    /** --- 动画周期，单位秒，默认 3，限制为 0.25–60；dots 为走完整条路径的时间 --- */
+    'duration'?: number;
+    /** --- dots 模式每个方向的圆点数，默认 3，取整并限制为 1–8 --- */
+    'dotCount'?: number;
+}
+/** --- 节点选择事件，仅通知选择，不在控件内执行业务跳转 --- */
+export interface IObjviewerSelectEvent {
+    'detail': {
+        'nodeId': string;
+        'label': string;
+    };
 }