@three-blocks/devtools 1.0.1-alpha.230.g7108d9c53a58 → 3.0.0-alpha.280.g945a5d860d58

package/CHANGELOG.md

@@ -1,31 +1,85 @@
 # @three-blocks/devtools
 
-## 1.0.1-alpha.230.g7108d9c53a58
+## 3.0.0-alpha.280.g945a5d860d58
 
-- Website: Pro now highlights lifetime licensing and tools at $79/month annually or $99 monthly.
+- CLI: New projects return to the shell and prefer Bun for the development command.
 
-- CLI: Deployment status now reports Amplify through GitHub without an AWS login.
+- Devtools: Development stays available when compatible shader receipts predate a version bump.
 
-- Devtools: Pushes now return preprod failures to the active Agent and avoid oversized bundles.
+- Devtools: Headless shader checks ignore automatic favicon misses and allow slow screenshots.
 
-- Devtools: Shader precompilation now hydrates minified builds without preserving constructor names.
+- Library: Gaussian splats now promote still scenes to the fast tile compositor automatically.
 
-- Packages: Three.js 186dev now uses upstream asynchronous compute compilation.
+- Library: Gaussian splats now stage tile-compositor promotion to avoid frame spikes.
 
-- Starter: New projects now use the current runtime without stale shader receipts.
+- Library: Gaussian splats now use faster subgroup sorting when the GPU supports it.
 
-- Tools: Mesh to Splat now ignores render-hidden collections when framing captures.
+- Packages: Benchmarks settle each frame lane before sampling steady-state performance.
 
-- Library: Vertex Animation Video now fails cleanly when numerical tracks cannot be decoded.
+- Packages: Benchmarks now compare GaussianSplats3D under the same standard protocol.
 
-- Packages: Documentation now matches the shipped commands, versions, and ports.
+- Website: Agent docs and llms.txt match the shipped release and cover Baked Motion format 3.
 
-- Website: Checkout now reuses billing profiles and collects tax-ready customer details.
+- Website: Example search now connects every showcased feature to its matching library blocks.
 
-- Website: Preprod billing now explains its read-only state instead of showing broken actions.
+- Packages: Built from `945a5d860d58`.
 
-- Packages: Built from `7108d9c53a58`.
 
+## 2.0.0
+
+### Minor Changes
+
+- beb026f: Packages: Shader tools now capture both backends by default and show backend tests and sizes.
+
+### Patch Changes
+
+- a59c7b8: Packages: Documentation now matches the shipped commands, versions, and ports.
+- a59c7b8: Devtools: Shader precompilation now hydrates minified builds without preserving constructor names.
+- b328fab: Packages: Precompiled shaders now preserve deterministic output across more Three.js examples.
+- 0ca530e: Devtools: Shader capture now respects each scene's supported renderer backends.
+- beb026f: Devtools: Precompiled indirect batches now skip redundant shader setup.
+- e8e7e30: Devtools: Shader precompilation now isolates backends and replays shared texture recipes.
+- beb026f: Starter: Fresh projects now avoid unstyled flashes and hydrate every captured startup shader.
+- 9daa49d: Packages: Three.js 186dev now uses upstream asynchronous compute compilation.
+- Updated dependencies [beb026f]
+- Updated dependencies [967a0ee]
+- Updated dependencies [967a0ee]
+- Updated dependencies [96be509]
+- Updated dependencies [96be509]
+- Updated dependencies [967a0ee]
+- Updated dependencies [96be509]
+- Updated dependencies [96be509]
+- Updated dependencies [96be509]
+- Updated dependencies [967a0ee]
+- Updated dependencies [96be509]
+- Updated dependencies [967a0ee]
+- Updated dependencies [beb026f]
+- Updated dependencies [0c23333]
+- Updated dependencies [e8e7e30]
+- Updated dependencies [a59c7b8]
+- Updated dependencies [beb026f]
+- Updated dependencies [967a0ee]
+- Updated dependencies [8bd64d6]
+- Updated dependencies [a59c7b8]
+- Updated dependencies [967a0ee]
+- Updated dependencies [b328fab]
+- Updated dependencies [0ca530e]
+- Updated dependencies [beb026f]
+- Updated dependencies [8bd64d6]
+- Updated dependencies [e8e7e30]
+- Updated dependencies [967a0ee]
+- Updated dependencies [0ca530e]
+- Updated dependencies [967a0ee]
+- Updated dependencies [9daa49d]
+- Updated dependencies [9daa49d]
+- Updated dependencies [beb026f]
+- Updated dependencies [9daa49d]
+- Updated dependencies [967a0ee]
+- Updated dependencies [967a0ee]
+- Updated dependencies [74a7597]
+- Updated dependencies [0c23333]
+- Updated dependencies [e8e7e30]
+  - three-blocks@0.3.0
 
 ## 1.0.0
 

package/README.md

@@ -1,6 +1,6 @@
 # @three-blocks/devtools
 
-`@three-blocks/devtools` is the public, account-free command engine behind `npx three-blocks`. It captures and verifies WebGPU shaders, generates text atlases, bakes environment lighting, and checks browser integrations. The runtime overlay and shader hydrator ship from `three-blocks/devtools` and `three-blocks/shaders` in the core package.
+`@three-blocks/devtools` is the public, account-free command engine behind `npx three-blocks`. It captures and verifies WebGPU shaders and eligible shaders from `WebGPURenderer`'s WebGL fallback, generates text atlases, bakes environment lighting, and checks browser integrations. The runtime overlay and shader hydrator ship from `three-blocks/devtools` and `three-blocks/shaders` in the core package.
 
 ## Add Devtools to a Vite app
 
@@ -43,7 +43,29 @@ Use `--driver static --serve build_directory` for a nonstandard build directory.
 
 The overlay changes from **Live** to **Precompiled** after a fresh capture loads. Each capture writes a receipt-matched estimate to `.three-blocks/shaders/timing.local.json`; `--commit-timing` also writes a shareable, hardware-labelled `timing.json`. `shaders test` replaces the local estimate with a median from repeated runs. The overlay reports skipped Three Shading Language (TSL) builds and estimated TSL work avoided only while timing matches the current receipt.
 
-`WebGLRenderer` stays on live shader building. `WebGPURenderer` also uses the live path when it selects a WebGL fallback.
+The default capture backend is `both`. Set `"backend": "webgpu"` or `"backend":
+"webgl"` to keep one lane, or select a lane explicitly:
+
+```bash
+npx three-blocks shaders capture --backend both
+npx three-blocks shaders test --parity-only --backend webgl
+npx three-blocks shaders status --check --backend webgl
+```
+
+Artifacts are symmetric: `.three-blocks/shaders/<scene>.<backend>.ts` and
+`public/three-blocks/shaders/<scene>.<backend>.json`. The receipt reports
+freshness per scene/backend, and the runtime loads only the active renderer's
+manifest.
+
+During development, the overlay's compact WebGPU/WebGL control reloads the page
+against either precompiled lane and reports the pooled WGSL/GLSL source size.
+
+This supports `WebGPURenderer` when it selects Three's WebGL fallback backend;
+the legacy standalone `WebGLRenderer` remains outside the provider seam.
+WebGL precompilation is render-only: compute, storage-buffer writes, subgroups,
+and PBO-backed storage reads stay on the live path with one warning. Required
+GLSL extensions are checked before hydration, so a capture from SwiftShader
+falls live instead of using incompatible source on another device.
 
 ### Three.js r185 compatibility patch
 
@@ -119,7 +141,7 @@ Use `npx three-blocks` in applications. This package also exposes `three-blocks-
 
 All commands support `--json` and `--reporter json`. `status` reads generated `three-blocks.json` metadata when present; adopted projects need only their shader or text configuration. Static status validates committed artifacts, compatibility versions, the installed `three-blocks/shaders` runtime closure, and discovered shader inputs. Browser evidence comes from the last `browser smoke` run and remains a dated verification, not live state.
 
-### Precompile WebGPU shaders
+### Precompile renderer shaders
 
 ```bash
 npx three-blocks shaders status --check
@@ -134,6 +156,7 @@ Add `three-blocks.shaders.json` when the project needs multiple routes, a semant
 ```json
 {
   "schemaVersion": 1,
+  "backend": "both",
   "scenes": [
     { "key": "main", "url": "/" },
     { "key": "text", "url": "/text", "requiresText": true }
@@ -144,7 +167,7 @@ Add `three-blocks.shaders.json` when the project needs multiple routes, a semant
 
 Readiness is optional. Its global may be `true` or a promise; a selector is also supported. With no override, the engine waits for its settled-frame and first-frame contract and assumes nothing about the application DOM.
 
-Capture observes real render and compute `NodeBuilder` states, then writes a deterministic pooled v3 manifest. The generated application owns no capture harness, and the tooling never writes to `node_modules`. Missing keys, stale receipts, unsupported Three.js versions, and hydration mismatches fail closed to live shader building.
+Capture observes real render and compute `NodeBuilder` states, then writes a deterministic pooled v3 manifest. WebGL receipts include render states and explicit live-fallback reasons for unsupported compute or PBO storage reads. The generated application owns no capture harness, and the tooling never writes to `node_modules`. Missing keys, stale receipts, unsupported Three.js versions, unavailable GLSL extensions, and hydration mismatches fail closed to live shader building.
 
 Artifact writes are transactional. `meta.json` records runtime, tool, schema, source-input, byte, and stage-coverage evidence. Relevant source changes during capture abort the write, and failures preserve the prior committed receipt. Explicit stable keys remain the clearest choice for conditional capture matrices; otherwise, capture assigns deterministic scene-scoped keys. Set `allowLiveBuilds: false` when every build must belong to the declared matrix.
 

package/dist/browser/shader-capture.d.ts

@@ -5,9 +5,19 @@ interface ShaderCaptureReadiness {
 interface ShaderCaptureRuntimeConfiguration {
     readonly capture: boolean;
     readonly forceLive: boolean;
+    /** Renderer backend owned by this capture lane. Omitted for ambient overlay instrumentation. */
+    readonly backend?: 'webgpu' | 'webgl';
+    /** Instrument a browser-driver observation without writing a capture or forcing live misses. */
+    readonly driven?: boolean;
     readonly settleFrames: number;
     /** Maximum visible settle time after readiness before capture posts, regardless of late builds. */
     readonly settleTimeoutMs?: number;
+    /**
+     * Absolute epoch deadline at which a driven capture must begin its manifest
+     * write, reserving driver time for payload validation, the transactional
+     * write, and timeout diagnostics before the outer lane budget expires.
+     */
+    readonly deadlineAt?: number;
     /** Pause the settle countdown while an interactive capture tab is hidden. */
     readonly visibilityGuard?: boolean;
     /** Overlay-capture session identity. Omitted by the driven browser capture. */
@@ -40,6 +50,8 @@ declare function instrumentThreeBlocksShaderBuilder(builderValue: unknown, rende
 declare function recordThreeBlocksShaderBuild(builderValue: unknown, rendererValue: unknown): void;
 /** Called at the top of r185 getForRender/getForCompute before provider lookup. */
 declare function prepareThreeBlocksShaderRenderer(rendererValue: unknown, namespaceValue?: unknown, revisionValue?: unknown): void;
+/** Synchronous view of this lane's demand journal for driver diagnostics. */
+declare function readThreeBlocksShaderDemands(): readonly UnknownRecord[];
 declare function pageLoadingIsComplete(root: UnknownRecord, readiness?: ShaderCaptureReadiness): boolean;
 
-export { activeShaderCaptureScene, capturedBindingKind, configureThreeBlocksShaderCapture, instrumentThreeBlocksShaderBuilder, pageLoadingIsComplete, prepareThreeBlocksShaderRenderer, recordThreeBlocksShaderBuild, wrapThreeBlocksCaptureTimedBuild };
+export { activeShaderCaptureScene, capturedBindingKind, configureThreeBlocksShaderCapture, instrumentThreeBlocksShaderBuilder, pageLoadingIsComplete, prepareThreeBlocksShaderRenderer, readThreeBlocksShaderDemands, recordThreeBlocksShaderBuild, wrapThreeBlocksCaptureTimedBuild };