A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
docs: record the WebGPU push-gate landing in the rearch map
yhh6c85d38ae866
diff --git a/docs/REARCHITECTURE.md b/docs/REARCHITECTURE.mdindex 80d7ecb6d..449dc2f46 100644--- a/docs/REARCHITECTURE.md+++ b/docs/REARCHITECTURE.md@@ -197,7 +197,7 @@ TS 驱动的主 pass clear 退出边界,`clear` 家族退出公共 RHI:**naga vendored(2026-07-08)**:SPIR-V→WGSL 侧零外部依赖——`tools/naga-spv2wgsl`(30 行 stdin→stdout WASI 封装 crate,Cargo.lock 钉版)编 wasm32-wasip1 产物入库 `build-tools/shader-twins/naga-spv2wgsl.wasm`(674KB,basis 先例同款 gitignore 白名单),`naga.mjs` 经 node:wasi 进程内运行;gen-shader-twins 改走 vendored 路径,**全部 fixture 重生成零 diff**(与 naga-cli 30 逐字节一致)。**glslang vendored(2026-07-08,用户批准 submodule)**:GLSL→SPIR-V 侧也零外部依赖——`third_party/glslang` submodule(钉 16.3.0)+ `tools/glslang-wasm/wrapper.cpp`(薄 C ABI,精确镜像 `glslangValidator -V --auto-map-locations`:Vulkan 1.0 语义、auto-map locations、无优化器)经 emscripten 构建入库 `build-tools/shader-twins/glslang-compile.{mjs,wasm}`(1.8MB)。**gen-shader-twins 自此零 PATH 依赖**(只需 build:web 产物);全 fixtures 经全 vendored 管线重生成**零 diff**(与本机 glslangValidator 16.0.0 + naga-cli 30 逐字节一致——跨 glslang 小版本仍稳定)。CI 新增两守卫(verify-render job):孪生覆盖检查(--check 全 fixtures)+ **管线冒烟**(剥孪生临时副本走完整 GLSL→SPIR-V→WGSL,每次 CI 真跑两个 wasm 转换器)。坑:工具改 `process.exitCode` 优雅退出——硬 process.exit 与存活的 emscripten 运行时在 Windows 上有拆除竞态(STATUS_STACK_BUFFER_OVERRUN)。**wechat/playable 并入 sourcePath 解析(2026-07-08,三线归一收官)**:wechat——AddressableManifest 的 `address` 字段承载逻辑源路径(ManifestModel 索引 address 双拼写入 byKey → resolvePath 直接命中;initWeChatRuntime 从 address 构建 Catalog buildPath 喂 initRuntime,与 web 宿主同款双映射),exportWeChat 在 staging 改名时发射 address,exportGame 顺带补上 wechat 分支漏转发 contentAddressed/compressTextures 的穿线缺口。playable——导出器发射紧凑 `__GAME_PATHMAP__`(逻辑路径→`@uuid:` 键),运行时**内存内别名**到内嵌 assets 映射(别名共享 data-URL 字符串,载荷零重复;fetch/图像解码/音频三通道读同一张表)。三条导出线自此共用同一套"逻辑身份 → staged 物理"解析语义。-**剩余**:CI 无 WebGPU 适配器(webgpu verify 仅本地)。+**WebGPU 验证入 push 门禁(2026-07-08,f236fc73,最后一个"环境性限制"证伪)**:"CI 无 WebGPU 适配器"是约定不是事实——Dawn 经 Electron 自带的 SwiftShader Vulkan(`--use-webgpu-adapter=swiftshader`)在无 GPU runner 上获得真实适配器;本地强制软件适配器与硬件运行逐像素一致(grid diff 22098 相同)。headless-verify 增 `enable-unsafe-webgpu` + `ESTELLA_VERIFY_WEBGPU_ADAPTER` 开关;build.yml verify-render 新增 WebGPU 段,四场景与 GL battery 同断言(sprite+grid / parallax-shape / mat-lit-point 生成孪生+Lit2D / mat-tint+preview 异步 readback),分支预演全绿后 fast-forward。**双后端像素验证自此每次 push 自动跑。**见 `REARCH_WGSL.md`(本地 gitignore,同 RC6/2D_PARITY 约定):着色器版图盘点(uniform 数据已全后端中立,剩程序文本)、岔路拍板(有限集人工孪生 / 图材质 AST 双发射 / 用户材质 cook 期转换——拒绝运行时翻译器的 MB 级体积代价)、四期计划(源语言接缝 → WebGPUDevice 原型 → 双语发射 → cook 期用户材质)。**Phase 0 已落地**:最后 3 个 GLSL ES 1.00 残留(SDK outline/drop-shadow/color-matrix 滤镜)重写为 fragment-only `.esshader` 反射路径——顺带修复其设计性破损(raw 形态无 `u_projection` 来源、无属性绑定、mat4 超 `setMaterialUniform` 的 vec4 上限**从未能传入**;色彩矩阵改为 4×vec4 行 + 偏移列,新增 `Filters.colorMatrixUniforms` 助手)。全仓每个程序自此都在现代缝上(300 es + UBO 反射)。**Phase 1(源语言接缝)已落地**:RHI 补上最后一块后端中立拼图——`createProgram` 收语言标签的 `GfxShaderSource`,新增 `supportsShaderLanguage` 能力查询(GL = 仅 GLSL ES 300;`Shader::compile` 在任何 GPU 调用前对不支持的语言快速失败);语言贯穿 Shader/ResourceManager(DrawParams 重写仅对 GLSL 生效);`ShaderParser::assembleStage` 获得 `ShaderTargetLanguage` 参数(WGSL 发射 = Phase 3)。MockGfxDevice 新增 `wgslSupported` 开关 + 语言门用例;行为零变化(8 harness + 场景抽样等价)。**Phase 2 切片 1(WebGPU 后端启动)已落地**:emdawnwebgpu 端口(Dawn)集成为测试目标独立依赖(主构建零影响);`renderer/webgpu/` 新增纯映射层(GfxEnums→WGPU 全翻译,blend/模板表镜像 GLDevice 语义,load-op 规则与 RenderPassDesc 契约一致)+ 空设备安全的 `WebGPUDevice` 骨架(缓冲/纹理/WGSL 模块真实现,布局/管线描述符保留待惰性构建,pass/draw 为切片 2 结构化桩);`test_webgpu_device` 用真 Dawn 头编译验证全部描述符拼写,入 CI。