@three-blocks/devtools 3.0.0 → 4.0.0-alpha.314.g989237b8fb54

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @three-blocks/devtools
 
+## 4.0.0-alpha.314.g989237b8fb54
+
+- Website: The home setup story now presents the starter, AI skill, and Pro Tools clearly.
+
+- Website: The home page now shows the current Three Blocks version.
+
+- Website: Email sign-in is open to everyone without a waitlist gate.
+
+- Website: Checkout now charges the displayed Pro price for each billing period.
+
+- Website: Device authorization waits until the page is ready before accepting clicks.
+
+- Website: Mobile examples now retain their intended rendering resolution.
+
+- Website: Login now shows the runnable npx command for signing in from a terminal.
+
+- Website: Example captions now stay compact on mobile and match the site on desktop.
+
+- Library: Baked Motion holds the last complete view while streamed samples load.
+
+- Devtools: Long-running commands now show static progress instead of a spinning indicator.
+
+- Devtools: Asset optimization compresses models and textures and tracks reusable outputs.
+
+- Packages: MSDF text stays crisp and color-accurate across display resolutions.
+
+- CLI: Asset optimization adds Vite config status for project models and textures.
+
+- CLI: Blender sign-in now tolerates twenty times more redirects before asking you to retry.
+
+- Packages: Built from `989237b8fb54`.
+
+
 ## 3.0.0
 
 ### Patch Changes

package/dist/asset-optimize-WFEMLDJF.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import {d}from'./chunk-EE64MV27.js';import'./chunk-ZT6T2W4B.js';import'./chunk-NPLE7PPF.js';import'./chunk-65VEJRRT.js';import {b,a as a$1,c,h,d as d$1,f}from'./chunk-5L2VS3BN.js';import {a}from'./chunk-HOZDD6PW.js';import {readFile,lstat,readdir,realpath,mkdir}from'fs/promises';import i from'path';import {read,KHR_DF_PRIMARIES_BT709,write}from'ktx-parse';var z=1,ie="ktx2-encoder@0.6.0",ae=i.join(".three-blocks","assets"),de=i.join(ae,"meta.json"),be=i.join(ae,"cache"),xe=256*1024*1024,we=64*1024*1024,ee=115e5,te=64,Te=163,Ae=166,Ee=167,Re=1000066e3,ue=1,ce=2,$e=/baseColor|emissive|diffuse|sheenColor|specularColor/u,Se=/normal/iu,Oe=/(?:^|[_\-.])(?:normal|nrm|nor)(?:[_\-.]|map|$)/iu,Me=/(?:rough|metal|orm\b|occlusion|ambient|[_\-.]ao(?:[_\-.]|$)|height|disp|thick|mask)/iu;function ve(t){return t.some(e=>Se.test(e))?"normal":t.some(e=>$e.test(e))||t.length===0?"color":"data"}a(ve,"presetForTextureSlots");function _e(t){let e=i.basename(t);return Oe.test(e)?"normal":Me.test(e)?"data":"color"}a(_e,"presetForImageName");function q(t){let e=i.extname(t).toLowerCase();return e===".glb"?"glb":e===".png"||e===".jpg"||e===".jpeg"||e===".webp"?"image":e===".hdr"?"hdr":null}a(q,"assetKindFor");function k(t,e){let r=i.relative(t,e);return (r!==""&&!r.startsWith("..")&&!i.isAbsolute(r)?r:e).split(i.sep).join("/")}a(k,"portable");var V;function le(){return V??=Promise.all([import('ktx2-encoder'),import('sharp')]).then(([t,e])=>({encodeToKTX2:t.encodeToKTX2,sharp:e.default})),V}a(le,"loadEncoderTools");function me(t,e){let r=e.quality==="high";return t==="hdr"?{mode:"uastc-hdr",options:{isHDR:true,imageType:"hdr",isUASTC:true,isYFlip:true,generateMipmap:true,needSupercompression:true,hdrQualityLevel:r?2:1}}:t==="color"&&!r?{mode:"etc1s",options:{isUASTC:false,qualityLevel:160,compressionLevel:2,isPerceptual:true,isSRGB:true,generateMipmap:true}}:{mode:"uastc",options:{isUASTC:true,uastcLDRQualityLevel:r?2:1,enableRDO:true,rdoQualityLevel:1,generateMipmap:true,needSupercompression:true,isPerceptual:t==="color",isSRGB:t==="color",isNormalMap:t==="normal"}}}a(me,"encoderOptionsFor");function Ie(t,e){let r=read(t),n=r.dataFormatDescriptor[0];if(n===void 0)return t;let s=e==="color"?ce:ue;return n.transferFunction===s&&(e!=="color"||n.colorPrimaries===KHR_DF_PRIMARIES_BT709)?t:(n.transferFunction=s,e==="color"&&(n.colorPrimaries=KHR_DF_PRIMARIES_BT709),write(r,{keepWriter:true}))}a(Ie,"normalizeDfdTransfer");function he(t,e,r,n){let s=read(t),o=s.dataFormatDescriptor[0];if(o===void 0)throw new Error(`${n} produced a KTX2 container without a data format descriptor.`);if(e==="hdr"){if(s.vkFormat!==Re||o.colorModel!==Ee)throw new Error(`${n} is not a UASTC HDR container (vkFormat ${s.vkFormat}, color model ${o.colorModel}).`)}else {let c=r==="etc1s"?Te:Ae;if(s.vkFormat!==0||o.colorModel!==c)throw new Error(`${n} is not a ${r} container (vkFormat ${s.vkFormat}, color model ${o.colorModel}).`)}let d=e==="color",u=o.transferFunction;if(d&&u!==ce)throw new Error(`${n} must carry the sRGB transfer function; found ${u}.`);if(!d&&u!==ue)throw new Error(`${n} must carry the linear transfer function; found ${u}.`);if(Math.max(s.pixelWidth,s.pixelHeight)>=8&&s.levels.length<2)throw new Error(`${n} is missing its mip chain.`);return {width:s.pixelWidth,height:s.pixelHeight}}a(he,"verifyKtx2");async function ye(t,e,r,n){let{encodeToKTX2:s,sharp:o}=await le(),d=r.maxDimension,{mode:u,options:c}=me(e,r),l=performance.now(),b=Ie(await s(t,{...c,imageDecoder:a(async w=>{let m=o(w),E=await m.metadata(),h=E.width??0,x=E.height??0;if(h<1||x<1)throw new Error(`${n} has no decodable dimensions.`);let v=Math.min(1,d/Math.max(h,x));h*v*x*v>ee&&(v=Math.sqrt(ee/(h*x)));let R=v<1,$=R?Math.max(4,Math.floor(h*v/4)*4):h,T=R?Math.max(4,Math.floor(x*v/4)*4):x,A=R?m.resize($,T,{fit:"fill",kernel:"lanczos3"}):m,{data:O,info:M}=await A.ensureAlpha().raw().toBuffer({resolveWithObject:true});return {data:new Uint8Array(O.buffer,O.byteOffset,O.byteLength),width:M.width,height:M.height}},"decode")}),e),{width:f,height:g}=he(b,e,u,n);return {bytes:b,width:f,height:g,mode:u,durationMs:performance.now()-l}}a(ye,"encodeLdrTexture");function De(t,e){let r=new TextDecoder("latin1").decode(t.subarray(0,Math.min(t.byteLength,4096))),n=/-Y\s+(\d+)\s+\+X\s+(\d+)/u.exec(r);if(n?.[1]===void 0||n[2]===void 0)throw new Error(`${e} is not a supported Radiance .hdr file (missing "-Y <h> +X <w>" resolution).`);return {width:Number(n[2]),height:Number(n[1])}}a(De,"hdrDimensions");async function Le(t,e,r){let n=De(t,r);if(Math.max(n.width,n.height)>e.hdrMaxDimension)throw new Error(`${r} is ${n.width}x${n.height}, above the ${e.hdrMaxDimension}px HDR cap; resize the source (HDR resize is not supported yet).`);let{encodeToKTX2:s}=await le(),{mode:o,options:d}=me("hdr",e),u=performance.now(),c=await s(t,d),{width:l,height:p}=he(c,"hdr",o,r);return {bytes:c,width:l,height:p,mode:o,durationMs:performance.now()-u}}a(Le,"encodeHdrTexture");function B(t,e,r){let n=t*e*1.3333333333333333;return Math.round(r==="source-hdr"?n*8:r==="source-ldr"?n*4:n*(r==="etc1s"?.5:1))}a(B,"textureVram");async function Fe(t,e,r){let n=r.preset??_e(e),s=`Image ${JSON.stringify(i.basename(e))}`,o=await ye(t,n,r,s),d=[`preset ${n} (${r.preset===null?"from filename":"explicit"})`];return n!=="color"&&d.push("linear DFD: consumers must treat this texture as non-color data"),d.push("compressed textures never flip: sample with glTF-style (flipY=false) UVs"),{bytes:o.bytes,metadata:{vramBytesIn:B(o.width,o.height,"source-ldr"),vramBytesOut:B(o.width,o.height,o.mode),textures:[{name:i.basename(e),slots:[],preset:n,mode:o.mode,width:o.width,height:o.height,bytesIn:t.byteLength,bytesOut:o.bytes.byteLength,durationMs:Math.round(o.durationMs)}],notes:d}}}a(Fe,"buildImageAsset");async function Be(t,e,r){let n=`Environment ${JSON.stringify(i.basename(e))}`,s=await Le(t,r,n);return {bytes:s.bytes,metadata:{vramBytesIn:B(s.width,s.height,"source-hdr"),vramBytesOut:B(s.width,s.height,s.mode),textures:[{name:i.basename(e),slots:["equirectangular"],preset:"hdr",mode:s.mode,width:s.width,height:s.height,bytesIn:t.byteLength,bytesOut:s.bytes.byteLength,durationMs:Math.round(s.durationMs)}],notes:["BC6H on BC-capable devices; transcodes to RGBA16F elsewhere"]}}}a(Be,"buildHdrAsset");async function Ne(t,e,r,n){let[{Logger:s,NodeIO:o},{ALL_EXTENSIONS:d,KHRTextureBasisu:u},{dedup:c,listTextureSlots:l,meshopt:p,prune:b,weld:f},{MeshoptDecoder:g,MeshoptEncoder:w}]=await Promise.all([import('@gltf-transform/core'),import('@gltf-transform/extensions'),import('@gltf-transform/functions'),import('meshoptimizer')]);await w.ready,await g.ready;let m=new o().registerExtensions(d).registerDependencies({"meshopt.encoder":w,"meshopt.decoder":g}),E=`GLB ${JSON.stringify(i.basename(e))}`;m.setLogger(new s(s.Verbosity.SILENT));let h=await m.readBinary(t);h.setLogger(new s(s.Verbosity.SILENT));let x=h.getRoot().listTextures();if(x.length>0&&x.every(y=>y.getMimeType()==="image/ktx2")&&h.getRoot().listExtensionsUsed().some(y=>y.extensionName==="EXT_meshopt_compression"))return {bytes:t,metadata:{vramBytesIn:0,vramBytesOut:0,textures:[],notes:["already optimized (KTX2 + meshopt); copied unchanged"]}};n?.("optimizing geometry"),await h.transform(c(),b({keepAttributes:true,keepExtras:true,keepSolidTextures:true}),f(),p({encoder:w,level:"medium"}));let R=[],$=[],T=0,A=0,O=0;for(let y of x){let _=y.getName()||y.getURI()||`texture-${R.length}`,D=y.getImage(),N=y.getMimeType();if(D===null||D.byteLength===0)continue;if(N==="image/ktx2"){$.push(`${_}: already KTX2, kept`);continue}if(!/^image\/(?:png|jpeg|webp)$/u.test(N)){$.push(`${_}: unsupported ${N}, kept`);continue}let j=y.getSize();if(j!==null&&Math.max(j[0],j[1])<te){$.push(`${_}: below ${te}px, kept`);continue}let G=l(y),K=ve(G);n?.(`encoding ${_} (${K})`);let S=await ye(new Uint8Array(D),K,r,`${E} texture ${JSON.stringify(_)}`);y.setImage(S.bytes).setMimeType("image/ktx2");let J=y.getURI();J!==""&&y.setURI(J.replace(/\.(?:png|jpe?g|webp)$/iu,".ktx2")),O+=1,T+=B(S.width,S.height,"source-ldr"),A+=B(S.width,S.height,S.mode),R.push({name:_,slots:G,preset:K,mode:S.mode,width:S.width,height:S.height,bytesIn:D.byteLength,bytesOut:S.bytes.byteLength,durationMs:Math.round(S.durationMs)});}O>0&&h.createExtension(u).setRequired(true);let M=await m.writeBinary(h);return await m.readBinary(M),O>0&&$.push("requires a KTX2-wired loader (three-blocks/assets or GLTFLoader.setKTX2Loader)"),{bytes:M,metadata:{vramBytesIn:T,vramBytesOut:A,textures:R,notes:$}}}a(Ne,"buildGlbAsset");function Pe(t,e,r){let n=i.basename(t,i.extname(t));if(e==="glb"){let s=r===null?i.join(i.dirname(t),`${n}.tb.glb`):i.join(r,`${n}.glb`);if(i.resolve(s)===i.resolve(t))throw new Error(`Output would overwrite the input: ${JSON.stringify(t)}. Pass a different output directory.`);return s}return i.join(r??i.dirname(t),`${n}.ktx2`)}a(Pe,"outputPathFor");async function pe(t){let e={schemaVersion:z,tool:{name:"three-blocks-devtools",assetOptimizeVersion:z,encoder:ie},assets:{}},r;try{r=await readFile(t,"utf8");}catch(n){if(b(n)==="ENOENT")return e;throw n}if(r.length>a$1.receipt)return e;try{let n=JSON.parse(r);if(typeof n!="object"||n===null)return e;let s=n;return s.schemaVersion!==z||typeof s.assets!="object"||s.assets===null?e:{...e,assets:{...s.assets}}}catch{return e}}a(pe,"readReceipt");async function ke(t){let e=[];for(let r of t){let n=i.resolve(r);if((await lstat(n)).isDirectory()){let o=(await readdir(n,{withFileTypes:true})).sort((d,u)=>d.name.localeCompare(u.name));for(let d of o)d.isFile()&&q(d.name)!==null&&e.push(i.join(n,d.name));}else e.push(n);}if(e.length===0)throw new Error("No optimizable inputs found (.glb, .png, .jpg, .webp, .hdr).");return e}a(ke,"expandInputs");async function Xe(t){let e=await realpath(t.root),r={maxDimension:re(t.maxDimension,2048),hdrMaxDimension:re(t.hdrMaxDimension,4096),quality:t.quality??"default",preset:t.preset??null},n=t.outDir===void 0?null:i.resolve(e,t.outDir);n!==null&&await mkdir(n,{recursive:true});let s=i.join(e,be),o=i.join(e,de),d$2=c(d({version:z,encoder:ie,...r})),u=await ke(t.inputs),c$1=[],l=[],p=await pe(o);for(let[b,f$1]of u.entries()){let g=q(f$1);try{if(g===null)throw new Error(`Unsupported asset type ${JSON.stringify(i.extname(f$1))}; expected .glb, .png, .jpg, .webp, or .hdr (EXR sources are not supported yet \u2014 convert environments to .hdr).`);t.onProgress?.(`${i.basename(f$1)} (${b+1}/${u.length})`);let w=g==="glb"?xe:g==="hdr"?we:a$1.texture,m=await h(f$1,w,"Asset input"),E=m.path,h$1=c(m.data),x=c(`${h$1}\0${d$2}`),v=g==="glb"?"glb":"ktx2",R=i.join(s,`${x}.${v}`),$=i.join(s,`${x}.json`),T,A,O=!1;if(t.force!==!0&&await d$1(R)&&await d$1($))T=(await h(R,w,"Cached asset")).data,A=JSON.parse((await h($,a$1.metadata,"Cached asset metadata")).data.toString("utf8")),O=!0;else {let _=a(N=>t.onProgress?.(`${i.basename(f$1)}: ${N}`),"progress"),D=g==="glb"?await Ne(m.data,E,r,_):g==="hdr"?await Be(m.data,E,r):await Fe(m.data,E,r);T=D.bytes,A=D.metadata,await f(R,T),await f($,`${JSON.stringify(A,null,"	")}
+`);}let M=Pe(E,g,n);await mkdir(i.dirname(M),{recursive:!0}),await f(M,T);let y=c(T);p.assets[k(e,E)]={kind:g,inputSha256:h$1,output:k(e,M),outputSha256:y,settingsSha256:d$2,bytesIn:m.data.byteLength,bytesOut:T.byteLength},c$1.push({input:k(e,E),output:k(e,M),kind:g,cached:O,bytesIn:m.data.byteLength,bytesOut:T.byteLength,vramBytesIn:A.vramBytesIn,vramBytesOut:A.vramBytesOut,textures:A.textures,notes:A.notes});}catch(w){l.push({input:k(e,f$1),error:w instanceof Error?w.message:String(w)});}}return c$1.length>0&&await f(o,`${JSON.stringify(p,null,"	")}
+`),{schemaVersion:1,command:"assets optimize",root:e,results:c$1,failed:l,bytesIn:c$1.reduce((b,f)=>b+f.bytesIn,0),bytesOut:c$1.reduce((b,f)=>b+f.bytesOut,0)}}a(Xe,"optimizeAssets");function re(t,e){if(t===void 0)return e;if(!Number.isInteger(t)||t<64||t>16384)throw new Error("Texture dimension caps must be integers between 64 and 16384.");return t}a(re,"boundedDimension");function I(t){if(t<1e3)return `${t} B`;if(t<1e6){let r=t/1e3;return `${r>=100?Math.round(r):r.toFixed(1)} kB`}let e=t/1e6;return `${e>=100?Math.round(e):e.toFixed(2)} MB`}a(I,"formatBytes");function ne(t,e){if(t===0)return "";let r=Math.round((e-t)/t*100);return r===0?"":` (${r>0?"+":""}${r}%)`}a(ne,"percentDelta");function Ve(t){let e=[];for(let r of t.results){let n=r.cached?" \xB7 cached":"";e.push(`${r.input} -> ${r.output}`),e.push(`  ${I(r.bytesIn)} -> ${I(r.bytesOut)}${ne(r.bytesIn,r.bytesOut)}${n}`),r.vramBytesOut>0&&e.push(`  VRAM \u2248 ${I(r.vramBytesIn)} -> ${I(r.vramBytesOut)}`);for(let s of r.textures){let o=s.slots.length>0?` [${s.slots.join(", ")}]`:"";e.push(`    ${s.name}${o} ${s.preset}/${s.mode} ${s.width}x${s.height} ${I(s.bytesIn)} -> ${I(s.bytesOut)}`);}for(let s of r.notes)e.push(`    note: ${s}`);}for(let r of t.failed)e.push(`failed ${r.input}: ${r.error}`);return t.results.length>1&&e.push(`total ${I(t.bytesIn)} -> ${I(t.bytesOut)}${ne(t.bytesIn,t.bytesOut)}`),e.join(`
+`)}a(Ve,"formatAssetOptimizeReport");async function He(t,e){let r=await realpath(t),n=i.resolve(r,e);if(!await d$1(n))return [];let s=[],o=[n],d=0;for(;o.length>0;){let u=o.shift();if(u===void 0)break;let c=(await readdir(u,{withFileTypes:true})).sort((l,p)=>l.name.localeCompare(p.name));for(let l of c){if(d+=1,d>8192)throw new Error("Public asset discovery exceeds the 8192-entry limit.");if(l.isSymbolicLink()||l.name.startsWith("."))continue;let p=i.join(u,l.name);if(l.isDirectory()){if(u===n&&l.name==="three-blocks")continue;o.push(p);continue}if(!l.isFile()||l.name.endsWith(".tb.glb"))continue;let b=q(l.name);(b==="glb"||b==="hdr")&&s.push(p);}}return s.sort()}a(He,"discoverPublicAssets");async function qe(t){let e=await realpath(t),r=await pe(i.join(e,de)),n=[];for(let[s,o]of Object.entries(r.assets).sort(([d],[u])=>d.localeCompare(u))){let d=i.resolve(e,s),u=i.resolve(e,o.output),c$1="fresh";if(!await d$1(d))c$1="missing-input";else if(!await d$1(u))c$1="missing-output";else {let[l,p]=await Promise.all([readFile(d),readFile(u)]);(c(l)!==o.inputSha256||c(p)!==o.outputSha256)&&(c$1="stale");}n.push({input:s,output:o.output,kind:o.kind,state:c$1});}return {schemaVersion:1,command:"assets status",root:e,state:n.length===0?"empty":n.every(s=>s.state==="fresh")?"fresh":"stale",entries:n}}a(qe,"inspectAssets");function Ge(t){if(t.state==="empty")return "No optimized assets recorded. Run `assets optimize <file|directory>` first.";let e=t.entries.map(r=>`${r.state==="fresh"?"fresh ":r.state.padEnd(14)} ${r.input} -> ${r.output}`);return t.state==="stale"&&e.push("Some assets moved or changed; re-run `assets optimize` on the stale inputs."),e.join(`
+`)}a(Ge,"formatAssetStatusReport");function Je(){V=void 0;}a(Je,"resetAssetOptimizeToolsForTests");export{z as ASSET_OPTIMIZE_VERSION,ae as ASSET_RECEIPT_DIRECTORY,de as ASSET_RECEIPT_FILE,He as discoverPublicAssets,Ve as formatAssetOptimizeReport,Ge as formatAssetStatusReport,qe as inspectAssets,Xe as optimizeAssets,_e as presetForImageName,ve as presetForTextureSlots,Je as resetAssetOptimizeToolsForTests};

package/dist/{browser-smoke-JHZLPGEB.js → browser-smoke-WWMWRM6S.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import {b,a as a$3}from'./chunk-L2CZ7RSV.js';import'./chunk-76WRV5MZ.js';import'./chunk-JHBQB7WC.js';import'./chunk-NQIAU3XU.js';import'./chunk-FKZT7XLM.js';import {a as a$2,b as b$1,d}from'./chunk-QJFPNM6W.js';import'./chunk-ZT6T2W4B.js';import'./chunk-NPLE7PPF.js';import {a as a$1}from'./chunk-65VEJRRT.js';import {j,a as a$4,c}from'./chunk-5L2VS3BN.js';import {a}from'./chunk-HOZDD6PW.js';import {randomUUID}from'crypto';import {mkdir,realpath,writeFile,rename,rm}from'fs/promises';import F from'path';import {PNG}from'pngjs';var ye="virtual:three-blocks-devtools/browser-smoke",ve=`\0${ye}`,Ke=`/@id/__x00__${ye}`,Be=9e4;async function Ee(){try{let[e,r]=await Promise.all([import('playwright'),import('vite')]);return {chromium:e.chromium,vite:r}}catch(e){throw new Error('Browser smoke and preview require the optional "playwright" and "vite" packages. Install both in the project and run `npx playwright install chromium`.',{cause:e})}}a(Ee,"loadBrowserSmokeTools");function V(e,r,o,t,n){let a=e??n;if(!Number.isSafeInteger(a)||a<o||a>t)throw new Error(`${r} must be an integer in ${o}...${t}.`);return a}a(V,"boundedInteger");function _e(e,r,o,t,n){let a=e??n;if(!Number.isFinite(a)||a<o||a>t)throw new Error(`${r} must be a finite number in ${o}...${t}.`);return a}a(_e,"boundedRatio");function Pe(e){let r=e??"/";if(r.length===0||r.length>2048||/[\u0000-\u001f\u007f]/u.test(r))throw new Error("Browser smoke route must be a bounded project URL.");let o=new URL(r,"http://three-blocks.invalid/");if(o.origin!=="http://three-blocks.invalid"||o.hash.length>0)throw new Error("Browser smoke route must stay within the project and have no fragment.");return `${o.pathname}${o.search}`}a(Pe,"safeRoute");function N(e,r){return e[r]===true}a(N,"booleanField");function $(e,r){if(!a$1(e)||!a$1(e.value))return {source:"missing",backend:"unknown",worker:false,workerReady:false,assetsReady:false,compileEnd:false,textEnabled:r,textReady:!r,firstFrame:false};let o=e.value,t=e.source==="public";if(t&&o.protocolVersion!==1)return {source:"public",backend:"unknown",worker:false,workerReady:false,assetsReady:false,compileEnd:false,textEnabled:r,textReady:!r,firstFrame:false};let n=a$1(o.readiness)?o.readiness:o,a=o.worker,d=t&&a$1(a)?a.offscreenCanvas===true&&a.visible===true:a===true;return {source:t?"public":"legacy",backend:t&&a$1(a)?a.offscreenCanvas===true?"OffscreenCanvas":"MainThread":a===true?"OffscreenCanvas":"unknown",worker:d,workerReady:N(n,"workerReady"),assetsReady:N(n,"assetsReady")||N(n,"loadEnd"),compileEnd:N(n,"compileEnd"),textEnabled:r,textReady:!r||N(n,"textReady"),firstFrame:N(n,"firstFrame")}}a($,"parseBrowserSmokeLifecycle");function ie(e){let r=PNG.sync.read(e),o=Math.floor(r.width*.25),t=Math.floor(r.width*.75),n=Math.floor(r.height*.25),a=Math.floor(r.height*.75),d=0,c=0;for(let f=n;f<a;f+=2)for(let p=o;p<t;p+=2){let h=(f*r.width+p)*4,l=r.data[h],i=r.data[h+1],s=r.data[h+2];l===void 0||i===void 0||s===void 0||(d+=Math.max(l,i,s),c+=1);}return c===0?0:d/c}a(ie,"screenshotLuminance");function Je(){return `
+import {b,a as a$3}from'./chunk-6RGA2IVT.js';import'./chunk-IILE5RBI.js';import'./chunk-JHBQB7WC.js';import'./chunk-2TSMAC6E.js';import'./chunk-S22OSG76.js';import'./chunk-EE64MV27.js';import {a as a$2,b as b$1,d}from'./chunk-QJFPNM6W.js';import'./chunk-ZT6T2W4B.js';import'./chunk-NPLE7PPF.js';import {a as a$1}from'./chunk-65VEJRRT.js';import {j,a as a$4,c}from'./chunk-5L2VS3BN.js';import {a}from'./chunk-HOZDD6PW.js';import {randomUUID}from'crypto';import {mkdir,realpath,writeFile,rename,rm}from'fs/promises';import F from'path';import {PNG}from'pngjs';var ye="virtual:three-blocks-devtools/browser-smoke",ve=`\0${ye}`,Ke=`/@id/__x00__${ye}`,Be=9e4;async function Ee(){try{let[e,r]=await Promise.all([import('playwright'),import('vite')]);return {chromium:e.chromium,vite:r}}catch(e){throw new Error('Browser smoke and preview require the optional "playwright" and "vite" packages. Install both in the project and run `npx playwright install chromium`.',{cause:e})}}a(Ee,"loadBrowserSmokeTools");function V(e,r,o,t,n){let a=e??n;if(!Number.isSafeInteger(a)||a<o||a>t)throw new Error(`${r} must be an integer in ${o}...${t}.`);return a}a(V,"boundedInteger");function _e(e,r,o,t,n){let a=e??n;if(!Number.isFinite(a)||a<o||a>t)throw new Error(`${r} must be a finite number in ${o}...${t}.`);return a}a(_e,"boundedRatio");function Pe(e){let r=e??"/";if(r.length===0||r.length>2048||/[\u0000-\u001f\u007f]/u.test(r))throw new Error("Browser smoke route must be a bounded project URL.");let o=new URL(r,"http://three-blocks.invalid/");if(o.origin!=="http://three-blocks.invalid"||o.hash.length>0)throw new Error("Browser smoke route must stay within the project and have no fragment.");return `${o.pathname}${o.search}`}a(Pe,"safeRoute");function N(e,r){return e[r]===true}a(N,"booleanField");function $(e,r){if(!a$1(e)||!a$1(e.value))return {source:"missing",backend:"unknown",worker:false,workerReady:false,assetsReady:false,compileEnd:false,textEnabled:r,textReady:!r,firstFrame:false};let o=e.value,t=e.source==="public";if(t&&o.protocolVersion!==1)return {source:"public",backend:"unknown",worker:false,workerReady:false,assetsReady:false,compileEnd:false,textEnabled:r,textReady:!r,firstFrame:false};let n=a$1(o.readiness)?o.readiness:o,a=o.worker,d=t&&a$1(a)?a.offscreenCanvas===true&&a.visible===true:a===true;return {source:t?"public":"legacy",backend:t&&a$1(a)?a.offscreenCanvas===true?"OffscreenCanvas":"MainThread":a===true?"OffscreenCanvas":"unknown",worker:d,workerReady:N(n,"workerReady"),assetsReady:N(n,"assetsReady")||N(n,"loadEnd"),compileEnd:N(n,"compileEnd"),textEnabled:r,textReady:!r||N(n,"textReady"),firstFrame:N(n,"firstFrame")}}a($,"parseBrowserSmokeLifecycle");function ie(e){let r=PNG.sync.read(e),o=Math.floor(r.width*.25),t=Math.floor(r.width*.75),n=Math.floor(r.height*.25),a=Math.floor(r.height*.75),d=0,c=0;for(let f=n;f<a;f+=2)for(let p=o;p<t;p+=2){let h=(f*r.width+p)*4,l=r.data[h],i=r.data[h+1],s=r.data[h+2];l===void 0||i===void 0||s===void 0||(d+=Math.max(l,i,s),c+=1);}return c===0?0:d/c}a(ie,"screenshotLuminance");function Je(){return `
 import * as THREE from 'three/webgpu';
 import { createAssetLoaderRegistry, createAssetManager, createThreeAssetAdapters, defineAssets } from 'three-blocks/assets';
 import { SceneHotReloader } from 'three-blocks/hmr';

package/dist/{chunk-NQIAU3XU.js → chunk-2TSMAC6E.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import {b,e as e$2,a as a$4,d as d$2,c as c$2,j as j$2,i as i$2,f as f$2,h as h$1,g as g$1}from'./chunk-FKZT7XLM.js';import {a as a$3}from'./chunk-ZT6T2W4B.js';import {i,j as j$1,d as d$1,e as e$1,g,b as b$1,l,f as f$1,k as k$1,c as c$3}from'./chunk-NPLE7PPF.js';import {a as a$2,c as c$1}from'./chunk-65VEJRRT.js';import {j,a as a$1,c,d,k,h,e,i as i$1,f}from'./chunk-5L2VS3BN.js';import {a}from'./chunk-HOZDD6PW.js';import {realpath,readdir,readFile,lstat,mkdir,writeFile}from'fs/promises';import Ae from'os';import L from'path';import {SHADER_ADDRESS_SCHEMA_VERSION,SHADER_RECIPE_SCHEMA_VERSION,SHADER_HYDRATION_SCHEMA_VERSION}from'three-blocks/shaders';import {createRequire}from'module';var Ge=[".ts",".tsx",".mts",".cts",".js",".jsx",".mjs",".cjs",".wgsl",".glsl",".vert",".frag",".json",".css"],Je=new Set(Ge),qe=/^(?:three-blocks\.shaders\.json|(?:precompile|three-blocks\.shaders)\.config\.(?:cjs|cts|js|mjs|mts|ts))$/u,Cr=/(?:^|\/)scene\.(?:cjs|cts|js|jsx|mjs|mts|ts|tsx)$/u,jr=/\b(?:export\s+)?(?:async\s+)?function\s+createScene\b|\bcreateScene\s*=\s*(?:async\s*)?\(/u,Dr=/\b(?:[A-Za-z_$][\w$]*\.)*(?:shaders|shaderCache|sceneShaders)\s*\.\s*(?:material|pipeline|compute|container)\s*\(/u,Ar=/\b(import|export)(?!\s*\()\s*(type\b\s*)?(?:[^"'();]*?\bfrom\s*)?["']([^"']+)["']/gu,_r=/\bimport\s*\(\s*["']([^"']+)["']\s*\)/gu,Fr=/\b(?:import|export)(?!\s*\()\s*(?:[^"'();]*?\bfrom\s*)?["']([^"']+)["']|\bimport\s*\(\s*["']([^"']+)["']\s*\)/gu,Nr=/^[0-9A-Za-z][0-9A-Za-z.+_-]{0,127}$/u,Ye=4096,Lr="./shaders";function mr(e,r){let n=L.relative(e,r).split(L.sep).join("/");if(n.length===0||/[\u0000-\u001f\u007f]/u.test(n))throw new Error("Semantic input has an unsafe relative path.");return n}a(mr,"portableRelativePath");function Xe(e,r){try{return new TextDecoder("utf-8",{fatal:!0}).decode(e)}catch{throw new Error(`Shader-relevant source ${JSON.stringify(r)} is not valid UTF-8.`)}}a(Xe,"sourceText");function Qe(e,r){let n="",t="code";for(let i=0;i<e.length;i++){let s=e[i]??"",c=e[i+1]??"";if(t==="code"){if(s==="/"&&c==="/"){n+="  ",t="line-comment",i++;continue}if(s==="/"&&c==="*"){n+="  ",t="block-comment",i++;continue}if(s==="'"||s==='"'||s==="`"){t=s==="'"?"single":s==='"'?"double":"template",n+=r?s:" ";continue}n+=s;continue}if(t==="line-comment"){s===`
+import {b,e as e$2,a as a$4,d as d$2,c as c$2,j as j$2,i as i$2,f as f$2,h as h$1,g as g$1}from'./chunk-EE64MV27.js';import {a as a$3}from'./chunk-ZT6T2W4B.js';import {i,j as j$1,d as d$1,e as e$1,g,b as b$1,l,f as f$1,k as k$1,c as c$3}from'./chunk-NPLE7PPF.js';import {a as a$2,c as c$1}from'./chunk-65VEJRRT.js';import {j,a as a$1,c,d,k,h,e,i as i$1,f}from'./chunk-5L2VS3BN.js';import {a}from'./chunk-HOZDD6PW.js';import {realpath,readdir,readFile,lstat,mkdir,writeFile}from'fs/promises';import Ae from'os';import L from'path';import {SHADER_ADDRESS_SCHEMA_VERSION,SHADER_RECIPE_SCHEMA_VERSION,SHADER_HYDRATION_SCHEMA_VERSION}from'three-blocks/shaders';import {createRequire}from'module';var Ge=[".ts",".tsx",".mts",".cts",".js",".jsx",".mjs",".cjs",".wgsl",".glsl",".vert",".frag",".json",".css"],Je=new Set(Ge),qe=/^(?:three-blocks\.shaders\.json|(?:precompile|three-blocks\.shaders)\.config\.(?:cjs|cts|js|mjs|mts|ts))$/u,Cr=/(?:^|\/)scene\.(?:cjs|cts|js|jsx|mjs|mts|ts|tsx)$/u,jr=/\b(?:export\s+)?(?:async\s+)?function\s+createScene\b|\bcreateScene\s*=\s*(?:async\s*)?\(/u,Dr=/\b(?:[A-Za-z_$][\w$]*\.)*(?:shaders|shaderCache|sceneShaders)\s*\.\s*(?:material|pipeline|compute|container)\s*\(/u,Ar=/\b(import|export)(?!\s*\()\s*(type\b\s*)?(?:[^"'();]*?\bfrom\s*)?["']([^"']+)["']/gu,_r=/\bimport\s*\(\s*["']([^"']+)["']\s*\)/gu,Fr=/\b(?:import|export)(?!\s*\()\s*(?:[^"'();]*?\bfrom\s*)?["']([^"']+)["']|\bimport\s*\(\s*["']([^"']+)["']\s*\)/gu,Nr=/^[0-9A-Za-z][0-9A-Za-z.+_-]{0,127}$/u,Ye=4096,Lr="./shaders";function mr(e,r){let n=L.relative(e,r).split(L.sep).join("/");if(n.length===0||/[\u0000-\u001f\u007f]/u.test(n))throw new Error("Semantic input has an unsafe relative path.");return n}a(mr,"portableRelativePath");function Xe(e,r){try{return new TextDecoder("utf-8",{fatal:!0}).decode(e)}catch{throw new Error(`Shader-relevant source ${JSON.stringify(r)} is not valid UTF-8.`)}}a(Xe,"sourceText");function Qe(e,r){let n="",t="code";for(let i=0;i<e.length;i++){let s=e[i]??"",c=e[i+1]??"";if(t==="code"){if(s==="/"&&c==="/"){n+="  ",t="line-comment",i++;continue}if(s==="/"&&c==="*"){n+="  ",t="block-comment",i++;continue}if(s==="'"||s==='"'||s==="`"){t=s==="'"?"single":s==='"'?"double":"template",n+=r?s:" ";continue}n+=s;continue}if(t==="line-comment"){s===`
 `?(n+=`
 `,t="code"):n+=" ";continue}if(t==="block-comment"){s==="*"&&c==="/"?(n+="  ",t="code",i++):n+=s===`
 `?`
@@ -7,11 +7,11 @@ import {b,e as e$2,a as a$4,d as d$2,c as c$2,j as j$2,i as i$2,f as f$2,h as h$
 `?`
 `:" ",s===o&&(t="code");}return n}a(Qe,"lexicalSource");function Vr(e){let r=new Set,n=Qe(e,true);for(let t of n.matchAll(Ar))t[2]===void 0&&t[3]!==void 0&&r.add(t[3]);for(let t of n.matchAll(_r))t[1]!==void 0&&r.add(t[1]);return [...r].sort()}a(Vr,"importSpecifiers");function Hr(e){let r=new Set;for(let n of Qe(e,true).matchAll(Fr)){let t=n[1]??n[2];t!==void 0&&r.add(t);}return [...r].sort()}a(Hr,"runtimeSpecifiers");function pr(e){return (e.split(/[?#]/u,1)[0]??e).replaceAll("\\","/")}a(pr,"cleanSpecifier");function Wr(e,r,n){let t=pr(r),i;if(t.startsWith("./")||t.startsWith("../"))i=L.posix.normalize(L.posix.join(L.posix.dirname(e),t));else if(t.startsWith("@/"))i=`src/${t.slice(2)}`;else if(t.startsWith("/src/"))i=t.slice(1);else return;if(i===".three-blocks"||i.startsWith(".three-blocks/"))return;let s=L.posix.extname(i).toLowerCase(),c=new Set([i]);if(s.length===0||!Je.has(s)){for(let o of Ge)c.add(`${i}${o}`);for(let o of Ge)c.add(`${i}/index${o}`);}else if([".js",".mjs",".cjs",".jsx"].includes(s)){let o=i.slice(0,-s.length);for(let m of [".ts",".tsx",".mts",".cts"])c.add(`${o}${m}`);}return [...c].find(o=>n.has(o))}a(Wr,"resolveProjectImport");function Kr(e,r){let n=Qe(r,false);return Cr.test(e)||jr.test(n)||Dr.test(n)}a(Kr,"isShaderRoot");async function Ce(e,r){let n=await realpath(e);if(r!==void 0){let a={},u=0;for(let w of r){let O=await j(n,L.join(n,w),a$1.semanticInput,"Declared shader semantic input");if(u+=O.data.byteLength,u>a$1.semanticTotal)throw new Error("Declared shader semantic inputs exceed the total inspection size limit.");a[w]=c(O.data);}return a}let t=new Map,i=L.join(n,"src");if(await d(i))for(let a of await k(n,i,u=>Je.has(L.extname(u).toLowerCase()))){let u=await j(n,a,a$1.semanticInput,"Shader semantic input");t.set(mr(n,a),u.data);}for(let a of await readdir(n,{withFileTypes:true})){if(!a.isFile()||!qe.test(a.name)&&!Je.has(L.extname(a.name).toLowerCase()))continue;let u=await j(n,L.join(n,a.name),a$1.semanticInput,qe.test(a.name)?"Shader configuration input":"Shader semantic input");t.set(a.name,u.data);}if(t.size>Ye)throw new Error(`Shader input discovery exceeds the ${Ye}-file limit.`);let s=new Set,c$1=new Map;for(let[a,u]of t){if(!a.includes("/")&&qe.test(a)&&s.add(a),!a.startsWith("src/"))continue;let w=Xe(u,a);c$1.set(a,w),Kr(a,w)&&s.add(a);}if(s.size===0)throw new Error("No shader registration or scene source root was found.");let o=new Set,m=[...s].sort();for(;m.length>0;){let a=m.shift();if(a===void 0||o.has(a))continue;let u=t.get(a);if(u===void 0)continue;o.add(a);let w=c$1.get(a)??Xe(u,a);for(let O of Vr(w)){let V=Wr(a,O,t);V!==void 0&&!o.has(V)&&m.push(V);}m.sort();}let l=0,f={};for(let a of [...o].sort()){let u=t.get(a);if(u===void 0)throw new Error(`Shader input ${JSON.stringify(a)} disappeared during inspection.`);if(l+=u.byteLength,l>a$1.semanticTotal)throw new Error("Semantic shader inputs exceed the total inspection size limit.");f[a]=c(u);}return f}a(Ce,"snapshotShaderInputs");function Ze(e){if(typeof e=="string")return e;if(a$2(e))return Ze(e.import)??Ze(e.default)}a(Ze,"conditionalImportTarget");async function fr(e,r){let n=e;for(;;){let t=L.join(n,"node_modules",...r.split("/"),"package.json");if(await d(t)){let s=await h(t,a$1.packageJson,`${r} package.json`),c=JSON.parse(s.data.toString("utf8"));if(!a$2(c)||c.name!==r||typeof c.version!="string"||!Nr.test(c.version))throw new Error(`Installed ${r} package metadata is invalid.`);return {root:L.dirname(s.path),manifest:c}}let i=L.dirname(n);if(i===n)break;n=i;}throw new Error(`Cannot verify the installed ${r} package.`)}a(fr,"findInstalledPackage");async function zr(e$1,r){if(!a$2(r.exports))throw new Error("Installed three-blocks package has no public exports map.");let n=Ze(r.exports[Lr]);if(n===void 0||!n.startsWith("./"))throw new Error("Installed three-blocks shader export has no import target.");let t=await realpath(e$1),i=[L.resolve(t,n)],s=new Map,c$1=0;for(;i.length>0;){let m=i.shift();if(m===void 0)break;let l=await h(m,a$1.semanticInput,"Three Blocks shader runtime module");if(!e(t,l.path)||l.path===t)throw new Error("Three Blocks shader runtime closure escapes its package.");let f=mr(t,l.path);if(s.has(f))continue;if(c$1+=l.data.byteLength,c$1>a$1.semanticTotal)throw new Error("Three Blocks shader runtime closure exceeds the inspection limit.");s.set(f,c(l.data));let a=Xe(l.data,f);for(let u of Hr(a)){let w=pr(u);if(!w.startsWith("./")&&!w.startsWith("../"))continue;let O=L.resolve(L.dirname(l.path),w);if(!e(t,O))throw new Error("Three Blocks shader runtime import escapes its package.");i.push(O);}if(i.sort(),s.size+i.length>Ye)throw new Error("Three Blocks shader runtime closure exceeds the file limit.")}let o=[...s].sort((m,l)=>m[0].localeCompare(l[0])).map(([m,l])=>`${m}\0${l}`).join(`
 `);return c(o)}a(zr,"shaderRuntimeClosure");async function we(e){let[r,n]=await Promise.all([fr(e,"three"),fr(e,"three-blocks")]);return {three:String(r.manifest.version),threeBlocks:String(n.manifest.version),threeBlocksShaderClosure:await zr(n.root,n.manifest)}}a(we,"readInstalledShaderRuntime");var Sr=4096,qr=createRequire(import.meta.url),gr,E=new Proxy({},{get(e,r){return gr??=qr("typescript"),Reflect.get(gr,r)}});function te(e){let r=e;for(;E.isParenthesizedExpression(r)||E.isAsExpression(r)||E.isSatisfiesExpression(r)||E.isNonNullExpression(r);)r=r.expression;return r}a(te,"unwrap");function Gr(e){if(E.isIdentifier(e)||E.isStringLiteral(e)||E.isNumericLiteral(e))return e.text}a(Gr,"propertyName");function ve(e,r){let n=new Map;for(let t of e.properties){if(!E.isPropertyAssignment(t))throw new Error(`${r} may contain only static property assignments.`);let i=Gr(t.name);if(i===void 0||n.has(i))throw new Error(`${r} contains a computed or duplicate property.`);n.set(i,t.initializer);}return n}a(ve,"properties");function be(e,r){if(e===void 0)throw new Error(`${r} is missing.`);let n=te(e);if(!E.isObjectLiteralExpression(n))throw new Error(`${r} must be a static object literal.`);return n}a(be,"objectLiteral");function ke(e,r){if(e===void 0)throw new Error(`${r} is missing.`);let n=te(e);if(!E.isStringLiteral(n)&&!E.isNoSubstitutionTemplateLiteral(n))throw new Error(`${r} must be a string literal.`);return n.text}a(ke,"stringLiteral");function je(e,r){if(e===void 0)throw new Error(`${r} is missing.`);let n=te(e);if(!E.isNumericLiteral(n))throw new Error(`${r} must be a numeric literal.`);return Number(n.text)}a(je,"numericLiteral");function yr(e,r){if(e===void 0)throw new Error(`${r} is missing.`);let n=te(e);if(!E.isArrayLiteralExpression(n))throw new Error(`${r} must be a static array literal.`);return n.elements}a(yr,"arrayLiteral");function Jr(e,r){if(e===void 0)throw new Error(`${r} is missing.`);let n=te(e);if(n.kind===E.SyntaxKind.NullKeyword)return null;if(!E.isNumericLiteral(n))throw new Error(`${r} must be null or a numeric literal.`);return Number(n.text)}a(Jr,"numericOrNullLiteral");function Yr(e){return e.parseDiagnostics??[]}a(Yr,"parseDiagnostics");function wr(e,r,n,t){let i=E.createSourceFile(r,e,E.ScriptTarget.Latest,true,E.ScriptKind.TS),s=Yr(i);if(s.length>0)throw new Error(`Shader manifest is not valid TypeScript: ${E.flattenDiagnosticMessageText(s[0]?.messageText??"parse error"," ")}`);let c=i.statements.filter(E.isExportAssignment).filter(v=>!v.isExportEquals);if(c.length!==1)throw new Error("Shader manifest must contain exactly one default export.");let o=ve(be(c[0]?.expression,"Shader manifest default export"),"Shader manifest"),m=o.get("version");if(m===void 0||!E.isNumericLiteral(te(m))||Number(te(m).getText(i))!==3)throw new Error("Shader manifest version must be the numeric literal 3.");if(ke(o.get("scene"),"Shader manifest scene")!==n)throw new Error(`Shader manifest scene does not match "${n}".`);let l=o.get("runtime"),a$1=(t?.compatibility??(l===void 0?"":ke(ve(be(l,"Shader manifest runtime"),"Shader manifest runtime").get("id"),"Shader manifest runtime id"))).startsWith("three-webgl-");if(t){if(ke(o.get("three"),"Shader manifest Three.js version")!==t.three||ke(o.get("threeBlocks"),"Shader manifest Three Blocks version")!==t.threeBlocks)throw new Error("Shader manifest runtime versions do not match its receipt.");let v=ve(be(o.get("runtime"),"Shader manifest runtime"),"Shader manifest runtime");if(ke(v.get("id"),"Shader manifest runtime id")!==t.compatibility||je(v.get("address"),"Shader manifest address schema")!==t.address||je(v.get("recipe"),"Shader manifest recipe schema")!==t.recipe||je(v.get("hydration"),"Shader manifest hydration schema")!==t.hydration)throw new Error("Shader manifest runtime compatibility schemas do not match its receipt.")}let u=ve(be(o.get("entries"),"Shader manifest entries"),"Shader manifest entries");if(u.size===0&&!a$1||u.size>Sr)throw new Error(`Shader manifest must contain ${a$1?"0":"1"}...${Sr} entries.`);let w=yr(o.get("modules"),"Shader manifest modules").map((v,$)=>{let D=te(v);if(!E.isStringLiteral(D)&&!E.isNoSubstitutionTemplateLiteral(D))throw new Error(`Shader manifest module ${$} must be a shader string literal.`);if(D.text.length===0)throw new Error(`Shader manifest module ${$} is empty.`);return D.text}),O=yr(o.get("states"),"Shader manifest states").map((v,$)=>{let D=ve(be(v,`Shader manifest state ${$}`),`Shader manifest state ${$}`),T=a((q,p)=>{let b=Jr(D.get(q),`Shader manifest state ${$} ${q}`);if(b===null)return  false;let x=w[b];if(x===void 0||!a$1&&!x.includes(p))throw new Error(`Shader manifest state ${$} ${q} does not reference a ${p} module.`);return  true},"moduleAt"),A=T("vertex","@vertex"),C=T("fragment","@fragment"),H=T("compute","@compute");if(H&&(A||C))throw new Error(`Shader manifest state ${$} mixes render and compute stages.`);if(!H&&!A&&!C)throw new Error(`Shader manifest state ${$} contains no shader stage.`);return {vertex:A,fragment:C,compute:H}}),V={render:0,vertex:0,fragment:0,compute:0};for(let[v,$]of u){if(v.length===0||/[\u0000-\u001f\u007f]/.test(v))throw new Error("Shader manifest contains an invalid entry key.");let D=je($,`Shader manifest entry "${v}"`),T=O[D];if(T===void 0)throw new Error(`Shader manifest entry "${v}" references an absent state.`);(T.vertex||T.fragment)&&(V.render+=1),T.vertex&&(V.vertex+=1),T.fragment&&(V.fragment+=1),T.compute&&(V.compute+=1);}return V}a(wr,"inspectPrecompiledManifest");function Xr(e,r){return e.render===r.render&&e.vertex===r.vertex&&e.fragment===r.fragment&&e.compute===r.compute}a(Xr,"sameCoverage");function Zr(e){let r=e.some(t=>t.state==="invalid")?"invalid":e.some(t=>t.state==="missing")?"missing":e.some(t=>t.state==="stale")?"stale":"fresh",n=e.filter(t=>t.state===r);return {state:r,reason:r==="fresh"?`${e.length} configured shader scene${e.length===1?" is":"s are"} fresh.`:n.map(t=>`${t.scene} (${t.backend}): ${t.reason}`).join("; ")}}a(Zr,"classifyMatrix");function Qr(e,r,n){let t=e.tool;if(!t)return "Shader receipt has no public tool compatibility metadata.";if((t.compatibilities?.[n]??t.compatibility)!==r)return "Shader receipt targets a different runtime compatibility contract.";if(t.transform!==b)return "Shader receipt uses a different provider transform version.";if(t.address!==SHADER_ADDRESS_SCHEMA_VERSION||t.recipe!==SHADER_RECIPE_SCHEMA_VERSION||t.hydration!==SHADER_HYDRATION_SCHEMA_VERSION)return "Shader receipt uses incompatible address, recipe, or hydration schemas."}a(Qr,"exactToolCompatibility");function et(e,r){let n=Object.keys(r).filter(s=>Object.hasOwn(e,s)&&e[s]!==r[s]),t=Object.keys(r).filter(s=>!Object.hasOwn(e,s)),i=Object.keys(e).filter(s=>!Object.hasOwn(r,s));return {...n.length>0?{changedInputs:n}:{},...t.length>0?{addedInputs:t}:{},...i.length>0?{removedInputs:i}:{}}}a(et,"inputChanges");async function De(e=process.cwd(),r,n){let t=await i(e),i$2=await j$1(t),s=d$1(n??i$2.backend),c$2=i$2.scenes.flatMap(l=>e$1(l,s).map(f=>({scene:l,backend:f,key:g(l.key,f)}))),o=L.join(t,b$1),m=a(()=>({schemaVersion:1,root:t,state:"missing",reason:`${b$1}/meta.json is absent.`,scenes:c$2.map(({scene:l,backend:f})=>({scene:l.key,backend:f,state:"missing",reason:"No committed shader receipt."}))}),"missing");if(!await d(o)||!await d(L.join(o,"meta.json")))return m();try{let l=await i$1(t,o,"Shader artifact directory"),f=await j(l,L.join(l,"meta.json"),a$1.receipt,"Shader receipt"),a=c$1(JSON.parse(f.data.toString("utf8"))),u=await e$2(l,f.data),w=r??await we(t),O=new Set(i$2.scenes.flatMap(p=>e$1(p,["webgpu","webgl"]).map(b=>g(p.key,b)))),v=Object.keys(a.scenes).filter(p=>!O.has(p));if(v.length>0)throw new Error(`Shader receipt contains unconfigured scenes: ${v.join(", ")}.`);let $=a.runtime.three!==w.three,D=a.runtime.threeBlocksShaderClosure!==w.threeBlocksShaderClosure,T=a.tool?.version!==a$3,A=L.join(t,i$2.publicDir??"public"),C=[];for(let{scene:p,backend:b,key:x}of c$2){let h=a.scenes[x];if(!h){C.push({scene:p.key,backend:b,state:"missing",reason:"Scene/backend is absent from the complete receipt matrix."});continue}let _=a$4(w.three,b),j$1=Qr(a,_,b);if(j$1)throw new Error(`${x}: ${j$1}`);let K=await j(l,L.join(l,h.artifact),a$1.manifest,"Shader manifest");if(c(K.data)!==h.artifactHash)throw new Error(`Shader artifact checksum differs for scene "${p.key}".`);if(h.asset!==void 0&&h.assetHash!==void 0){let F=await j(A,L.join(A,h.asset),a$1.manifest,"Static shader manifest");if(c(F.data)!==h.assetHash)throw new Error(`Static shader manifest checksum differs for scene "${p.key}".`)}if(h.bytes!==void 0&&h.bytes!==K.data.byteLength)throw new Error(`Shader artifact byte count differs for scene "${p.key}".`);let B=wr(K.data.toString("utf8"),K.path,p.key,{three:a.runtime.three,threeBlocks:a.runtime.threeBlocks,compatibility:_,address:SHADER_ADDRESS_SCHEMA_VERSION,recipe:SHADER_RECIPE_SCHEMA_VERSION,hydration:SHADER_HYDRATION_SCHEMA_VERSION});if(!Xr(B,h.coverage))throw new Error(`Shader coverage differs for scene "${p.key}".`);if(b==="webgpu"&&!i$2.allowLiveBuilds&&h.skipped&&h.skipped.render+h.skipped.compute>0)throw new Error(`Scene "${p.key}" contains skipped live builds but allowLiveBuilds is false.`);let S=await Ce(t,p.inputs),k=et(h.inputs,S),y=(k.changedInputs?.length??0)+(k.addedInputs?.length??0)+(k.removedInputs?.length??0),g=$||D||T||y>0,M=u?.scenes[x],R=M===void 0||u===void 0?void 0:{...M,schemaVersion:u.schemaVersion,measuredAt:u.measuredAt,source:u.source,...u.source==="committed-capture"?{adapter:u.adapter,platform:u.platform}:{}};C.push({scene:p.key,backend:b,state:g?"stale":"fresh",reason:$?"Installed Three.js version differs from the receipt.":D?"Installed three-blocks/shaders runtime closure differs from the receipt.":T?`Receipt was generated by @three-blocks/devtools ${a.tool?.version??"unknown"}.`:y>0?`${y} semantic shader input${y===1?"":"s"} changed.`:"Manifest, runtime, schemas, transform, and semantic inputs match.",coverage:B,...!g&&R!==void 0&&R.builds===B.render+B.compute?{timing:R}:{},...k});}let H=Zr(C),q=H.state==="fresh"&&u!==void 0&&C.every(p=>p.timing!==void 0)?u:void 0;return {schemaVersion:1,root:t,...H,scenes:C,runtime:w,receipt:a,...q===void 0?{}:{timing:q}}}catch(l){let f=l instanceof Error?l.message:String(l);return {schemaVersion:1,root:t,state:"invalid",reason:f,scenes:c$2.map(({scene:a,backend:u})=>({scene:a.key,backend:u,state:"invalid",reason:f}))}}}a(De,"inspectShaderMatrix");var xr=".three-blocks/shaders/pending-capture";function nt(e){return (e instanceof Error?`${e.name}: ${e.message}`:String(e)).includes("ShaderHydrationError:")}a(nt,"isShaderHydrationFailure");async function it(e,r,n){if(r.length===0)return;let t=L.join(e,b$1,"meta.json"),i=await readFile(t);if(c(i)!==c(n))throw new Error("Shader receipt changed before failed scenes could be marked for recapture.");let s=c$1(JSON.parse(i.toString("utf8"))),c$2=c(n),o=new Set(r),m=c$1({...s,scenes:Object.fromEntries(Object.entries(s.scenes).map(([l,f])=>[l,o.has(l)?{...f,inputs:{...f.inputs,[xr]:c$2}}:f]))});await f(t,`${d$2(m)}
-`);}a(it,"markShaderScenesForRecapture");function st(e,r){return d$2(e)===d$2(r)}a(st,"equalSnapshot");async function Vt(e={}){let r=e.root?await realpath(e.root):await i(e.start),n=e.config===void 0?await l(r):void 0,t=e.config??n?.config??await j$1(r),i$1=e.runtime??await we(r),s=d$1(e.backend??t.backend),c$1=d$1(t.backend),o=[...new Set([...c$1,...s])],m=[...s].reverse(),l$1=[...f$1(t.scenes,m)],f,a$1={},u;if(e.ifStale){let S=await De(r,i$1,e.backend??t.backend);if(S.state==="fresh"&&S.scenes.every(k=>k.timing!==void 0))return {schemaVersion:1,root:r,skipped:true,reason:S.reason,scenes:[]};if(S.state!=="invalid"&&S.receipt!==void 0){let k=S.state==="fresh";l$1=l$1.filter(({scene:y,backend:g})=>{let M=S.scenes.find(R=>R.scene===y.key&&R.backend===g);return M?.state!=="fresh"||k&&M.timing===void 0}),f=S.receipt;for(let y of S.scenes){if(y.state!=="fresh"||y.timing===void 0)continue;let{builds:g$1,liveBuildMs:M,precompiledBuildMs:R,avoidedBuildMs:F,runs:W,spreadMs:Ee}=y.timing;a$1[g(y.scene,y.backend)]={builds:g$1,liveBuildMs:M,precompiledBuildMs:R,avoidedBuildMs:F,runs:W,spreadMs:Ee},y.timing.source==="committed-capture"&&y.timing.adapter!==void 0&&y.timing.platform!==void 0&&(u={adapter:y.timing.adapter,platform:y.timing.platform});}}}let w=performance.now(),O=f!==void 0&&(f.runtime.three!==i$1.three||f.runtime.threeBlocksShaderClosure!==i$1.threeBlocksShaderClosure||f.tool?.version!==a$3)?c(d$2({runtime:f.runtime,tool:f.tool})):void 0,V=a(async()=>new Map(await Promise.all(t.scenes.map(async S=>[S.key,await Ce(r,S.inputs)]))),"snapshotInputs"),v=await V(),$=a(async()=>{let S=await V();for(let k of t.scenes){let y=v.get(k.key),g=S.get(k.key);if(y===void 0||g===void 0||!st(y,g))throw new Error(`Semantic shader inputs changed during capture for scene "${k.key}"; the current scene was not committed.`)}},"assertInputsUnchanged"),D=e.driver===void 0,T=e.driver===void 0&&e.driverKind===void 0&&e.serve===void 0&&e.url===void 0?await k$1(r):void 0,A=e.serve??T?.serve,C=e.driverKind??T?.driverKind??(A===void 0?"vite":"static");if(e.url!==void 0&&(e.serve!==void 0||e.driverKind!==void 0))throw new Error("--url cannot be combined with --driver or --serve.");if(C==="vite"&&A!==void 0)throw new Error("--serve requires the static shader driver.");if(C==="static"&&A===void 0&&e.driver===void 0)throw new Error("The static shader driver requires --serve <built-directory>.");let H=e.driver===void 0?await import('./shader-browser-YPBP3WQY.js'):void 0,q=a(()=>e.url!==void 0?H.createAttachedPlaywrightShaderDriver({root:r,runtime:i$1,url:e.url,...e.headed!==void 0?{headed:e.headed}:{}}):C==="static"?H.createStaticPlaywrightShaderDriver({root:r,runtime:i$1,serve:A,...e.headed!==void 0?{headed:e.headed}:{}}):H.createPlaywrightShaderDriver({root:r,runtime:i$1,...e.headed!==void 0?{headed:e.headed}:{}}),"createDriver"),p=new Map,b=a(S=>{if(e.driver!==void 0)return e.driver;let k=p.get(S);return k===void 0&&(k=q(),p.set(S,k)),k},"driverFor"),x=new Map,h=[],_=f!==void 0&&t.scenes.every(S=>e$1(S,o).every(k=>f?.scenes[g(S.key,k)]!==void 0)),j=f,K,B=e.attempts??2;if(!Number.isSafeInteger(B)||B<1||B>5)throw new Error("Shader capture attempts must be an integer in 1...5.");try{for(let[g$1,M]of l$1.entries()){let{scene:R,backend:F,key:W}=M,Ee=b(F);e.onSceneStart?.(W,g$1,l$1.length);let N,Se,se=0;for(;se<B;se++)try{N=c$2(await Ee.capture(R,t,F),{scene:R.key,backend:F,runtime:i$1});let Q=F==="webgl"&&N.skipped.every(G=>G.reason.startsWith("WebGL shader precompilation does not support "));if(N.skipped.length>0&&!t.allowLiveBuilds&&!Q)throw new Error(`Scene "${R.key}" contains ${N.skipped.length} unregistered live shader build${N.skipped.length===1?"":"s"} while allowLiveBuilds is false.`);break}catch(Q){Se=Q,N=void 0,se+1<B&&e.onSceneRetry?.(R.key,se+2,B,t.timeoutMs,Q);}if(!N)throw new Error(`Shader capture "${R.key}" failed after ${B} attempts: ${Se instanceof Error?Se.message:String(Se)}`);if(x.set(W,N),h.push({scene:R.key,backend:F,attempts:se+1,coverage:N.coverage,skipped:N.skipped.length,startupBuilds:N.stats.registeredBuilds,startupBuildMs:N.stats.buildMs,...N.timing===void 0?{}:{timing:N.timing}}),_&&j!==void 0){await $();let Q=new Map(t.scenes.map(G=>{let Fe=e$1(G,o),ae=G.key===R.key?v.get(G.key):Fe.map(J=>j?.scenes[g(G.key,J)]?.inputs).find(J=>J!==void 0);if(ae===void 0)throw new Error(`Shader checkpoint is missing scene "${G.key}".`);return O!==void 0&&!Fe.every(J=>x.has(g(G.key,J)))&&(ae={...ae,[xr]:O}),[G.key,ae]}));K=await j$2({root:r,scenes:t.scenes,backends:o,captures:new Map([[W,N]]),runtime:i$1,inputs:Q,previousReceipt:j,publicDirectory:t.publicDir??"public"}),j=K.receipt;}}await $(),K=await j$2({root:r,scenes:t.scenes,backends:o,captures:x,runtime:i$1,inputs:v,...f===void 0?{}:{previousReceipt:f},publicDirectory:t.publicDir??"public"});let S={...a$1};for(let g$1 of h)S[g(g$1.scene,g$1.backend)]={builds:g$1.coverage.render+g$1.coverage.compute,setupMeasured:!1,liveBuildMs:g$1.startupBuildMs,precompiledBuildMs:0,avoidedBuildMs:g$1.startupBuildMs,runs:1,spreadMs:0};if(e.commitTiming===!0){let g=u??{adapter:x.values().next().value?.provenance?.adapter??"WebGPU adapter",platform:`${Ae.platform()}/${Ae.arch()}`},M=p.values().next().value??e.driver;await i$2(r,S,await(M?.timingEnvironment?.()??g));}else await f$2(r,S);let k=await readFile(L.join(K.directory,"meta.json")),y=await e$2(K.directory,k);return {schemaVersion:1,root:r,skipped:!1,reason:`Wrote ${h.length} shader scene${h.length===1?"":"s"}.`,durationMs:performance.now()-w,scenes:h,measurement:{beforeBuilds:h.reduce((g,M)=>g+M.startupBuilds,0),afterBuilds:0,firstFrameDeltaMs:-h.reduce((g,M)=>g+M.startupBuildMs,0),source:"capture-build-phase"},...n===void 0?{}:{configuration:{created:n.created,file:n.file}},written:K,...y===void 0?{}:{timing:y}}}finally{D&&await Promise.all([...p.values()].map(S=>S.close()));}}a(Vt,"captureShaders");function at(e){return ["workerReady","assetsReady",...e.requiresText?["textReady"]:[],"compileEnd","firstFrame"]}a(at,"requiredReadiness");function Rr(e){if(e.length===0)throw new Error("Cannot take the median of an empty shader timing capture.");let r=[...e].sort((s,c)=>s-c),n=Math.floor(r.length/2),t=r[n];if(t===void 0)throw new Error("Shader timing median is unavailable.");if(r.length%2===1)return t;let i=r[n-1];if(i===void 0)throw new Error("Shader timing median pair is unavailable.");return (i+t)/2}a(Rr,"median");function er(e,r,n,t){if(e.scene!==r.key||e.mode!==n)throw new Error(`Browser observation identity differs for scene "${r.key}".`);if(e.compatibility!==t||e.transform!==b)throw new Error(`Browser observation compatibility differs for scene "${r.key}".`);let i=at(r).filter(s=>e.readiness[s]!==true);if(i.length>0)throw new Error(`Scene "${r.key}" ${n} observation is missing readiness bits: ${i.join(", ")}.`);if(e.errors.length>0)throw new Error(`Scene "${r.key}" ${n} browser errors:
+`);}a(it,"markShaderScenesForRecapture");function st(e,r){return d$2(e)===d$2(r)}a(st,"equalSnapshot");async function Vt(e={}){let r=e.root?await realpath(e.root):await i(e.start),n=e.config===void 0?await l(r):void 0,t=e.config??n?.config??await j$1(r),i$1=e.runtime??await we(r),s=d$1(e.backend??t.backend),c$1=d$1(t.backend),o=[...new Set([...c$1,...s])],m=[...s].reverse(),l$1=[...f$1(t.scenes,m)],f,a$1={},u;if(e.ifStale){let S=await De(r,i$1,e.backend??t.backend);if(S.state==="fresh"&&S.scenes.every(k=>k.timing!==void 0))return {schemaVersion:1,root:r,skipped:true,reason:S.reason,scenes:[]};if(S.state!=="invalid"&&S.receipt!==void 0){let k=S.state==="fresh";l$1=l$1.filter(({scene:y,backend:g})=>{let M=S.scenes.find(R=>R.scene===y.key&&R.backend===g);return M?.state!=="fresh"||k&&M.timing===void 0}),f=S.receipt;for(let y of S.scenes){if(y.state!=="fresh"||y.timing===void 0)continue;let{builds:g$1,liveBuildMs:M,precompiledBuildMs:R,avoidedBuildMs:F,runs:W,spreadMs:Ee}=y.timing;a$1[g(y.scene,y.backend)]={builds:g$1,liveBuildMs:M,precompiledBuildMs:R,avoidedBuildMs:F,runs:W,spreadMs:Ee},y.timing.source==="committed-capture"&&y.timing.adapter!==void 0&&y.timing.platform!==void 0&&(u={adapter:y.timing.adapter,platform:y.timing.platform});}}}let w=performance.now(),O=f!==void 0&&(f.runtime.three!==i$1.three||f.runtime.threeBlocksShaderClosure!==i$1.threeBlocksShaderClosure||f.tool?.version!==a$3)?c(d$2({runtime:f.runtime,tool:f.tool})):void 0,V=a(async()=>new Map(await Promise.all(t.scenes.map(async S=>[S.key,await Ce(r,S.inputs)]))),"snapshotInputs"),v=await V(),$=a(async()=>{let S=await V();for(let k of t.scenes){let y=v.get(k.key),g=S.get(k.key);if(y===void 0||g===void 0||!st(y,g))throw new Error(`Semantic shader inputs changed during capture for scene "${k.key}"; the current scene was not committed.`)}},"assertInputsUnchanged"),D=e.driver===void 0,T=e.driver===void 0&&e.driverKind===void 0&&e.serve===void 0&&e.url===void 0?await k$1(r):void 0,A=e.serve??T?.serve,C=e.driverKind??T?.driverKind??(A===void 0?"vite":"static");if(e.url!==void 0&&(e.serve!==void 0||e.driverKind!==void 0))throw new Error("--url cannot be combined with --driver or --serve.");if(C==="vite"&&A!==void 0)throw new Error("--serve requires the static shader driver.");if(C==="static"&&A===void 0&&e.driver===void 0)throw new Error("The static shader driver requires --serve <built-directory>.");let H=e.driver===void 0?await import('./shader-browser-K7H5MZSG.js'):void 0,q=a(()=>e.url!==void 0?H.createAttachedPlaywrightShaderDriver({root:r,runtime:i$1,url:e.url,...e.headed!==void 0?{headed:e.headed}:{}}):C==="static"?H.createStaticPlaywrightShaderDriver({root:r,runtime:i$1,serve:A,...e.headed!==void 0?{headed:e.headed}:{}}):H.createPlaywrightShaderDriver({root:r,runtime:i$1,...e.headed!==void 0?{headed:e.headed}:{}}),"createDriver"),p=new Map,b=a(S=>{if(e.driver!==void 0)return e.driver;let k=p.get(S);return k===void 0&&(k=q(),p.set(S,k)),k},"driverFor"),x=new Map,h=[],_=f!==void 0&&t.scenes.every(S=>e$1(S,o).every(k=>f?.scenes[g(S.key,k)]!==void 0)),j=f,K,B=e.attempts??2;if(!Number.isSafeInteger(B)||B<1||B>5)throw new Error("Shader capture attempts must be an integer in 1...5.");try{for(let[g$1,M]of l$1.entries()){let{scene:R,backend:F,key:W}=M,Ee=b(F);e.onSceneStart?.(W,g$1,l$1.length);let N,Se,se=0;for(;se<B;se++)try{N=c$2(await Ee.capture(R,t,F),{scene:R.key,backend:F,runtime:i$1});let Q=F==="webgl"&&N.skipped.every(G=>G.reason.startsWith("WebGL shader precompilation does not support "));if(N.skipped.length>0&&!t.allowLiveBuilds&&!Q)throw new Error(`Scene "${R.key}" contains ${N.skipped.length} unregistered live shader build${N.skipped.length===1?"":"s"} while allowLiveBuilds is false.`);break}catch(Q){Se=Q,N=void 0,se+1<B&&e.onSceneRetry?.(R.key,se+2,B,t.timeoutMs,Q);}if(!N)throw new Error(`Shader capture "${R.key}" failed after ${B} attempts: ${Se instanceof Error?Se.message:String(Se)}`);if(x.set(W,N),h.push({scene:R.key,backend:F,attempts:se+1,coverage:N.coverage,skipped:N.skipped.length,startupBuilds:N.stats.registeredBuilds,startupBuildMs:N.stats.buildMs,...N.timing===void 0?{}:{timing:N.timing}}),_&&j!==void 0){await $();let Q=new Map(t.scenes.map(G=>{let Fe=e$1(G,o),ae=G.key===R.key?v.get(G.key):Fe.map(J=>j?.scenes[g(G.key,J)]?.inputs).find(J=>J!==void 0);if(ae===void 0)throw new Error(`Shader checkpoint is missing scene "${G.key}".`);return O!==void 0&&!Fe.every(J=>x.has(g(G.key,J)))&&(ae={...ae,[xr]:O}),[G.key,ae]}));K=await j$2({root:r,scenes:t.scenes,backends:o,captures:new Map([[W,N]]),runtime:i$1,inputs:Q,previousReceipt:j,publicDirectory:t.publicDir??"public"}),j=K.receipt;}}await $(),K=await j$2({root:r,scenes:t.scenes,backends:o,captures:x,runtime:i$1,inputs:v,...f===void 0?{}:{previousReceipt:f},publicDirectory:t.publicDir??"public"});let S={...a$1};for(let g$1 of h)S[g(g$1.scene,g$1.backend)]={builds:g$1.coverage.render+g$1.coverage.compute,setupMeasured:!1,liveBuildMs:g$1.startupBuildMs,precompiledBuildMs:0,avoidedBuildMs:g$1.startupBuildMs,runs:1,spreadMs:0};if(e.commitTiming===!0){let g=u??{adapter:x.values().next().value?.provenance?.adapter??"WebGPU adapter",platform:`${Ae.platform()}/${Ae.arch()}`},M=p.values().next().value??e.driver;await i$2(r,S,await(M?.timingEnvironment?.()??g));}else await f$2(r,S);let k=await readFile(L.join(K.directory,"meta.json")),y=await e$2(K.directory,k);return {schemaVersion:1,root:r,skipped:!1,reason:`Wrote ${h.length} shader scene${h.length===1?"":"s"}.`,durationMs:performance.now()-w,scenes:h,measurement:{beforeBuilds:h.reduce((g,M)=>g+M.startupBuilds,0),afterBuilds:0,firstFrameDeltaMs:-h.reduce((g,M)=>g+M.startupBuildMs,0),source:"capture-build-phase"},...n===void 0?{}:{configuration:{created:n.created,file:n.file}},written:K,...y===void 0?{}:{timing:y}}}finally{D&&await Promise.all([...p.values()].map(S=>S.close()));}}a(Vt,"captureShaders");function at(e){return ["workerReady","assetsReady",...e.requiresText?["textReady"]:[],"compileEnd","firstFrame"]}a(at,"requiredReadiness");function Rr(e){if(e.length===0)throw new Error("Cannot take the median of an empty shader timing capture.");let r=[...e].sort((s,c)=>s-c),n=Math.floor(r.length/2),t=r[n];if(t===void 0)throw new Error("Shader timing median is unavailable.");if(r.length%2===1)return t;let i=r[n-1];if(i===void 0)throw new Error("Shader timing median pair is unavailable.");return (i+t)/2}a(Rr,"median");function er(e,r,n,t){if(e.scene!==r.key||e.mode!==n)throw new Error(`Browser observation identity differs for scene "${r.key}".`);if(e.compatibility!==t||e.transform!==b)throw new Error(`Browser observation compatibility differs for scene "${r.key}".`);let i=at(r).filter(s=>e.readiness[s]!==true);if(i.length>0)throw new Error(`Scene "${r.key}" ${n} observation is missing readiness bits: ${i.join(", ")}.`);if(e.errors.length>0)throw new Error(`Scene "${r.key}" ${n} browser errors:
  - ${e.errors.join(`
  - `)}
 ${n} demands: ${rr(e.demands)}`)}a(er,"assertObservation");async function ot(e,r,n){if(n===void 0)return new Set;try{let t=JSON.parse(await readFile(L.join(e,r.publicDir??"public",n),"utf8"));return new Set(Object.keys(t.fallbacks??{}))}catch{return new Set}}a(ot,"manifestFallbackKeys");function dt(e,r,n,t,i,s){if(r.render>0&&n.stats.registeredRenderBuilds===0)throw new Error(`Scene "${e.key}" live baseline exercised no registered render pipeline.`);if(r.compute>0&&n.stats.registeredComputeBuilds===0)throw new Error(`Scene "${e.key}" live baseline exercised no registered compute kernel.`);Tr(e,r,t,i,s,n.demands);}a(dt,"assertZeroBuild");function rr(e){return !e||e.length===0?"none recorded":e.map(r=>`${String(r.key??"unregistered")}[${String(r.event)}${r.hit===false?":miss":""}|${String(r.target)}${r.object===void 0?"":`@${String(r.object)}`}]`).join(" ").slice(0,4e3)}a(rr,"describeDemands");function Tr(e,r,n,t,i,s){let c=a(()=>`
 Precompiled demands: ${rr(n.demands)}`+(s===void 0?"":`
-Live demands: ${rr(s)}`),"demandEvidence");if(n.stats.registeredRenderBuilds+n.stats.registeredComputeBuilds>t){let o=n.stats.missedKeys??[];throw new Error(`Scene "${e.key}" injected path performed ${n.stats.registeredRenderBuilds} render and ${n.stats.registeredComputeBuilds} compute registered live builds; capture permits ${t}.`+(o.length>0?` Missed keys: ${o.join(", ")}.`:"")+c())}if(n.stats.buildCalls>t)throw new Error(`Scene "${e.key}" injected path performed ${n.stats.buildCalls} total live NodeBuilder build${n.stats.buildCalls===1?"":"s"}; capture permits ${t} skipped live build${t===1?"":"s"}.`);if(r.render>0&&n.stats.injectedRender===0)throw new Error(`Scene "${e.key}" injected no render entries.`);if(r.compute>0&&n.stats.injectedCompute===0)throw new Error(`Scene "${e.key}" injected no compute entries.`);if(n.stats.missed!==0||n.stats.missedRender!==0||n.stats.missedCompute!==0){let o=n.stats.missedKeys??[],m=o.filter(f=>!i.has(f)),l=o.length>0&&n.stats.missed<=i.size;if(m.length>0||!l)throw new Error(`Scene "${e.key}" injected path reported shader manifest misses.`+(o.length>0?` Missed keys: ${o.join(", ")}.`:"")+(m.length>0&&m.length!==o.length?` Unexpected: ${m.join(", ")}.`:"")+c())}}a(Tr,"assertPrecompiledZeroBuild");async function ct(e,r,n,t,i){let s=L.join(e,c$3);if(await d(s)){let o=await lstat(s);if(o.isSymbolicLink()||!o.isDirectory())throw new Error("Shader parity artifact directory is not a real directory.")}else await mkdir(s,{recursive:true});let c=[`${r}.live.png`,`${r}.precompiled.png`,`${r}.diff.png`];return await Promise.all([n,t,i].map(async(o,m)=>{let l=c[m];if(l===void 0)throw new Error("Parity artifact mapping failed.");let f=L.join(s,l);if(await d(f)){let a=await lstat(f);if(a.isSymbolicLink()||!a.isFile())throw new Error(`Shader parity target is not a regular file: ${l}.`)}await writeFile(f,o,{mode:384});})),c.map(o=>`${c$3}/${o}`)}a(ct,"writeParityFailure");async function Ht(e={}){let r=e.root?await realpath(e.root):await i(e.start),n=e.runtime??await we(r),t=e.config??await j$1(r),i$1=d$1(e.backend??t.backend),s=f$1(t.scenes,[...i$1].reverse()),c=await De(r,n,e.backend??t.backend);if(c.state!=="fresh")throw new Error(`Shader no-GPU validation is ${c.state}: ${c.reason}`);if(e.skipBrowser)return {schemaVersion:1,root:r,noGpu:c,browser:"skipped",scenes:[]};if(e.parityOnly===true&&e.commitTiming===true)throw new Error("Parity-only shader verification cannot commit timing.");let o=e.runs??5;if(!Number.isSafeInteger(o)||o<1||o>100)throw new Error("Shader timing runs must be an integer in 1...100.");let m=await readFile(L.join(r,b$1,"meta.json")),l=c$1(JSON.parse(m.toString("utf8")));if(c.receipt===void 0||d$2(l)!==d$2(c.receipt))throw new Error("Shader receipt changed after no-GPU validation; restart browser parity verification.");let f=e.driver===void 0,a$1=e.driver===void 0&&e.driverKind===void 0&&e.serve===void 0&&e.url===void 0?await k$1(r):void 0,u=e.serve??a$1?.serve,w=e.driverKind??a$1?.driverKind??(u===void 0?"vite":"static");if(e.url!==void 0&&(e.serve!==void 0||e.driverKind!==void 0))throw new Error("--url cannot be combined with --driver or --serve.");if(w==="vite"&&u!==void 0)throw new Error("--serve requires the static shader driver.");if(w==="static"&&u===void 0&&e.driver===void 0)throw new Error("The static shader driver requires --serve <built-directory>.");let O=e.driver===void 0?await import('./shader-browser-YPBP3WQY.js'):void 0,{compareShaderScreenshots:V}=await import('./shader-parity-XPKQQK26.js'),v=a(()=>e.url!==void 0?O.createAttachedPlaywrightShaderDriver({root:r,runtime:n,url:e.url,...e.headed!==void 0?{headed:e.headed}:{}}):w==="static"?O.createStaticPlaywrightShaderDriver({root:r,runtime:n,serve:u,...e.headed!==void 0?{headed:e.headed}:{}}):O.createPlaywrightShaderDriver({root:r,runtime:n,...e.headed!==void 0?{headed:e.headed}:{}}),"createDriver"),$=new Map,D=new Map,T=a((p,b)=>{if(e.driver!==void 0)return e.driver;let x=p.get(b);return x===void 0&&(x=v(),p.set(b,x)),x},"driverFor");await h$1(r,s.map(p=>p.key),m);let A=[],C={},H=[],q=new Set;try{for(let[b,x]of s.entries()){let{scene:h,backend:_,key:j}=x;e.onSceneStart?.(j,b,s.length);let K=c.scenes.find(P=>P.scene===h.key&&P.backend===_);if(!K?.coverage)throw new Error(`Fresh receipt has no coverage for "${j}".`);let B=K.coverage;if(B.render+B.compute===0)continue;let S=a$4(n.three,_),k=c.receipt?.scenes[j]?.skipped,y=(k?.render??0)+(k?.compute??0),g=await ot(r,t,c.receipt?.scenes[j]?.asset),M=a(async P=>{let oe=T($,_),Re=T(D,_),ee=P?"live":"precompiled",$e=P?"precompiled":"live",xe=P?oe:Re,Te=P?Re:oe,ne=await xe.observe(h,ee,t,void 0,_),I=await Te.observe(h,$e,t,ne.frame,_),de=ne.mode==="live"?ne:I,ce=ne.mode==="precompiled"?ne:I;er(de,h,"live",S),er(ce,h,"precompiled",S),dt(h,B,de,ce,y,g);let tr=a(async(Mr,nr,ir)=>{let Y=V(nr,ir,t.parity.channelTolerance,h.maxDiffRatio??t.parity.maxDiffRatio);if(Y.matches)return Y;let Pr=await ct(r,j,nr,ir,Y.diff),Ir=Y.nonBlack?`${Y.differentPixels}/${Y.totalPixels} pixels differ (${(Y.diffRatio*100).toFixed(3)}%).`:`rendered output is black (live=${Y.baselineLuminance.toFixed(4)}, precompiled=${Y.precompiledLuminance.toFixed(4)}).`;throw new Error(`Shader ${Mr} parity failed for scene "${h.key}" at completed frames live=${de.frame}, precompiled=${ce.frame}: ${Ir} Artifacts: ${Pr.join(", ")}`)},"compare");await tr("first frame",de.firstFrameScreenshot,ce.firstFrameScreenshot);let Br=await tr("settled",de.screenshot,ce.screenshot);return {live:de,precompiled:ce,parity:Br}},"observePair"),R,F,W;if(e.parityOnly===!0)try{R=await M(!0);}catch(P){nt(P)&&q.add(j),H.push({scene:j,error:P}),e.onSceneError?.(j,P);continue}else {await M(!0);let P=[];for(let I=0;I<o;I++)P.push(await M(I%2===0));let oe=P[P.length-1];if(oe===void 0)throw new Error(`Shader timing produced no runs for scene "${h.key}".`);if(R=oe,F=await T(D,_).observePublished(h,t,_),er(F,h,"precompiled",S),Tr(h,B,F,y,g),W=h.runtimeMotion?V(F.beforeScreenshot,F.screenshot,t.parity.channelTolerance,1):void 0,W&&W.diffRatio<1e-4)throw new Error(`Published scene "${h.key}" stopped animating during its normal 120-frame soak (changed ${W.differentPixels}/${W.totalPixels} canvas pixels).`);let ee=a(I=>I.stats.buildMs+(I.stats.precompiledSetupMs??0)+(I.stats.hydrationMs??0),"observedNodeBuilderMs"),$e=Rr(P.map(I=>ee(I.live))),xe=Rr(P.map(I=>ee(I.precompiled))),Te=Math.max(0,$e-xe),ne=P.map(I=>Math.max(0,ee(I.live)-ee(I.precompiled)));C[j]={builds:B.render+B.compute,setupMeasured:!0,liveBuildMs:$e,precompiledBuildMs:xe,avoidedBuildMs:Te,runs:o,spreadMs:Math.max(...ne.map(I=>Math.abs(I-Te)))};}let{diff:Ee,...N}=R.parity,{firstFrameScreenshot:Se,screenshot:se,...Q}=R.live,{firstFrameScreenshot:G,screenshot:Fe,...ae}=R.precompiled,J;if(F!==void 0){let{beforeScreenshot:P,firstFrameScreenshot:oe,screenshot:Re,...ee}=F;J=ee;}A.push({scene:h.key,backend:_,coverage:B,live:Q,precompiled:ae,...J===void 0?{}:{published:J},parity:N,...W===void 0?{}:{runtimeMotion:{differentPixels:W.differentPixels,totalPixels:W.totalPixels,diffRatio:W.diffRatio}}}),await g$1(r,[j],m);}if(e.parityOnly===!0){if(await it(r,[...q],m),H.length>0)throw new Error(`Shader parity failed for ${H.length}/${s.length} scene/backend pair(s):
+Live demands: ${rr(s)}`),"demandEvidence");if(n.stats.registeredRenderBuilds+n.stats.registeredComputeBuilds>t){let o=n.stats.missedKeys??[];throw new Error(`Scene "${e.key}" injected path performed ${n.stats.registeredRenderBuilds} render and ${n.stats.registeredComputeBuilds} compute registered live builds; capture permits ${t}.`+(o.length>0?` Missed keys: ${o.join(", ")}.`:"")+c())}if(n.stats.buildCalls>t)throw new Error(`Scene "${e.key}" injected path performed ${n.stats.buildCalls} total live NodeBuilder build${n.stats.buildCalls===1?"":"s"}; capture permits ${t} skipped live build${t===1?"":"s"}.`);if(r.render>0&&n.stats.injectedRender===0)throw new Error(`Scene "${e.key}" injected no render entries.`);if(r.compute>0&&n.stats.injectedCompute===0)throw new Error(`Scene "${e.key}" injected no compute entries.`);if(n.stats.missed!==0||n.stats.missedRender!==0||n.stats.missedCompute!==0){let o=n.stats.missedKeys??[],m=o.filter(f=>!i.has(f)),l=o.length>0&&n.stats.missed<=i.size;if(m.length>0||!l)throw new Error(`Scene "${e.key}" injected path reported shader manifest misses.`+(o.length>0?` Missed keys: ${o.join(", ")}.`:"")+(m.length>0&&m.length!==o.length?` Unexpected: ${m.join(", ")}.`:"")+c())}}a(Tr,"assertPrecompiledZeroBuild");async function ct(e,r,n,t,i){let s=L.join(e,c$3);if(await d(s)){let o=await lstat(s);if(o.isSymbolicLink()||!o.isDirectory())throw new Error("Shader parity artifact directory is not a real directory.")}else await mkdir(s,{recursive:true});let c=[`${r}.live.png`,`${r}.precompiled.png`,`${r}.diff.png`];return await Promise.all([n,t,i].map(async(o,m)=>{let l=c[m];if(l===void 0)throw new Error("Parity artifact mapping failed.");let f=L.join(s,l);if(await d(f)){let a=await lstat(f);if(a.isSymbolicLink()||!a.isFile())throw new Error(`Shader parity target is not a regular file: ${l}.`)}await writeFile(f,o,{mode:384});})),c.map(o=>`${c$3}/${o}`)}a(ct,"writeParityFailure");async function Ht(e={}){let r=e.root?await realpath(e.root):await i(e.start),n=e.runtime??await we(r),t=e.config??await j$1(r),i$1=d$1(e.backend??t.backend),s=f$1(t.scenes,[...i$1].reverse()),c=await De(r,n,e.backend??t.backend);if(c.state!=="fresh")throw new Error(`Shader no-GPU validation is ${c.state}: ${c.reason}`);if(e.skipBrowser)return {schemaVersion:1,root:r,noGpu:c,browser:"skipped",scenes:[]};if(e.parityOnly===true&&e.commitTiming===true)throw new Error("Parity-only shader verification cannot commit timing.");let o=e.runs??5;if(!Number.isSafeInteger(o)||o<1||o>100)throw new Error("Shader timing runs must be an integer in 1...100.");let m=await readFile(L.join(r,b$1,"meta.json")),l=c$1(JSON.parse(m.toString("utf8")));if(c.receipt===void 0||d$2(l)!==d$2(c.receipt))throw new Error("Shader receipt changed after no-GPU validation; restart browser parity verification.");let f=e.driver===void 0,a$1=e.driver===void 0&&e.driverKind===void 0&&e.serve===void 0&&e.url===void 0?await k$1(r):void 0,u=e.serve??a$1?.serve,w=e.driverKind??a$1?.driverKind??(u===void 0?"vite":"static");if(e.url!==void 0&&(e.serve!==void 0||e.driverKind!==void 0))throw new Error("--url cannot be combined with --driver or --serve.");if(w==="vite"&&u!==void 0)throw new Error("--serve requires the static shader driver.");if(w==="static"&&u===void 0&&e.driver===void 0)throw new Error("The static shader driver requires --serve <built-directory>.");let O=e.driver===void 0?await import('./shader-browser-K7H5MZSG.js'):void 0,{compareShaderScreenshots:V}=await import('./shader-parity-XPKQQK26.js'),v=a(()=>e.url!==void 0?O.createAttachedPlaywrightShaderDriver({root:r,runtime:n,url:e.url,...e.headed!==void 0?{headed:e.headed}:{}}):w==="static"?O.createStaticPlaywrightShaderDriver({root:r,runtime:n,serve:u,...e.headed!==void 0?{headed:e.headed}:{}}):O.createPlaywrightShaderDriver({root:r,runtime:n,...e.headed!==void 0?{headed:e.headed}:{}}),"createDriver"),$=new Map,D=new Map,T=a((p,b)=>{if(e.driver!==void 0)return e.driver;let x=p.get(b);return x===void 0&&(x=v(),p.set(b,x)),x},"driverFor");await h$1(r,s.map(p=>p.key),m);let A=[],C={},H=[],q=new Set;try{for(let[b,x]of s.entries()){let{scene:h,backend:_,key:j}=x;e.onSceneStart?.(j,b,s.length);let K=c.scenes.find(P=>P.scene===h.key&&P.backend===_);if(!K?.coverage)throw new Error(`Fresh receipt has no coverage for "${j}".`);let B=K.coverage;if(B.render+B.compute===0)continue;let S=a$4(n.three,_),k=c.receipt?.scenes[j]?.skipped,y=(k?.render??0)+(k?.compute??0),g=await ot(r,t,c.receipt?.scenes[j]?.asset),M=a(async P=>{let oe=T($,_),Re=T(D,_),ee=P?"live":"precompiled",$e=P?"precompiled":"live",xe=P?oe:Re,Te=P?Re:oe,ne=await xe.observe(h,ee,t,void 0,_),I=await Te.observe(h,$e,t,ne.frame,_),de=ne.mode==="live"?ne:I,ce=ne.mode==="precompiled"?ne:I;er(de,h,"live",S),er(ce,h,"precompiled",S),dt(h,B,de,ce,y,g);let tr=a(async(Mr,nr,ir)=>{let Y=V(nr,ir,t.parity.channelTolerance,h.maxDiffRatio??t.parity.maxDiffRatio);if(Y.matches)return Y;let Pr=await ct(r,j,nr,ir,Y.diff),Ir=Y.nonBlack?`${Y.differentPixels}/${Y.totalPixels} pixels differ (${(Y.diffRatio*100).toFixed(3)}%).`:`rendered output is black (live=${Y.baselineLuminance.toFixed(4)}, precompiled=${Y.precompiledLuminance.toFixed(4)}).`;throw new Error(`Shader ${Mr} parity failed for scene "${h.key}" at completed frames live=${de.frame}, precompiled=${ce.frame}: ${Ir} Artifacts: ${Pr.join(", ")}`)},"compare");await tr("first frame",de.firstFrameScreenshot,ce.firstFrameScreenshot);let Br=await tr("settled",de.screenshot,ce.screenshot);return {live:de,precompiled:ce,parity:Br}},"observePair"),R,F,W;if(e.parityOnly===!0)try{R=await M(!0);}catch(P){nt(P)&&q.add(j),H.push({scene:j,error:P}),e.onSceneError?.(j,P);continue}else {await M(!0);let P=[];for(let I=0;I<o;I++)P.push(await M(I%2===0));let oe=P[P.length-1];if(oe===void 0)throw new Error(`Shader timing produced no runs for scene "${h.key}".`);if(R=oe,F=await T(D,_).observePublished(h,t,_),er(F,h,"precompiled",S),Tr(h,B,F,y,g),W=h.runtimeMotion?V(F.beforeScreenshot,F.screenshot,t.parity.channelTolerance,1):void 0,W&&W.diffRatio<1e-4)throw new Error(`Published scene "${h.key}" stopped animating during its normal 120-frame soak (changed ${W.differentPixels}/${W.totalPixels} canvas pixels).`);let ee=a(I=>I.stats.buildMs+(I.stats.precompiledSetupMs??0)+(I.stats.hydrationMs??0),"observedNodeBuilderMs"),$e=Rr(P.map(I=>ee(I.live))),xe=Rr(P.map(I=>ee(I.precompiled))),Te=Math.max(0,$e-xe),ne=P.map(I=>Math.max(0,ee(I.live)-ee(I.precompiled)));C[j]={builds:B.render+B.compute,setupMeasured:!0,liveBuildMs:$e,precompiledBuildMs:xe,avoidedBuildMs:Te,runs:o,spreadMs:Math.max(...ne.map(I=>Math.abs(I-Te)))};}let{diff:Ee,...N}=R.parity,{firstFrameScreenshot:Se,screenshot:se,...Q}=R.live,{firstFrameScreenshot:G,screenshot:Fe,...ae}=R.precompiled,J;if(F!==void 0){let{beforeScreenshot:P,firstFrameScreenshot:oe,screenshot:Re,...ee}=F;J=ee;}A.push({scene:h.key,backend:_,coverage:B,live:Q,precompiled:ae,...J===void 0?{}:{published:J},parity:N,...W===void 0?{}:{runtimeMotion:{differentPixels:W.differentPixels,totalPixels:W.totalPixels,diffRatio:W.diffRatio}}}),await g$1(r,[j],m);}if(e.parityOnly===!0){if(await it(r,[...q],m),H.length>0)throw new Error(`Shader parity failed for ${H.length}/${s.length} scene/backend pair(s):
 `+H.map(b=>{let x=b.error instanceof Error?b.error.message:String(b.error);return ` - ${b.scene}: ${x}`}).join(`
 `));return {schemaVersion:1,root:r,noGpu:c,browser:"passed",scenes:A}}if(Object.keys(C).length===0)return {schemaVersion:1,root:r,noGpu:c,browser:"passed",scenes:A};if(e.commitTiming===!0){let b={adapter:i$1.length===1&&i$1[0]==="webgl"?"WebGL adapter":"WebGPU adapter",platform:`${Ae.platform()}/${Ae.arch()}`},h=await(($.values().next().value??e.driver)?.timingEnvironment?.()??b),_=await i$2(r,C,h);return {schemaVersion:1,root:r,noGpu:c,browser:"passed",scenes:A,timing:_.local,committedTiming:_.committed}}let p=await f$2(r,C);return {schemaVersion:1,root:r,noGpu:c,browser:"passed",scenes:A,timing:p}}finally{f&&await Promise.all([...$.values(),...D.values()].map(p=>p.close()));}}a(Ht,"testShaders");export{wr as a,Ce as b,we as c,De as d,Vt as e,Ht as f};

package/dist/{chunk-L2CZ7RSV.js → chunk-6RGA2IVT.js}

@@ -1,5 +1,5 @@
 #!/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-JHBQB7WC.js';import {a as a$3,c as c$2,b,d as d$1}from'./chunk-NQIAU3XU.js';import {a as a$1,c,b as b$1}from'./chunk-65VEJRRT.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 S={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&&!S.scene)throw new Error("Runtime status receipt cannot attempt HMR without the scene capability.");if(y&&!S.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"]),k={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(k);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(k.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:S,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:k,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:S,threeBlocksShaderClosure:x}=await c$2(e);if(a.runtime.three!==y||t.runtime.three!==y||t.runtime.threeBlocks!==S)return {state:"stale",scene:r,reason:`Installed runtime versions (${y}, ${S}) 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),k=Object.keys(R),V=Object.keys(d.inputs),P=k.filter(b=>!Object.hasOwn(d.inputs,b)),T=V.filter(b=>!Object.hasOwn(R,b)),f=k.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},S=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},k=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:S,optimization:R,stats:x,...k===void 0?{}:{text:k}},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.backend}`,`${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(`
+import {d as d$2,b as b$2,c as c$3,g as g$2}from'./chunk-IILE5RBI.js';import {g as g$1}from'./chunk-JHBQB7WC.js';import {a as a$3,c as c$2,b,d as d$1}from'./chunk-2TSMAC6E.js';import {a as a$1,c,b as b$1}from'./chunk-65VEJRRT.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 S={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&&!S.scene)throw new Error("Runtime status receipt cannot attempt HMR without the scene capability.");if(y&&!S.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"]),k={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(k);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(k.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:S,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:k,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:S,threeBlocksShaderClosure:x}=await c$2(e);if(a.runtime.three!==y||t.runtime.three!==y||t.runtime.threeBlocks!==S)return {state:"stale",scene:r,reason:`Installed runtime versions (${y}, ${S}) 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),k=Object.keys(R),V=Object.keys(d.inputs),P=k.filter(b=>!Object.hasOwn(d.inputs,b)),T=V.filter(b=>!Object.hasOwn(R,b)),f=k.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},S=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},k=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:S,optimization:R,stats:x,...k===void 0?{}:{text:k}},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.backend}`,`${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(`

package/dist/chunk-EE64MV27.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import {a as a$2}from'./chunk-ZT6T2W4B.js';import {e as e$1,g}from'./chunk-NPLE7PPF.js';import {a as a$1,c as c$1}from'./chunk-65VEJRRT.js';import {c,d as d$1,f,e,i}from'./chunk-5L2VS3BN.js';import {a}from'./chunk-HOZDD6PW.js';import {THREE_WEBGL_R185_COMPATIBILITY,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 {lstat,readFile,unlink,mkdir,readdir}from'fs/promises';import d from'path';function v(e,r="webgpu"){if(/^0\.185\./u.test(e))return r==="webgl"?THREE_WEBGL_R185_COMPATIBILITY:THREE_WEBGPU_R185_COMPATIBILITY;if(e===THREE_R186DEV_VERSION&&r==="webgpu")return THREE_WEBGPU_R186DEV_COMPATIBILITY;throw new Error(`Three.js ${e} is outside the supported shader compatibility contracts.`)}a(v,"shaderCompatibilityForThree");var be=62,de="timing.local.json",ce="timing.json",q="parity.json",O=4096,Ee=4096;function W(e,r,n=8192){if(typeof e!="string"||e.length===0||e.length>n||/[\u0000\u007f]/u.test(e))throw new Error(`${r} must be a bounded non-empty string.`);return e}a(W,"boundedString");function p(e,r,n=true){if(typeof e!="number"||!Number.isFinite(e)||e<0||n&&!Number.isSafeInteger(e))throw new Error(`${r} must be a non-negative ${n?"integer":"finite number"}.`);return e}a(p,"nonNegativeNumber");function Re(e){if(!a$1(e))throw new Error("Shader capture stats are missing.");let r={buildCalls:p(e.buildCalls,"capture stats.buildCalls"),renderBuilds:p(e.renderBuilds,"capture stats.renderBuilds"),computeBuilds:p(e.computeBuilds,"capture stats.computeBuilds"),registeredBuilds:p(e.registeredBuilds,"capture stats.registeredBuilds"),registeredRenderBuilds:p(e.registeredRenderBuilds,"capture stats.registeredRenderBuilds"),registeredComputeBuilds:p(e.registeredComputeBuilds,"capture stats.registeredComputeBuilds"),buildMs:p(e.buildMs,"capture stats.buildMs",false),syncBuildMs:p(e.syncBuildMs,"capture stats.syncBuildMs",false),asyncBuildElapsedMs:p(e.asyncBuildElapsedMs,"capture stats.asyncBuildElapsedMs",false),precompiledSetupMs:p(e.precompiledSetupMs,"capture stats.precompiledSetupMs",false),maxSyncBuildMs:p(e.maxSyncBuildMs??e.syncBuildMs,"capture stats.maxSyncBuildMs",false),maxPrecompiledSetupMs:p(e.maxPrecompiledSetupMs??e.precompiledSetupMs,"capture stats.maxPrecompiledSetupMs",false),hydrationMs:p(e.hydrationMs??0,"capture stats.hydrationMs",false),maxHydrationMs:p(e.maxHydrationMs??e.hydrationMs??0,"capture stats.maxHydrationMs",false),injected:p(e.injected,"capture stats.injected"),injectedRender:p(e.injectedRender,"capture stats.injectedRender"),injectedCompute:p(e.injectedCompute,"capture stats.injectedCompute"),missed:p(e.missed,"capture stats.missed"),missedRender:p(e.missedRender,"capture stats.missedRender"),missedCompute:p(e.missedCompute,"capture stats.missedCompute"),...Array.isArray(e.missedKeys)&&e.missedKeys.every(n=>typeof n=="string")?{missedKeys:e.missedKeys.slice(0,O)}:{}};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||Math.abs(r.syncBuildMs+r.asyncBuildElapsedMs-r.buildMs)>.001||r.maxSyncBuildMs>r.syncBuildMs+.001||r.maxPrecompiledSetupMs>r.precompiledSetupMs+.001||r.maxHydrationMs>r.hydrationMs+.001)throw new Error("Shader capture stats totals are inconsistent.");return r}a(Re,"captureStats");function Me(e){if(!Array.isArray(e)||e.length>O)throw new Error("Shader capture skipped builds are invalid.");return e.map((r,n)=>{if(!a$1(r)||r.kind!=="render"&&r.kind!=="compute")throw new Error(`Shader capture skipped build ${n} is invalid.`);return {kind:r.kind,name:W(r.name,`skipped build ${n} name`,512),reason:W(r.reason,`skipped build ${n} reason`)}})}a(Me,"skippedBuilds");function ke(e){let r=0,n=0,t=0,i=0;for(let s of Object.values(e.entries)){let o=e.states[s];o!==void 0&&((o.vertex!==null||o.fragment!==null)&&r++,o.vertex!==null&&n++,o.fragment!==null&&t++,o.compute!==null&&i++);}return {render:r,vertex:n,fragment:t,compute:i}}a(ke,"shaderCoverage");function Le(e,r){if(!a$1(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 n=r.backend??"webgpu",t=v(r.runtime.three,n);if(e.compatibility!==t)throw new Error(`Shader capture compatibility must be "${t}".`);if(!a$1(e.entries))throw new Error("Shader capture entries must be an object.");if(typeof e.requiresSetup!="boolean")throw new Error("Shader capture requiresSetup must be boolean.");let i=Object.keys(e.entries).length;if(i>O)throw new Error(`Shader capture must contain at most ${O} entries.`);if(!Array.isArray(e.errors)||e.errors.length>Ee)throw new Error("Shader capture errors are invalid.");let s=e.errors.map((w,a)=>W(w,`capture error ${a}`,64*1024));if(s.length>0)throw new Error(`Shader capture failed:
+ - ${s.join(`
+ - `)}`);let o=Me(e.skipped);if(i===0&&(n!=="webgl"||o.length===0))throw new Error("Shader capture must contain an entry unless WebGL explicitly skipped every live build.");let u=Re(e.stats),l=a$1(e.timing)?e.timing:void 0,g=l===void 0?void 0:Object.fromEntries(["launch","firstRequest","readiness","lastBuild","settled","posted"].flatMap(w=>{let a=l[w];if(a===void 0)return [];if(typeof a!="number"||!Number.isFinite(a)||a<0)throw new Error(`Shader capture timing.${w} is invalid.`);return [[w,a]]})),m;if(e.provenance!==void 0){if(!a$1(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(w=>typeof w=="string"&&w.length<=128))throw new Error("Shader capture provenance is invalid.");m={userAgent:e.provenance.userAgent,adapter:e.provenance.adapter,features:[...new Set(e.provenance.features)].sort()};}let R=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},requiresSetup:e.requiresSetup,modules:e.modules,nodes:e.nodes,layouts:e.layouts,attributePlans:e.attributePlans,updatePlans:e.updatePlans,requirementPlans:e.requirementPlans,states:e.states,entries:e.entries,...e.fallbacks===void 0?{}:{fallbacks:e.fallbacks}}),S=ke(R);if(u.registeredRenderBuilds<S.render||u.registeredComputeBuilds<S.compute)throw new Error("Shader capture did not live-build every distinct registered render/compute entry.");return {scene:r.scene,backend:n,manifest:R,skipped:o,stats:u,coverage:S,...g===void 0?{}:{timing:g},...m===void 0?{}:{provenance:m}}}a(Le,"validateShaderCapture");function E(e,r=0){let n="	".repeat(r),t="	".repeat(r+1);if(Array.isArray(e))return e.length===0?"[]":e.every(s=>s===null||["number","string","boolean"].includes(typeof s))?JSON.stringify(e):`[
+${e.map(s=>`${t}${E(s,r+1)}`).join(`,
+`)}
+${n}]`;if(e!==null&&typeof e=="object"){let s=e,o=Object.keys(s).sort();return o.length===0?"{}":`{
+${o.map(u=>{let l=s[u];return `${t}${JSON.stringify(u)}: ${E(l,r+1)}`}).join(`,
+`)}
+${n}}`}let i=JSON.stringify(e);if(i===void 0)throw new Error("Shader artifact contains a non-serializable value.");return i}a(E,"stableStringify");function Be(e){return ["// GENERATED FILE \u2014 do not edit by hand.","// Produced by @three-blocks/devtools.","import type { PrecompiledManifest } from 'three-blocks/shaders';","",`export default ${E(e)} satisfies PrecompiledManifest;`,""].join(`
+`)}a(Be,"serializeShaderManifest");function ee(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(ee,"timingLabel");function U(e){if(!a$1(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))||!a$1(e.scenes))throw new Error("Shader timing is invalid.");let r={};for(let[t,i]of Object.entries(e.scenes)){if(t.length===0||t.length>128||!a$1(i))throw new Error("Shader timing scene is invalid.");let s={builds:p(i.builds,`timing ${t}.builds`),setupMeasured:i.setupMeasured===true,liveBuildMs:p(i.liveBuildMs,`timing ${t}.liveBuildMs`,false),precompiledBuildMs:p(i.precompiledBuildMs,`timing ${t}.precompiledBuildMs`,false),avoidedBuildMs:p(i.avoidedBuildMs,`timing ${t}.avoidedBuildMs`,false),runs:p(i.runs,`timing ${t}.runs`),spreadMs:p(i.spreadMs,`timing ${t}.spreadMs`,false)};if(s.runs<1)throw new Error(`Shader timing runs are invalid for scene "${t}".`);if(Math.abs(s.avoidedBuildMs-Math.max(0,s.liveBuildMs-s.precompiledBuildMs))>.001)throw new Error(`Shader timing delta is inconsistent for scene "${t}".`);r[t]=s;}if(Object.keys(r).length===0)throw new Error("Shader timing contains no scenes.");let n={schemaVersion:3,receiptHash:e.receiptHash,measuredAt:e.measuredAt,scenes:r};return e.source==="latest-local-capture"?{...n,source:"latest-local-capture"}:{...n,source:"committed-capture",adapter:ee(e.adapter,"Shader timing adapter"),platform:ee(e.platform,"Shader timing platform")}}a(U,"parseShaderTiming");function _(e){return /^[a-z0-9][a-z0-9_-]{0,63}(?:\.webgl)?$/u.test(e)}a(_,"validParityScene");function re(e){return typeof e=="string"&&Number.isFinite(Date.parse(e))}a(re,"validParityTimestamp");function Y(e){if(!a$1(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)||!re(e.verifiedAt)||!Array.isArray(e.scenes)||e.scenes.length===0||e.scenes.length>64||!e.scenes.every(t=>typeof t=="string"&&_(t)))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||!a$1(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 n={};for(let[t,i]of r.sort(([s],[o])=>s.localeCompare(o))){if(!_(t)||!a$1(i)||typeof i.fingerprint!="string"||!/^[a-f0-9]{64}$/u.test(i.fingerprint)||!re(i.verifiedAt))throw new Error("Shader parity evidence is invalid.");n[t]={fingerprint:i.fingerprint,verifiedAt:i.verifiedAt};}return {schemaVersion:2,scenes:n}}a(Y,"parseShaderParityEvidence");function G(e,r){let n=e.scenes[r];if(n===void 0)throw new Error(`Shader receipt has no scene "${r}" for parity evidence.`);return c(E({runtime:{three:e.runtime.three,threeBlocks:e.runtime.threeBlocks,threeBlocksShaderClosure:e.runtime.threeBlocksShaderClosure},...e.tool===void 0?{}:{tool:e.tool},scene:n}))}a(G,"shaderSceneParityFingerprint");async function te(e,r,n,t){let i=d.join(e,n);try{if(!await d$1(i))return;let s=await lstat(i);if(s.isSymbolicLink()||!s.isFile()||s.size>1024*1024)return;let o=U(JSON.parse(await readFile(i,"utf8")));return o.source===t&&o.receiptHash===c(r)?o:void 0}catch{return}}a(te,"readShaderTimingFile");async function De(e,r){return await te(e,r,de,"latest-local-capture")??await te(e,r,ce,"committed-capture")}a(De,"readShaderTiming");async function ue(e,r){let n=d.join(e,q);try{if(!await d$1(n))return;let t=await lstat(n);if(t.isSymbolicLink()||!t.isFile()||t.size>1024*1024)return;let i=Y(JSON.parse(await readFile(n,"utf8"))),s=c$1(JSON.parse(Buffer.from(r).toString("utf8"))),o={};if(i.schemaVersion===1){if(i.receiptHash!==c(r))return;for(let u of i.scenes)s.scenes[u]!==void 0&&(o[u]={fingerprint:G(s,u),verifiedAt:i.verifiedAt});}else for(let[u,l]of Object.entries(i.scenes))s.scenes[u]===void 0||l.fingerprint!==G(s,u)||(o[u]=l);return Object.keys(o).length===0?void 0:{schemaVersion:2,scenes:o}}catch{return}}a(ue,"readShaderParityEvidence");async function pe(e,r,n){let t=await x(e),i=d.join(t,"meta.json"),s=await lstat(i);if(s.isSymbolicLink()||!s.isFile())throw new Error("Shader receipt must be a regular file before timing.");let o=await readFile(i),u=new Date().toISOString(),l=Object.fromEntries(Object.entries(r).sort(([R],[S])=>R.localeCompare(S))),g=U({schemaVersion:3,receiptHash:c(o),measuredAt:u,source:"latest-local-capture",scenes:l});if(await f(d.join(t,de),`${E(g)}
+`),n===void 0)return {local:g};let m=U({schemaVersion:3,receiptHash:c(o),measuredAt:u,source:"committed-capture",adapter:n.adapter,platform:n.platform,scenes:l});return await f(d.join(t,ce),`${E(m)}
+`),{local:g,committed:m}}a(pe,"writeShaderTimings");async function Ne(e,r){return (await pe(e,r)).local}a(Ne,"writeShaderLocalTiming");async function ve(e,r,n){if(r.length===0||r.length>64||r.some(S=>!_(S)))throw new Error("Shader parity evidence must contain 1...64 valid scene keys.");let t=await x(e),i=d.join(t,"meta.json"),s=await lstat(i);if(s.isSymbolicLink()||!s.isFile())throw new Error("Shader receipt must be a regular file before parity evidence.");let o=await readFile(i);if(n!==void 0&&c(o)!==c(n))throw new Error("Shader receipt changed during browser parity verification; completed observations were not attached to the new receipt.");let u=c$1(JSON.parse(o.toString("utf8"))),l=await ue(t,o),g=new Date().toISOString(),m={...l?.scenes};for(let S of [...new Set(r)].sort())m[S]={fingerprint:G(u,S),verifiedAt:g};let R=Y({schemaVersion:2,scenes:m});return await f(d.join(t,q),`${E(R)}
+`),R}a(ve,"writeShaderParityEvidence");async function Fe(e,r,n){if(r.length===0||r.length>64||r.some(m=>!_(m)))throw new Error("Shader parity invalidation must contain 1...64 valid scene keys.");let t=await x(e),i=await readFile(d.join(t,"meta.json"));if(c(i)!==c(n))throw new Error("Shader receipt changed before prior parity evidence could be invalidated.");let s=await ue(t,i);if(s===void 0)return;let o=new Set(r),u=Object.fromEntries(Object.entries(s.scenes).filter(([m])=>!o.has(m))),l=d.join(t,q);if(Object.keys(u).length===0){await unlink(l).catch(m=>{if(!a$1(m)||m.code!=="ENOENT")throw m});return}let g=Y({schemaVersion:2,scenes:u});await f(l,`${E(g)}
+`);}a(Fe,"removeShaderParityEvidence");async function We(e,r,n){let t=await pe(e,r,n);if(t.committed===void 0)throw new Error("Committed shader timing was not written.");return {local:t.local,committed:t.committed}}a(We,"writeShaderTimingTwins");async function ne(e){if(!await d$1(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(ne,"assertDirectory");async function x(e){let r=d.resolve(e),n=d.join(r,".three-blocks");await ne(n);let t=d.join(n,"shaders");return await ne(t),t}a(x,"artifactRoot");async function Ue(e$2){let r=await x(e$2.root),n=e$2.backends??["webgpu"],t=Object.fromEntries(n.map(a=>[a,v(e$2.runtime.three,a)])),i$1=d.resolve(e$2.root),s=d.resolve(i$1,e$2.publicDirectory??"public");if(!e(i$1,s)||s===i$1)throw new Error("Shader public directory must stay inside the project root.");let o=d.join(s,"three-blocks","shaders");await mkdir(o,{recursive:true}),await i(i$1,o,"Shader static-asset directory");let u={},l=[];for(let a of [...e$2.scenes].sort((b,k)=>b.key.localeCompare(k.key))){let b=e$2.inputs.get(a.key);if(b===void 0)throw new Error(`Shader input matrix is missing scene "${a.key}".`);for(let k of e$1(a,n)){let T=g(a.key,k),M=e$2.captures.get(T);if(M===void 0){let f=e$2.previousReceipt?.scenes[T];if(f===void 0)continue;let V=await readFile(d.join(r,f.artifact));if(c(V)!==f.artifactHash)throw new Error(`Preserved shader artifact checksum differs for "${T}".`);if(f.asset!==void 0&&f.assetHash!==void 0){let L=await readFile(d.join(s,f.asset));if(c(L)!==f.assetHash)throw new Error(`Preserved static shader manifest checksum differs for "${T}".`)}u[T]={...f,backend:k,inputs:Object.fromEntries(Object.entries(b).sort(([L],[me])=>L.localeCompare(me)))},l.push(f.artifact),f.asset!==void 0&&l.push(d.relative(i$1,d.join(s,f.asset)).split(d.sep).join("/"));continue}if(M.scene!==a.key||M.backend!==k||M.manifest.scene!==a.key)throw new Error(`Capture matrix scene/backend "${T}" is inconsistent.`);let I=`${a.key}.${k}.ts`,$=Be(M.manifest);await f(d.join(r,I),$),l.push(I);let H=`three-blocks/shaders/${a.key}.${k}.json`,J=`${E(M.manifest)}
+`;await f(d.join(s,H),J),l.push(d.relative(i$1,d.join(s,H)).split(d.sep).join("/"));let z=M.skipped.filter(f=>f.kind==="render").length,le=M.skipped.length-z;u[T]={backend:k,artifact:I,artifactHash:c($),asset:H,assetHash:c(J),inputs:Object.fromEntries(Object.entries(b).sort(([f],[V])=>f.localeCompare(V))),coverage:M.coverage,bytes:Buffer.byteLength($),skipped:{render:z,compute:le}};}}let g$1=[...e$2.captures.values()].find(a=>a.provenance!==void 0)?.provenance??e$2.previousReceipt?.runtime.capture,m={schemaVersion:2,runtime:{...e$2.runtime,...g$1===void 0?{}:{capture:g$1}},tool:{name:"@three-blocks/devtools",version:a$2,compatibility:t[n[0]??"webgpu"],compatibilities:t,transform:be,address:SHADER_ADDRESS_SCHEMA_VERSION,recipe:SHADER_RECIPE_SCHEMA_VERSION,hydration:SHADER_HYDRATION_SCHEMA_VERSION},scenes:u},R=new Set(l);for(let a of await readdir(r,{withFileTypes:true}))if(!(!/\.(?:webgpu|webgl)\.ts$/u.test(a.name)||R.has(a.name))){if(a.isSymbolicLink()||!a.isFile())throw new Error(`Orphan shader artifact is not a regular file: ${a.name}.`);await unlink(d.join(r,a.name));}let S=new Set(e$2.scenes.flatMap(a=>e$1(a,n).map(b=>`${a.key}.${b}.json`))),w=new Set(Object.values(e$2.previousReceipt?.scenes??{}).map(a=>a.asset===void 0?void 0:d.posix.basename(a.asset)).filter(a=>a!==void 0));try{let a=c$1(JSON.parse(await readFile(d.join(r,"meta.json"),"utf8")));for(let b of Object.values(a.scenes))b.asset!==void 0&&w.add(d.posix.basename(b.asset));}catch{}for(let a of await readdir(o,{withFileTypes:true}))if(!(!a.name.endsWith(".json")||S.has(a.name))&&w.has(a.name)){if(a.isSymbolicLink()||!a.isFile())throw new Error(`Orphan shader static asset is not a regular file: ${a.name}.`);await unlink(d.join(o,a.name));}return await f(d.join(r,"meta.json"),`${E(m)}
+`),l.push("meta.json"),{directory:r,receipt:m,files:l}}a(Ue,"writeShaderArtifacts");export{v as a,be as b,Le as c,E as d,De as e,Ne as f,ve as g,Fe as h,We as i,Ue as j};

package/dist/chunk-IILE5RBI.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import {a}from'./chunk-HOZDD6PW.js';function S(n=process.env,r=process.stdout){if(n.NO_COLOR!==void 0)return 0;if(n.FORCE_COLOR!==void 0){let t=String(n.FORCE_COLOR);return t==="0"||t==="false"?0:t==="3"?24:t==="2"?8:4}return !r||!r.isTTY||n.TERM==="dumb"?0:/^(truecolor|24bit)$/i.test(n.COLORTERM??"")||n.WT_SESSION||n.TERM_PROGRAM==="iTerm.app"||n.TERM_PROGRAM==="vscode"?24:/-256(color)?$/i.test(n.TERM??"")?8:4}a(S,"resolveColorDepth");function R(n=process.env,r=process.platform){return r!=="win32"?true:!!(n.WT_SESSION||n.TERM_PROGRAM||n.ConEmuANSI||/-256(color)?$/i.test(n.TERM??""))}a(R,"resolveUnicode");function k(n=process.stdout){let r=n?.columns;return typeof r=="number"&&Number.isInteger(r)&&r>0?r:80}a(k,"termWidth");var T={depth:S(),unicode:R(),get width(){return k()}},d={logo:{square:[30,84,200]},accent:[86,132,230],gold:[244,174,12],danger:[221,76,51],live:[212,255,71]};function M(n,r,t){if(Math.max(n,r,t)-Math.min(n,r,t)<12){let e=Math.round((n+r+t)/3);return e<8?16:e>238?231:232+Math.round((e-8)/10)}let s=a(e=>e<48?0:e<115?1:Math.min(5,Math.round((e-35)/40)),"level");return 16+36*s(n)+6*s(r)+s(t)}a(M,"ansi256");function g(n,r,t){return t>=24?`38;2;${n[0]};${n[1]};${n[2]}`:t>=8?`38;5;${M(n[0],n[1],n[2])}`:String(r)}a(g,"fgOpen");function E(n=T.depth,r=T.unicode){let t=n>0?(s,e=39)=>o=>`\x1B[${s}m${String(o)}\x1B[${e}m`:()=>s=>String(s);return {depth:n,unicode:r,accent:t(g(d.accent,94,n)),live:t(g(d.live,92,n)),danger:t(g(d.danger,91,n)),gold:t(g(d.gold,33,n)),deep:t(g(d.logo.square,34,n)),warn:t(g(d.gold,33,n)),dim:t(2,22),bold:t(1,22)}}a(E,"createTheme");function v(n){let r=n.unicode;return {tick:n.live(r?"\u2713":"\u221A"),cross:n.danger(r?"\u2717":"x"),warn:n.warn(r?"\u25B2":"!"),info:n.accent(r?"\u203A":">"),pointer:n.accent(r?"\u276F":">"),dot:n.dim(r?"\xB7":"."),ring:n.dim(r?"\u25CB":"o"),bar:r?"\u2502":"|",ellipsis:r?"\u2026":"...",mark:r?`${n.gold("\u25B2")} ${n.danger("\u25CF")} ${n.deep("\u25A0")}`:null}}a(v,"createSymbols");var y=E(),m=v(y),W=/\x1b\[[0-9;]*m/g,A=/(\x1b\[[0-9;]*m)/;function _(n){return String(n).replace(W,"")}a(_,"stripAnsi");function O(n){return n===8203||n===8205||n>=768&&n<=879||n>=65024&&n<=65039?0:n>=4352&&n<=4447||n>=11904&&n<=42191||n>=44032&&n<=55203||n>=63744&&n<=64255||n>=65072&&n<=65103||n>=65280&&n<=65376||n>=65504&&n<=65510||n>=127744&&n<=129791||n>=131072&&n<=262141?2:1}a(O,"charWidth");function x(n){let r=0;for(let t of _(n))r+=O(t.codePointAt(0)??0);return r}a(x,"visibleWidth");function b(n){let r=Number(n.split(";")[0]);return r>=30&&r<=38||r>=90&&r<=97}a(b,"isForeground");function C(n,r){let t=r.slice(2,-1);if(t===""||t==="0")return [];let s=t.split(";")[0];if(s==="22")return n.filter(o=>o!=="1"&&o!=="2");if(s==="39")return n.filter(o=>!b(o));let e=b(t)?n.filter(o=>!b(o)):n.filter(o=>o!==t);return e.push(t),e}a(C,"advanceSgr");var h=a(n=>n.length?"\x1B[0m":"","closeIf");function N(n,r,t="\u2026"){let s=String(n);if(x(s)<=r)return s;let e=Math.max(0,r-x(t)),o="",u=0,p=[];for(let l of s.split(A))if(l){if(l.startsWith("\x1B[")){p=C(p,l),o+=l;continue}for(let a of l){let c=O(a.codePointAt(0)??0);if(u+c>e)return o+h(p)+t;o+=a,u+=c;}}return o+h(p)+t}a(N,"truncateAnsi");function I(n,r){let t=r-x(String(n));return t>0?String(n)+" ".repeat(t):String(n)}a(I,"padEndAnsi");function G(n,r={}){let{gap:t=2,indent:s=0,maxWidth:e}=r;if(!n.length)return [];let o=Math.max(...n.map(a=>a.length)),u=new Array(o).fill(0);for(let a of n)a.forEach((c,f)=>{u[f]=Math.max(u[f]??0,x(c));});if(e){let a$1=a(()=>s+u.reduce((c,f)=>c+f,0)+t*(o-1),"total");for(;a$1()>e;){let c=u.indexOf(Math.max(...u)),f=u[c];if(f===void 0||f<=6)break;u[c]=f-1;}}let p=" ".repeat(s),l=" ".repeat(t);return n.map(a=>(p+a.map((c,f)=>{let $=u[f]??0,w=N(c,$);return f===a.length-1?w:I(w,$)}).join(l)).trimEnd())}a(G,"columns");function L(n="",r=process.stdout){r.write(`${n}
+`);}a(L,"log");function F(n){return ["fresh","ready","precompiled","passed","captured","verified","first frame","compiled","worker ready","assets ready"].includes(n)?m.tick:["stale","live","generating","fallback","updating","skipped"].includes(n)?m.warn:["missing","starting","not-observed","unobserved"].includes(n)?m.ring:m.cross}a(F,"stateMark");function Y(n,r=process.stdout){let t,s=a(e=>{e!==t&&(t=e,r.write(`${m.dot} ${t}
+`));},"update");return s(n),{update:s,stop(e){e&&r.write(`${e}
+`);}}}a(Y,"spinner");export{T as a,y as b,m as c,I as d,G as e,L as f,F as g,Y as h};