@three-blocks/devtools 1.0.0-alpha.176.g8ff8a72e6369 → 1.0.0-alpha.190.g3ffe5c0ecc9c

package/dist/chunk-54BHFG2E.js

@@ -0,0 +1,76 @@
+import {d,a as a$1,T as T$1,v as v$1,U,x,Q,m,l,h,g,O}from'./chunk-ZKXUYNSG.js';import {a}from'./chunk-EI7MMDWY.js';import v from'process';import {createServer}from'http';import {createRequire}from'module';import {mkdtemp,rm,lstat,realpath}from'fs/promises';import T 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 Z(r=v.env,e=v.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(Z,"webgpuBrowserArgs");function ee(r=false,e=v.env){return r!==true&&e.THREE_BLOCKS_SOFTWARE_WEBGPU!=="1"}a(ee,"webgpuBrowserHeadless");var te="three-blocks.shader-capture.runtime.v1";var ce="/__three-blocks/shaders/capture",M="/__three-blocks/shaders/telemetry",le="/__three-blocks/shaders/runtime.js",ue="/__three-blocks/shaders/bootstrap.js",he="/__three-blocks/shaders/bridge.js",me=d.manifest*2,K=/^[a-z0-9][a-z0-9_-]{0,63}$/u,fe=64,pe=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(T.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 W=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,a)=>{let i=setTimeout(()=>{this.#e.delete(e),a(new Error(`Shader capture "${e}" timed out after ${t}ms.`));},t);this.#e.set(e,{resolve:o,reject:a,timer:i});})}receive(e){if(!a$1(e)||typeof e.scene!="string"||!K.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>=fe)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 je(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(je,"waitForShaderCaptureAcrossNavigation");var q=class{static{a(this,"TelemetryHub");}#e=new Map;#t=new Map;markFirstRequest(e){K.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"||!K.test(e.scene))throw new Error("Shader telemetry has no bounded scene key.");if(!this.#e.has(e.scene)&&this.#e.size>=fe)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);}},Le=a(async(r,e,t,n,o)=>{let a=0;for(;r.__threeBlocksParityUsesAnimationLoop!==true&&a<e;)await n(),a+=1;if(r.__threeBlocksParityUsesAnimationLoop===true){let i=Number(r.__threeBlocksParityCompletedFrame||0),s=Number(t),l=Number.isSafeInteger(s)&&s>=i?s:i+e;for(r.__threeBlocksParityTargetFrame=l;Number(r.__threeBlocksParityCompletedFrame||0)<l;)await n();}return await o(),Number(r.__threeBlocksParityCompletedFrame||0)},"settleShaderParityFrames");function G(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, injected: 0, injectedRender: 0, injectedCompute: 0, missed: 0, missedRender: 0, missedCompute: 0, missedKeys: [] };
+  const settleParityFrames = ${Le.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}, 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(G,"publicBridgeScript");function we(r,e,t,n,o=false){let a=new URL(r.url??"/","http://three-blocks.invalid"),i=a.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===M&&r.method==="GET"){let u=a.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 s=i===ce,l=i===M;if(!s&&!l)return  false;if(r.method!=="POST")return e.statusCode=405,e.end("POST required"),true;let h=[],p=0,w=false;return r.on("data",u=>{p+=u.byteLength,p>me?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"));l?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(we,"handleCaptureEndpoint");function Ae(r,e,t,n){return {name:"three-blocks:shader-capture-endpoint",transformIndexHtml(){return [{tag:"script",children:G(n),injectTo:"head-prepend"}]},configureServer(o){o.middlewares.use((a,i,s)=>{let h=new URL(a.url??"/","http://three-blocks.invalid").searchParams.get("captureId");h!==null&&e.markFirstRequest(h),!we(a,i,r,e,t)&&s();});}}}a(Ae,"captureEndpointPlugin");function ne(r,e,t){let n=new URL(e.url,r);for(let[o,a]of Object.entries(t))n.searchParams.set(o,a);return n.href}a(ne,"browserUrl");function Fe(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(Fe,"publishedBrowserUrl");function oe(r){return Be.some(e=>e.test(r))}a(oe,"knownNoise");async function P(r){let e;try{await Promise.race([r(),new Promise(t=>{e=setTimeout(t,pe);})]);}catch{}finally{e&&clearTimeout(e);}}a(P,"closeBrowserResource");async function ae(r){let e;try{return await Promise.race([r().catch(()=>null),new Promise(t=>{e=setTimeout(()=>t(null),pe);})])}finally{e!==void 0&&clearTimeout(e);}}a(ae,"readPageDiagnostic");function H(r){let e=a(()=>{},"resolveFirst"),t=new Promise(i=>{e=i;}),n={console:[],page:[],first:t},o=false,a$1=a(i=>{o||(o=true,e(new Error(i)));},"report");return r.on("console",i=>{let s=i.type()==="warning"&&/\[three-blocks\/shaders\].*(?:has no entry|manifest miss|hydration)/iu.test(i.text());if(i.type()!=="error"&&!s||oe(i.text()))return;let l=i.location().url,h=l.length>0?`${i.text()} (${l})`:i.text();n.console.push(h),a$1(`Browser console ${s?"warning":"error"}: ${h}`);}),r.on("pageerror",i=>{if(oe(i.message))return;let s=i.stack||i.message;n.page.push(s),a$1(`Browser page error: ${s}`);}),r.on("crash",()=>a$1("Browser page crashed before shader capture completed.")),r.on("close",()=>a$1("Browser page closed before shader capture completed.")),n}a(H,"collectErrors");function _(r,e,t=false){return typeof r[e]=="boolean"?r[e]:t}a(_,"booleanField");function De(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),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(De,"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 a=r.readiness;if(!a$1(a))throw new Error("The shader bridge readiness snapshot is invalid.");let i={workerReady:_(a,"workerReady"),assetsReady:_(a,"assetsReady"),textReady:e.requiresText?_(a,"textReady"):true,compileEnd:_(a,"compileEnd"),firstFrame:_(a,"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 s=t?o:r.compatibility,l=t?x:r.transform;if(s!==o||l!==x)throw new Error(`Scene "${e.key}" exposed incompatible shader bridge metadata.`);return U(n),{compatibility:o,transform:l,readiness:i,stats:De(r.stats)}}a(A,"parseBridge");async function F(r,e){return r.evaluate(t=>{let n=globalThis;if(!t)return n.__threeBlocksShaderTools??null;let o=n.__threeBlocks,a=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:a}},e)}a(F,"readBridge");async function D(r,e,t,n){return r.evaluate(async o=>{let i=globalThis.__threeBlocksShaderTools;if(i&&typeof i=="object"){let h=Reflect.get(i,"settle");if(typeof h=="function"){let p=await h(o.frames,o.targetFrame);return typeof p=="number"&&Number.isSafeInteger(p)?p:0}}if(!o.legacy||!o.modulePath)throw new Error("The public shader bridge does not provide deterministic settle().");let s=await import(o.modulePath);if(!s.store||typeof s.store!="object")throw new Error("Legacy deterministic store is unavailable.");let l=s.store;return l.recordFrameCount=0,l.recordFrameRate=60,l.recordTotalFrames=o.frames,l.recording=true,await new Promise((h,p)=>{let w=Date.now(),u=a(()=>{if(l.recording===false)return h();if(Date.now()-w>o.timeoutMs)return p(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})}a(D,"settlePage");async function ie(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 a=o;for(let l of n.global.split(".")){if((typeof a!="object"||a===null)&&typeof a!="function")return  false;a=Reflect.get(a,l);}if(a===true)return  true;if(typeof a!="object"||a===null||typeof Reflect.get(a,"then")!="function")return  false;let i=o.__threeBlocksReadinessState,s=i instanceof Map?i:new Map;return i instanceof Map||(o.__threeBlocksReadinessState=s),s.has(a)||(s.set(a,false),Promise.resolve(a).then(()=>s.set(a,true),()=>s.set(a,false))),s.get(a)===true},e.readiness,{timeout:e.timeoutMs}),t.first.then(n=>Promise.reject(n))]);}a(ie,"waitForConfiguredReadiness");async function se(r){let e=r.locator("canvas"),n=(await e.evaluateAll(o=>o.map((a,i)=>{let s=a.getBoundingClientRect();return {index:i,area:Math.max(0,s.width)*Math.max(0,s.height)}}))).sort((o,a)=>a.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(se,"primaryCanvasScreenshot");async function V(r,e,t,n,o,a){let i=ge(n,o),s=await Q(),l=`(() => {
+  const runtime = globalThis[Symbol.for(${JSON.stringify(te)})];
+  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:`${s}
+${l}`}),await r.addInitScript({content:G(a)}),await r.route("**/*",async h=>{let p=h.request(),w=new URL(p.url()),u=w.pathname;if(p.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===M&&p.method()==="GET"){let f=t.read(w.searchParams.get("scene")??"");await h.fulfill(f===void 0?{status:204}:{status:200,contentType:"application/json",body:JSON.stringify(f)});return}let m=u===ce,c=u===M;if((m||c)&&p.method()==="POST"){let f=p.postDataBuffer()??Buffer.alloc(0);if(f.byteLength>me){await h.fulfill({status:413,body:"capture payload too large"});return}try{let g=JSON.parse(f.toString("utf8"));c?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(V,"configureAttachedContext");var Me=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="${he}"></script>`,`<script type="module" src="${ue}"></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(le)};`,`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}}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,a;for(let i of t){let s=(await l(r,i,d.texture,"Static application JavaScript")).data.toString("utf8");if(s.includes("nodeBuilderStateProvider")&&(n=true),s.includes("three-blocks.shader-capture.runtime.v1")&&(o=true,a??=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,...a===void 0?{}:{id:a}}}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=T.resolve(r,n.length===0?"index.html":n);if(!h(r,o)||o===r||(await g(o)&&(await lstat(o)).isDirectory()&&(o=T.join(o,"index.html")),!await g(o)&&T.extname(o).length===0&&(o=T.join(r,"index.html")),!await g(o)))return;let a=await l(r,o,d.texture,"Static application asset");return {data:a.data,file:a.path}}a($e,"staticRequestFile");async function He(r,e,t,n,o){let a=await realpath(r.root),i=await realpath(T.resolve(a,r.serve));if(!h(a,i)||i===a)throw new Error("--serve must name a built application directory inside the project root.");let s=await Ue(a,i),l=await O(),h$1=Ie(e,t),p=G(v$1(r.runtime.three)),w=createServer((m,c)=>{(async()=>{if(we(m,c,n,o,e!=="precompiled"))return;let f=new URL(m.url??"/","http://three-blocks.invalid");if(m.method!=="GET"&&m.method!=="HEAD"){c.statusCode=405,c.end("GET or HEAD required");return}let g=f.pathname===le?l:f.pathname===ue?h$1:f.pathname===he?p:void 0;if(g!==void 0){c.statusCode=200,c.setHeader("Content-Type","text/javascript; charset=utf-8"),c.setHeader("Cache-Control","no-store"),c.end(m.method==="HEAD"?void 0:g);return}let y=await $e(i,f.pathname);if(y===void 0){c.statusCode=404,c.end("Not found");return}let S=T.extname(y.file).toLowerCase(),x=S===".html"?Buffer.from(Ne(y.data.toString("utf8"))):y.data;c.statusCode=200,c.setHeader("Content-Type",Me[S]??"application/octet-stream"),c.setHeader("Content-Length",String(x.byteLength)),c.setHeader("Cache-Control","no-store"),c.end(m.method==="HEAD"?void 0:x);})().catch(f=>{if(c.headersSent)return c.destroy(f instanceof Error?f:void 0);c.statusCode=500,c.end(f instanceof Error?f.message:String(f));});});await new Promise((m,c)=>{w.once("error",c),w.listen(0,"127.0.0.1",()=>{w.off("error",c),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:s}}a(He,"startStaticShaderServer");function Ve(r,e,t){return r===e?true:t&&r!==void 0&&r!=="capture"&&e!=="capture"}a(Ve,"canReuseShaderBrowserSession");function de(r){let e=r instanceof Error?r.message:String(r);return e.includes("Execution context was destroyed")&&e.includes("navigation")}a(de,"isRetryableShaderObservationNavigation");var B=class{static{a(this,"PlaywrightShaderDriver");}#e;#t=new W;#n=new q;#u;#h;#a;#i;#r;#o;#m;#d;#f;#c=0;#l;constructor(e){this.#e=e;}#s(){return this.#u?.status??this.#h??{seen:false,applied:false,alreadyPresent:false}}async#p(e){if(this.#r?.isConnected()===true)return;this.#r=void 0;let t=await xe();this.#l??=await mkdtemp(T.join(tmpdir(),"three-blocks-shader-cache-")),this.#r=await t.launch({headless:ee(this.#e.headed===true),args:[...Z(),`--disk-cache-dir=${this.#l}`],timeout:e.timeoutMs}),this.#c=0;}async#w(e,t){let n=this.#a!==void 0||this.#i!==void 0||this.#e.url!==void 0&&this.#o!==void 0,o=this.#i!==void 0?this.#d===e:Ve(this.#d,e,t.bridge.legacyLab);if(n&&o){this.#d=e,await this.#p(t);return}if(n&&await this.close(),this.#d=e,this.#e.url!==void 0){let a=new URL(this.#e.url);if(!["http:","https:"].includes(a.protocol)||a.username||a.password||a.hash)throw new Error("Attached shader URL must be an HTTP(S) URL without credentials or a fragment.");this.#o=a.href,this.#h={seen:true,applied:true,alreadyPresent:false,captureApplied:true,id:"attached-application"},await this.#p(t);return}if(this.#e.serve!==void 0)try{let a=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.#i=a.server,this.#h=a.transform,this.#o=a.baseUrl,await this.#p(t);return}catch(a){throw await this.close(),a}this.#u=T$1(this.#e.runtime.three,{disableTimestampQueries:v.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.#m={THREE_BLOCKS_SHADER_TOOL:v.env.THREE_BLOCKS_SHADER_TOOL,THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER:v.env.THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER},v.env.THREE_BLOCKS_SHADER_TOOL="1",v.env.THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER="1";try{let a=await Oe(this.#e.root);this.#a=await a({root:this.#e.root,logLevel:"error",plugins:[this.#u.plugin,Ae(this.#t,this.#n,e!=="precompiled",v$1(this.#e.runtime.three))],server:{host:"127.0.0.1",port:0}}),await this.#a.listen();let i=this.#a.httpServer?.address();if(!i||typeof i=="string")throw new Error("Vite did not expose an ephemeral TCP address.");this.#o=`http://127.0.0.1:${i.port}`,await this.#p(t);}catch(a){throw await this.close(),a}}async capture(e,t){let n=Date.now();if(await this.#w("capture",t),!this.#r||!this.#o)throw new Error("Shader browser driver did not start.");let o=this.#r,a$2=await o.newContext({viewport:t.viewport});this.#e.url!==void 0&&await V(a$2,this.#t,this.#n,"capture",t,v$1(this.#e.runtime.three));let i=await a$2.newPage(),s=H(i);this.#n.clear(e.key);let l=this.#t.wait(e.key,t.timeoutMs),h=Promise.race([l,s.first.then(m=>Promise.reject(m))]),p=a(()=>{},"resolveDisconnected"),w=new Promise(m=>{p=m;}),u=a(()=>p(new Error("Shader capture browser disconnected before posting a manifest.")),"onDisconnected");o.on("disconnected",u);try{let m=i.goto(ne(this.#o,e,{threeBlocksShaderCapture:"1",capture:"1",captureId:e.key,captureFrames:String(Math.max(4,t.settleFrames)),settleFrames:String(t.settleFrames)}),{waitUntil:"domcontentloaded",timeout:t.timeoutMs}),c=await je(m,Promise.race([h,w.then(g=>Promise.reject(g))]));U(this.#s());let f=[...s.page,...s.console];if(f.length>0)throw new Error(`Capture browser errors:
+ - ${f.join(`
+ - `)}`);return a$1(c)?{...c,timing:{...a$1(c.timing)?c.timing:{},launch:n,...this.#n.firstRequest(e.key)===void 0?{}:{firstRequest:this.#n.firstRequest(e.key)},posted:Date.now()}}:c}catch(m){let c=m instanceof Error?m:new Error(String(m));this.#t.cancel(e.key,c),await l.catch(()=>{});let f=this.#n.read(e.key);if(c.message.includes("timed out")){let g=await ae(()=>i.evaluate(()=>{let y=globalThis,S=y.__threeBlocksShaderTools,x=S&&typeof S=="object"?S:void 0,ye=y.document,R=Reflect.get(y,Symbol.for("three-blocks.shader-capture.cache-value.v1")),O=y.location,Se=O!==null&&typeof O=="object"&&typeof Reflect.get(O,"href")=="string"?String(Reflect.get(O,"href")):"http://three-blocks.invalid/",be=new URL(Se).searchParams.get("captureId")??"default",J=R!==null&&typeof R=="object"&&typeof Reflect.get(R,"registrations")=="function"?Reflect.apply(Reflect.get(R,"registrations"),R,[be]):void 0;return {documentReadyState:ye?.readyState??null,parityTargetFrame:Number(y.__threeBlocksParityTargetFrame??0),parityCompletedFrame:Number(y.__threeBlocksParityCompletedFrame??0),readiness:x?.readiness??null,captureCache:R!==null&&typeof R=="object"?{activeScene:Reflect.get(R,"activeScene")??null,registrations:Array.isArray(J)?J.slice(0,16).map(k=>k!==null&&typeof k=="object"?{key:Reflect.get(k,"key")??null,kind:Reflect.get(k,"kind")??null}:null):null}:null,threeRuntimeResources:performance.getEntriesByType("resource").map(k=>k.name).filter(k=>k.includes("three.webgpu"))}}));throw new Error(`${c.message} Last capture state for "${e.key}": ${JSON.stringify({page:g,telemetry:f??null,transform:this.#s()})}`)}throw c}finally{o.off("disconnected",u),await P(()=>a$2.close()),this.#c++,(!o.isConnected()||this.#c>=(t.browserRelaunchScenes??8))&&(this.#r===o&&(this.#r=void 0),await P(()=>o.close()),this.#c=0);}}async observe(e,t,n,o){for(let a=0;a<2;a++)try{return await this.#g(e,t,n,o)}catch(i){if(a===0&&de(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.#w(t,n),!this.#r||!this.#o)throw new Error("Shader browser driver did not start.");let a=await this.#r.newContext({viewport:n.viewport});this.#e.url!==void 0&&await V(a,this.#t,this.#n,t,n,v$1(this.#e.runtime.three));let i=await a.newPage(),s=H(i);this.#n.clear(e.key);try{await i.goto(ne(this.#o,e,{threeBlocksShaderCapture:"1",threeBlocksShaderMode:t,captureId:e.key,...t==="live"?{precompiled:"0"}:{}}),{waitUntil:"domcontentloaded",timeout:n.timeoutMs}),await Promise.race([i.waitForFunction(n.bridge.legacyLab?"globalThis.__threeBlocks?.compileEnd === true":"globalThis.__threeBlocksShaderTools?.readiness?.compileEnd === true",void 0,{timeout:n.timeoutMs}),s.first.then(u=>Promise.reject(u))]),A(await F(i,n.bridge.legacyLab),e,n.bridge.legacyLab,this.#s(),v$1(this.#e.runtime.three)),await ie(i,n,s);let l=e.parityFrames??n.parity.frames,h=await D(i,n,l,o),p=Buffer.from(await i.screenshot({type:"png"}));e.parityFrames!==void 0&&l<n.parity.frames&&await D(i,n,n.parity.frames-l);let w=A(await F(i,n.bridge.legacyLab),e,n.bridge.legacyLab,this.#s(),v$1(this.#e.runtime.three));return this.#f===void 0&&(this.#f=await i.evaluate(async()=>{let u=Reflect.get(navigator,"gpu"),m=typeof u=="object"&&u!==null?Reflect.get(u,"requestAdapter"):void 0,c=typeof m=="function"?await Reflect.apply(m,u,[]):void 0,f=typeof c=="object"&&c!==null?Reflect.get(c,"info"):void 0,g=["description","device","architecture","vendor"].flatMap(y=>{let S=typeof f=="object"&&f!==null?Reflect.get(f,y):void 0;return typeof S=="string"&&S.length>0?[S]:[]});return {adapter:[...new Set(g)].join(" \xB7 ")||"WebGPU adapter",platform:navigator.platform||navigator.userAgent}})),{scene:e.key,mode:t,...w,frame:h,screenshot:p,errors:[...s.page,...s.console]}}catch(l){let h=l instanceof Error?l:new Error(String(l));if(/(?:timed?\s*out|timeout)/iu.test(h.message)){let p=this.#n.read(e.key),w=await ae(()=>i.evaluate(()=>{let u=globalThis,m=u.__threeBlocksShaderTools,c=m&&typeof m=="object"?m:void 0;return {documentReadyState:u.document?.readyState??null,parityTargetFrame:Number(u.__threeBlocksParityTargetFrame??0),parityCompletedFrame:Number(u.__threeBlocksParityCompletedFrame??0),readiness:c?.readiness??null,threeRuntimeResources:performance.getEntriesByType("resource").map(g=>g.name).filter(g=>g.includes("three.webgpu"))}}));throw new Error(`${h.message} Last ${t} state for "${e.key}": ${JSON.stringify({page:w,telemetry:p??null})}`)}throw h}finally{await P(()=>a.close());}}async observePublished(e,t){for(let n=0;n<2;n++)try{return await this.#y(e,t)}catch(o){if(n===0&&de(o))continue;throw o}throw new Error(`Published shader observation retry was exhausted for scene "${e.key}".`)}async#y(e,t){if(await this.#w("precompiled",t),!this.#r||!this.#o)throw new Error("Shader browser driver did not start.");let n=await this.#r.newContext({viewport:t.viewport});this.#e.url!==void 0&&await V(n,this.#t,this.#n,"precompiled",t,v$1(this.#e.runtime.three));let o=await n.newPage(),a=H(o);this.#n.clear(e.key);try{await o.goto(Fe(this.#o,e),{waitUntil:"domcontentloaded",timeout:t.timeoutMs}),await Promise.race([o.waitForFunction(t.bridge.legacyLab?"globalThis.__threeBlocks?.compileEnd === true":"globalThis.__threeBlocksShaderTools?.readiness?.compileEnd === true",void 0,{timeout:t.timeoutMs}),a.first.then(p=>Promise.reject(p))]),await ie(o,t,a),A(await F(o,t.bridge.legacyLab),e,t.bridge.legacyLab,this.#s(),v$1(this.#e.runtime.three)),await D(o,t,2);let i=await se(o),s=await D(o,t,120),l=await se(o),h=A(await F(o,t.bridge.legacyLab),e,t.bridge.legacyLab,this.#s(),v$1(this.#e.runtime.three));return {scene:e.key,mode:"precompiled",...h,frame:s,beforeScreenshot:i,screenshot:l,errors:[...a.page,...a.console]}}finally{await P(()=>n.close());}}timingEnvironment(){return this.#f??{adapter:"WebGPU adapter",platform:`${v.platform}/${v.arch}`}}async close(){this.#t.rejectAll(new Error("Shader browser driver closed.")),this.#r&&await P(()=>this.#r?.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 P(()=>this.#a?.close()??Promise.resolve()),this.#i){let n=this.#i;n.closeAllConnections(),await P(()=>new Promise(o=>{n.close(()=>o());}));}if(this.#r=void 0,this.#a=void 0,this.#i=void 0,this.#o=void 0,this.#u=void 0,this.#h=void 0,this.#d=void 0,this.#f=void 0,this.#c=0,this.#l!==void 0&&(await rm(this.#l,{recursive:true,force:true}),this.#l=void 0),this.#m){for(let[n,o]of Object.entries(this.#m))o===void 0?delete v.env[n]:v.env[n]=o;this.#m=void 0;}}};function ct(r){return new B(r)}a(ct,"createPlaywrightShaderDriver");function lt(r){return new B(r)}a(lt,"createStaticPlaywrightShaderDriver");function ut(r){return new B(r)}a(ut,"createAttachedPlaywrightShaderDriver");
+export{ve as a,We as b,Z as c,ee as d,je as e,Le as f,G as g,Ve as h,de as i,ct as j,lt as k,ut as l};

package/dist/{chunk-ZKK6E42X.js → chunk-77HY5X2T.js}

@@ -1 +1 @@
-import {P,Q}from'./chunk-SCJNCGMF.js';import {a}from'./chunk-EI7MMDWY.js';import {existsSync,readFileSync,readFile}from'fs';import {createRequire}from'module';import d from'path';var m="@three-blocks/devtools/webpack-loader";function y(e){if(typeof e=="string")return e===m;if(Array.isArray(e))return e.some(y);if(e===null||typeof e!="object")return  false;let o=e;return o.loader===m||y(o.use)}a(y,"webpackRuleUsesShaderLoader");function T(e){let o=b(process.cwd()),r=a(t=>x(o,t),"exact"),n={...e.resolve?.alias,...r("three")===void 0?{}:{three$:r("three")},...r("three/webgpu")===void 0?{}:{"three/webgpu$":r("three/webgpu")},...r("three/tsl")===void 0?{}:{"three/tsl$":r("three/tsl")},"three/addons":d.join(o.root,"examples/jsm"),"three/examples/jsm":d.join(o.root,"examples/jsm")};return {...e,resolve:{...e.resolve,alias:n}}}a(T,"withTargetThreeAliases");function w(e){let o=T(e),r=o.module?.rules??[];return r.some(y)?o:{...o,module:{...o.module,rules:[...r,{enforce:"pre",test:/three[\\/]build[\\/]three\.webgpu\.js$/u,use:[{loader:m}]}]}}}a(w,"withShaderWebpackRule");function A(e){return w(e)}a(A,"withThreeBlocksWebpack");function B(e){let r=e.webpack;return {...e,webpack(n,...t){let s=r?.call(this,n,...t)??n,i=t[0];return i!==null&&typeof i=="object"&&Reflect.get(i,"isServer")===true?T(s):w(s)}}}a(B,"withThreeBlocksNext");function b(e){let o;try{o=createRequire(d.join(d.resolve(e),"package.json")).resolve("three");}catch(s){throw new Error("The shader adapter could not resolve Three.js from the target project.",{cause:s})}let r=d.dirname(o),n,t;for(;;){let s=d.join(r,"package.json");if(existsSync(s)){let l=JSON.parse(readFileSync(s,"utf8"));if(l.name==="three"){n=s,t=l;break}}let i=d.dirname(r);if(i===r)break;r=i;}if(n===void 0)throw new Error(`The shader adapter could not locate Three.js package metadata from ${o}.`);if(typeof t?.version!="string"||t.version.length===0)throw new Error(`The resolved Three.js package has no version: ${n}`);return {root:d.dirname(n),version:t.version,exports:t.exports}}a(b,"resolveThreePackage");function L(e=process.cwd()){return b(e).version}a(L,"resolveShaderAdapterThreeVersion");function v(e){return {version:e.threeVersion??L(e.root),capture:e.capture??process.env.THREE_BLOCKS_SHADER_TOOL==="1"}}a(v,"resolvedOptions");function _(e,o,r={}){if(!P(o))return null;let n=v(r);return Q(e,n.version,{instrumentCapture:n.capture})}a(_,"transformThreeWebGPUModule");function g(e){if(typeof e=="string")return e;if(Array.isArray(e)){for(let r of e){let n=g(r);if(n!==void 0)return n}return}if(e===null||typeof e!="object")return;let o=e;for(let r of ["browser","import","default"]){let n=g(o[r]);if(n!==void 0)return n}}a(g,"exportTarget");function x(e,o){if(e.exports===null||typeof e.exports!="object")return;let r=e.exports,n=o==="three"?".":`./${o.slice(6)}`,t=g(r[n]);if(t!==void 0)return d.resolve(e.root,t);for(let[s,i]of Object.entries(r)){let l=s.indexOf("*");if(l<0)continue;let c=s.slice(0,l),u=s.slice(l+1);if(!n.startsWith(c)||!n.endsWith(u))continue;let f=n.slice(c.length,n.length-u.length),p=g(i);if(p!==void 0)return d.resolve(e.root,p.replaceAll("*",f))}}a(x,"resolveThreeExport");function $(e={}){let o=e.root??process.cwd(),r=b(o),n={version:e.threeVersion??r.version,capture:e.capture??process.env.THREE_BLOCKS_SHADER_TOOL==="1"};return {name:"three-blocks-shader-provider",setup(t){t.onResolve?.({filter:/^three(?:\/.*)?$/},s=>{let i=x(r,s.path);return i===void 0?void 0:{path:i}}),t.onLoad({filter:/three[\\/]build[\\/]three\.webgpu\.js$/},async s=>{let i=await new Promise((c,u)=>{readFile(s.path,"utf8",(f,p)=>{f?u(f):c(p);});});return {contents:Q(i,n.version,{instrumentCapture:n.capture}).code,loader:"js"}});}}}a($,"createEsbuildShaderPlugin");function H(e={}){let o=v(e);return {name:"three-blocks-shader-provider",enforce:"pre",transform(r,n){return P(n)?{code:Q(r,o.version,{instrumentCapture:o.capture}).code,map:null}:null}}}a(H,"createRollupShaderPlugin");export{m as a,A as b,B as c,L as d,_ as e,$ as f,H as g};
+import {R,S}from'./chunk-ZKXUYNSG.js';import {a}from'./chunk-EI7MMDWY.js';import {existsSync,readFileSync,readFile}from'fs';import {createRequire}from'module';import d from'path';var m="@three-blocks/devtools/webpack-loader";function y(e){if(typeof e=="string")return e===m;if(Array.isArray(e))return e.some(y);if(e===null||typeof e!="object")return  false;let o=e;return o.loader===m||y(o.use)}a(y,"webpackRuleUsesShaderLoader");function T(e){let o=b(process.cwd()),r=a(t=>x(o,t),"exact"),n={...e.resolve?.alias,...r("three")===void 0?{}:{three$:r("three")},...r("three/webgpu")===void 0?{}:{"three/webgpu$":r("three/webgpu")},...r("three/tsl")===void 0?{}:{"three/tsl$":r("three/tsl")},"three/addons":d.join(o.root,"examples/jsm"),"three/examples/jsm":d.join(o.root,"examples/jsm")};return {...e,resolve:{...e.resolve,alias:n}}}a(T,"withTargetThreeAliases");function w(e){let o=T(e),r=o.module?.rules??[];return r.some(y)?o:{...o,module:{...o.module,rules:[...r,{enforce:"pre",test:/three[\\/]build[\\/]three\.webgpu\.js$/u,use:[{loader:m}]}]}}}a(w,"withShaderWebpackRule");function A(e){return w(e)}a(A,"withThreeBlocksWebpack");function B(e){let r=e.webpack;return {...e,webpack(n,...t){let s=r?.call(this,n,...t)??n,i=t[0];return i!==null&&typeof i=="object"&&Reflect.get(i,"isServer")===true?T(s):w(s)}}}a(B,"withThreeBlocksNext");function b(e){let o;try{o=createRequire(d.join(d.resolve(e),"package.json")).resolve("three");}catch(s){throw new Error("The shader adapter could not resolve Three.js from the target project.",{cause:s})}let r=d.dirname(o),n,t;for(;;){let s=d.join(r,"package.json");if(existsSync(s)){let l=JSON.parse(readFileSync(s,"utf8"));if(l.name==="three"){n=s,t=l;break}}let i=d.dirname(r);if(i===r)break;r=i;}if(n===void 0)throw new Error(`The shader adapter could not locate Three.js package metadata from ${o}.`);if(typeof t?.version!="string"||t.version.length===0)throw new Error(`The resolved Three.js package has no version: ${n}`);return {root:d.dirname(n),version:t.version,exports:t.exports}}a(b,"resolveThreePackage");function L(e=process.cwd()){return b(e).version}a(L,"resolveShaderAdapterThreeVersion");function v(e){return {version:e.threeVersion??L(e.root),capture:e.capture??process.env.THREE_BLOCKS_SHADER_TOOL==="1"}}a(v,"resolvedOptions");function _(e,o,r={}){if(!R(o))return null;let n=v(r);return S(e,n.version,{instrumentCapture:n.capture})}a(_,"transformThreeWebGPUModule");function g(e){if(typeof e=="string")return e;if(Array.isArray(e)){for(let r of e){let n=g(r);if(n!==void 0)return n}return}if(e===null||typeof e!="object")return;let o=e;for(let r of ["browser","import","default"]){let n=g(o[r]);if(n!==void 0)return n}}a(g,"exportTarget");function x(e,o){if(e.exports===null||typeof e.exports!="object")return;let r=e.exports,n=o==="three"?".":`./${o.slice(6)}`,t=g(r[n]);if(t!==void 0)return d.resolve(e.root,t);for(let[s,i]of Object.entries(r)){let l=s.indexOf("*");if(l<0)continue;let c=s.slice(0,l),u=s.slice(l+1);if(!n.startsWith(c)||!n.endsWith(u))continue;let f=n.slice(c.length,n.length-u.length),p=g(i);if(p!==void 0)return d.resolve(e.root,p.replaceAll("*",f))}}a(x,"resolveThreeExport");function $(e={}){let o=e.root??process.cwd(),r=b(o),n={version:e.threeVersion??r.version,capture:e.capture??process.env.THREE_BLOCKS_SHADER_TOOL==="1"};return {name:"three-blocks-shader-provider",setup(t){t.onResolve?.({filter:/^three(?:\/.*)?$/},s=>{let i=x(r,s.path);return i===void 0?void 0:{path:i}}),t.onLoad({filter:/three[\\/]build[\\/]three\.webgpu\.js$/},async s=>{let i=await new Promise((c,u)=>{readFile(s.path,"utf8",(f,p)=>{f?u(f):c(p);});});return {contents:S(i,n.version,{instrumentCapture:n.capture}).code,loader:"js"}});}}}a($,"createEsbuildShaderPlugin");function H(e={}){let o=v(e);return {name:"three-blocks-shader-provider",enforce:"pre",transform(r,n){return R(n)?{code:S(r,o.version,{instrumentCapture:o.capture}).code,map:null}:null}}}a(H,"createRollupShaderPlugin");export{m as a,A as b,B as c,L as d,_ as e,$ as f,H as g};

package/dist/chunk-NEWSG5RX.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import {a as a$1,b as b$1}from'./chunk-ZDNZCQUQ.js';import {d as d$1,j as j$1,a as a$2,g}from'./chunk-5L2VS3BN.js';import {a}from'./chunk-HOZDD6PW.js';import {realpath,readFile}from'fs/promises';import d from'path';var b="three-blocks.shaders.json",I=".three-blocks/shaders",O=".three-blocks/shaders/parity",_=/^[a-z0-9][a-z0-9_-]{0,63}$/u,C=/^[A-Za-z_$][A-Za-z0-9_$]*(?:\.[A-Za-z_$][A-Za-z0-9_$]*)*$/u,E=64,R=64,j={schemaVersion:1,scenes:[{key:"default",url:"/"}]};function x(n,r,e){if(n===void 0)return e;if(typeof n!="string"||n.length===0||n.length>512||d.isAbsolute(n)||/[\u0000-\u001f\u007f]/u.test(n))throw new Error(`${r} must be a bounded project-relative directory.`);let i=d.posix.normalize(n.replaceAll("\\","/")).replace(/\/+$/u,"");if(i==="."||i===".."||i.startsWith("../"))throw new Error(`${r} must stay inside the project.`);return i}a(x,"safeProjectDirectory");function A(n,r){let e=x(n,r,"");if(typeof n!="string"||n.endsWith("/"))throw new Error(`${r} must be a project-relative file.`);return e}a(A,"safeProjectFile");function u(n,r,e,i,o){if(n===void 0)return o;if(!Number.isSafeInteger(n)||Number(n)<e||Number(n)>i)throw new Error(`${r} must be an integer in ${e}...${i}.`);return Number(n)}a(u,"boundedInteger");function T(n,r,e){if(n===void 0)return e;if(typeof n!="number"||!Number.isFinite(n)||n<0||n>1)throw new Error(`${r} must be a finite ratio in 0...1.`);return n}a(T,"finiteRatio");function $(n,r){if(typeof n!="string"||n.length===0||n.length>2048||/[\u0000-\u001f\u007f]/u.test(n))throw new Error(`${r} must be a bounded project-relative URL.`);let e;try{e=new URL(n,"http://three-blocks.invalid/");}catch{throw new Error(`${r} is not a valid URL.`)}if(e.origin!=="http://three-blocks.invalid"||e.hash.length>0)throw new Error(`${r} must stay within the project and must not contain a fragment.`);return `${e.pathname}${e.search}`}a($,"safeBrowserUrl");function F(n){if(!Array.isArray(n)||n.length===0||n.length>E)throw new Error(`Shader config scenes must contain 1...${E} entries.`);let r=new Set;return n.map((e,i)=>{if(!a$1(e)||typeof e.key!="string"||!_.test(e.key))throw new Error(`Shader config scene ${i} has an invalid key.`);if(r.has(e.key))throw new Error(`Shader config scene key "${e.key}" is duplicated.`);r.add(e.key);let o=e.parityFrames,t=e.maxDiffRatio;if(e.inputs!==void 0&&(!Array.isArray(e.inputs)||e.inputs.length===0||e.inputs.length>R))throw new Error(`Shader config scene "${e.key}" inputs must contain 1...${R} files.`);let a=e.inputs===void 0?void 0:e.inputs.map((h,l)=>A(h,`Shader config scene "${e.key}" input ${l}`));if(a!==void 0&&new Set(a).size!==a.length)throw new Error(`Shader config scene "${e.key}" inputs must be unique.`);if(e.runtimeMotion!==void 0&&typeof e.runtimeMotion!="boolean")throw new Error(`Shader config scene "${e.key}" runtimeMotion must be a boolean.`);return {key:e.key,url:$(e.url,`Shader config scene "${e.key}" URL`),requiresText:e.requiresText===true,...a===void 0?{}:{inputs:a},...o===void 0?{}:{parityFrames:u(o,`Shader config scene "${e.key}" parityFrames`,0,1e4,0)},...t===void 0?{}:{maxDiffRatio:T(t,`Shader config scene "${e.key}" maxDiffRatio`,.01)},...e.runtimeMotion===true?{runtimeMotion:true}:{}}})}a(F,"parseScenes");function y(n){if(!a$1(n)||n.schemaVersion!==void 0&&n.schemaVersion!==1)throw new Error("Shader config must use schemaVersion 1.");let r=n.viewport;if(r!==void 0&&!a$1(r))throw new Error("Shader config viewport must be an object.");let e=n.parity;if(e!==void 0&&!a$1(e))throw new Error("Shader config parity must be an object.");let i=n.bridge;if(i!==void 0&&!a$1(i))throw new Error("Shader config bridge must be an object.");let o=a$1(i)?i.deterministicModule:void 0;o!==void 0&&$(o,"Shader deterministic module");let t=n.readiness;if(t!==void 0&&!a$1(t))throw new Error("Shader config readiness must be an object.");let a=a$1(t)?t.selector:void 0;if(a!==void 0&&(typeof a!="string"||a.length===0||a.length>512||/[\u0000-\u001f\u007f]/u.test(a)))throw new Error("Shader readiness selector must be a bounded, non-empty CSS selector.");let h=a$1(t)?t.global:void 0;if(h!==void 0&&(typeof h!="string"||!C.test(h)))throw new Error("Shader readiness global must be a dot-separated JavaScript property path.");return {schemaVersion:1,scenes:F(n.scenes),settleFrames:u(n.settleFrames,"Shader settleFrames",0,1e4,60),settleTimeoutMs:u(n.settleTimeoutMs,"Shader settleTimeoutMs",1e3,15*6e4,3e4),browserRelaunchScenes:u(n.browserRelaunchScenes,"Shader browserRelaunchScenes",1,64,8),timeoutMs:u(n.timeoutMs,"Shader timeoutMs",1e3,15*6e4,24e4),viewport:{width:u(a$1(r)?r.width:void 0,"Shader viewport width",64,8192,1024),height:u(a$1(r)?r.height:void 0,"Shader viewport height",64,8192,640)},parity:{frames:u(a$1(e)?e.frames:void 0,"Shader parity frames",0,1e4,90),channelTolerance:u(a$1(e)?e.channelTolerance:void 0,"Shader parity channelTolerance",0,255,8),maxDiffRatio:T(a$1(e)?e.maxDiffRatio:void 0,"Shader parity maxDiffRatio",.01)},bridge:{legacyLab:a$1(i)&&i.legacyLab===true,...typeof o=="string"?{deterministicModule:o}:{}},readiness:{...typeof a=="string"?{selector:a}:{},...typeof h=="string"?{global:h}:{}},publicDir:x(n.publicDir,"Shader publicDir","public"),allowLiveBuilds:n.allowLiveBuilds!==false}}a(y,"parseShaderToolConfig");async function v(n=process.cwd()){let r=d.resolve(n);for(;;){if(await d$1(d.join(r,b))||await d$1(d.join(r,"three-blocks.json")))return realpath(r);let e=d.join(r,"package.json");if(await d$1(e)){let o=await j$1(r,e,a$2.packageJson,"Project package.json"),t;try{t=JSON.parse(o.data.toString("utf8"));}catch{throw new Error(`Project package.json is not valid JSON: ${e}.`)}if(a$1(t)&&[t.dependencies,t.devDependencies,t.peerDependencies,t.optionalDependencies].filter(a$1).some(l=>typeof l.three=="string"||typeof l["three-blocks"]=="string"||typeof l["@three-blocks/devtools"]=="string"))return realpath(r)}let i=d.dirname(r);if(i===r)throw new Error(`No Three Blocks shader project found from ${JSON.stringify(d.resolve(n))}; add Three.js to package.json or pass --root.`);r=i;}}a(v,"findShaderProjectRoot");async function w(n){let r=await realpath(n),e=d.join(r,b);if(await d$1(e)){let o=await j$1(r,e,a$2.metadata,"Shader configuration");return y(JSON.parse(o.data.toString("utf8")))}let i=d.join(r,"three-blocks.json");if(await d$1(i)){let o=b$1(JSON.parse(await readFile(i,"utf8")));return y({schemaVersion:1,scenes:[{key:o.template,url:"/",requiresText:o.features.text}]})}return y(j)}a(w,"loadShaderToolConfig");async function U(n){let r=await realpath(n);for(let t of ["vite.config.ts","vite.config.mts","vite.config.js","vite.config.mjs","vite.config.cts","vite.config.cjs"])if(await d$1(d.join(r,t)))return {driverKind:"vite",reason:`Detected ${t}.`};let e,i=d.join(r,"package.json");if(await d$1(i)){let t=await j$1(r,i,a$2.packageJson,"Project package.json"),a=JSON.parse(t.data.toString("utf8"));a$1(a)&&(e=a);}let o=a(t=>[e?.dependencies,e?.devDependencies,e?.peerDependencies,e?.optionalDependencies].some(a=>a$1(a)&&typeof a[t]=="string"),"hasDependency");if(o("vite"))return {driverKind:"vite",reason:"Detected the Vite dependency."};for(let t of ["dist","build","out"])if(await d$1(d.join(r,t,"index.html")))return {driverKind:"static",serve:t,reason:`Detected the built ${t}/index.html application.`};if(o("next"))throw new Error("Detected Next.js without an attach URL. Run `shaders capture` without an explicit driver or URL to preview the withThreeBlocksNext adapter and start a project-local capture server, or pass --url <local-url> for a server you manage.");if(o("webpack")||o("esbuild")||o("rollup"))throw new Error("Detected a non-Vite bundler but no static index.html. Run `shaders capture` without an explicit driver or URL to preview adapter wiring and build the project, or build it yourself and pass --driver static --serve <directory>.");return {driverKind:"vite",reason:"Using the Vite golden-path driver."}}a(U,"inferShaderCaptureTarget");async function V(n){let r=await realpath(n),e=d.join(r,b);if(await d$1(e))return {config:await w(r),file:e,created:false};let i=d.join(r,"three-blocks.json");if(await d$1(i))return {config:await w(r),file:i,created:false};let o=j,t=y(o),a=await g(e,`${JSON.stringify(o,null,2)}
+`);return {config:a?t:await w(r),file:e,created:a}}a(V,"ensureShaderToolConfig");export{b as a,I as b,O as c,y as d,v as e,w as f,U as g,V as h};

package/dist/chunk-UQOPSJR6.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import {d as d$2,b as b$2,c as c$3,g as g$2}from'./chunk-76WRV5MZ.js';import {g as g$1}from'./chunk-JMS5NTP7.js';import {a as a$3,c as c$2,b,d as d$1}from'./chunk-3TQVLKUH.js';import {a as a$1,c,b as b$1}from'./chunk-ZDNZCQUQ.js';import {j,d,i,a as a$2,c as c$1}from'./chunk-5L2VS3BN.js';import {a}from'./chunk-HOZDD6PW.js';import {realpath}from'fs/promises';import h from'path';var te=".three-blocks/runtime/status.json",re=256*1024,H="three-blocks browser smoke",se=["three-blocks.json","three-blocks.shaders.json","three-blocks.text.ts"];function Q(e){return "kind"in e&&e.kind==="adopted"}a(Q,"isAdoptedProjectStatus");async function O(e,t,r,s){let n=await j(e,t,r,s);return JSON.parse(n.data.toString("utf8"))}a(O,"readJsonWithin");var ne=["starting","worker ready","assets ready","compiled","first frame","updating","error"],ae=["ready","generating","fallback","missing","invalid"],oe=["WebGPU","WebGL"],ie=["OffscreenCanvas","MainThread"],de=/^[0-9A-Za-z][0-9A-Za-z._-]{0,63}$/,X=16,K=1e9;function g(e,t,r,s=[]){if(!a$1(e))throw new Error(`${t} must be an object.`);let n=new Set([...r,...s]);for(let o of r)if(!Object.hasOwn(e,o))throw new Error(`${t}.${o} is required.`);for(let o of Object.keys(e))if(!n.has(o))throw new Error(`${t}.${o} is not supported by schema v1.`);return e}a(g,"exactRecord");function A(e,t,r){if(typeof e!="string"||!t.includes(e))throw new Error(`${r} has an unsupported value.`);return e}a(A,"enumValue");function p(e,t){if(typeof e!="boolean")throw new Error(`${t} must be a boolean.`);return e}a(p,"booleanValue");function Y(e,t){return e===null?null:p(e,t)}a(Y,"nullableBoolean");function E(e,t){if(typeof e!="number"||!Number.isSafeInteger(e)||e<0||e>K)throw new Error(`${t} must be a non-negative integer no greater than ${K}.`);return e}a(E,"boundedCounter");function ce(e){if(typeof e!="string"||e.length>32)throw new Error("Runtime status receipt observedAt must be a bounded ISO timestamp.");let t=Date.parse(e);if(!Number.isFinite(t)||new Date(t).toISOString()!==e)throw new Error("Runtime status receipt observedAt must be an exact ISO timestamp.");return e}a(ce,"observedTimestamp");function ue(e){if(e===null)return null;if(typeof e!="string"||e.length===0||e.length>2048||/[\u0000-\u001f\u007f]/u.test(e))throw new Error("Runtime status receipt error must be null or one bounded display-safe line.");return e}a(ue,"receiptError");function le(e){if(!Array.isArray(e)||e.length>X)throw new Error(`Runtime status receipt assets.codecs must contain at most ${X} entries.`);let t=e.map((r,s)=>{let n=g(r,`Runtime status receipt assets.codecs[${s}]`,["name","available","decoded"]);if(typeof n.name!="string"||!de.test(n.name))throw new Error(`Runtime status receipt assets.codecs[${s}].name is invalid.`);let o=p(n.available,`Runtime status receipt assets.codecs[${s}].available`),a=p(n.decoded,`Runtime status receipt assets.codecs[${s}].decoded`);if(a&&!o)throw new Error(`Runtime status receipt codec ${JSON.stringify(n.name)} cannot be decoded when unavailable.`);return {name:n.name,available:o,decoded:a}});if(new Set(t.map(r=>r.name)).size!==t.length)throw new Error("Runtime status receipt assets.codecs must have unique names.");return t}a(le,"parseRuntimeCodecs");function me(e){if(e.assetsReady&&!e.workerReady)throw new Error("Runtime lifecycle assetsReady requires workerReady.");if(e.compiled&&!e.assetsReady)throw new Error("Runtime lifecycle compiled requires assetsReady.");if(e.firstFrame&&!e.compiled)throw new Error("Runtime lifecycle firstFrame requires compiled.");let t=e.state==="starting"?[false,false,false,false]:e.state==="worker ready"?[true,false,false,false]:e.state==="assets ready"?[true,true,false,false]:e.state==="compiled"?[true,true,true,false]:e.state==="first frame"||e.state==="updating"?[true,true,true,true]:null;if(t!==null&&![e.workerReady,e.assetsReady,e.compiled,e.firstFrame].every((r,s)=>r===t[s]))throw new Error(`Runtime lifecycle flags do not match state ${JSON.stringify(e.state)}.`)}a(me,"validateLifecycle");function pe(e){let t=g(e,"Runtime status receipt",["schemaVersion","observedAt","worker","assets","hmr","stats","lifecycle","shaders","error"],["text"]);if(t.schemaVersion!==1)throw new Error("Runtime status receipt must use schemaVersion 1.");let r=g(t.worker,"Runtime status receipt worker",["backend","renderer","protocolVersion"]);if(r.protocolVersion!==1)throw new Error("Runtime status receipt worker.protocolVersion must be 1.");let s=g(t.assets,"Runtime status receipt assets",["codecs","resources"]),n=g(t.hmr,"Runtime status receipt hmr",["capabilities","outcome"]),o=g(n.capabilities,"Runtime status receipt hmr.capabilities",["scene","component","assetManifest","workerRestart"]),a=g(n.outcome,"Runtime status receipt hmr.outcome",["attempted","succeeded","rollbackPreserved","workerRestarted"]),d=p(a.attempted,"Runtime status receipt hmr.outcome.attempted"),l=Y(a.succeeded,"Runtime status receipt hmr.outcome.succeeded"),m=Y(a.rollbackPreserved,"Runtime status receipt hmr.outcome.rollbackPreserved"),y=p(a.workerRestarted,"Runtime status receipt hmr.outcome.workerRestarted");if(d?l===null||m===null:l!==null||m!==null||y)throw new Error("Runtime status receipt HMR outcome fields are inconsistent with attempted.");let k={scene:p(o.scene,"Runtime status receipt hmr.capabilities.scene"),component:p(o.component,"Runtime status receipt hmr.capabilities.component"),assetManifest:p(o.assetManifest,"Runtime status receipt hmr.capabilities.assetManifest"),workerRestart:p(o.workerRestart,"Runtime status receipt hmr.capabilities.workerRestart")};if(d&&!k.scene)throw new Error("Runtime status receipt cannot attempt HMR without the scene capability.");if(y&&!k.workerRestart)throw new Error("Runtime status receipt cannot restart a worker without the workerRestart capability.");let x=g(t.stats,"Runtime status receipt stats",["snapshots","textures","workerProfiler","mainPanels"]),R=g(t.lifecycle,"Runtime status receipt lifecycle",["state","workerReady","assetsReady","compiled","firstFrame"]),S={state:A(R.state,ne,"Runtime status receipt lifecycle.state"),workerReady:p(R.workerReady,"Runtime status receipt lifecycle.workerReady"),assetsReady:p(R.assetsReady,"Runtime status receipt lifecycle.assetsReady"),compiled:p(R.compiled,"Runtime status receipt lifecycle.compiled"),firstFrame:p(R.firstFrame,"Runtime status receipt lifecycle.firstFrame")};me(S);let V=g(t.shaders,"Runtime status receipt shaders",["mode","pipelines"]),P=A(V.mode,["precompiled","live"],"Runtime status receipt shaders.mode"),T=E(V.pipelines,"Runtime status receipt shaders.pipelines");if(P==="precompiled"&&T===0)throw new Error("A precompiled runtime receipt must observe at least one shader pipeline.");let f;if(t.text!==void 0){let I=g(t.text,"Runtime status receipt text",["state","atlases","glyphs","requiredGlyphs"]);if(f={state:A(I.state,ae,"Runtime status receipt text.state"),atlases:E(I.atlases,"Runtime status receipt text.atlases"),glyphs:E(I.glyphs,"Runtime status receipt text.glyphs"),requiredGlyphs:E(I.requiredGlyphs,"Runtime status receipt text.requiredGlyphs")},f.state==="ready"&&(f.atlases===0||f.requiredGlyphs===0||f.glyphs<f.requiredGlyphs))throw new Error("A ready text receipt must cover a non-empty required glyph set with at least one atlas.")}let b=ue(t.error);if(S.state==="error"?b===null:b!==null)throw new Error("Runtime status receipt error must be present only when lifecycle.state is error.");return {schemaVersion:1,observedAt:ce(t.observedAt),worker:{backend:A(r.backend,ie,"Runtime status receipt worker.backend"),renderer:A(r.renderer,oe,"Runtime status receipt worker.renderer"),protocolVersion:1},assets:{codecs:le(s.codecs),resources:E(s.resources,"Runtime status receipt assets.resources")},hmr:{capabilities:k,outcome:{attempted:d,succeeded:l,rollbackPreserved:m,workerRestarted:y}},stats:{snapshots:E(x.snapshots,"Runtime status receipt stats.snapshots"),textures:E(x.textures,"Runtime status receipt stats.textures"),workerProfiler:p(x.workerProfiler,"Runtime status receipt stats.workerProfiler"),mainPanels:p(x.mainPanels,"Runtime status receipt stats.mainPanels")},lifecycle:S,shaders:{mode:P,pipelines:T},...f===void 0?{}:{text:f},error:b}}a(pe,"parseRuntimeStatusReceipt");function he(e,t){return e.render===t.render&&e.vertex===t.vertex&&e.fragment===t.fragment&&e.compute===t.compute}a(he,"sameCoverage");async function ee(e=process.cwd()){let t=h.resolve(e);for(;;){if((await Promise.all(se.map(s=>d(h.join(t,s))))).some(Boolean))return realpath(t);let r=h.dirname(t);if(r===t)return realpath(h.resolve(e));t=r;}}a(ee,"findProjectRoot");async function fe(e,t){let r=t.template,s=h.join(e,".three-blocks","shaders"),n=h.join(s,"meta.json");if(!await d(s)||!await d(n))return {state:"missing",scene:r,reason:t.artifacts?.shaders==="pending"?"The selected template has no verified shader capture yet.":".three-blocks/shaders/meta.json is absent."};try{let o=await i(e,s,"Shader artifact directory"),a=c(await O(o,n,a$2.receipt,"Shader receipt")),d=a.scenes[r];if(d===void 0)return {state:"invalid",scene:r,reason:`Shader receipt has no "${r}" scene.`};let l=await j(o,h.join(o,d.artifact),a$2.manifest,"Shader manifest");if(c$1(l.data)!==d.artifactHash)return {state:"invalid",scene:r,reason:"The selected shader manifest checksum does not match its receipt."};let m=a$3(l.data.toString("utf8"),l.path,r);if(!he(m,d.coverage))return {state:"invalid",scene:r,reason:"Shader receipt coverage does not match the manifest entries.",coverage:m};let{three:y,threeBlocks:k,threeBlocksShaderClosure:x}=await c$2(e);if(a.runtime.three!==y||t.runtime.three!==y||a.runtime.threeBlocks!==k||t.runtime.threeBlocks!==k)return {state:"stale",scene:r,reason:`Installed runtime versions (${y}, ${k}) do not match the metadata and shader receipt.`,coverage:m};if(a.runtime.threeBlocksShaderClosure!==x)return {state:"stale",scene:r,reason:"The installed three-blocks/shaders runtime closure differs from the capture receipt.",coverage:m};let R=await b(e),S=Object.keys(R),V=Object.keys(d.inputs),P=S.filter(b=>!Object.hasOwn(d.inputs,b)),T=V.filter(b=>!Object.hasOwn(R,b)),f=S.filter(b=>Object.hasOwn(d.inputs,b)&&d.inputs[b]!==R[b]);return P.length>0||T.length>0||f.length>0?{state:"stale",scene:r,reason:`${P.length} added, ${T.length} removed, and ${f.length} changed semantic shader inputs.`,coverage:m,...f.length>0?{changedInputs:f}:{},...P.length>0?{addedInputs:P}:{},...T.length>0?{removedInputs:T}:{}}:{state:"fresh",scene:r,reason:"Manifest, installed shader runtime closure, and the shader-relevant source snapshot match.",coverage:m}}catch(o){return {state:"invalid",scene:r,reason:o instanceof Error?o.message:String(o)}}}a(fe,"inspectShaders");async function ye(e,t){if(t.artifacts?.text==="pending")return {state:"missing",reason:"The template has no verified text artifacts yet.",atlases:[]};let r=await g$1(e);return {state:r.state,reason:r.reason,atlases:r.atlases.map(s=>({name:s.font.key,glyphs:s.codePoints.length,width:s.texture.width,height:s.texture.height}))}}a(ye,"inspectText");function Re(e,t){if(e.lifecycle.assetsReady&&e.assets.codecs.some(r=>!r.available))throw new Error("Runtime status receipt claims assets ready while a configured codec is unavailable.");if(t.features.text!==(e.text!==void 0))throw new Error("Runtime status receipt text observation does not match three-blocks.json.")}a(Re,"validateRuntimeReceiptForProject");async function be(e,t){let r=h.join(e,...te.split("/"));if(!await d(r))return {kind:"absent",receipt:null,reason:"No browser observation receipt is available."};try{let s=await i(e,h.dirname(r),"Runtime status receipt directory"),n=pe(await O(s,h.join(s,h.basename(r)),re,"Runtime status receipt"));return Re(n,t),{kind:"valid",receipt:n,reason:n.error??`Browser observation captured at ${n.observedAt}.`}}catch(s){return {kind:"invalid",receipt:null,reason:`Runtime status receipt is invalid: ${s instanceof Error?s.message:String(s)}`}}}a(be,"inspectRuntimeReceipt");function ge(){return {scene:false,component:false,assetManifest:false,workerRestart:false}}a(ge,"emptyCapabilities");function we(){return {attempted:false,succeeded:null,rollbackPreserved:null,workerRestarted:false}}a(we,"emptyOutcome");function ke(){return []}a(ke,"configuredCodecs");function Se(e,t,r){if(t.state!=="fresh")return "three-blocks shaders capture";if(r!==void 0&&r.state!=="ready")return "three-blocks text generate";let s=e.receipt;return e.kind!=="valid"||s===null||s.lifecycle.state==="error"?H:s.text!==void 0&&s.text.state!=="ready"?"three-blocks text generate":H}a(Se,"recoveryCommand");async function xe(e=process.cwd()){let t=await ee(e),r=b$1(await O(t,h.join(t,"three-blocks.json"),a$2.metadata,"Project metadata")),s=await fe(t,r),n=r.features.text?await ye(t,r):void 0,o=await be(t,r),a=o.receipt,d=o.kind==="invalid",l=d||a?.lifecycle.state==="error",m=a===null?{state:d?"error":"starting",backend:null,renderer:null,protocolVersion:1}:{state:l?"error":a.lifecycle.workerReady?"worker ready":"starting",backend:a.worker.backend,renderer:a.worker.renderer,protocolVersion:a.worker.protocolVersion},y=a===null?{state:d?"error":"starting",codecs:ke(),resources:0}:{state:l?"error":a.lifecycle.assetsReady?"assets ready":"starting",codecs:a.assets.codecs,resources:a.assets.resources},k=a===null?{state:d?"error":"starting",capabilities:ge(),outcome:we()}:{state:l||a.hmr.outcome.attempted&&(a.hmr.outcome.succeeded!==true||a.hmr.outcome.rollbackPreserved!==true)?"error":a.hmr.outcome.attempted?"first frame":"starting",capabilities:a.hmr.capabilities,outcome:a.hmr.outcome},x=a===null?{state:d?"error":"starting",snapshots:0,textures:0,workerProfiler:false,mainPanels:false}:{state:l?"error":a.stats.snapshots>0&&a.stats.workerProfiler&&a.stats.mainPanels?"first frame":"starting",...a.stats},R=a===null?{state:d?"error":"starting",mode:null,pipelines:0,artifactState:s.state}:{state:l?"error":a.lifecycle.compiled?s.state==="fresh"?a.shaders.mode:s.state:a.lifecycle.state,mode:a.shaders.mode,pipelines:a.shaders.pipelines,artifactState:s.state},S=n===void 0?void 0:a?.text===void 0?{state:d?"error":"starting",atlases:0,glyphs:0,requiredGlyphs:0}:{state:l?"error":n.state==="ready"?a.text.state:n.state,atlases:a.text.atlases,glyphs:a.text.glyphs,requiredGlyphs:a.text.requiredGlyphs};return {schemaVersion:1,root:t,metadata:r,configuration:{worker:m,assets:y,hmr:k,optimization:R,stats:x,...S===void 0?{}:{text:S}},runtime:{state:d?"error":a?.lifecycle.state??"starting",observed:a!==null,observedAt:a?.observedAt??null,reason:o.reason,recovery:Se(o,s,n),observation:a},shaders:s,...n?{text:n}:{}}}a(xe,"inspectProject");async function Z(e){let[t,r]=await Promise.all([d(h.join(e,"three-blocks.shaders.json")),d(h.join(e,"three-blocks.text.ts"))]),[s,n]=await Promise.all([t?d$1(e):Promise.resolve(void 0),r?g$1(e):Promise.resolve(void 0)]);return {schemaVersion:1,root:e,kind:"adopted",markers:{shaders:t,text:r},...s===void 0?{}:{shaders:s},...n===void 0?{}:{text:n}}}a(Z,"inspectAdoptedProject");async function qe(e=process.cwd()){let t=await ee(e),r=h.join(t,"three-blocks.json");if(await d(r)){try{b$1(await O(t,r,a$2.metadata,"Project metadata"));}catch{return Z(t)}return xe(t)}return Z(t)}a(qe,"inspectThreeBlocksStatus");function Ge(e){return Q(e)?(e.markers.shaders||e.markers.text)&&(e.shaders===void 0||e.shaders.state==="fresh")&&(e.text===void 0||e.text.state==="ready"):e.shaders.state==="fresh"&&(e.text===void 0||e.text.state==="ready")&&e.runtime.state!=="error"}a(Ge,"threeBlocksStatusIsFresh");function $e(e){return e==="ktx2"?"KTX2":e==="draco"?"Draco":e==="meshopt"?"Meshopt":e}a($e,"codecName");function ve(e,t=Date.now()){let r=t-Date.parse(e);if(!Number.isFinite(r)||r<0)return e;let s=Math.round(r/1e3);if(s<60)return "just now";let n=Math.round(s/60);if(n<60)return `${n} minute${n===1?"":"s"} ago`;let o=Math.round(n/60);return o<48?`${o} hour${o===1?"":"s"} ago`:`${Math.round(o/24)} days ago`}a(ve,"relativeTime");function w(e,t,r){return `${e} ${d$2(t,12)} ${r}`}a(w,"row");function v(e,t){return `  ${d$2(b$2.dim(e),12)} ${b$2.dim(t)}`}a(v,"subRow");function Pe(e){return e<100?e.toFixed(1):Math.round(e).toString()}a(Pe,"milliseconds");function Te(e){return e?`${e.render} render \xB7 ${e.compute} compute`:"no coverage"}a(Te,"coverageText");function je(e){let t=[w(g$2(e.state),"shaders",`${e.state==="fresh"?"fresh":b$2.warn(e.state)} ${c$3.dot} ${b$2.dim(e.reason)}`)];for(let r of e.scenes){let s=r.timing,n=s?.source==="committed-capture"?s.adapter??"captured adapter":"this capture",o=s===void 0?"":s.runs>1?`measured median of ${s.runs}`:"single-capture estimate",a=s===void 0?"":`\u2248${Pe(s.avoidedBuildMs)} ms TSL work avoided`,d=s===void 0?r.state==="fresh"?` ${c$3.dot} ${b$2.dim("capture again to record a timing estimate")}`:"":` ${c$3.dot} ${b$2.dim(`${a} \xB7 ${o} \xB7 ${n}`)}`;t.push(w(g$2(r.state),r.scene,`${r.state} ${c$3.dot} ${Te(r.coverage)}${d}`)),s!==void 0&&s.spreadMs>s.avoidedBuildMs*.4&&t.push(v("measure",b$2.warn("noisy measurement \u2014 close other GPU apps and re-run")));let l=[...r.changedInputs??[],...r.addedInputs??[],...r.removedInputs??[]];l.length>0&&t.push(v("changed",l.join(", ")));}return e.state!=="fresh"&&t.push(`${c$3.info} ${b$2.accent("three-blocks shaders capture")}`),t.join(`
+`)}a(je,"formatShaderMatrixStatus");function Ee(e){let t=e.scene,r=e.coverage,s=r?`${r.render} render \xB7 ${r.compute} compute`:"no coverage";if(e.state==="fresh")return [w(g$2("fresh"),t,`fresh ${c$3.dot} ${s} ${c$3.dot} ${b$2.dim("precompiled at runtime")}`)];let n=[w(g$2(e.state),t,`${e.state==="missing"?b$2.dim("missing"):b$2.warn(e.state)} ${c$3.dot} ${b$2.dim(e.reason)}`)],o=[...e.changedInputs??[],...e.addedInputs??[],...e.removedInputs??[]];return o.length>0&&n.push(v("changed",o.join(", "))),n}a(Ee,"shaderRow");function Me(e,t=Date.now()){let r=c$3.mark?`${c$3.mark}  `:"",s=e.metadata.runtime,n=[`${r}${b$2.bold("three-blocks")} ${b$2.dim("status")}`,v("project",e.root),"",b$2.bold("Project"),w(c$3.tick,e.metadata.template,`three ${s.three} ${c$3.dot} three-blocks ${s.threeBlocks}`),"",b$2.bold("Shaders"),...Ee(e.shaders)];if(e.text){let d=e.text,l=d.atlases.reduce((m,y)=>m+y.glyphs,0);n.push("",b$2.bold("Text"),w(g$2(d.state),"coverage",d.state==="ready"?`ready ${c$3.dot} ${l} glyphs ${c$3.dot} ${d.atlases.length} atlas${d.atlases.length===1?"":"es"}`:`${b$2.warn(d.state)} ${c$3.dot} ${b$2.dim(d.reason)}`),...d.atlases.map(m=>v("atlas",`${m.name} \xB7 ${m.glyphs} glyphs \xB7 ${m.width}\xD7${m.height}`)));}let o=e.runtime.observation;if(n.push("",b$2.bold("Browser check")),o!==null&&e.runtime.state!=="error"){let d=o.assets.codecs.map(l=>`${$e(l.name)}${l.decoded?"":l.available?" (idle)":" (unavailable)"}`).join(" \xB7 ");n.push(w(c$3.tick,"verified",`${ve(o.observedAt,t)} ${c$3.dot} ${o.worker.renderer} worker ${c$3.dot} ${o.lifecycle.state} ${c$3.dot} ${o.shaders.pipelines} pipeline${o.shaders.pipelines===1?"":"s"} ${o.shaders.mode}`),v("codecs",d||"none configured")),o.hmr.outcome.attempted&&n.push(v("hmr",o.hmr.outcome.succeeded?`update succeeded${o.hmr.outcome.workerRestarted?" \xB7 worker restarted":""}`:"update failed"));}else e.runtime.state==="error"?n.push(w(c$3.cross,"runtime",b$2.danger(e.runtime.reason))):n.push(w(c$3.ring,"unverified",b$2.dim(`no browser run recorded \u2014 ${H}`)));return e.shaders.state==="fresh"&&(e.text===void 0||e.text.state==="ready")&&e.runtime.state!=="error"||n.push("",b$2.bold("Next"),`${c$3.info} ${b$2.accent(e.runtime.recovery)}`),n.join(`
+`)}a(Me,"formatStatus");function He(e,t=Date.now()){if(!Q(e))return Me(e,t);let r=c$3.mark?`${c$3.mark}  `:"",s=e.markers.shaders||e.markers.text,n=[`${r}${b$2.bold("three-blocks")} ${b$2.dim("status")}`,v("project",e.root)];if(!s)return n.push("",`${c$3.dot} ${b$2.dim("no Three Blocks project markers found")}`,`  ${b$2.dim("shaders:")} add three-blocks.shaders.json \u2014 /docs/tools/devtools`,`  ${b$2.dim("starter:")} npx three-blocks starter`),n.join(`
+`);if(e.shaders!==void 0&&n.push("",b$2.bold("Shaders"),je(e.shaders)),e.text!==void 0){let o=e.text.atlases.reduce((a,d)=>a+d.codePoints.length,0);n.push("",b$2.bold("Text"),w(g$2(e.text.state),"coverage",e.text.state==="ready"?`ready ${c$3.dot} ${o} glyphs ${c$3.dot} ${e.text.atlases.length} atlas${e.text.atlases.length===1?"":"es"}`:`${b$2.warn(e.text.state)} ${c$3.dot} ${b$2.dim(e.text.reason)}`));}return n.join(`
+`)}a(He,"formatThreeBlocksStatus");export{te as a,re as b,H as c,pe as d,ee as e,xe as f,qe as g,Ge as h,je as i,Me as j,He as k};

package/dist/chunk-WNNN3UJI.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 y 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 P(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(P,"shaderCompatibilityForThree");var O=50,xe="timing.local.json",Oe="timing.json",de="parity.json",Y=4096,lr=4096;function ae(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(ae,"boundedString");function E(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(E,"nonNegativeNumber");function mr(r){if(!a$2(r))throw new Error("Shader capture stats are missing.");let e={buildCalls:E(r.buildCalls,"capture stats.buildCalls"),renderBuilds:E(r.renderBuilds,"capture stats.renderBuilds"),computeBuilds:E(r.computeBuilds,"capture stats.computeBuilds"),registeredBuilds:E(r.registeredBuilds,"capture stats.registeredBuilds"),registeredRenderBuilds:E(r.registeredRenderBuilds,"capture stats.registeredRenderBuilds"),registeredComputeBuilds:E(r.registeredComputeBuilds,"capture stats.registeredComputeBuilds"),buildMs:E(r.buildMs,"capture stats.buildMs",false),injected:E(r.injected,"capture stats.injected"),injectedRender:E(r.injectedRender,"capture stats.injectedRender"),injectedCompute:E(r.injectedCompute,"capture stats.injectedCompute"),missed:E(r.missed,"capture stats.missed"),missedRender:E(r.missedRender,"capture stats.missedRender"),missedCompute:E(r.missedCompute,"capture stats.missedCompute"),...Array.isArray(r.missedKeys)&&r.missedKeys.every(t=>typeof t=="string")?{missedKeys:r.missedKeys.slice(0,Y)}:{}};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)throw new Error("Shader capture stats totals are inconsistent.");return e}a(mr,"captureStats");function pr(r){if(!Array.isArray(r)||r.length>Y)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:ae(e.name,`skipped build ${t} name`,512),reason:ae(e.reason,`skipped build ${t} reason`)}})}a(pr,"skippedBuilds");function hr(r){let e=0,t=0,n=0,i=0;for(let a of Object.values(r.entries)){let s=r.states[a];s!==void 0&&((s.vertex!==null||s.fragment!==null)&&e++,s.vertex!==null&&t++,s.fragment!==null&&n++,s.compute!==null&&i++);}return {render:e,vertex:t,fragment:n,compute:i}}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=P(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.");let n=Object.keys(r.entries).length;if(n===0||n>Y)throw new Error(`Shader capture must contain 1...${Y} entries.`);if(!Array.isArray(r.errors)||r.errors.length>lr)throw new Error("Shader capture errors are invalid.");let i=r.errors.map((l,d)=>ae(l,`capture error ${d}`,64*1024));if(i.length>0)throw new Error(`Shader capture failed:
+ - ${i.join(`
+ - `)}`);let a=pr(r.skipped),s=mr(r.stats),o=a$2(r.timing)?r.timing:void 0,u=o===void 0?void 0:Object.fromEntries(["launch","firstRequest","readiness","lastBuild","settled","posted"].flatMap(l=>{let d=o[l];if(d===void 0)return [];if(typeof d!="number"||!Number.isFinite(d)||d<0)throw new Error(`Shader capture timing.${l} is invalid.`);return [[l,d]]})),p;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(l=>typeof l=="string"&&l.length<=128))throw new Error("Shader capture provenance is invalid.");p={userAgent:r.provenance.userAgent,adapter:r.provenance.adapter,features:[...new Set(r.provenance.features)].sort()};}let h=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},modules:r.modules,nodes:r.nodes,layouts:r.layouts,attributePlans:r.attributePlans,updatePlans:r.updatePlans,requirementPlans:r.requirementPlans,states:r.states,entries:r.entries}),g=hr(h);if(s.registeredRenderBuilds<g.render||s.registeredComputeBuilds<g.compute)throw new Error("Shader capture did not live-build every distinct registered render/compute entry.");return {scene:e.scene,manifest:h,skipped:a,stats:s,coverage:g,...u===void 0?{}:{timing:u},...p===void 0?{}:{provenance:p}}}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(a=>a===null||["number","string","boolean"].includes(typeof a))?JSON.stringify(r):`[
+${r.map(a=>`${n}${C(a,e+1)}`).join(`,
+`)}
+${t}]`;if(r!==null&&typeof r=="object"){let a=r,s=Object.keys(a).sort();return s.length===0?"{}":`{
+${s.map(o=>{let u=a[o];return `${n}${JSON.stringify(o)}: ${C(u,e+1)}`}).join(`,
+`)}
+${t}}`}let i=JSON.stringify(r);if(i===void 0)throw new Error("Shader artifact contains a non-serializable value.");return i}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 Te(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(Te,"timingLabel");function se(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,i]of Object.entries(r.scenes)){if(n.length===0||n.length>128||!a$2(i))throw new Error("Shader timing scene is invalid.");let a={builds:E(i.builds,`timing ${n}.builds`),liveBuildMs:E(i.liveBuildMs,`timing ${n}.liveBuildMs`,false),precompiledBuildMs:E(i.precompiledBuildMs,`timing ${n}.precompiledBuildMs`,false),avoidedBuildMs:E(i.avoidedBuildMs,`timing ${n}.avoidedBuildMs`,false),runs:E(i.runs,`timing ${n}.runs`),spreadMs:E(i.spreadMs,`timing ${n}.spreadMs`,false)};if(a.runs<1)throw new Error(`Shader timing runs are invalid for scene "${n}".`);if(Math.abs(a.avoidedBuildMs-Math.max(0,a.liveBuildMs-a.precompiledBuildMs))>.001)throw new Error(`Shader timing delta is inconsistent for scene "${n}".`);e[n]=a;}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:Te(r.adapter,"Shader timing adapter"),platform:Te(r.platform,"Shader timing platform")}}a(se,"parseShaderTiming");function Q(r){return /^[a-z0-9][a-z0-9_-]{0,63}$/u.test(r)}a(Q,"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"&&Q(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,i]of e.sort(([a],[s])=>a.localeCompare(s))){if(!Q(n)||!a$2(i)||typeof i.fingerprint!="string"||!/^[a-f0-9]{64}$/u.test(i.fingerprint)||!Pe(i.verifiedAt))throw new Error("Shader parity evidence is invalid.");t[n]={fingerprint:i.fingerprint,verifiedAt:i.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 i=y.join(r,t);try{if(!await d(i))return;let a=await lstat(i);if(a.isSymbolicLink()||!a.isFile()||a.size>1024*1024)return;let s=se(JSON.parse(await readFile(i,"utf8")));return s.source===n&&s.receiptHash===c$1(e)?s:void 0}catch{return}}a(ke,"readShaderTimingFile");async function at(r,e){return await ke(r,e,xe,"latest-local-capture")??await ke(r,e,Oe,"committed-capture")}a(at,"readShaderTiming");async function Ie(r,e){let t=y.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 i=ce(JSON.parse(await readFile(t,"utf8"))),a=c$2(JSON.parse(Buffer.from(e).toString("utf8"))),s={};if(i.schemaVersion===1){if(i.receiptHash!==c$1(e))return;for(let o of i.scenes)a.scenes[o]!==void 0&&(s[o]={fingerprint:oe(a,o),verifiedAt:i.verifiedAt});}else for(let[o,u]of Object.entries(i.scenes))a.scenes[o]===void 0||u.fingerprint!==oe(a,o)||(s[o]=u);return Object.keys(s).length===0?void 0:{schemaVersion:2,scenes:s}}catch{return}}a(Ie,"readShaderParityEvidence");async function Me(r,e,t){let n=await X(r),i=y.join(n,"meta.json"),a=await lstat(i);if(a.isSymbolicLink()||!a.isFile())throw new Error("Shader receipt must be a regular file before timing.");let s=await readFile(i),o=new Date().toISOString(),u=Object.fromEntries(Object.entries(e).sort(([g],[l])=>g.localeCompare(l))),p=se({schemaVersion:3,receiptHash:c$1(s),measuredAt:o,source:"latest-local-capture",scenes:u});if(await f(y.join(n,xe),`${C(p)}
+`),t===void 0)return {local:p};let h=se({schemaVersion:3,receiptHash:c$1(s),measuredAt:o,source:"committed-capture",adapter:t.adapter,platform:t.platform,scenes:u});return await f(y.join(n,Oe),`${C(h)}
+`),{local:p,committed:h}}a(Me,"writeShaderTimings");async function st(r,e){return (await Me(r,e)).local}a(st,"writeShaderLocalTiming");async function ot(r,e,t){if(e.length===0||e.length>64||e.some(l=>!Q(l)))throw new Error("Shader parity evidence must contain 1...64 valid scene keys.");let n=await X(r),i=y.join(n,"meta.json"),a=await lstat(i);if(a.isSymbolicLink()||!a.isFile())throw new Error("Shader receipt must be a regular file before parity evidence.");let s=await readFile(i);if(t!==void 0&&c$1(s)!==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(s.toString("utf8"))),u=await Ie(n,s),p=new Date().toISOString(),h={...u?.scenes};for(let l of [...new Set(e)].sort())h[l]={fingerprint:oe(o,l),verifiedAt:p};let g=ce({schemaVersion:2,scenes:h});return await f(y.join(n,de),`${C(g)}
+`),g}a(ot,"writeShaderParityEvidence");async function dt(r,e,t){if(e.length===0||e.length>64||e.some(h=>!Q(h)))throw new Error("Shader parity invalidation must contain 1...64 valid scene keys.");let n=await X(r),i=await readFile(y.join(n,"meta.json"));if(c$1(i)!==c$1(t))throw new Error("Shader receipt changed before prior parity evidence could be invalidated.");let a=await Ie(n,i);if(a===void 0)return;let s=new Set(e),o=Object.fromEntries(Object.entries(a.scenes).filter(([h])=>!s.has(h))),u=y.join(n,de);if(Object.keys(o).length===0){await unlink(u).catch(h=>{if(!a$2(h)||h.code!=="ENOENT")throw h});return}let p=ce({schemaVersion:2,scenes:o});await f(u,`${C(p)}
+`);}a(dt,"removeShaderParityEvidence");async function ct(r,e,t){let n=await Me(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 X(r){let e=y.resolve(r),t=y.join(e,".three-blocks");await Ce(t);let n=y.join(t,"shaders");return await Ce(n),n}a(X,"artifactRoot");async function ut(r){let e$1=await X(r.root),t=P(r.runtime.three),n=y.resolve(r.root),i$1=y.resolve(n,r.publicDirectory??"public");if(!e(n,i$1)||i$1===n)throw new Error("Shader public directory must stay inside the project root.");let a=y.join(i$1,"three-blocks","shaders");await mkdir(a,{recursive:true}),await i(n,a,"Shader static-asset directory");let s={},o=[];for(let d of [...r.scenes].sort((m,f)=>m.key.localeCompare(f.key))){let m=r.captures.get(d.key),f$1=r.inputs.get(d.key);if(f$1===void 0)throw new Error(`Shader input matrix is missing scene "${d.key}".`);if(m===void 0){let b=r.previousReceipt?.scenes[d.key];if(b===void 0)throw new Error(`Capture matrix is missing scene "${d.key}".`);let F=await readFile(y.join(e$1,b.artifact));if(c$1(F)!==b.artifactHash)throw new Error(`Preserved shader artifact checksum differs for scene "${d.key}".`);if(b.asset!==void 0&&b.assetHash!==void 0){let N=await readFile(y.join(i$1,b.asset));if(c$1(N)!==b.assetHash)throw new Error(`Preserved static shader manifest checksum differs for scene "${d.key}".`)}s[d.key]={...b,inputs:Object.fromEntries(Object.entries(f$1).sort(([N],[J])=>N.localeCompare(J)))},o.push(b.artifact),b.asset!==void 0&&o.push(y.relative(n,y.join(i$1,b.asset)).split(y.sep).join("/"));continue}if(m.scene!==d.key||m.manifest.scene!==d.key)throw new Error(`Capture matrix scene "${d.key}" is inconsistent.`);let S=`${d.key}.webgpu.ts`,v=fr(m.manifest);await f(y.join(e$1,S),v),o.push(S);let R=`three-blocks/shaders/${d.key}.json`,M=`${C(m.manifest)}
+`;await f(y.join(i$1,R),M),o.push(y.relative(n,y.join(i$1,R)).split(y.sep).join("/"));let q=m.skipped.filter(b=>b.kind==="render").length,k=m.skipped.length-q;s[d.key]={artifact:S,artifactHash:c$1(v),asset:R,assetHash:c$1(M),inputs:Object.fromEntries(Object.entries(f$1).sort(([b],[F])=>b.localeCompare(F))),coverage:m.coverage,bytes:Buffer.byteLength(v),skipped:{render:q,compute:k}};}let u=[...r.captures.values()].find(d=>d.provenance!==void 0)?.provenance??r.previousReceipt?.runtime.capture,p={schemaVersion:2,runtime:{...r.runtime,...u===void 0?{}:{capture:u}},tool:{name:"@three-blocks/devtools",version:a$3,compatibility:t,transform:O,address:SHADER_ADDRESS_SCHEMA_VERSION,recipe:SHADER_RECIPE_SCHEMA_VERSION,hydration:SHADER_HYDRATION_SCHEMA_VERSION},scenes:s},h=new Set(o);for(let d of await readdir(e$1,{withFileTypes:true}))if(!(!d.name.endsWith(".webgpu.ts")||h.has(d.name))){if(d.isSymbolicLink()||!d.isFile())throw new Error(`Orphan shader artifact is not a regular file: ${d.name}.`);await unlink(y.join(e$1,d.name));}let g=new Set(r.scenes.map(d=>`${d.key}.json`)),l=new Set(Object.values(r.previousReceipt?.scenes??{}).map(d=>d.asset===void 0?void 0:y.posix.basename(d.asset)).filter(d=>d!==void 0));try{let d=c$2(JSON.parse(await readFile(y.join(e$1,"meta.json"),"utf8")));for(let m of Object.values(d.scenes))m.asset!==void 0&&l.add(y.posix.basename(m.asset));}catch{}for(let d of await readdir(a,{withFileTypes:true}))if(!(!d.name.endsWith(".json")||g.has(d.name))&&l.has(d.name)){if(d.isSymbolicLink()||!d.isFile())throw new Error(`Orphan shader static asset is not a regular file: ${d.name}.`);await unlink(y.join(a,d.name));}return await f(y.join(e$1,"meta.json"),`${C(p)}
+`),o.push("meta.json"),{directory:e$1,receipt:p,files:o}}a(ut,"writeShaderArtifacts");var Le="three-blocks.shader-capture.runtime.v1";var G;async function $(){G===void 0&&(G=(async()=>{let e=createRequire(y.join(process.cwd(),"package.json")).resolve("@three-blocks/devtools/browser/shader-capture"),t=y.resolve(y.dirname(e),"../..");return (await j(t,e,a$1.metadata,"Shader capture browser runtime")).data.toString("utf8")})());let r=G;try{return await r}catch(e){throw G===r&&(G=void 0),e}}a($,"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 $(),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(y.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"}),i=n.state==="already-applied",a=n.code;return t.instrumentCapture&&(a=transformThreeWebgpuCaptureInstrumentation(a,{...t.captureRuntimeImport===void 0?{}:{runtimeImport:t.captureRuntimeImport}}).code),{code:a,alreadyPresent:i,captureApplied:t.instrumentCapture===true}}a(Er,"applyShaderProviderTransform");var vr=/this\.trackTimestamp\s*=\s*\(\s*parameters\.trackTimestamp\s*===\s*true\s*\);/gu,Rr="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(i){return e.capture&&i===De?$e:e.capture&&i===le?Fe:null},async load(i){return e.capture?i===Fe?$():i===$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:O})} );`].join(`
+`):null:null},transform(i,a){if(!br(a))return null;t.seen=true,t.id=a;try{let s=Er(i,r,{instrumentCapture:e.capture!==void 0,...e.capture!==void 0?{captureRuntimeImport:De}:{}}),o=e.disableTimestampQueries===!0?s.code.replace(vr,Rr):s.code;if(e.disableTimestampQueries===!0&&o===s.code)throw new Error("Three.js timestamp tracking anchor drifted; refusing software WebGPU capture.");return t.applied=!0,t.alreadyPresent=s.alreadyPresent,t.captureApplied=s.captureApplied,o===i?null:{code:o,map:null}}catch(s){throw t.error=s instanceof Error?s.message:String(s),s}}},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,jr=[/is not valid JSON/iu,/WebGPU is experimental/iu];async function xr(){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(xr,"loadChromium");async function Or(r){let e;try{e=createRequire(y.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(Or,"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((i,a)=>{let s=setTimeout(()=>{this.#e.delete(e),a(new Error(`Shader capture "${e}" timed out after ${t}ms.`));},t);this.#e.set(e,{resolve:i,reject:a,timer:s});})}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 Ir(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(Ir,"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);}},Mr=a(async(r,e,t,n,i)=>{let a=0;for(;r.__threeBlocksParityUsesAnimationLoop!==true&&a<e;)await n(),a+=1;if(r.__threeBlocksParityUsesAnimationLoop===true){let s=Number(r.__threeBlocksParityCompletedFrame||0),o=Number(t),u=Number.isSafeInteger(o)&&o>=s?o:s+e;for(r.__threeBlocksParityTargetFrame=u;Number(r.__threeBlocksParityCompletedFrame||0)<u;)await n();}return await i(),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, injected: 0, injectedRender: 0, injectedCompute: 0, missed: 0, missedRender: 0, missedCompute: 0, missedKeys: [] };
+  const settleParityFrames = ${Mr.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: ${O}, 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,i=false){let a=new URL(r.url??"/","http://three-blocks.invalid"),s=a.pathname;if(i&&r.method==="GET"&&/^\/three-blocks\/shaders\/[a-z0-9][a-z0-9_-]{0,63}\.json$/u.test(s))return e.statusCode=204,e.end(),true;if(s===te&&r.method==="GET"){let l=a.searchParams.get("scene")??"",d=n.read(l);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=s===Qe,u=s===te;if(!o&&!u)return  false;if(r.method!=="POST")return e.statusCode=405,e.end("POST required"),true;let p=[],h=0,g=false;return r.on("data",l=>{h+=l.byteLength,h>rr?g=true:p.push(l);}),r.on("end",()=>{if(g){e.statusCode=413,e.end("capture payload too large");return}try{let l=JSON.parse(Buffer.concat(p).toString("utf8"));u?n.receive(l):t.receive(l),e.statusCode=204,e.end();}catch(l){e.statusCode=400,e.end(l instanceof Error?l.message:String(l));}}),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(i){i.middlewares.use((a,s,o)=>{let p=new URL(a.url??"/","http://three-blocks.invalid").searchParams.get("captureId");p!==null&&e.markFirstRequest(p),!ir(a,s,r,e,t)&&o();});}}}a(Lr,"captureEndpointPlugin");function We(r,e,t){let n=new URL(e.url,r);for(let[i,a]of Object.entries(t))n.searchParams.set(i,a);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 Ke(r){return jr.some(e=>e.test(r))}a(Ke,"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 qe(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(qe,"readPageDiagnostic");function pe(r){let e=a(()=>{},"resolveFirst"),t=new Promise(s=>{e=s;}),n={console:[],page:[],first:t},i=false,a$1=a(s=>{i||(i=true,e(new Error(s)));},"report");return r.on("console",s=>{let o=s.type()==="warning"&&/\[three-blocks\/shaders\].*(?:has no entry|manifest miss|hydration)/iu.test(s.text());if(s.type()!=="error"&&!o||Ke(s.text()))return;let u=s.location().url,p=u.length>0?`${s.text()} (${u})`:s.text();n.console.push(p),a$1(`Browser console ${o?"warning":"error"}: ${p}`);}),r.on("pageerror",s=>{if(Ke(s.message))return;let o=s.stack||s.message;n.page.push(o),a$1(`Browser page error: ${o}`);}),r.on("crash",()=>a$1("Browser page crashed before shader capture completed.")),r.on("close",()=>a$1("Browser page closed before shader capture completed.")),n}a(pe,"collectErrors");function W(r,e,t=false){return typeof r[e]=="boolean"?r[e]:t}a(W,"booleanField");function $r(r){if(!a$2(r))throw new Error("Browser shader stats are unavailable.");let e=a((t,n=true)=>{let i=r[t];if(typeof i!="number"||!Number.isFinite(i)||i<0||n&&!Number.isSafeInteger(i))throw new Error(`Browser shader stats.${t} is invalid.`);return i},"read");return {buildCalls:e("buildCalls"),renderBuilds:e("renderBuilds"),computeBuilds:e("computeBuilds"),registeredBuilds:e("registeredBuilds"),registeredRenderBuilds:e("registeredRenderBuilds"),registeredComputeBuilds:e("registeredComputeBuilds"),buildMs:e("buildMs",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 Z(r,e,t,n,i){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 a=r.readiness;if(!a$2(a))throw new Error("The shader bridge readiness snapshot is invalid.");let s={workerReady:W(a,"workerReady"),assetsReady:W(a,"assetsReady"),textReady:e.requiresText?W(a,"textReady"):true,compileEnd:W(a,"compileEnd"),firstFrame:W(a,"firstFrame",t)};if(!s.workerReady||!s.assetsReady||!s.textReady||!s.compileEnd)throw new Error(`Scene "${e.key}" did not reach worker/assets/text/compile readiness.`);let o=t?i:r.compatibility,u=t?O:r.transform;if(o!==i||u!==O)throw new Error(`Scene "${e.key}" exposed incompatible shader bridge metadata.`);return me(n),{compatibility:i,transform:u,readiness:s,stats:$r(r.stats)}}a(Z,"parseBridge");async function ee(r,e){return r.evaluate(t=>{let n=globalThis;if(!t)return n.__threeBlocksShaderTools??null;let i=n.__threeBlocks,a=n.__threeBlocksTslStats;if(!i||typeof i!="object")return null;let s=i;return {readiness:{workerReady:s.workerReady===true,assetsReady:s.loadEnd===true||s.assetsReady===true,textReady:s.textReady===true,compileEnd:s.compileEnd===true,firstFrame:true},stats:a}},e)}a(ee,"readBridge");async function re(r,e,t,n){return r.evaluate(async i=>{let s=globalThis.__threeBlocksShaderTools;if(s&&typeof s=="object"){let p=Reflect.get(s,"settle");if(typeof p=="function"){let h=await p(i.frames,i.targetFrame);return typeof h=="number"&&Number.isSafeInteger(h)?h:0}}if(!i.legacy||!i.modulePath)throw new Error("The public shader bridge does not provide deterministic settle().");let o=await import(i.modulePath);if(!o.store||typeof o.store!="object")throw new Error("Legacy deterministic store is unavailable.");let u=o.store;return u.recordFrameCount=0,u.recordFrameRate=60,u.recordTotalFrames=i.frames,u.recording=true,await new Promise((p,h)=>{let g=Date.now(),l=a(()=>{if(u.recording===false)return p();if(Date.now()-g>i.timeoutMs)return h(new Error("Legacy deterministic settle timed out."));setTimeout(l,25);},"poll");l();}),0},{frames:t,targetFrame:n,legacy:e.bridge.legacyLab,modulePath:e.bridge.deterministicModule??null,timeoutMs:e.timeoutMs})}a(re,"settlePage");async function Je(r,e,t){e.readiness.selector===void 0&&e.readiness.global===void 0||await Promise.race([r.waitForFunction(n=>{let i=globalThis;if(n.selector!==void 0&&i.document?.querySelector(n.selector)==null)return  false;if(n.global===void 0)return  true;let a=i;for(let u of n.global.split(".")){if((typeof a!="object"||a===null)&&typeof a!="function")return  false;a=Reflect.get(a,u);}if(a===true)return  true;if(typeof a!="object"||a===null||typeof Reflect.get(a,"then")!="function")return  false;let s=i.__threeBlocksReadinessState,o=s instanceof Map?s:new Map;return s instanceof Map||(i.__threeBlocksReadinessState=o),o.has(a)||(o.set(a,false),Promise.resolve(a).then(()=>o.set(a,true),()=>o.set(a,false))),o.get(a)===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(i=>i.map((a,s)=>{let o=a.getBoundingClientRect();return {index:s,area:Math.max(0,o.width)*Math.max(0,o.height)}}))).sort((i,a)=>a.area-i.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,i,a){let s=ar(n,i),o=await He(),u=`(() => {
+  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(s).replaceAll("<","\\u003c")});
+})();`;await r.addInitScript({content:`${o}
+${u}`}),await r.addInitScript({content:Se(a)}),await r.route("**/*",async p=>{let h=p.request(),g=new URL(h.url()),l=g.pathname;if(h.method()==="GET"&&n!=="precompiled"&&/^\/three-blocks\/shaders\/[a-z0-9][a-z0-9_-]{0,63}\.json$/u.test(l)){await p.fulfill({status:204});return}if(l===te&&h.method()==="GET"){let f=t.read(g.searchParams.get("scene")??"");await p.fulfill(f===void 0?{status:204}:{status:200,contentType:"application/json",body:JSON.stringify(f)});return}let d=l===Qe,m=l===te;if((d||m)&&h.method()==="POST"){let f=h.postDataBuffer()??Buffer.alloc(0);if(f.byteLength>rr){await p.fulfill({status:413,body:"capture payload too large"});return}try{let S=JSON.parse(f.toString("utf8"));m?t.receive(S):e.receive(S),await p.fulfill({status:204});}catch(S){await p.fulfill({status:400,body:S instanceof Error?S.message:String(S)});}return}await p.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=ar(r,e);return [`import { configureThreeBlocksShaderCapture } from ${JSON.stringify(Xe)};`,`configureThreeBlocksShaderCapture( ${JSON.stringify(t).replaceAll("<","\\u003c")} );`].join(`
+`)}a(Hr,"staticCaptureBootstrap");function ar(r,e){return {capture:r==="capture",forceLive:r!=="precompiled",settleFrames:e.settleFrames,settleTimeoutMs:e.settleTimeoutMs??3e4,readiness:e.readiness,transform:O}}a(ar,"shaderCaptureConfiguration");async function Ur(r,e){let t=await k(r,e,s=>/\.(?:c|m)?js$/u.test(s),16384),n=false,i=false,a;for(let s of t){let o=(await j(r,s,a$1.texture,"Static application JavaScript")).data.toString("utf8");if(o.includes("nodeBuilderStateProvider")&&(n=true),o.includes("three-blocks.shader-capture.runtime.v1")&&(i=true,a??=s),n&&i)break}if(!n||!i)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,...a===void 0?{}:{id:a}}}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,""),i=y.resolve(r,n.length===0?"index.html":n);if(!e(r,i)||i===r||(await d(i)&&(await lstat(i)).isDirectory()&&(i=y.join(i,"index.html")),!await d(i)&&y.extname(i).length===0&&(i=y.join(r,"index.html")),!await d(i)))return;let a=await j(r,i,a$1.texture,"Static application asset");return {data:a.data,file:a.path}}a(Vr,"staticRequestFile");async function Gr(r,e$1,t,n,i){let a=await realpath(r.root),s=await realpath(y.resolve(a,r.serve));if(!e(a,s)||s===a)throw new Error("--serve must name a built application directory inside the project root.");let o=await Ur(a,s),u=await $(),p=Hr(e$1,t),h=Se(P(r.runtime.three)),g=createServer((d,m)=>{(async()=>{if(ir(d,m,n,i,e$1!=="precompiled"))return;let f=new URL(d.url??"/","http://three-blocks.invalid");if(d.method!=="GET"&&d.method!=="HEAD"){m.statusCode=405,m.end("GET or HEAD required");return}let S=f.pathname===Xe?u:f.pathname===Ze?p:f.pathname===er?h:void 0;if(S!==void 0){m.statusCode=200,m.setHeader("Content-Type","text/javascript; charset=utf-8"),m.setHeader("Cache-Control","no-store"),m.end(d.method==="HEAD"?void 0:S);return}let v=await Vr(s,f.pathname);if(v===void 0){m.statusCode=404,m.end("Not found");return}let R=y.extname(v.file).toLowerCase(),M=R===".html"?Buffer.from(Nr(v.data.toString("utf8"))):v.data;m.statusCode=200,m.setHeader("Content-Type",Fr[R]??"application/octet-stream"),m.setHeader("Content-Length",String(M.byteLength)),m.setHeader("Cache-Control","no-store"),m.end(d.method==="HEAD"?void 0:M);})().catch(f=>{if(m.headersSent)return m.destroy(f instanceof Error?f:void 0);m.statusCode=500,m.end(f instanceof Error?f.message:String(f));});});await new Promise((d,m)=>{g.once("error",m),g.listen(0,"127.0.0.1",()=>{g.off("error",m),d();});});let l=g.address();if(!l||typeof l=="string")throw new Error("Static capture server did not expose an ephemeral TCP address.");return {server:g,baseUrl:`http://127.0.0.1:${l.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")}a(Ye,"isRetryableShaderObservationNavigation");var K=class{static{a(this,"PlaywrightShaderDriver");}#e;#r=new ye;#n=new ge;#l;#m;#a;#s;#t;#i;#p;#d;#h;#c=0;#u;constructor(e){this.#e=e;}#o(){return this.#l?.status??this.#m??{seen:false,applied:false,alreadyPresent:false}}async#f(e){if(this.#t?.isConnected()===true)return;this.#t=void 0;let t=await xr();this.#u??=await mkdtemp(y.join(tmpdir(),"three-blocks-shader-cache-")),this.#t=await t.launch({headless:c(this.#e.headed===true),args:[...b(),`--disk-cache-dir=${this.#u}`],timeout:e.timeoutMs}),this.#c=0;}async#y(e,t){let n=this.#a!==void 0||this.#s!==void 0||this.#e.url!==void 0&&this.#i!==void 0,i=this.#s!==void 0?this.#d===e:Wr(this.#d,e,t.bridge.legacyLab);if(n&&i){this.#d=e,await this.#f(t);return}if(n&&await this.close(),this.#d=e,this.#e.url!==void 0){let a=new URL(this.#e.url);if(!["http:","https:"].includes(a.protocol)||a.username||a.password||a.hash)throw new Error("Attached shader URL must be an HTTP(S) URL without credentials or a fragment.");this.#i=a.href,this.#m={seen:true,applied:true,alreadyPresent:false,captureApplied:true,id:"attached-application"},await this.#f(t);return}if(this.#e.serve!==void 0)try{let a=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.#s=a.server,this.#m=a.transform,this.#i=a.baseUrl,await this.#f(t);return}catch(a){throw await this.close(),a}this.#l=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.#p={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 a=await Or(this.#e.root);this.#a=await a({root:this.#e.root,logLevel:"error",plugins:[this.#l.plugin,Lr(this.#r,this.#n,e!=="precompiled",P(this.#e.runtime.three))],server:{host:"127.0.0.1",port:0}}),await this.#a.listen();let s=this.#a.httpServer?.address();if(!s||typeof s=="string")throw new Error("Vite did not expose an ephemeral TCP address.");this.#i=`http://127.0.0.1:${s.port}`,await this.#f(t);}catch(a){throw await this.close(),a}}async capture(e,t){let n=Date.now();if(await this.#y("capture",t),!this.#t||!this.#i)throw new Error("Shader browser driver did not start.");let i=this.#t,a$1=await i.newContext({viewport:t.viewport});this.#e.url!==void 0&&await he(a$1,this.#r,this.#n,"capture",t,P(this.#e.runtime.three));let s=await a$1.newPage(),o=pe(s);this.#n.clear(e.key);let u=this.#r.wait(e.key,t.timeoutMs),p=Promise.race([u,o.first.then(d=>Promise.reject(d))]),h=a(()=>{},"resolveDisconnected"),g=new Promise(d=>{h=d;}),l=a(()=>h(new Error("Shader capture browser disconnected before posting a manifest.")),"onDisconnected");i.on("disconnected",l);try{let d=s.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}),m=await Ir(d,Promise.race([p,g.then(S=>Promise.reject(S))]));me(this.#o());let f=[...o.page,...o.console];if(f.length>0)throw new Error(`Capture browser errors:
+ - ${f.join(`
+ - `)}`);return a$2(m)?{...m,timing:{...a$2(m.timing)?m.timing:{},launch:n,...this.#n.firstRequest(e.key)===void 0?{}:{firstRequest:this.#n.firstRequest(e.key)},posted:Date.now()}}:m}catch(d){let m=d instanceof Error?d:new Error(String(d));this.#r.cancel(e.key,m),await u.catch(()=>{});let f=this.#n.read(e.key);if(m.message.includes("timed out")){let S=await qe(()=>s.evaluate(()=>{let v=globalThis,R=v.__threeBlocksShaderTools,M=R&&typeof R=="object"?R:void 0,q=v.document,k=Reflect.get(v,Symbol.for("three-blocks.shader-capture.cache-value.v1")),b=v.location,F=b!==null&&typeof b=="object"&&typeof Reflect.get(b,"href")=="string"?String(Reflect.get(b,"href")):"http://three-blocks.invalid/",N=new URL(F).searchParams.get("captureId")??"default",J=k!==null&&typeof k=="object"&&typeof Reflect.get(k,"registrations")=="function"?Reflect.apply(Reflect.get(k,"registrations"),k,[N]):void 0;return {documentReadyState:q?.readyState??null,parityTargetFrame:Number(v.__threeBlocksParityTargetFrame??0),parityCompletedFrame:Number(v.__threeBlocksParityCompletedFrame??0),readiness:M?.readiness??null,captureCache:k!==null&&typeof k=="object"?{activeScene:Reflect.get(k,"activeScene")??null,registrations:Array.isArray(J)?J.slice(0,16).map(B=>B!==null&&typeof B=="object"?{key:Reflect.get(B,"key")??null,kind:Reflect.get(B,"kind")??null}:null):null}:null,threeRuntimeResources:performance.getEntriesByType("resource").map(B=>B.name).filter(B=>B.includes("three.webgpu"))}}));throw new Error(`${m.message} Last capture state for "${e.key}": ${JSON.stringify({page:S,telemetry:f??null,transform:this.#o()})}`)}throw m}finally{i.off("disconnected",l),await L(()=>a$1.close()),this.#c++,(!i.isConnected()||this.#c>=(t.browserRelaunchScenes??8))&&(this.#t===i&&(this.#t=void 0),await L(()=>i.close()),this.#c=0);}}async observe(e,t,n,i){for(let a=0;a<2;a++)try{return await this.#g(e,t,n,i)}catch(s){if(a===0&&Ye(s))continue;throw s}throw new Error(`Shader observation retry was exhausted for scene "${e.key}".`)}async#g(e,t,n,i){if(await this.#y(t,n),!this.#t||!this.#i)throw new Error("Shader browser driver did not start.");let a=await this.#t.newContext({viewport:n.viewport});this.#e.url!==void 0&&await he(a,this.#r,this.#n,t,n,P(this.#e.runtime.three));let s=await a.newPage(),o=pe(s);this.#n.clear(e.key);try{await s.goto(We(this.#i,e,{threeBlocksShaderCapture:"1",threeBlocksShaderMode:t,captureId:e.key,...t==="live"?{precompiled:"0"}:{}}),{waitUntil:"domcontentloaded",timeout:n.timeoutMs}),await Promise.race([s.waitForFunction(n.bridge.legacyLab?"globalThis.__threeBlocks?.compileEnd === true":"globalThis.__threeBlocksShaderTools?.readiness?.compileEnd === true",void 0,{timeout:n.timeoutMs}),o.first.then(l=>Promise.reject(l))]),Z(await ee(s,n.bridge.legacyLab),e,n.bridge.legacyLab,this.#o(),P(this.#e.runtime.three)),await Je(s,n,o);let u=e.parityFrames??n.parity.frames,p=await re(s,n,u,i),h=Buffer.from(await s.screenshot({type:"png"}));e.parityFrames!==void 0&&u<n.parity.frames&&await re(s,n,n.parity.frames-u);let g=Z(await ee(s,n.bridge.legacyLab),e,n.bridge.legacyLab,this.#o(),P(this.#e.runtime.three));return this.#h===void 0&&(this.#h=await s.evaluate(async()=>{let l=Reflect.get(navigator,"gpu"),d=typeof l=="object"&&l!==null?Reflect.get(l,"requestAdapter"):void 0,m=typeof d=="function"?await Reflect.apply(d,l,[]):void 0,f=typeof m=="object"&&m!==null?Reflect.get(m,"info"):void 0,S=["description","device","architecture","vendor"].flatMap(v=>{let R=typeof f=="object"&&f!==null?Reflect.get(f,v):void 0;return typeof R=="string"&&R.length>0?[R]:[]});return {adapter:[...new Set(S)].join(" \xB7 ")||"WebGPU adapter",platform:navigator.platform||navigator.userAgent}})),{scene:e.key,mode:t,...g,frame:p,screenshot:h,errors:[...o.page,...o.console]}}catch(u){let p=u instanceof Error?u:new Error(String(u));if(/(?:timed?\s*out|timeout)/iu.test(p.message)){let h=this.#n.read(e.key),g=await qe(()=>s.evaluate(()=>{let l=globalThis,d=l.__threeBlocksShaderTools,m=d&&typeof d=="object"?d:void 0;return {documentReadyState:l.document?.readyState??null,parityTargetFrame:Number(l.__threeBlocksParityTargetFrame??0),parityCompletedFrame:Number(l.__threeBlocksParityCompletedFrame??0),readiness:m?.readiness??null,threeRuntimeResources:performance.getEntriesByType("resource").map(S=>S.name).filter(S=>S.includes("three.webgpu"))}}));throw new Error(`${p.message} Last ${t} state for "${e.key}": ${JSON.stringify({page:g,telemetry:h??null})}`)}throw p}finally{await L(()=>a.close());}}async observePublished(e,t){for(let n=0;n<2;n++)try{return await this.#S(e,t)}catch(i){if(n===0&&Ye(i))continue;throw i}throw new Error(`Published shader observation retry was exhausted for scene "${e.key}".`)}async#S(e,t){if(await this.#y("precompiled",t),!this.#t||!this.#i)throw new Error("Shader browser driver did not start.");let n=await this.#t.newContext({viewport:t.viewport});this.#e.url!==void 0&&await he(n,this.#r,this.#n,"precompiled",t,P(this.#e.runtime.three));let i=await n.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(h=>Promise.reject(h))]),await Je(i,t,a),Z(await ee(i,t.bridge.legacyLab),e,t.bridge.legacyLab,this.#o(),P(this.#e.runtime.three)),await re(i,t,2);let s=await ze(i),o=await re(i,t,120),u=await ze(i),p=Z(await ee(i,t.bridge.legacyLab),e,t.bridge.legacyLab,this.#o(),P(this.#e.runtime.three));return {scene:e.key,mode:"precompiled",...p,frame:o,beforeScreenshot:s,screenshot:u,errors:[...a.page,...a.console]}}finally{await L(()=>n.close());}}timingEnvironment(){return this.#h??{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.#s){let n=this.#s;n.closeAllConnections(),await L(()=>new Promise(i=>{n.close(()=>i());}));}if(this.#t=void 0,this.#a=void 0,this.#s=void 0,this.#i=void 0,this.#l=void 0,this.#m=void 0,this.#d=void 0,this.#h=void 0,this.#c=0,this.#u!==void 0&&(await rm(this.#u,{recursive:true,force:true}),this.#u=void 0),this.#p){for(let[n,i]of Object.entries(this.#p))i===void 0?delete _.env[n]:_.env[n]=i;this.#p=void 0;}}};function Ut(r){return new K(r)}a(Ut,"createPlaywrightShaderDriver");function Vt(r){return new K(r)}a(Vt,"createStaticPlaywrightShaderDriver");function Gt(r){return new K(r)}a(Gt,"createAttachedPlaywrightShaderDriver");
+export{P as a,O as b,it as c,C as d,at as e,st as f,ot as g,dt as h,ct as i,ut as j,Ir as k,Mr as l,Se as m,Wr as n,Ye as o,Ut as p,Vt as q,Gt as r};

package/dist/chunk-ZKXUYNSG.js

@@ -0,0 +1,18 @@
+import {a}from'./chunk-EI7MMDWY.js';import {createHash,randomUUID}from'crypto';import {lstat,open,realpath,mkdir,rename,rm,link,readdir,readFile,unlink}from'fs/promises';import p from'path';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 {createRequire}from'module';import {transformThreeWebgpuProviderHooks,transformThreeWebgpuCaptureInstrumentation}from'three-blocks/vite';var D=/^[a-f0-9]{64}$/,Ye=/^[0-9A-Za-z][0-9A-Za-z.+_-]{0,127}$/,be=/^[a-z0-9][a-z0-9_-]{0,63}$/,we=/^[0-9A-Za-z][0-9A-Za-z._/-]{0,127}$/;function c(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}a(c,"isRecord");function x(e){return typeof e=="string"&&Ye.test(e)}a(x,"isSafeVersion");function Q(e){if(e.length===0||e.length>512||e.includes("\\")||/[\u0000-\u001f\u007f]/.test(e))return  false;let r=e.split("/");return !e.startsWith("/")&&r.every(t=>t.length>0&&t!=="."&&t!=="..")}a(Q,"isSafeRelativePath");function Ee(e){if(!c(e)||e.schemaVersion!==2)throw new Error("three-blocks.json must use schemaVersion 2.");if(typeof e.template!="string"||!be.test(e.template))throw new Error("three-blocks.json has an invalid default shader scene key.");if(!Array.isArray(e.layers)||!e.layers.every(r=>typeof r=="string"&&we.test(r))||new Set(e.layers).size!==e.layers.length)throw new Error("three-blocks.json has invalid layers.");if(e.generator!==void 0&&(!c(e.generator)||typeof e.generator.name!="string"||!we.test(e.generator.name)||!x(e.generator.version)))throw new Error("three-blocks.json has invalid generator metadata.");if(!c(e.runtime)||!x(e.runtime.three)||!x(e.runtime.threeBlocks))throw new Error("three-blocks.json has invalid runtime versions.");if(!c(e.features)||typeof e.features.text!="boolean")throw new Error("three-blocks.json has invalid feature metadata.");if(!c(e.protocol)||e.protocol.resultFile!==1)throw new Error("three-blocks.json has an unsupported protocol schema.");if(e.artifacts!==void 0){if(!c(e.artifacts)||typeof e.artifacts.shaders!="string"||!["fresh","pending"].includes(e.artifacts.shaders)||typeof e.artifacts.text!="string"||!["fresh","pending","not-applicable"].includes(e.artifacts.text))throw new Error("three-blocks.json has invalid artifact metadata.");if(e.features.text?e.artifacts.text==="not-applicable":e.artifacts.text!=="not-applicable")throw new Error("three-blocks.json text artifact state does not match the text capability.")}return {schemaVersion:2,template:e.template,layers:e.layers,...e.generator===void 0?{}:{generator:{name:e.generator.name,version:e.generator.version}},runtime:{three:e.runtime.three,threeBlocks:e.runtime.threeBlocks},features:{text:e.features.text},...e.artifacts===void 0?{}:{artifacts:{shaders:e.artifacts.shaders,text:e.artifacts.text}},protocol:{resultFile:1}}}a(Ee,"parseProjectMetadata");function Xe(e){if(!c(e))throw new Error("Shader coverage is missing.");for(let r of ["render","vertex","fragment","compute"])if(typeof e[r]!="number"||!Number.isSafeInteger(e[r])||e[r]<0)throw new Error(`Shader coverage.${r} must be a non-negative integer.`);return e}a(Xe,"parseCoverage");function Ze(e,r){if(!c(e))throw new Error(`Shader receipt inputs for "${r}" are invalid.`);let t=Object.entries(e);if(t.length===0||t.length>4096)throw new Error(`Shader receipt inputs for "${r}" must contain between 1 and 4096 files.`);for(let[n,i]of t)if(!Q(n)||typeof i!="string"||!D.test(i))throw new Error(`Shader receipt input for "${r}" is invalid.`)}a(Ze,"parseInputs");function F(e){if(!c(e)||e.schemaVersion!==2||!c(e.runtime)||!x(e.runtime.three)||!x(e.runtime.threeBlocks)||typeof e.runtime.threeBlocksShaderClosure!="string"||!D.test(e.runtime.threeBlocksShaderClosure)||!c(e.scenes))throw new Error("Shader meta.json does not match receipt schema 2.");if(e.runtime.capture!==void 0&&(!c(e.runtime.capture)||typeof e.runtime.capture.userAgent!="string"||e.runtime.capture.userAgent.length>1024||typeof e.runtime.capture.adapter!="string"||e.runtime.capture.adapter.length>1024||!Array.isArray(e.runtime.capture.features)||e.runtime.capture.features.length>256||!e.runtime.capture.features.every(t=>typeof t=="string"&&t.length>0&&t.length<=128)))throw new Error("Shader meta.json has invalid browser capture provenance.");let r=Object.entries(e.scenes);if(r.length===0)throw new Error("Shader meta.json contains no scenes.");for(let[t,n]of r){if(!be.test(t)||!c(n)||typeof n.artifact!="string"||!Q(n.artifact)||!n.artifact.endsWith(".webgpu.ts")||typeof n.artifactHash!="string"||!D.test(n.artifactHash))throw new Error(`Shader receipt for "${t}" is invalid.`);if(n.asset===void 0!=(n.assetHash===void 0)||n.asset!==void 0&&(typeof n.asset!="string"||!Q(n.asset)||!n.asset.endsWith(".json")||typeof n.assetHash!="string"||!D.test(n.assetHash)))throw new Error(`Shader static asset receipt for "${t}" is invalid.`);if(Ze(n.inputs,t),Xe(n.coverage),n.bytes!==void 0&&(!Number.isSafeInteger(n.bytes)||Number(n.bytes)<0))throw new Error(`Shader receipt byte count for "${t}" is invalid.`);if(n.skipped!==void 0&&(!c(n.skipped)||!Number.isSafeInteger(n.skipped.render)||Number(n.skipped.render)<0||!Number.isSafeInteger(n.skipped.compute)||Number(n.skipped.compute)<0))throw new Error(`Shader receipt skipped-build counts for "${t}" are invalid.`)}if(e.tool!==void 0&&(!c(e.tool)||e.tool.name!=="@three-blocks/devtools"||!x(e.tool.version)||typeof e.tool.compatibility!="string"||!Number.isSafeInteger(e.tool.transform)||!Number.isSafeInteger(e.tool.address)||!Number.isSafeInteger(e.tool.recipe)||!Number.isSafeInteger(e.tool.hydration)))throw new Error("Shader meta.json has invalid tool compatibility metadata.");return e}a(F,"parseShaderReceipt");var $=Object.freeze({metadata:1024*1024,receipt:2*1024*1024,manifest:32*1024*1024,semanticInput:8*1024*1024,semanticTotal:64*1024*1024,metrics:8*1024*1024,texture:128*1024*1024,packageJson:1024*1024});function re(e){return typeof e=="object"&&e!==null&&"code"in e&&typeof e.code=="string"?e.code:void 0}a(re,"errorCode");function R(e){return createHash("sha256").update(e).digest("hex")}a(R,"sha256");async function b(e){try{return await lstat(e),!0}catch(r){if(re(r)==="ENOENT")return  false;throw r}}a(b,"pathExists");function _(e,r){let t=p.relative(e,r);return t===""||!p.isAbsolute(t)&&t!==".."&&!t.startsWith(`..${p.sep}`)}a(_,"isWithin");function P(e){return JSON.stringify(e)}a(P,"displayPath");async function Ae(e,r,t){let n=await open(e,"r");try{let[i,o,s]=await Promise.all([lstat(e),n.stat(),realpath(e)]);if(i.isSymbolicLink())throw new Error(`${t} must not be a symbolic link: ${P(e)}.`);if(!o.isFile())throw new Error(`${t} must be a regular file: ${P(e)}.`);if(o.size>r)throw new Error(`${t} exceeds the ${r}-byte inspection limit: ${P(e)}.`);let d=await n.readFile();if(d.byteLength>r)throw new Error(`${t} grew beyond the ${r}-byte inspection limit while being read.`);return {path:s,data:d}}finally{await n.close();}}a(Ae,"readBoundedRegularFile");async function j(e,r){let t=p.dirname(e);await mkdir(t,{recursive:true});try{if((await lstat(e)).isSymbolicLink())throw new Error(`Atomic write target must not be a symbolic link: ${P(e)}.`)}catch(o){if(re(o)!=="ENOENT")throw o}let n=p.join(t,`.${p.basename(e)}.${process.pid}.${randomUUID()}.tmp`),i;try{i=await open(n,"wx",384),await i.writeFile(r),await i.sync(),await i.close(),i=void 0,await rename(n,e);}finally{await i?.close().catch(()=>{}),await rm(n,{force:true});}}a(j,"writeAtomicRegularFile");async function je(e,r){let t=p.dirname(e);await mkdir(t,{recursive:true});let n=p.join(t,`.${p.basename(e)}.${process.pid}.${randomUUID()}.tmp`),i;try{i=await open(n,"wx",384),await i.writeFile(r),await i.sync(),await i.close(),i=void 0;try{return await link(n,e),!0}catch(o){if(re(o)==="EEXIST")return !1;throw o}}finally{await i?.close().catch(()=>{}),await rm(n,{force:true});}}a(je,"writeNewRegularFile");async function $r(e,r,t){return Ae(e,r,t)}a($r,"readExternalRegularFile");async function v(e,r,t){let n=p.resolve(e),i=p.resolve(r);if(!_(n,i))throw new Error(`${t} escapes its allowed directory.`);let o=await lstat(i);if(o.isSymbolicLink())throw new Error(`${t} must not be a symbolic link.`);if(!o.isDirectory())throw new Error(`${t} must be a directory.`);let[s,d]=await Promise.all([realpath(n),realpath(i)]);if(!_(s,d))throw new Error(`${t} resolves outside its allowed directory.`);return d}a(v,"canonicalDirectoryWithin");async function I(e,r,t,n){let i=p.resolve(e),o=p.resolve(r);if(!_(i,o)||i===o)throw new Error(`${n} escapes its allowed directory.`);let s=await Ae(o,t,n),d=await realpath(i);if(!_(d,s.path)||d===s.path)throw new Error(`${n} resolves outside its allowed directory.`);return s}a(I,"readRegularFileWithin");async function Ir(e,r,t,n=8192){let o=[await v(e,r,"Inspected directory")],s=[],d=0;for(;o.length>0;){let l=o.shift();if(l===void 0)break;let g=(await readdir(l,{withFileTypes:true})).sort((f,y)=>f.name.localeCompare(y.name));for(let f of g){if(d+=1,d>n)throw new Error(`Inspected directory exceeds the ${n}-entry limit.`);let y=p.join(l,f.name);if(f.isSymbolicLink())throw new Error(`Inspected directory contains a symbolic link: ${P(p.relative(e,y))}.`);if(f.isDirectory()){o.push(await v(e,y,"Nested inspected directory"));continue}if(f.isFile()&&t(f.name))s.push(y);else if(t(f.name))throw new Error(`Semantic input is not a regular file: ${P(y)}.`)}}return s.sort()}a(Ir,"listRegularFilesRecursively");var ne="three-blocks.shaders.json",Lr=".three-blocks/shaders",vr=".three-blocks/shaders/parity",ir=/^[a-z0-9][a-z0-9_-]{0,63}$/u,or=/^[A-Za-z_$][A-Za-z0-9_$]*(?:\.[A-Za-z_$][A-Za-z0-9_$]*)*$/u,Ce=64,xe=64,Pe={schemaVersion:1,scenes:[{key:"default",url:"/"}]};function _e(e,r,t){if(e===void 0)return t;if(typeof e!="string"||e.length===0||e.length>512||p.isAbsolute(e)||/[\u0000-\u001f\u007f]/u.test(e))throw new Error(`${r} must be a bounded project-relative directory.`);let n=p.posix.normalize(e.replaceAll("\\","/")).replace(/\/+$/u,"");if(n==="."||n===".."||n.startsWith("../"))throw new Error(`${r} must stay inside the project.`);return n}a(_e,"safeProjectDirectory");function sr(e,r){let t=_e(e,r,"");if(typeof e!="string"||e.endsWith("/"))throw new Error(`${r} must be a project-relative file.`);return t}a(sr,"safeProjectFile");function A(e,r,t,n,i){if(e===void 0)return i;if(!Number.isSafeInteger(e)||Number(e)<t||Number(e)>n)throw new Error(`${r} must be an integer in ${t}...${n}.`);return Number(e)}a(A,"boundedInteger");function $e(e,r,t){if(e===void 0)return t;if(typeof e!="number"||!Number.isFinite(e)||e<0||e>1)throw new Error(`${r} must be a finite ratio in 0...1.`);return e}a($e,"finiteRatio");function Ie(e,r){if(typeof e!="string"||e.length===0||e.length>2048||/[\u0000-\u001f\u007f]/u.test(e))throw new Error(`${r} must be a bounded project-relative URL.`);let t;try{t=new URL(e,"http://three-blocks.invalid/");}catch{throw new Error(`${r} is not a valid URL.`)}if(t.origin!=="http://three-blocks.invalid"||t.hash.length>0)throw new Error(`${r} must stay within the project and must not contain a fragment.`);return `${t.pathname}${t.search}`}a(Ie,"safeBrowserUrl");function ar(e){if(!Array.isArray(e)||e.length===0||e.length>Ce)throw new Error(`Shader config scenes must contain 1...${Ce} entries.`);let r=new Set;return e.map((t,n)=>{if(!c(t)||typeof t.key!="string"||!ir.test(t.key))throw new Error(`Shader config scene ${n} has an invalid key.`);if(r.has(t.key))throw new Error(`Shader config scene key "${t.key}" is duplicated.`);r.add(t.key);let i=t.parityFrames,o=t.maxDiffRatio;if(t.inputs!==void 0&&(!Array.isArray(t.inputs)||t.inputs.length===0||t.inputs.length>xe))throw new Error(`Shader config scene "${t.key}" inputs must contain 1...${xe} files.`);let s=t.inputs===void 0?void 0:t.inputs.map((d,l)=>sr(d,`Shader config scene "${t.key}" input ${l}`));if(s!==void 0&&new Set(s).size!==s.length)throw new Error(`Shader config scene "${t.key}" inputs must be unique.`);if(t.runtimeMotion!==void 0&&typeof t.runtimeMotion!="boolean")throw new Error(`Shader config scene "${t.key}" runtimeMotion must be a boolean.`);return {key:t.key,url:Ie(t.url,`Shader config scene "${t.key}" URL`),requiresText:t.requiresText===true,...s===void 0?{}:{inputs:s},...i===void 0?{}:{parityFrames:A(i,`Shader config scene "${t.key}" parityFrames`,0,1e4,0)},...o===void 0?{}:{maxDiffRatio:$e(o,`Shader config scene "${t.key}" maxDiffRatio`,.01)},...t.runtimeMotion===true?{runtimeMotion:true}:{}}})}a(ar,"parseScenes");function H(e){if(!c(e)||e.schemaVersion!==void 0&&e.schemaVersion!==1)throw new Error("Shader config must use schemaVersion 1.");let r=e.viewport;if(r!==void 0&&!c(r))throw new Error("Shader config viewport must be an object.");let t=e.parity;if(t!==void 0&&!c(t))throw new Error("Shader config parity must be an object.");let n=e.bridge;if(n!==void 0&&!c(n))throw new Error("Shader config bridge must be an object.");let i=c(n)?n.deterministicModule:void 0;i!==void 0&&Ie(i,"Shader deterministic module");let o=e.readiness;if(o!==void 0&&!c(o))throw new Error("Shader config readiness must be an object.");let s=c(o)?o.selector:void 0;if(s!==void 0&&(typeof s!="string"||s.length===0||s.length>512||/[\u0000-\u001f\u007f]/u.test(s)))throw new Error("Shader readiness selector must be a bounded, non-empty CSS selector.");let d=c(o)?o.global:void 0;if(d!==void 0&&(typeof d!="string"||!or.test(d)))throw new Error("Shader readiness global must be a dot-separated JavaScript property path.");return {schemaVersion:1,scenes:ar(e.scenes),settleFrames:A(e.settleFrames,"Shader settleFrames",0,1e4,60),settleTimeoutMs:A(e.settleTimeoutMs,"Shader settleTimeoutMs",1e3,15*6e4,3e4),browserRelaunchScenes:A(e.browserRelaunchScenes,"Shader browserRelaunchScenes",1,64,8),timeoutMs:A(e.timeoutMs,"Shader timeoutMs",1e3,15*6e4,24e4),viewport:{width:A(c(r)?r.width:void 0,"Shader viewport width",64,8192,1024),height:A(c(r)?r.height:void 0,"Shader viewport height",64,8192,640)},parity:{frames:A(c(t)?t.frames:void 0,"Shader parity frames",0,1e4,90),channelTolerance:A(c(t)?t.channelTolerance:void 0,"Shader parity channelTolerance",0,255,8),maxDiffRatio:$e(c(t)?t.maxDiffRatio:void 0,"Shader parity maxDiffRatio",.01)},bridge:{legacyLab:c(n)&&n.legacyLab===true,...typeof i=="string"?{deterministicModule:i}:{}},readiness:{...typeof s=="string"?{selector:s}:{},...typeof d=="string"?{global:d}:{}},publicDir:_e(e.publicDir,"Shader publicDir","public"),allowLiveBuilds:e.allowLiveBuilds!==false}}a(H,"parseShaderToolConfig");async function Vr(e=process.cwd()){let r=p.resolve(e);for(;;){if(await b(p.join(r,ne))||await b(p.join(r,"three-blocks.json")))return realpath(r);let t=p.join(r,"package.json");if(await b(t)){let i=await I(r,t,$.packageJson,"Project package.json"),o;try{o=JSON.parse(i.data.toString("utf8"));}catch{throw new Error(`Project package.json is not valid JSON: ${t}.`)}if(c(o)&&[o.dependencies,o.devDependencies,o.peerDependencies,o.optionalDependencies].filter(c).some(l=>typeof l.three=="string"||typeof l["three-blocks"]=="string"||typeof l["@three-blocks/devtools"]=="string"))return realpath(r)}let n=p.dirname(r);if(n===r)throw new Error(`No Three Blocks shader project found from ${JSON.stringify(p.resolve(e))}; add Three.js to package.json or pass --root.`);r=n;}}a(Vr,"findShaderProjectRoot");async function te(e){let r=await realpath(e),t=p.join(r,ne);if(await b(t)){let i=await I(r,t,$.metadata,"Shader configuration");return H(JSON.parse(i.data.toString("utf8")))}let n=p.join(r,"three-blocks.json");if(await b(n)){let i=Ee(JSON.parse(await readFile(n,"utf8")));return H({schemaVersion:1,scenes:[{key:i.template,url:"/",requiresText:i.features.text}]})}return H(Pe)}a(te,"loadShaderToolConfig");async function Hr(e){let r=await realpath(e);for(let o of ["vite.config.ts","vite.config.mts","vite.config.js","vite.config.mjs","vite.config.cts","vite.config.cjs"])if(await b(p.join(r,o)))return {driverKind:"vite",reason:`Detected ${o}.`};let t,n=p.join(r,"package.json");if(await b(n)){let o=await I(r,n,$.packageJson,"Project package.json"),s=JSON.parse(o.data.toString("utf8"));c(s)&&(t=s);}let i=a(o=>[t?.dependencies,t?.devDependencies,t?.peerDependencies,t?.optionalDependencies].some(s=>c(s)&&typeof s[o]=="string"),"hasDependency");if(i("vite"))return {driverKind:"vite",reason:"Detected the Vite dependency."};for(let o of ["dist","build","out"])if(await b(p.join(r,o,"index.html")))return {driverKind:"static",serve:o,reason:`Detected the built ${o}/index.html application.`};if(i("next"))throw new Error("Detected Next.js without an attach URL. Run `shaders capture` without an explicit driver or URL to preview the withThreeBlocksNext adapter and start a project-local capture server, or pass --url <local-url> for a server you manage.");if(i("webpack")||i("esbuild")||i("rollup"))throw new Error("Detected a non-Vite bundler but no static index.html. Run `shaders capture` without an explicit driver or URL to preview adapter wiring and build the project, or build it yourself and pass --driver static --serve <directory>.");return {driverKind:"vite",reason:"Using the Vite golden-path driver."}}a(Hr,"inferShaderCaptureTarget");async function Ur(e){let r=await realpath(e),t=p.join(r,ne);if(await b(t))return {config:await te(r),file:t,created:false};let n=p.join(r,"three-blocks.json");if(await b(n))return {config:await te(r),file:n,created:false};let i=Pe,o=H(i),s=await je(t,`${JSON.stringify(i,null,2)}
+`);return {config:s?o:await te(r),file:t,created:s}}a(Ur,"ensureShaderToolConfig");function ie(e){if(/^0\.185\./u.test(e))return THREE_WEBGPU_R185_COMPATIBILITY;if(e===THREE_R186DEV_VERSION)return THREE_WEBGPU_R186DEV_COMPATIBILITY;throw new Error(`Three.js ${e} is outside the supported shader compatibility contracts.`)}a(ie,"shaderCompatibilityForThree");var oe="0.1.0";var ue=50,pe="timing.local.json",le="timing.json",fe="parity.json",U=4096,fr=4096;function ae(e,r,t=8192){if(typeof e!="string"||e.length===0||e.length>t||/[\u0000\u007f]/u.test(e))throw new Error(`${r} must be a bounded non-empty string.`);return e}a(ae,"boundedString");function m(e,r,t=true){if(typeof e!="number"||!Number.isFinite(e)||e<0||t&&!Number.isSafeInteger(e))throw new Error(`${r} must be a non-negative ${t?"integer":"finite number"}.`);return e}a(m,"nonNegativeNumber");function mr(e){if(!c(e))throw new Error("Shader capture stats are missing.");let r={buildCalls:m(e.buildCalls,"capture stats.buildCalls"),renderBuilds:m(e.renderBuilds,"capture stats.renderBuilds"),computeBuilds:m(e.computeBuilds,"capture stats.computeBuilds"),registeredBuilds:m(e.registeredBuilds,"capture stats.registeredBuilds"),registeredRenderBuilds:m(e.registeredRenderBuilds,"capture stats.registeredRenderBuilds"),registeredComputeBuilds:m(e.registeredComputeBuilds,"capture stats.registeredComputeBuilds"),buildMs:m(e.buildMs,"capture stats.buildMs",false),injected:m(e.injected,"capture stats.injected"),injectedRender:m(e.injectedRender,"capture stats.injectedRender"),injectedCompute:m(e.injectedCompute,"capture stats.injectedCompute"),missed:m(e.missed,"capture stats.missed"),missedRender:m(e.missedRender,"capture stats.missedRender"),missedCompute:m(e.missedCompute,"capture stats.missedCompute"),...Array.isArray(e.missedKeys)&&e.missedKeys.every(t=>typeof t=="string")?{missedKeys:e.missedKeys.slice(0,U)}:{}};if(r.renderBuilds+r.computeBuilds!==r.buildCalls||r.registeredRenderBuilds+r.registeredComputeBuilds!==r.registeredBuilds||r.injectedRender+r.injectedCompute!==r.injected||r.missedRender+r.missedCompute!==r.missed||r.registeredBuilds>r.buildCalls)throw new Error("Shader capture stats totals are inconsistent.");return r}a(mr,"captureStats");function hr(e){if(!Array.isArray(e)||e.length>U)throw new Error("Shader capture skipped builds are invalid.");return e.map((r,t)=>{if(!c(r)||r.kind!=="render"&&r.kind!=="compute")throw new Error(`Shader capture skipped build ${t} is invalid.`);return {kind:r.kind,name:ae(r.name,`skipped build ${t} name`,512),reason:ae(r.reason,`skipped build ${t} reason`)}})}a(hr,"skippedBuilds");function yr(e){let r=0,t=0,n=0,i=0;for(let o of Object.values(e.entries)){let s=e.states[o];s!==void 0&&((s.vertex!==null||s.fragment!==null)&&r++,s.vertex!==null&&t++,s.fragment!==null&&n++,s.compute!==null&&i++);}return {render:r,vertex:t,fragment:n,compute:i}}a(yr,"shaderCoverage");function ot(e,r){if(!c(e))throw new Error("Shader capture payload must be an object.");if(e.scene!==r.scene)throw new Error(`Shader capture scene does not match "${r.scene}".`);if(e.protocolVersion!==2)throw new Error("Shader capture protocolVersion must be 2.");let t=ie(r.runtime.three);if(e.compatibility!==t)throw new Error(`Shader capture compatibility must be "${t}".`);if(!c(e.entries))throw new Error("Shader capture entries must be an object.");let n=Object.keys(e.entries).length;if(n===0||n>U)throw new Error(`Shader capture must contain 1...${U} entries.`);if(!Array.isArray(e.errors)||e.errors.length>fr)throw new Error("Shader capture errors are invalid.");let i=e.errors.map((h,u)=>ae(h,`capture error ${u}`,64*1024));if(i.length>0)throw new Error(`Shader capture failed:
+ - ${i.join(`
+ - `)}`);let o=hr(e.skipped),s=mr(e.stats),d=c(e.timing)?e.timing:void 0,l=d===void 0?void 0:Object.fromEntries(["launch","firstRequest","readiness","lastBuild","settled","posted"].flatMap(h=>{let u=d[h];if(u===void 0)return [];if(typeof u!="number"||!Number.isFinite(u)||u<0)throw new Error(`Shader capture timing.${h} is invalid.`);return [[h,u]]})),g;if(e.provenance!==void 0){if(!c(e.provenance)||typeof e.provenance.userAgent!="string"||e.provenance.userAgent.length>1024||typeof e.provenance.adapter!="string"||e.provenance.adapter.length>1024||!Array.isArray(e.provenance.features)||e.provenance.features.length>256||!e.provenance.features.every(h=>typeof h=="string"&&h.length<=128))throw new Error("Shader capture provenance is invalid.");g={userAgent:e.provenance.userAgent,adapter:e.provenance.adapter,features:[...new Set(e.provenance.features)].sort()};}let f=parsePrecompiledManifest({version:PRECOMPILED_MANIFEST_VERSION,scene:r.scene,three:r.runtime.three,threeBlocks:r.runtime.threeBlocks,runtime:{id:t,address:SHADER_ADDRESS_SCHEMA_VERSION,recipe:SHADER_RECIPE_SCHEMA_VERSION,hydration:SHADER_HYDRATION_SCHEMA_VERSION},...e.automatic===void 0?{}:{automatic:e.automatic},modules:e.modules,nodes:e.nodes,layouts:e.layouts,attributePlans:e.attributePlans,updatePlans:e.updatePlans,requirementPlans:e.requirementPlans,states:e.states,entries:e.entries}),y=yr(f);if(s.registeredRenderBuilds<y.render||s.registeredComputeBuilds<y.compute)throw new Error("Shader capture did not live-build every distinct registered render/compute entry.");return {scene:r.scene,manifest:f,skipped:o,stats:s,coverage:y,...l===void 0?{}:{timing:l},...g===void 0?{}:{provenance:g}}}a(ot,"validateShaderCapture");function T(e,r=0){let t="	".repeat(r),n="	".repeat(r+1);if(Array.isArray(e))return e.length===0?"[]":e.every(o=>o===null||["number","string","boolean"].includes(typeof o))?JSON.stringify(e):`[
+${e.map(o=>`${n}${T(o,r+1)}`).join(`,
+`)}
+${t}]`;if(e!==null&&typeof e=="object"){let o=e,s=Object.keys(o).sort();return s.length===0?"{}":`{
+${s.map(d=>{let l=o[d];return `${n}${JSON.stringify(d)}: ${T(l,r+1)}`}).join(`,
+`)}
+${t}}`}let i=JSON.stringify(e);if(i===void 0)throw new Error("Shader artifact contains a non-serializable value.");return i}a(T,"stableStringify");function gr(e){return ["// GENERATED FILE \u2014 do not edit by hand.","// Produced by @three-blocks/devtools.","import type { PrecompiledManifest } from 'three-blocks/shaders';","",`export default ${T(e)} satisfies PrecompiledManifest;`,""].join(`
+`)}a(gr,"serializeShaderManifest");function Oe(e,r){if(typeof e!="string"||e.length===0||e.length>256||/[\u0000-\u001f\u007f]/u.test(e))throw new Error(`${r} is invalid.`);return e}a(Oe,"timingLabel");function de(e){if(!c(e)||e.schemaVersion!==3||e.source!=="latest-local-capture"&&e.source!=="committed-capture"||typeof e.receiptHash!="string"||!/^[a-f0-9]{64}$/u.test(e.receiptHash)||typeof e.measuredAt!="string"||!Number.isFinite(Date.parse(e.measuredAt))||!c(e.scenes))throw new Error("Shader timing is invalid.");let r={};for(let[n,i]of Object.entries(e.scenes)){if(n.length===0||n.length>128||!c(i))throw new Error("Shader timing scene is invalid.");let o={builds:m(i.builds,`timing ${n}.builds`),liveBuildMs:m(i.liveBuildMs,`timing ${n}.liveBuildMs`,false),precompiledBuildMs:m(i.precompiledBuildMs,`timing ${n}.precompiledBuildMs`,false),avoidedBuildMs:m(i.avoidedBuildMs,`timing ${n}.avoidedBuildMs`,false),runs:m(i.runs,`timing ${n}.runs`),spreadMs:m(i.spreadMs,`timing ${n}.spreadMs`,false)};if(o.runs<1)throw new Error(`Shader timing runs are invalid for scene "${n}".`);if(Math.abs(o.avoidedBuildMs-Math.max(0,o.liveBuildMs-o.precompiledBuildMs))>.001)throw new Error(`Shader timing delta is inconsistent for scene "${n}".`);r[n]=o;}if(Object.keys(r).length===0)throw new Error("Shader timing contains no scenes.");let t={schemaVersion:3,receiptHash:e.receiptHash,measuredAt:e.measuredAt,scenes:r};return e.source==="latest-local-capture"?{...t,source:"latest-local-capture"}:{...t,source:"committed-capture",adapter:Oe(e.adapter,"Shader timing adapter"),platform:Oe(e.platform,"Shader timing platform")}}a(de,"parseShaderTiming");function W(e){return /^[a-z0-9][a-z0-9_-]{0,63}$/u.test(e)}a(W,"validParityScene");function Ne(e){return typeof e=="string"&&Number.isFinite(Date.parse(e))}a(Ne,"validParityTimestamp");function me(e){if(!c(e))throw new Error("Shader parity evidence is invalid.");if(e.schemaVersion===1){if(typeof e.receiptHash!="string"||!/^[a-f0-9]{64}$/u.test(e.receiptHash)||!Ne(e.verifiedAt)||!Array.isArray(e.scenes)||e.scenes.length===0||e.scenes.length>64||!e.scenes.every(n=>typeof n=="string"&&W(n)))throw new Error("Shader parity evidence is invalid.");return {schemaVersion:1,receiptHash:e.receiptHash,verifiedAt:e.verifiedAt,scenes:[...new Set(e.scenes)].sort()}}if(e.schemaVersion!==2||!c(e.scenes))throw new Error("Shader parity evidence is invalid.");let r=Object.entries(e.scenes);if(r.length===0||r.length>64)throw new Error("Shader parity evidence is invalid.");let t={};for(let[n,i]of r.sort(([o],[s])=>o.localeCompare(s))){if(!W(n)||!c(i)||typeof i.fingerprint!="string"||!/^[a-f0-9]{64}$/u.test(i.fingerprint)||!Ne(i.verifiedAt))throw new Error("Shader parity evidence is invalid.");t[n]={fingerprint:i.fingerprint,verifiedAt:i.verifiedAt};}return {schemaVersion:2,scenes:t}}a(me,"parseShaderParityEvidence");function ce(e,r){let t=e.scenes[r];if(t===void 0)throw new Error(`Shader receipt has no scene "${r}" for parity evidence.`);return R(T({runtime:{three:e.runtime.three,threeBlocks:e.runtime.threeBlocks,threeBlocksShaderClosure:e.runtime.threeBlocksShaderClosure},...e.tool===void 0?{}:{tool:e.tool},scene:t}))}a(ce,"shaderSceneParityFingerprint");async function z(e,r,t,n){let i=p.join(e,t);try{if(!await b(i))return;let o=await lstat(i);if(o.isSymbolicLink()||!o.isFile()||o.size>1024*1024)return;let s=de(JSON.parse(await readFile(i,"utf8")));return s.source===n&&s.receiptHash===R(r)?s:void 0}catch{return}}a(z,"readShaderTimingFile");async function st(e,r){let t=await z(e,r,pe,"latest-local-capture");return t?.source==="latest-local-capture"?t:void 0}a(st,"readShaderLocalTiming");async function at(e,r){return await z(e,r,pe,"latest-local-capture")??await z(e,r,le,"committed-capture")}a(at,"readShaderTiming");async function Ve(e,r){let t=p.join(e,fe);try{if(!await b(t))return;let n=await lstat(t);if(n.isSymbolicLink()||!n.isFile()||n.size>1024*1024)return;let i=me(JSON.parse(await readFile(t,"utf8"))),o=F(JSON.parse(Buffer.from(r).toString("utf8"))),s={};if(i.schemaVersion===1){if(i.receiptHash!==R(r))return;for(let d of i.scenes)o.scenes[d]!==void 0&&(s[d]={fingerprint:ce(o,d),verifiedAt:i.verifiedAt});}else for(let[d,l]of Object.entries(i.scenes))o.scenes[d]===void 0||l.fingerprint!==ce(o,d)||(s[d]=l);return Object.keys(s).length===0?void 0:{schemaVersion:2,scenes:s}}catch{return}}a(Ve,"readShaderParityEvidence");async function dt(e,r){let t=await z(e,r,le,"committed-capture");return t?.source==="committed-capture"?t:void 0}a(dt,"readShaderCommittedTiming");async function He(e,r,t){let n=await G(e),i=p.join(n,"meta.json"),o=await lstat(i);if(o.isSymbolicLink()||!o.isFile())throw new Error("Shader receipt must be a regular file before timing.");let s=await readFile(i),d=new Date().toISOString(),l=Object.fromEntries(Object.entries(r).sort(([y],[h])=>y.localeCompare(h))),g=de({schemaVersion:3,receiptHash:R(s),measuredAt:d,source:"latest-local-capture",scenes:l});if(await j(p.join(n,pe),`${T(g)}
+`),t===void 0)return {local:g};let f=de({schemaVersion:3,receiptHash:R(s),measuredAt:d,source:"committed-capture",adapter:t.adapter,platform:t.platform,scenes:l});return await j(p.join(n,le),`${T(f)}
+`),{local:g,committed:f}}a(He,"writeShaderTimings");async function ct(e,r){return (await He(e,r)).local}a(ct,"writeShaderLocalTiming");async function ut(e,r,t){if(r.length===0||r.length>64||r.some(h=>!W(h)))throw new Error("Shader parity evidence must contain 1...64 valid scene keys.");let n=await G(e),i=p.join(n,"meta.json"),o=await lstat(i);if(o.isSymbolicLink()||!o.isFile())throw new Error("Shader receipt must be a regular file before parity evidence.");let s=await readFile(i);if(t!==void 0&&R(s)!==R(t))throw new Error("Shader receipt changed during browser parity verification; completed observations were not attached to the new receipt.");let d=F(JSON.parse(s.toString("utf8"))),l=await Ve(n,s),g=new Date().toISOString(),f={...l?.scenes};for(let h of [...new Set(r)].sort())f[h]={fingerprint:ce(d,h),verifiedAt:g};let y=me({schemaVersion:2,scenes:f});return await j(p.join(n,fe),`${T(y)}
+`),y}a(ut,"writeShaderParityEvidence");async function pt(e,r,t){if(r.length===0||r.length>64||r.some(f=>!W(f)))throw new Error("Shader parity invalidation must contain 1...64 valid scene keys.");let n=await G(e),i=await readFile(p.join(n,"meta.json"));if(R(i)!==R(t))throw new Error("Shader receipt changed before prior parity evidence could be invalidated.");let o=await Ve(n,i);if(o===void 0)return;let s=new Set(r),d=Object.fromEntries(Object.entries(o.scenes).filter(([f])=>!s.has(f))),l=p.join(n,fe);if(Object.keys(d).length===0){await unlink(l).catch(f=>{if(!c(f)||f.code!=="ENOENT")throw f});return}let g=me({schemaVersion:2,scenes:d});await j(l,`${T(g)}
+`);}a(pt,"removeShaderParityEvidence");async function lt(e,r,t){let n=await He(e,r,t);if(n.committed===void 0)throw new Error("Committed shader timing was not written.");return {local:n.local,committed:n.committed}}a(lt,"writeShaderTimingTwins");async function Be(e){if(!await b(e)){await mkdir(e);return}let r=await lstat(e);if(r.isSymbolicLink()||!r.isDirectory())throw new Error(`Shader artifact path is not a real directory: ${e}.`)}a(Be,"assertDirectory");async function G(e){let r=p.resolve(e),t=p.join(r,".three-blocks");await Be(t);let n=p.join(t,"shaders");return await Be(n),n}a(G,"artifactRoot");async function ft(e){let r=await G(e.root),t=ie(e.runtime.three),n=p.resolve(e.root),i=p.resolve(n,e.publicDirectory??"public");if(!_(n,i)||i===n)throw new Error("Shader public directory must stay inside the project root.");let o=p.join(i,"three-blocks","shaders");await mkdir(o,{recursive:true}),await v(n,o,"Shader static-asset directory");let s={},d=[];for(let u of [...e.scenes].sort((k,M)=>k.key.localeCompare(M.key))){let k=e.captures.get(u.key),M=e.inputs.get(u.key);if(M===void 0)throw new Error(`Shader input matrix is missing scene "${u.key}".`);if(k===void 0){let S=e.previousReceipt?.scenes[u.key];if(S===void 0)throw new Error(`Capture matrix is missing scene "${u.key}".`);let X=await readFile(p.join(r,S.artifact));if(R(X)!==S.artifactHash)throw new Error(`Preserved shader artifact checksum differs for scene "${u.key}".`);if(S.asset!==void 0&&S.assetHash!==void 0){let Z=await readFile(p.join(i,S.asset));if(R(Z)!==S.assetHash)throw new Error(`Preserved static shader manifest checksum differs for scene "${u.key}".`)}s[u.key]={...S,inputs:Object.fromEntries(Object.entries(M).sort(([Z],[qe])=>Z.localeCompare(qe)))},d.push(S.artifact),S.asset!==void 0&&d.push(p.relative(n,p.join(i,S.asset)).split(p.sep).join("/"));continue}if(k.scene!==u.key||k.manifest.scene!==u.key)throw new Error(`Capture matrix scene "${u.key}" is inconsistent.`);let K=`${u.key}.webgpu.ts`,q=gr(k.manifest);await j(p.join(r,K),q),d.push(K);let Y=`three-blocks/shaders/${u.key}.json`,ge=`${T(k.manifest)}
+`;await j(p.join(i,Y),ge),d.push(p.relative(n,p.join(i,Y)).split(p.sep).join("/"));let Se=k.skipped.filter(S=>S.kind==="render").length,Ke=k.skipped.length-Se;s[u.key]={artifact:K,artifactHash:R(q),asset:Y,assetHash:R(ge),inputs:Object.fromEntries(Object.entries(M).sort(([S],[X])=>S.localeCompare(X))),coverage:k.coverage,bytes:Buffer.byteLength(q),skipped:{render:Se,compute:Ke}};}let l=[...e.captures.values()].find(u=>u.provenance!==void 0)?.provenance??e.previousReceipt?.runtime.capture,g={schemaVersion:2,runtime:{...e.runtime,...l===void 0?{}:{capture:l}},tool:{name:"@three-blocks/devtools",version:oe,compatibility:t,transform:ue,address:SHADER_ADDRESS_SCHEMA_VERSION,recipe:SHADER_RECIPE_SCHEMA_VERSION,hydration:SHADER_HYDRATION_SCHEMA_VERSION},scenes:s},f=new Set(d);for(let u of await readdir(r,{withFileTypes:true}))if(!(!u.name.endsWith(".webgpu.ts")||f.has(u.name))){if(u.isSymbolicLink()||!u.isFile())throw new Error(`Orphan shader artifact is not a regular file: ${u.name}.`);await unlink(p.join(r,u.name));}let y=new Set(e.scenes.map(u=>`${u.key}.json`)),h=new Set(Object.values(e.previousReceipt?.scenes??{}).map(u=>u.asset===void 0?void 0:p.posix.basename(u.asset)).filter(u=>u!==void 0));try{let u=F(JSON.parse(await readFile(p.join(r,"meta.json"),"utf8")));for(let k of Object.values(u.scenes))k.asset!==void 0&&h.add(p.posix.basename(k.asset));}catch{}for(let u of await readdir(o,{withFileTypes:true}))if(!(!u.name.endsWith(".json")||y.has(u.name))&&h.has(u.name)){if(u.isSymbolicLink()||!u.isFile())throw new Error(`Orphan shader static asset is not a regular file: ${u.name}.`);await unlink(p.join(o,u.name));}return await j(p.join(r,"meta.json"),`${T(g)}
+`),d.push("meta.json"),{directory:r,receipt:g,files:d}}a(ft,"writeShaderArtifacts");var B;async function J(){B===void 0&&(B=(async()=>{let r=createRequire(p.join(process.cwd(),"package.json")).resolve("@three-blocks/devtools/browser/shader-capture"),t=p.resolve(p.dirname(r),"../..");return (await I(t,r,$.metadata,"Shader capture browser runtime")).data.toString("utf8")})());let e=B;try{return await e}catch(r){throw B===e&&(B=void 0),r}}a(J,"loadShaderCaptureRuntimeSource");var Ue="virtual:three-blocks-shader-capture-client",We="\0three-blocks:shader-capture-client",ye="virtual:three-blocks-shader-capture-runtime",ze="\0three-blocks:shader-capture-runtime";async function Ct(){let e=await J(),r=e.replace(/\bexport\{[^{}]*\};?\s*$/u,"");if(r===e)throw new Error("Shader capture browser runtime no longer has the expected final ESM export list.");return r}a(Ct,"loadShaderCaptureRuntimeScriptSource");function Rr(e){let r=e.split("?",1)[0];return r===void 0?false:r.split(p.sep).join("/").endsWith("/build/three.webgpu.js")}a(Rr,"isThreeWebGPUModule");function Je(e){let r=/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/u.exec(e);return r?.[1]==="0"&&r[2]==="185"}a(Je,"supportedVersion");function kr(e,r,t={}){if(!Je(r))throw new Error(`Shader provider transform ${THREE_WEBGPU_R185_COMPATIBILITY} supports Three.js 0.185.x; received "${r}".`);let n=transformThreeWebgpuProviderHooks(e,{threeVersion:r,...t.threeRevision===void 0?{}:{threeRevision:t.threeRevision},id:"three/build/three.webgpu.js"}),i=n.state==="already-applied",o=n.code;return t.instrumentCapture&&(o=transformThreeWebgpuCaptureInstrumentation(o,{...t.captureRuntimeImport===void 0?{}:{runtimeImport:t.captureRuntimeImport}}).code),{code:o,alreadyPresent:i,captureApplied:t.instrumentCapture===true}}a(kr,"applyShaderProviderTransform");var Tr=/this\.trackTimestamp\s*=\s*\(\s*parameters\.trackTimestamp\s*===\s*true\s*\);/gu,Ar="Object.defineProperty( this, 'trackTimestamp', { get: () => false, set: () => {} } );";function xt(e,r={}){if(!Je(e))throw new Error(`Shader provider transform ${THREE_WEBGPU_R185_COMPATIBILITY} supports Three.js 0.185.x; received "${e}".`);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(i){return r.capture&&i===Ue?We:r.capture&&i===ye?ze:null},async load(i){return r.capture?i===ze?J():i===We?[`export * from '${ye}';`,`import { configureThreeBlocksShaderCapture } from '${ye}';`,`configureThreeBlocksShaderCapture( ${JSON.stringify({capture:r.capture.capture,forceLive:r.capture.forceLive,settleFrames:r.capture.settleFrames,settleTimeoutMs:r.capture.settleTimeoutMs,visibilityGuard:r.capture.visibilityGuard,captureId:r.capture.captureId,sessionKey:r.capture.sessionKey,token:r.capture.token,readiness:r.capture.readiness??{},transform:ue})} );`].join(`
+`):null:null},transform(i,o){if(!Rr(o))return null;t.seen=true,t.id=o;try{let s=kr(i,e,{instrumentCapture:r.capture!==void 0,...r.capture!==void 0?{captureRuntimeImport:Ue}:{}}),d=r.disableTimestampQueries===!0?s.code.replace(Tr,Ar):s.code;if(r.disableTimestampQueries===!0&&d===s.code)throw new Error("Three.js timestamp tracking anchor drifted; refusing software WebGPU capture.");return t.applied=!0,t.alreadyPresent=s.alreadyPresent,t.captureApplied=s.captureApplied,d===i?null:{code:d,map:null}}catch(s){throw t.error=s instanceof Error?s.message:String(s),s}}},status:t}}a(xt,"createShaderProviderTransform");function Pt(e){if(e.error)throw new Error(e.error);if(!e.seen||!e.applied)throw new Error(`The version-gated shader provider transform was not applied (${e.seen?"module seen":"three/webgpu not seen"}).`)}a(Pt,"assertShaderProviderTransform");export{fe as A,yr as B,ot as C,T as D,gr as E,st as F,at as G,Ve as H,dt as I,ct as J,ut as K,pt as L,lt as M,ft as N,J as O,Ue as P,Ct as Q,Rr as R,kr as S,xt as T,Pt as U,c as a,Ee as b,F as c,$ as d,re as e,R as f,b as g,_ as h,j as i,$r as j,v as k,I as l,Ir as m,ne as n,Lr as o,vr as p,H as q,Vr as r,te as s,Hr as t,Ur as u,ie as v,oe as w,ue as x,pe as y,le as z};