feat: 添加跨平台运行时、资产系统和UI适配功能 (#256)

* feat(platform-common): 添加WASM加载器和环境检测API * feat(rapier2d): 新增Rapier2D WASM绑定包 * feat(physics-rapier2d): 添加跨平台WASM加载器 * feat(asset-system): 添加运行时资产目录和bundle格式 * feat(asset-system-editor): 新增编辑器资产管理包 * feat(editor-core): 添加构建系统和模块管理 * feat(editor-app): 重构浏览器预览使用import maps * feat(platform-web): 添加BrowserRuntime和资产读取 * feat(engine): 添加材质系统和着色器管理 * feat(material): 新增材质系统和着色器编辑器 * feat(tilemap): 增强tilemap编辑器和动画系统 * feat(modules): 添加module.json配置 * feat(core): 添加module.json和类型定义更新 * chore: 更新依赖和构建配置 * refactor(plugins): 更新插件模板使用ModuleManifest * chore: 添加第三方依赖库 * chore: 移除BehaviourTree-ai和ecs-astar子模块 * docs: 更新README和文档主题样式 * fix: 修复Rust文档测试和添加rapier2d WASM绑定 * fix(tilemap-editor): 修复画布高DPI屏幕分辨率适配问题 * feat(ui): 添加UI屏幕适配系统(CanvasScaler/SafeArea) * fix(ecs-engine-bindgen): 添加缺失的ecs-framework-math依赖 * fix: 添加缺失的包依赖修复CI构建 * fix: 修复CodeQL检测到的代码问题 * fix: 修复构建错误和缺失依赖 * fix: 修复类型检查错误 * fix(material-system): 修复tsconfig配置支持TypeScript项目引用 * fix(editor-core): 修复Rollup构建配置添加tauri external * fix: 修复CodeQL检测到的代码问题 * fix: 修复CodeQL检测到的代码问题
2025-12-03 22:15:22 +08:00
parent caf7622aa0
commit 63f006ab62
496 changed files with 77601 additions and 4067 deletions
--- a/packages/physics-rapier2d/src/loaders/WebRapier2DLoader.ts
+++ b/packages/physics-rapier2d/src/loaders/WebRapier2DLoader.ts
@@ -0,0 +1,96 @@
+/**
+ * Web 平台 Rapier2D 加载器
+ *
+ * 使用 @esengine/rapier2d 标准版（独立 WASM 文件）
+ */
+
+import type {
+    IWasmLibraryLoader,
+    WasmLibraryConfig,
+    PlatformInfo
+} from '@esengine/platform-common';
+import { PlatformType, isEditorEnvironment } from '@esengine/platform-common';
+
+/**
+ * Rapier2D 模块类型
+ */
+type RapierModule = typeof import('@esengine/rapier2d');
+
+/**
+ * Web 平台 Rapier2D 加载器
+ *
+ * 使用标准版，需要配置 WASM 路径
+ *
+ * @example
+ * ```typescript
+ * const loader = new WebRapier2DLoader(config);
+ * if (loader.isSupported()) {
+ *     const RAPIER = await loader.load();
+ *     // 使用 RAPIER...
+ * }
+ * ```
+ */
+export class WebRapier2DLoader implements IWasmLibraryLoader<RapierModule> {
+    private _config: WasmLibraryConfig;
+
+    /**
+     * 创建 Web 平台 Rapier2D 加载器
+     *
+     * @param config - 加载器配置
+     */
+    constructor(config: WasmLibraryConfig) {
+        this._config = config;
+    }
+
+    /**
+     * 加载 Rapier2D 模块
+     *
+     * @returns 初始化完成的 Rapier2D 模块
+     */
+    async load(): Promise<RapierModule> {
+        console.log(`[${this._config.name}] 正在加载 Web 版本...`);
+
+        // 动态导入标准版
+        const RAPIER = await import('@esengine/rapier2d');
+
+        // 初始化 WASM - 标准版需要提供 WASM 路径
+        // 构建时 WASM 文件会被复制到 wasm/ 目录
+        const wasmPath = this._config.web?.wasmPath || 'wasm/rapier_wasm2d_bg.wasm';
+        await RAPIER.init(wasmPath);
+
+        console.log(`[${this._config.name}] 加载完成`);
+        return RAPIER;
+    }
+
+    /**
+     * 检查是否支持 WebAssembly
+     *
+     * @returns 是否支持
+     */
+    isSupported(): boolean {
+        return typeof WebAssembly !== 'undefined';
+    }
+
+    /**
+     * 获取平台信息
+     * Get platform information
+     */
+    getPlatformInfo(): PlatformInfo {
+        return {
+            type: PlatformType.Web,
+            supportsWasm: typeof WebAssembly !== 'undefined',
+            supportsSharedArrayBuffer: typeof SharedArrayBuffer !== 'undefined',
+            needsPolyfills: [],
+            isEditor: isEditorEnvironment()
+        };
+    }
+
+    /**
+     * 获取加载器配置
+     *
+     * @returns 配置对象
+     */
+    getConfig(): WasmLibraryConfig {
+        return this._config;
+    }
+}