moonbridge-ts 0.1.0

package/dist/moonbridge-ipc/general/app_launch/model/app_launch_models_extension.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 基于当前运行环境（typeof window / process.platform）从 AppLaunchIdentifier、AppInstallationPath、AppLaunchArguments 取当前平台对应值。
+ * 与 Flutter 平台扩展语义一致。
+ */
+import { AppLaunchArguments } from './app_launch_models.js';
+import { AppInstallationPath, AppLaunchIdentifier } from './app_info.js';
+/**
+ * 基于当前运行环境的模型扩展（013：一级函数收敛为类静态方法）。
+ */
+export declare class AppLaunchModelsExtension {
+    /**
+     * 当前平台下应用标识（可执行名/Bundle ID/Scheme/包名）。
+     * 浏览器视为 Web，返回 iOSScheme；Node 按 process.platform 返回对应字段。
+     */
+    static getCurrentPlatformIdentifier(id: AppLaunchIdentifier): string | undefined;
+    /**
+     * 当前平台下安装路径。仅 Node 桌面端有效；浏览器返回 undefined。
+     */
+    static getCurrentPlatformPath(path: AppInstallationPath): string | undefined;
+    /**
+     * 当前平台下启动参数数组。浏览器返回 iOS；Node 返回 windows/macOS 命令行参数。
+     */
+    static getCurrentPlatformArguments(args: AppLaunchArguments): string[];
+}
+//# sourceMappingURL=app_launch_models_extension.d.ts.map

package/dist/moonbridge-ipc/general/app_launch/model/app_launch_models_extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app_launch_models_extension.d.ts","sourceRoot":"","sources":["../../../../../src/moonbridge-ipc/general/app_launch/model/app_launch_models_extension.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAKzE;;GAEG;AACH,qBAAa,wBAAwB;IACnC;;;OAGG;IACH,MAAM,CAAC,4BAA4B,CACjC,EAAE,EAAE,mBAAmB,GACtB,MAAM,GAAG,SAAS;IAWrB;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAC3B,IAAI,EAAE,mBAAmB,GACxB,MAAM,GAAG,SAAS;IAWrB;;OAEG;IACH,MAAM,CAAC,2BAA2B,CAChC,IAAI,EAAE,kBAAkB,GACvB,MAAM,EAAE;CAUZ"}

package/dist/moonbridge-ipc/general/app_launch/model/app_launch_models_extension.js

@@ -0,0 +1,49 @@
+'use strict';
+
+const isBrowser = typeof window !== "undefined" && typeof window.document !== "undefined";
+class AppLaunchModelsExtension {
+  /**
+   * 当前平台下应用标识（可执行名/Bundle ID/Scheme/包名）。
+   * 浏览器视为 Web，返回 iOSScheme；Node 按 process.platform 返回对应字段。
+   */
+  static getCurrentPlatformIdentifier(id) {
+    if (isBrowser) return id.iOSScheme;
+    if (typeof process !== "undefined" && process.platform === "win32") {
+      return id.windowsExecutable;
+    }
+    if (typeof process !== "undefined" && process.platform === "darwin") {
+      return id.macOSBundleId;
+    }
+    return void 0;
+  }
+  /**
+   * 当前平台下安装路径。仅 Node 桌面端有效；浏览器返回 undefined。
+   */
+  static getCurrentPlatformPath(path) {
+    if (isBrowser) return void 0;
+    if (typeof process !== "undefined" && process.platform === "win32") {
+      return path.windows;
+    }
+    if (typeof process !== "undefined" && process.platform === "darwin") {
+      return path.macOS;
+    }
+    return void 0;
+  }
+  /**
+   * 当前平台下启动参数数组。浏览器返回 iOS；Node 返回 windows/macOS 命令行参数。
+   */
+  static getCurrentPlatformArguments(args) {
+    if (isBrowser) return args.iOS;
+    if (typeof process !== "undefined" && process.platform === "win32") {
+      return args.windows;
+    }
+    if (typeof process !== "undefined" && process.platform === "darwin") {
+      return args.macOS;
+    }
+    return [];
+  }
+}
+
+exports.AppLaunchModelsExtension = AppLaunchModelsExtension;
+//# sourceMappingURL=app_launch_models_extension.js.map
+//# sourceMappingURL=app_launch_models_extension.js.map

package/dist/moonbridge-ipc/general/app_launch/model/app_launch_models_extension.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/moonbridge-ipc/general/app_launch/model/app_launch_models_extension.ts"],"names":[],"mappings":";;AAQA,MAAM,YACJ,OAAO,MAAA,KAAW,WAAA,IAAe,OAAO,OAAO,QAAA,KAAa,WAAA;AAKvD,MAAM,wBAAA,CAAyB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKpC,OAAO,6BACL,EAAA,EACoB;AACpB,IAAA,IAAI,SAAA,SAAkB,EAAA,CAAG,SAAA;AACzB,IAAA,IAAI,OAAO,OAAA,KAAY,WAAA,IAAe,OAAA,CAAQ,aAAa,OAAA,EAAS;AAClE,MAAA,OAAO,EAAA,CAAG,iBAAA;AAAA,IACZ;AACA,IAAA,IAAI,OAAO,OAAA,KAAY,WAAA,IAAe,OAAA,CAAQ,aAAa,QAAA,EAAU;AACnE,MAAA,OAAO,EAAA,CAAG,aAAA;AAAA,IACZ;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,uBACL,IAAA,EACoB;AACpB,IAAA,IAAI,WAAW,OAAO,MAAA;AACtB,IAAA,IAAI,OAAO,OAAA,KAAY,WAAA,IAAe,OAAA,CAAQ,aAAa,OAAA,EAAS;AAClE,MAAA,OAAO,IAAA,CAAK,OAAA;AAAA,IACd;AACA,IAAA,IAAI,OAAO,OAAA,KAAY,WAAA,IAAe,OAAA,CAAQ,aAAa,QAAA,EAAU;AACnE,MAAA,OAAO,IAAA,CAAK,KAAA;AAAA,IACd;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,4BACL,IAAA,EACU;AACV,IAAA,IAAI,SAAA,SAAkB,IAAA,CAAK,GAAA;AAC3B,IAAA,IAAI,OAAO,OAAA,KAAY,WAAA,IAAe,OAAA,CAAQ,aAAa,OAAA,EAAS;AAClE,MAAA,OAAO,IAAA,CAAK,OAAA;AAAA,IACd;AACA,IAAA,IAAI,OAAO,OAAA,KAAY,WAAA,IAAe,OAAA,CAAQ,aAAa,QAAA,EAAU;AACnE,MAAA,OAAO,IAAA,CAAK,KAAA;AAAA,IACd;AACA,IAAA,OAAO,EAAC;AAAA,EACV;AACF","file":"app_launch_models_extension.js","sourcesContent":["/**\n * 基于当前运行环境（typeof window / process.platform）从 AppLaunchIdentifier、AppInstallationPath、AppLaunchArguments 取当前平台对应值。\n * 与 Flutter 平台扩展语义一致。\n */\n\nimport { AppLaunchArguments } from './app_launch_models.js';\nimport { AppInstallationPath, AppLaunchIdentifier } from './app_info.js';\n\nconst isBrowser =\n  typeof window !== 'undefined' && typeof window.document !== 'undefined';\n\n/**\n * 基于当前运行环境的模型扩展（013：一级函数收敛为类静态方法）。\n */\nexport class AppLaunchModelsExtension {\n  /**\n   * 当前平台下应用标识（可执行名/Bundle ID/Scheme/包名）。\n   * 浏览器视为 Web，返回 iOSScheme；Node 按 process.platform 返回对应字段。\n   */\n  static getCurrentPlatformIdentifier(\n    id: AppLaunchIdentifier,\n  ): string | undefined {\n    if (isBrowser) return id.iOSScheme;\n    if (typeof process !== 'undefined' && process.platform === 'win32') {\n      return id.windowsExecutable;\n    }\n    if (typeof process !== 'undefined' && process.platform === 'darwin') {\n      return id.macOSBundleId;\n    }\n    return undefined;\n  }\n\n  /**\n   * 当前平台下安装路径。仅 Node 桌面端有效；浏览器返回 undefined。\n   */\n  static getCurrentPlatformPath(\n    path: AppInstallationPath,\n  ): string | undefined {\n    if (isBrowser) return undefined;\n    if (typeof process !== 'undefined' && process.platform === 'win32') {\n      return path.windows;\n    }\n    if (typeof process !== 'undefined' && process.platform === 'darwin') {\n      return path.macOS;\n    }\n    return undefined;\n  }\n\n  /**\n   * 当前平台下启动参数数组。浏览器返回 iOS；Node 返回 windows/macOS 命令行参数。\n   */\n  static getCurrentPlatformArguments(\n    args: AppLaunchArguments,\n  ): string[] {\n    if (isBrowser) return args.iOS;\n    if (typeof process !== 'undefined' && process.platform === 'win32') {\n      return args.windows;\n    }\n    if (typeof process !== 'undefined' && process.platform === 'darwin') {\n      return args.macOS;\n    }\n    return [];\n  }\n}\n\n"]}

package/dist/moonbridge-ipc/general/app_launch/model/app_launch_models_extension.mjs

@@ -0,0 +1,47 @@
+const isBrowser = typeof window !== "undefined" && typeof window.document !== "undefined";
+class AppLaunchModelsExtension {
+  /**
+   * 当前平台下应用标识（可执行名/Bundle ID/Scheme/包名）。
+   * 浏览器视为 Web，返回 iOSScheme；Node 按 process.platform 返回对应字段。
+   */
+  static getCurrentPlatformIdentifier(id) {
+    if (isBrowser) return id.iOSScheme;
+    if (typeof process !== "undefined" && process.platform === "win32") {
+      return id.windowsExecutable;
+    }
+    if (typeof process !== "undefined" && process.platform === "darwin") {
+      return id.macOSBundleId;
+    }
+    return void 0;
+  }
+  /**
+   * 当前平台下安装路径。仅 Node 桌面端有效；浏览器返回 undefined。
+   */
+  static getCurrentPlatformPath(path) {
+    if (isBrowser) return void 0;
+    if (typeof process !== "undefined" && process.platform === "win32") {
+      return path.windows;
+    }
+    if (typeof process !== "undefined" && process.platform === "darwin") {
+      return path.macOS;
+    }
+    return void 0;
+  }
+  /**
+   * 当前平台下启动参数数组。浏览器返回 iOS；Node 返回 windows/macOS 命令行参数。
+   */
+  static getCurrentPlatformArguments(args) {
+    if (isBrowser) return args.iOS;
+    if (typeof process !== "undefined" && process.platform === "win32") {
+      return args.windows;
+    }
+    if (typeof process !== "undefined" && process.platform === "darwin") {
+      return args.macOS;
+    }
+    return [];
+  }
+}
+
+export { AppLaunchModelsExtension };
+//# sourceMappingURL=app_launch_models_extension.mjs.map
+//# sourceMappingURL=app_launch_models_extension.mjs.map

package/dist/moonbridge-ipc/general/app_launch/model/app_launch_models_extension.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/moonbridge-ipc/general/app_launch/model/app_launch_models_extension.ts"],"names":[],"mappings":"AAQA,MAAM,YACJ,OAAO,MAAA,KAAW,WAAA,IAAe,OAAO,OAAO,QAAA,KAAa,WAAA;AAKvD,MAAM,wBAAA,CAAyB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKpC,OAAO,6BACL,EAAA,EACoB;AACpB,IAAA,IAAI,SAAA,SAAkB,EAAA,CAAG,SAAA;AACzB,IAAA,IAAI,OAAO,OAAA,KAAY,WAAA,IAAe,OAAA,CAAQ,aAAa,OAAA,EAAS;AAClE,MAAA,OAAO,EAAA,CAAG,iBAAA;AAAA,IACZ;AACA,IAAA,IAAI,OAAO,OAAA,KAAY,WAAA,IAAe,OAAA,CAAQ,aAAa,QAAA,EAAU;AACnE,MAAA,OAAO,EAAA,CAAG,aAAA;AAAA,IACZ;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,uBACL,IAAA,EACoB;AACpB,IAAA,IAAI,WAAW,OAAO,MAAA;AACtB,IAAA,IAAI,OAAO,OAAA,KAAY,WAAA,IAAe,OAAA,CAAQ,aAAa,OAAA,EAAS;AAClE,MAAA,OAAO,IAAA,CAAK,OAAA;AAAA,IACd;AACA,IAAA,IAAI,OAAO,OAAA,KAAY,WAAA,IAAe,OAAA,CAAQ,aAAa,QAAA,EAAU;AACnE,MAAA,OAAO,IAAA,CAAK,KAAA;AAAA,IACd;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,4BACL,IAAA,EACU;AACV,IAAA,IAAI,SAAA,SAAkB,IAAA,CAAK,GAAA;AAC3B,IAAA,IAAI,OAAO,OAAA,KAAY,WAAA,IAAe,OAAA,CAAQ,aAAa,OAAA,EAAS;AAClE,MAAA,OAAO,IAAA,CAAK,OAAA;AAAA,IACd;AACA,IAAA,IAAI,OAAO,OAAA,KAAY,WAAA,IAAe,OAAA,CAAQ,aAAa,QAAA,EAAU;AACnE,MAAA,OAAO,IAAA,CAAK,KAAA;AAAA,IACd;AACA,IAAA,OAAO,EAAC;AAAA,EACV;AACF","file":"app_launch_models_extension.mjs","sourcesContent":["/**\n * 基于当前运行环境（typeof window / process.platform）从 AppLaunchIdentifier、AppInstallationPath、AppLaunchArguments 取当前平台对应值。\n * 与 Flutter 平台扩展语义一致。\n */\n\nimport { AppLaunchArguments } from './app_launch_models.js';\nimport { AppInstallationPath, AppLaunchIdentifier } from './app_info.js';\n\nconst isBrowser =\n  typeof window !== 'undefined' && typeof window.document !== 'undefined';\n\n/**\n * 基于当前运行环境的模型扩展（013：一级函数收敛为类静态方法）。\n */\nexport class AppLaunchModelsExtension {\n  /**\n   * 当前平台下应用标识（可执行名/Bundle ID/Scheme/包名）。\n   * 浏览器视为 Web，返回 iOSScheme；Node 按 process.platform 返回对应字段。\n   */\n  static getCurrentPlatformIdentifier(\n    id: AppLaunchIdentifier,\n  ): string | undefined {\n    if (isBrowser) return id.iOSScheme;\n    if (typeof process !== 'undefined' && process.platform === 'win32') {\n      return id.windowsExecutable;\n    }\n    if (typeof process !== 'undefined' && process.platform === 'darwin') {\n      return id.macOSBundleId;\n    }\n    return undefined;\n  }\n\n  /**\n   * 当前平台下安装路径。仅 Node 桌面端有效；浏览器返回 undefined。\n   */\n  static getCurrentPlatformPath(\n    path: AppInstallationPath,\n  ): string | undefined {\n    if (isBrowser) return undefined;\n    if (typeof process !== 'undefined' && process.platform === 'win32') {\n      return path.windows;\n    }\n    if (typeof process !== 'undefined' && process.platform === 'darwin') {\n      return path.macOS;\n    }\n    return undefined;\n  }\n\n  /**\n   * 当前平台下启动参数数组。浏览器返回 iOS；Node 返回 windows/macOS 命令行参数。\n   */\n  static getCurrentPlatformArguments(\n    args: AppLaunchArguments,\n  ): string[] {\n    if (isBrowser) return args.iOS;\n    if (typeof process !== 'undefined' && process.platform === 'win32') {\n      return args.windows;\n    }\n    if (typeof process !== 'undefined' && process.platform === 'darwin') {\n      return args.macOS;\n    }\n    return [];\n  }\n}\n\n"]}

package/dist/moonbridge-ipc/general/app_launch/platform_app_launcher.d.mts

@@ -0,0 +1,46 @@
+import { AppLaunchIdentifier, AppInstallationPath } from './model/app_info.mjs';
+import { AppLaunchArguments, AppLaunchResult } from './model/app_launch_models.mjs';
+
+/**
+ * 平台应用启动器接口与工厂，与 Flutter PlatformAppLauncher 行为对齐。
+ * 与 contracts/app_launch_api.md 一致。
+ * 平台分派：浏览器且存在 iOSScheme → BrowserPlatformAppLauncher；
+ * Node (win32/darwin) 且存在当前平台安装路径 → NodePlatformAppLauncher；否则 → StubPlatformAppLauncher。
+ */
+
+/** launchApp 可选参数，与 Flutter 语义一致 */
+interface LaunchAppOptions {
+    /** 应用启动标识对应的启动参数 */
+    argumentsForIdentifier?: AppLaunchArguments;
+    /** 应用安装路径对应的启动参数 */
+    argumentsForInstallationPath?: AppLaunchArguments;
+    /** 状态检查间隔（秒），默认 0.3 */
+    statusCheckInterval?: number;
+    /** 操作超时（秒），默认 3.0 */
+    operationTimeout?: number;
+}
+/**
+ * 平台应用启动器：按标识符或安装路径启动应用，并支持进程/运行状态检测。
+ */
+interface PlatformAppLauncher {
+    launchApp(options?: LaunchAppOptions): Promise<AppLaunchResult>;
+    isAppRunning(): Promise<boolean>;
+}
+/**
+ * 平台启动器工厂（013：一级函数收敛为类静态方法）。
+ * 根据当前运行环境返回平台启动器实例。
+ */
+declare class PlatformAppLauncherFactory {
+    /**
+     * 根据当前运行环境返回平台启动器实例。
+     * 浏览器且 appIdentifier 含 iOSScheme 时返回 BrowserPlatformAppLauncher；
+     * Node 且 (win32/darwin) 且 appInstallationPath 含当前平台路径时返回 NodePlatformAppLauncher；
+     * 否则返回 Stub。
+     */
+    static create({ appIdentifier, appInstallationPath, }: {
+        appIdentifier?: AppLaunchIdentifier;
+        appInstallationPath?: AppInstallationPath;
+    }): PlatformAppLauncher;
+}
+
+export { type LaunchAppOptions, type PlatformAppLauncher, PlatformAppLauncherFactory };

package/dist/moonbridge-ipc/general/app_launch/platform_app_launcher.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 平台应用启动器接口与工厂，与 Flutter PlatformAppLauncher 行为对齐。
+ * 与 contracts/app_launch_api.md 一致。
+ * 平台分派：浏览器且存在 iOSScheme → BrowserPlatformAppLauncher；
+ * Node (win32/darwin) 且存在当前平台安装路径 → NodePlatformAppLauncher；否则 → StubPlatformAppLauncher。
+ */
+import { AppInstallationPath } from './model/app_info.js';
+import { AppLaunchArguments, AppLaunchResult } from './model/app_launch_models.js';
+import { AppLaunchIdentifier } from './model/app_info.js';
+/** launchApp 可选参数，与 Flutter 语义一致 */
+export interface LaunchAppOptions {
+    /** 应用启动标识对应的启动参数 */
+    argumentsForIdentifier?: AppLaunchArguments;
+    /** 应用安装路径对应的启动参数 */
+    argumentsForInstallationPath?: AppLaunchArguments;
+    /** 状态检查间隔（秒），默认 0.3 */
+    statusCheckInterval?: number;
+    /** 操作超时（秒），默认 3.0 */
+    operationTimeout?: number;
+}
+/**
+ * 平台应用启动器：按标识符或安装路径启动应用，并支持进程/运行状态检测。
+ */
+export interface PlatformAppLauncher {
+    launchApp(options?: LaunchAppOptions): Promise<AppLaunchResult>;
+    isAppRunning(): Promise<boolean>;
+}
+/**
+ * 平台启动器工厂（013：一级函数收敛为类静态方法）。
+ * 根据当前运行环境返回平台启动器实例。
+ */
+export declare class PlatformAppLauncherFactory {
+    /**
+     * 根据当前运行环境返回平台启动器实例。
+     * 浏览器且 appIdentifier 含 iOSScheme 时返回 BrowserPlatformAppLauncher；
+     * Node 且 (win32/darwin) 且 appInstallationPath 含当前平台路径时返回 NodePlatformAppLauncher；
+     * 否则返回 Stub。
+     */
+    static create({ appIdentifier, appInstallationPath, }: {
+        appIdentifier?: AppLaunchIdentifier;
+        appInstallationPath?: AppInstallationPath;
+    }): PlatformAppLauncher;
+}
+//# sourceMappingURL=platform_app_launcher.d.ts.map

package/dist/moonbridge-ipc/general/app_launch/platform_app_launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform_app_launcher.d.ts","sourceRoot":"","sources":["../../../../src/moonbridge-ipc/general/app_launch/platform_app_launcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAO1D,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,sBAAsB,CAAC,EAAE,kBAAkB,CAAC;IAC5C,oBAAoB;IACpB,4BAA4B,CAAC,EAAE,kBAAkB,CAAC;IAClD,uBAAuB;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qBAAqB;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAChE,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC;AAwBD;;;GAGG;AACH,qBAAa,0BAA0B;IACrC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,EACZ,aAAa,EACb,mBAAmB,GACpB,EAAE;QACD,aAAa,CAAC,EAAE,mBAAmB,CAAC;QACpC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;KAC3C,GAAG,mBAAmB;CAaxB"}

package/dist/moonbridge-ipc/general/app_launch/platform_app_launcher.js

@@ -0,0 +1,47 @@
+'use strict';
+
+var app_info_js = require('./model/app_info.js');
+var real_platform_app_launcher_js = require('./internal/real_platform_app_launcher.js');
+
+const isBrowser = typeof window !== "undefined" && typeof window.document !== "undefined";
+const NODE_PLATFORMS = [
+  "aix",
+  "android",
+  "darwin",
+  "freebsd",
+  "haiku",
+  "linux",
+  "openbsd",
+  "sunos",
+  "win32",
+  "cygwin",
+  "netbsd"
+];
+const isNode = typeof process !== "undefined" && typeof process.platform === "string" && NODE_PLATFORMS.includes(process.platform);
+class PlatformAppLauncherFactory {
+  /**
+   * 根据当前运行环境返回平台启动器实例。
+   * 浏览器且 appIdentifier 含 iOSScheme 时返回 BrowserPlatformAppLauncher；
+   * Node 且 (win32/darwin) 且 appInstallationPath 含当前平台路径时返回 NodePlatformAppLauncher；
+   * 否则返回 Stub。
+   */
+  static create({
+    appIdentifier,
+    appInstallationPath
+  }) {
+    if (!appIdentifier && !appInstallationPath) {
+      throw new Error("appIdentifier \u6216 appInstallationPath \u4E0D\u80FD\u4E3A\u7A7A");
+    }
+    if (isBrowser) {
+      return new real_platform_app_launcher_js.BrowserPlatformAppLauncher(appIdentifier != null ? appIdentifier : new app_info_js.AppLaunchIdentifier({}));
+    } else if (isNode) {
+      return new real_platform_app_launcher_js.NodePlatformAppLauncher(appInstallationPath != null ? appInstallationPath : new app_info_js.AppInstallationPath({}));
+    } else {
+      return new real_platform_app_launcher_js.StubPlatformAppLauncher();
+    }
+  }
+}
+
+exports.PlatformAppLauncherFactory = PlatformAppLauncherFactory;
+//# sourceMappingURL=platform_app_launcher.js.map
+//# sourceMappingURL=platform_app_launcher.js.map

package/dist/moonbridge-ipc/general/app_launch/platform_app_launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/moonbridge-ipc/general/app_launch/platform_app_launcher.ts"],"names":["BrowserPlatformAppLauncher","AppLaunchIdentifier","NodePlatformAppLauncher","AppInstallationPath","StubPlatformAppLauncher"],"mappings":";;;;;AAuCA,MAAM,YACJ,OAAO,MAAA,KAAW,WAAA,IAAe,OAAO,OAAO,QAAA,KAAa,WAAA;AAK9D,MAAM,cAAA,GAA6C;AAAA,EACjD,KAAA;AAAA,EAAO,SAAA;AAAA,EAAW,QAAA;AAAA,EAAU,SAAA;AAAA,EAAW,OAAA;AAAA,EAAS,OAAA;AAAA,EAChD,SAAA;AAAA,EAAW,OAAA;AAAA,EAAS,OAAA;AAAA,EAAS,QAAA;AAAA,EAAU;AACzC,CAAA;AAKA,MAAM,MAAA,GACJ,OAAO,OAAA,KAAY,WAAA,IACnB,OAAO,OAAA,CAAQ,QAAA,KAAa,QAAA,IAC5B,cAAA,CAAe,QAAA,CAAS,OAAA,CAAQ,QAA2B,CAAA;AAMtD,MAAM,0BAAA,CAA2B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOtC,OAAO,MAAA,CAAO;AAAA,IACZ,aAAA;AAAA,IACA;AAAA,GACF,EAGwB;AACtB,IAAA,IAAI,CAAC,aAAA,IAAiB,CAAC,mBAAA,EAAqB;AAC1C,MAAA,MAAM,IAAI,MAAM,mEAA0C,CAAA;AAAA,IAC5D;AAEA,IAAA,IAAI,SAAA,EAAW;AACb,MAAA,OAAO,IAAIA,wDAAA,CAA2B,aAAA,IAAA,IAAA,GAAA,aAAA,GAAiB,IAAIC,+BAAA,CAAoB,EAAE,CAAC,CAAA;AAAA,IACpF,WAAW,MAAA,EAAQ;AACjB,MAAA,OAAO,IAAIC,qDAAA,CAAwB,mBAAA,IAAA,IAAA,GAAA,mBAAA,GAAuB,IAAIC,+BAAA,CAAoB,EAAE,CAAC,CAAA;AAAA,IACvF,CAAA,MAAO;AACL,MAAA,OAAO,IAAIC,qDAAA,EAAwB;AAAA,IACrC;AAAA,EACF;AACF","file":"platform_app_launcher.js","sourcesContent":["/**\n * 平台应用启动器接口与工厂，与 Flutter PlatformAppLauncher 行为对齐。\n * 与 contracts/app_launch_api.md 一致。\n * 平台分派：浏览器且存在 iOSScheme → BrowserPlatformAppLauncher；\n * Node (win32/darwin) 且存在当前平台安装路径 → NodePlatformAppLauncher；否则 → StubPlatformAppLauncher。\n */\n\nimport { AppInstallationPath } from './model/app_info.js';\nimport { AppLaunchArguments, AppLaunchResult } from './model/app_launch_models.js';\nimport { AppLaunchIdentifier } from './model/app_info.js';\nimport {\n  BrowserPlatformAppLauncher,\n  NodePlatformAppLauncher,\n  StubPlatformAppLauncher,\n} from './internal/real_platform_app_launcher.js';\n\n/** launchApp 可选参数，与 Flutter 语义一致 */\nexport interface LaunchAppOptions {\n  /** 应用启动标识对应的启动参数 */\n  argumentsForIdentifier?: AppLaunchArguments;\n  /** 应用安装路径对应的启动参数 */\n  argumentsForInstallationPath?: AppLaunchArguments;\n  /** 状态检查间隔（秒），默认 0.3 */\n  statusCheckInterval?: number;\n  /** 操作超时（秒），默认 3.0 */\n  operationTimeout?: number;\n}\n\n/**\n * 平台应用启动器：按标识符或安装路径启动应用，并支持进程/运行状态检测。\n */\nexport interface PlatformAppLauncher {\n  launchApp(options?: LaunchAppOptions): Promise<AppLaunchResult>;\n  isAppRunning(): Promise<boolean>;\n}\n\n/** \n * 是否为浏览器环境 \n */\nconst isBrowser =\n  typeof window !== 'undefined' && typeof window.document !== 'undefined';\n\n/** \n * Node 官方 Platform 集合（@types/node process.d.ts），用于区分 Node 与浏览器等环境 \n */\nconst NODE_PLATFORMS: readonly NodeJS.Platform[] = [\n  'aix', 'android', 'darwin', 'freebsd', 'haiku', 'linux',\n  'openbsd', 'sunos', 'win32', 'cygwin', 'netbsd',\n];\n\n/** \n * 是否为 Node 环境 \n */\nconst isNode =\n  typeof process !== 'undefined' &&\n  typeof process.platform === 'string' &&\n  NODE_PLATFORMS.includes(process.platform as NodeJS.Platform);\n\n/**\n * 平台启动器工厂（013：一级函数收敛为类静态方法）。\n * 根据当前运行环境返回平台启动器实例。\n */\nexport class PlatformAppLauncherFactory {\n  /**\n   * 根据当前运行环境返回平台启动器实例。\n   * 浏览器且 appIdentifier 含 iOSScheme 时返回 BrowserPlatformAppLauncher；\n   * Node 且 (win32/darwin) 且 appInstallationPath 含当前平台路径时返回 NodePlatformAppLauncher；\n   * 否则返回 Stub。\n   */\n  static create({\n    appIdentifier,\n    appInstallationPath,\n  }: {\n    appIdentifier?: AppLaunchIdentifier;\n    appInstallationPath?: AppInstallationPath;\n  }): PlatformAppLauncher {\n    if (!appIdentifier && !appInstallationPath) {\n      throw new Error('appIdentifier 或 appInstallationPath 不能为空');\n    }\n\n    if (isBrowser) {\n      return new BrowserPlatformAppLauncher(appIdentifier ?? new AppLaunchIdentifier({}));\n    } else if (isNode) {\n      return new NodePlatformAppLauncher(appInstallationPath ?? new AppInstallationPath({}));\n    } else {\n      return new StubPlatformAppLauncher();\n    }\n  }\n}\n"]}

package/dist/moonbridge-ipc/general/app_launch/platform_app_launcher.mjs

@@ -0,0 +1,45 @@
+import { AppLaunchIdentifier, AppInstallationPath } from './model/app_info.js';
+import { BrowserPlatformAppLauncher, NodePlatformAppLauncher, StubPlatformAppLauncher } from './internal/real_platform_app_launcher.js';
+
+const isBrowser = typeof window !== "undefined" && typeof window.document !== "undefined";
+const NODE_PLATFORMS = [
+  "aix",
+  "android",
+  "darwin",
+  "freebsd",
+  "haiku",
+  "linux",
+  "openbsd",
+  "sunos",
+  "win32",
+  "cygwin",
+  "netbsd"
+];
+const isNode = typeof process !== "undefined" && typeof process.platform === "string" && NODE_PLATFORMS.includes(process.platform);
+class PlatformAppLauncherFactory {
+  /**
+   * 根据当前运行环境返回平台启动器实例。
+   * 浏览器且 appIdentifier 含 iOSScheme 时返回 BrowserPlatformAppLauncher；
+   * Node 且 (win32/darwin) 且 appInstallationPath 含当前平台路径时返回 NodePlatformAppLauncher；
+   * 否则返回 Stub。
+   */
+  static create({
+    appIdentifier,
+    appInstallationPath
+  }) {
+    if (!appIdentifier && !appInstallationPath) {
+      throw new Error("appIdentifier \u6216 appInstallationPath \u4E0D\u80FD\u4E3A\u7A7A");
+    }
+    if (isBrowser) {
+      return new BrowserPlatformAppLauncher(appIdentifier != null ? appIdentifier : new AppLaunchIdentifier({}));
+    } else if (isNode) {
+      return new NodePlatformAppLauncher(appInstallationPath != null ? appInstallationPath : new AppInstallationPath({}));
+    } else {
+      return new StubPlatformAppLauncher();
+    }
+  }
+}
+
+export { PlatformAppLauncherFactory };
+//# sourceMappingURL=platform_app_launcher.mjs.map
+//# sourceMappingURL=platform_app_launcher.mjs.map

package/dist/moonbridge-ipc/general/app_launch/platform_app_launcher.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/moonbridge-ipc/general/app_launch/platform_app_launcher.ts"],"names":[],"mappings":";;;AAuCA,MAAM,YACJ,OAAO,MAAA,KAAW,WAAA,IAAe,OAAO,OAAO,QAAA,KAAa,WAAA;AAK9D,MAAM,cAAA,GAA6C;AAAA,EACjD,KAAA;AAAA,EAAO,SAAA;AAAA,EAAW,QAAA;AAAA,EAAU,SAAA;AAAA,EAAW,OAAA;AAAA,EAAS,OAAA;AAAA,EAChD,SAAA;AAAA,EAAW,OAAA;AAAA,EAAS,OAAA;AAAA,EAAS,QAAA;AAAA,EAAU;AACzC,CAAA;AAKA,MAAM,MAAA,GACJ,OAAO,OAAA,KAAY,WAAA,IACnB,OAAO,OAAA,CAAQ,QAAA,KAAa,QAAA,IAC5B,cAAA,CAAe,QAAA,CAAS,OAAA,CAAQ,QAA2B,CAAA;AAMtD,MAAM,0BAAA,CAA2B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOtC,OAAO,MAAA,CAAO;AAAA,IACZ,aAAA;AAAA,IACA;AAAA,GACF,EAGwB;AACtB,IAAA,IAAI,CAAC,aAAA,IAAiB,CAAC,mBAAA,EAAqB;AAC1C,MAAA,MAAM,IAAI,MAAM,mEAA0C,CAAA;AAAA,IAC5D;AAEA,IAAA,IAAI,SAAA,EAAW;AACb,MAAA,OAAO,IAAI,0BAAA,CAA2B,aAAA,IAAA,IAAA,GAAA,aAAA,GAAiB,IAAI,mBAAA,CAAoB,EAAE,CAAC,CAAA;AAAA,IACpF,WAAW,MAAA,EAAQ;AACjB,MAAA,OAAO,IAAI,uBAAA,CAAwB,mBAAA,IAAA,IAAA,GAAA,mBAAA,GAAuB,IAAI,mBAAA,CAAoB,EAAE,CAAC,CAAA;AAAA,IACvF,CAAA,MAAO;AACL,MAAA,OAAO,IAAI,uBAAA,EAAwB;AAAA,IACrC;AAAA,EACF;AACF","file":"platform_app_launcher.mjs","sourcesContent":["/**\n * 平台应用启动器接口与工厂，与 Flutter PlatformAppLauncher 行为对齐。\n * 与 contracts/app_launch_api.md 一致。\n * 平台分派：浏览器且存在 iOSScheme → BrowserPlatformAppLauncher；\n * Node (win32/darwin) 且存在当前平台安装路径 → NodePlatformAppLauncher；否则 → StubPlatformAppLauncher。\n */\n\nimport { AppInstallationPath } from './model/app_info.js';\nimport { AppLaunchArguments, AppLaunchResult } from './model/app_launch_models.js';\nimport { AppLaunchIdentifier } from './model/app_info.js';\nimport {\n  BrowserPlatformAppLauncher,\n  NodePlatformAppLauncher,\n  StubPlatformAppLauncher,\n} from './internal/real_platform_app_launcher.js';\n\n/** launchApp 可选参数，与 Flutter 语义一致 */\nexport interface LaunchAppOptions {\n  /** 应用启动标识对应的启动参数 */\n  argumentsForIdentifier?: AppLaunchArguments;\n  /** 应用安装路径对应的启动参数 */\n  argumentsForInstallationPath?: AppLaunchArguments;\n  /** 状态检查间隔（秒），默认 0.3 */\n  statusCheckInterval?: number;\n  /** 操作超时（秒），默认 3.0 */\n  operationTimeout?: number;\n}\n\n/**\n * 平台应用启动器：按标识符或安装路径启动应用，并支持进程/运行状态检测。\n */\nexport interface PlatformAppLauncher {\n  launchApp(options?: LaunchAppOptions): Promise<AppLaunchResult>;\n  isAppRunning(): Promise<boolean>;\n}\n\n/** \n * 是否为浏览器环境 \n */\nconst isBrowser =\n  typeof window !== 'undefined' && typeof window.document !== 'undefined';\n\n/** \n * Node 官方 Platform 集合（@types/node process.d.ts），用于区分 Node 与浏览器等环境 \n */\nconst NODE_PLATFORMS: readonly NodeJS.Platform[] = [\n  'aix', 'android', 'darwin', 'freebsd', 'haiku', 'linux',\n  'openbsd', 'sunos', 'win32', 'cygwin', 'netbsd',\n];\n\n/** \n * 是否为 Node 环境 \n */\nconst isNode =\n  typeof process !== 'undefined' &&\n  typeof process.platform === 'string' &&\n  NODE_PLATFORMS.includes(process.platform as NodeJS.Platform);\n\n/**\n * 平台启动器工厂（013：一级函数收敛为类静态方法）。\n * 根据当前运行环境返回平台启动器实例。\n */\nexport class PlatformAppLauncherFactory {\n  /**\n   * 根据当前运行环境返回平台启动器实例。\n   * 浏览器且 appIdentifier 含 iOSScheme 时返回 BrowserPlatformAppLauncher；\n   * Node 且 (win32/darwin) 且 appInstallationPath 含当前平台路径时返回 NodePlatformAppLauncher；\n   * 否则返回 Stub。\n   */\n  static create({\n    appIdentifier,\n    appInstallationPath,\n  }: {\n    appIdentifier?: AppLaunchIdentifier;\n    appInstallationPath?: AppInstallationPath;\n  }): PlatformAppLauncher {\n    if (!appIdentifier && !appInstallationPath) {\n      throw new Error('appIdentifier 或 appInstallationPath 不能为空');\n    }\n\n    if (isBrowser) {\n      return new BrowserPlatformAppLauncher(appIdentifier ?? new AppLaunchIdentifier({}));\n    } else if (isNode) {\n      return new NodePlatformAppLauncher(appInstallationPath ?? new AppInstallationPath({}));\n    } else {\n      return new StubPlatformAppLauncher();\n    }\n  }\n}\n"]}

package/dist/moonbridge-ipc/general/config/port_candidate_rule.d.mts

@@ -0,0 +1,41 @@
+/**
+ * 端口候选规则，对应 Flutter lib/general/config/port_candidate_rule.dart。
+ * 生成确定性有序端口列表，服务端按序 try-bind，客户端按序 try-connect。
+ */
+declare const maxAttemptsCap = 128;
+/**
+ * 端口候选规则
+ */
+declare class PortCandidateRule {
+    private readonly _preferredPort;
+    private readonly _step;
+    private readonly _maxAttempts;
+    private readonly _ports;
+    private constructor();
+    /**
+     * 策略一：首选端口 + 步长。生成 [preferredPort, preferredPort+step, ...]，长度不超过 maxAttempts。
+     * @param preferredPort 首选端口
+     * @param options 选项
+     * @returns 端口候选规则
+     */
+    static preferred(preferredPort: number, options?: {
+        step?: number;
+        maxAttempts?: number;
+    }): PortCandidateRule;
+    /**
+     * 策略二：显式端口列表。按 ports 顺序使用，截断至 maxAttempts 并过滤非法端口。
+     * @param ports 端口列表
+     * @param options 选项
+     * @returns 端口候选规则
+     */
+    static explicit(ports: number[], options?: {
+        maxAttempts?: number;
+    }): PortCandidateRule;
+    /**
+     * 生成有序端口列表，每项 1..65535，长度不超过 maxAttempts。
+     * @returns 有序端口列表
+     */
+    toOrderedPortList(): number[];
+}
+
+export { PortCandidateRule, maxAttemptsCap };

package/dist/moonbridge-ipc/general/config/port_candidate_rule.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 端口候选规则，对应 Flutter lib/general/config/port_candidate_rule.dart。
+ * 生成确定性有序端口列表，服务端按序 try-bind，客户端按序 try-connect。
+ */
+export declare const maxAttemptsCap = 128;
+/**
+ * 端口候选规则
+ */
+export declare class PortCandidateRule {
+    private readonly _preferredPort;
+    private readonly _step;
+    private readonly _maxAttempts;
+    private readonly _ports;
+    private constructor();
+    /**
+     * 策略一：首选端口 + 步长。生成 [preferredPort, preferredPort+step, ...]，长度不超过 maxAttempts。
+     * @param preferredPort 首选端口
+     * @param options 选项
+     * @returns 端口候选规则
+     */
+    static preferred(preferredPort: number, options?: {
+        step?: number;
+        maxAttempts?: number;
+    }): PortCandidateRule;
+    /**
+     * 策略二：显式端口列表。按 ports 顺序使用，截断至 maxAttempts 并过滤非法端口。
+     * @param ports 端口列表
+     * @param options 选项
+     * @returns 端口候选规则
+     */
+    static explicit(ports: number[], options?: {
+        maxAttempts?: number;
+    }): PortCandidateRule;
+    /**
+     * 生成有序端口列表，每项 1..65535，长度不超过 maxAttempts。
+     * @returns 有序端口列表
+     */
+    toOrderedPortList(): number[];
+}
+//# sourceMappingURL=port_candidate_rule.d.ts.map

package/dist/moonbridge-ipc/general/config/port_candidate_rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port_candidate_rule.d.ts","sourceRoot":"","sources":["../../../../src/moonbridge-ipc/general/config/port_candidate_rule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAE9C,OAAO;IAYP;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CACd,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GACpD,iBAAiB;IASpB;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,iBAAiB;IAO3F;;;OAGG;IACH,iBAAiB,IAAI,MAAM,EAAE;CAiB9B"}

package/dist/moonbridge-ipc/general/config/port_candidate_rule.js

@@ -0,0 +1,65 @@
+'use strict';
+
+const maxAttemptsCap = 128;
+class PortCandidateRule {
+  constructor(preferredPort, step, maxAttempts, ports) {
+    this._preferredPort = preferredPort;
+    this._step = step;
+    this._maxAttempts = maxAttempts;
+    this._ports = ports;
+  }
+  /** 
+   * 策略一：首选端口 + 步长。生成 [preferredPort, preferredPort+step, ...]，长度不超过 maxAttempts。
+   * @param preferredPort 首选端口
+   * @param options 选项
+   * @returns 端口候选规则
+   */
+  static preferred(preferredPort, options = {}) {
+    var _a, _b;
+    const step = (_a = options.step) != null ? _a : 1;
+    const maxAttempts = (_b = options.maxAttempts) != null ? _b : 32;
+    if (preferredPort < 1 || preferredPort > 65535) throw new Error("preferredPort must be in 1..65535");
+    if (step < 1) throw new Error("step must be >= 1");
+    if (maxAttempts < 1 || maxAttempts > maxAttemptsCap) throw new Error(`maxAttempts must be in 1..${maxAttemptsCap}`);
+    return new PortCandidateRule(preferredPort, step, maxAttempts, void 0);
+  }
+  /** 
+   * 策略二：显式端口列表。按 ports 顺序使用，截断至 maxAttempts 并过滤非法端口。
+   * @param ports 端口列表
+   * @param options 选项
+   * @returns 端口候选规则
+   */
+  static explicit(ports, options = {}) {
+    var _a;
+    const maxAttempts = (_a = options.maxAttempts) != null ? _a : 32;
+    if (ports.length === 0) throw new Error("ports must not be empty");
+    if (maxAttempts < 1 || maxAttempts > maxAttemptsCap) throw new Error(`maxAttempts must be in 1..${maxAttemptsCap}`);
+    return new PortCandidateRule(0, 1, maxAttempts, [...ports]);
+  }
+  /** 
+   * 生成有序端口列表，每项 1..65535，长度不超过 maxAttempts。
+   * @returns 有序端口列表
+   */
+  toOrderedPortList() {
+    if (this._ports != null && this._ports.length > 0) {
+      const list2 = [];
+      for (const p of this._ports) {
+        if (list2.length >= this._maxAttempts) break;
+        if (p >= 1 && p <= 65535) list2.push(p);
+      }
+      return list2;
+    }
+    const list = [];
+    for (let i = 0; i < this._maxAttempts; i++) {
+      const p = this._preferredPort + i * this._step;
+      if (p > 65535) break;
+      if (p >= 1) list.push(p);
+    }
+    return list;
+  }
+}
+
+exports.PortCandidateRule = PortCandidateRule;
+exports.maxAttemptsCap = maxAttemptsCap;
+//# sourceMappingURL=port_candidate_rule.js.map
+//# sourceMappingURL=port_candidate_rule.js.map

package/dist/moonbridge-ipc/general/config/port_candidate_rule.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/moonbridge-ipc/general/config/port_candidate_rule.ts"],"names":["list"],"mappings":"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","file":"port_candidate_rule.js","sourcesContent":["/**\n * 端口候选规则，对应 Flutter lib/general/config/port_candidate_rule.dart。\n * 生成确定性有序端口列表，服务端按序 try-bind，客户端按序 try-connect。\n */\n\nexport const maxAttemptsCap = 128;\n\n/**\n * 端口候选规则\n */\nexport class PortCandidateRule {\n  private readonly _preferredPort: number;\n  private readonly _step: number;\n  private readonly _maxAttempts: number;\n  private readonly _ports: number[] | undefined;\n\n  private constructor(\n    preferredPort: number,\n    step: number,\n    maxAttempts: number,\n    ports: number[] | undefined,\n  ) {\n    this._preferredPort = preferredPort;\n    this._step = step;\n    this._maxAttempts = maxAttempts;\n    this._ports = ports;\n  }\n\n  /** \n   * 策略一：首选端口 + 步长。生成 [preferredPort, preferredPort+step, ...]，长度不超过 maxAttempts。\n   * @param preferredPort 首选端口\n   * @param options 选项\n   * @returns 端口候选规则\n   */\n  static preferred(\n    preferredPort: number,\n    options: { step?: number; maxAttempts?: number } = {},\n  ): PortCandidateRule {\n    const step = options.step ?? 1;\n    const maxAttempts = options.maxAttempts ?? 32;\n    if (preferredPort < 1 || preferredPort > 65535) throw new Error('preferredPort must be in 1..65535');\n    if (step < 1) throw new Error('step must be >= 1');\n    if (maxAttempts < 1 || maxAttempts > maxAttemptsCap) throw new Error(`maxAttempts must be in 1..${maxAttemptsCap}`);\n    return new PortCandidateRule(preferredPort, step, maxAttempts, undefined);\n  }\n\n  /** \n   * 策略二：显式端口列表。按 ports 顺序使用，截断至 maxAttempts 并过滤非法端口。\n   * @param ports 端口列表\n   * @param options 选项\n   * @returns 端口候选规则\n   */\n  static explicit(ports: number[], options: { maxAttempts?: number } = {}): PortCandidateRule {\n    const maxAttempts = options.maxAttempts ?? 32;\n    if (ports.length === 0) throw new Error('ports must not be empty');\n    if (maxAttempts < 1 || maxAttempts > maxAttemptsCap) throw new Error(`maxAttempts must be in 1..${maxAttemptsCap}`);\n    return new PortCandidateRule(0, 1, maxAttempts, [...ports]);\n  }\n\n  /** \n   * 生成有序端口列表，每项 1..65535，长度不超过 maxAttempts。\n   * @returns 有序端口列表\n   */\n  toOrderedPortList(): number[] {\n    if (this._ports != null && this._ports.length > 0) {\n      const list: number[] = [];\n      for (const p of this._ports) {\n        if (list.length >= this._maxAttempts) break;\n        if (p >= 1 && p <= 65535) list.push(p);\n      }\n      return list;\n    }\n    const list: number[] = [];\n    for (let i = 0; i < this._maxAttempts; i++) {\n      const p = this._preferredPort + i * this._step;\n      if (p > 65535) break;\n      if (p >= 1) list.push(p);\n    }\n    return list;\n  }\n}\n"]}

package/dist/moonbridge-ipc/general/config/port_candidate_rule.mjs

@@ -0,0 +1,62 @@
+const maxAttemptsCap = 128;
+class PortCandidateRule {
+  constructor(preferredPort, step, maxAttempts, ports) {
+    this._preferredPort = preferredPort;
+    this._step = step;
+    this._maxAttempts = maxAttempts;
+    this._ports = ports;
+  }
+  /** 
+   * 策略一：首选端口 + 步长。生成 [preferredPort, preferredPort+step, ...]，长度不超过 maxAttempts。
+   * @param preferredPort 首选端口
+   * @param options 选项
+   * @returns 端口候选规则
+   */
+  static preferred(preferredPort, options = {}) {
+    var _a, _b;
+    const step = (_a = options.step) != null ? _a : 1;
+    const maxAttempts = (_b = options.maxAttempts) != null ? _b : 32;
+    if (preferredPort < 1 || preferredPort > 65535) throw new Error("preferredPort must be in 1..65535");
+    if (step < 1) throw new Error("step must be >= 1");
+    if (maxAttempts < 1 || maxAttempts > maxAttemptsCap) throw new Error(`maxAttempts must be in 1..${maxAttemptsCap}`);
+    return new PortCandidateRule(preferredPort, step, maxAttempts, void 0);
+  }
+  /** 
+   * 策略二：显式端口列表。按 ports 顺序使用，截断至 maxAttempts 并过滤非法端口。
+   * @param ports 端口列表
+   * @param options 选项
+   * @returns 端口候选规则
+   */
+  static explicit(ports, options = {}) {
+    var _a;
+    const maxAttempts = (_a = options.maxAttempts) != null ? _a : 32;
+    if (ports.length === 0) throw new Error("ports must not be empty");
+    if (maxAttempts < 1 || maxAttempts > maxAttemptsCap) throw new Error(`maxAttempts must be in 1..${maxAttemptsCap}`);
+    return new PortCandidateRule(0, 1, maxAttempts, [...ports]);
+  }
+  /** 
+   * 生成有序端口列表，每项 1..65535，长度不超过 maxAttempts。
+   * @returns 有序端口列表
+   */
+  toOrderedPortList() {
+    if (this._ports != null && this._ports.length > 0) {
+      const list2 = [];
+      for (const p of this._ports) {
+        if (list2.length >= this._maxAttempts) break;
+        if (p >= 1 && p <= 65535) list2.push(p);
+      }
+      return list2;
+    }
+    const list = [];
+    for (let i = 0; i < this._maxAttempts; i++) {
+      const p = this._preferredPort + i * this._step;
+      if (p > 65535) break;
+      if (p >= 1) list.push(p);
+    }
+    return list;
+  }
+}
+
+export { PortCandidateRule, maxAttemptsCap };
+//# sourceMappingURL=port_candidate_rule.mjs.map
+//# sourceMappingURL=port_candidate_rule.mjs.map

package/dist/moonbridge-ipc/general/config/port_candidate_rule.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/moonbridge-ipc/general/config/port_candidate_rule.ts"],"names":["list"],"mappings":"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","file":"port_candidate_rule.mjs","sourcesContent":["/**\n * 端口候选规则，对应 Flutter lib/general/config/port_candidate_rule.dart。\n * 生成确定性有序端口列表，服务端按序 try-bind，客户端按序 try-connect。\n */\n\nexport const maxAttemptsCap = 128;\n\n/**\n * 端口候选规则\n */\nexport class PortCandidateRule {\n  private readonly _preferredPort: number;\n  private readonly _step: number;\n  private readonly _maxAttempts: number;\n  private readonly _ports: number[] | undefined;\n\n  private constructor(\n    preferredPort: number,\n    step: number,\n    maxAttempts: number,\n    ports: number[] | undefined,\n  ) {\n    this._preferredPort = preferredPort;\n    this._step = step;\n    this._maxAttempts = maxAttempts;\n    this._ports = ports;\n  }\n\n  /** \n   * 策略一：首选端口 + 步长。生成 [preferredPort, preferredPort+step, ...]，长度不超过 maxAttempts。\n   * @param preferredPort 首选端口\n   * @param options 选项\n   * @returns 端口候选规则\n   */\n  static preferred(\n    preferredPort: number,\n    options: { step?: number; maxAttempts?: number } = {},\n  ): PortCandidateRule {\n    const step = options.step ?? 1;\n    const maxAttempts = options.maxAttempts ?? 32;\n    if (preferredPort < 1 || preferredPort > 65535) throw new Error('preferredPort must be in 1..65535');\n    if (step < 1) throw new Error('step must be >= 1');\n    if (maxAttempts < 1 || maxAttempts > maxAttemptsCap) throw new Error(`maxAttempts must be in 1..${maxAttemptsCap}`);\n    return new PortCandidateRule(preferredPort, step, maxAttempts, undefined);\n  }\n\n  /** \n   * 策略二：显式端口列表。按 ports 顺序使用，截断至 maxAttempts 并过滤非法端口。\n   * @param ports 端口列表\n   * @param options 选项\n   * @returns 端口候选规则\n   */\n  static explicit(ports: number[], options: { maxAttempts?: number } = {}): PortCandidateRule {\n    const maxAttempts = options.maxAttempts ?? 32;\n    if (ports.length === 0) throw new Error('ports must not be empty');\n    if (maxAttempts < 1 || maxAttempts > maxAttemptsCap) throw new Error(`maxAttempts must be in 1..${maxAttemptsCap}`);\n    return new PortCandidateRule(0, 1, maxAttempts, [...ports]);\n  }\n\n  /** \n   * 生成有序端口列表，每项 1..65535，长度不超过 maxAttempts。\n   * @returns 有序端口列表\n   */\n  toOrderedPortList(): number[] {\n    if (this._ports != null && this._ports.length > 0) {\n      const list: number[] = [];\n      for (const p of this._ports) {\n        if (list.length >= this._maxAttempts) break;\n        if (p >= 1 && p <= 65535) list.push(p);\n      }\n      return list;\n    }\n    const list: number[] = [];\n    for (let i = 0; i < this._maxAttempts; i++) {\n      const p = this._preferredPort + i * this._step;\n      if (p > 65535) break;\n      if (p >= 1) list.push(p);\n    }\n    return list;\n  }\n}\n"]}

package/dist/moonbridge-ipc/general/config/websocket_server_endpoint.d.mts

@@ -0,0 +1,33 @@
+import { PortCandidateRule } from './port_candidate_rule.mjs';
+
+/**
+ * WebSocket 服务端端点配置，对应 Flutter lib/general/config/websocket_server_endpoint.dart WebSocketServerEndpoint。
+ */
+
+/**
+ * WebSocket 服务端端点配置
+ */
+declare class WebSocketServerEndpoint {
+    readonly address: string;
+    readonly port: number;
+    readonly path: string;
+    readonly useTls: boolean;
+    readonly portCandidateRule?: PortCandidateRule;
+    /**
+     * 构造函数
+     * @param address 地址
+     * @param port 端口
+     * @param path 路径
+     * @param useTls 是否使用 TLS
+     * @param portCandidateRule 端口候选规则
+     */
+    constructor({ address, port, path, useTls, portCandidateRule, }: {
+        address: string;
+        port: number;
+        path: string;
+        useTls: boolean;
+        portCandidateRule?: PortCandidateRule;
+    });
+}
+
+export { WebSocketServerEndpoint };