@three-blocks/devtools 1.0.1-alpha.229.gb2f4ea7d182c → 2.0.0-alpha.238.g8723f0a28ca3

package/CHANGELOG.md

@@ -1,9 +1,37 @@
 # @three-blocks/devtools
 
-## 1.0.1-alpha.229.gb2f4ea7d182c
+## 2.0.0-alpha.238.g8723f0a28ca3
+
+- Website: Admin now shows quick growth, traffic, CLI, tools, and Blender activity.
 
 - Website: Pro now highlights lifetime licensing and tools at $79/month annually or $99 monthly.
 
+- Tools: Mesh to Splat now honors scene-camera scale and completes engine checks after reloads.
+
+- Tools: Mesh to Splat no longer crashes when Windows blocks an engine cache.
+
+- CLI: Splat engine setup now appears only when a Mesh to Splat tool needs it.
+
+- CLI: Deployment watch now stays open and names uploaded tool and Blender add-on versions.
+
+- Devtools: Shader capture now respects each scene's supported renderer backends.
+
+- Devtools: Shader precompilation now isolates backends and replays shared texture recipes.
+
+- Packages: Shader tools now capture both backends by default and show backend tests and sizes.
+
+- Library: Baked Motion now loads each ActiveFrame track once and drops KTX2 pose fields.
+
+- Devtools: Precompiled indirect batches now skip redundant shader setup.
+
+- CLI: Blender subject pickers now browse collapsed collections with fuzzy graph search.
+
+- Starter: Fresh projects now avoid unstyled flashes and hydrate every captured startup shader.
+
+- Website: Deployments now keep cached example chunks available across releases.
+
+- Website: Static assets now deploy reliably without changing their public URLs.
+
 - CLI: Deployment status now reports Amplify through GitHub without an AWS login.
 
 - Devtools: Pushes now return preprod failures to the active Agent and avoid oversized bundles.
@@ -24,7 +52,7 @@
 
 - Website: Preprod billing now explains its read-only state instead of showing broken actions.
 
-- Packages: Built from `b2f4ea7d182c`.
+- Packages: Built from `8723f0a28ca3`.
 
 
 ## 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 };