@esengine/ecs-framework 2.2.21 → 2.3.0

package/bin/ECS/WorldManager.js

@@ -0,0 +1,365 @@
+import { World } from './World';
+import { createLogger } from '../Utils/Logger';
+const logger = createLogger('WorldManager');
+/**
+ * World管理器 - 管理所有World实例
+ *
+ * WorldManager负责管理多个独立的World实例。
+ * 每个World都是独立的ECS环境，可以包含多个Scene。
+ *
+ * 适用场景：
+ * - MMO游戏的多房间管理
+ * - 服务器端的多游戏实例
+ * - 需要完全隔离的多个游戏环境
+ *
+ * @example
+ * ```typescript
+ * // 创建WorldManager实例
+ * const worldManager = new WorldManager({
+ *     maxWorlds: 100,
+ *     autoCleanup: true
+ * });
+ *
+ * // 创建游戏房间World
+ * const room1 = worldManager.createWorld('room_001', {
+ *     name: 'GameRoom_001',
+ *     maxScenes: 5
+ * });
+ * room1.setActive(true);
+ *
+ * // 游戏循环
+ * function gameLoop(deltaTime: number) {
+ *     Core.update(deltaTime);
+ *     worldManager.updateAll();  // 更新所有活跃World
+ * }
+ * ```
+ */
+export class WorldManager {
+    constructor(config = {}) {
+        this._worlds = new Map();
+        this._isRunning = false;
+        this._framesSinceCleanup = 0;
+        this._config = {
+            maxWorlds: 50,
+            autoCleanup: true,
+            cleanupFrameInterval: 1800, // 1800帧
+            debug: false,
+            ...config
+        };
+        // 默认启动运行状态
+        this._isRunning = true;
+        logger.info('WorldManager已初始化', {
+            maxWorlds: this._config.maxWorlds,
+            autoCleanup: this._config.autoCleanup,
+            cleanupFrameInterval: this._config.cleanupFrameInterval
+        });
+    }
+    /**
+     * 创建新World
+     */
+    createWorld(worldName, config) {
+        if (!worldName || typeof worldName !== 'string' || worldName.trim() === '') {
+            throw new Error('World name不能为空');
+        }
+        if (this._worlds.has(worldName)) {
+            throw new Error(`World name '${worldName}' 已存在`);
+        }
+        if (this._worlds.size >= this._config.maxWorlds) {
+            throw new Error(`已达到最大World数量限制: ${this._config.maxWorlds}`);
+        }
+        // 优先级：config.debug > WorldManager.debug > 默认
+        const worldConfig = {
+            name: worldName,
+            debug: config?.debug ?? this._config.debug ?? false,
+            ...(config?.maxScenes !== undefined && { maxScenes: config.maxScenes }),
+            ...(config?.autoCleanup !== undefined && { autoCleanup: config.autoCleanup })
+        };
+        const world = new World(worldConfig);
+        this._worlds.set(worldName, world);
+        return world;
+    }
+    /**
+     * 移除World
+     */
+    removeWorld(worldName) {
+        const world = this._worlds.get(worldName);
+        if (!world) {
+            return false;
+        }
+        // 销毁World
+        world.destroy();
+        this._worlds.delete(worldName);
+        logger.info(`移除World: ${worldName}`);
+        return true;
+    }
+    /**
+     * 获取World
+     */
+    getWorld(worldName) {
+        return this._worlds.get(worldName) || null;
+    }
+    /**
+     * 获取所有World ID
+     */
+    getWorldIds() {
+        return Array.from(this._worlds.keys());
+    }
+    /**
+     * 获取所有World
+     */
+    getAllWorlds() {
+        return Array.from(this._worlds.values());
+    }
+    /**
+     * 设置World激活状态
+     */
+    setWorldActive(worldName, active) {
+        const world = this._worlds.get(worldName);
+        if (!world) {
+            logger.warn(`World '${worldName}' 不存在`);
+            return;
+        }
+        if (active) {
+            world.start();
+            logger.debug(`激活World: ${worldName}`);
+        }
+        else {
+            world.stop();
+            logger.debug(`停用World: ${worldName}`);
+        }
+    }
+    /**
+     * 检查World是否激活
+     */
+    isWorldActive(worldName) {
+        const world = this._worlds.get(worldName);
+        return world?.isActive ?? false;
+    }
+    /**
+     * 更新所有活跃的World
+     *
+     * 应该在每帧的游戏循环中调用。
+     * 会自动更新所有活跃World的全局系统和场景。
+     *
+     * @example
+     * ```typescript
+     * function gameLoop(deltaTime: number) {
+     *     Core.update(deltaTime);      // 更新全局服务
+     *     worldManager.updateAll();    // 更新所有World
+     * }
+     * ```
+     */
+    updateAll() {
+        if (!this._isRunning)
+            return;
+        for (const world of this._worlds.values()) {
+            if (world.isActive) {
+                // 更新World的全局System
+                world.updateGlobalSystems();
+                // 更新World中的所有Scene
+                world.updateScenes();
+            }
+        }
+        // 基于帧的自动清理
+        if (this._config.autoCleanup) {
+            this._framesSinceCleanup++;
+            if (this._framesSinceCleanup >= this._config.cleanupFrameInterval) {
+                this.cleanup();
+                this._framesSinceCleanup = 0; // 重置计数器
+                if (this._config.debug) {
+                    logger.debug(`执行定期清理World (间隔: ${this._config.cleanupFrameInterval} 帧)`);
+                }
+            }
+        }
+    }
+    /**
+     * 获取所有激活的World
+     */
+    getActiveWorlds() {
+        const activeWorlds = [];
+        for (const world of this._worlds.values()) {
+            if (world.isActive) {
+                activeWorlds.push(world);
+            }
+        }
+        return activeWorlds;
+    }
+    /**
+     * 启动所有World
+     */
+    startAll() {
+        this._isRunning = true;
+        for (const world of this._worlds.values()) {
+            world.start();
+        }
+        logger.info('启动所有World');
+    }
+    /**
+     * 停止所有World
+     */
+    stopAll() {
+        this._isRunning = false;
+        for (const world of this._worlds.values()) {
+            world.stop();
+        }
+        logger.info('停止所有World');
+    }
+    /**
+     * 查找满足条件的World
+     */
+    findWorlds(predicate) {
+        const results = [];
+        for (const world of this._worlds.values()) {
+            if (predicate(world)) {
+                results.push(world);
+            }
+        }
+        return results;
+    }
+    /**
+     * 根据名称查找World
+     */
+    findWorldByName(name) {
+        for (const world of this._worlds.values()) {
+            if (world.name === name) {
+                return world;
+            }
+        }
+        return null;
+    }
+    /**
+     * 获取WorldManager统计信息
+     */
+    getStats() {
+        const stats = {
+            totalWorlds: this._worlds.size,
+            activeWorlds: this.activeWorldCount,
+            totalScenes: 0,
+            totalEntities: 0,
+            totalSystems: 0,
+            memoryUsage: 0,
+            isRunning: this._isRunning,
+            config: { ...this._config },
+            worlds: []
+        };
+        for (const [worldName, world] of this._worlds) {
+            const worldStats = world.getStats();
+            stats.totalScenes += worldStats.totalSystems; // World的getStats可能需要调整
+            stats.totalEntities += worldStats.totalEntities;
+            stats.totalSystems += worldStats.totalSystems;
+            stats.worlds.push({
+                id: worldName,
+                name: world.name,
+                isActive: world.isActive,
+                sceneCount: world.sceneCount,
+                ...worldStats
+            });
+        }
+        return stats;
+    }
+    /**
+     * 获取详细状态信息
+     */
+    getDetailedStatus() {
+        return {
+            ...this.getStats(),
+            worlds: Array.from(this._worlds.entries()).map(([worldName, world]) => ({
+                id: worldName,
+                isActive: world.isActive,
+                status: world.getStatus()
+            }))
+        };
+    }
+    /**
+     * 清理空World
+     */
+    cleanup() {
+        const worldsToRemove = [];
+        for (const [worldName, world] of this._worlds) {
+            if (this.shouldCleanupWorld(world)) {
+                worldsToRemove.push(worldName);
+            }
+        }
+        for (const worldName of worldsToRemove) {
+            this.removeWorld(worldName);
+        }
+        if (worldsToRemove.length > 0) {
+            logger.debug(`清理了 ${worldsToRemove.length} 个World`);
+        }
+        return worldsToRemove.length;
+    }
+    /**
+     * 销毁WorldManager
+     */
+    destroy() {
+        logger.info('正在销毁WorldManager...');
+        // 停止所有World
+        this.stopAll();
+        // 销毁所有World
+        const worldNames = Array.from(this._worlds.keys());
+        for (const worldName of worldNames) {
+            this.removeWorld(worldName);
+        }
+        this._worlds.clear();
+        this._isRunning = false;
+        logger.info('WorldManager已销毁');
+    }
+    /**
+     * 实现 IService 接口的 dispose 方法
+     * 调用 destroy 方法进行清理
+     */
+    dispose() {
+        this.destroy();
+    }
+    /**
+     * 判断World是否应该被清理
+     * 清理策略：
+     * 1. World未激活
+     * 2. 没有Scene或所有Scene都是空的
+     * 3. 创建时间超过10分钟
+     */
+    shouldCleanupWorld(world) {
+        if (world.isActive) {
+            return false;
+        }
+        const age = Date.now() - world.createdAt;
+        const isOldEnough = age > 10 * 60 * 1000; // 10分钟
+        if (world.sceneCount === 0) {
+            return isOldEnough;
+        }
+        // 检查是否所有Scene都是空的
+        const allScenes = world.getAllScenes();
+        const hasEntities = allScenes.some((scene) => scene.entities && scene.entities.count > 0);
+        return !hasEntities && isOldEnough;
+    }
+    /**
+     * 获取World总数
+     */
+    get worldCount() {
+        return this._worlds.size;
+    }
+    /**
+     * 获取激活World数量
+     */
+    get activeWorldCount() {
+        let count = 0;
+        for (const world of this._worlds.values()) {
+            if (world.isActive)
+                count++;
+        }
+        return count;
+    }
+    /**
+     * 检查是否正在运行
+     */
+    get isRunning() {
+        return this._isRunning;
+    }
+    /**
+     * 获取配置
+     */
+    get config() {
+        return { ...this._config };
+    }
+}
+//# sourceMappingURL=WorldManager.js.map

package/bin/ECS/WorldManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorldManager.js","sourceRoot":"","sources":["../../src/ECS/WorldManager.ts"],"names":[],"mappings":"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"}

package/bin/ECS/index.d.ts

@@ -0,0 +1,26 @@
+export { Entity } from './Entity';
+export { Component } from './Component';
+export { EEntityLifecyclePolicy } from './Core/EntityLifecyclePolicy';
+export { ECSEventType, EventPriority, EVENT_TYPES, EventTypeValidator } from './CoreEvents';
+export * from './Systems';
+export * from './Utils';
+export * from './Decorators';
+export * from './Components';
+export { Scene } from './Scene';
+export { IScene, ISceneFactory, ISceneConfig } from './IScene';
+export { SceneManager } from './SceneManager';
+export { World, IWorldConfig } from './World';
+export { WorldManager, IWorldManagerConfig } from './WorldManager';
+export * from './Core/Events';
+export * from './Core/Query';
+export * from './Core/Storage';
+export * from './Core/StorageDecorators';
+export * from './Serialization';
+export { ReferenceTracker, getSceneByEntityId } from './Core/ReferenceTracker';
+export type { EntityRefRecord } from './Core/ReferenceTracker';
+export { ReactiveQuery, ReactiveQueryChangeType } from './Core/ReactiveQuery';
+export type { ReactiveQueryChange, ReactiveQueryListener, ReactiveQueryConfig } from './Core/ReactiveQuery';
+export { CommandBuffer, CommandType } from './Core/CommandBuffer';
+export type { DeferredCommand } from './Core/CommandBuffer';
+export * from './EntityTags';
+//# sourceMappingURL=index.d.ts.map

package/bin/ECS/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ECS/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5F,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACnE,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC5G,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,cAAc,cAAc,CAAC"}

package/bin/ECS/index.js

@@ -0,0 +1,21 @@
+export { Entity } from './Entity';
+export { Component } from './Component';
+export { ECSEventType, EventPriority, EVENT_TYPES, EventTypeValidator } from './CoreEvents';
+export * from './Systems';
+export * from './Utils';
+export * from './Decorators';
+export * from './Components';
+export { Scene } from './Scene';
+export { SceneManager } from './SceneManager';
+export { World } from './World';
+export { WorldManager } from './WorldManager';
+export * from './Core/Events';
+export * from './Core/Query';
+export * from './Core/Storage';
+export * from './Core/StorageDecorators';
+export * from './Serialization';
+export { ReferenceTracker, getSceneByEntityId } from './Core/ReferenceTracker';
+export { ReactiveQuery, ReactiveQueryChangeType } from './Core/ReactiveQuery';
+export { CommandBuffer, CommandType } from './Core/CommandBuffer';
+export * from './EntityTags';
+//# sourceMappingURL=index.js.map

package/bin/ECS/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ECS/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5F,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAgB,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAuB,MAAM,gBAAgB,CAAC;AACnE,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAElE,cAAc,cAAc,CAAC"}

package/bin/Platform/IPlatformAdapter.d.ts

@@ -0,0 +1,169 @@
+/**
+ * 平台适配器接口
+ * 用于适配不同的运行环境（浏览器、微信小游戏、字节跳动小游戏等）
+ */
+export interface IPlatformAdapter {
+    /**
+     * 平台名称
+     */
+    readonly name: string;
+    /**
+     * 平台版本信息
+     */
+    readonly version?: string;
+    /**
+     * 检查是否支持Worker
+     */
+    isWorkerSupported(): boolean;
+    /**
+     * 检查是否支持SharedArrayBuffer
+     */
+    isSharedArrayBufferSupported(): boolean;
+    /**
+     * 获取硬件并发数（CPU核心数）
+     */
+    getHardwareConcurrency(): number;
+    /**
+     * 创建Worker
+     * @param script Worker脚本内容
+     * @param options Worker选项
+     */
+    createWorker(script: string, options?: WorkerCreationOptions): PlatformWorker;
+    /**
+     * 创建SharedArrayBuffer
+     * @param length 缓冲区大小（字节）
+     */
+    createSharedArrayBuffer(length: number): SharedArrayBuffer | null;
+    /**
+     * 获取高精度时间戳
+     */
+    getHighResTimestamp(): number;
+    /**
+     * 获取平台特定的配置
+     */
+    getPlatformConfig(): PlatformConfig;
+    /**
+     * 异步获取平台配置（包含需要异步获取的信息）
+     */
+    getPlatformConfigAsync?(): Promise<PlatformConfig>;
+}
+/**
+ * Worker创建选项
+ */
+export interface WorkerCreationOptions {
+    /**
+     * Worker类型
+     */
+    type?: 'classic' | 'module';
+    /**
+     * 凭据模式
+     */
+    credentials?: 'omit' | 'same-origin' | 'include';
+    /**
+     * Worker名称（用于调试）
+     */
+    name?: string;
+}
+/**
+ * 平台Worker接口
+ */
+export interface PlatformWorker {
+    /**
+     * 发送消息到Worker
+     */
+    postMessage(message: any, transfer?: Transferable[]): void;
+    /**
+     * 监听Worker消息
+     */
+    onMessage(handler: (event: {
+        data: any;
+    }) => void): void;
+    /**
+     * 监听Worker错误
+     */
+    onError(handler: (error: ErrorEvent) => void): void;
+    /**
+     * 终止Worker
+     */
+    terminate(): void;
+    /**
+     * Worker状态
+     */
+    readonly state: 'running' | 'terminated';
+}
+/**
+ * 平台配置
+ */
+export interface PlatformConfig {
+    /**
+     * 最大Worker数量限制
+     */
+    maxWorkerCount: number;
+    /**
+     * 是否支持模块Worker
+     */
+    supportsModuleWorker: boolean;
+    /**
+     * 是否支持Transferable Objects
+     */
+    supportsTransferableObjects: boolean;
+    /**
+     * SharedArrayBuffer的最大大小限制（字节）
+     */
+    maxSharedArrayBufferSize?: number;
+    /**
+     * 平台特定的Worker脚本前缀（如果需要）
+     */
+    workerScriptPrefix?: string;
+    /**
+     * 平台特定的限制和特性
+     */
+    limitations?: {
+        /**
+         * 是否禁用eval（影响动态脚本创建）
+         */
+        noEval?: boolean;
+        /**
+         * 是否需要特殊的Worker初始化
+         */
+        requiresWorkerInit?: boolean;
+        /**
+         * 内存限制（字节）
+         */
+        memoryLimit?: number;
+        /**
+         * Worker是否不受支持（用于明确标记不支持Worker的平台）
+         */
+        workerNotSupported?: boolean;
+        /**
+         * Worker限制说明列表
+         */
+        workerLimitations?: string[];
+    };
+    /**
+     * 平台特定的扩展属性
+     */
+    extensions?: Record<string, any>;
+}
+/**
+ * 平台检测结果
+ */
+export interface PlatformDetectionResult {
+    /**
+     * 平台类型
+     */
+    platform: 'browser' | 'wechat-minigame' | 'bytedance-minigame' | 'alipay-minigame' | 'baidu-minigame' | 'nodejs' | 'unknown';
+    /**
+     * 是否确定检测结果
+     */
+    confident: boolean;
+    /**
+     * 检测到的特征
+     */
+    features: string[];
+    /**
+     * 建议使用的适配器类名
+     */
+    adapterClass?: string;
+}
+//# sourceMappingURL=IPlatformAdapter.d.ts.map

package/bin/Platform/IPlatformAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPlatformAdapter.d.ts","sourceRoot":"","sources":["../../src/Platform/IPlatformAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,iBAAiB,IAAI,OAAO,CAAC;IAE7B;;OAEG;IACH,4BAA4B,IAAI,OAAO,CAAC;IAExC;;OAEG;IACH,sBAAsB,IAAI,MAAM,CAAC;IAEjC;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAAC;IAE9E;;;OAGG;IACH,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAAC;IAElE;;OAEG;IACH,mBAAmB,IAAI,MAAM,CAAC;IAE9B;;OAEG;IACH,iBAAiB,IAAI,cAAc,CAAC;IAEpC;;OAEG;IACH,sBAAsB,CAAC,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAE5B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAEjD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAE3D;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,GAAG,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAEpD;;OAEG;IACH,SAAS,IAAI,IAAI,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,oBAAoB,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,2BAA2B,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,WAAW,CAAC,EAAE;QACV;;WAEG;QACH,MAAM,CAAC,EAAE,OAAO,CAAC;QAEjB;;WAEG;QACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAE7B;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAE7B;;WAEG;QACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAChC,CAAC;IAEF;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC;;OAEG;IACH,QAAQ,EAAE,SAAS,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,QAAQ,GAAG,SAAS,CAAC;IAE7H;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/bin/Platform/IPlatformAdapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IPlatformAdapter.js.map

package/bin/Platform/IPlatformAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPlatformAdapter.js","sourceRoot":"","sources":["../../src/Platform/IPlatformAdapter.ts"],"names":[],"mappings":""}

package/bin/Platform/PlatformDetector.d.ts

@@ -0,0 +1,56 @@
+import type { PlatformDetectionResult } from './IPlatformAdapter';
+/**
+ * 平台检测器
+ * 自动检测当前运行环境并返回对应的平台信息
+ */
+export declare class PlatformDetector {
+    /**
+     * 检测当前平台
+     */
+    static detect(): PlatformDetectionResult;
+    /**
+     * 检测是否为微信小游戏环境
+     */
+    private static isWeChatMiniGame;
+    /**
+     * 检测是否为字节跳动小游戏环境
+     */
+    private static isByteDanceMiniGame;
+    /**
+     * 检测是否为Node.js环境
+     */
+    private static isNodeJS;
+    /**
+     * 检测是否为支付宝小游戏环境
+     */
+    private static isAlipayMiniGame;
+    /**
+     * 检测是否为百度小游戏环境
+     */
+    private static isBaiduMiniGame;
+    /**
+     * 检测是否为浏览器环境
+     */
+    private static isBrowser;
+    /**
+     * 检测是否在 Tauri 桌面环境中运行
+     * Check if running in Tauri desktop environment
+     *
+     * 同时支持 Tauri v1 (__TAURI__) 和 v2 (__TAURI_INTERNALS__)
+     * Supports both Tauri v1 (__TAURI__) and v2 (__TAURI_INTERNALS__)
+     */
+    static isTauriEnvironment(): boolean;
+    /**
+     * 检测是否在编辑器环境中运行
+     * Check if running in editor environment
+     *
+     * 包括 Tauri 桌面应用或带 __ESENGINE_EDITOR__ 标记的环境
+     * Includes Tauri desktop app or environments marked with __ESENGINE_EDITOR__
+     */
+    static isEditorEnvironment(): boolean;
+    /**
+     * 获取详细的环境信息（用于调试）
+     */
+    static getDetailedInfo(): Record<string, any>;
+}
+//# sourceMappingURL=PlatformDetector.d.ts.map

package/bin/Platform/PlatformDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformDetector.d.ts","sourceRoot":"","sources":["../../src/Platform/PlatformDetector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE;;;GAGG;AACH,qBAAa,gBAAgB;IACzB;;OAEG;WACW,MAAM,IAAI,uBAAuB;IA+F/C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAU/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAUlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;IAmBvB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAU/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAU9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAQxB;;;;;;OAMG;WACW,kBAAkB,IAAI,OAAO;IAQ3C;;;;;;OAMG;WACW,mBAAmB,IAAI,OAAO;IAkB5C;;OAEG;WACW,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CA4CvD"}