weapp-ide-cli 6.1.2 → 6.1.4

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { Buffer } from "node:buffer";
 import { AutomatorElement, AutomatorMiniProgram, AutomatorPage, DevtoolsConnectionInput, DevtoolsContext, DevtoolsElementSnapshot, DevtoolsPageSnapshot, DevtoolsRuntimeSessionOptions, DevtoolsToolResult, MiniProgramEventMap, closeSharedMiniProgram, getSharedMiniProgramSessionCount, readDevtoolsElementSnapshot as readElementSnapshot, releaseSharedMiniProgram, resolveDevtoolsProjectPath as resolveProjectPath, toDevtoolsSerializableValue as toSerializableValue } from "@weapp-vite/devtools-runtime";
 import { McpServer } from "@modelcontextprotocol/server";
 //#region src/cli/automator.d.ts
-interface AutomatorOptions {
+export interface AutomatorOptions {
   projectPath: string;
   timeout?: number;
   cliPath?: string;
@@ -16,54 +16,54 @@ interface AutomatorOptions {
 /**
  * @description 为项目路径派生稳定的 DevTools automator 端口，避免多个 dev:open 项目抢占默认端口。
  */
-declare function resolveProjectAutomatorPort(projectPath: string): number;
+export declare function resolveProjectAutomatorPort(projectPath: string): number;
 /**
  * @description 判断错误是否属于开发者工具服务端口不可用。
  */
-declare function isDevtoolsHttpPortError(error: unknown): boolean;
+export declare function isDevtoolsHttpPortError(error: unknown): boolean;
 /**
  * @description 判断错误是否属于开发者工具 automator 扩展上下文尚未就绪。
  */
-declare function isDevtoolsExtensionContextInvalidatedError(error: unknown): boolean;
+export declare function isDevtoolsExtensionContextInvalidatedError(error: unknown): boolean;
 /**
  * @description 判断错误是否属于可重试的 automator 启动抖动。
  */
-declare function isRetryableAutomatorLaunchError(error: unknown): boolean;
+export declare function isRetryableAutomatorLaunchError(error: unknown): boolean;
 /**
  * @description 判断错误是否属于开发者工具 websocket 连接失败。
  */
-declare function isAutomatorWsConnectError(error: unknown): boolean;
+export declare function isAutomatorWsConnectError(error: unknown): boolean;
 /**
  * @description 判断错误是否属于目标项目 automator 端口仍被旧会话占用。
  */
-declare function isAutomatorPortInUseError(error: unknown): boolean;
+export declare function isAutomatorPortInUseError(error: unknown): boolean;
 /**
  * @description 判断错误是否属于开发者工具协议调用超时。
  */
-declare function isAutomatorProtocolTimeoutError(error: unknown): boolean;
+export declare function isAutomatorProtocolTimeoutError(error: unknown): boolean;
 /**
  * @description 提取协议超时的方法名。
  */
-declare function getAutomatorProtocolTimeoutMethod(error: unknown): string | undefined;
+export declare function getAutomatorProtocolTimeoutMethod(error: unknown): string | undefined;
 /**
  * @description 判断错误是否属于开发者工具登录失效。
  */
-declare function isAutomatorLoginError(error: unknown): boolean;
+export declare function isAutomatorLoginError(error: unknown): boolean;
 /**
  * @description 格式化开发者工具登录失效错误，便于终端展示。
  */
-declare function formatAutomatorLoginError(error: unknown): string;
+export declare function formatAutomatorLoginError(error: unknown): string;
 /**
  * @description 基于当前配置解析 CLI 路径，并通过现代化 automator 入口启动会话。
  */
-declare function launchAutomator(options: AutomatorOptions): Promise<any>;
+export declare function launchAutomator(options: AutomatorOptions): Promise<any>;
 /**
  * @description 连接当前项目已打开的开发者工具自动化会话，不触发新的 IDE 拉起。
  */
-declare function connectOpenedAutomator(options: AutomatorOptions): Promise<unknown>;
+export declare function connectOpenedAutomator(options: AutomatorOptions): Promise<unknown>;
 //#endregion
 //#region src/cli/automator-argv.d.ts
-interface ParsedAutomatorArgs {
+export interface ParsedAutomatorArgs {
   projectPath: string;
   timeout?: number;
   port?: number;
@@ -75,84 +75,82 @@ interface ParsedAutomatorArgs {
 /**
  * @description 解析 automator 命令通用参数与位置参数。
  */
-declare function parseAutomatorArgs(argv: readonly string[]): ParsedAutomatorArgs;
+export declare function parseAutomatorArgs(argv: readonly string[]): ParsedAutomatorArgs;
 /**
  * @description 读取选项值，支持多个别名，以及 --option value 与 --option=value。
  */
-declare function readOptionValue(argv: readonly string[], ...optionNames: string[]): string | undefined;
+export declare function readOptionValue(argv: readonly string[], ...optionNames: string[]): string | undefined;
 /**
  * @description 读取布尔选项，支持裸 flag、--flag=true/false 与 --flag true/false。
  */
-declare function readBooleanOption(argv: readonly string[], ...optionNames: string[]): boolean | undefined;
+export declare function readBooleanOption(argv: readonly string[], ...optionNames: string[]): boolean | undefined;
 /**
  * @description 删除参数中的指定选项（同时支持 --opt value 与 --opt=value）。
  */
-declare function removeOption(argv: readonly string[], optionName: string): string[];
+export declare function removeOption(argv: readonly string[], optionName: string): string[];
 //#endregion
 //#region src/cli/automator-session.d.ts
 type MiniProgramLike = AutomatorMiniProgram;
 type MiniProgramPage = AutomatorPage;
 type MiniProgramElement = AutomatorElement;
 interface AutomatorSessionOptions extends DevtoolsRuntimeSessionOptions {}
-/**
- * @description 建立 automator 会话，并统一处理常见连接错误提示。
- */
-declare function connectMiniProgram(options: AutomatorSessionOptions): Promise<MiniProgramLike>;
+/** 建立交互式会话，并报告最终连接错误。 */
+export declare function connectMiniProgram(options: AutomatorSessionOptions): Promise<MiniProgramLike>;
 /**
  * @description 获取指定项目的共享 automator 会话；若不存在则自动创建。
  */
-declare function acquireSharedMiniProgram(options: AutomatorSessionOptions): Promise<MiniProgramLike>;
+export declare function acquireSharedMiniProgram(options: AutomatorSessionOptions): Promise<MiniProgramLike>;
 /**
  * @description 统一管理 automator 会话生命周期。
  */
-declare function withMiniProgram<T>(options: AutomatorSessionOptions, runner: (miniProgram: MiniProgramLike) => Promise<T>): Promise<T>;
+export declare function withMiniProgram<T>(options: AutomatorSessionOptions, runner: (miniProgram: MiniProgramLike) => Promise<T>): Promise<T>;
 //#endregion
 //#region src/cli/command-catalog.d.ts
-declare const WECHAT_CLI_COMMAND_NAMES: readonly ["open", "login", "islogin", "preview", "auto-preview", "upload", "build-npm", "auto", "auto-replay", "reset-fileutils", "close", "quit", "cache", "engine", "open-other", "build-ipa", "build-apk", "cloud"];
-declare const MINIDEV_NAMESPACE_COMMAND_NAMES: readonly ["alipay", "ali", "minidev"];
-declare const CONFIG_COMMAND_NAME: "config";
-declare const MCP_COMMAND_NAME: "mcp";
-declare const WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES: string[];
+export declare const WECHAT_CLI_COMMAND_NAMES: readonly ["open", "login", "islogin", "preview", "auto-preview", "upload", "build-npm", "auto", "auto-replay", "reset-fileutils", "close", "quit", "cache", "engine", "open-other", "build-ipa", "build-apk", "cloud"];
+export declare const MINIDEV_NAMESPACE_COMMAND_NAMES: readonly ["alipay", "ali", "minidev"];
+export declare const CONFIG_COMMAND_NAME: "config";
+export declare const MCP_COMMAND_NAME: "mcp";
+export declare const WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES: string[];
 /**
  * @description 判断是否为 weapp-ide-cli 支持的顶层命令。
  */
-declare function isWeappIdeTopLevelCommand(command: string | undefined): boolean;
+export declare function isWeappIdeTopLevelCommand(command: string | undefined): boolean;
 //#endregion
 //#region src/cli/commands.d.ts
-interface AutomatorCommandOptions extends AutomatorSessionOptions {}
-interface NavigateOptions extends AutomatorCommandOptions {
+export interface AutomatorCommandOptions extends AutomatorSessionOptions {}
+export interface NavigateOptions extends AutomatorCommandOptions {
   url: string;
 }
-interface PageInfoOptions extends AutomatorCommandOptions {
+export interface PageInfoOptions extends AutomatorCommandOptions {
   json?: boolean;
 }
-interface PageDataOptions extends PageInfoOptions {
+export interface PageDataOptions extends PageInfoOptions {
   path?: string;
 }
-interface SelectorOptions extends AutomatorCommandOptions {
+export interface SelectorOptions extends AutomatorCommandOptions {
   selector: string;
 }
-interface TapOptions extends SelectorOptions {}
-interface InputOptions extends SelectorOptions {
+export interface TapOptions extends SelectorOptions {}
+export interface InputOptions extends SelectorOptions {
   value: string;
 }
-interface ScrollOptions extends AutomatorCommandOptions {
+export interface ScrollOptions extends AutomatorCommandOptions {
   scrollTop: number;
 }
-interface AuditOptions extends AutomatorCommandOptions {
+export interface AuditOptions extends AutomatorCommandOptions {
   outputPath?: string;
 }
-interface ScreenshotOptions extends AutomatorCommandOptions {
+export interface ScreenshotOptions extends AutomatorCommandOptions {
   outputPath?: string;
   page?: string;
   fullPage?: boolean;
   retryWithFreshSession?: boolean;
 }
-interface ScreenshotResult {
+export interface ScreenshotResult {
   base64?: string;
   path?: string;
 }
-interface RemoteOptions extends AutomatorCommandOptions {
+export interface RemoteOptions extends AutomatorCommandOptions {
   enable?: boolean;
 }
 interface PageSnapshot {
@@ -162,67 +160,67 @@ interface PageSnapshot {
 /**
  * @description 执行保留栈页面跳转。
  */
-declare function navigateTo(options: NavigateOptions): Promise<void>;
+export declare function navigateTo(options: NavigateOptions): Promise<void>;
 /**
  * @description 执行关闭当前页的重定向。
  */
-declare function redirectTo(options: NavigateOptions): Promise<void>;
+export declare function redirectTo(options: NavigateOptions): Promise<void>;
 /**
  * @description 返回上一页。
  */
-declare function navigateBack(options: AutomatorCommandOptions): Promise<void>;
+export declare function navigateBack(options: AutomatorCommandOptions): Promise<void>;
 /**
  * @description 重启到指定页面。
  */
-declare function reLaunch(options: NavigateOptions): Promise<void>;
+export declare function reLaunch(options: NavigateOptions): Promise<void>;
 /**
  * @description 切换到 tabBar 页面。
  */
-declare function switchTab(options: NavigateOptions): Promise<void>;
+export declare function switchTab(options: NavigateOptions): Promise<void>;
 /**
  * @description 获取页面栈。
  */
-declare function pageStack(options: PageInfoOptions): Promise<any>;
+export declare function pageStack(options: PageInfoOptions): Promise<any>;
 /**
  * @description 获取当前页面信息。
  */
-declare function currentPage(options: PageInfoOptions): Promise<PageSnapshot>;
+export declare function currentPage(options: PageInfoOptions): Promise<PageSnapshot>;
 /**
  * @description 获取系统信息。
  */
-declare function systemInfo(options: PageInfoOptions): Promise<any>;
+export declare function systemInfo(options: PageInfoOptions): Promise<any>;
 /**
  * @description 获取当前页面数据。
  */
-declare function pageData(options: PageDataOptions): Promise<any>;
+export declare function pageData(options: PageDataOptions): Promise<any>;
 /**
  * @description 点击页面元素。
  */
-declare function tap(options: TapOptions): Promise<void>;
+export declare function tap(options: TapOptions): Promise<void>;
 /**
  * @description 向页面元素输入文本。
  */
-declare function input(options: InputOptions): Promise<void>;
+export declare function input(options: InputOptions): Promise<void>;
 /**
  * @description 滚动页面到指定位置。
  */
-declare function scrollTo(options: ScrollOptions): Promise<void>;
+export declare function scrollTo(options: ScrollOptions): Promise<void>;
 /**
  * @description 执行体验评分审计。
  */
-declare function audit(options: AuditOptions): Promise<any>;
+export declare function audit(options: AuditOptions): Promise<any>;
 /**
  * @description 捕获当前页面截图并返回二进制内容。
  */
-declare function captureScreenshotBuffer(options: ScreenshotOptions): Promise<Buffer>;
+export declare function captureScreenshotBuffer(options: ScreenshotOptions): Promise<Buffer>;
 /**
  * @description 获取当前小程序截图。
  */
-declare function takeScreenshot(options: ScreenshotOptions): Promise<ScreenshotResult>;
+export declare function takeScreenshot(options: ScreenshotOptions): Promise<ScreenshotResult>;
 /**
  * @description 开关远程调试。
  */
-declare function remote(options: RemoteOptions): Promise<void>;
+export declare function remote(options: RemoteOptions): Promise<void>;
 //#endregion
 //#region src/cli/compare.d.ts
 interface CompareOptions extends ScreenshotOptions {
@@ -236,53 +234,54 @@ interface CompareOptions extends ScreenshotOptions {
 /**
  * @description 输出 compare 命令帮助信息。
  */
-declare function printCompareHelp(): void;
+export declare function printCompareHelp(): void;
 /**
  * @description 解析 compare 命令参数。
  */
-declare function parseCompareArgs(argv: string[]): CompareOptions;
+export declare function parseCompareArgs(argv: string[]): CompareOptions;
 //#endregion
 //#region src/cli/config-command.d.ts
 /**
  * @description 处理 config 子命令。
  */
-declare function handleConfigCommand(argv: string[]): Promise<void>;
+export declare function handleConfigCommand(argv: string[]): Promise<void>;
 //#endregion
 //#region src/cli/http.d.ts
-interface WechatDevtoolsHttpCommandOptions {
+export interface WechatDevtoolsHttpCommandOptions {
   port?: number;
+  signal?: AbortSignal;
   timeoutMs?: number;
 }
-interface WechatDevtoolsEngineBuildResult {
+export interface WechatDevtoolsEngineBuildResult {
   msg?: string;
   status?: string;
 }
-interface StartWechatIdeEngineBuildResult {
+export interface StartWechatIdeEngineBuildResult {
   body: string;
 }
-interface PollWechatIdeEngineBuildResult extends WechatDevtoolsEngineBuildResult {
+export interface PollWechatIdeEngineBuildResult extends WechatDevtoolsEngineBuildResult {
   body: string;
   done: boolean;
   failed: boolean;
 }
-declare function requestWechatDevtoolsHttp(pathname: string, query: Record<string, string>, options?: WechatDevtoolsHttpCommandOptions): Promise<string>;
+export declare function requestWechatDevtoolsHttp(pathname: string, query: Record<string, string>, options?: WechatDevtoolsHttpCommandOptions): Promise<string>;
 /**
  * @description 通过微信开发者工具 HTTP 服务端口重新打开项目；若项目已打开，开发者工具会刷新当前项目。
  */
-declare function openWechatIdeProjectByHttp(projectPath: string, options?: WechatDevtoolsHttpCommandOptions): Promise<string>;
+export declare function openWechatIdeProjectByHttp(projectPath: string, options?: WechatDevtoolsHttpCommandOptions): Promise<string>;
 /**
  * @description 通过微信开发者工具 HTTP 服务端口重置当前项目的 fileutils 状态。
  */
-declare function resetWechatIdeFileUtilsByHttp(projectPath: string, options?: WechatDevtoolsHttpCommandOptions): Promise<string>;
+export declare function resetWechatIdeFileUtilsByHttp(projectPath: string, options?: WechatDevtoolsHttpCommandOptions): Promise<string>;
 /**
  * @description 通过微信开发者工具 HTTP 服务端口触发 engine build。
  */
-declare function startWechatIdeEngineBuildByHttp(projectPath: string, options?: WechatDevtoolsHttpCommandOptions): Promise<StartWechatIdeEngineBuildResult>;
+export declare function startWechatIdeEngineBuildByHttp(projectPath: string, options?: WechatDevtoolsHttpCommandOptions): Promise<StartWechatIdeEngineBuildResult>;
 /**
  * @description 轮询微信开发者工具 engine build 状态。
  */
-declare function pollWechatIdeEngineBuildResultByHttp(options?: WechatDevtoolsHttpCommandOptions): Promise<PollWechatIdeEngineBuildResult>;
-declare const WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES: {
+export declare function pollWechatIdeEngineBuildResultByHttp(options?: WechatDevtoolsHttpCommandOptions): Promise<PollWechatIdeEngineBuildResult>;
+export declare const WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES: {
   readonly BUILDING: "BUILDING";
   readonly END: "END";
   readonly ERROR: "ERROR";
@@ -291,60 +290,60 @@ declare const WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES: {
 };
 //#endregion
 //#region src/cli/engine.d.ts
-interface RunWechatIdeEngineBuildByHttpOptions extends WechatDevtoolsHttpCommandOptions {
+export interface RunWechatIdeEngineBuildByHttpOptions extends WechatDevtoolsHttpCommandOptions {
   onProgress?: (result: PollWechatIdeEngineBuildResult) => void;
   overallTimeoutMs?: number;
   pollIntervalMs?: number;
 }
-interface RunWechatIdeEngineBuildOptions extends RunWechatIdeEngineBuildByHttpOptions {
+export interface RunWechatIdeEngineBuildOptions extends RunWechatIdeEngineBuildByHttpOptions {
   fallbackToCli?: boolean;
   logPath?: string;
 }
-declare function isWechatIdeEngineBuildEndpointMissingError(error: unknown): boolean;
+export declare function isWechatIdeEngineBuildEndpointMissingError(error: unknown): boolean;
 /**
  * @description 通过开发者工具 HTTP 服务端口执行 engine build，并轮询直到构建结束。
  */
-declare function runWechatIdeEngineBuildByHttp(projectPath: string, options?: RunWechatIdeEngineBuildByHttpOptions): Promise<PollWechatIdeEngineBuildResult>;
+export declare function runWechatIdeEngineBuildByHttp(projectPath: string, options?: RunWechatIdeEngineBuildByHttpOptions): Promise<PollWechatIdeEngineBuildResult>;
 /**
  * @description 以更接近官方 CLI 的方式执行 engine build，并支持将构建日志写入文件。
  */
-declare function runWechatIdeEngineBuild(projectPath: string, options?: RunWechatIdeEngineBuildOptions): Promise<void | PollWechatIdeEngineBuildResult>;
+export declare function runWechatIdeEngineBuild(projectPath: string, options?: RunWechatIdeEngineBuildOptions): Promise<void | PollWechatIdeEngineBuildResult>;
 //#endregion
 //#region src/cli/forwardConsole.d.ts
-type ForwardConsoleLogLevel = 'debug' | 'log' | 'info' | 'warn' | 'error';
-interface ForwardConsoleEvent {
+export type ForwardConsoleLogLevel = 'debug' | 'log' | 'info' | 'warn' | 'error';
+export interface ForwardConsoleEvent {
   level: ForwardConsoleLogLevel;
   message: string;
   raw: unknown;
 }
-interface ForwardConsoleOptions extends AutomatorSessionOptions {
+export interface ForwardConsoleOptions extends AutomatorSessionOptions {
   logLevels?: ForwardConsoleLogLevel[];
   unhandledErrors?: boolean;
   onLog?: (event: ForwardConsoleEvent) => void;
   onReady?: () => void;
 }
-interface ForwardConsoleSession {
+export interface ForwardConsoleSession {
   close: () => Promise<void>;
 }
 /**
  * @description 启动小程序控制台日志转发，并保持 automator 会话常驻。
  */
-declare function startForwardConsole(options: ForwardConsoleOptions): Promise<ForwardConsoleSession>;
+export declare function startForwardConsole(options: ForwardConsoleOptions): Promise<ForwardConsoleSession>;
 //#endregion
 //#region src/cli/inputCoordinator.d.ts
-interface SharedInputSessionOptions {
+export interface SharedInputSessionOptions {
   onData?: (chunk: string | Uint8Array) => void;
   onKeypress?: (str: string, key: {
     name?: string;
     ctrl?: boolean;
   } | undefined) => void;
 }
-interface SharedInputSession {
+export interface SharedInputSession {
   close: () => void;
   resume: () => void;
   suspend: () => void;
 }
-interface ExclusiveKeypressOptions<T> {
+export interface ExclusiveKeypressOptions<T> {
   ignoreInitialMs?: number;
   timeoutMs?: number;
   onKeypress: (str: string, key: {
@@ -352,46 +351,46 @@ interface ExclusiveKeypressOptions<T> {
     ctrl?: boolean;
   } | undefined) => T | undefined;
 }
-declare function createSharedInputSession(options: SharedInputSessionOptions): SharedInputSession | undefined;
-declare function waitForExclusiveKeypress<T>(options: ExclusiveKeypressOptions<T>): Promise<T | 'timeout'>;
-declare function runWithSuspendedSharedInput<T>(runner: () => Promise<T>): Promise<T>;
+export declare function createSharedInputSession(options: SharedInputSessionOptions): SharedInputSession | undefined;
+export declare function waitForExclusiveKeypress<T>(options: ExclusiveKeypressOptions<T>): Promise<T | 'timeout'>;
+export declare function runWithSuspendedSharedInput<T>(runner: () => Promise<T>): Promise<T>;
 //#endregion
 //#region src/cli/minidev.d.ts
 /**
  * @description 运行支付宝小程序 CLI（minidev）
  */
-declare function runMinidev(argv: readonly string[]): Promise<void>;
+export declare function runMinidev(argv: readonly string[]): Promise<void>;
 //#endregion
 //#region src/cli/prompt.d.ts
 /**
  * @description 交互式提示并保存 CLI 路径
  */
-declare function promptForCliPath(): Promise<string | null>;
+export declare function promptForCliPath(): Promise<string | null>;
 //#endregion
 //#region src/cli/resolver.d.ts
 /**
  * @description 解析 CLI 路径并校验可用性
  */
-declare function resolveCliPath(): Promise<{
+export declare function resolveCliPath(): Promise<{
   cliPath: string | null;
   source: ConfigSource;
 }>;
 //#endregion
 //#region src/cli/retry.d.ts
-interface RetryKeypressOptions {
+export interface RetryKeypressOptions {
   timeoutMs?: number;
 }
-interface RetryPromptOptions extends RetryKeypressOptions {
+export interface RetryPromptOptions extends RetryKeypressOptions {
   logger: {
     info: (message: string) => void;
   };
 }
-interface RetryLogger {
+export interface RetryLogger {
   error: (message: string) => void;
   info: (message: string) => void;
   warn: (message: string) => void;
 }
-interface WechatIdeLoginRetryOptions {
+export interface WechatIdeLoginRetryOptions {
   allowRetry?: boolean;
   cancelLevel?: 'info' | 'warn';
   error: unknown;
@@ -399,87 +398,87 @@ interface WechatIdeLoginRetryOptions {
   promptOpenIdeLogin?: boolean;
   retryTimeoutMs?: number;
 }
-type RetryPromptResult = 'retry' | 'cancel' | 'timeout';
-declare const RETRY_PROMPT_INITIAL_IGNORE_MS = 300;
-declare const RETRY_CONFIRM_KEYS: readonly ["y"];
-declare const RETRY_CANCEL_KEYS: readonly ["q", "Esc", "Ctrl+C"];
+export type RetryPromptResult = 'retry' | 'cancel' | 'timeout';
+export declare const RETRY_PROMPT_INITIAL_IGNORE_MS = 300;
+export declare const RETRY_CONFIRM_KEYS: readonly ["y"];
+export declare const RETRY_CANCEL_KEYS: readonly ["q", "Esc", "Ctrl+C"];
 /**
  * @description 提取执行错误文本，便于统一匹配与提示。
  */
-declare function extractExecutionErrorText(error: unknown): string;
+export declare function extractExecutionErrorText(error: unknown): string;
 /**
  * @description 判断是否为微信开发者工具登录失效错误。
  */
-declare function isWechatIdeLoginRequiredError(error: unknown): boolean;
+export declare function isWechatIdeLoginRequiredError(error: unknown): boolean;
 /**
  * @description 将登录失效错误格式化为更易读的摘要。
  */
-declare function formatWechatIdeLoginRequiredError(error: unknown): string;
+export declare function formatWechatIdeLoginRequiredError(error: unknown): string;
 /**
  * @description 创建登录失效专用错误，并携带退出码语义。
  */
-declare function createWechatIdeLoginRequiredExitError(error: unknown, reason?: string): Error & {
+export declare function createWechatIdeLoginRequiredExitError(error: unknown, reason?: string): Error & {
   code: number;
   exitCode: number;
 };
 /**
  * @description 判断错误是否为登录失效专用退出错误。
  */
-declare function isWechatIdeLoginRequiredExitError(error: unknown): boolean;
+export declare function isWechatIdeLoginRequiredExitError(error: unknown): boolean;
 /**
  * @description 交互等待用户按 y 重试，按 q 或 Ctrl+C 取消。
  */
-declare function waitForRetryKeypress(options?: RetryKeypressOptions): Promise<RetryPromptResult>;
+export declare function waitForRetryKeypress(options?: RetryKeypressOptions): Promise<RetryPromptResult>;
 /**
  * @description 生成重试按键提示，并高亮关键热键。
  */
-declare function formatRetryHotkeyPrompt(timeoutMs?: number): string;
+export declare function formatRetryHotkeyPrompt(timeoutMs?: number): string;
 /**
  * @description 输出重试热键提示，并独占等待当前提示对应的按键输入。
  */
-declare function promptRetryKeypress(options: RetryPromptOptions): Promise<RetryPromptResult>;
+export declare function promptRetryKeypress(options: RetryPromptOptions): Promise<RetryPromptResult>;
 /**
  * @description 统一处理微信开发者工具登录失效场景下的提示与重试交互。
  */
-declare function promptWechatIdeLoginRetry(options: WechatIdeLoginRetryOptions): Promise<"cancel" | "retry">;
+export declare function promptWechatIdeLoginRetry(options: WechatIdeLoginRetryOptions): Promise<"cancel" | "retry">;
 //#endregion
 //#region src/cli/run.d.ts
 /**
  * @description 基于 cac 注册顶层命令，用于统一识别入口。
  */
-declare function createCli(): import("cac").CAC;
+export declare function createCli(): import("cac").CAC;
 /**
  * @description CLI 入口解析与分发。
  */
-declare function parse(argv: string[]): Promise<void>;
+export declare function parse(argv: string[]): Promise<void>;
 //#endregion
 //#region src/cli/run-automator.d.ts
-declare const AUTOMATOR_COMMAND_NAMES: string[];
+export declare const AUTOMATOR_COMMAND_NAMES: string[];
 /**
  * @description 判断是否属于 automator 子命令。
  */
-declare function isAutomatorCommand(command: string | undefined): boolean;
+export declare function isAutomatorCommand(command: string | undefined): boolean;
 /**
  * @description 获取 automator 子命令帮助文本。
  */
-declare function getAutomatorCommandHelp(command: string): string | undefined;
+export declare function getAutomatorCommandHelp(command: string): string | undefined;
 /**
  * @description 执行 automator 子命令。
  */
-declare function runAutomatorCommand(command: string, argv: string[]): Promise<void>;
+export declare function runAutomatorCommand(command: string, argv: string[]): Promise<void>;
 //#endregion
 //#region src/cli/run-login.d.ts
-interface RunWechatCliWithRetryOptions {
+export interface RunWechatCliWithRetryOptions {
   silent?: boolean;
   timeout?: number;
 }
 /**
  * @description 运行微信开发者工具 CLI，并在登录失效时允许按键重试。
  */
-declare function runWechatCliWithRetry(cliPath: string, argv: string[], options?: RunWechatCliWithRetryOptions): Promise<void>;
+export declare function runWechatCliWithRetry(cliPath: string, argv: string[], options?: RunWechatCliWithRetryOptions): Promise<void>;
 //#endregion
 //#region src/cli/run-login-executor.d.ts
-interface RetryableCommandExecutorOptions<TResult, TPromptResult> {
+export interface RetryableCommandExecutorOptions<TResult, TPromptResult> {
   createCancelError: (result: TResult) => Error;
   execute: () => Promise<TResult>;
   isRetryableResult: (result: TResult) => boolean;
@@ -491,49 +490,49 @@ interface RetryableCommandExecutorOptions<TResult, TPromptResult> {
 /**
  * @description 执行可重试命令循环，并将“是否可重试”与“如何提示重试”交给调用方定义。
  */
-declare function runRetryableCommand<TResult, TPromptResult>(options: RetryableCommandExecutorOptions<TResult, TPromptResult>): Promise<TResult>;
+export declare function runRetryableCommand<TResult, TPromptResult>(options: RetryableCommandExecutorOptions<TResult, TPromptResult>): Promise<TResult>;
 //#endregion
 //#region src/cli/run-mcp.d.ts
-interface McpCommandOptions {
+export interface McpCommandOptions {
   workspaceRoot?: string;
 }
-declare function runMcpCommand(argv: string[]): Promise<void>;
+export declare function runMcpCommand(argv: string[]): Promise<void>;
 //#endregion
 //#region src/cli/screenshot.d.ts
 /**
  * @description Print help for screenshot command
  */
-declare function printScreenshotHelp(): void;
+export declare function printScreenshotHelp(): void;
 /**
  * @description Parse command line arguments for screenshot command
  */
-declare function parseScreenshotArgs(argv: string[]): ScreenshotOptions;
+export declare function parseScreenshotArgs(argv: string[]): ScreenshotOptions;
 //#endregion
 //#region src/cli/wechat-command-schema.d.ts
 /**
  * @description 在调用官方微信 CLI 前做轻量参数校验。
  */
-declare function validateWechatCliCommandArgs(argv: readonly string[]): void;
+export declare function validateWechatCliCommandArgs(argv: readonly string[]): void;
 //#endregion
 //#region src/cli/wechat-commands.d.ts
-interface LoginWechatIdeOptions {
+export interface LoginWechatIdeOptions {
   qrFormat?: 'base64' | 'image' | 'terminal';
   qrOutput?: string;
   qrSize?: string;
   resultOutput?: string;
 }
-interface OpenWechatIdeOptions {
+export interface OpenWechatIdeOptions {
   appid?: string;
   extAppid?: string;
   platform?: string;
   projectPath?: string;
   trustProject?: boolean;
 }
-interface BuildWechatIdeNpmOptions {
+export interface BuildWechatIdeNpmOptions {
   compileType?: string;
   projectPath?: string;
 }
-interface PreviewWechatIdeOptions {
+export interface PreviewWechatIdeOptions {
   appid?: string;
   compileCondition?: string;
   extAppid?: string;
@@ -543,14 +542,14 @@ interface PreviewWechatIdeOptions {
   qrOutput?: string;
   qrSize?: string;
 }
-interface AutoPreviewWechatIdeOptions {
+export interface AutoPreviewWechatIdeOptions {
   appid?: string;
   compileCondition?: string;
   extAppid?: string;
   infoOutput?: string;
   projectPath?: string;
 }
-interface UploadWechatIdeOptions {
+export interface UploadWechatIdeOptions {
   appid?: string;
   desc: string;
   extAppid?: string;
@@ -558,7 +557,7 @@ interface UploadWechatIdeOptions {
   projectPath?: string;
   version: string;
 }
-interface AutoWechatIdeOptions {
+export interface AutoWechatIdeOptions {
   account?: string;
   appid?: string;
   extAppid?: string;
@@ -568,7 +567,7 @@ interface AutoWechatIdeOptions {
   ticket?: string;
   trustProject?: boolean;
 }
-interface AutoReplayWechatIdeOptions {
+export interface AutoReplayWechatIdeOptions {
   account?: string;
   appid?: string;
   extAppid?: string;
@@ -580,16 +579,16 @@ interface AutoReplayWechatIdeOptions {
   ticket?: string;
   trustProject?: boolean;
 }
-interface OpenWechatIdeOtherProjectOptions {
+export interface OpenWechatIdeOtherProjectOptions {
   projectPath?: string;
 }
-interface ClearWechatIdeCacheOptions {
+export interface ClearWechatIdeCacheOptions {
   clean: 'all' | 'auth' | 'compile' | 'file' | 'network' | 'session' | 'storage';
 }
-interface ResetWechatIdeFileUtilsOptions {
+export interface ResetWechatIdeFileUtilsOptions {
   projectPath: string;
 }
-interface WechatIdeAutomatorSessionOptions {
+export interface WechatIdeAutomatorSessionOptions {
   port?: number;
   preferOpenedSession?: boolean;
   preserveProjectRoot?: boolean;
@@ -598,16 +597,16 @@ interface WechatIdeAutomatorSessionOptions {
   sharedSession?: boolean;
   timeout?: number;
 }
-interface CompileWechatIdeByAutomatorOptions extends WechatIdeAutomatorSessionOptions {
+export interface CompileWechatIdeByAutomatorOptions extends WechatIdeAutomatorSessionOptions {
   force?: boolean;
 }
-interface ClearWechatIdeCacheByAutomatorOptions extends WechatIdeAutomatorSessionOptions {
+export interface ClearWechatIdeCacheByAutomatorOptions extends WechatIdeAutomatorSessionOptions {
   clean: 'all' | 'auth' | 'compile' | 'file' | 'network' | 'session' | 'storage';
 }
-interface SetWechatIdeTicketOptions extends WechatIdeAutomatorSessionOptions {
+export interface SetWechatIdeTicketOptions extends WechatIdeAutomatorSessionOptions {
   ticket: string;
 }
-interface BuildWechatIdeApkOptions {
+export interface BuildWechatIdeApkOptions {
   desc?: string;
   isUploadResourceBundle?: boolean;
   keyAlias: string;
@@ -619,7 +618,7 @@ interface BuildWechatIdeApkOptions {
   storePass: string;
   useAab?: boolean;
 }
-interface BuildWechatIdeIpaOptions {
+export interface BuildWechatIdeIpaOptions {
   certificateName?: string;
   isDistribute: boolean;
   isRemoteBuild?: boolean;
@@ -639,153 +638,153 @@ interface BuildWechatIdeIpaOptions {
 /**
  * @description 调用微信开发者工具 open 命令。
  */
-declare function openWechatIde(options?: OpenWechatIdeOptions): Promise<void>;
+export declare function openWechatIde(options?: OpenWechatIdeOptions): Promise<void>;
 /**
  * @description 调用微信开发者工具 login 命令。
  */
-declare function loginWechatIde(options?: LoginWechatIdeOptions): Promise<void>;
+export declare function loginWechatIde(options?: LoginWechatIdeOptions): Promise<void>;
 /**
  * @description 调用微信开发者工具 islogin 命令。
  */
-declare function isWechatIdeLoggedIn(options?: {
+export declare function isWechatIdeLoggedIn(options?: {
   nonInteractive?: boolean;
   silent?: boolean;
 }): Promise<void>;
 /**
  * @description 调用微信开发者工具 build-npm 命令。
  */
-declare function buildWechatIdeNpm(options?: BuildWechatIdeNpmOptions): Promise<void>;
+export declare function buildWechatIdeNpm(options?: BuildWechatIdeNpmOptions): Promise<void>;
 /**
  * @description 调用微信开发者工具 preview 命令。
  */
-declare function previewWechatIde(options?: PreviewWechatIdeOptions): Promise<void>;
+export declare function previewWechatIde(options?: PreviewWechatIdeOptions): Promise<void>;
 /**
  * @description 调用微信开发者工具 auto-preview 命令。
  */
-declare function autoPreviewWechatIde(options?: AutoPreviewWechatIdeOptions): Promise<void>;
+export declare function autoPreviewWechatIde(options?: AutoPreviewWechatIdeOptions): Promise<void>;
 /**
  * @description 调用微信开发者工具 auto 命令。
  */
-declare function autoWechatIde(options?: AutoWechatIdeOptions): Promise<void>;
+export declare function autoWechatIde(options?: AutoWechatIdeOptions): Promise<void>;
 /**
  * @description 调用微信开发者工具 auto-replay 命令。
  */
-declare function autoReplayWechatIde(options?: AutoReplayWechatIdeOptions): Promise<void>;
+export declare function autoReplayWechatIde(options?: AutoReplayWechatIdeOptions): Promise<void>;
 /**
  * @description 调用微信开发者工具 upload 命令。
  */
-declare function uploadWechatIde(options: UploadWechatIdeOptions): Promise<void>;
+export declare function uploadWechatIde(options: UploadWechatIdeOptions): Promise<void>;
 /**
  * @description 调用微信开发者工具 close 命令。
  */
-declare function closeWechatIdeProject(): Promise<void>;
+export declare function closeWechatIdeProject(): Promise<void>;
 /**
  * @description 调用微信开发者工具 quit 命令。
  */
-declare function quitWechatIde(): Promise<void>;
+export declare function quitWechatIde(): Promise<void>;
 /**
  * @description 调用微信开发者工具 cache 命令。
  */
-declare function clearWechatIdeCache(options: ClearWechatIdeCacheOptions): Promise<void>;
+export declare function clearWechatIdeCache(options: ClearWechatIdeCacheOptions): Promise<void>;
 /**
  * @description 调用微信开发者工具 open-other 命令。
  */
-declare function openWechatIdeOtherProject(_options?: OpenWechatIdeOtherProjectOptions): Promise<void>;
+export declare function openWechatIdeOtherProject(_options?: OpenWechatIdeOtherProjectOptions): Promise<void>;
 /**
  * @description 通过微信开发者工具 HTTP 服务端口重置指定项目的 fileutils 状态。
  */
-declare function resetWechatIdeFileUtils(options: ResetWechatIdeFileUtilsOptions): Promise<void>;
+export declare function resetWechatIdeFileUtils(options: ResetWechatIdeFileUtilsOptions): Promise<void>;
 /**
  * @description 通过已打开或新建的 automator 会话获取开发者工具基础信息。
  */
-declare function getWechatIdeToolInfo(options: WechatIdeAutomatorSessionOptions): Promise<any>;
+export declare function getWechatIdeToolInfo(options: WechatIdeAutomatorSessionOptions): Promise<any>;
 /**
  * @description 通过已打开或新建的 automator 会话执行项目编译。
  */
-declare function compileWechatIdeByAutomator(options: CompileWechatIdeByAutomatorOptions): Promise<any>;
+export declare function compileWechatIdeByAutomator(options: CompileWechatIdeByAutomatorOptions): Promise<any>;
 /**
  * @description 通过已打开或新建的 automator 会话清理开发者工具缓存。
  */
-declare function clearWechatIdeCacheByAutomator(options: ClearWechatIdeCacheByAutomatorOptions): Promise<any>;
+export declare function clearWechatIdeCacheByAutomator(options: ClearWechatIdeCacheByAutomatorOptions): Promise<any>;
 /**
  * @description 通过已打开或新建的 automator 会话获取当前 ticket。
  */
-declare function getWechatIdeTicket(options: WechatIdeAutomatorSessionOptions): Promise<any>;
+export declare function getWechatIdeTicket(options: WechatIdeAutomatorSessionOptions): Promise<any>;
 /**
  * @description 通过已打开或新建的 automator 会话设置 ticket。
  */
-declare function setWechatIdeTicket(options: SetWechatIdeTicketOptions): Promise<void>;
+export declare function setWechatIdeTicket(options: SetWechatIdeTicketOptions): Promise<void>;
 /**
  * @description 通过已打开或新建的 automator 会话刷新 ticket。
  */
-declare function refreshWechatIdeTicket(options: WechatIdeAutomatorSessionOptions): Promise<void>;
+export declare function refreshWechatIdeTicket(options: WechatIdeAutomatorSessionOptions): Promise<void>;
 /**
  * @description 通过已打开或新建的 automator 会话获取测试账号列表。
  */
-declare function getWechatIdeTestAccounts(options: WechatIdeAutomatorSessionOptions): Promise<any>;
+export declare function getWechatIdeTestAccounts(options: WechatIdeAutomatorSessionOptions): Promise<any>;
 /**
  * @description 调用微信开发者工具 build-apk 命令。
  */
-declare function buildWechatIdeApk(options: BuildWechatIdeApkOptions): Promise<void>;
+export declare function buildWechatIdeApk(options: BuildWechatIdeApkOptions): Promise<void>;
 /**
  * @description 调用微信开发者工具 build-ipa 命令。
  */
-declare function buildWechatIdeIpa(options: BuildWechatIdeIpaOptions): Promise<void>;
+export declare function buildWechatIdeIpa(options: BuildWechatIdeIpaOptions): Promise<void>;
 //#endregion
 //#region src/cli/wechat-dispatch.d.ts
 /**
  * @description 优先将高频官方命令分发到 weapp-ide-cli 的稳定 helper，实现更清晰的程序化命令层。
  */
-declare function dispatchWechatCliCommand(argv: string[]): Promise<boolean>;
+export declare function dispatchWechatCliCommand(argv: string[]): Promise<boolean>;
 //#endregion
 //#region src/cli/wechatDevtoolsRuntimePort.d.ts
 /**
  * @description 标记当前进程最近一次检测到的微信开发者工具服务端口。
  */
-declare function setRuntimeWechatDevtoolsServicePort(port: number | undefined): void;
+export declare function setRuntimeWechatDevtoolsServicePort(port: number | undefined): void;
 /**
  * @description 读取当前进程最近一次检测到的微信开发者工具服务端口。
  */
-declare function getRuntimeWechatDevtoolsServicePort(): number | undefined;
+export declare function getRuntimeWechatDevtoolsServicePort(): number | undefined;
 //#endregion
 //#region src/cli/wechatDevtoolsSettings.d.ts
-interface WechatDevtoolsSecuritySettings {
+export interface WechatDevtoolsSecuritySettings {
   enableServicePort: boolean;
   port: number;
   allowGetTicket: boolean;
   trustWhenAuto: boolean;
 }
-interface DetectedWechatDevtoolsServicePortSettings {
+export interface DetectedWechatDevtoolsServicePortSettings {
   enabled?: boolean;
   port?: number;
 }
-interface DetectWechatDevtoolsServicePortOptions {
+export interface DetectWechatDevtoolsServicePortOptions {
   homeDir?: string;
   localAppDataDir?: string;
   platform?: NodeJS.Platform;
 }
-interface DetectWechatDevtoolsServicePortResult {
+export interface DetectWechatDevtoolsServicePortResult {
   touchedInstanceCount: number;
   detectedSecurityCount: number;
   servicePort?: number;
   servicePortEnabled?: boolean;
 }
-interface BootstrapWechatDevtoolsSettingsOptions extends DetectWechatDevtoolsServicePortOptions {
+export interface BootstrapWechatDevtoolsSettingsOptions extends DetectWechatDevtoolsServicePortOptions {
   projectPath?: string;
   trustProject?: boolean;
 }
-interface BootstrapWechatDevtoolsSettingsResult extends DetectWechatDevtoolsServicePortResult {
+export interface BootstrapWechatDevtoolsSettingsResult extends DetectWechatDevtoolsServicePortResult {
   updatedSecurityCount: number;
   trustedProjectCount: number;
 }
 /**
  * @description 检测微信开发者工具当前服务端口配置，严格沿用用户已有设置。
  */
-declare function detectWechatDevtoolsServicePort(options?: DetectWechatDevtoolsServicePortOptions): Promise<DetectWechatDevtoolsServicePortResult>;
+export declare function detectWechatDevtoolsServicePort(options?: DetectWechatDevtoolsServicePortOptions): Promise<DetectWechatDevtoolsServicePortResult>;
 /**
  * @description 在启动微信开发者工具前，检测服务端口配置，并按需写入项目信任信息。
  */
-declare function bootstrapWechatDevtoolsSettings(options?: BootstrapWechatDevtoolsSettingsOptions): Promise<BootstrapWechatDevtoolsSettingsResult>;
+export declare function bootstrapWechatDevtoolsSettings(options?: BootstrapWechatDevtoolsSettingsOptions): Promise<BootstrapWechatDevtoolsSettingsResult>;
 //#endregion
 //#region src/types.d.ts
 /**
@@ -822,47 +821,47 @@ interface CustomConfigFile {
   autoBootstrapDevtools?: boolean;
   autoTrustProject?: boolean;
 }
-declare function readCustomConfig(): Promise<CustomConfigFile>;
+export declare function readCustomConfig(): Promise<CustomConfigFile>;
 /**
  * @description 写入自定义 CLI 路径配置
  */
-declare function createCustomConfig(params: BaseConfig): Promise<string>;
+export declare function createCustomConfig(params: BaseConfig): Promise<string>;
 /**
  * @description 写入语言配置（zh / en）。
  */
-declare function createLocaleConfig(locale: 'zh' | 'en'): Promise<"zh" | "en">;
+export declare function createLocaleConfig(locale: 'zh' | 'en'): Promise<"zh" | "en">;
 /**
  * @description 写入开发者工具自动预热配置。
  */
-declare function createAutoBootstrapDevtoolsConfig(value: boolean): Promise<boolean>;
+export declare function createAutoBootstrapDevtoolsConfig(value: boolean): Promise<boolean>;
 /**
  * @description 写入项目自动信任配置。
  */
-declare function createAutoTrustProjectConfig(value: boolean): Promise<boolean>;
+export declare function createAutoTrustProjectConfig(value: boolean): Promise<boolean>;
 /**
  * @description 删除指定配置项。
  */
-declare function removeCustomConfigKey(key: keyof CustomConfigFile): Promise<void>;
+export declare function removeCustomConfigKey(key: keyof CustomConfigFile): Promise<void>;
 /**
  * @description 覆盖写入配置内容（会替换原内容）。
  */
-declare function overwriteCustomConfig(config: CustomConfigFile): Promise<void>;
+export declare function overwriteCustomConfig(config: CustomConfigFile): Promise<void>;
 //#endregion
 //#region src/config/paths.d.ts
 /**
  * @description 默认自定义配置目录
  */
-declare const defaultCustomConfigDirPath: string;
+export declare const defaultCustomConfigDirPath: string;
 /**
  * @description 默认自定义配置文件路径
  */
-declare const defaultCustomConfigFilePath: string;
+export declare const defaultCustomConfigFilePath: string;
 //#endregion
 //#region src/config/resolver.d.ts
 /**
  * @description 解析开发者工具自动预热相关配置的最终生效值。
  */
-declare function resolveDevtoolsAutomationDefaults(config: {
+export declare function resolveDevtoolsAutomationDefaults(config: {
   autoBootstrapDevtools?: boolean;
   autoTrustProject?: boolean;
 }): {
@@ -872,17 +871,17 @@ declare function resolveDevtoolsAutomationDefaults(config: {
 /**
  * @description 读取并解析 CLI 配置（自定义优先）
  */
-declare function getConfig(): Promise<ResolvedConfig>;
+export declare function getConfig(): Promise<ResolvedConfig>;
 /**
  * @description 获取用户配置的语言偏好。
  */
-declare function getConfiguredLocale(): Promise<"zh" | "en" | undefined>;
+export declare function getConfiguredLocale(): Promise<"zh" | "en" | undefined>;
 //#endregion
 //#region src/mcp/runtime.d.ts
-interface StartWeappIdeMcpServerOptions {
+export interface StartWeappIdeMcpServerOptions {
   workspaceRoot?: string;
 }
-declare function startWeappIdeMcpServer(options?: StartWeappIdeMcpServerOptions): Promise<{
+export declare function startWeappIdeMcpServer(options?: StartWeappIdeMcpServerOptions): Promise<{
   close: () => Promise<void>;
 }>;
 //#endregion
@@ -890,7 +889,7 @@ declare function startWeappIdeMcpServer(options?: StartWeappIdeMcpServerOptions)
 interface ToolRegistrar {
   registerTool: McpServer['registerTool'];
 }
-interface WeappIdeMcpRuntimeHooks {
+export interface WeappIdeMcpRuntimeHooks {
   withMiniProgram: <T>(options: {
     preferOpenedSession?: boolean;
     port?: number;
@@ -900,15 +899,15 @@ interface WeappIdeMcpRuntimeHooks {
     timeout?: number;
   }, runner: (miniProgram: MiniProgramLike) => Promise<T>) => Promise<T>;
 }
-interface WeappIdeMcpServerOptions {
+export interface WeappIdeMcpServerOptions {
   runtimeHooks: WeappIdeMcpRuntimeHooks;
   workspaceRoot?: string;
 }
-interface WeappIdeMcpServerHandle {
+export interface WeappIdeMcpServerHandle {
   close: () => Promise<void>;
 }
-declare function registerWeappIdeMcpTools(server: ToolRegistrar, options: WeappIdeMcpServerOptions): void;
-declare function createWeappIdeMcpServer(options: WeappIdeMcpServerOptions): Promise<{
+export declare function registerWeappIdeMcpTools(server: ToolRegistrar, options: WeappIdeMcpServerOptions): void;
+export declare function createWeappIdeMcpServer(options: WeappIdeMcpServerOptions): Promise<{
   close: () => Promise<undefined>;
   server: McpServer;
 }>;
@@ -918,7 +917,7 @@ declare function createWeappIdeMcpServer(options: WeappIdeMcpServerOptions): Pro
  * @description 官方微信开发者工具只支持 Windows、macOS，Linux 只有社区版。
  * https://github.com/msojocs/wechat-web-devtools-linux
  */
-declare const SupportedPlatformsMap: {
+export declare const SupportedPlatformsMap: {
   readonly Windows_NT: "Windows_NT";
   readonly Darwin: "Darwin";
   readonly Linux: "Linux";
@@ -926,37 +925,37 @@ declare const SupportedPlatformsMap: {
 /**
  * @description 支持的系统类型。
  */
-type SupportedPlatform = (typeof SupportedPlatformsMap)[keyof typeof SupportedPlatformsMap];
+export type SupportedPlatform = (typeof SupportedPlatformsMap)[keyof typeof SupportedPlatformsMap];
 /**
  * @description 判断当前系统是否支持微信开发者工具。
  */
-declare function isOperatingSystemSupported(osName?: string): osName is SupportedPlatform;
+export declare function isOperatingSystemSupported(osName?: string): osName is SupportedPlatform;
 /**
  * @description 当前系统名称。
  */
-declare const operatingSystemName: string;
+export declare const operatingSystemName: string;
 /**
  * @description 获取默认 CLI 路径（按系统）。
  */
-declare function getDefaultCliPath(targetOs?: string): Promise<string | undefined>;
+export declare function getDefaultCliPath(targetOs?: string): Promise<string | undefined>;
 //#endregion
 //#region src/utils/argv.d.ts
 /**
  * @description argv 处理函数
  */
-type ArgvTransform = (argv: readonly string[]) => string[];
+export type ArgvTransform = (argv: readonly string[]) => string[];
 /**
  * @description 依次应用 argv 处理函数（不修改原始 argv）
  */
-declare function transformArgv(argv: readonly string[], transforms: readonly ArgvTransform[]): string[];
+export declare function transformArgv(argv: readonly string[], transforms: readonly ArgvTransform[]): string[];
 /**
  * @description 创建参数别名转换器
  */
-declare function createAlias(entry: AliasEntry): ArgvTransform;
+export declare function createAlias(entry: AliasEntry): ArgvTransform;
 /**
  * @description 创建路径参数兼容转换器（补全或规范化路径）
  */
-declare function createPathCompat(option: string): ArgvTransform;
+export declare function createPathCompat(option: string): ArgvTransform;
 //#endregion
 //#region src/utils/exec.d.ts
 interface ExecuteOptions {
@@ -967,7 +966,7 @@ interface ExecuteOptions {
 /**
  * @description 执行 CLI 命令并透传输出
  */
-declare function execute(cliPath: string, argv: string[], options?: ExecuteOptions): Promise<import("execa").Result<{
+export declare function execute(cliPath: string, argv: string[], options?: ExecuteOptions): Promise<import("execa").Result<{
   timeout: number | undefined;
 }>>;
 //#endregion
@@ -975,6 +974,6 @@ declare function execute(cliPath: string, argv: string[], options?: ExecuteOptio
 /**
  * @description 解析为绝对路径（基于当前工作目录）
  */
-declare function resolvePath(filePath: string): string;
+export declare function resolvePath(filePath: string): string;
 //#endregion
-export { AUTOMATOR_COMMAND_NAMES, ArgvTransform, AuditOptions, AutoPreviewWechatIdeOptions, AutoReplayWechatIdeOptions, AutoWechatIdeOptions, AutomatorCommandOptions, AutomatorOptions, AutomatorSessionOptions, type BaseConfig, BootstrapWechatDevtoolsSettingsOptions, BootstrapWechatDevtoolsSettingsResult, BuildWechatIdeApkOptions, BuildWechatIdeIpaOptions, BuildWechatIdeNpmOptions, CONFIG_COMMAND_NAME, ClearWechatIdeCacheByAutomatorOptions, ClearWechatIdeCacheOptions, CompileWechatIdeByAutomatorOptions, type ConfigSource, DetectWechatDevtoolsServicePortOptions, DetectWechatDevtoolsServicePortResult, DetectedWechatDevtoolsServicePortSettings, type DevtoolsConnectionInput, type DevtoolsContext, type DevtoolsElementSnapshot, type DevtoolsPageSnapshot, type DevtoolsToolResult, ExclusiveKeypressOptions, ForwardConsoleEvent, ForwardConsoleLogLevel, ForwardConsoleOptions, ForwardConsoleSession, InputOptions, LoginWechatIdeOptions, MCP_COMMAND_NAME, MINIDEV_NAMESPACE_COMMAND_NAMES, McpCommandOptions, MiniProgramElement, type MiniProgramEventMap, MiniProgramLike, MiniProgramPage, NavigateOptions, OpenWechatIdeOptions, OpenWechatIdeOtherProjectOptions, PageDataOptions, PageInfoOptions, ParsedAutomatorArgs, PollWechatIdeEngineBuildResult, PreviewWechatIdeOptions, RETRY_CANCEL_KEYS, RETRY_CONFIRM_KEYS, RETRY_PROMPT_INITIAL_IGNORE_MS, RemoteOptions, ResetWechatIdeFileUtilsOptions, type ResolvedConfig, RetryKeypressOptions, RetryLogger, RetryPromptOptions, RetryPromptResult, RetryableCommandExecutorOptions, RunWechatCliWithRetryOptions, RunWechatIdeEngineBuildByHttpOptions, RunWechatIdeEngineBuildOptions, ScreenshotOptions, ScreenshotResult, ScrollOptions, SelectorOptions, SetWechatIdeTicketOptions, SharedInputSession, SharedInputSessionOptions, StartWeappIdeMcpServerOptions, StartWechatIdeEngineBuildResult, SupportedPlatform, SupportedPlatformsMap, TapOptions, UploadWechatIdeOptions, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, WECHAT_CLI_COMMAND_NAMES, WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES, WeappIdeMcpRuntimeHooks, WeappIdeMcpServerHandle, WeappIdeMcpServerOptions, WechatDevtoolsEngineBuildResult, WechatDevtoolsHttpCommandOptions, WechatDevtoolsSecuritySettings, WechatIdeAutomatorSessionOptions, WechatIdeLoginRetryOptions, acquireSharedMiniProgram, audit, autoPreviewWechatIde, autoReplayWechatIde, autoWechatIde, bootstrapWechatDevtoolsSettings, buildWechatIdeApk, buildWechatIdeIpa, buildWechatIdeNpm, captureScreenshotBuffer, clearWechatIdeCache, clearWechatIdeCacheByAutomator, closeSharedMiniProgram, closeWechatIdeProject, compileWechatIdeByAutomator, connectMiniProgram, connectOpenedAutomator, createAlias, createAutoBootstrapDevtoolsConfig, createAutoTrustProjectConfig, createCli, createCustomConfig, createLocaleConfig, createPathCompat, createSharedInputSession, createWeappIdeMcpServer, createWechatIdeLoginRequiredExitError, currentPage, defaultCustomConfigDirPath, defaultCustomConfigFilePath, detectWechatDevtoolsServicePort, dispatchWechatCliCommand, execute, extractExecutionErrorText, formatAutomatorLoginError, formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getAutomatorCommandHelp, getAutomatorProtocolTimeoutMethod, getConfig, getConfiguredLocale, getDefaultCliPath, getRuntimeWechatDevtoolsServicePort, getSharedMiniProgramSessionCount, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, handleConfigCommand, input, isAutomatorCommand, isAutomatorLoginError, isAutomatorPortInUseError, isAutomatorProtocolTimeoutError, isAutomatorWsConnectError, isDevtoolsExtensionContextInvalidatedError, isDevtoolsHttpPortError, isOperatingSystemSupported, isRetryableAutomatorLaunchError, isWeappIdeTopLevelCommand, isWechatIdeEngineBuildEndpointMissingError, isWechatIdeLoggedIn, isWechatIdeLoginRequiredError, isWechatIdeLoginRequiredExitError, launchAutomator, loginWechatIde, navigateBack, navigateTo, openWechatIde, openWechatIdeOtherProject, openWechatIdeProjectByHttp, operatingSystemName, overwriteCustomConfig, pageData, pageStack, parse, parseAutomatorArgs, parseCompareArgs, parseScreenshotArgs, pollWechatIdeEngineBuildResultByHttp, previewWechatIde, printCompareHelp, printScreenshotHelp, promptForCliPath, promptRetryKeypress, promptWechatIdeLoginRetry, quitWechatIde, reLaunch, readBooleanOption, readCustomConfig, readElementSnapshot, readOptionValue, redirectTo, refreshWechatIdeTicket, registerWeappIdeMcpTools, releaseSharedMiniProgram, remote, removeCustomConfigKey, removeOption, requestWechatDevtoolsHttp, resetWechatIdeFileUtils, resetWechatIdeFileUtilsByHttp, resolveCliPath, resolveDevtoolsAutomationDefaults, resolvePath, resolveProjectAutomatorPort, resolveProjectPath, runAutomatorCommand, runMcpCommand, runMinidev, runRetryableCommand, runWechatCliWithRetry, runWechatIdeEngineBuild, runWechatIdeEngineBuildByHttp, runWithSuspendedSharedInput, scrollTo, setRuntimeWechatDevtoolsServicePort, setWechatIdeTicket, startForwardConsole, startWeappIdeMcpServer, startWechatIdeEngineBuildByHttp, switchTab, systemInfo, takeScreenshot, tap, toSerializableValue, transformArgv, uploadWechatIde, validateWechatCliCommandArgs, waitForExclusiveKeypress, waitForRetryKeypress, withMiniProgram };
+export { type AutomatorSessionOptions, type BaseConfig, type ConfigSource, type DevtoolsConnectionInput, type DevtoolsContext, type DevtoolsElementSnapshot, type DevtoolsPageSnapshot, type DevtoolsToolResult, type MiniProgramElement, type MiniProgramEventMap, type MiniProgramLike, type MiniProgramPage, type ResolvedConfig, closeSharedMiniProgram, getSharedMiniProgramSessionCount, readElementSnapshot, releaseSharedMiniProgram, resolveProjectPath, toSerializableValue };