moonbridge-ts 0.1.0

package/dist/index.js

@@ -0,0 +1,28 @@
+'use strict';
+
+var moonbridge = require('./moonbridge');
+var moonbridgeIpc = require('./moonbridge-ipc');
+var wpsLauncher = require('./wps-launcher');
+
+
+
+Object.keys(moonbridge).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return moonbridge[k]; }
+	});
+});
+Object.keys(moonbridgeIpc).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return moonbridgeIpc[k]; }
+	});
+});
+Object.keys(wpsLauncher).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return wpsLauncher[k]; }
+	});
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}

package/dist/index.mjs

@@ -0,0 +1,5 @@
+export * from './moonbridge';
+export * from './moonbridge-ipc';
+export * from './wps-launcher';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs","sourcesContent":[]}

package/dist/ipc_client_component_provider-CayqZGuB.d.ts

@@ -0,0 +1,205 @@
+import { IpcClientSettings } from './moonbridge-ipc/client/internal/settings/ipc_client_settings.js';
+import { IpcConnectionCompletionHandler, IpcErrorCallback } from './moonbridge-ipc/client/types/ipc_types.js';
+import { Request } from './moonbridge-ipc/general/message/request.js';
+import { Response } from './moonbridge-ipc/general/message/response.js';
+import { Error } from './moonbridge-ipc/general/message/error.js';
+import { IpcMessageStrategy } from './moonbridge-ipc/client/types/ipc_message_strategy.js';
+import { Event } from './moonbridge-ipc/general/message/event.js';
+import { EventBus, Subscriber } from './moonbridge-ipc/client/types/ipc_event_bus.js';
+import { B as Bridge, E as Executor, M as ModuleCreator } from './bridge_module-2N398tJq.js';
+import { MessageParserManager } from './moonbridge/message/message_parser_manager.js';
+import { MoonBridgeIpcClient } from './moonbridge-ipc/client/moonbridge_ipc_client.js';
+import { TransportClient } from './moonbridge-ipc/general/transport/interface/transport_client.js';
+import { IpcSessionSetupResponse } from './moonbridge-ipc/general/message/session_setup.js';
+import { IpcError } from './moonbridge-ipc/general/error/ipc_error.js';
+
+/**
+ * IPC 通信环境构建结果回调
+ */
+type IpcSessionSetupCallback = (success: boolean, error?: IpcError) => void;
+/**
+ * IPC 连接管理器，负责维护 IPC 通信的连接状态
+ */
+declare class IpcConnectionManager {
+    private readonly settings;
+    private readonly componentProvider;
+    private readonly clientName;
+    private transportClient;
+    private connectionHandlers;
+    private sessionSetupCallbacks;
+    private onMessageReceivedListener?;
+    constructor(componentProvider: IpcClientComponentProvider);
+    initialize(): void;
+    onMessageReceived(listener: (message: string) => void): void;
+    connect(onResult?: IpcConnectionCompletionHandler, options?: {
+        autoLaunch?: boolean;
+    }): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    setupSession(request: Request, callback: IpcSessionSetupCallback, autoLaunch: boolean): void;
+    onSessionSetupCallback(response: IpcSessionSetupResponse): void;
+    get transportClientInstance(): TransportClient;
+    private bindTransportEvents;
+    private getPortList;
+    /**
+     * 生成环境回调 ID，与 Flutter _generateSessionCallbackId 一致。
+     * 同一 (fromClient, toClient) 对的多个请求共享同一 sessionCallbackId，仅首次会发送 IpcSessionSetupRequest。
+     */
+    private generateSessionCallbackId;
+    /**
+     * 对指定 client 执行应用层握手，与 Flutter _performHandshake 语义一致：
+     * 发送握手请求后，在短超时内等待带相同 magic 与 server 角色的握手响应，成功才返回 true。
+     */
+    private performHandshake;
+    /**
+     * 019：唤醒后连接探测。立即尝试连接，失败则短间隔重试，成功即停止；支持多轮端口遍历。
+     */
+    private attemptConnectionWithProbe;
+    private attemptConnection;
+    private handleConnectionFailed;
+    private handleConnectionException;
+    private handleAlreadyConnected;
+    private shouldAttemptWakeUp;
+    private setupSessionAfterConnection;
+    private onError;
+    private onServerClose;
+    private notifyConnectionResult;
+}
+
+/**
+ * IPC 客户端请求与响应协调器类
+ * 负责构建 IPC 请求的参数并管理相应的回调处理。
+ */
+declare class IpcRequestCoordinator {
+    private readonly clientName;
+    private readonly responseCallbacks;
+    private readonly errorCallbacks;
+    constructor(componentProvider: IpcClientComponentProvider);
+    initialize(): void;
+    prepareAndCreateIpcRequest(options: {
+        toClient: string;
+        moduleName: string;
+        methodName: string;
+        arguments?: Array<unknown>;
+        onError?: IpcErrorCallback;
+    }): Request;
+    onResponse(response: Response): void;
+    onError(error: Error): void;
+    private generateRequestId;
+    private generateCallbackId;
+}
+
+/**
+ * 具体实现类，对应 Dart IpcCommunicationAgent。
+ */
+declare class IpcCommunicationAgent {
+    private readonly componentProvider;
+    private readonly settings;
+    private clientName;
+    private messageInterceptor?;
+    constructor(componentProvider: IpcClientComponentProvider);
+    initialize(): void;
+    sendRequestAfterSetupSession(request: Request, strategy: IpcMessageStrategy | undefined, callback: IpcConnectionCompletionHandler | undefined): void;
+    register(): Promise<boolean>;
+    unregister(): Promise<boolean>;
+    sendRequest(request: Request): Promise<boolean>;
+    sendResponse(response: Response): Promise<boolean>;
+    sendError(error: Error): Promise<boolean>;
+    postEvent(event: Event): Promise<void>;
+    private onEvent;
+    private onError;
+    private onRequest;
+    private onResponse;
+    private onSessionSetupResponse;
+    private getMessageType;
+    private get socketClient();
+    private get connectionManager();
+    private get requestCoordinator();
+    private get bridge();
+    private get eventBus();
+}
+
+declare class IpcEventBus implements EventBus {
+    private readonly componentProvider;
+    private readonly subscriberMap;
+    constructor(componentProvider: IpcClientComponentProvider);
+    initialize(): void;
+    private get connectionManager();
+    private get communicationAgent();
+    onEvent(event: Event): void;
+    register(subscriber: Subscriber): void;
+    unregister(subscriber: Subscriber): void;
+    post(event: Event): Promise<void>;
+}
+
+declare class IpcConnectionKeeper {
+    /** 组件提供者（强引用；Flutter 使用 WeakReference<IpcClientComponentProvider>） */
+    private readonly componentProvider;
+    private clientName;
+    private heartbeatEnabled;
+    private heartbeatIntervalMs;
+    private heartbeatTimer;
+    constructor(componentProvider: IpcClientComponentProvider);
+    initialize(): void;
+    startHeartbeat(): void;
+    stopHeartbeat(): void;
+    private heartbeatTick;
+}
+
+/**
+ * IPC 客户端桥接器类。
+ *
+ * 该类实现 Bridge 接口，用于管理 IPC 客户端的模块创建、执行器和消息解析器。
+ */
+declare class IpcClientBridge implements Bridge {
+    /** IPC 客户端实例（TS 端使用占位类型） */
+    private readonly _ipcClient;
+    /** IPC 客户端执行器 */
+    private readonly _executor;
+    /** 模块创建器 */
+    private readonly _moduleCreator;
+    /** 消息解析器管理器 */
+    private readonly _parserManager;
+    /**
+     * 构造函数。
+     *
+     * @param ipcClient IPC 客户端实例
+     * @param communicationAgent 通信代理实例
+     */
+    constructor(ipcClient: MoonBridgeIpcClient, communicationAgent: IpcCommunicationAgent);
+    /**
+     * 初始化配置。
+     */
+    initialize(): void;
+    /** 获取 IPC 客户端实例 */
+    get ipcClient(): MoonBridgeIpcClient;
+    /** 获取执行器实例 */
+    get executor(): Executor;
+    /** 获取模块创建器实例 */
+    get moduleCreator(): ModuleCreator;
+    /** 获取消息解析器管理器实例 */
+    get parserManager(): MessageParserManager;
+}
+
+/**
+ * IpcClientComponentProvider 的默认实现，与 Flutter RealMoonBridgeIpcClient 的组件装配顺序一致。
+ * 由本类统一 new 各 IPC 组件，调用方仅需提供 IpcClientSettings。
+ * 012 对齐说明：Flutter 仅有抽象接口 IpcClientComponentProvider，装配在 RealMoonBridgeIpcClient 构造函数内；
+ * JS 保留本实现类，RealMoonBridgeIpcClient 通过继承此类获得组件，装配顺序与 Flutter 一致，Bridge 不传 moduleFactories。
+ */
+
+/**
+ * 单一装配点：按 Flutter 顺序创建并初始化 ConnectionManager → RequestCoordinator →
+ * CommunicationAgent → EventBus → ConnectionKeeper → Bridge。
+ */
+interface IpcClientComponentProvider {
+    readonly settings: IpcClientSettings;
+    readonly connectionManager: IpcConnectionManager;
+    readonly requestCoordinator: IpcRequestCoordinator;
+    readonly communicationAgent: IpcCommunicationAgent;
+    readonly ipcEventBus: IpcEventBus;
+    readonly connectionKeeper: IpcConnectionKeeper;
+    readonly bridge: IpcClientBridge;
+}
+
+export { type IpcClientComponentProvider as I, IpcConnectionManager as a, IpcRequestCoordinator as b, IpcCommunicationAgent as c, IpcEventBus as d, IpcConnectionKeeper as e, IpcClientBridge as f, type IpcSessionSetupCallback as g };

package/dist/ipc_client_component_provider-kXpa5anm.d.mts

@@ -0,0 +1,205 @@
+import { IpcClientSettings } from './moonbridge-ipc/client/internal/settings/ipc_client_settings.mjs';
+import { IpcConnectionCompletionHandler, IpcErrorCallback } from './moonbridge-ipc/client/types/ipc_types.mjs';
+import { Request } from './moonbridge-ipc/general/message/request.mjs';
+import { Response } from './moonbridge-ipc/general/message/response.mjs';
+import { Error } from './moonbridge-ipc/general/message/error.mjs';
+import { IpcMessageStrategy } from './moonbridge-ipc/client/types/ipc_message_strategy.mjs';
+import { Event } from './moonbridge-ipc/general/message/event.mjs';
+import { EventBus, Subscriber } from './moonbridge-ipc/client/types/ipc_event_bus.mjs';
+import { B as Bridge, E as Executor, M as ModuleCreator } from './bridge_module-Dd27cxv9.mjs';
+import { MessageParserManager } from './moonbridge/message/message_parser_manager.mjs';
+import { MoonBridgeIpcClient } from './moonbridge-ipc/client/moonbridge_ipc_client.mjs';
+import { TransportClient } from './moonbridge-ipc/general/transport/interface/transport_client.mjs';
+import { IpcSessionSetupResponse } from './moonbridge-ipc/general/message/session_setup.mjs';
+import { IpcError } from './moonbridge-ipc/general/error/ipc_error.mjs';
+
+/**
+ * IPC 通信环境构建结果回调
+ */
+type IpcSessionSetupCallback = (success: boolean, error?: IpcError) => void;
+/**
+ * IPC 连接管理器，负责维护 IPC 通信的连接状态
+ */
+declare class IpcConnectionManager {
+    private readonly settings;
+    private readonly componentProvider;
+    private readonly clientName;
+    private transportClient;
+    private connectionHandlers;
+    private sessionSetupCallbacks;
+    private onMessageReceivedListener?;
+    constructor(componentProvider: IpcClientComponentProvider);
+    initialize(): void;
+    onMessageReceived(listener: (message: string) => void): void;
+    connect(onResult?: IpcConnectionCompletionHandler, options?: {
+        autoLaunch?: boolean;
+    }): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    setupSession(request: Request, callback: IpcSessionSetupCallback, autoLaunch: boolean): void;
+    onSessionSetupCallback(response: IpcSessionSetupResponse): void;
+    get transportClientInstance(): TransportClient;
+    private bindTransportEvents;
+    private getPortList;
+    /**
+     * 生成环境回调 ID，与 Flutter _generateSessionCallbackId 一致。
+     * 同一 (fromClient, toClient) 对的多个请求共享同一 sessionCallbackId，仅首次会发送 IpcSessionSetupRequest。
+     */
+    private generateSessionCallbackId;
+    /**
+     * 对指定 client 执行应用层握手，与 Flutter _performHandshake 语义一致：
+     * 发送握手请求后，在短超时内等待带相同 magic 与 server 角色的握手响应，成功才返回 true。
+     */
+    private performHandshake;
+    /**
+     * 019：唤醒后连接探测。立即尝试连接，失败则短间隔重试，成功即停止；支持多轮端口遍历。
+     */
+    private attemptConnectionWithProbe;
+    private attemptConnection;
+    private handleConnectionFailed;
+    private handleConnectionException;
+    private handleAlreadyConnected;
+    private shouldAttemptWakeUp;
+    private setupSessionAfterConnection;
+    private onError;
+    private onServerClose;
+    private notifyConnectionResult;
+}
+
+/**
+ * IPC 客户端请求与响应协调器类
+ * 负责构建 IPC 请求的参数并管理相应的回调处理。
+ */
+declare class IpcRequestCoordinator {
+    private readonly clientName;
+    private readonly responseCallbacks;
+    private readonly errorCallbacks;
+    constructor(componentProvider: IpcClientComponentProvider);
+    initialize(): void;
+    prepareAndCreateIpcRequest(options: {
+        toClient: string;
+        moduleName: string;
+        methodName: string;
+        arguments?: Array<unknown>;
+        onError?: IpcErrorCallback;
+    }): Request;
+    onResponse(response: Response): void;
+    onError(error: Error): void;
+    private generateRequestId;
+    private generateCallbackId;
+}
+
+/**
+ * 具体实现类，对应 Dart IpcCommunicationAgent。
+ */
+declare class IpcCommunicationAgent {
+    private readonly componentProvider;
+    private readonly settings;
+    private clientName;
+    private messageInterceptor?;
+    constructor(componentProvider: IpcClientComponentProvider);
+    initialize(): void;
+    sendRequestAfterSetupSession(request: Request, strategy: IpcMessageStrategy | undefined, callback: IpcConnectionCompletionHandler | undefined): void;
+    register(): Promise<boolean>;
+    unregister(): Promise<boolean>;
+    sendRequest(request: Request): Promise<boolean>;
+    sendResponse(response: Response): Promise<boolean>;
+    sendError(error: Error): Promise<boolean>;
+    postEvent(event: Event): Promise<void>;
+    private onEvent;
+    private onError;
+    private onRequest;
+    private onResponse;
+    private onSessionSetupResponse;
+    private getMessageType;
+    private get socketClient();
+    private get connectionManager();
+    private get requestCoordinator();
+    private get bridge();
+    private get eventBus();
+}
+
+declare class IpcEventBus implements EventBus {
+    private readonly componentProvider;
+    private readonly subscriberMap;
+    constructor(componentProvider: IpcClientComponentProvider);
+    initialize(): void;
+    private get connectionManager();
+    private get communicationAgent();
+    onEvent(event: Event): void;
+    register(subscriber: Subscriber): void;
+    unregister(subscriber: Subscriber): void;
+    post(event: Event): Promise<void>;
+}
+
+declare class IpcConnectionKeeper {
+    /** 组件提供者（强引用；Flutter 使用 WeakReference<IpcClientComponentProvider>） */
+    private readonly componentProvider;
+    private clientName;
+    private heartbeatEnabled;
+    private heartbeatIntervalMs;
+    private heartbeatTimer;
+    constructor(componentProvider: IpcClientComponentProvider);
+    initialize(): void;
+    startHeartbeat(): void;
+    stopHeartbeat(): void;
+    private heartbeatTick;
+}
+
+/**
+ * IPC 客户端桥接器类。
+ *
+ * 该类实现 Bridge 接口，用于管理 IPC 客户端的模块创建、执行器和消息解析器。
+ */
+declare class IpcClientBridge implements Bridge {
+    /** IPC 客户端实例（TS 端使用占位类型） */
+    private readonly _ipcClient;
+    /** IPC 客户端执行器 */
+    private readonly _executor;
+    /** 模块创建器 */
+    private readonly _moduleCreator;
+    /** 消息解析器管理器 */
+    private readonly _parserManager;
+    /**
+     * 构造函数。
+     *
+     * @param ipcClient IPC 客户端实例
+     * @param communicationAgent 通信代理实例
+     */
+    constructor(ipcClient: MoonBridgeIpcClient, communicationAgent: IpcCommunicationAgent);
+    /**
+     * 初始化配置。
+     */
+    initialize(): void;
+    /** 获取 IPC 客户端实例 */
+    get ipcClient(): MoonBridgeIpcClient;
+    /** 获取执行器实例 */
+    get executor(): Executor;
+    /** 获取模块创建器实例 */
+    get moduleCreator(): ModuleCreator;
+    /** 获取消息解析器管理器实例 */
+    get parserManager(): MessageParserManager;
+}
+
+/**
+ * IpcClientComponentProvider 的默认实现，与 Flutter RealMoonBridgeIpcClient 的组件装配顺序一致。
+ * 由本类统一 new 各 IPC 组件，调用方仅需提供 IpcClientSettings。
+ * 012 对齐说明：Flutter 仅有抽象接口 IpcClientComponentProvider，装配在 RealMoonBridgeIpcClient 构造函数内；
+ * JS 保留本实现类，RealMoonBridgeIpcClient 通过继承此类获得组件，装配顺序与 Flutter 一致，Bridge 不传 moduleFactories。
+ */
+
+/**
+ * 单一装配点：按 Flutter 顺序创建并初始化 ConnectionManager → RequestCoordinator →
+ * CommunicationAgent → EventBus → ConnectionKeeper → Bridge。
+ */
+interface IpcClientComponentProvider {
+    readonly settings: IpcClientSettings;
+    readonly connectionManager: IpcConnectionManager;
+    readonly requestCoordinator: IpcRequestCoordinator;
+    readonly communicationAgent: IpcCommunicationAgent;
+    readonly ipcEventBus: IpcEventBus;
+    readonly connectionKeeper: IpcConnectionKeeper;
+    readonly bridge: IpcClientBridge;
+}
+
+export { type IpcClientComponentProvider as I, IpcConnectionManager as a, IpcRequestCoordinator as b, IpcCommunicationAgent as c, IpcEventBus as d, IpcConnectionKeeper as e, IpcClientBridge as f, type IpcSessionSetupCallback as g };

package/dist/moonbridge/annotation/decorators.d.mts

@@ -0,0 +1,48 @@
+import { B as Bridge, a as BridgeModule } from '../../bridge_module-Dd27cxv9.mjs';
+import '../message/message_parser_manager.mjs';
+import '../message/message.mjs';
+import '../message/message_parser.mjs';
+
+/**
+ * MoonBridge 注解装饰器，对应 Flutter 中的模块 / 方法注解。
+ * 使用 TypeScript 装饰器在运行时向全局注册表写入元信息。
+ *
+ * 装饰器执行顺序：TypeScript 中方法装饰器先于类装饰器执行。
+ * 因此 @MoonBridgeMethod 执行时，@MoonBridgeModule 尚未注册类。
+ * 使用 pendingMethodRegistrations 缓存待注册方法，待 @MoonBridgeModule 执行时消费。
+ */
+/**
+ * 使用 @MoonBridgeModule 和 @MoonBridgeMethod 装饰器时，需要配置 tsconfig.json 如下：
+ *
+ * ```json
+ * "experimentalDecorators": true,    // 必选：启用装饰器语法
+ * "emitDecoratorMetadata": true,     // 必选：启用装饰器元数据（如反射获取类型）
+ * "useDefineForClassFields": false,  // 必选：兼容装饰器与类字段（TS 3.7+ 建议配置）
+ * ```
+ */
+
+/**
+ * 模块装饰器，对应 Flutter 侧的模块 annotation。
+ * 用于声明某个类是可桥接模块，并绑定模块名。
+ *
+ * 约定：
+ * - 被装饰的类必须继承自 BridgeModule
+ * - 构造函数签名为 new (bridge: Bridge)
+ *
+ * - name: 模块名
+ *
+ * 执行时先 registerModule，再消费 pendingMethodRegistrations 中该类的待注册方法。
+ */
+declare function MoonBridgeModule(name: string): (target: new (bridge: Bridge) => BridgeModule | any) => void;
+/**
+ * 方法装饰器，对应 Flutter 侧的方法 annotation。
+ * 用于给方法声明对外暴露的别名。
+ *
+ * - name: 方法别名（可选）；未传时使用 propertyKey 作为别名
+ *
+ * 因方法装饰器先于类装饰器执行，若类尚未注册则写入 pendingMethodRegistrations，
+ * 待 @MoonBridgeModule 执行时消费。
+ */
+declare function MoonBridgeMethod(name?: string): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
+
+export { MoonBridgeMethod, MoonBridgeModule };

package/dist/moonbridge/annotation/decorators.d.ts

@@ -0,0 +1,43 @@
+/**
+ * MoonBridge 注解装饰器，对应 Flutter 中的模块 / 方法注解。
+ * 使用 TypeScript 装饰器在运行时向全局注册表写入元信息。
+ *
+ * 装饰器执行顺序：TypeScript 中方法装饰器先于类装饰器执行。
+ * 因此 @MoonBridgeMethod 执行时，@MoonBridgeModule 尚未注册类。
+ * 使用 pendingMethodRegistrations 缓存待注册方法，待 @MoonBridgeModule 执行时消费。
+ */
+/**
+ * 使用 @MoonBridgeModule 和 @MoonBridgeMethod 装饰器时，需要配置 tsconfig.json 如下：
+ *
+ * ```json
+ * "experimentalDecorators": true,    // 必选：启用装饰器语法
+ * "emitDecoratorMetadata": true,     // 必选：启用装饰器元数据（如反射获取类型）
+ * "useDefineForClassFields": false,  // 必选：兼容装饰器与类字段（TS 3.7+ 建议配置）
+ * ```
+ */
+import { Bridge } from '../kernel/bridge';
+import { BridgeModule } from '../kernel/bridge_module';
+/**
+ * 模块装饰器，对应 Flutter 侧的模块 annotation。
+ * 用于声明某个类是可桥接模块，并绑定模块名。
+ *
+ * 约定：
+ * - 被装饰的类必须继承自 BridgeModule
+ * - 构造函数签名为 new (bridge: Bridge)
+ *
+ * - name: 模块名
+ *
+ * 执行时先 registerModule，再消费 pendingMethodRegistrations 中该类的待注册方法。
+ */
+export declare function MoonBridgeModule(name: string): (target: new (bridge: Bridge) => BridgeModule | any) => void;
+/**
+ * 方法装饰器，对应 Flutter 侧的方法 annotation。
+ * 用于给方法声明对外暴露的别名。
+ *
+ * - name: 方法别名（可选）；未传时使用 propertyKey 作为别名
+ *
+ * 因方法装饰器先于类装饰器执行，若类尚未注册则写入 pendingMethodRegistrations，
+ * 待 @MoonBridgeModule 执行时消费。
+ */
+export declare function MoonBridgeMethod(name?: string): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/moonbridge/annotation/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/moonbridge/annotation/decorators.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAcvD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,IAE1B,QAAQ,KAAK,MAAM,EAAE,MAAM,KAAK,YAAY,GAAG,GAAG,KAAG,IAAI,CAe3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,IAE3B,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,aAAa,kBAAkB,KAAG,IAAI,CA+B1F"}

package/dist/moonbridge/annotation/decorators.js

@@ -0,0 +1,55 @@
+'use strict';
+
+var logger = require('../utils/logger');
+var registry = require('./registry');
+
+const pendingMethodRegistrations = /* @__PURE__ */ new Map();
+function MoonBridgeModule(name) {
+  return function(target) {
+    logger.logger.info(`[MoonBridgeModule] \u88C5\u9970\u5668\u6267\u884C moduleName=${name}`);
+    registry.MoonBridgeRegistry.getInstance().registerModule(name, target);
+    const className = target.name;
+    const pending = pendingMethodRegistrations.get(className);
+    if (pending) {
+      const registry$1 = registry.MoonBridgeRegistry.getInstance();
+      for (const { methodAlias, methodName } of pending) {
+        registry$1.registerMethod(name, methodAlias, { className, methodName });
+      }
+      pendingMethodRegistrations.delete(className);
+    }
+  };
+}
+function MoonBridgeMethod(name) {
+  return function(target, propertyKey, _descriptor) {
+    const clazz = target.constructor;
+    const className = clazz.name;
+    const methodAlias = name != null ? name : propertyKey;
+    logger.logger.info(`[MoonBridgeMethod] \u88C5\u9970\u5668\u6267\u884C methodAlias=${methodAlias} propertyKey=${propertyKey}`);
+    const registry$1 = registry.MoonBridgeRegistry.getInstance();
+    let matchedModuleName = "";
+    for (const [moduleName, ctor] of registry$1.moduleCtorMap) {
+      if (ctor.name === className) {
+        matchedModuleName = moduleName;
+        break;
+      }
+    }
+    if (matchedModuleName) {
+      registry$1.registerMethod(matchedModuleName, methodAlias, {
+        className,
+        methodName: propertyKey
+      });
+    } else {
+      let list = pendingMethodRegistrations.get(className);
+      if (!list) {
+        list = [];
+        pendingMethodRegistrations.set(className, list);
+      }
+      list.push({ methodAlias, methodName: propertyKey });
+    }
+  };
+}
+
+exports.MoonBridgeMethod = MoonBridgeMethod;
+exports.MoonBridgeModule = MoonBridgeModule;
+//# sourceMappingURL=decorators.js.map
+//# sourceMappingURL=decorators.js.map

package/dist/moonbridge/annotation/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/moonbridge/annotation/decorators.ts"],"names":["logger","MoonBridgeRegistry","registry"],"mappings":";;;;;AA2BA,MAAM,0BAAA,uBAAiC,GAAA,EAGrC;AAgBK,SAAS,iBAAiB,IAAA,EAAc;AAE7C,EAAA,OAAO,SAAU,MAAA,EAA0D;AACzE,IAAAA,aAAA,CAAO,IAAA,CAAK,CAAA,6DAAA,EAAuC,IAAI,CAAA,CAAE,CAAA;AACzD,IAAAC,2BAAA,CAAmB,WAAA,EAAY,CAAE,cAAA,CAAe,IAAA,EAAM,MAAM,CAAA;AAG5D,IAAA,MAAM,YAAY,MAAA,CAAO,IAAA;AACzB,IAAA,MAAM,OAAA,GAAU,0BAAA,CAA2B,GAAA,CAAI,SAAS,CAAA;AACxD,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,MAAMC,UAAA,GAAWD,4BAAmB,WAAA,EAAY;AAChD,MAAA,KAAA,MAAW,EAAE,WAAA,EAAa,UAAA,EAAW,IAAK,OAAA,EAAS;AACjD,QAAAC,UAAA,CAAS,eAAe,IAAA,EAAM,WAAA,EAAa,EAAE,SAAA,EAAW,YAAY,CAAA;AAAA,MACtE;AACA,MAAA,0BAAA,CAA2B,OAAO,SAAS,CAAA;AAAA,IAC7C;AAAA,EACF,CAAA;AACF;AAWO,SAAS,iBAAiB,IAAA,EAAe;AAE9C,EAAA,OAAO,SAAU,MAAA,EAAa,WAAA,EAAqB,WAAA,EAAuC;AACxF,IAAA,MAAM,QAAQ,MAAA,CAAO,WAAA;AACrB,IAAA,MAAM,YAAY,KAAA,CAAM,IAAA;AACxB,IAAA,MAAM,cAAc,IAAA,IAAA,IAAA,GAAA,IAAA,GAAQ,WAAA;AAC5B,IAAAF,aAAA,CAAO,IAAA,CAAK,CAAA,8DAAA,EAAwC,WAAW,CAAA,aAAA,EAAgB,WAAW,CAAA,CAAE,CAAA;AAC5F,IAAA,MAAME,UAAA,GAAWD,4BAAmB,WAAA,EAAY;AAGhD,IAAA,IAAI,iBAAA,GAAoB,EAAA;AACxB,IAAA,KAAA,MAAW,CAAC,UAAA,EAAY,IAAI,CAAA,IAAKC,WAAS,aAAA,EAAe;AACvD,MAAA,IAAI,IAAA,CAAK,SAAS,SAAA,EAAW;AAC3B,QAAA,iBAAA,GAAoB,UAAA;AACpB,QAAA;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAI,iBAAA,EAAmB;AACrB,MAAAA,UAAA,CAAS,cAAA,CAAe,mBAAmB,WAAA,EAAa;AAAA,QACtD,SAAA;AAAA,QACA,UAAA,EAAY;AAAA,OACb,CAAA;AAAA,IACH,CAAA,MAAO;AAEL,MAAA,IAAI,IAAA,GAAO,0BAAA,CAA2B,GAAA,CAAI,SAAS,CAAA;AACnD,MAAA,IAAI,CAAC,IAAA,EAAM;AACT,QAAA,IAAA,GAAO,EAAC;AACR,QAAA,0BAAA,CAA2B,GAAA,CAAI,WAAW,IAAI,CAAA;AAAA,MAChD;AACA,MAAA,IAAA,CAAK,IAAA,CAAK,EAAE,WAAA,EAAa,UAAA,EAAY,aAAa,CAAA;AAAA,IACpD;AAAA,EACF,CAAA;AACF","file":"decorators.js","sourcesContent":["/**\n * MoonBridge 注解装饰器，对应 Flutter 中的模块 / 方法注解。\n * 使用 TypeScript 装饰器在运行时向全局注册表写入元信息。\n *\n * 装饰器执行顺序：TypeScript 中方法装饰器先于类装饰器执行。\n * 因此 @MoonBridgeMethod 执行时，@MoonBridgeModule 尚未注册类。\n * 使用 pendingMethodRegistrations 缓存待注册方法，待 @MoonBridgeModule 执行时消费。\n */\n\n/**\n * 使用 @MoonBridgeModule 和 @MoonBridgeMethod 装饰器时，需要配置 tsconfig.json 如下：\n * \n * ```json\n * \"experimentalDecorators\": true,    // 必选：启用装饰器语法\n * \"emitDecoratorMetadata\": true,     // 必选：启用装饰器元数据（如反射获取类型）\n * \"useDefineForClassFields\": false,  // 必选：兼容装饰器与类字段（TS 3.7+ 建议配置）\n * ```\n */\n\nimport { Bridge } from '../kernel/bridge';\nimport { BridgeModule } from '../kernel/bridge_module';\nimport { logger } from '../utils/logger';\nimport { MoonBridgeRegistry } from './registry';\n\n// CONSTANTS\n\n/** 键：className；值：待注册方法列表。方法装饰器先于类装饰器执行，故需缓存。 */\nconst pendingMethodRegistrations = new Map<\n  string,\n  Array<{ methodAlias: string; methodName: string }>\n>();\n\n// PUBLIC METHODS\n\n/**\n * 模块装饰器，对应 Flutter 侧的模块 annotation。\n * 用于声明某个类是可桥接模块，并绑定模块名。\n *\n * 约定：\n * - 被装饰的类必须继承自 BridgeModule\n * - 构造函数签名为 new (bridge: Bridge)\n *\n * - name: 模块名\n *\n * 执行时先 registerModule，再消费 pendingMethodRegistrations 中该类的待注册方法。\n */\nexport function MoonBridgeModule(name: string) {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return function (target: new (bridge: Bridge) => BridgeModule | any): void {\n    logger.info(`[MoonBridgeModule] 装饰器执行 moduleName=${name}`);\n    MoonBridgeRegistry.getInstance().registerModule(name, target);\n\n    // 消费方法装饰器写入的待注册项（方法装饰器先于类装饰器执行）\n    const className = target.name;\n    const pending = pendingMethodRegistrations.get(className);\n    if (pending) {\n      const registry = MoonBridgeRegistry.getInstance();\n      for (const { methodAlias, methodName } of pending) {\n        registry.registerMethod(name, methodAlias, { className, methodName });\n      }\n      pendingMethodRegistrations.delete(className);\n    }\n  };\n}\n\n/**\n * 方法装饰器，对应 Flutter 侧的方法 annotation。\n * 用于给方法声明对外暴露的别名。\n *\n * - name: 方法别名（可选）；未传时使用 propertyKey 作为别名\n *\n * 因方法装饰器先于类装饰器执行，若类尚未注册则写入 pendingMethodRegistrations，\n * 待 @MoonBridgeModule 执行时消费。\n */\nexport function MoonBridgeMethod(name?: string) {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return function (target: any, propertyKey: string, _descriptor: PropertyDescriptor): void {\n    const clazz = target.constructor;\n    const className = clazz.name;\n    const methodAlias = name ?? propertyKey;\n    logger.info(`[MoonBridgeMethod] 装饰器执行 methodAlias=${methodAlias} propertyKey=${propertyKey}`);\n    const registry = MoonBridgeRegistry.getInstance();\n\n    // 根据 class 名称找到对应的 moduleName（类装饰器可能已执行）\n    let matchedModuleName = '';\n    for (const [moduleName, ctor] of registry.moduleCtorMap) {\n      if (ctor.name === className) {\n        matchedModuleName = moduleName;\n        break;\n      }\n    }\n\n    if (matchedModuleName) {\n      registry.registerMethod(matchedModuleName, methodAlias, {\n        className,\n        methodName: propertyKey,\n      });\n    } else {\n      // 类尚未注册，写入待注册缓存\n      let list = pendingMethodRegistrations.get(className);\n      if (!list) {\n        list = [];\n        pendingMethodRegistrations.set(className, list);\n      }\n      list.push({ methodAlias, methodName: propertyKey });\n    }\n  };\n}\n\n"]}

package/dist/moonbridge/annotation/decorators.mjs

@@ -0,0 +1,52 @@
+import { logger } from '../utils/logger';
+import { MoonBridgeRegistry } from './registry';
+
+const pendingMethodRegistrations = /* @__PURE__ */ new Map();
+function MoonBridgeModule(name) {
+  return function(target) {
+    logger.info(`[MoonBridgeModule] \u88C5\u9970\u5668\u6267\u884C moduleName=${name}`);
+    MoonBridgeRegistry.getInstance().registerModule(name, target);
+    const className = target.name;
+    const pending = pendingMethodRegistrations.get(className);
+    if (pending) {
+      const registry = MoonBridgeRegistry.getInstance();
+      for (const { methodAlias, methodName } of pending) {
+        registry.registerMethod(name, methodAlias, { className, methodName });
+      }
+      pendingMethodRegistrations.delete(className);
+    }
+  };
+}
+function MoonBridgeMethod(name) {
+  return function(target, propertyKey, _descriptor) {
+    const clazz = target.constructor;
+    const className = clazz.name;
+    const methodAlias = name != null ? name : propertyKey;
+    logger.info(`[MoonBridgeMethod] \u88C5\u9970\u5668\u6267\u884C methodAlias=${methodAlias} propertyKey=${propertyKey}`);
+    const registry = MoonBridgeRegistry.getInstance();
+    let matchedModuleName = "";
+    for (const [moduleName, ctor] of registry.moduleCtorMap) {
+      if (ctor.name === className) {
+        matchedModuleName = moduleName;
+        break;
+      }
+    }
+    if (matchedModuleName) {
+      registry.registerMethod(matchedModuleName, methodAlias, {
+        className,
+        methodName: propertyKey
+      });
+    } else {
+      let list = pendingMethodRegistrations.get(className);
+      if (!list) {
+        list = [];
+        pendingMethodRegistrations.set(className, list);
+      }
+      list.push({ methodAlias, methodName: propertyKey });
+    }
+  };
+}
+
+export { MoonBridgeMethod, MoonBridgeModule };
+//# sourceMappingURL=decorators.mjs.map
+//# sourceMappingURL=decorators.mjs.map