vgpu

vgpu 发布 v0.6.0 稳定预 1.0 版（8 个公开包统一 0.6.0，可选 @vgpu/native 仍为 beta）：预编译 ShaderSource v2 制品将 WGSL 反射移入构建期，动态着色器改用 prepareShader()，加载器与渲染器须配套升级；Next.js Turbopack 集成新增 wgslTurbopackRule() 获得感知编译器的持久缓存。场景组合改为显式变换、相机状态、层级求值与固定容量实例，应用自行负责着色、灯光、输入与调度；帧自有 compute pass 保留 compute/render 顺序并按操作捕获 managed uniform。Canvas Surface 支持可选深度/MSAA 与帧外 pipeline 准备；设备丢失改为显式 gpu.lost 通知，资源绑定校验与生命周期契约更明确；重复编码与不变 managed uniform 复用未变化工作，接受奇数长度 Uint16 索引上传。自 0.5.0 升级需按迁移指南执行 API 步骤，自 rc.1/rc.2 升级仅需更新包版本并验证编码与索引上传修复。

vgpu 发布 v0.6.0-rc.2 候选版（npm next 渠道，稳定 latest 不变，8 个公开包统一为 0.6.0-rc.2）：初始上传时通过填充支持奇数长度的 Uint16Array 几何索引，逻辑计数、subarray 边界与 writeIndices 边界保持不变；通过复用绑定校验与 bind-group 键减少未变化 draws、effects、computes 编码时的 CPU 开销，draws 与 effects 另复用派生 pipeline 键，资源失效、uniform 捕获与延迟 pipeline 错误行为不变。自 rc.1 升级无需代码改动；自稳定版 0.5.0 或 rc.0 升级须按整合迁移指南准备 v2 着色器并应用场景、帧与绑定变更；可选原生组件仍为 beta。

vgpu 发布 v0.6.0-rc.0 候选版（npm next 渠道）：新增应用自有的场景组合能力（变换、相机状态、层级求值、实例化几何体及 WGSL 场景辅助）；Canvas Surface 支持深度与 4x MSAA，可在帧外预建 pipeline/bundle；新增惰性 compute 准备、帧自有 compute pass 与按操作的 managed-uniform 捕获；bundle 保留自动清理并支持可选 bundle.dispose()；gpu.settled() 纳入已提交队列工作，gpu.lost 语义修正。含破坏性 API 变更，需阅读 0.6.0 迁移指南。

vgpu v0.5.0 稳定版发布：将 0.5.0-rc.1 的 API 与默认配置提升至 stable 渠道，八个公开包统一版本号，可选原生工具仍为 beta。稳定内容包括：核心与公开 API 的显式纹理形状/usage、不可变分配与 mip/区域回读；更安全的 target/纹理对替换、已销毁资源校验与 stale-bundle 检测；Node/Linux 默认使用 Vulkan（含 X11/Wayland 主机）；intrinsic WGSL host layouts、入口点元数据与严格 JS 持有绑定值；可选 @vgpu/native 生成 Swift/Metal 包（内置固定版本、经认证的 Tint worker）。RC1 用户无需额外 API 迁移，仅更新包版本；从 0.4.x/RC0 升级需阅读 0.5.0 迁移指南。

vgpu 发布 v0.5.0-rc.1 候选版（npm next 渠道，不更新 latest）：首个可用的 @vgpu/native beta，提供构建时 WGSL→Swift/Metal 工具链（vgpu native doctor/check/build/verify），npm 内置固定版本且哈希校验的 Tint worker，安装时无需构建或下载 Tint，产物只含 Swift 与编译后 Metal 资源、不含 Node/Tint 运行时依赖；要求 Node 22 与 Apple Silicon Mac，worker 仅 ad hoc 签名。另有不依赖原生开关的破坏性变更：intrinsic WGSL host layouts、严格 JS 持有绑定值与入口点声明元数据，多绑定 set 调用不再全局原子；RC0 纹理契约与 Linux Vulkan 默认不变，需按迁移指南从 0.4.1 或 rc.0 升级。

vgpu 发布 v0.5.0-rc.0 候选版（npm next 渠道，latest 仍为稳定版）：七个公开包统一版本号；引入显式统一的纹理创建 API（kind、size、layers、usage 及不可变创建元数据），纹理回读支持显式 mip 选择、mip 相对区域及任意 layer/slice；改进纹理替换与资源生命周期处理（stale bundle 检测、compute/draw 缓存分离）；Linux Node 渲染默认改用 Vulkan，规避 Dawn 在 OpenGL 上的受限 mip 视图与存储写入缺陷；新增 Atmosphere & Clouds 示例。含破坏性变更：移除 Texture.resize() 与 Target/Surface read 委托，需显式重分配并改用 texture.read({ mipLevel: 0, region: "all" })；Linux 需可用 Vulkan 驱动或便携 CPU 渲染器，不再静默回退 OpenGL。

vgpu v0.4.0 发布：新增 Three.js TSL 适配器，可将 WGSL 模块作为 three.js TSL 节点使用，并新增 three-tsl 文档示例；frame(gpu, cb) 改为原子语义（返回时提交、抛出时取消）；新增自适应质量与 Particle Orbit 示例及指南，示例 API 制品改为构建时生成，同时完善 WGSL 模块文档与示例页面源码路由。

Vercel 开源 TypeScript WebGPU 库 vgpu：以 MIT 协议发布到 npm，将 .wgsl 视为可导入 TS 模块，支持浏览器、无头 Node（Dawn）与 CI mock 三套运行时。