更新文档并预留wasm接口

source/build.config.js

@@ -25,20 +25,54 @@ module.exports = {
         sourcemap: true
     },
     
+    // WebAssembly支持配置
+    wasm: {
+        enabled: false, // 暂时禁用，未来启用
+        modules: {
+            // 计划迁移到WebAssembly的模块
+            core: {
+                entry: './src/wasm/core.ts',
+                output: 'ecs-core.wasm',
+                features: ['query-system', 'math-utils']
+            },
+            physics: {
+                entry: './src/wasm/physics.ts', 
+                output: 'ecs-physics.wasm',
+                features: ['collision-detection', 'spatial-hash']
+            }
+        },
+        // AssemblyScript配置
+        assemblyscript: {
+            target: 'wasm32',
+            optimize: true,
+            runtime: 'minimal'
+        }
+    },
+    
     // 游戏引擎特定配置
     engines: {
         laya: {
             // Laya引擎特定优化
             target: 'es5',
             polyfills: ['Promise', 'Object.assign'],
-            globals: ['Laya']
+            globals: ['Laya'],
+            wasm: {
+                // Laya环境下的WebAssembly配置
+                loader: 'laya-wasm-loader',
+                fallback: true // 支持降级到JavaScript
+            }
         },
 
         cocos: {
             // Cocos引擎特定优化
             target: 'es6',
             polyfills: [],
-            globals: ['cc']
+            globals: ['cc'],
+            wasm: {
+                // Cocos环境下的WebAssembly配置
+                loader: 'cocos-wasm-loader',
+                fallback: true
+            }
         }
     },
     
@@ -48,19 +82,33 @@ module.exports = {
             // 微信小游戏优化
             maxSize: '4MB',
             treeshaking: true,
-            compression: 'gzip'
+            compression: 'gzip',
+            wasm: {
+                // 微信小游戏WebAssembly支持
+                enabled: true,
+                maxWasmSize: '2MB', // WebAssembly模块大小限制
+                preload: ['ecs-core.wasm'] // 预加载核心模块
+            }
         },
         alipay: {
             // 支付宝小游戏优化
             maxSize: '4MB',
             treeshaking: true,
-            compression: 'gzip'
+            compression: 'gzip',
+            wasm: {
+                enabled: true,
+                maxWasmSize: '2MB'
+            }
         },
         bytedance: {
             // 字节跳动小游戏优化
             maxSize: '4MB',
             treeshaking: true,
-            compression: 'gzip'
+            compression: 'gzip',
+            wasm: {
+                enabled: true,
+                maxWasmSize: '2MB'
+            }
         }
     },
     
@@ -77,7 +125,23 @@ module.exports = {
             removeDebugger: true
         },
         // 内联小文件
-        inlineThreshold: 1024
+        inlineThreshold: 1024,
+        // WebAssembly优化
+        wasm: {
+            // 启用WebAssembly优化
+            optimize: true,
+            // 内存配置
+            memory: {
+                initial: 1, // 初始内存页数 (64KB per page)
+                maximum: 16, // 最大内存页数
+                shared: false // 是否共享内存
+            },
+            // 导出配置
+            exports: {
+                memory: true,
+                table: false
+            }
+        }
     },
     
     // 开发配置
@@ -93,5 +157,22 @@ module.exports = {
         minify: true,
         optimization: true,
         bundleAnalyzer: true
+    },
+    
+    // 实验性功能
+    experimental: {
+        // 混合架构支持
+        hybrid: {
+            enabled: true,
+            // 自动检测WebAssembly支持
+            autoDetect: true,
+            // 性能基准测试
+            benchmark: true,
+            // 降级策略
+            fallback: {
+                strategy: 'graceful', // 优雅降级
+                modules: ['core', 'physics'] // 支持降级的模块
+            }
+        }
     }
 };