@three-blocks/devtools 1.0.0-alpha.176.g8ff8a72e6369

package/dist/chunk-VGJ3V4QQ.js

@@ -0,0 +1,78 @@
+import {d,a as a$1,R,S,w,O,m,l,h,g,M}from'./chunk-SCJNCGMF.js';import {a}from'./chunk-EI7MMDWY.js';import b from'process';import {createServer}from'http';import {createRequire}from'module';import {mkdtemp,rm,lstat,realpath}from'fs/promises';import E from'path';import {tmpdir}from'os';import {pathToFileURL}from'url';import {THREE_WEBGPU_R185_COMPATIBILITY}from'three-blocks/shaders';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=b.env,e=b.platform){let t=r.THREE_BLOCKS_WEBGPU_BROWSER_ARGS?.split(/\s+/u).filter(Boolean);if(t&&t.length>0)return t;let n=["--enable-unsafe-webgpu"];return e==="darwin"&&n.push("--enable-gpu","--use-angle=metal"),e==="linux"&&n.push("--enable-features=Vulkan","--disable-vulkan-surface","--ignore-gpu-blocklist","--disable-gpu-driver-bug-workarounds","--disable-gpu-watchdog"),n}a(Z,"webgpuBrowserArgs");function ee(r=false,e=b.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",D="/__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(E.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((a,o)=>{let s=setTimeout(()=>{this.#e.delete(e),o(new Error(`Shader capture "${e}" timed out after ${t}ms.`));},t);this.#e.set(e,{resolve:a,reject:o,timer:s});})}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 G=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,a)=>{let o=0;for(;r.__threeBlocksParityUsesAnimationLoop!==true&&o<e;)await n(),o+=1;if(r.__threeBlocksParityUsesAnimationLoop===true){let s=Number(r.__threeBlocksParityCompletedFrame||0),i=Number(t),l=Number.isSafeInteger(i)&&i>=s?i:s+e;for(r.__threeBlocksParityTargetFrame=l;Number(r.__threeBlocksParityCompletedFrame||0)<l;)await n();}return await a(),Number(r.__threeBlocksParityCompletedFrame||0)},"settleShaderParityFrames");function q(){return `(() => {
+  const root = globalThis;
+  const scene = new URL(location.href).searchParams.get('captureId')
+    || 'default';
+  // Keep the wall clock native so shader build durations and loader deadlines stay
+  // truthful. Deterministic application time is supplied by renderer/Timer capture hooks.
+  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');
+  const randomStreams = new Map();
+  let randomState = randomSeed(scene);
+  Math.random = () => {
+    if (parityMode === 'live' || parityMode === 'precompiled') {
+      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;
+    }
+    randomState = advanceRandom(randomState);
+    return randomState / 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(THREE_WEBGPU_R185_COMPATIBILITY)}, transform: ${w}, 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(q,"publicBridgeScript");function we(r,e,t,n,a=false){let o=new URL(r.url??"/","http://three-blocks.invalid"),s=o.pathname;if(a&&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===D&&r.method==="GET"){let u=o.searchParams.get("scene")??"",h=n.read(u);return h===void 0?(e.statusCode=204,e.end()):(e.statusCode=200,e.setHeader("Content-Type","application/json"),e.end(JSON.stringify(h))),true}let i=s===ce,l=s===D;if(!i&&!l)return  false;if(r.method!=="POST")return e.statusCode=405,e.end("POST required"),true;let m=[],p=0,w=false;return r.on("data",u=>{p+=u.byteLength,p>me?w=true:m.push(u);}),r.on("end",()=>{if(w){e.statusCode=413,e.end("capture payload too large");return}try{let u=JSON.parse(Buffer.concat(m).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){return {name:"three-blocks:shader-capture-endpoint",transformIndexHtml(){return [{tag:"script",children:q(),injectTo:"head-prepend"}]},configureServer(n){n.middlewares.use((a,o,s)=>{let l=new URL(a.url??"/","http://three-blocks.invalid").searchParams.get("captureId");l!==null&&e.markFirstRequest(l),!we(a,o,r,e,t)&&s();});}}}a(Ae,"captureEndpointPlugin");function ne(r,e,t){let n=new URL(e.url,r);for(let[a,o]of Object.entries(t))n.searchParams.set(a,o);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 ae(r){return Be.some(e=>e.test(r))}a(ae,"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 oe(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(oe,"readPageDiagnostic");function $(r){let e=a(()=>{},"resolveFirst"),t=new Promise(s=>{e=s;}),n={console:[],page:[],first:t},a$1=false,o=a(s=>{a$1||(a$1=true,e(new Error(s)));},"report");return r.on("console",s=>{let i=s.type()==="warning"&&/\[three-blocks\/shaders\].*(?:has no entry|manifest miss|hydration)/iu.test(s.text());if(s.type()!=="error"&&!i||ae(s.text()))return;let l=s.location().url,m=l.length>0?`${s.text()} (${l})`:s.text();n.console.push(m),o(`Browser console ${i?"warning":"error"}: ${m}`);}),r.on("pageerror",s=>{if(ae(s.message))return;let i=s.stack||s.message;n.page.push(i),o(`Browser page error: ${i}`);}),r.on("crash",()=>o("Browser page crashed before shader capture completed.")),r.on("close",()=>o("Browser page closed before shader capture completed.")),n}a($,"collectErrors");function C(r,e,t=false){return typeof r[e]=="boolean"?r[e]:t}a(C,"booleanField");function De(r){if(!a$1(r))throw new Error("Browser shader stats are unavailable.");let e=a((t,n=true)=>{let a=r[t];if(typeof a!="number"||!Number.isFinite(a)||a<0||n&&!Number.isSafeInteger(a))throw new Error(`Browser shader stats.${t} is invalid.`);return a},"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 L(r,e,t,n){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 o={workerReady:C(a,"workerReady"),assetsReady:C(a,"assetsReady"),textReady:e.requiresText?C(a,"textReady"):true,compileEnd:C(a,"compileEnd"),firstFrame:C(a,"firstFrame",t)};if(!o.workerReady||!o.assetsReady||!o.textReady||!o.compileEnd)throw new Error(`Scene "${e.key}" did not reach worker/assets/text/compile readiness.`);let s=t?THREE_WEBGPU_R185_COMPATIBILITY:r.compatibility,i=t?w:r.transform;if(s!==THREE_WEBGPU_R185_COMPATIBILITY||i!==w)throw new Error(`Scene "${e.key}" exposed incompatible shader bridge metadata.`);return S(n),{compatibility:s,transform:i,readiness:o,stats:De(r.stats)}}a(L,"parseBridge");async function A(r,e){return r.evaluate(t=>{let n=globalThis;if(!t)return n.__threeBlocksShaderTools??null;let a=n.__threeBlocks,o=n.__threeBlocksTslStats;if(!a||typeof a!="object")return null;let s=a;return {readiness:{workerReady:s.workerReady===true,assetsReady:s.loadEnd===true||s.assetsReady===true,textReady:s.textReady===true,compileEnd:s.compileEnd===true,firstFrame:true},stats:o}},e)}a(A,"readBridge");async function F(r,e,t,n){return r.evaluate(async a$1=>{let s=globalThis.__threeBlocksShaderTools;if(s&&typeof s=="object"){let m=Reflect.get(s,"settle");if(typeof m=="function"){let p=await m(a$1.frames,a$1.targetFrame);return typeof p=="number"&&Number.isSafeInteger(p)?p:0}}if(!a$1.legacy||!a$1.modulePath)throw new Error("The public shader bridge does not provide deterministic settle().");let i=await import(a$1.modulePath);if(!i.store||typeof i.store!="object")throw new Error("Legacy deterministic store is unavailable.");let l=i.store;return l.recordFrameCount=0,l.recordFrameRate=60,l.recordTotalFrames=a$1.frames,l.recording=true,await new Promise((m,p)=>{let w=Date.now(),u=a(()=>{if(l.recording===false)return m();if(Date.now()-w>a$1.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(F,"settlePage");async function se(r,e,t){e.readiness.selector===void 0&&e.readiness.global===void 0||await Promise.race([r.waitForFunction(n=>{let a=globalThis;if(n.selector!==void 0&&a.document?.querySelector(n.selector)==null)return  false;if(n.global===void 0)return  true;let o=a;for(let l of n.global.split(".")){if((typeof o!="object"||o===null)&&typeof o!="function")return  false;o=Reflect.get(o,l);}if(o===true)return  true;if(typeof o!="object"||o===null||typeof Reflect.get(o,"then")!="function")return  false;let s=a.__threeBlocksReadinessState,i=s instanceof Map?s:new Map;return s instanceof Map||(a.__threeBlocksReadinessState=i),i.has(o)||(i.set(o,false),Promise.resolve(o).then(()=>i.set(o,true),()=>i.set(o,false))),i.get(o)===true},e.readiness,{timeout:e.timeoutMs}),t.first.then(n=>Promise.reject(n))]);}a(se,"waitForConfiguredReadiness");async function ie(r){let e=r.locator("canvas"),n=(await e.evaluateAll(a=>a.map((o,s)=>{let i=o.getBoundingClientRect();return {index:s,area:Math.max(0,i.width)*Math.max(0,i.height)}}))).sort((a,o)=>o.area-a.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(ie,"primaryCanvasScreenshot");async function H(r,e,t,n,a){let o=ge(n,a),s=await O(),i=`(() => {
+  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(o).replaceAll("<","\\u003c")});
+})();`;await r.addInitScript({content:`${s}
+${i}`}),await r.addInitScript({content:q()}),await r.route("**/*",async l=>{let m=l.request(),p=new URL(m.url()),w=p.pathname;if(m.method()==="GET"&&n!=="precompiled"&&/^\/three-blocks\/shaders\/[a-z0-9][a-z0-9_-]{0,63}\.json$/u.test(w)){await l.fulfill({status:204});return}if(w===D&&m.method()==="GET"){let c=t.read(p.searchParams.get("scene")??"");await l.fulfill(c===void 0?{status:204}:{status:200,contentType:"application/json",body:JSON.stringify(c)});return}let u=w===ce,h=w===D;if((u||h)&&m.method()==="POST"){let c=m.postDataBuffer()??Buffer.alloc(0);if(c.byteLength>me){await l.fulfill({status:413,body:"capture payload too large"});return}try{let f=JSON.parse(c.toString("utf8"));h?t.receive(f):e.receive(f),await l.fulfill({status:204});}catch(f){await l.fulfill({status:400,body:f instanceof Error?f.message:String(f)});}return}await l.continue();});}a(H,"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 Ie(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(Ie,"injectStaticShaderCaptureHtml");function Ne(r,e){let t=ge(r,e);return [`import { configureThreeBlocksShaderCapture } from ${JSON.stringify(le)};`,`configureThreeBlocksShaderCapture( ${JSON.stringify(t).replaceAll("<","\\u003c")} );`].join(`
+`)}a(Ne,"staticCaptureBootstrap");function ge(r,e){return {capture:r==="capture",forceLive:r!=="precompiled",settleFrames:e.settleFrames,settleTimeoutMs:e.settleTimeoutMs??3e4,readiness:e.readiness,transform:w}}a(ge,"shaderCaptureConfiguration");async function Ue(r,e){let t=await m(r,e,s=>/\.(?:c|m)?js$/u.test(s),16384),n=false,a=false,o;for(let s of t){let i=(await l(r,s,d.texture,"Static application JavaScript")).data.toString("utf8");if(i.includes("nodeBuilderStateProvider")&&(n=true),i.includes("three-blocks.shader-capture.runtime.v1")&&(a=true,o??=s),n&&a)break}if(!n||!a)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,...o===void 0?{}:{id:o}}}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,""),a=E.resolve(r,n.length===0?"index.html":n);if(!h(r,a)||a===r||(await g(a)&&(await lstat(a)).isDirectory()&&(a=E.join(a,"index.html")),!await g(a)&&E.extname(a).length===0&&(a=E.join(r,"index.html")),!await g(a)))return;let o=await l(r,a,d.texture,"Static application asset");return {data:o.data,file:o.path}}a($e,"staticRequestFile");async function He(r,e,t,n,a){let o=await realpath(r.root),s=await realpath(E.resolve(o,r.serve));if(!h(o,s)||s===o)throw new Error("--serve must name a built application directory inside the project root.");let i=await Ue(o,s),l=await M(),m=Ne(e,t),p=q(),w=createServer((h,c)=>{(async()=>{if(we(h,c,n,a,e!=="precompiled"))return;let f=new URL(h.url??"/","http://three-blocks.invalid");if(h.method!=="GET"&&h.method!=="HEAD"){c.statusCode=405,c.end("GET or HEAD required");return}let y=f.pathname===le?l:f.pathname===ue?m:f.pathname===he?p:void 0;if(y!==void 0){c.statusCode=200,c.setHeader("Content-Type","text/javascript; charset=utf-8"),c.setHeader("Cache-Control","no-store"),c.end(h.method==="HEAD"?void 0:y);return}let g=await $e(s,f.pathname);if(g===void 0){c.statusCode=404,c.end("Not found");return}let S=E.extname(g.file).toLowerCase(),B=S===".html"?Buffer.from(Ie(g.data.toString("utf8"))):g.data;c.statusCode=200,c.setHeader("Content-Type",Me[S]??"application/octet-stream"),c.setHeader("Content-Length",String(B.byteLength)),c.setHeader("Cache-Control","no-store"),c.end(h.method==="HEAD"?void 0:B);})().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((h,c)=>{w.once("error",c),w.listen(0,"127.0.0.1",()=>{w.off("error",c),h();});});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:i}}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 _=class{static{a(this,"PlaywrightShaderDriver");}#e;#t=new W;#n=new G;#u;#h;#o;#s;#r;#a;#m;#d;#f;#c=0;#l;constructor(e){this.#e=e;}#i(){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(E.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.#o!==void 0||this.#s!==void 0||this.#e.url!==void 0&&this.#a!==void 0,a=this.#s!==void 0?this.#d===e:Ve(this.#d,e,t.bridge.legacyLab);if(n&&a){this.#d=e,await this.#p(t);return}if(n&&await this.close(),this.#d=e,this.#e.url!==void 0){let o=new URL(this.#e.url);if(!["http:","https:"].includes(o.protocol)||o.username||o.password||o.hash)throw new Error("Attached shader URL must be an HTTP(S) URL without credentials or a fragment.");this.#a=o.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 o=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.#s=o.server,this.#h=o.transform,this.#a=o.baseUrl,await this.#p(t);return}catch(o){throw await this.close(),o}this.#u=R(this.#e.runtime.three,{disableTimestampQueries:b.env.THREE_BLOCKS_SOFTWARE_WEBGPU==="1",...t.bridge.legacyLab?{}:{capture:{capture:e==="capture",forceLive:e!=="precompiled",settleFrames:t.settleFrames,settleTimeoutMs:t.settleTimeoutMs??3e4,readiness:t.readiness}}}),this.#m={THREE_BLOCKS_SHADER_TOOL:b.env.THREE_BLOCKS_SHADER_TOOL,THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER:b.env.THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER},b.env.THREE_BLOCKS_SHADER_TOOL="1",b.env.THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER="1";try{let o=await Oe(this.#e.root);this.#o=await o({root:this.#e.root,logLevel:"error",plugins:[this.#u.plugin,Ae(this.#t,this.#n,e!=="precompiled")],server:{host:"127.0.0.1",port:0}}),await this.#o.listen();let s=this.#o.httpServer?.address();if(!s||typeof s=="string")throw new Error("Vite did not expose an ephemeral TCP address.");this.#a=`http://127.0.0.1:${s.port}`,await this.#p(t);}catch(o){throw await this.close(),o}}async capture(e,t){let n=Date.now();if(await this.#w("capture",t),!this.#r||!this.#a)throw new Error("Shader browser driver did not start.");let a$2=this.#r,o=await a$2.newContext({viewport:t.viewport});this.#e.url!==void 0&&await H(o,this.#t,this.#n,"capture",t);let s=await o.newPage(),i=$(s);this.#n.clear(e.key);let l=this.#t.wait(e.key,t.timeoutMs),m=Promise.race([l,i.first.then(h=>Promise.reject(h))]),p=a(()=>{},"resolveDisconnected"),w=new Promise(h=>{p=h;}),u=a(()=>p(new Error("Shader capture browser disconnected before posting a manifest.")),"onDisconnected");a$2.on("disconnected",u);try{let h=s.goto(ne(this.#a,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(h,Promise.race([m,w.then(y=>Promise.reject(y))]));S(this.#i());let f=[...i.page,...i.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(h){let c=h instanceof Error?h:new Error(String(h));this.#t.cancel(e.key,c),await l.catch(()=>{});let f=this.#n.read(e.key);if(c.message.includes("timed out")){let y=await oe(()=>s.evaluate(()=>{let g=globalThis,S=g.__threeBlocksShaderTools,B=S&&typeof S=="object"?S:void 0,ye=g.document,v=Reflect.get(g,Symbol.for("three-blocks.shader-capture.cache-value.v1")),x=g.location,Se=x!==null&&typeof x=="object"&&typeof Reflect.get(x,"href")=="string"?String(Reflect.get(x,"href")):"http://three-blocks.invalid/",be=new URL(Se).searchParams.get("captureId")??"default",J=v!==null&&typeof v=="object"&&typeof Reflect.get(v,"registrations")=="function"?Reflect.apply(Reflect.get(v,"registrations"),v,[be]):void 0;return {documentReadyState:ye?.readyState??null,parityTargetFrame:Number(g.__threeBlocksParityTargetFrame??0),parityCompletedFrame:Number(g.__threeBlocksParityCompletedFrame??0),readiness:B?.readiness??null,captureCache:v!==null&&typeof v=="object"?{activeScene:Reflect.get(v,"activeScene")??null,registrations:Array.isArray(J)?J.slice(0,16).map(R=>R!==null&&typeof R=="object"?{key:Reflect.get(R,"key")??null,kind:Reflect.get(R,"kind")??null}:null):null}:null,threeRuntimeResources:performance.getEntriesByType("resource").map(R=>R.name).filter(R=>R.includes("three.webgpu"))}}));throw new Error(`${c.message} Last capture state for "${e.key}": ${JSON.stringify({page:y,telemetry:f??null,transform:this.#i()})}`)}throw c}finally{a$2.off("disconnected",u),await P(()=>o.close()),this.#c++,(!a$2.isConnected()||this.#c>=(t.browserRelaunchScenes??8))&&(this.#r===a$2&&(this.#r=void 0),await P(()=>a$2.close()),this.#c=0);}}async observe(e,t,n,a){for(let o=0;o<2;o++)try{return await this.#g(e,t,n,a)}catch(s){if(o===0&&de(s))continue;throw s}throw new Error(`Shader observation retry was exhausted for scene "${e.key}".`)}async#g(e,t,n,a){if(await this.#w(t,n),!this.#r||!this.#a)throw new Error("Shader browser driver did not start.");let o=await this.#r.newContext({viewport:n.viewport});this.#e.url!==void 0&&await H(o,this.#t,this.#n,t,n);let s=await o.newPage(),i=$(s);this.#n.clear(e.key);try{await s.goto(ne(this.#a,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}),i.first.then(u=>Promise.reject(u))]),L(await A(s,n.bridge.legacyLab),e,n.bridge.legacyLab,this.#i()),await se(s,n,i);let l=e.parityFrames??n.parity.frames,m=await F(s,n,l,a),p=Buffer.from(await s.screenshot({type:"png"}));e.parityFrames!==void 0&&l<n.parity.frames&&await F(s,n,n.parity.frames-l);let w=L(await A(s,n.bridge.legacyLab),e,n.bridge.legacyLab,this.#i());return this.#f===void 0&&(this.#f=await s.evaluate(async()=>{let u=Reflect.get(navigator,"gpu"),h=typeof u=="object"&&u!==null?Reflect.get(u,"requestAdapter"):void 0,c=typeof h=="function"?await Reflect.apply(h,u,[]):void 0,f=typeof c=="object"&&c!==null?Reflect.get(c,"info"):void 0,y=["description","device","architecture","vendor"].flatMap(g=>{let S=typeof f=="object"&&f!==null?Reflect.get(f,g):void 0;return typeof S=="string"&&S.length>0?[S]:[]});return {adapter:[...new Set(y)].join(" \xB7 ")||"WebGPU adapter",platform:navigator.platform||navigator.userAgent}})),{scene:e.key,mode:t,...w,frame:m,screenshot:p,errors:[...i.page,...i.console]}}catch(l){let m=l instanceof Error?l:new Error(String(l));if(/(?:timed?\s*out|timeout)/iu.test(m.message)){let p=this.#n.read(e.key),w=await oe(()=>s.evaluate(()=>{let u=globalThis,h=u.__threeBlocksShaderTools,c=h&&typeof h=="object"?h: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(y=>y.name).filter(y=>y.includes("three.webgpu"))}}));throw new Error(`${m.message} Last ${t} state for "${e.key}": ${JSON.stringify({page:w,telemetry:p??null})}`)}throw m}finally{await o.close();}}async observePublished(e,t){for(let n=0;n<2;n++)try{return await this.#y(e,t)}catch(a){if(n===0&&de(a))continue;throw a}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.#a)throw new Error("Shader browser driver did not start.");let n=await this.#r.newContext({viewport:t.viewport});this.#e.url!==void 0&&await H(n,this.#t,this.#n,"precompiled",t);let a=await n.newPage(),o=$(a);this.#n.clear(e.key);try{await a.goto(Fe(this.#a,e),{waitUntil:"domcontentloaded",timeout:t.timeoutMs}),await Promise.race([a.waitForFunction(t.bridge.legacyLab?"globalThis.__threeBlocks?.compileEnd === true":"globalThis.__threeBlocksShaderTools?.readiness?.compileEnd === true",void 0,{timeout:t.timeoutMs}),o.first.then(p=>Promise.reject(p))]),await se(a,t,o),L(await A(a,t.bridge.legacyLab),e,t.bridge.legacyLab,this.#i()),await F(a,t,2);let s=await ie(a),i=await F(a,t,120),l=await ie(a),m=L(await A(a,t.bridge.legacyLab),e,t.bridge.legacyLab,this.#i());return {scene:e.key,mode:"precompiled",...m,frame:i,beforeScreenshot:s,screenshot:l,errors:[...o.page,...o.console]}}finally{await n.close();}}timingEnvironment(){return this.#f??{adapter:"WebGPU adapter",platform:`${b.platform}/${b.arch}`}}async close(){this.#t.rejectAll(new Error("Shader browser driver closed.")),this.#r&&await P(()=>this.#r?.close()??Promise.resolve());let e=this.#o?.httpServer,t=e?Reflect.get(e,"closeAllConnections"):void 0;if(e&&typeof t=="function"&&Reflect.apply(t,e,[]),this.#o&&await P(()=>this.#o?.close()??Promise.resolve()),this.#s){let n=this.#s;n.closeAllConnections(),await P(()=>new Promise(a=>{n.close(()=>a());}));}if(this.#r=void 0,this.#o=void 0,this.#s=void 0,this.#a=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,a]of Object.entries(this.#m))a===void 0?delete b.env[n]:b.env[n]=a;this.#m=void 0;}}};function ct(r){return new _(r)}a(ct,"createPlaywrightShaderDriver");function lt(r){return new _(r)}a(lt,"createStaticPlaywrightShaderDriver");function ut(r){return new _(r)}a(ut,"createAttachedPlaywrightShaderDriver");
+export{ve as a,We as b,Z as c,ee as d,je as e,Le as f,Ve as g,de as h,ct as i,lt as j,ut as k};

package/dist/chunk-ZDNZCQUQ.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import {a as a$1}from'./chunk-HOZDD6PW.js';var i=/^[a-f0-9]{64}$/,p=/^[0-9A-Za-z][0-9A-Za-z.+_-]{0,127}$/,h=/^[a-z0-9][a-z0-9_-]{0,63}$/,f=/^[0-9A-Za-z][0-9A-Za-z._/-]{0,127}$/;function o(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}a$1(o,"isRecord");function a(e){return typeof e=="string"&&p.test(e)}a$1(a,"isSafeVersion");function d(e){if(e.length===0||e.length>512||e.includes("\\")||/[\u0000-\u001f\u007f]/.test(e))return  false;let n=e.split("/");return !e.startsWith("/")&&n.every(t=>t.length>0&&t!=="."&&t!=="..")}a$1(d,"isSafeRelativePath");function m(e){if(!o(e)||e.schemaVersion!==2)throw new Error("three-blocks.json must use schemaVersion 2.");if(typeof e.template!="string"||!h.test(e.template))throw new Error("three-blocks.json has an invalid default shader scene key.");if(!Array.isArray(e.layers)||!e.layers.every(n=>typeof n=="string"&&f.test(n))||new Set(e.layers).size!==e.layers.length)throw new Error("three-blocks.json has invalid layers.");if(e.generator!==void 0&&(!o(e.generator)||typeof e.generator.name!="string"||!f.test(e.generator.name)||!a(e.generator.version)))throw new Error("three-blocks.json has invalid generator metadata.");if(!o(e.runtime)||!a(e.runtime.three)||!a(e.runtime.threeBlocks))throw new Error("three-blocks.json has invalid runtime versions.");if(!o(e.features)||typeof e.features.text!="boolean")throw new Error("three-blocks.json has invalid feature metadata.");if(!o(e.protocol)||e.protocol.resultFile!==1)throw new Error("three-blocks.json has an unsupported protocol schema.");if(e.artifacts!==void 0){if(!o(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$1(m,"parseProjectMetadata");function y(e){if(!o(e))throw new Error("Shader coverage is missing.");for(let n of ["render","vertex","fragment","compute"])if(typeof e[n]!="number"||!Number.isSafeInteger(e[n])||e[n]<0)throw new Error(`Shader coverage.${n} must be a non-negative integer.`);return e}a$1(y,"parseCoverage");function g(e,n){if(!o(e))throw new Error(`Shader receipt inputs for "${n}" are invalid.`);let t=Object.entries(e);if(t.length===0||t.length>4096)throw new Error(`Shader receipt inputs for "${n}" must contain between 1 and 4096 files.`);for(let[r,c]of t)if(!d(r)||typeof c!="string"||!i.test(c))throw new Error(`Shader receipt input for "${n}" is invalid.`)}a$1(g,"parseInputs");function l(e){if(!o(e)||e.schemaVersion!==2||!o(e.runtime)||!a(e.runtime.three)||!a(e.runtime.threeBlocks)||typeof e.runtime.threeBlocksShaderClosure!="string"||!i.test(e.runtime.threeBlocksShaderClosure)||!o(e.scenes))throw new Error("Shader meta.json does not match receipt schema 2.");if(e.runtime.capture!==void 0&&(!o(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 n=Object.entries(e.scenes);if(n.length===0)throw new Error("Shader meta.json contains no scenes.");for(let[t,r]of n){if(!h.test(t)||!o(r)||typeof r.artifact!="string"||!d(r.artifact)||!r.artifact.endsWith(".webgpu.ts")||typeof r.artifactHash!="string"||!i.test(r.artifactHash))throw new Error(`Shader receipt for "${t}" is invalid.`);if(r.asset===void 0!=(r.assetHash===void 0)||r.asset!==void 0&&(typeof r.asset!="string"||!d(r.asset)||!r.asset.endsWith(".json")||typeof r.assetHash!="string"||!i.test(r.assetHash)))throw new Error(`Shader static asset receipt for "${t}" is invalid.`);if(g(r.inputs,t),y(r.coverage),r.bytes!==void 0&&(!Number.isSafeInteger(r.bytes)||Number(r.bytes)<0))throw new Error(`Shader receipt byte count for "${t}" is invalid.`);if(r.skipped!==void 0&&(!o(r.skipped)||!Number.isSafeInteger(r.skipped.render)||Number(r.skipped.render)<0||!Number.isSafeInteger(r.skipped.compute)||Number(r.skipped.compute)<0))throw new Error(`Shader receipt skipped-build counts for "${t}" are invalid.`)}if(e.tool!==void 0&&(!o(e.tool)||e.tool.name!=="@three-blocks/devtools"||!a(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$1(l,"parseShaderReceipt");export{o as a,m as b,l as c};

package/dist/chunk-ZKK6E42X.js

@@ -0,0 +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};

package/dist/chunk-ZT6T2W4B.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+var o="0.1.0";export{o as a};

package/dist/cli.js

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

package/dist/environment-bake-5P4IAL4O.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import {b,c,a as a$2}from'./chunk-NE7SC2BX.js';import {a as a$1,c as c$1,d,h,e}from'./chunk-5L2VS3BN.js';import {a}from'./chunk-HOZDD6PW.js';import {randomUUID}from'crypto';import {mkdir,lstat,realpath,writeFile,rename,rm,readFile}from'fs/promises';import p from'path';import {fileURLToPath}from'url';import F from'zlib';import {VK_FORMAT_R16G16B16A16_SFLOAT,KHR_SUPERCOMPRESSION_NONE,read,KHR_SUPERCOMPRESSION_ZSTD,write}from'ktx-parse';var N="/__three-blocks/devtools/environment-bake",Q="/__three-blocks/devtools/environment-bake/upload",T="virtual:three-blocks-devtools/environment-bake.ts",O=`\0${T}`,q=`/@id/__x00__${T}`,ee="src/assets/environment/room-environment.pmrem.ktx2",_=128*1024*1024,te=1;async function re(){try{let[e,r]=await Promise.all([import('playwright'),import('vite')]);return {chromium:e.chromium,createServer:r.createServer}}catch(e){throw new Error('Environment baking requires the optional "playwright" and "vite" packages. Install both in the project and run `npx playwright install chromium`.',{cause:e})}}a(re,"loadEnvironmentBakeBrowserTools");function j(e,r,t,n,o){let d=e??o;if(!Number.isSafeInteger(d)||d<t||d>n)throw new Error(`${r} must be an integer in ${t}...${n}.`);return d}a(j,"boundedInteger");function V(e){let r=j(e,"Environment cube size",16,1024,256);if((r&r-1)!==0)throw new Error("Environment cube size must be a power of two.");return r}a(V,"validateEnvironmentCubeSize");function ne(){return F}a(ne,"zstdFunctions");function oe(e){if(!/^[0-9A-Za-z][0-9A-Za-z.+_-]{0,63}$/u.test(e))throw new Error("Browser reported an invalid Three.js revision.");return e}a(oe,"boundedThreeRevision");function ie(e){if(e.vkFormat!==VK_FORMAT_R16G16B16A16_SFLOAT)throw new Error("RoomEnvironment bake must be RGBA16F KTX2.");if(e.typeSize!==2)throw new Error("RoomEnvironment RGBA16F KTX2 must use a two-byte component type.");if(e.supercompressionScheme!==KHR_SUPERCOMPRESSION_NONE)throw new Error("Browser RoomEnvironment KTX2 must be uncompressed before deterministic encoding.");if(!Number.isSafeInteger(e.pixelWidth)||e.pixelWidth<=0||e.pixelWidth>8192||!Number.isSafeInteger(e.pixelHeight)||e.pixelHeight<=0||e.pixelHeight>8192||e.pixelDepth!==0||e.layerCount!==0||e.faceCount!==1||e.levels.length!==1||e.levels[0]===void 0)throw new Error("RoomEnvironment KTX2 has invalid CubeUV dimensions or topology.");let r=e.pixelWidth*e.pixelHeight*8;if(!Number.isSafeInteger(r)||r>_)throw new Error("RoomEnvironment KTX2 decoded payload exceeds the safety limit.");let t=e.levels[0],n=r+e.pixelHeight*256;if(t.levelData.byteLength<r||t.levelData.byteLength>n||t.levelData.byteLength%8!==0||t.uncompressedByteLength!==t.levelData.byteLength)throw new Error(`RoomEnvironment KTX2 level byte count ${t.levelData.byteLength} is outside the bounded RGBA16F CubeUV layout.`);return e.levels.map(o=>new Uint8Array(o.levelData))}a(ie,"validateRawContainer");function ae(e,r){return e.byteLength===r.byteLength&&Buffer.from(e).equals(Buffer.from(r))}a(ae,"sameBytes");function se(e,r){let t=V(r.cubeSize),n=oe(r.threeRevision);if(e.byteLength===0||e.byteLength>a$1.texture)throw new Error("RoomEnvironment KTX2 input exceeds the bounded texture size.");let o=read(e),d=ie(o),m=r.compression??"zstd",c=ne(),f=F.constants.ZSTD_c_compressionLevel;if(m==="zstd"&&(c.zstdCompressSync===void 0||c.zstdDecompressSync===void 0||f===void 0))throw new Error("This Node.js runtime does not provide deterministic Zstandard support; use --no-zstd explicitly to opt out.");if(o.supercompressionScheme=m==="zstd"?KHR_SUPERCOMPRESSION_ZSTD:KHR_SUPERCOMPRESSION_NONE,o.levelCount=d.length,o.levels=d.map(a=>{let l=m==="zstd"?c.zstdCompressSync?.(a,{params:{[f]:19}}):void 0;return {levelData:l===void 0?a:new Uint8Array(l.buffer,l.byteOffset,l.byteLength),uncompressedByteLength:a.byteLength}}),m==="zstd")for(let a of o.dataFormatDescriptor)a.bytesPlane=[0,0,0,0,0,0,0,0];o.keyValue={KTXorientation:"rd",KTXwriter:`three-blocks RoomEnvironment \xB7 three r${n}`};let u=write(o,{keepWriter:true});if(u.byteLength===0||u.byteLength>a$1.texture)throw new Error("Encoded RoomEnvironment KTX2 exceeds the bounded texture size.");let i=read(u);if(i.vkFormat!==VK_FORMAT_R16G16B16A16_SFLOAT||i.pixelWidth!==o.pixelWidth||i.pixelHeight!==o.pixelHeight||i.supercompressionScheme!==o.supercompressionScheme||i.keyValue.KTXorientation!=="rd"||i.levels.length!==d.length)throw new Error("RoomEnvironment KTX2 header failed round-trip validation.");for(let a=0;a<i.levels.length;a+=1){let l=i.levels[a],g=d[a];if(l===void 0||g===void 0)throw new Error(`RoomEnvironment KTX2 level ${a} is missing after round-trip.`);let R=m==="zstd"?c.zstdDecompressSync?.(l.levelData):l.levelData;if(R===void 0||l.uncompressedByteLength!==g.byteLength||!ae(R,g))throw new Error(`RoomEnvironment KTX2 level ${a} failed byte-for-byte round-trip validation.`)}let h=d.reduce((a,l)=>a+l.byteLength,0);return {bytes:u,metadata:{compression:m,cubeSize:t,format:"RGBA16F CubeUVReflectionMapping",height:i.pixelHeight,rawBytes:h,sha256:c$1(u),three:n,version:te,width:i.pixelWidth}}}a(se,"encodeRoomEnvironmentKtx2");var S=class{static{a(this,"BakeInbox");}promise;#t=a(()=>{},"#resolve");#r=a(()=>{},"#reject");#e=false;constructor(){this.promise=new Promise((r,t)=>{this.#t=r,this.#r=t;});}receive(r){return this.#e?false:(this.#e=true,this.#t(r),true)}reject(r){this.#e||(this.#e=true,this.#r(r));}};function ue(e){if(e.url!==void 0)try{return new URL(e.url,"http://three-blocks.invalid").pathname}catch{return}}a(ue,"requestPath");function y(e,r,t=""){e.statusCode=r,e.setHeader("Content-Type",t.startsWith("<!")?"text/html; charset=utf-8":"text/plain; charset=utf-8"),e.setHeader("Cache-Control","no-store"),e.end(t);}a(y,"respond");function de(e,r){return {name:"three-blocks:environment-bake",enforce:"post",resolveId(t){return t===T?O:void 0},load(t){return t===O?r:void 0},configureServer(t){t.middlewares.use((n,o,d)=>{let m=ue(n);if(m===N&&(n.method==="GET"||n.method==="HEAD")){let a=n.method==="HEAD"?"":`<!doctype html><html lang="en"><head><meta charset="utf-8"><title>Three Blocks environment bake</title></head><body><canvas id="three-blocks-environment-baker" width="1" height="1"></canvas><script type="module" src="${q}"></script></body></html>`;y(o,200,a);return}if(m!==Q)return d();if(n.method!=="POST"){y(o,405,"POST required");return}let c=n.headers["content-type"];if(typeof c!="string"||!c.toLowerCase().startsWith("image/ktx2")){y(o,415,"image/ktx2 required");return}let f=Number(n.headers["content-length"]??0);if(Number.isFinite(f)&&f>_){y(o,413,"Bake payload exceeds 128 MiB");return}let u=[],i=0,h=false;n.on("data",a=>{i+=a.byteLength,i>_?h=true:u.push(a);}),n.on("error",a=>e.reject(a)),n.on("end",()=>{if(h){y(o,413,"Bake payload exceeds 128 MiB"),e.reject(new Error("RoomEnvironment bake upload exceeded 128 MiB."));return}let a=n.headers["x-three-revision"];if(typeof a!="string"){y(o,400,"x-three-revision required"),e.reject(new Error("RoomEnvironment upload omitted the Three.js revision."));return}let l=e.receive({bytes:new Uint8Array(Buffer.concat(u)),threeRevision:a});y(o,l?204:409,l?"":"Bake upload already received");});});}}}a(de,"bakePlugin");async function me(){let e=p.dirname(fileURLToPath(import.meta.url)),r=[p.join(e,"browser","environment-bake.js"),p.join(e,"browser","environment-bake.ts")];for(let t of r)if(await d(t))return (await h(t,a$1.semanticInput,"Environment bake browser entry")).data.toString("utf8");throw new Error("The separately built environment bake browser entry is missing.")}a(me,"browserEntrySource");function ce(e){return new Promise((r,t)=>{e.on("pageerror",n=>{a$2(n.message)||t(n);}),e.on("console",n=>{n.type()==="error"&&!a$2(n.text())&&t(new Error(n.text()));});})}a(ce,"pageFailure");async function le(e,r){await e.waitForFunction(()=>globalThis.__THREE_BLOCKS_ROOM_ENVIRONMENT_BAKE__!==void 0,void 0,{timeout:Math.min(r,3e4)});let t=await e.evaluate(()=>globalThis.__THREE_BLOCKS_ROOM_ENVIRONMENT_BAKE__);if(!t||typeof t!="object"||Reflect.get(t,"ok")!==true){let n=t&&typeof t=="object"?Reflect.get(t,"error"):void 0;throw new Error(typeof n=="string"?n:"Browser RoomEnvironment bake did not report success.")}}a(le,"readBrowserBakeResult");var pe=a(async e=>{let{chromium:r,createServer:t}=await re(),n=new S,o,d,m,c$1,f=false;try{let u=await me();o=await t({root:e.root,configFile:!1,logLevel:"silent",optimizeDeps:{noDiscovery:!0},plugins:[de(n,u)],server:{host:"127.0.0.1",port:0,strictPort:!1}}),await o.listen();let i=o.httpServer?.address();if(!i||typeof i=="string")throw new Error("Environment bake Vite server has no ephemeral TCP address.");d=await r.launch({headless:c(e.headed),args:[...b()]}),m=await d.newContext({viewport:{width:320,height:240}});let h=await m.newPage(),a=ce(h),l=new Promise((R,H)=>{c$1=setTimeout(()=>H(new Error(`RoomEnvironment bake timed out after ${e.timeoutMs}ms.`)),e.timeoutMs),c$1.unref();});await h.goto(`http://127.0.0.1:${i.port}${N}?size=${e.size}`,{waitUntil:"domcontentloaded",timeout:Math.min(e.timeoutMs,3e4)});let g=await Promise.race([n.promise,a,l]);return await le(h,e.timeoutMs),g}catch(u){throw f=true,n.reject(u instanceof Error?u:new Error(String(u))),await n.promise.catch(()=>{}),u}finally{c$1&&clearTimeout(c$1);let u=[];if(await m?.close().catch(i=>u.push(`context: ${i instanceof Error?i.message:String(i)}`)),await d?.close().catch(i=>u.push(`browser: ${i instanceof Error?i.message:String(i)}`)),await o?.close().catch(i=>u.push(`Vite: ${i instanceof Error?i.message:String(i)}`)),!f&&u.length>0)throw new Error(`RoomEnvironment cleanup failed (${u.join("; ")}).`)}},"captureRoomEnvironment");function fe(e$1,r){let t=r??ee;if(p.isAbsolute(t)||t.length===0||t.length>2048||/[\u0000-\u001f\u007f]/u.test(t)||!t.endsWith(".ktx2"))throw new Error("Environment output must be a bounded project-relative .ktx2 path.");let n=p.resolve(e$1,t);if(!e(e$1,n)||n===e$1)throw new Error("Environment output escapes the project root.");return {asset:n,metadata:`${n.slice(0,-5)}.json`}}a(fe,"outputPaths");async function he(e$1,r){let t=p.relative(e$1,r);if(t==="")return;let n=e$1;for(let d$1 of t.split(p.sep)){n=p.join(n,d$1),await d(n)||await mkdir(n);let m=await lstat(n);if(m.isSymbolicLink()||!m.isDirectory())throw new Error(`Environment output parent is not a real directory: ${n}.`)}let o=await realpath(r);if(!e(e$1,o))throw new Error("Environment output parent resolves outside the project root.")}a(he,"ensureSafeParent");async function M(e){if(!await d(e))return;let r=await lstat(e);if(r.isSymbolicLink()||!r.isFile())throw new Error(`Environment output target must be a regular file: ${e}.`)}a(M,"validateOutputTarget");async function ve(e,r,t,n){await Promise.all([M(e),M(t)]);let o=`${process.pid}-${randomUUID()}`,d$1=p.join(p.dirname(e),`.${p.basename(e)}.${o}.tmp`),m=p.join(p.dirname(t),`.${p.basename(t)}.${o}.tmp`),c=`${d$1}.backup`,f=`${m}.backup`,u=false,i=false,h=false,a=false;try{await Promise.all([writeFile(d$1,r,{flag:"wx"}),writeFile(m,n,{encoding:"utf8",flag:"wx"})]),await d(e)&&(await rename(e,c),u=!0),await d(t)&&(await rename(t,f),i=!0),await rename(d$1,e),h=!0,await rename(m,t),a=!0,await Promise.all([rm(c,{force:!0}),rm(f,{force:!0})]);}catch(l){throw a&&await rm(t,{force:true}),h&&await rm(e,{force:true}),i&&await rename(f,t),u&&await rename(c,e),l}finally{await Promise.all([rm(d$1,{force:true}),rm(m,{force:true}),rm(c,{force:true}),rm(f,{force:true})]);}}a(ve,"writeAtomicPair");function U(e,r){return p.relative(e,r).split(p.sep).join("/")}a(U,"portableRelative");async function _e(e){let r=await realpath(e.root),t=V(e.size??256),n=j(e.timeoutMs,"Environment bake timeoutMs",1e3,15*6e4,24e4),o=fe(r,e.output);await he(r,p.dirname(o.asset));let m=await(e.capture??pe)({root:r,size:t,timeoutMs:n,headed:e.headed===true}),c=se(m.bytes,{cubeSize:t,threeRevision:m.threeRevision,compression:e.compression??"zstd"}),f=`${JSON.stringify(c.metadata,null,2)}
+`;await ve(o.asset,c.bytes,o.metadata,f);let u=await readFile(o.asset);if(c$1(u)!==c.metadata.sha256)throw new Error("Committed RoomEnvironment checksum does not match metadata.");return {schemaVersion:1,command:"environment bake",output:U(r,o.asset),metadataOutput:U(r,o.metadata),bytes:c.bytes.byteLength,metadata:c.metadata}}a(_e,"bakeRoomEnvironment");function ye(e){if(e<1e3)return `${e} B`;let r=e/1e3;return `${r>=100?Math.round(r):r.toFixed(1)} kB`}a(ye,"formatBytes");function Se(e){return [`\u2713 Environment   ${e.metadata.width}\xD7${e.metadata.height} \xB7 CubeUV ${e.metadata.cubeSize}px \xB7 RGBA16F ${e.metadata.compression}`,`  Output        ${e.output} \xB7 ${ye(e.bytes)}`,`  Checksum      ${e.metadata.sha256}`].join(`
+`)}a(Se,"formatEnvironmentBakeReport");export{_e as bakeRoomEnvironment,pe as captureRoomEnvironment,se as encodeRoomEnvironmentKtx2,Se as formatEnvironmentBakeReport,V as validateEnvironmentCubeSize};