@three-blocks/devtools 1.0.1-alpha.214.gf051bb7d43f2 → 1.0.1-alpha.217.g90981be82863

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @three-blocks/devtools
 
-## 1.0.1-alpha.214.gf051bb7d43f2
+## 1.0.1-alpha.217.g90981be82863
 
 - Packages: Three.js 186dev now uses upstream asynchronous compute compilation.
 
@@ -8,7 +8,9 @@
 
 - Tools: Mesh to Splat now ignores render-hidden collections when framing captures.
 
-- Packages: Built from `f051bb7d43f2`.
+- Library: Vertex Animation Video now fails cleanly when numerical tracks cannot be decoded.
+
+- Packages: Built from `90981be82863`.
 
 
 ## 1.0.0

package/README.md

@@ -4,7 +4,7 @@
 
 ## Add Devtools to a Vite app
 
-The Three Blocks starter already installs and configures this package. Pin the command engine in an adopted project when you need offline, version-locked commands:
+The Three Blocks starter already installs and configures this package. An adopted project installs it once; every `npx three-blocks` command in this document runs the project's own copy:
 
 ```bash
 npm install --save-dev @three-blocks/devtools
@@ -47,9 +47,9 @@ The overlay changes from **Live** to **Precompiled** after a fresh capture loads
 
 ### Three.js r185 compatibility patch
 
-Shader precompilation supports Three.js `>=0.185.0 <0.186.0`. Every adapter applies the same version-gated transform to `three/build/three.webgpu.js` in memory and never writes `node_modules`. Exact source anchors fail closed on unknown or partially patched builds. Current captures require precompiled manifest version `3` and shader receipt transform version `51`; recapture older artifacts instead of editing them.
+Shader precompilation supports Three.js `>=0.185.0 <0.186.0`. Every adapter applies the same version-gated transform to `three/build/three.webgpu.js` in memory and never writes `node_modules`. Exact source anchors fail closed on unknown or partially patched builds. Current captures require precompiled manifest version `3` and shader receipt transform version `53`; recapture older artifacts instead of editing them.
 
-The [Three.js WebGPU compatibility reference](../../docs/maintenance/three-webgpu-release-compatibility.md) defines the released r185 patches, source markers, removal conditions, and verification gates.
+The [Devtools guide](https://threejs-blocks.com/docs/tools/devtools) lists the released r185 patches behind that transform.
 
 ### Manual bundler adapters
 
@@ -150,7 +150,7 @@ Artifact writes are transactional. `meta.json` records runtime, tool, schema, so
 
 `shaders test` first repeats the GPU-free matrix inspection. Its browser gate proves that the live baseline builds every registered render pipeline and compute kernel. The fresh path must perform zero registered builds, report no misses, reach first-frame readiness, render non-black output, and match deterministic pixels.
 
-Successful scenes are checkpointed against their scene receipt and the shared runtime and tool contract. A later run can resume at the missing scene. `--parity-only` runs one live and precompiled pair without timing warmups, repeats, or the published-page soak. The default mode retains those measurements and production-page checks. A parity observation is capped at 10 seconds. Failures write live, precompiled, and diff PNGs under `.three-blocks/shaders/parity/`.
+Successful scenes are checkpointed against their scene receipt and the shared runtime and tool contract. A later run can resume at the missing scene. `--parity-only` runs one live and precompiled pair without timing warmups, repeats, or the published-page soak. The default mode retains those measurements and production-page checks. A parity observation is bounded by the per-scene `timeoutMs`, 240 seconds by default. Failures write live, precompiled, and diff PNGs under `.three-blocks/shaders/parity/`.
 
 ### Verify a browser integration
 
@@ -162,7 +162,7 @@ npx three-blocks browser preview --route /
 
 The smoke gate loads the project's Vite config on an ephemeral loopback port. It requires the visible OffscreenCanvas worker plus `workerReady`, `assetsReady`, and `compileEnd`. It also requires `textReady` when the Vite text configuration is enabled. Every configured Draco and KTX2 route is fetched, the lazy Meshopt decoder is initialized, and page or console errors fail the run. The gate checks the WebGPU screenshot and readable 2D panels for an all-black frame.
 
-The command reads the starter's built-in readiness check. Application tutorials describe the visible **Starting**, **Ready**, **Precompiled**, and **Live** states instead of this maintainer contract. Contributors can inspect the exact protocol in the [maintainer browser-verification reference](../../docs/maintenance/browser-verification.md).
+The command reads the starter's built-in readiness check. Application tutorials describe the visible **Starting**, **Ready**, **Precompiled**, and **Live** states instead of this maintainer contract.
 
 `--hmr project_relative_module` emits a synthetic watcher change through Vite for an already loaded scene module. It runs the HMR graph without changing source and verifies that the browser acknowledges the update while lifecycle readiness remains stable.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@three-blocks/devtools",
-  "version": "1.0.1-alpha.214.gf051bb7d43f2",
+  "version": "1.0.1-alpha.217.g90981be82863",
   "description": "Three Blocks devtools command engine for npx three-blocks; the runtime lives in three-blocks/devtools and the Vite plugin",
   "keywords": [
     "three",
@@ -79,7 +79,7 @@
     "@types/three": "0.185.0",
     "create-vite": "9.1.1",
     "playwright": "^1.61.1",
-    "three-blocks": "0.2.1-alpha.214.gf051bb7d43f2",
+    "three-blocks": "0.2.1-alpha.217.g90981be82863",
     "tsup": "^8.0.0",
     "typescript": "^5.9.3",
     "vite": "^7.2.2",
@@ -91,7 +91,7 @@
   "peerDependencies": {
     "playwright": "^1.61.1",
     "three": ">=0.185.0 <0.186.0",
-    "three-blocks": "0.2.1-alpha.214.gf051bb7d43f2",
+    "three-blocks": "0.2.1-alpha.217.g90981be82863",
     "typescript": ">=5.9.3 <7.0.0",
     "vite": ">=7.2.2 <9.0.0"
   },