@three-blocks/devtools 1.0.0-alpha.194.g5e3cc4492aa3 → 1.0.1-alpha.214.gf051bb7d43f2

package/dist/chunk-TGOUAHMD.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import {b,c}from'./chunk-NE7SC2BX.js';import {a as a$3}from'./chunk-ZT6T2W4B.js';import {a as a$2,c as c$2}from'./chunk-ZDNZCQUQ.js';import {a as a$1,c as c$1,d,f,e,i,j,k}from'./chunk-5L2VS3BN.js';import {a}from'./chunk-HOZDD6PW.js';import _ from'process';import {createServer}from'http';import {createRequire}from'module';import {mkdtemp,rm,lstat,readFile,unlink,mkdir,readdir,realpath}from'fs/promises';import g from'path';import {tmpdir}from'os';import {pathToFileURL}from'url';import {THREE_WEBGPU_R185_COMPATIBILITY,THREE_R186DEV_VERSION,THREE_WEBGPU_R186DEV_COMPATIBILITY,parsePrecompiledManifest,SHADER_HYDRATION_SCHEMA_VERSION,SHADER_RECIPE_SCHEMA_VERSION,SHADER_ADDRESS_SCHEMA_VERSION,PRECOMPILED_MANIFEST_VERSION}from'three-blocks/shaders';import {transformThreeWebgpuProviderHooks,transformThreeWebgpuCaptureInstrumentation}from'three-blocks/vite';function v(r){if(/^0\.185\./u.test(r))return THREE_WEBGPU_R185_COMPATIBILITY;if(r===THREE_R186DEV_VERSION)return THREE_WEBGPU_R186DEV_COMPATIBILITY;throw new Error(`Three.js ${r} is outside the supported shader compatibility contracts.`)}a(v,"shaderCompatibilityForThree");var I=53,Ae="timing.local.json",je="timing.json",de="parity.json",Q=4096,lr=4096;function se(r,e,t=8192){if(typeof r!="string"||r.length===0||r.length>t||/[\u0000\u007f]/u.test(r))throw new Error(`${e} must be a bounded non-empty string.`);return r}a(se,"boundedString");function S(r,e,t=true){if(typeof r!="number"||!Number.isFinite(r)||r<0||t&&!Number.isSafeInteger(r))throw new Error(`${e} must be a non-negative ${t?"integer":"finite number"}.`);return r}a(S,"nonNegativeNumber");function mr(r){if(!a$2(r))throw new Error("Shader capture stats are missing.");let e={buildCalls:S(r.buildCalls,"capture stats.buildCalls"),renderBuilds:S(r.renderBuilds,"capture stats.renderBuilds"),computeBuilds:S(r.computeBuilds,"capture stats.computeBuilds"),registeredBuilds:S(r.registeredBuilds,"capture stats.registeredBuilds"),registeredRenderBuilds:S(r.registeredRenderBuilds,"capture stats.registeredRenderBuilds"),registeredComputeBuilds:S(r.registeredComputeBuilds,"capture stats.registeredComputeBuilds"),buildMs:S(r.buildMs,"capture stats.buildMs",false),syncBuildMs:S(r.syncBuildMs,"capture stats.syncBuildMs",false),asyncBuildElapsedMs:S(r.asyncBuildElapsedMs,"capture stats.asyncBuildElapsedMs",false),precompiledSetupMs:S(r.precompiledSetupMs,"capture stats.precompiledSetupMs",false),maxSyncBuildMs:S(r.maxSyncBuildMs??r.syncBuildMs,"capture stats.maxSyncBuildMs",false),maxPrecompiledSetupMs:S(r.maxPrecompiledSetupMs??r.precompiledSetupMs,"capture stats.maxPrecompiledSetupMs",false),hydrationMs:S(r.hydrationMs??0,"capture stats.hydrationMs",false),maxHydrationMs:S(r.maxHydrationMs??r.hydrationMs??0,"capture stats.maxHydrationMs",false),injected:S(r.injected,"capture stats.injected"),injectedRender:S(r.injectedRender,"capture stats.injectedRender"),injectedCompute:S(r.injectedCompute,"capture stats.injectedCompute"),missed:S(r.missed,"capture stats.missed"),missedRender:S(r.missedRender,"capture stats.missedRender"),missedCompute:S(r.missedCompute,"capture stats.missedCompute"),...Array.isArray(r.missedKeys)&&r.missedKeys.every(t=>typeof t=="string")?{missedKeys:r.missedKeys.slice(0,Q)}:{}};if(e.renderBuilds+e.computeBuilds!==e.buildCalls||e.registeredRenderBuilds+e.registeredComputeBuilds!==e.registeredBuilds||e.injectedRender+e.injectedCompute!==e.injected||e.missedRender+e.missedCompute!==e.missed||e.registeredBuilds>e.buildCalls||Math.abs(e.syncBuildMs+e.asyncBuildElapsedMs-e.buildMs)>.001||e.maxSyncBuildMs>e.syncBuildMs+.001||e.maxPrecompiledSetupMs>e.precompiledSetupMs+.001||e.maxHydrationMs>e.hydrationMs+.001)throw new Error("Shader capture stats totals are inconsistent.");return e}a(mr,"captureStats");function pr(r){if(!Array.isArray(r)||r.length>Q)throw new Error("Shader capture skipped builds are invalid.");return r.map((e,t)=>{if(!a$2(e)||e.kind!=="render"&&e.kind!=="compute")throw new Error(`Shader capture skipped build ${t} is invalid.`);return {kind:e.kind,name:se(e.name,`skipped build ${t} name`,512),reason:se(e.reason,`skipped build ${t} reason`)}})}a(pr,"skippedBuilds");function hr(r){let e=0,t=0,n=0,s=0;for(let i of Object.values(r.entries)){let a=r.states[i];a!==void 0&&((a.vertex!==null||a.fragment!==null)&&e++,a.vertex!==null&&t++,a.fragment!==null&&n++,a.compute!==null&&s++);}return {render:e,vertex:t,fragment:n,compute:s}}a(hr,"shaderCoverage");function it(r,e){if(!a$2(r))throw new Error("Shader capture payload must be an object.");if(r.scene!==e.scene)throw new Error(`Shader capture scene does not match "${e.scene}".`);if(r.protocolVersion!==2)throw new Error("Shader capture protocolVersion must be 2.");let t=v(e.runtime.three);if(r.compatibility!==t)throw new Error(`Shader capture compatibility must be "${t}".`);if(!a$2(r.entries))throw new Error("Shader capture entries must be an object.");if(typeof r.requiresSetup!="boolean")throw new Error("Shader capture requiresSetup must be boolean.");let n=Object.keys(r.entries).length;if(n===0||n>Q)throw new Error(`Shader capture must contain 1...${Q} entries.`);if(!Array.isArray(r.errors)||r.errors.length>lr)throw new Error("Shader capture errors are invalid.");let s=r.errors.map((m,d)=>se(m,`capture error ${d}`,64*1024));if(s.length>0)throw new Error(`Shader capture failed:
+ - ${s.join(`
+ - `)}`);let i=pr(r.skipped),a=mr(r.stats),o=a$2(r.timing)?r.timing:void 0,l=o===void 0?void 0:Object.fromEntries(["launch","firstRequest","readiness","lastBuild","settled","posted"].flatMap(m=>{let d=o[m];if(d===void 0)return [];if(typeof d!="number"||!Number.isFinite(d)||d<0)throw new Error(`Shader capture timing.${m} is invalid.`);return [[m,d]]})),h;if(r.provenance!==void 0){if(!a$2(r.provenance)||typeof r.provenance.userAgent!="string"||r.provenance.userAgent.length>1024||typeof r.provenance.adapter!="string"||r.provenance.adapter.length>1024||!Array.isArray(r.provenance.features)||r.provenance.features.length>256||!r.provenance.features.every(m=>typeof m=="string"&&m.length<=128))throw new Error("Shader capture provenance is invalid.");h={userAgent:r.provenance.userAgent,adapter:r.provenance.adapter,features:[...new Set(r.provenance.features)].sort()};}let p=parsePrecompiledManifest({version:PRECOMPILED_MANIFEST_VERSION,scene:e.scene,three:e.runtime.three,threeBlocks:e.runtime.threeBlocks,runtime:{id:t,address:SHADER_ADDRESS_SCHEMA_VERSION,recipe:SHADER_RECIPE_SCHEMA_VERSION,hydration:SHADER_HYDRATION_SCHEMA_VERSION},...r.automatic===void 0?{}:{automatic:r.automatic},requiresSetup:r.requiresSetup,modules:r.modules,nodes:r.nodes,layouts:r.layouts,attributePlans:r.attributePlans,updatePlans:r.updatePlans,requirementPlans:r.requirementPlans,states:r.states,entries:r.entries}),f=hr(p);if(a.registeredRenderBuilds<f.render||a.registeredComputeBuilds<f.compute)throw new Error("Shader capture did not live-build every distinct registered render/compute entry.");return {scene:e.scene,manifest:p,skipped:i,stats:a,coverage:f,...l===void 0?{}:{timing:l},...h===void 0?{}:{provenance:h}}}a(it,"validateShaderCapture");function C(r,e=0){let t="	".repeat(e),n="	".repeat(e+1);if(Array.isArray(r))return r.length===0?"[]":r.every(i=>i===null||["number","string","boolean"].includes(typeof i))?JSON.stringify(r):`[
+${r.map(i=>`${n}${C(i,e+1)}`).join(`,
+`)}
+${t}]`;if(r!==null&&typeof r=="object"){let i=r,a=Object.keys(i).sort();return a.length===0?"{}":`{
+${a.map(o=>{let l=i[o];return `${n}${JSON.stringify(o)}: ${C(l,e+1)}`}).join(`,
+`)}
+${t}}`}let s=JSON.stringify(r);if(s===void 0)throw new Error("Shader artifact contains a non-serializable value.");return s}a(C,"stableStringify");function fr(r){return ["// GENERATED FILE \u2014 do not edit by hand.","// Produced by @three-blocks/devtools.","import type { PrecompiledManifest } from 'three-blocks/shaders';","",`export default ${C(r)} satisfies PrecompiledManifest;`,""].join(`
+`)}a(fr,"serializeShaderManifest");function ve(r,e){if(typeof r!="string"||r.length===0||r.length>256||/[\u0000-\u001f\u007f]/u.test(r))throw new Error(`${e} is invalid.`);return r}a(ve,"timingLabel");function ae(r){if(!a$2(r)||r.schemaVersion!==3||r.source!=="latest-local-capture"&&r.source!=="committed-capture"||typeof r.receiptHash!="string"||!/^[a-f0-9]{64}$/u.test(r.receiptHash)||typeof r.measuredAt!="string"||!Number.isFinite(Date.parse(r.measuredAt))||!a$2(r.scenes))throw new Error("Shader timing is invalid.");let e={};for(let[n,s]of Object.entries(r.scenes)){if(n.length===0||n.length>128||!a$2(s))throw new Error("Shader timing scene is invalid.");let i={builds:S(s.builds,`timing ${n}.builds`),setupMeasured:s.setupMeasured===true,liveBuildMs:S(s.liveBuildMs,`timing ${n}.liveBuildMs`,false),precompiledBuildMs:S(s.precompiledBuildMs,`timing ${n}.precompiledBuildMs`,false),avoidedBuildMs:S(s.avoidedBuildMs,`timing ${n}.avoidedBuildMs`,false),runs:S(s.runs,`timing ${n}.runs`),spreadMs:S(s.spreadMs,`timing ${n}.spreadMs`,false)};if(i.runs<1)throw new Error(`Shader timing runs are invalid for scene "${n}".`);if(Math.abs(i.avoidedBuildMs-Math.max(0,i.liveBuildMs-i.precompiledBuildMs))>.001)throw new Error(`Shader timing delta is inconsistent for scene "${n}".`);e[n]=i;}if(Object.keys(e).length===0)throw new Error("Shader timing contains no scenes.");let t={schemaVersion:3,receiptHash:r.receiptHash,measuredAt:r.measuredAt,scenes:e};return r.source==="latest-local-capture"?{...t,source:"latest-local-capture"}:{...t,source:"committed-capture",adapter:ve(r.adapter,"Shader timing adapter"),platform:ve(r.platform,"Shader timing platform")}}a(ae,"parseShaderTiming");function X(r){return /^[a-z0-9][a-z0-9_-]{0,63}$/u.test(r)}a(X,"validParityScene");function Pe(r){return typeof r=="string"&&Number.isFinite(Date.parse(r))}a(Pe,"validParityTimestamp");function ce(r){if(!a$2(r))throw new Error("Shader parity evidence is invalid.");if(r.schemaVersion===1){if(typeof r.receiptHash!="string"||!/^[a-f0-9]{64}$/u.test(r.receiptHash)||!Pe(r.verifiedAt)||!Array.isArray(r.scenes)||r.scenes.length===0||r.scenes.length>64||!r.scenes.every(n=>typeof n=="string"&&X(n)))throw new Error("Shader parity evidence is invalid.");return {schemaVersion:1,receiptHash:r.receiptHash,verifiedAt:r.verifiedAt,scenes:[...new Set(r.scenes)].sort()}}if(r.schemaVersion!==2||!a$2(r.scenes))throw new Error("Shader parity evidence is invalid.");let e=Object.entries(r.scenes);if(e.length===0||e.length>64)throw new Error("Shader parity evidence is invalid.");let t={};for(let[n,s]of e.sort(([i],[a])=>i.localeCompare(a))){if(!X(n)||!a$2(s)||typeof s.fingerprint!="string"||!/^[a-f0-9]{64}$/u.test(s.fingerprint)||!Pe(s.verifiedAt))throw new Error("Shader parity evidence is invalid.");t[n]={fingerprint:s.fingerprint,verifiedAt:s.verifiedAt};}return {schemaVersion:2,scenes:t}}a(ce,"parseShaderParityEvidence");function oe(r,e){let t=r.scenes[e];if(t===void 0)throw new Error(`Shader receipt has no scene "${e}" for parity evidence.`);return c$1(C({runtime:{three:r.runtime.three,threeBlocks:r.runtime.threeBlocks,threeBlocksShaderClosure:r.runtime.threeBlocksShaderClosure},...r.tool===void 0?{}:{tool:r.tool},scene:t}))}a(oe,"shaderSceneParityFingerprint");async function ke(r,e,t,n){let s=g.join(r,t);try{if(!await d(s))return;let i=await lstat(s);if(i.isSymbolicLink()||!i.isFile()||i.size>1024*1024)return;let a=ae(JSON.parse(await readFile(s,"utf8")));return a.source===n&&a.receiptHash===c$1(e)?a:void 0}catch{return}}a(ke,"readShaderTimingFile");async function st(r,e){return await ke(r,e,Ae,"latest-local-capture")??await ke(r,e,je,"committed-capture")}a(st,"readShaderTiming");async function Oe(r,e){let t=g.join(r,de);try{if(!await d(t))return;let n=await lstat(t);if(n.isSymbolicLink()||!n.isFile()||n.size>1024*1024)return;let s=ce(JSON.parse(await readFile(t,"utf8"))),i=c$2(JSON.parse(Buffer.from(e).toString("utf8"))),a={};if(s.schemaVersion===1){if(s.receiptHash!==c$1(e))return;for(let o of s.scenes)i.scenes[o]!==void 0&&(a[o]={fingerprint:oe(i,o),verifiedAt:s.verifiedAt});}else for(let[o,l]of Object.entries(s.scenes))i.scenes[o]===void 0||l.fingerprint!==oe(i,o)||(a[o]=l);return Object.keys(a).length===0?void 0:{schemaVersion:2,scenes:a}}catch{return}}a(Oe,"readShaderParityEvidence");async function Ie(r,e,t){let n=await Z(r),s=g.join(n,"meta.json"),i=await lstat(s);if(i.isSymbolicLink()||!i.isFile())throw new Error("Shader receipt must be a regular file before timing.");let a=await readFile(s),o=new Date().toISOString(),l=Object.fromEntries(Object.entries(e).sort(([f],[m])=>f.localeCompare(m))),h=ae({schemaVersion:3,receiptHash:c$1(a),measuredAt:o,source:"latest-local-capture",scenes:l});if(await f(g.join(n,Ae),`${C(h)}
+`),t===void 0)return {local:h};let p=ae({schemaVersion:3,receiptHash:c$1(a),measuredAt:o,source:"committed-capture",adapter:t.adapter,platform:t.platform,scenes:l});return await f(g.join(n,je),`${C(p)}
+`),{local:h,committed:p}}a(Ie,"writeShaderTimings");async function at(r,e){return (await Ie(r,e)).local}a(at,"writeShaderLocalTiming");async function ot(r,e,t){if(e.length===0||e.length>64||e.some(m=>!X(m)))throw new Error("Shader parity evidence must contain 1...64 valid scene keys.");let n=await Z(r),s=g.join(n,"meta.json"),i=await lstat(s);if(i.isSymbolicLink()||!i.isFile())throw new Error("Shader receipt must be a regular file before parity evidence.");let a=await readFile(s);if(t!==void 0&&c$1(a)!==c$1(t))throw new Error("Shader receipt changed during browser parity verification; completed observations were not attached to the new receipt.");let o=c$2(JSON.parse(a.toString("utf8"))),l=await Oe(n,a),h=new Date().toISOString(),p={...l?.scenes};for(let m of [...new Set(e)].sort())p[m]={fingerprint:oe(o,m),verifiedAt:h};let f$1=ce({schemaVersion:2,scenes:p});return await f(g.join(n,de),`${C(f$1)}
+`),f$1}a(ot,"writeShaderParityEvidence");async function dt(r,e,t){if(e.length===0||e.length>64||e.some(p=>!X(p)))throw new Error("Shader parity invalidation must contain 1...64 valid scene keys.");let n=await Z(r),s=await readFile(g.join(n,"meta.json"));if(c$1(s)!==c$1(t))throw new Error("Shader receipt changed before prior parity evidence could be invalidated.");let i=await Oe(n,s);if(i===void 0)return;let a=new Set(e),o=Object.fromEntries(Object.entries(i.scenes).filter(([p])=>!a.has(p))),l=g.join(n,de);if(Object.keys(o).length===0){await unlink(l).catch(p=>{if(!a$2(p)||p.code!=="ENOENT")throw p});return}let h=ce({schemaVersion:2,scenes:o});await f(l,`${C(h)}
+`);}a(dt,"removeShaderParityEvidence");async function ct(r,e,t){let n=await Ie(r,e,t);if(n.committed===void 0)throw new Error("Committed shader timing was not written.");return {local:n.local,committed:n.committed}}a(ct,"writeShaderTimingTwins");async function Ce(r){if(!await d(r)){await mkdir(r);return}let e=await lstat(r);if(e.isSymbolicLink()||!e.isDirectory())throw new Error(`Shader artifact path is not a real directory: ${r}.`)}a(Ce,"assertDirectory");async function Z(r){let e=g.resolve(r),t=g.join(e,".three-blocks");await Ce(t);let n=g.join(t,"shaders");return await Ce(n),n}a(Z,"artifactRoot");async function ut(r){let e$1=await Z(r.root),t=v(r.runtime.three),n=g.resolve(r.root),s=g.resolve(n,r.publicDirectory??"public");if(!e(n,s)||s===n)throw new Error("Shader public directory must stay inside the project root.");let i$1=g.join(s,"three-blocks","shaders");await mkdir(i$1,{recursive:true}),await i(n,i$1,"Shader static-asset directory");let a={},o=[];for(let d of [...r.scenes].sort((u,y)=>u.key.localeCompare(y.key))){let u=r.captures.get(d.key),y=r.inputs.get(d.key);if(y===void 0)throw new Error(`Shader input matrix is missing scene "${d.key}".`);if(u===void 0){let R=r.previousReceipt?.scenes[d.key];if(R===void 0)throw new Error(`Capture matrix is missing scene "${d.key}".`);let N=await readFile(g.join(e$1,R.artifact));if(c$1(N)!==R.artifactHash)throw new Error(`Preserved shader artifact checksum differs for scene "${d.key}".`);if(R.asset!==void 0&&R.assetHash!==void 0){let H=await readFile(g.join(s,R.asset));if(c$1(H)!==R.assetHash)throw new Error(`Preserved static shader manifest checksum differs for scene "${d.key}".`)}a[d.key]={...R,inputs:Object.fromEntries(Object.entries(y).sort(([H],[z])=>H.localeCompare(z)))},o.push(R.artifact),R.asset!==void 0&&o.push(g.relative(n,g.join(s,R.asset)).split(g.sep).join("/"));continue}if(u.scene!==d.key||u.manifest.scene!==d.key)throw new Error(`Capture matrix scene "${d.key}" is inconsistent.`);let b=`${d.key}.webgpu.ts`,w=fr(u.manifest);await f(g.join(e$1,b),w),o.push(b);let P=`three-blocks/shaders/${d.key}.json`,B=`${C(u.manifest)}
+`;await f(g.join(s,P),B),o.push(g.relative(n,g.join(s,P)).split(g.sep).join("/"));let M=u.skipped.filter(R=>R.kind==="render").length,k=u.skipped.length-M;a[d.key]={artifact:b,artifactHash:c$1(w),asset:P,assetHash:c$1(B),inputs:Object.fromEntries(Object.entries(y).sort(([R],[N])=>R.localeCompare(N))),coverage:u.coverage,bytes:Buffer.byteLength(w),skipped:{render:M,compute:k}};}let l=[...r.captures.values()].find(d=>d.provenance!==void 0)?.provenance??r.previousReceipt?.runtime.capture,h={schemaVersion:2,runtime:{...r.runtime,...l===void 0?{}:{capture:l}},tool:{name:"@three-blocks/devtools",version:a$3,compatibility:t,transform:I,address:SHADER_ADDRESS_SCHEMA_VERSION,recipe:SHADER_RECIPE_SCHEMA_VERSION,hydration:SHADER_HYDRATION_SCHEMA_VERSION},scenes:a},p=new Set(o);for(let d of await readdir(e$1,{withFileTypes:true}))if(!(!d.name.endsWith(".webgpu.ts")||p.has(d.name))){if(d.isSymbolicLink()||!d.isFile())throw new Error(`Orphan shader artifact is not a regular file: ${d.name}.`);await unlink(g.join(e$1,d.name));}let f$1=new Set(r.scenes.map(d=>`${d.key}.json`)),m=new Set(Object.values(r.previousReceipt?.scenes??{}).map(d=>d.asset===void 0?void 0:g.posix.basename(d.asset)).filter(d=>d!==void 0));try{let d=c$2(JSON.parse(await readFile(g.join(e$1,"meta.json"),"utf8")));for(let u of Object.values(d.scenes))u.asset!==void 0&&m.add(g.posix.basename(u.asset));}catch{}for(let d of await readdir(i$1,{withFileTypes:true}))if(!(!d.name.endsWith(".json")||f$1.has(d.name))&&m.has(d.name)){if(d.isSymbolicLink()||!d.isFile())throw new Error(`Orphan shader static asset is not a regular file: ${d.name}.`);await unlink(g.join(i$1,d.name));}return await f(g.join(e$1,"meta.json"),`${C(h)}
+`),o.push("meta.json"),{directory:e$1,receipt:h,files:o}}a(ut,"writeShaderArtifacts");var Le="three-blocks.shader-capture.runtime.v1";var W;async function F(){W===void 0&&(W=(async()=>{let e=createRequire(g.join(process.cwd(),"package.json")).resolve("@three-blocks/devtools/browser/shader-capture"),t=g.resolve(g.dirname(e),"../..");return (await j(t,e,a$1.metadata,"Shader capture browser runtime")).data.toString("utf8")})());let r=W;try{return await r}catch(e){throw W===r&&(W=void 0),e}}a(F,"loadShaderCaptureRuntimeSource");var De="virtual:three-blocks-shader-capture-client",$e="\0three-blocks:shader-capture-client",le="virtual:three-blocks-shader-capture-runtime",Fe="\0three-blocks:shader-capture-runtime";async function He(){let r=await F(),e=r.replace(/\bexport\{[^{}]*\};?\s*$/u,"");if(e===r)throw new Error("Shader capture browser runtime no longer has the expected final ESM export list.");return e}a(He,"loadShaderCaptureRuntimeScriptSource");function br(r){let e=r.split("?",1)[0];return e===void 0?false:e.split(g.sep).join("/").endsWith("/build/three.webgpu.js")}a(br,"isThreeWebGPUModule");function Ue(r){let e=/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/u.exec(r);return e?.[1]==="0"&&e[2]==="185"}a(Ue,"supportedVersion");function Er(r,e,t={}){if(!Ue(e))throw new Error(`Shader provider transform ${THREE_WEBGPU_R185_COMPATIBILITY} supports Three.js 0.185.x; received "${e}".`);let n=transformThreeWebgpuProviderHooks(r,{threeVersion:e,...t.threeRevision===void 0?{}:{threeRevision:t.threeRevision},id:"three/build/three.webgpu.js"}),s=n.state==="already-applied",i=n.code;return t.instrumentCapture&&(i=transformThreeWebgpuCaptureInstrumentation(i,{...t.captureRuntimeImport===void 0?{}:{runtimeImport:t.captureRuntimeImport}}).code),{code:i,alreadyPresent:s,captureApplied:t.instrumentCapture===true}}a(Er,"applyShaderProviderTransform");var Rr=/this\.trackTimestamp\s*=\s*\(\s*parameters\.trackTimestamp\s*===\s*true\s*\);/gu,Tr="Object.defineProperty( this, 'trackTimestamp', { get: () => false, set: () => {} } );";function Ve(r,e={}){if(!Ue(r))throw new Error(`Shader provider transform ${THREE_WEBGPU_R185_COMPATIBILITY} supports Three.js 0.185.x; received "${r}".`);let t={seen:false,applied:false,alreadyPresent:false};return {plugin:{name:"three-blocks:shader-provider-transform",enforce:"pre",config(){return {optimizeDeps:{exclude:["three","three/webgpu","three/tsl"]},resolve:{dedupe:["three"]}}},resolveId(s){return e.capture&&s===De?$e:e.capture&&s===le?Fe:null},async load(s){return e.capture?s===Fe?F():s===$e?[`export * from '${le}';`,`import { configureThreeBlocksShaderCapture } from '${le}';`,`configureThreeBlocksShaderCapture( ${JSON.stringify({capture:e.capture.capture,forceLive:e.capture.forceLive,settleFrames:e.capture.settleFrames,settleTimeoutMs:e.capture.settleTimeoutMs,visibilityGuard:e.capture.visibilityGuard,captureId:e.capture.captureId,sessionKey:e.capture.sessionKey,token:e.capture.token,readiness:e.capture.readiness??{},transform:I})} );`].join(`
+`):null:null},transform(s,i){if(!br(i))return null;t.seen=true,t.id=i;try{let a=Er(s,r,{instrumentCapture:e.capture!==void 0,...e.capture!==void 0?{captureRuntimeImport:De}:{}}),o=e.disableTimestampQueries===!0?a.code.replace(Rr,Tr):a.code;if(e.disableTimestampQueries===!0&&o===a.code)throw new Error("Three.js timestamp tracking anchor drifted; refusing software WebGPU capture.");return t.applied=!0,t.alreadyPresent=a.alreadyPresent,t.captureApplied=a.captureApplied,o===s?null:{code:o,map:null}}catch(a){throw t.error=a instanceof Error?a.message:String(a),a}}},status:t}}a(Ve,"createShaderProviderTransform");function me(r){if(r.error)throw new Error(r.error);if(!r.seen||!r.applied)throw new Error(`The version-gated shader provider transform was not applied (${r.seen?"module seen":"three/webgpu not seen"}).`)}a(me,"assertShaderProviderTransform");var Qe="/__three-blocks/shaders/capture",te="/__three-blocks/shaders/telemetry",Xe="/__three-blocks/shaders/runtime.js",Ze="/__three-blocks/shaders/bootstrap.js",er="/__three-blocks/shaders/bridge.js",rr=a$1.manifest*2,fe=/^[a-z0-9][a-z0-9_-]{0,63}$/u,tr=64,nr=2e3,xr=[/is not valid JSON/iu,/WebGPU is experimental/iu];async function Ar(){try{return (await import('playwright')).chromium}catch(r){throw new Error('Shader browser work requires the optional "playwright" package. Install it in the project and run `npx playwright install chromium`.',{cause:r})}}a(Ar,"loadChromium");async function jr(r){let e;try{e=createRequire(g.join(r,"package.json")).resolve("vite");}catch(n){throw new Error("Shader capture requires Vite in the target project.",{cause:n})}let t=await import(pathToFileURL(e).href);if(typeof t.createServer!="function")throw new Error(`The target project's Vite entry does not export createServer(): ${e}`);return t.createServer}a(jr,"loadProjectCreateServer");var ye=class{static{a(this,"CaptureInbox");}#e=new Map;#r=new Map;wait(e,t){let n=this.#r.get(e);if(n!==void 0)return this.#r.delete(e),Promise.resolve(n);if(this.#e.has(e))throw new Error(`A shader capture is already waiting for scene "${e}".`);return new Promise((s,i)=>{let a=setTimeout(()=>{this.#e.delete(e),i(new Error(`Shader capture "${e}" timed out after ${t}ms.`));},t);this.#e.set(e,{resolve:s,reject:i,timer:a});})}receive(e){if(!a$2(e)||typeof e.scene!="string"||!fe.test(e.scene))throw new Error("Capture POST has no safe scene key.");if(!this.#r.has(e.scene)&&!this.#e.has(e.scene)&&this.#r.size>=tr)throw new Error("Capture POST exceeds the scene inbox limit.");let t=this.#e.get(e.scene);t?(clearTimeout(t.timer),this.#e.delete(e.scene),t.resolve(e)):this.#r.set(e.scene,e);}cancel(e,t){let n=this.#e.get(e);n&&(clearTimeout(n.timer),this.#e.delete(e),n.reject(t));}rejectAll(e){for(let t of this.#e.values())clearTimeout(t.timer),t.reject(e);this.#e.clear(),this.#r.clear();}};async function Or(r,e){let t=await Promise.race([e.then(n=>({kind:"capture",value:n})),r.then(()=>({kind:"navigation"}))]);return t.kind==="capture"?t.value:e}a(Or,"waitForShaderCaptureAcrossNavigation");var ge=class{static{a(this,"TelemetryHub");}#e=new Map;#r=new Map;markFirstRequest(e){fe.test(e)&&!this.#r.has(e)&&this.#r.set(e,Date.now());}firstRequest(e){return this.#r.get(e)}receive(e){if(!a$2(e)||typeof e.scene!="string"||!fe.test(e.scene))throw new Error("Shader telemetry has no bounded scene key.");if(!this.#e.has(e.scene)&&this.#e.size>=tr)throw new Error("Shader telemetry exceeds the scene limit.");this.#e.set(e.scene,e);}read(e){return this.#e.get(e)}clear(e){this.#e.delete(e),this.#r.delete(e);}},Ir=a(async(r,e,t,n,s)=>{let i=0;for(;r.__threeBlocksParityUsesAnimationLoop!==true&&i<e;)await n(),i+=1;if(r.__threeBlocksParityUsesAnimationLoop===true){let a=Number(r.__threeBlocksParityCompletedFrame||0),o=Number(t),l=Number.isSafeInteger(o)&&o>=a?o:a+e;for(r.__threeBlocksParityTargetFrame=l;Number(r.__threeBlocksParityCompletedFrame||0)<l;)await n();}return await s(),Number(r.__threeBlocksParityCompletedFrame||0)},"settleShaderParityFrames");function Se(r){return `(() => {
+  const root = globalThis;
+  const scene = new URL(location.href).searchParams.get('captureId')
+    || 'default';
+  const randomSeed = (value) => {
+    let state = 2166136261;
+    for (let index = 0; index < value.length; index++) state = Math.imul(state ^ value.charCodeAt(index), 16777619) >>> 0;
+    return state === 0 ? 0x9e3779b9 : state;
+  };
+  const advanceRandom = (state) => {
+    state ^= state << 13;
+    state ^= state >>> 17;
+    state ^= state << 5;
+    return state >>> 0;
+  };
+  const parityMode = new URL(location.href).searchParams.get('threeBlocksShaderMode');
+  if (parityMode === 'live' || parityMode === 'precompiled') {
+    root.__threeBlocksParityEpoch = 1700000000000;
+    root.__threeBlocksParityTime = 0;
+    Date.now = () => root.__threeBlocksParityEpoch + Number(root.__threeBlocksParityTime || 0);
+  }
+  const randomStreams = new Map();
+  Math.random = () => {
+    const stackLine = String(new Error().stack || '').split('\\n')[2] || 'unknown';
+    const originIndex = stackLine.indexOf(location.origin);
+    const callsite = (originIndex >= 0 ? stackLine.slice(0, originIndex) : stackLine).trim() || 'anonymous';
+    const next = advanceRandom(randomStreams.get(callsite) ?? randomSeed(scene + '|' + callsite));
+    randomStreams.set(callsite, next);
+    return next / 4294967296;
+  };
+  const readiness = { workerReady: false, assetsReady: false, textReady: false, compileEnd: false, firstFrame: false };
+  const stats = { buildCalls: 0, renderBuilds: 0, computeBuilds: 0, registeredBuilds: 0, registeredRenderBuilds: 0, registeredComputeBuilds: 0, buildMs: 0, syncBuildMs: 0, asyncBuildElapsedMs: 0, precompiledSetupMs: 0, maxSyncBuildMs: 0, maxPrecompiledSetupMs: 0, hydrationMs: 0, maxHydrationMs: 0, injected: 0, injectedRender: 0, injectedCompute: 0, missed: 0, missedRender: 0, missedCompute: 0, missedKeys: [] };
+  const settleParityFrames = ${Ir.toString()};
+  const settle = (frames, requestedTarget) => settleParityFrames(
+    root,
+    frames,
+    requestedTarget,
+    () => new Promise((resolve) => requestAnimationFrame(resolve)),
+    () => new Promise((resolve) => setTimeout(resolve, 100)),
+  );
+  const bridge = { protocolVersion: 1, compatibility: ${JSON.stringify(r)}, transform: ${I}, readiness, stats, settle };
+  root.__threeBlocksShaderTools = bridge;
+  requestAnimationFrame(() => requestAnimationFrame(() => { readiness.firstFrame = true; }));
+  const poll = async () => {
+    try {
+      const response = await fetch('/__three-blocks/shaders/telemetry?scene=' + encodeURIComponent(scene), { cache: 'no-store' });
+      if (response.status !== 204 && response.ok) {
+        const payload = await response.json();
+        if (payload.protocolVersion !== 1 || payload.compatibility !== bridge.compatibility || payload.transform !== bridge.transform) throw new Error('incompatible shader telemetry');
+        Object.assign(stats, payload.stats);
+        readiness.workerReady = true;
+        if (payload.settled === true) {
+          readiness.assetsReady = true;
+          readiness.textReady = true;
+          readiness.compileEnd = true;
+        }
+        const smoke = root.__threeBlocksSmoke && typeof root.__threeBlocksSmoke === 'object' ? root.__threeBlocksSmoke : { protocolVersion: 1, worker: { offscreenCanvas: true, visible: true }, readiness: {} };
+        smoke.readiness = { ...(smoke.readiness || {}), ...readiness };
+        root.__threeBlocksSmoke = smoke;
+      }
+    } catch {}
+    setTimeout(poll, 40);
+  };
+  void poll();
+})();`}a(Se,"publicBridgeScript");function ir(r,e,t,n,s=false){let i=new URL(r.url??"/","http://three-blocks.invalid"),a=i.pathname;if(s&&r.method==="GET"&&/^\/three-blocks\/shaders\/[a-z0-9][a-z0-9_-]{0,63}\.json$/u.test(a))return e.statusCode=204,e.end(),true;if(a===te&&r.method==="GET"){let m=i.searchParams.get("scene")??"",d=n.read(m);return d===void 0?(e.statusCode=204,e.end()):(e.statusCode=200,e.setHeader("Content-Type","application/json"),e.end(JSON.stringify(d))),true}let o=a===Qe,l=a===te;if(!o&&!l)return  false;if(r.method!=="POST")return e.statusCode=405,e.end("POST required"),true;let h=[],p=0,f=false;return r.on("data",m=>{p+=m.byteLength,p>rr?f=true:h.push(m);}),r.on("end",()=>{if(f){e.statusCode=413,e.end("capture payload too large");return}try{let m=JSON.parse(Buffer.concat(h).toString("utf8"));l?n.receive(m):t.receive(m),e.statusCode=204,e.end();}catch(m){e.statusCode=400,e.end(m instanceof Error?m.message:String(m));}}),true}a(ir,"handleCaptureEndpoint");function Lr(r,e,t,n){return {name:"three-blocks:shader-capture-endpoint",transformIndexHtml(){return [{tag:"script",children:Se(n),injectTo:"head-prepend"}]},configureServer(s){s.middlewares.use((i,a,o)=>{let h=new URL(i.url??"/","http://three-blocks.invalid").searchParams.get("captureId");h!==null&&e.markFirstRequest(h),!ir(i,a,r,e,t)&&o();});}}}a(Lr,"captureEndpointPlugin");function We(r,e,t){let n=new URL(e.url,r);for(let[s,i]of Object.entries(t))n.searchParams.set(s,i);return n.href}a(We,"browserUrl");function Dr(r,e){let t=new URL(e.url,r);for(let n of ["capture","precompiled"])t.searchParams.delete(n);return t.searchParams.set("captureId",e.key),t.searchParams.set("threeBlocksShaderMode","precompiled"),t.searchParams.set("tbStats","1"),t.href}a(Dr,"publishedBrowserUrl");function qe(r){return xr.some(e=>e.test(r))}a(qe,"knownNoise");async function L(r){let e;try{await Promise.race([r(),new Promise(t=>{e=setTimeout(t,nr);})]);}catch{}finally{e&&clearTimeout(e);}}a(L,"closeBrowserResource");async function Ke(r){let e;try{return await Promise.race([r().catch(()=>null),new Promise(t=>{e=setTimeout(()=>t(null),nr);})])}finally{e!==void 0&&clearTimeout(e);}}a(Ke,"readPageDiagnostic");function pe(r){let e=a(()=>{},"resolveFirst"),t=new Promise(a=>{e=a;}),n={console:[],page:[],first:t},s=false,i=a(a=>{s||(s=true,e(new Error(a)));},"report");return r.on("console",a=>{let o=a.type()==="warning"&&/\[three-blocks\/shaders\].*(?:has no entry|manifest miss|hydration)/iu.test(a.text());if(a.type()!=="error"&&!o||qe(a.text()))return;let l=a.location().url,h=l.length>0?`${a.text()} (${l})`:a.text();n.console.push(h),i(`Browser console ${o?"warning":"error"}: ${h}`);}),r.on("pageerror",a=>{if(qe(a.message))return;let o=a.stack||a.message;n.page.push(o),i(`Browser page error: ${o}`);}),r.on("crash",()=>i("Browser page crashed before shader capture completed.")),r.on("close",()=>i("Browser page closed before shader capture completed.")),n}a(pe,"collectErrors");function q(r,e,t=false){return typeof r[e]=="boolean"?r[e]:t}a(q,"booleanField");function $r(r){if(!a$2(r))throw new Error("Browser shader stats are unavailable.");let e=a((t,n=true)=>{let s=r[t];if(typeof s!="number"||!Number.isFinite(s)||s<0||n&&!Number.isSafeInteger(s))throw new Error(`Browser shader stats.${t} is invalid.`);return s},"read");return {buildCalls:e("buildCalls"),renderBuilds:e("renderBuilds"),computeBuilds:e("computeBuilds"),registeredBuilds:e("registeredBuilds"),registeredRenderBuilds:e("registeredRenderBuilds"),registeredComputeBuilds:e("registeredComputeBuilds"),buildMs:e("buildMs",false),syncBuildMs:e("syncBuildMs",false),asyncBuildElapsedMs:e("asyncBuildElapsedMs",false),precompiledSetupMs:e("precompiledSetupMs",false),maxSyncBuildMs:e("maxSyncBuildMs",false),maxPrecompiledSetupMs:e("maxPrecompiledSetupMs",false),hydrationMs:e("hydrationMs",false),maxHydrationMs:e("maxHydrationMs",false),injected:e("injected"),injectedRender:e("injectedRender"),injectedCompute:e("injectedCompute"),missed:e("missed"),missedRender:e("missedRender"),missedCompute:e("missedCompute"),...Array.isArray(r.missedKeys)&&r.missedKeys.every(t=>typeof t=="string")?{missedKeys:r.missedKeys}:{}}}a($r,"parseStats");function ee(r,e,t,n,s){if(!a$2(r))throw new Error("The page did not expose the public shader devtools bridge.");if(!t&&r.protocolVersion!==1)throw new Error(`Scene "${e.key}" exposed an unsupported shader bridge protocol.`);let i=r.readiness;if(!a$2(i))throw new Error("The shader bridge readiness snapshot is invalid.");let a={workerReady:q(i,"workerReady"),assetsReady:q(i,"assetsReady"),textReady:e.requiresText?q(i,"textReady"):true,compileEnd:q(i,"compileEnd"),firstFrame:q(i,"firstFrame",t)};if(!a.workerReady||!a.assetsReady||!a.textReady||!a.compileEnd)throw new Error(`Scene "${e.key}" did not reach worker/assets/text/compile readiness.`);let o=t?s:r.compatibility,l=t?I:r.transform;if(o!==s||l!==I)throw new Error(`Scene "${e.key}" exposed incompatible shader bridge metadata.`);return me(n),{compatibility:s,transform:l,readiness:a,stats:$r(r.stats)}}a(ee,"parseBridge");async function re(r,e){return r.evaluate(t=>{let n=globalThis;if(!t)return n.__threeBlocksShaderTools??null;let s=n.__threeBlocks,i=n.__threeBlocksTslStats;if(!s||typeof s!="object")return null;let a=s;return {readiness:{workerReady:a.workerReady===true,assetsReady:a.loadEnd===true||a.assetsReady===true,textReady:a.textReady===true,compileEnd:a.compileEnd===true,firstFrame:true},stats:i}},e)}a(re,"readBridge");async function K(r,e,t,n){let s=r.evaluate(async a$1=>{let l=globalThis.__threeBlocksShaderTools;if(l&&typeof l=="object"){let f=Reflect.get(l,"settle");if(typeof f=="function"){let m=await f(a$1.frames,a$1.targetFrame);return typeof m=="number"&&Number.isSafeInteger(m)?m:0}}if(!a$1.legacy||!a$1.modulePath)throw new Error("The public shader bridge does not provide deterministic settle().");let h=await import(a$1.modulePath);if(!h.store||typeof h.store!="object")throw new Error("Legacy deterministic store is unavailable.");let p=h.store;return p.recordFrameCount=0,p.recordFrameRate=60,p.recordTotalFrames=a$1.frames,p.recording=true,await new Promise((f,m)=>{let d=Date.now(),u=a(()=>{if(p.recording===false)return f();if(Date.now()-d>a$1.timeoutMs)return m(new Error("Legacy deterministic settle timed out."));setTimeout(u,25);},"poll");u();}),0},{frames:t,targetFrame:n,legacy:e.bridge.legacyLab,modulePath:e.bridge.deterministicModule??null,timeoutMs:e.timeoutMs}),i;try{return await Promise.race([s,new Promise((a,o)=>{i=setTimeout(()=>o(new Error(`Shader parity settle timed out after ${e.timeoutMs}ms.`)),e.timeoutMs);})])}finally{i!==void 0&&clearTimeout(i);}}a(K,"settlePage");async function Je(r,e,t){e.readiness.selector===void 0&&e.readiness.global===void 0||await Promise.race([r.waitForFunction(n=>{let s=globalThis;if(n.selector!==void 0&&s.document?.querySelector(n.selector)==null)return  false;if(n.global===void 0)return  true;let i=s;for(let l of n.global.split(".")){if((typeof i!="object"||i===null)&&typeof i!="function")return  false;i=Reflect.get(i,l);}if(i===true)return  true;if(typeof i!="object"||i===null||typeof Reflect.get(i,"then")!="function")return  false;let a=s.__threeBlocksReadinessState,o=a instanceof Map?a:new Map;return a instanceof Map||(s.__threeBlocksReadinessState=o),o.has(i)||(o.set(i,false),Promise.resolve(i).then(()=>o.set(i,true),()=>o.set(i,false))),o.get(i)===true},e.readiness,{timeout:e.timeoutMs}),t.first.then(n=>Promise.reject(n))]);}a(Je,"waitForConfiguredReadiness");async function ze(r){let e=r.locator("canvas"),n=(await e.evaluateAll(s=>s.map((i,a)=>{let o=i.getBoundingClientRect();return {index:a,area:Math.max(0,o.width)*Math.max(0,o.height)}}))).sort((s,i)=>i.area-s.area)[0];if(n===void 0||n.area<=0)throw new Error("Published page has no visible renderer canvas.");return Buffer.from(await e.nth(n.index).screenshot({type:"png"}))}a(ze,"primaryCanvasScreenshot");async function he(r,e,t,n,s,i){let a=sr(n,s),o=await He(),l=`(() => {
+  const runtime = globalThis[Symbol.for(${JSON.stringify(Le)})];
+  if (!runtime || typeof runtime.configureThreeBlocksShaderCapture !== 'function') {
+    throw new Error('@three-blocks/devtools attached shader capture runtime is incompatible.');
+  }
+  runtime.configureThreeBlocksShaderCapture(${JSON.stringify(a).replaceAll("<","\\u003c")});
+})();`;await r.addInitScript({content:`${o}
+${l}`}),await r.addInitScript({content:Se(i)}),await r.route("**/*",async h=>{let p=h.request(),f=new URL(p.url()),m=f.pathname;if(p.method()==="GET"&&n!=="precompiled"&&/^\/three-blocks\/shaders\/[a-z0-9][a-z0-9_-]{0,63}\.json$/u.test(m)){await h.fulfill({status:204});return}if(m===te&&p.method()==="GET"){let y=t.read(f.searchParams.get("scene")??"");await h.fulfill(y===void 0?{status:204}:{status:200,contentType:"application/json",body:JSON.stringify(y)});return}let d=m===Qe,u=m===te;if((d||u)&&p.method()==="POST"){let y=p.postDataBuffer()??Buffer.alloc(0);if(y.byteLength>rr){await h.fulfill({status:413,body:"capture payload too large"});return}try{let b=JSON.parse(y.toString("utf8"));u?t.receive(b):e.receive(b),await h.fulfill({status:204});}catch(b){await h.fulfill({status:400,body:b instanceof Error?b.message:String(b)});}return}await h.continue();});}a(he,"configureAttachedContext");var Fr=Object.freeze({".avif":"image/avif",".css":"text/css; charset=utf-8",".gif":"image/gif",".html":"text/html; charset=utf-8",".ico":"image/x-icon",".jpeg":"image/jpeg",".jpg":"image/jpeg",".js":"text/javascript; charset=utf-8",".json":"application/json; charset=utf-8",".mjs":"text/javascript; charset=utf-8",".mp4":"video/mp4",".png":"image/png",".svg":"image/svg+xml",".wasm":"application/wasm",".webm":"video/webm",".webp":"image/webp",".woff":"font/woff",".woff2":"font/woff2"});function Nr(r){let e=[`<script src="${er}"></script>`,`<script type="module" src="${Ze}"></script>`].join(""),t=/<head(?:\s[^>]*)?>/iu.exec(r);return t===null?`${e}${r}`:`${r.slice(0,t.index+t[0].length)}${e}${r.slice(t.index+t[0].length)}`}a(Nr,"injectStaticShaderCaptureHtml");function Hr(r,e){let t=sr(r,e);return [`import { configureThreeBlocksShaderCapture } from ${JSON.stringify(Xe)};`,`configureThreeBlocksShaderCapture( ${JSON.stringify(t).replaceAll("<","\\u003c")} );`].join(`
+`)}a(Hr,"staticCaptureBootstrap");function sr(r,e){return {capture:r==="capture",forceLive:r!=="precompiled",settleFrames:e.settleFrames,settleTimeoutMs:e.settleTimeoutMs??3e4,readiness:e.readiness,transform:I}}a(sr,"shaderCaptureConfiguration");async function Ur(r,e){let t=await k(r,e,a=>/\.(?:c|m)?js$/u.test(a),16384),n=false,s=false,i;for(let a of t){let o=(await j(r,a,a$1.texture,"Static application JavaScript")).data.toString("utf8");if(o.includes("nodeBuilderStateProvider")&&(n=true),o.includes("three-blocks.shader-capture.runtime.v1")&&(s=true,i??=a),n&&s)break}if(!n||!s)throw new Error("The static build does not contain the Three.js shader capture transform. Run `shaders capture` without an explicit driver or URL to preview adapter wiring and build automatically, or add the manual adapter from the package README and rebuild.");return {seen:true,applied:true,alreadyPresent:false,captureApplied:true,...i===void 0?{}:{id:i}}}a(Ur,"inspectStaticCaptureTransform");async function Vr(r,e$1){let t;try{t=decodeURIComponent(e$1);}catch{return}if(t.includes("\0"))return;let n=t.replace(/^\/+/u,""),s=g.resolve(r,n.length===0?"index.html":n);if(!e(r,s)||s===r||(await d(s)&&(await lstat(s)).isDirectory()&&(s=g.join(s,"index.html")),!await d(s)&&g.extname(s).length===0&&(s=g.join(r,"index.html")),!await d(s)))return;let i=await j(r,s,a$1.texture,"Static application asset");return {data:i.data,file:i.path}}a(Vr,"staticRequestFile");async function Gr(r,e$1,t,n,s){let i=await realpath(r.root),a=await realpath(g.resolve(i,r.serve));if(!e(i,a)||a===i)throw new Error("--serve must name a built application directory inside the project root.");let o=await Ur(i,a),l=await F(),h=Hr(e$1,t),p=Se(v(r.runtime.three)),f=createServer((d,u)=>{(async()=>{if(ir(d,u,n,s,e$1!=="precompiled"))return;let y=new URL(d.url??"/","http://three-blocks.invalid");if(d.method!=="GET"&&d.method!=="HEAD"){u.statusCode=405,u.end("GET or HEAD required");return}let b=y.pathname===Xe?l:y.pathname===Ze?h:y.pathname===er?p:void 0;if(b!==void 0){u.statusCode=200,u.setHeader("Content-Type","text/javascript; charset=utf-8"),u.setHeader("Cache-Control","no-store"),u.end(d.method==="HEAD"?void 0:b);return}let w=await Vr(a,y.pathname);if(w===void 0){u.statusCode=404,u.end("Not found");return}let P=g.extname(w.file).toLowerCase(),B=P===".html"?Buffer.from(Nr(w.data.toString("utf8"))):w.data;u.statusCode=200,u.setHeader("Content-Type",Fr[P]??"application/octet-stream"),u.setHeader("Content-Length",String(B.byteLength)),u.setHeader("Cache-Control","no-store"),u.end(d.method==="HEAD"?void 0:B);})().catch(y=>{if(u.headersSent)return u.destroy(y instanceof Error?y:void 0);u.statusCode=500,u.end(y instanceof Error?y.message:String(y));});});await new Promise((d,u)=>{f.once("error",u),f.listen(0,"127.0.0.1",()=>{f.off("error",u),d();});});let m=f.address();if(!m||typeof m=="string")throw new Error("Static capture server did not expose an ephemeral TCP address.");return {server:f,baseUrl:`http://127.0.0.1:${m.port}`,transform:o}}a(Gr,"startStaticShaderServer");function Wr(r,e,t){return r===e?true:t&&r!==void 0&&r!=="capture"&&e!=="capture"}a(Wr,"canReuseShaderBrowserSession");function Ye(r){let e=r instanceof Error?r.message:String(r);return e.includes("Execution context was destroyed")&&e.includes("navigation")||/^launch: Timeout \d+ms exceeded\./u.test(e)}a(Ye,"isRetryableShaderObservationNavigation");var J=class{static{a(this,"PlaywrightShaderDriver");}#e;#r=new ye;#n=new ge;#m;#p;#a;#o;#t;#i;#h;#c;#f;#u=0;#l;constructor(e){this.#e=e;}#d(){return this.#m?.status??this.#p??{seen:false,applied:false,alreadyPresent:false}}async#y(e){if(this.#t?.isConnected()===true)return;this.#t=void 0;let t=await Ar();this.#l??=await mkdtemp(g.join(tmpdir(),"three-blocks-shader-cache-")),this.#t=await t.launch({headless:c(this.#e.headed===true),args:[...b(),`--disk-cache-dir=${this.#l}`],timeout:e.timeoutMs}),this.#u=0;}async#s(e,t,n){let s;try{return await Promise.race([n(),new Promise((i,a)=>{s=setTimeout(()=>a(new Error(`launch: Timeout ${t.timeoutMs}ms exceeded.`)),t.timeoutMs);})])}catch(i){throw this.#t===e&&(this.#t=void 0),await L(()=>e.close()),i}finally{s!==void 0&&clearTimeout(s);}}async#g(e,t){let n=this.#a!==void 0||this.#o!==void 0||this.#e.url!==void 0&&this.#i!==void 0,s=this.#o!==void 0?this.#c===e:Wr(this.#c,e,t.bridge.legacyLab);if(n&&s){this.#c=e,await this.#y(t);return}if(n&&await this.close(),this.#c=e,this.#e.url!==void 0){let i=new URL(this.#e.url);if(!["http:","https:"].includes(i.protocol)||i.username||i.password||i.hash)throw new Error("Attached shader URL must be an HTTP(S) URL without credentials or a fragment.");this.#i=i.href,this.#p={seen:true,applied:true,alreadyPresent:false,captureApplied:true,id:"attached-application"},await this.#y(t);return}if(this.#e.serve!==void 0)try{let i=await Gr({root:this.#e.root,runtime:this.#e.runtime,serve:this.#e.serve,...this.#e.headed===void 0?{}:{headed:this.#e.headed}},e,t,this.#r,this.#n);this.#o=i.server,this.#p=i.transform,this.#i=i.baseUrl,await this.#y(t);return}catch(i){throw await this.close(),i}this.#m=Ve(this.#e.runtime.three,{disableTimestampQueries:_.env.THREE_BLOCKS_SOFTWARE_WEBGPU==="1",...t.bridge.legacyLab?{}:{capture:{capture:e==="capture",forceLive:e!=="precompiled",settleFrames:t.settleFrames,settleTimeoutMs:t.settleTimeoutMs??3e4,readiness:t.readiness}}}),this.#h={THREE_BLOCKS_SHADER_TOOL:_.env.THREE_BLOCKS_SHADER_TOOL,THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER:_.env.THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER},_.env.THREE_BLOCKS_SHADER_TOOL="1",_.env.THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER="1";try{let i=await jr(this.#e.root);this.#a=await i({root:this.#e.root,logLevel:"error",plugins:[this.#m.plugin,Lr(this.#r,this.#n,e!=="precompiled",v(this.#e.runtime.three))],server:{host:"127.0.0.1",port:0}}),await this.#a.listen();let a=this.#a.httpServer?.address();if(!a||typeof a=="string")throw new Error("Vite did not expose an ephemeral TCP address.");this.#i=`http://127.0.0.1:${a.port}`,await this.#y(t);}catch(i){throw await this.close(),i}}async capture(e,t){let n=Date.now();if(await this.#g("capture",t),!this.#t||!this.#i)throw new Error("Shader browser driver did not start.");let s=this.#t,i=await this.#s(s,t,()=>s.newContext({viewport:t.viewport}));this.#e.url!==void 0&&await this.#s(s,t,()=>he(i,this.#r,this.#n,"capture",t,v(this.#e.runtime.three)));let a$1=await this.#s(s,t,()=>i.newPage()),o=pe(a$1);this.#n.clear(e.key);let l=this.#r.wait(e.key,t.timeoutMs),h=Promise.race([l,o.first.then(d=>Promise.reject(d))]),p=a(()=>{},"resolveDisconnected"),f=new Promise(d=>{p=d;}),m=a(()=>p(new Error("Shader capture browser disconnected before posting a manifest.")),"onDisconnected");s.on("disconnected",m);try{let d=a$1.goto(We(this.#i,e,{threeBlocksShaderCapture:"1",capture:"1",captureId:e.key,captureFrames:String(Math.max(4,t.settleFrames)),settleFrames:String(t.settleFrames)}),{waitUntil:"domcontentloaded",timeout:t.timeoutMs}),u=await Or(d,Promise.race([h,f.then(b=>Promise.reject(b))]));me(this.#d());let y=[...o.page,...o.console];if(y.length>0)throw new Error(`Capture browser errors:
+ - ${y.join(`
+ - `)}`);return a$2(u)?{...u,timing:{...a$2(u.timing)?u.timing:{},launch:n,...this.#n.firstRequest(e.key)===void 0?{}:{firstRequest:this.#n.firstRequest(e.key)},posted:Date.now()}}:u}catch(d){let u=d instanceof Error?d:new Error(String(d));this.#r.cancel(e.key,u),await l.catch(()=>{});let y=this.#n.read(e.key);if(u.message.includes("timed out")){let b=await Ke(()=>a$1.evaluate(()=>{let w=globalThis,P=w.__threeBlocksShaderTools,B=P&&typeof P=="object"?P:void 0,M=w.document,k=Reflect.get(w,Symbol.for("three-blocks.shader-capture.cache-value.v1")),R=w.location,N=R!==null&&typeof R=="object"&&typeof Reflect.get(R,"href")=="string"?String(Reflect.get(R,"href")):"http://three-blocks.invalid/",H=new URL(N).searchParams.get("captureId")??"default",z=k!==null&&typeof k=="object"&&typeof Reflect.get(k,"registrations")=="function"?Reflect.apply(Reflect.get(k,"registrations"),k,[H]):void 0;return {documentReadyState:M?.readyState??null,parityTargetFrame:Number(w.__threeBlocksParityTargetFrame??0),parityCompletedFrame:Number(w.__threeBlocksParityCompletedFrame??0),readiness:B?.readiness??null,captureCache:k!==null&&typeof k=="object"?{activeScene:Reflect.get(k,"activeScene")??null,registrations:Array.isArray(z)?z.slice(0,16).map(x=>x!==null&&typeof x=="object"?{key:Reflect.get(x,"key")??null,kind:Reflect.get(x,"kind")??null}:null):null}:null,threeRuntimeResources:performance.getEntriesByType("resource").map(x=>x.name).filter(x=>x.includes("three.webgpu"))}}));throw new Error(`${u.message} Last capture state for "${e.key}": ${JSON.stringify({page:b,telemetry:y??null,transform:this.#d()})}`)}throw u}finally{s.off("disconnected",m),await L(()=>i.close()),this.#u++,(!s.isConnected()||this.#u>=(t.browserRelaunchScenes??8))&&(this.#t===s&&(this.#t=void 0),await L(()=>s.close()),this.#u=0);}}async observe(e,t,n,s){for(let i=0;i<2;i++)try{return await this.#S(e,t,n,s)}catch(a){if(i===0&&Ye(a))continue;throw a}throw new Error(`Shader observation retry was exhausted for scene "${e.key}".`)}async#S(e,t,n,s){if(await this.#g(t,n),!this.#t||!this.#i)throw new Error("Shader browser driver did not start.");let i=this.#t,a=await this.#s(i,n,()=>i.newContext({viewport:n.viewport}));this.#e.url!==void 0&&await this.#s(i,n,()=>he(a,this.#r,this.#n,t,n,v(this.#e.runtime.three)));let o=await this.#s(i,n,()=>a.newPage()),l=pe(o);this.#n.clear(e.key);try{await o.goto(We(this.#i,e,{threeBlocksShaderCapture:"1",threeBlocksShaderMode:t,captureId:e.key,...t==="live"?{precompiled:"0"}:{}}),{waitUntil:"domcontentloaded",timeout:n.timeoutMs}),await Promise.race([o.waitForFunction(n.bridge.legacyLab?"globalThis.__threeBlocks?.compileEnd === true":"globalThis.__threeBlocksShaderTools?.readiness?.compileEnd === true",void 0,{timeout:n.timeoutMs}),l.first.then(u=>Promise.reject(u))]),ee(await re(o,n.bridge.legacyLab),e,n.bridge.legacyLab,this.#d(),v(this.#e.runtime.three)),await Je(o,n,l),await Promise.race([o.waitForFunction(n.bridge.legacyLab?"true":"globalThis.__threeBlocksShaderTools?.readiness?.firstFrame === true",void 0,{timeout:n.timeoutMs}),l.first.then(u=>Promise.reject(u))]),await K(o,n,1);let h=Buffer.from(await o.screenshot({type:"png"})),p=e.parityFrames??n.parity.frames,f=await K(o,n,p,s),m=Buffer.from(await o.screenshot({type:"png"}));e.parityFrames!==void 0&&p<n.parity.frames&&await K(o,n,n.parity.frames-p);let d=ee(await re(o,n.bridge.legacyLab),e,n.bridge.legacyLab,this.#d(),v(this.#e.runtime.three));return this.#f===void 0&&(this.#f=await o.evaluate(async()=>{let u=Reflect.get(navigator,"gpu"),y=typeof u=="object"&&u!==null?Reflect.get(u,"requestAdapter"):void 0,b=typeof y=="function"?await Reflect.apply(y,u,[]):void 0,w=typeof b=="object"&&b!==null?Reflect.get(b,"info"):void 0,P=["description","device","architecture","vendor"].flatMap(B=>{let M=typeof w=="object"&&w!==null?Reflect.get(w,B):void 0;return typeof M=="string"&&M.length>0?[M]:[]});return {adapter:[...new Set(P)].join(" \xB7 ")||"WebGPU adapter",platform:navigator.platform||navigator.userAgent}})),{scene:e.key,mode:t,...d,frame:f,firstFrameScreenshot:h,screenshot:m,errors:[...l.page,...l.console]}}catch(h){let p=h instanceof Error?h:new Error(String(h));if(/(?:timed?\s*out|timeout)/iu.test(p.message)){let f=this.#n.read(e.key),m=await Ke(()=>o.evaluate(()=>{let d=globalThis,u=d.__threeBlocksShaderTools,y=u&&typeof u=="object"?u:void 0;return {documentReadyState:d.document?.readyState??null,parityTargetFrame:Number(d.__threeBlocksParityTargetFrame??0),parityCompletedFrame:Number(d.__threeBlocksParityCompletedFrame??0),readiness:y?.readiness??null,threeRuntimeResources:performance.getEntriesByType("resource").map(w=>w.name).filter(w=>w.includes("three.webgpu"))}}));throw new Error(`${p.message} Last ${t} state for "${e.key}": ${JSON.stringify({page:m,telemetry:f??null})}`)}throw p}finally{await L(()=>a.close());}}async observePublished(e,t){for(let n=0;n<2;n++)try{return await this.#w(e,t)}catch(s){if(n===0&&Ye(s))continue;throw s}throw new Error(`Published shader observation retry was exhausted for scene "${e.key}".`)}async#w(e,t){if(await this.#g("precompiled",t),!this.#t||!this.#i)throw new Error("Shader browser driver did not start.");let n=this.#t,s=await this.#s(n,t,()=>n.newContext({viewport:t.viewport}));this.#e.url!==void 0&&await this.#s(n,t,()=>he(s,this.#r,this.#n,"precompiled",t,v(this.#e.runtime.three)));let i=await this.#s(n,t,()=>s.newPage()),a=pe(i);this.#n.clear(e.key);try{await i.goto(Dr(this.#i,e),{waitUntil:"domcontentloaded",timeout:t.timeoutMs}),await Promise.race([i.waitForFunction(t.bridge.legacyLab?"globalThis.__threeBlocks?.compileEnd === true":"globalThis.__threeBlocksShaderTools?.readiness?.compileEnd === true",void 0,{timeout:t.timeoutMs}),a.first.then(f=>Promise.reject(f))]),await Je(i,t,a),ee(await re(i,t.bridge.legacyLab),e,t.bridge.legacyLab,this.#d(),v(this.#e.runtime.three)),await K(i,t,2);let o=await ze(i),l=await K(i,t,120),h=await ze(i),p=ee(await re(i,t.bridge.legacyLab),e,t.bridge.legacyLab,this.#d(),v(this.#e.runtime.three));return {scene:e.key,mode:"precompiled",...p,frame:l,firstFrameScreenshot:o,beforeScreenshot:o,screenshot:h,errors:[...a.page,...a.console]}}finally{await L(()=>s.close());}}timingEnvironment(){return this.#f??{adapter:"WebGPU adapter",platform:`${_.platform}/${_.arch}`}}async close(){this.#r.rejectAll(new Error("Shader browser driver closed.")),this.#t&&await L(()=>this.#t?.close()??Promise.resolve());let e=this.#a?.httpServer,t=e?Reflect.get(e,"closeAllConnections"):void 0;if(e&&typeof t=="function"&&Reflect.apply(t,e,[]),this.#a&&await L(()=>this.#a?.close()??Promise.resolve()),this.#o){let n=this.#o;n.closeAllConnections(),await L(()=>new Promise(s=>{n.close(()=>s());}));}if(this.#t=void 0,this.#a=void 0,this.#o=void 0,this.#i=void 0,this.#m=void 0,this.#p=void 0,this.#c=void 0,this.#f=void 0,this.#u=0,this.#l!==void 0&&(await rm(this.#l,{recursive:true,force:true}),this.#l=void 0),this.#h){for(let[n,s]of Object.entries(this.#h))s===void 0?delete _.env[n]:_.env[n]=s;this.#h=void 0;}}};function Ut(r){return new J(r)}a(Ut,"createPlaywrightShaderDriver");function Vt(r){return new J(r)}a(Vt,"createStaticPlaywrightShaderDriver");function Gt(r){return new J(r)}a(Gt,"createAttachedPlaywrightShaderDriver");
+export{v as a,I as b,it as c,C as d,st as e,at as f,ot as g,dt as h,ct as i,ut as j,Or as k,Ir as l,Se as m,Wr as n,Ye as o,Ut as p,Vt as q,Gt as r};

package/dist/chunk-WKUP6PVY.js

@@ -0,0 +1,76 @@
+import {d,a as a$1,T,v,U,x as x$1,Q,m,l,h,g,O as O$1}from'./chunk-2JE5VZXK.js';import {a}from'./chunk-EI7MMDWY.js';import b from'process';import {createServer}from'http';import {createRequire}from'module';import {mkdtemp,rm,lstat,realpath}from'fs/promises';import k from'path';import {tmpdir}from'os';import {pathToFileURL}from'url';var ve=Object.freeze([{id:"three-inspector-invalid-json",pattern:/is not valid JSON/iu},{id:"chromium-webgpu-experimental",pattern:/WebGPU is experimental/iu}]);function We(r){return ve.some(e=>e.pattern.test(r))}a(We,"isDocumentedBrowserNoise");function ee(r=b.env,e=b.platform){let t=r.THREE_BLOCKS_WEBGPU_BROWSER_ARGS?.split(/\s+/u).filter(Boolean);if(t&&t.length>0)return t;let n=["--enable-unsafe-webgpu"];return e==="darwin"&&n.push("--enable-gpu","--use-angle=metal"),e==="linux"&&n.push("--enable-features=Vulkan","--disable-vulkan-surface","--ignore-gpu-blocklist","--disable-gpu-driver-bug-workarounds","--disable-gpu-watchdog"),n}a(ee,"webgpuBrowserArgs");function te(r=false,e=b.env){return r!==true&&e.THREE_BLOCKS_SOFTWARE_WEBGPU!=="1"}a(te,"webgpuBrowserHeadless");var re="three-blocks.shader-capture.runtime.v1";var ce="/__three-blocks/shaders/capture",N="/__three-blocks/shaders/telemetry",ue="/__three-blocks/shaders/runtime.js",he="/__three-blocks/shaders/bootstrap.js",me="/__three-blocks/shaders/bridge.js",fe=d.manifest*2,W=/^[a-z0-9][a-z0-9_-]{0,63}$/u,pe=64,we=2e3,Be=[/is not valid JSON/iu,/WebGPU is experimental/iu];async function xe(){try{return (await import('playwright')).chromium}catch(r){throw new Error('Shader browser work requires the optional "playwright" package. Install it in the project and run `npx playwright install chromium`.',{cause:r})}}a(xe,"loadChromium");async function Oe(r){let e;try{e=createRequire(k.join(r,"package.json")).resolve("vite");}catch(n){throw new Error("Shader capture requires Vite in the target project.",{cause:n})}let t=await import(pathToFileURL(e).href);if(typeof t.createServer!="function")throw new Error(`The target project's Vite entry does not export createServer(): ${e}`);return t.createServer}a(Oe,"loadProjectCreateServer");var q=class{static{a(this,"CaptureInbox");}#e=new Map;#t=new Map;wait(e,t){let n=this.#t.get(e);if(n!==void 0)return this.#t.delete(e),Promise.resolve(n);if(this.#e.has(e))throw new Error(`A shader capture is already waiting for scene "${e}".`);return new Promise((o,s)=>{let i=setTimeout(()=>{this.#e.delete(e),s(new Error(`Shader capture "${e}" timed out after ${t}ms.`));},t);this.#e.set(e,{resolve:o,reject:s,timer:i});})}receive(e){if(!a$1(e)||typeof e.scene!="string"||!W.test(e.scene))throw new Error("Capture POST has no safe scene key.");if(!this.#t.has(e.scene)&&!this.#e.has(e.scene)&&this.#t.size>=pe)throw new Error("Capture POST exceeds the scene inbox limit.");let t=this.#e.get(e.scene);t?(clearTimeout(t.timer),this.#e.delete(e.scene),t.resolve(e)):this.#t.set(e.scene,e);}cancel(e,t){let n=this.#e.get(e);n&&(clearTimeout(n.timer),this.#e.delete(e),n.reject(t));}rejectAll(e){for(let t of this.#e.values())clearTimeout(t.timer),t.reject(e);this.#e.clear(),this.#t.clear();}};async function Me(r,e){let t=await Promise.race([e.then(n=>({kind:"capture",value:n})),r.then(()=>({kind:"navigation"}))]);return t.kind==="capture"?t.value:e}a(Me,"waitForShaderCaptureAcrossNavigation");var G=class{static{a(this,"TelemetryHub");}#e=new Map;#t=new Map;markFirstRequest(e){W.test(e)&&!this.#t.has(e)&&this.#t.set(e,Date.now());}firstRequest(e){return this.#t.get(e)}receive(e){if(!a$1(e)||typeof e.scene!="string"||!W.test(e.scene))throw new Error("Shader telemetry has no bounded scene key.");if(!this.#e.has(e.scene)&&this.#e.size>=pe)throw new Error("Shader telemetry exceeds the scene limit.");this.#e.set(e.scene,e);}read(e){return this.#e.get(e)}clear(e){this.#e.delete(e),this.#t.delete(e);}},je=a(async(r,e,t,n,o)=>{let s=0;for(;r.__threeBlocksParityUsesAnimationLoop!==true&&s<e;)await n(),s+=1;if(r.__threeBlocksParityUsesAnimationLoop===true){let i=Number(r.__threeBlocksParityCompletedFrame||0),a=Number(t),c=Number.isSafeInteger(a)&&a>=i?a:i+e;for(r.__threeBlocksParityTargetFrame=c;Number(r.__threeBlocksParityCompletedFrame||0)<c;)await n();}return await o(),Number(r.__threeBlocksParityCompletedFrame||0)},"settleShaderParityFrames");function J(r){return `(() => {
+  const root = globalThis;
+  const scene = new URL(location.href).searchParams.get('captureId')
+    || 'default';
+  const randomSeed = (value) => {
+    let state = 2166136261;
+    for (let index = 0; index < value.length; index++) state = Math.imul(state ^ value.charCodeAt(index), 16777619) >>> 0;
+    return state === 0 ? 0x9e3779b9 : state;
+  };
+  const advanceRandom = (state) => {
+    state ^= state << 13;
+    state ^= state >>> 17;
+    state ^= state << 5;
+    return state >>> 0;
+  };
+  const parityMode = new URL(location.href).searchParams.get('threeBlocksShaderMode');
+  if (parityMode === 'live' || parityMode === 'precompiled') {
+    root.__threeBlocksParityEpoch = 1700000000000;
+    root.__threeBlocksParityTime = 0;
+    Date.now = () => root.__threeBlocksParityEpoch + Number(root.__threeBlocksParityTime || 0);
+  }
+  const randomStreams = new Map();
+  Math.random = () => {
+    const stackLine = String(new Error().stack || '').split('\\n')[2] || 'unknown';
+    const originIndex = stackLine.indexOf(location.origin);
+    const callsite = (originIndex >= 0 ? stackLine.slice(0, originIndex) : stackLine).trim() || 'anonymous';
+    const next = advanceRandom(randomStreams.get(callsite) ?? randomSeed(scene + '|' + callsite));
+    randomStreams.set(callsite, next);
+    return next / 4294967296;
+  };
+  const readiness = { workerReady: false, assetsReady: false, textReady: false, compileEnd: false, firstFrame: false };
+  const stats = { buildCalls: 0, renderBuilds: 0, computeBuilds: 0, registeredBuilds: 0, registeredRenderBuilds: 0, registeredComputeBuilds: 0, buildMs: 0, syncBuildMs: 0, asyncBuildElapsedMs: 0, precompiledSetupMs: 0, maxSyncBuildMs: 0, maxPrecompiledSetupMs: 0, hydrationMs: 0, maxHydrationMs: 0, injected: 0, injectedRender: 0, injectedCompute: 0, missed: 0, missedRender: 0, missedCompute: 0, missedKeys: [] };
+  const settleParityFrames = ${je.toString()};
+  const settle = (frames, requestedTarget) => settleParityFrames(
+    root,
+    frames,
+    requestedTarget,
+    () => new Promise((resolve) => requestAnimationFrame(resolve)),
+    () => new Promise((resolve) => setTimeout(resolve, 100)),
+  );
+  const bridge = { protocolVersion: 1, compatibility: ${JSON.stringify(r)}, transform: ${x$1}, readiness, stats, settle };
+  root.__threeBlocksShaderTools = bridge;
+  requestAnimationFrame(() => requestAnimationFrame(() => { readiness.firstFrame = true; }));
+  const poll = async () => {
+    try {
+      const response = await fetch('/__three-blocks/shaders/telemetry?scene=' + encodeURIComponent(scene), { cache: 'no-store' });
+      if (response.status !== 204 && response.ok) {
+        const payload = await response.json();
+        if (payload.protocolVersion !== 1 || payload.compatibility !== bridge.compatibility || payload.transform !== bridge.transform) throw new Error('incompatible shader telemetry');
+        Object.assign(stats, payload.stats);
+        readiness.workerReady = true;
+        if (payload.settled === true) {
+          readiness.assetsReady = true;
+          readiness.textReady = true;
+          readiness.compileEnd = true;
+        }
+        const smoke = root.__threeBlocksSmoke && typeof root.__threeBlocksSmoke === 'object' ? root.__threeBlocksSmoke : { protocolVersion: 1, worker: { offscreenCanvas: true, visible: true }, readiness: {} };
+        smoke.readiness = { ...(smoke.readiness || {}), ...readiness };
+        root.__threeBlocksSmoke = smoke;
+      }
+    } catch {}
+    setTimeout(poll, 40);
+  };
+  void poll();
+})();`}a(J,"publicBridgeScript");function ye(r,e,t,n,o=false){let s=new URL(r.url??"/","http://three-blocks.invalid"),i=s.pathname;if(o&&r.method==="GET"&&/^\/three-blocks\/shaders\/[a-z0-9][a-z0-9_-]{0,63}\.json$/u.test(i))return e.statusCode=204,e.end(),true;if(i===N&&r.method==="GET"){let u=s.searchParams.get("scene")??"",m=n.read(u);return m===void 0?(e.statusCode=204,e.end()):(e.statusCode=200,e.setHeader("Content-Type","application/json"),e.end(JSON.stringify(m))),true}let a=i===ce,c=i===N;if(!a&&!c)return  false;if(r.method!=="POST")return e.statusCode=405,e.end("POST required"),true;let h=[],f=0,w=false;return r.on("data",u=>{f+=u.byteLength,f>fe?w=true:h.push(u);}),r.on("end",()=>{if(w){e.statusCode=413,e.end("capture payload too large");return}try{let u=JSON.parse(Buffer.concat(h).toString("utf8"));c?n.receive(u):t.receive(u),e.statusCode=204,e.end();}catch(u){e.statusCode=400,e.end(u instanceof Error?u.message:String(u));}}),true}a(ye,"handleCaptureEndpoint");function Fe(r,e,t,n){return {name:"three-blocks:shader-capture-endpoint",transformIndexHtml(){return [{tag:"script",children:J(n),injectTo:"head-prepend"}]},configureServer(o){o.middlewares.use((s,i,a)=>{let h=new URL(s.url??"/","http://three-blocks.invalid").searchParams.get("captureId");h!==null&&e.markFirstRequest(h),!ye(s,i,r,e,t)&&a();});}}}a(Fe,"captureEndpointPlugin");function se(r,e,t){let n=new URL(e.url,r);for(let[o,s]of Object.entries(t))n.searchParams.set(o,s);return n.href}a(se,"browserUrl");function Le(r,e){let t=new URL(e.url,r);for(let n of ["capture","precompiled"])t.searchParams.delete(n);return t.searchParams.set("captureId",e.key),t.searchParams.set("threeBlocksShaderMode","precompiled"),t.searchParams.set("tbStats","1"),t.href}a(Le,"publishedBrowserUrl");function oe(r){return Be.some(e=>e.test(r))}a(oe,"knownNoise");async function E(r){let e;try{await Promise.race([r(),new Promise(t=>{e=setTimeout(t,we);})]);}catch{}finally{e&&clearTimeout(e);}}a(E,"closeBrowserResource");async function ie(r){let e;try{return await Promise.race([r().catch(()=>null),new Promise(t=>{e=setTimeout(()=>t(null),we);})])}finally{e!==void 0&&clearTimeout(e);}}a(ie,"readPageDiagnostic");function V(r){let e=a(()=>{},"resolveFirst"),t=new Promise(i=>{e=i;}),n={console:[],page:[],first:t},o=false,s=a(i=>{o||(o=true,e(new Error(i)));},"report");return r.on("console",i=>{let a=i.type()==="warning"&&/\[three-blocks\/shaders\].*(?:has no entry|manifest miss|hydration)/iu.test(i.text());if(i.type()!=="error"&&!a||oe(i.text()))return;let c=i.location().url,h=c.length>0?`${i.text()} (${c})`:i.text();n.console.push(h),s(`Browser console ${a?"warning":"error"}: ${h}`);}),r.on("pageerror",i=>{if(oe(i.message))return;let a=i.stack||i.message;n.page.push(a),s(`Browser page error: ${a}`);}),r.on("crash",()=>s("Browser page crashed before shader capture completed.")),r.on("close",()=>s("Browser page closed before shader capture completed.")),n}a(V,"collectErrors");function x(r,e,t=false){return typeof r[e]=="boolean"?r[e]:t}a(x,"booleanField");function Ae(r){if(!a$1(r))throw new Error("Browser shader stats are unavailable.");let e=a((t,n=true)=>{let o=r[t];if(typeof o!="number"||!Number.isFinite(o)||o<0||n&&!Number.isSafeInteger(o))throw new Error(`Browser shader stats.${t} is invalid.`);return o},"read");return {buildCalls:e("buildCalls"),renderBuilds:e("renderBuilds"),computeBuilds:e("computeBuilds"),registeredBuilds:e("registeredBuilds"),registeredRenderBuilds:e("registeredRenderBuilds"),registeredComputeBuilds:e("registeredComputeBuilds"),buildMs:e("buildMs",false),syncBuildMs:e("syncBuildMs",false),asyncBuildElapsedMs:e("asyncBuildElapsedMs",false),precompiledSetupMs:e("precompiledSetupMs",false),maxSyncBuildMs:e("maxSyncBuildMs",false),maxPrecompiledSetupMs:e("maxPrecompiledSetupMs",false),hydrationMs:e("hydrationMs",false),maxHydrationMs:e("maxHydrationMs",false),injected:e("injected"),injectedRender:e("injectedRender"),injectedCompute:e("injectedCompute"),missed:e("missed"),missedRender:e("missedRender"),missedCompute:e("missedCompute"),...Array.isArray(r.missedKeys)&&r.missedKeys.every(t=>typeof t=="string")?{missedKeys:r.missedKeys}:{}}}a(Ae,"parseStats");function A(r,e,t,n,o){if(!a$1(r))throw new Error("The page did not expose the public shader devtools bridge.");if(!t&&r.protocolVersion!==1)throw new Error(`Scene "${e.key}" exposed an unsupported shader bridge protocol.`);let s=r.readiness;if(!a$1(s))throw new Error("The shader bridge readiness snapshot is invalid.");let i={workerReady:x(s,"workerReady"),assetsReady:x(s,"assetsReady"),textReady:e.requiresText?x(s,"textReady"):true,compileEnd:x(s,"compileEnd"),firstFrame:x(s,"firstFrame",t)};if(!i.workerReady||!i.assetsReady||!i.textReady||!i.compileEnd)throw new Error(`Scene "${e.key}" did not reach worker/assets/text/compile readiness.`);let a=t?o:r.compatibility,c=t?x$1:r.transform;if(a!==o||c!==x$1)throw new Error(`Scene "${e.key}" exposed incompatible shader bridge metadata.`);return U(n),{compatibility:o,transform:c,readiness:i,stats:Ae(r.stats)}}a(A,"parseBridge");async function D(r,e){return r.evaluate(t=>{let n=globalThis;if(!t)return n.__threeBlocksShaderTools??null;let o=n.__threeBlocks,s=n.__threeBlocksTslStats;if(!o||typeof o!="object")return null;let i=o;return {readiness:{workerReady:i.workerReady===true,assetsReady:i.loadEnd===true||i.assetsReady===true,textReady:i.textReady===true,compileEnd:i.compileEnd===true,firstFrame:true},stats:s}},e)}a(D,"readBridge");async function O(r,e,t,n){let o=r.evaluate(async i=>{let c=globalThis.__threeBlocksShaderTools;if(c&&typeof c=="object"){let w=Reflect.get(c,"settle");if(typeof w=="function"){let u=await w(i.frames,i.targetFrame);return typeof u=="number"&&Number.isSafeInteger(u)?u:0}}if(!i.legacy||!i.modulePath)throw new Error("The public shader bridge does not provide deterministic settle().");let h=await import(i.modulePath);if(!h.store||typeof h.store!="object")throw new Error("Legacy deterministic store is unavailable.");let f=h.store;return f.recordFrameCount=0,f.recordFrameRate=60,f.recordTotalFrames=i.frames,f.recording=true,await new Promise((w,u)=>{let m=Date.now(),d=a(()=>{if(f.recording===false)return w();if(Date.now()-m>i.timeoutMs)return u(new Error("Legacy deterministic settle timed out."));setTimeout(d,25);},"poll");d();}),0},{frames:t,targetFrame:n,legacy:e.bridge.legacyLab,modulePath:e.bridge.deterministicModule??null,timeoutMs:e.timeoutMs}),s;try{return await Promise.race([o,new Promise((i,a)=>{s=setTimeout(()=>a(new Error(`Shader parity settle timed out after ${e.timeoutMs}ms.`)),e.timeoutMs);})])}finally{s!==void 0&&clearTimeout(s);}}a(O,"settlePage");async function ae(r,e,t){e.readiness.selector===void 0&&e.readiness.global===void 0||await Promise.race([r.waitForFunction(n=>{let o=globalThis;if(n.selector!==void 0&&o.document?.querySelector(n.selector)==null)return  false;if(n.global===void 0)return  true;let s=o;for(let c of n.global.split(".")){if((typeof s!="object"||s===null)&&typeof s!="function")return  false;s=Reflect.get(s,c);}if(s===true)return  true;if(typeof s!="object"||s===null||typeof Reflect.get(s,"then")!="function")return  false;let i=o.__threeBlocksReadinessState,a=i instanceof Map?i:new Map;return i instanceof Map||(o.__threeBlocksReadinessState=a),a.has(s)||(a.set(s,false),Promise.resolve(s).then(()=>a.set(s,true),()=>a.set(s,false))),a.get(s)===true},e.readiness,{timeout:e.timeoutMs}),t.first.then(n=>Promise.reject(n))]);}a(ae,"waitForConfiguredReadiness");async function de(r){let e=r.locator("canvas"),n=(await e.evaluateAll(o=>o.map((s,i)=>{let a=s.getBoundingClientRect();return {index:i,area:Math.max(0,a.width)*Math.max(0,a.height)}}))).sort((o,s)=>s.area-o.area)[0];if(n===void 0||n.area<=0)throw new Error("Published page has no visible renderer canvas.");return Buffer.from(await e.nth(n.index).screenshot({type:"png"}))}a(de,"primaryCanvasScreenshot");async function K(r,e,t,n,o,s){let i=ge(n,o),a=await Q(),c=`(() => {
+  const runtime = globalThis[Symbol.for(${JSON.stringify(re)})];
+  if (!runtime || typeof runtime.configureThreeBlocksShaderCapture !== 'function') {
+    throw new Error('@three-blocks/devtools attached shader capture runtime is incompatible.');
+  }
+  runtime.configureThreeBlocksShaderCapture(${JSON.stringify(i).replaceAll("<","\\u003c")});
+})();`;await r.addInitScript({content:`${a}
+${c}`}),await r.addInitScript({content:J(s)}),await r.route("**/*",async h=>{let f=h.request(),w=new URL(f.url()),u=w.pathname;if(f.method()==="GET"&&n!=="precompiled"&&/^\/three-blocks\/shaders\/[a-z0-9][a-z0-9_-]{0,63}\.json$/u.test(u)){await h.fulfill({status:204});return}if(u===N&&f.method()==="GET"){let p=t.read(w.searchParams.get("scene")??"");await h.fulfill(p===void 0?{status:204}:{status:200,contentType:"application/json",body:JSON.stringify(p)});return}let m=u===ce,d=u===N;if((m||d)&&f.method()==="POST"){let p=f.postDataBuffer()??Buffer.alloc(0);if(p.byteLength>fe){await h.fulfill({status:413,body:"capture payload too large"});return}try{let g=JSON.parse(p.toString("utf8"));d?t.receive(g):e.receive(g),await h.fulfill({status:204});}catch(g){await h.fulfill({status:400,body:g instanceof Error?g.message:String(g)});}return}await h.continue();});}a(K,"configureAttachedContext");var De=Object.freeze({".avif":"image/avif",".css":"text/css; charset=utf-8",".gif":"image/gif",".html":"text/html; charset=utf-8",".ico":"image/x-icon",".jpeg":"image/jpeg",".jpg":"image/jpeg",".js":"text/javascript; charset=utf-8",".json":"application/json; charset=utf-8",".mjs":"text/javascript; charset=utf-8",".mp4":"video/mp4",".png":"image/png",".svg":"image/svg+xml",".wasm":"application/wasm",".webm":"video/webm",".webp":"image/webp",".woff":"font/woff",".woff2":"font/woff2"});function Ne(r){let e=[`<script src="${me}"></script>`,`<script type="module" src="${he}"></script>`].join(""),t=/<head(?:\s[^>]*)?>/iu.exec(r);return t===null?`${e}${r}`:`${r.slice(0,t.index+t[0].length)}${e}${r.slice(t.index+t[0].length)}`}a(Ne,"injectStaticShaderCaptureHtml");function Ie(r,e){let t=ge(r,e);return [`import { configureThreeBlocksShaderCapture } from ${JSON.stringify(ue)};`,`configureThreeBlocksShaderCapture( ${JSON.stringify(t).replaceAll("<","\\u003c")} );`].join(`
+`)}a(Ie,"staticCaptureBootstrap");function ge(r,e){return {capture:r==="capture",forceLive:r!=="precompiled",settleFrames:e.settleFrames,settleTimeoutMs:e.settleTimeoutMs??3e4,readiness:e.readiness,transform:x$1}}a(ge,"shaderCaptureConfiguration");async function Ue(r,e){let t=await m(r,e,i=>/\.(?:c|m)?js$/u.test(i),16384),n=false,o=false,s;for(let i of t){let a=(await l(r,i,d.texture,"Static application JavaScript")).data.toString("utf8");if(a.includes("nodeBuilderStateProvider")&&(n=true),a.includes("three-blocks.shader-capture.runtime.v1")&&(o=true,s??=i),n&&o)break}if(!n||!o)throw new Error("The static build does not contain the Three.js shader capture transform. Run `shaders capture` without an explicit driver or URL to preview adapter wiring and build automatically, or add the manual adapter from the package README and rebuild.");return {seen:true,applied:true,alreadyPresent:false,captureApplied:true,...s===void 0?{}:{id:s}}}a(Ue,"inspectStaticCaptureTransform");async function $e(r,e){let t;try{t=decodeURIComponent(e);}catch{return}if(t.includes("\0"))return;let n=t.replace(/^\/+/u,""),o=k.resolve(r,n.length===0?"index.html":n);if(!h(r,o)||o===r||(await g(o)&&(await lstat(o)).isDirectory()&&(o=k.join(o,"index.html")),!await g(o)&&k.extname(o).length===0&&(o=k.join(r,"index.html")),!await g(o)))return;let s=await l(r,o,d.texture,"Static application asset");return {data:s.data,file:s.path}}a($e,"staticRequestFile");async function He(r,e,t,n,o){let s=await realpath(r.root),i=await realpath(k.resolve(s,r.serve));if(!h(s,i)||i===s)throw new Error("--serve must name a built application directory inside the project root.");let a=await Ue(s,i),c=await O$1(),h$1=Ie(e,t),f=J(v(r.runtime.three)),w=createServer((m,d)=>{(async()=>{if(ye(m,d,n,o,e!=="precompiled"))return;let p=new URL(m.url??"/","http://three-blocks.invalid");if(m.method!=="GET"&&m.method!=="HEAD"){d.statusCode=405,d.end("GET or HEAD required");return}let g=p.pathname===ue?c:p.pathname===he?h$1:p.pathname===me?f:void 0;if(g!==void 0){d.statusCode=200,d.setHeader("Content-Type","text/javascript; charset=utf-8"),d.setHeader("Cache-Control","no-store"),d.end(m.method==="HEAD"?void 0:g);return}let y=await $e(i,p.pathname);if(y===void 0){d.statusCode=404,d.end("Not found");return}let v=k.extname(y.file).toLowerCase(),C=v===".html"?Buffer.from(Ne(y.data.toString("utf8"))):y.data;d.statusCode=200,d.setHeader("Content-Type",De[v]??"application/octet-stream"),d.setHeader("Content-Length",String(C.byteLength)),d.setHeader("Cache-Control","no-store"),d.end(m.method==="HEAD"?void 0:C);})().catch(p=>{if(d.headersSent)return d.destroy(p instanceof Error?p:void 0);d.statusCode=500,d.end(p instanceof Error?p.message:String(p));});});await new Promise((m,d)=>{w.once("error",d),w.listen(0,"127.0.0.1",()=>{w.off("error",d),m();});});let u=w.address();if(!u||typeof u=="string")throw new Error("Static capture server did not expose an ephemeral TCP address.");return {server:w,baseUrl:`http://127.0.0.1:${u.port}`,transform:a}}a(He,"startStaticShaderServer");function Ve(r,e,t){return r===e?true:t&&r!==void 0&&r!=="capture"&&e!=="capture"}a(Ve,"canReuseShaderBrowserSession");function le(r){let e=r instanceof Error?r.message:String(r);return e.includes("Execution context was destroyed")&&e.includes("navigation")||/^launch: Timeout \d+ms exceeded\./u.test(e)}a(le,"isRetryableShaderObservationNavigation");var M=class{static{a(this,"PlaywrightShaderDriver");}#e;#t=new q;#n=new G;#h;#m;#i;#a;#r;#s;#f;#l;#p;#c=0;#u;constructor(e){this.#e=e;}#d(){return this.#h?.status??this.#m??{seen:false,applied:false,alreadyPresent:false}}async#w(e){if(this.#r?.isConnected()===true)return;this.#r=void 0;let t=await xe();this.#u??=await mkdtemp(k.join(tmpdir(),"three-blocks-shader-cache-")),this.#r=await t.launch({headless:te(this.#e.headed===true),args:[...ee(),`--disk-cache-dir=${this.#u}`],timeout:e.timeoutMs}),this.#c=0;}async#o(e,t,n){let o;try{return await Promise.race([n(),new Promise((s,i)=>{o=setTimeout(()=>i(new Error(`launch: Timeout ${t.timeoutMs}ms exceeded.`)),t.timeoutMs);})])}catch(s){throw this.#r===e&&(this.#r=void 0),await E(()=>e.close()),s}finally{o!==void 0&&clearTimeout(o);}}async#y(e,t){let n=this.#i!==void 0||this.#a!==void 0||this.#e.url!==void 0&&this.#s!==void 0,o=this.#a!==void 0?this.#l===e:Ve(this.#l,e,t.bridge.legacyLab);if(n&&o){this.#l=e,await this.#w(t);return}if(n&&await this.close(),this.#l=e,this.#e.url!==void 0){let s=new URL(this.#e.url);if(!["http:","https:"].includes(s.protocol)||s.username||s.password||s.hash)throw new Error("Attached shader URL must be an HTTP(S) URL without credentials or a fragment.");this.#s=s.href,this.#m={seen:true,applied:true,alreadyPresent:false,captureApplied:true,id:"attached-application"},await this.#w(t);return}if(this.#e.serve!==void 0)try{let s=await He({root:this.#e.root,runtime:this.#e.runtime,serve:this.#e.serve,...this.#e.headed===void 0?{}:{headed:this.#e.headed}},e,t,this.#t,this.#n);this.#a=s.server,this.#m=s.transform,this.#s=s.baseUrl,await this.#w(t);return}catch(s){throw await this.close(),s}this.#h=T(this.#e.runtime.three,{disableTimestampQueries:b.env.THREE_BLOCKS_SOFTWARE_WEBGPU==="1",...t.bridge.legacyLab?{}:{capture:{capture:e==="capture",forceLive:e!=="precompiled",settleFrames:t.settleFrames,settleTimeoutMs:t.settleTimeoutMs??3e4,readiness:t.readiness}}}),this.#f={THREE_BLOCKS_SHADER_TOOL:b.env.THREE_BLOCKS_SHADER_TOOL,THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER:b.env.THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER},b.env.THREE_BLOCKS_SHADER_TOOL="1",b.env.THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER="1";try{let s=await Oe(this.#e.root);this.#i=await s({root:this.#e.root,logLevel:"error",plugins:[this.#h.plugin,Fe(this.#t,this.#n,e!=="precompiled",v(this.#e.runtime.three))],server:{host:"127.0.0.1",port:0}}),await this.#i.listen();let i=this.#i.httpServer?.address();if(!i||typeof i=="string")throw new Error("Vite did not expose an ephemeral TCP address.");this.#s=`http://127.0.0.1:${i.port}`,await this.#w(t);}catch(s){throw await this.close(),s}}async capture(e,t){let n=Date.now();if(await this.#y("capture",t),!this.#r||!this.#s)throw new Error("Shader browser driver did not start.");let o=this.#r,s=await this.#o(o,t,()=>o.newContext({viewport:t.viewport}));this.#e.url!==void 0&&await this.#o(o,t,()=>K(s,this.#t,this.#n,"capture",t,v(this.#e.runtime.three)));let i=await this.#o(o,t,()=>s.newPage()),a$2=V(i);this.#n.clear(e.key);let c=this.#t.wait(e.key,t.timeoutMs),h=Promise.race([c,a$2.first.then(m=>Promise.reject(m))]),f=a(()=>{},"resolveDisconnected"),w=new Promise(m=>{f=m;}),u=a(()=>f(new Error("Shader capture browser disconnected before posting a manifest.")),"onDisconnected");o.on("disconnected",u);try{let m=i.goto(se(this.#s,e,{threeBlocksShaderCapture:"1",capture:"1",captureId:e.key,captureFrames:String(Math.max(4,t.settleFrames)),settleFrames:String(t.settleFrames)}),{waitUntil:"domcontentloaded",timeout:t.timeoutMs}),d=await Me(m,Promise.race([h,w.then(g=>Promise.reject(g))]));U(this.#d());let p=[...a$2.page,...a$2.console];if(p.length>0)throw new Error(`Capture browser errors:
+ - ${p.join(`
+ - `)}`);return a$1(d)?{...d,timing:{...a$1(d.timing)?d.timing:{},launch:n,...this.#n.firstRequest(e.key)===void 0?{}:{firstRequest:this.#n.firstRequest(e.key)},posted:Date.now()}}:d}catch(m){let d=m instanceof Error?m:new Error(String(m));this.#t.cancel(e.key,d),await c.catch(()=>{});let p=this.#n.read(e.key);if(d.message.includes("timed out")){let g=await ie(()=>i.evaluate(()=>{let y=globalThis,v=y.__threeBlocksShaderTools,C=v&&typeof v=="object"?v:void 0,_=y.document,T=Reflect.get(y,Symbol.for("three-blocks.shader-capture.cache-value.v1")),j=y.location,Se=j!==null&&typeof j=="object"&&typeof Reflect.get(j,"href")=="string"?String(Reflect.get(j,"href")):"http://three-blocks.invalid/",be=new URL(Se).searchParams.get("captureId")??"default",z=T!==null&&typeof T=="object"&&typeof Reflect.get(T,"registrations")=="function"?Reflect.apply(Reflect.get(T,"registrations"),T,[be]):void 0;return {documentReadyState:_?.readyState??null,parityTargetFrame:Number(y.__threeBlocksParityTargetFrame??0),parityCompletedFrame:Number(y.__threeBlocksParityCompletedFrame??0),readiness:C?.readiness??null,captureCache:T!==null&&typeof T=="object"?{activeScene:Reflect.get(T,"activeScene")??null,registrations:Array.isArray(z)?z.slice(0,16).map(R=>R!==null&&typeof R=="object"?{key:Reflect.get(R,"key")??null,kind:Reflect.get(R,"kind")??null}:null):null}:null,threeRuntimeResources:performance.getEntriesByType("resource").map(R=>R.name).filter(R=>R.includes("three.webgpu"))}}));throw new Error(`${d.message} Last capture state for "${e.key}": ${JSON.stringify({page:g,telemetry:p??null,transform:this.#d()})}`)}throw d}finally{o.off("disconnected",u),await E(()=>s.close()),this.#c++,(!o.isConnected()||this.#c>=(t.browserRelaunchScenes??8))&&(this.#r===o&&(this.#r=void 0),await E(()=>o.close()),this.#c=0);}}async observe(e,t,n,o){for(let s=0;s<2;s++)try{return await this.#g(e,t,n,o)}catch(i){if(s===0&&le(i))continue;throw i}throw new Error(`Shader observation retry was exhausted for scene "${e.key}".`)}async#g(e,t,n,o){if(await this.#y(t,n),!this.#r||!this.#s)throw new Error("Shader browser driver did not start.");let s=this.#r,i=await this.#o(s,n,()=>s.newContext({viewport:n.viewport}));this.#e.url!==void 0&&await this.#o(s,n,()=>K(i,this.#t,this.#n,t,n,v(this.#e.runtime.three)));let a=await this.#o(s,n,()=>i.newPage()),c=V(a);this.#n.clear(e.key);try{await a.goto(se(this.#s,e,{threeBlocksShaderCapture:"1",threeBlocksShaderMode:t,captureId:e.key,...t==="live"?{precompiled:"0"}:{}}),{waitUntil:"domcontentloaded",timeout:n.timeoutMs}),await Promise.race([a.waitForFunction(n.bridge.legacyLab?"globalThis.__threeBlocks?.compileEnd === true":"globalThis.__threeBlocksShaderTools?.readiness?.compileEnd === true",void 0,{timeout:n.timeoutMs}),c.first.then(d=>Promise.reject(d))]),A(await D(a,n.bridge.legacyLab),e,n.bridge.legacyLab,this.#d(),v(this.#e.runtime.three)),await ae(a,n,c),await Promise.race([a.waitForFunction(n.bridge.legacyLab?"true":"globalThis.__threeBlocksShaderTools?.readiness?.firstFrame === true",void 0,{timeout:n.timeoutMs}),c.first.then(d=>Promise.reject(d))]),await O(a,n,1);let h=Buffer.from(await a.screenshot({type:"png"})),f=e.parityFrames??n.parity.frames,w=await O(a,n,f,o),u=Buffer.from(await a.screenshot({type:"png"}));e.parityFrames!==void 0&&f<n.parity.frames&&await O(a,n,n.parity.frames-f);let m=A(await D(a,n.bridge.legacyLab),e,n.bridge.legacyLab,this.#d(),v(this.#e.runtime.three));return this.#p===void 0&&(this.#p=await a.evaluate(async()=>{let d=Reflect.get(navigator,"gpu"),p=typeof d=="object"&&d!==null?Reflect.get(d,"requestAdapter"):void 0,g=typeof p=="function"?await Reflect.apply(p,d,[]):void 0,y=typeof g=="object"&&g!==null?Reflect.get(g,"info"):void 0,v=["description","device","architecture","vendor"].flatMap(C=>{let _=typeof y=="object"&&y!==null?Reflect.get(y,C):void 0;return typeof _=="string"&&_.length>0?[_]:[]});return {adapter:[...new Set(v)].join(" \xB7 ")||"WebGPU adapter",platform:navigator.platform||navigator.userAgent}})),{scene:e.key,mode:t,...m,frame:w,firstFrameScreenshot:h,screenshot:u,errors:[...c.page,...c.console]}}catch(h){let f=h instanceof Error?h:new Error(String(h));if(/(?:timed?\s*out|timeout)/iu.test(f.message)){let w=this.#n.read(e.key),u=await ie(()=>a.evaluate(()=>{let m=globalThis,d=m.__threeBlocksShaderTools,p=d&&typeof d=="object"?d:void 0;return {documentReadyState:m.document?.readyState??null,parityTargetFrame:Number(m.__threeBlocksParityTargetFrame??0),parityCompletedFrame:Number(m.__threeBlocksParityCompletedFrame??0),readiness:p?.readiness??null,threeRuntimeResources:performance.getEntriesByType("resource").map(y=>y.name).filter(y=>y.includes("three.webgpu"))}}));throw new Error(`${f.message} Last ${t} state for "${e.key}": ${JSON.stringify({page:u,telemetry:w??null})}`)}throw f}finally{await E(()=>i.close());}}async observePublished(e,t){for(let n=0;n<2;n++)try{return await this.#S(e,t)}catch(o){if(n===0&&le(o))continue;throw o}throw new Error(`Published shader observation retry was exhausted for scene "${e.key}".`)}async#S(e,t){if(await this.#y("precompiled",t),!this.#r||!this.#s)throw new Error("Shader browser driver did not start.");let n=this.#r,o=await this.#o(n,t,()=>n.newContext({viewport:t.viewport}));this.#e.url!==void 0&&await this.#o(n,t,()=>K(o,this.#t,this.#n,"precompiled",t,v(this.#e.runtime.three)));let s=await this.#o(n,t,()=>o.newPage()),i=V(s);this.#n.clear(e.key);try{await s.goto(Le(this.#s,e),{waitUntil:"domcontentloaded",timeout:t.timeoutMs}),await Promise.race([s.waitForFunction(t.bridge.legacyLab?"globalThis.__threeBlocks?.compileEnd === true":"globalThis.__threeBlocksShaderTools?.readiness?.compileEnd === true",void 0,{timeout:t.timeoutMs}),i.first.then(w=>Promise.reject(w))]),await ae(s,t,i),A(await D(s,t.bridge.legacyLab),e,t.bridge.legacyLab,this.#d(),v(this.#e.runtime.three)),await O(s,t,2);let a=await de(s),c=await O(s,t,120),h=await de(s),f=A(await D(s,t.bridge.legacyLab),e,t.bridge.legacyLab,this.#d(),v(this.#e.runtime.three));return {scene:e.key,mode:"precompiled",...f,frame:c,firstFrameScreenshot:a,beforeScreenshot:a,screenshot:h,errors:[...i.page,...i.console]}}finally{await E(()=>o.close());}}timingEnvironment(){return this.#p??{adapter:"WebGPU adapter",platform:`${b.platform}/${b.arch}`}}async close(){this.#t.rejectAll(new Error("Shader browser driver closed.")),this.#r&&await E(()=>this.#r?.close()??Promise.resolve());let e=this.#i?.httpServer,t=e?Reflect.get(e,"closeAllConnections"):void 0;if(e&&typeof t=="function"&&Reflect.apply(t,e,[]),this.#i&&await E(()=>this.#i?.close()??Promise.resolve()),this.#a){let n=this.#a;n.closeAllConnections(),await E(()=>new Promise(o=>{n.close(()=>o());}));}if(this.#r=void 0,this.#i=void 0,this.#a=void 0,this.#s=void 0,this.#h=void 0,this.#m=void 0,this.#l=void 0,this.#p=void 0,this.#c=0,this.#u!==void 0&&(await rm(this.#u,{recursive:true,force:true}),this.#u=void 0),this.#f){for(let[n,o]of Object.entries(this.#f))o===void 0?delete b.env[n]:b.env[n]=o;this.#f=void 0;}}};function lt(r){return new M(r)}a(lt,"createPlaywrightShaderDriver");function ct(r){return new M(r)}a(ct,"createStaticPlaywrightShaderDriver");function ut(r){return new M(r)}a(ut,"createAttachedPlaywrightShaderDriver");
+export{ve as a,We as b,ee as c,te as d,Me as e,je as f,J as g,Ve as h,le as i,lt as j,ct as k,ut as l};

package/dist/cli.js

@@ -5,20 +5,20 @@ ${e}
 `:t),n.includes("--yes"))return  true;if(!a.stdin.isTTY||!a.stderr.isTTY)throw new Error("Adapter wiring needs consent. Review the diff above, then rerun with --yes; no files were changed.");let{createInterface:i}=await import('readline/promises'),r=i({input:a.stdin,output:a.stderr});try{let c=await r.question("Apply this patch? (y/N) ");return /^y(?:es)?$/iu.test(c.trim())}finally{r.close();}}a$1(ce,"approveAdapterPatch");function C(e){return w?{update(){},stop(){}}:h(e)}a$1(C,"wait");function le(){let e$1=a$1(f=>b$1.accent(f),"c"),t=a$1(f=>b$1.dim(f),"d"),i=c.mark?`${c.mark}  `:"",r=[["Inspect",[[`${e$1("status")}`,`project report: shaders, text, browser evidence ${t("\u2014 no browser, no GPU")}`],[`${e$1("shaders")}`,"verify shader freshness and exit 1 with the exact recovery command"],[`${e$1("shaders status")} ${t("[--check]")}`,`per-scene shader freshness ${t("(--check exits 1 when not fresh)")}`],[`${e$1("text status")}`,"text atlas coverage"]]],["Produce",[[`${e$1("shaders capture")} ${t("[--if-stale] [--commit-timing] [--driver static --serve dist]")}`,"capture shaders plus a local timing estimate; during development use the overlay Capture button"],[`${e$1("shaders watch")} ${t("[--debounce <ms>]")}`,"recapture automatically while you work"],[`${e$1("text generate")} ${t("[--config <path>]")}`,"regenerate MSDF text atlases"],[`${e$1("environment bake")} ${t("[--size 256]")}`,"bake the PMREM room environment to KTX2"]]],["Verify",[[`${e$1("shaders test")}`,"median timing + zero-build + compute + pixel parity gate"],[`${e$1("shaders test --parity-only")}`,"one correctness pair per scene; no timing or published-page soak"],[`${e$1("browser smoke")} ${t("[--route /] [--hmr <module>]")}`,"boot the dev app, verify worker lifecycle + HMR"],[`${e$1("browser preview")} ${t("[--route /]...")}`,"build + serve production, verify precompiled hydration"]]]],c$1=["",`${i}${b$1.bold("three-blocks devtools")} ${b$1.dim(`v${a$2}`)}`,b$1.dim("WebGPU shader precompilation and verification for Three Blocks projects."),"",`${b$1.bold("Usage")}`,`  ${e$1("three-blocks-devtools")} ${t("[command] [options] [--json]")}`];for(let[f,d]of r)c$1.push("",b$1.bold(f),...e(d,{indent:2,maxWidth:a$3.width-2}));c$1.push("",b$1.bold("Options"),...e([[t("--json"),"stable machine-readable report on stdout"],[t("--reporter <plain|json>"),"select the stable terminal or CI reporter"],[t("--root <path>"),"project root (defaults to the nearest three-blocks project)"],[t("--headed"),"show the automation browser window"],[t("--runs <n>"),"shader timing captures after warmup (default 5)"],[t("--parity-only"),"skip timing warmup/repeats and the published-page soak"],[t("--commit-timing"),"also write shareable hardware-labelled build timing"],[t("--skip-browser"),"check shader schema and freshness without browser parity"],[t("--driver <vite|static>"),"capture through Vite or an already-built static app"],[t("--serve <path>"),"built application directory for --driver static"],[t("--url <url>"),"attach to an already-running transformed application"],[t("--yes"),"apply a previewed framework adapter patch non-interactively"]],{indent:2,maxWidth:a$3.width-2}),"",b$1.dim("During development, use the in-page overlay Capture button for one-click recapture."),b$1.dim("`shaders capture` remains the explicit isolated-browser fallback for batch and CI."),""),f(c$1.join(`
 `));}a$1(le,"help");function pe(e){return e?`${e.render} render \xB7 ${e.compute} compute`:"no coverage"}a$1(pe,"coverageText");function Q(e){return e<100?e.toFixed(1):Math.round(e).toString()}a$1(Q,"milliseconds");function A(e,t,i){return `${e} ${d(t,12)} ${i}`}a$1(A,"row");function oe(e$1){if(e$1.skipped)return A(c.tick,"shaders",`fresh ${c.dot} capture skipped ${b$1.dim(`(--if-stale) \xB7 ${e$1.reason}`)}`);let t=Math.max(0,Math.round((e$1.durationMs??0)/1e3)),i=e$1.scenes.length,r=[A(c.tick,"shaders",`captured in ${t} s ${c.dot} wrote ${i} shader scene${i===1?"":"s"}`)];e$1.configuration?.created===true&&r.push(b$1.dim(`  created ${e$1.configuration.file} with the default "/" capture route`));for(let f of e$1.scenes)r.push(A(c.tick,f.scene,`${pe(f.coverage)} ${c.dot} ${b$1.dim(`${f.attempts} attempt${f.attempts===1?"":"s"}`)}`));let c$1=e$1.scenes.flatMap(f=>{let d=f.timing;if(d?.launch===void 0||d.firstRequest===void 0||d.readiness===void 0||d.lastBuild===void 0||d.settled===void 0||d.posted===void 0)return [];let m=a$1((M,l)=>`${Q(Math.max(0,l-M))} ms`,"elapsed");return [[f.scene,`launch\u2192request ${m(d.launch,d.firstRequest)} ${c.dot} ready ${m(d.firstRequest,d.readiness)} ${c.dot} last build ${m(d.readiness,d.lastBuild)} ${c.dot} settle ${m(d.lastBuild,d.settled)} ${c.dot} post ${m(d.settled,d.posted)}`]]});return c$1.length>0&&r.push("",b$1.bold("Capture stages"),...e(c$1,{indent:2,maxWidth:a$3.width-2})),e$1.measurement!==void 0&&r.push(`  TSL builds at startup: ${e$1.measurement.beforeBuilds} \u2192 ${e$1.measurement.afterBuilds} ${c.dot} \u2248${Q(Math.abs(e$1.measurement.firstFrameDeltaMs))} ms TSL work avoided (single-capture estimate)`),r.push(b$1.dim("  a running dev server reloads on its own; otherwise refresh the page")),r.join(`
 `)}a$1(oe,"formatShaderCapture");function fe(e){let t=[A(c.tick,"shaders",`no-GPU ${e.noGpu.state} ${c.dot} browser ${e.browser}`)];for(let i of e.scenes){let r=e.timing?.scenes[i.scene],c$1=r===void 0?`${i.coverage.render+i.coverage.compute} TSL build${i.coverage.render+i.coverage.compute===1?"":"s"} skipped`:`${r.builds} TSL build${r.builds===1?"":"s"} skipped ${c.dot} \u2248${Q(r.avoidedBuildMs)} ms \xB1 ${Q(r.spreadMs)} TSL work avoided ${c.dot} median of ${r.runs} ${c.dot} Latest local capture`,f=r!==void 0&&r.spreadMs>r.avoidedBuildMs*.4?` ${c.dot} ${b$1.warn("noisy measurement \u2014 close other GPU apps and re-run")}`:"";t.push(A(c.tick,i.scene,`${c$1} ${c.dot} ${i.coverage.compute} compute ${c.dot} ${(i.parity.diffRatio*100).toFixed(3)}% pixel diff${f}`));}return t.join(`
-`)}a$1(fe,"formatShaderTest");async function he(){if(se!==void 0)throw new Error(se);if(y==="help"||y==="--help"||n.includes("--help"))return le();if(y==="version"||n.includes("--version")){f(w?JSON.stringify({version:a$2}):a$2);return}if(y==="browser"){let{formatBrowserPreviewReport:d,formatBrowserSmokeReport:m,runBrowserPreview:M,runBrowserSmoke:l}=await import('./browser-smoke-MKYIJVVA.js'),{findProjectRoot:S}=await import('./status-76TXXSRT.js');if(E==="preview"){let U=b("--root")??await S(),j=ue("--route"),I=b("--build-mode"),P=b("--expect-shaders")??"precompiled";if(P!=="precompiled"&&P!=="live")throw new Error('--expect-shaders must be "precompiled" or "live".');let T=$("--width"),B=$("--height"),J=$("--timeout"),D=$("--settle"),O=$("--min-luminance"),z=C("building and verifying the production bundle"),o;try{o=await M({root:U,...j.length===0?{}:{routes:j},...I===void 0?{}:{buildMode:I},expectShaders:P,text:n.includes("--text"),...J===void 0?{}:{timeoutMs:J},...D===void 0?{}:{settleMs:D},...O===void 0?{}:{minimumLuminance:O},...T===void 0&&B===void 0?{}:{viewport:{width:T??1024,height:B??640}},headed:n.includes("--headed")});}finally{z.stop();}a.stdout.write(`${w?JSON.stringify(o,null,2):d(o)}
+`)}a$1(fe,"formatShaderTest");async function he(){if(se!==void 0)throw new Error(se);if(y==="help"||y==="--help"||n.includes("--help"))return le();if(y==="version"||n.includes("--version")){f(w?JSON.stringify({version:a$2}):a$2);return}if(y==="browser"){let{formatBrowserPreviewReport:d,formatBrowserSmokeReport:m,runBrowserPreview:M,runBrowserSmoke:l}=await import('./browser-smoke-GPOH7Z4F.js'),{findProjectRoot:S}=await import('./status-J53T3G3P.js');if(E==="preview"){let U=b("--root")??await S(),j=ue("--route"),I=b("--build-mode"),P=b("--expect-shaders")??"precompiled";if(P!=="precompiled"&&P!=="live")throw new Error('--expect-shaders must be "precompiled" or "live".');let T=$("--width"),B=$("--height"),J=$("--timeout"),D=$("--settle"),O=$("--min-luminance"),z=C("building and verifying the production bundle"),o;try{o=await M({root:U,...j.length===0?{}:{routes:j},...I===void 0?{}:{buildMode:I},expectShaders:P,text:n.includes("--text"),...J===void 0?{}:{timeoutMs:J},...D===void 0?{}:{settleMs:D},...O===void 0?{}:{minimumLuminance:O},...T===void 0&&B===void 0?{}:{viewport:{width:T??1024,height:B??640}},headed:n.includes("--headed")});}finally{z.stop();}a.stdout.write(`${w?JSON.stringify(o,null,2):d(o)}
 `),o.passed||(a.exitCode=1);return}if(E!=="smoke")throw new Error(`Unsupported browser command "${E??""}".`);let x=b("--root")??await S(),h=$("--width"),k=$("--height"),R=b("--route"),_=$("--timeout"),q=$("--settle"),L=$("--min-luminance"),g=b("--hmr");if(n.includes("--webgl")&&n.includes("--unsupported-worker"))throw new Error("--webgl and --unsupported-worker are mutually exclusive.");let W=C(`smoking ${R??"/"} in a real browser`),v;try{v=await l({root:x,...R===void 0?{}:{route:R},..._===void 0?{}:{timeoutMs:_},...q===void 0?{}:{settleMs:q},...L===void 0?{}:{minimumLuminance:L},...g===void 0?{}:{hmrModule:g},forceWebgl:n.includes("--webgl"),unsupportedWorker:n.includes("--unsupported-worker"),expectTextGenerationFailure:n.includes("--expect-text-generation-failure"),...h===void 0&&k===void 0?{}:{viewport:{width:h??1024,height:k??640}},headed:n.includes("--headed")});}finally{W.stop();}a.stdout.write(`${w?JSON.stringify(v,null,2):m(v)}
-`),v.passed||(a.exitCode=1);return}if(y==="environment"){if(E!=="bake")throw new Error(`Unsupported environment command "${E??""}".`);let{bakeRoomEnvironment:d,formatEnvironmentBakeReport:m}=await import('./environment-bake-5P4IAL4O.js'),{findProjectRoot:M}=await import('./status-76TXXSRT.js'),l=b("--root")??await M(),S=$("--size"),x=b("--output"),h=$("--timeout"),k=C("baking the room environment on the GPU"),R;try{R=await d({root:l,...S===void 0?{}:{size:S},...x===void 0?{}:{output:x},...h===void 0?{}:{timeoutMs:h},compression:n.includes("--no-zstd")?"none":"zstd",headed:n.includes("--headed")});}finally{k.stop();}a.stdout.write(`${w?JSON.stringify(R,null,2):m(R)}
-`);return}if(y==="shaders"){let{findShaderProjectRoot:d}=await import('./shader-config-BYBJUL3C.js'),m=E??"status";if(!["status","capture","test","watch"].includes(m))throw new Error(`Unsupported shader command "${m}".`);let M=b("--root"),l=await d(M),S=b("--driver");if(S!==void 0&&S!=="vite"&&S!=="static")throw new Error('--driver must be "vite" or "static".');let x=S,h=b("--serve"),k=b("--url");if(m==="status"){let{inspectShaderMatrix:g}=await import('./shader-workflow-AAH3FM4U.js'),{formatShaderMatrixStatus:W}=await import('./status-76TXXSRT.js'),v=await g(l);a.stdout.write(`${w?JSON.stringify(v,null,2):W(v)}
-`),(n.includes("--check")||E===void 0)&&v.state!=="fresh"&&(a.exitCode=1);return}if(m==="capture"){let{captureShaders:g}=await import('./shader-workflow-AAH3FM4U.js'),{applyShaderAutoWire:W,hasRegisterDevtoolsCall:v,inspectShaderAutoWire:U}=await import('./shader-autowire-DCODBFMX.js'),{buildShaderCaptureProject:j,startNextShaderCaptureServer:I}=await import('./shader-project-runner-GUR3LTYS.js'),{inferShaderCaptureTarget:P}=await import('./shader-config-BYBJUL3C.js'),T=x,B=h,J=k,D,O,z;try{if(T===void 0&&B===void 0&&J===void 0){let o=await U(l);if(!o.configured&&o.plan!==void 0){if(!await ce(o.plan.diff))throw new Error("Adapter wiring was declined; no files were changed.");await W(o.plan);}else if(!o.configured&&o.bundler!=="vite"&&o.bundler!=="unknown")throw new Error(`${o.reason} No files were changed.`);if(o.bundler==="next")O=C("starting the project-local Next.js capture server"),D=await I(l),J=D.url,O.update("capturing shader scenes");else if(o.bundler==="webpack"||o.bundler==="esbuild"||o.bundler==="rollup"){O=C(`building the ${o.bundler} capture target`),await j(l);let N=await P(l);if(N.driverKind!=="static"||N.serve===void 0)throw new Error(`${o.bundler} build completed but no dist/, build/, or out/index.html was found; pass --driver static --serve <directory>.`);T="static",B=N.serve,O.update("capturing shader scenes");}}O??=C("capturing shader scenes"),z=await g({root:l,headed:n.includes("--headed"),ifStale:n.includes("--if-stale"),commitTiming:n.includes("--commit-timing"),...T===void 0?{}:{driverKind:T},...B===void 0?{}:{serve:B},...J===void 0?{}:{url:J},onSceneStart:a$1((o,N,K)=>O?.update(`capturing ${b$1.accent(o)} ${b$1.dim(`(${N+1}/${K})`)}`),"onSceneStart"),onSceneRetry:a$1((o,N,K,re,V)=>{let ae=V instanceof Error&&/timed out/iu.test(V.message),ne=`capture attempt ${N}/${K} for "${o}" after ${ae?`timeout (${Math.round(re/1e3)} s burned)`:`failure (${V instanceof Error?V.message:String(V)})`}`;a.stderr.write(w?`${JSON.stringify({type:"shader-capture-retry",scene:o,attempt:N,total:K,timeoutMs:re,message:ne})}
+`),v.passed||(a.exitCode=1);return}if(y==="environment"){if(E!=="bake")throw new Error(`Unsupported environment command "${E??""}".`);let{bakeRoomEnvironment:d,formatEnvironmentBakeReport:m}=await import('./environment-bake-5P4IAL4O.js'),{findProjectRoot:M}=await import('./status-J53T3G3P.js'),l=b("--root")??await M(),S=$("--size"),x=b("--output"),h=$("--timeout"),k=C("baking the room environment on the GPU"),R;try{R=await d({root:l,...S===void 0?{}:{size:S},...x===void 0?{}:{output:x},...h===void 0?{}:{timeoutMs:h},compression:n.includes("--no-zstd")?"none":"zstd",headed:n.includes("--headed")});}finally{k.stop();}a.stdout.write(`${w?JSON.stringify(R,null,2):m(R)}
+`);return}if(y==="shaders"){let{findShaderProjectRoot:d}=await import('./shader-config-BYBJUL3C.js'),m=E??"status";if(!["status","capture","test","watch"].includes(m))throw new Error(`Unsupported shader command "${m}".`);let M=b("--root"),l=await d(M),S=b("--driver");if(S!==void 0&&S!=="vite"&&S!=="static")throw new Error('--driver must be "vite" or "static".');let x=S,h=b("--serve"),k=b("--url");if(m==="status"){let{inspectShaderMatrix:g}=await import('./shader-workflow-TVW3WMIP.js'),{formatShaderMatrixStatus:W}=await import('./status-J53T3G3P.js'),v=await g(l);a.stdout.write(`${w?JSON.stringify(v,null,2):W(v)}
+`),(n.includes("--check")||E===void 0)&&v.state!=="fresh"&&(a.exitCode=1);return}if(m==="capture"){let{captureShaders:g}=await import('./shader-workflow-TVW3WMIP.js'),{applyShaderAutoWire:W,hasRegisterDevtoolsCall:v,inspectShaderAutoWire:U}=await import('./shader-autowire-DCODBFMX.js'),{buildShaderCaptureProject:j,startNextShaderCaptureServer:I}=await import('./shader-project-runner-GUR3LTYS.js'),{inferShaderCaptureTarget:P}=await import('./shader-config-BYBJUL3C.js'),T=x,B=h,J=k,D,O,z;try{if(T===void 0&&B===void 0&&J===void 0){let o=await U(l);if(!o.configured&&o.plan!==void 0){if(!await ce(o.plan.diff))throw new Error("Adapter wiring was declined; no files were changed.");await W(o.plan);}else if(!o.configured&&o.bundler!=="vite"&&o.bundler!=="unknown")throw new Error(`${o.reason} No files were changed.`);if(o.bundler==="next")O=C("starting the project-local Next.js capture server"),D=await I(l),J=D.url,O.update("capturing shader scenes");else if(o.bundler==="webpack"||o.bundler==="esbuild"||o.bundler==="rollup"){O=C(`building the ${o.bundler} capture target`),await j(l);let N=await P(l);if(N.driverKind!=="static"||N.serve===void 0)throw new Error(`${o.bundler} build completed but no dist/, build/, or out/index.html was found; pass --driver static --serve <directory>.`);T="static",B=N.serve,O.update("capturing shader scenes");}}O??=C("capturing shader scenes"),z=await g({root:l,headed:n.includes("--headed"),ifStale:n.includes("--if-stale"),commitTiming:n.includes("--commit-timing"),...T===void 0?{}:{driverKind:T},...B===void 0?{}:{serve:B},...J===void 0?{}:{url:J},onSceneStart:a$1((o,N,K)=>O?.update(`capturing ${b$1.accent(o)} ${b$1.dim(`(${N+1}/${K})`)}`),"onSceneStart"),onSceneRetry:a$1((o,N,K,re,V)=>{let ae=V instanceof Error&&/timed out/iu.test(V.message),ne=`capture attempt ${N}/${K} for "${o}" after ${ae?`timeout (${Math.round(re/1e3)} s burned)`:`failure (${V instanceof Error?V.message:String(V)})`}`;a.stderr.write(w?`${JSON.stringify({type:"shader-capture-retry",scene:o,attempt:N,total:K,timeoutMs:re,message:ne})}
 `:`${ne}
 `);},"onSceneRetry")});}finally{O?.stop(),await D?.close();}if(a.stdout.write(`${w?JSON.stringify(z,null,2):oe(z)}
 `),!await v(l)){let o="Add registerDevtools({ renderer }) from three-blocks/devtools so committed shader artifacts hydrate in development and production.";a.stderr.write(w?`${JSON.stringify({type:"shader-runtime-registration",state:"missing",message:o})}
 `:`${c.warn} ${o}
-`);}return}if(m==="test"){let g=b("--mode");if(g!==void 0&&g!=="strict")throw new Error('--mode currently supports only "strict".');let{testShaders:W}=await import('./shader-workflow-AAH3FM4U.js'),v=C("verifying precompiled shaders against the live baseline"),U=$("--runs"),j;try{j=await W({root:l,headed:n.includes("--headed"),skipBrowser:n.includes("--skip-browser"),...x===void 0?{}:{driverKind:x},...h===void 0?{}:{serve:h},...k===void 0?{}:{url:k},...U===void 0?{}:{runs:U},parityOnly:n.includes("--parity-only"),commitTiming:n.includes("--commit-timing"),onSceneStart:a$1((I,P,T)=>v.update(`verifying ${b$1.accent(I)} ${b$1.dim(`(${P+1}/${T})`)}`),"onSceneStart")});}finally{v.stop();}a.stdout.write(`${w?JSON.stringify(j,null,2):fe(j)}
-`);return}let R=$("--debounce"),{watchShaders:_}=await import('./shader-watch-EI5D7GCN.js'),q=new AbortController;a.once("SIGINT",()=>q.abort()),a.once("SIGTERM",()=>q.abort());let L=await _({root:l,headed:n.includes("--headed"),...x===void 0?{}:{driverKind:x},...h===void 0?{}:{serve:h},...k===void 0?{}:{url:k},...R===void 0?{}:{debounceMs:R},signal:q.signal,onResult(g){a.stdout.write(`${w?JSON.stringify(g):oe(g)}
+`);}return}if(m==="test"){let g=b("--mode");if(g!==void 0&&g!=="strict")throw new Error('--mode currently supports only "strict".');let{testShaders:W}=await import('./shader-workflow-TVW3WMIP.js'),v=C("verifying precompiled shaders against the live baseline"),U=$("--runs"),j;try{j=await W({root:l,headed:n.includes("--headed"),skipBrowser:n.includes("--skip-browser"),...x===void 0?{}:{driverKind:x},...h===void 0?{}:{serve:h},...k===void 0?{}:{url:k},...U===void 0?{}:{runs:U},parityOnly:n.includes("--parity-only"),commitTiming:n.includes("--commit-timing"),onSceneStart:a$1((I,P,T)=>v.update(`verifying ${b$1.accent(I)} ${b$1.dim(`(${P+1}/${T})`)}`),"onSceneStart")});}finally{v.stop();}a.stdout.write(`${w?JSON.stringify(j,null,2):fe(j)}
+`);return}let R=$("--debounce"),{watchShaders:_}=await import('./shader-watch-TLLBKLCE.js'),q=new AbortController;a.once("SIGINT",()=>q.abort()),a.once("SIGTERM",()=>q.abort());let L=await _({root:l,headed:n.includes("--headed"),...x===void 0?{}:{driverKind:x},...h===void 0?{}:{serve:h},...k===void 0?{}:{url:k},...R===void 0?{}:{debounceMs:R},signal:q.signal,onResult(g){a.stdout.write(`${w?JSON.stringify(g):oe(g)}
 `);},onError(g){a.stderr.write(`${w?JSON.stringify({error:g.message}):`${c.cross} ${b$1.danger(g.message)}`}
-`);}});w||f(A(c.ring,"watching",b$1.dim(L.root))),await L.done;return}if(y==="text"&&E&&E!=="status"){if(E!=="generate")throw new Error(`Unsupported text command "${E}".`);let{generateTextAtlases:d$1}=await import('./text-atlas-BHPSDU7C.js'),{findProjectRoot:m}=await import('./status-76TXXSRT.js'),M=n.indexOf("--config"),l=M===-1?"three-blocks.text.ts":n[M+1];if(l===void 0||l.startsWith("--"))throw new Error("--config requires a project-relative path.");let S=await m(),x=C("generating MSDF text atlases"),h;try{h=await d$1(S,l);}finally{x.stop();}if(w)a.stdout.write(`${JSON.stringify(h,null,2)}
-`);else {f(A(c.tick,"text",`${h.glyphs} glyphs ${c.dot} ${h.atlases.length} atlas${h.atlases.length===1?"":"es"} regenerated`));for(let k of h.updatedFiles)f(`  ${d(b$1.dim("updated"),12)} ${b$1.dim(k)}`);}return}if(!["status","text"].includes(y))throw new Error(`Unknown command "${y}".`);let{formatThreeBlocksStatus:e,inspectThreeBlocksStatus:t,threeBlocksStatusIsFresh:i}=await import('./status-76TXXSRT.js'),r=await t(),c$1=(r.text);if(y==="text"&&!c$1)throw new Error("This project does not enable the text feature.");let f$1=y==="text"?c$1:r;a.stdout.write(`${w?JSON.stringify(f$1,null,2):y==="status"?e(r):JSON.stringify(f$1,null,2)}
+`);}});w||f(A(c.ring,"watching",b$1.dim(L.root))),await L.done;return}if(y==="text"&&E&&E!=="status"){if(E!=="generate")throw new Error(`Unsupported text command "${E}".`);let{generateTextAtlases:d$1}=await import('./text-atlas-BHPSDU7C.js'),{findProjectRoot:m}=await import('./status-J53T3G3P.js'),M=n.indexOf("--config"),l=M===-1?"three-blocks.text.ts":n[M+1];if(l===void 0||l.startsWith("--"))throw new Error("--config requires a project-relative path.");let S=await m(),x=C("generating MSDF text atlases"),h;try{h=await d$1(S,l);}finally{x.stop();}if(w)a.stdout.write(`${JSON.stringify(h,null,2)}
+`);else {f(A(c.tick,"text",`${h.glyphs} glyphs ${c.dot} ${h.atlases.length} atlas${h.atlases.length===1?"":"es"} regenerated`));for(let k of h.updatedFiles)f(`  ${d(b$1.dim("updated"),12)} ${b$1.dim(k)}`);}return}if(!["status","text"].includes(y))throw new Error(`Unknown command "${y}".`);let{formatThreeBlocksStatus:e,inspectThreeBlocksStatus:t,threeBlocksStatusIsFresh:i}=await import('./status-J53T3G3P.js'),r=await t(),c$1=(r.text);if(y==="text"&&!c$1)throw new Error("This project does not enable the text feature.");let f$1=y==="text"?c$1:r;a.stdout.write(`${w?JSON.stringify(f$1,null,2):y==="status"?e(r):JSON.stringify(f$1,null,2)}
 `),y==="status"&&n.includes("--check")&&!i(r)&&(a.exitCode=1);}a$1(he,"main");he().catch(e=>{let t=e instanceof Error?e.message:String(e);w?a.stderr.write(`${JSON.stringify({error:t})}
 `):a.stderr.write(`${c.cross} ${b$1.danger(t)}
 `),a.exitCode=1;});

package/dist/index.d.ts

@@ -247,7 +247,7 @@ declare function ensureShaderToolConfig(root: string): Promise<EnsuredShaderTool
 /** Published devtools protocol/package version. Kept dependency-free for instant CLI startup. */
 declare const SHADER_DEVTOOLS_VERSION: "0.1.0";
 
-declare const SHADER_PROVIDER_TRANSFORM_VERSION: 52;
+declare const SHADER_PROVIDER_TRANSFORM_VERSION: 53;
 declare const SHADER_LOCAL_TIMING_FILE: "timing.local.json";
 declare const SHADER_COMMITTED_TIMING_FILE: "timing.json";
 declare const SHADER_PARITY_EVIDENCE_FILE: "parity.json";