@three-blocks/devtools 1.0.1-alpha.229.gb2f4ea7d182c → 2.0.0-alpha.238.g8723f0a28ca3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +30 -2
- package/README.md +27 -4
- package/dist/browser/shader-capture.d.ts +13 -1
- package/dist/browser/shader-capture.js +2 -2
- package/dist/{browser-smoke-X3NBYPHI.js → browser-smoke-EIKJ6OVK.js} +4 -4
- package/dist/chunk-4YRR36JN.js +97 -0
- package/dist/chunk-65VEJRRT.js +2 -0
- package/dist/chunk-GA7PGW2R.js +18 -0
- package/dist/{chunk-JMS5NTP7.js → chunk-JHBQB7WC.js} +1 -1
- package/dist/chunk-LUULHXFK.js +17 -0
- package/dist/chunk-NPLE7PPF.js +3 -0
- package/dist/{chunk-YLN3G2JS.js → chunk-OQLHTDDH.js} +1 -1
- package/dist/chunk-TRHSN2DJ.cjs +1 -0
- package/dist/{chunk-ILOEBEIQ.js → chunk-TUIINI6U.js} +1 -1
- package/dist/chunk-V34C7NIM.js +80 -0
- package/dist/chunk-W6UL2OW7.js +2 -0
- package/dist/cli.js +22 -22
- package/dist/environment-bake-XMRKQJXM.js +4 -0
- package/dist/index.d.ts +38 -8
- package/dist/index.js +24 -21
- package/dist/{shader-autowire-DCODBFMX.js → shader-autowire-SPE5DM2X.js} +1 -1
- package/dist/{shader-browser-ZGPGYM2U.js → shader-browser-EYE3UT2U.js} +1 -1
- package/dist/{shader-browser-FSCRBXJ7.js → shader-browser-WF4HNSAV.js} +1 -1
- package/dist/shader-capture-server.d.ts +22 -2
- package/dist/shader-capture-server.js +14 -14
- package/dist/shader-config-EOFU5D3Y.js +2 -0
- package/dist/{shader-project-runner-FJXPTLUO.js → shader-project-runner-S2AID2RJ.js} +1 -1
- package/dist/{shader-transform-DSFaVrux.d.ts → shader-transform-D160zMyt.d.ts} +3 -0
- package/dist/shader-watch-ISNWIAXN.js +2 -0
- package/dist/shader-workflow-T72N2CLS.js +2 -0
- package/dist/status-D2RF6QTL.js +2 -0
- package/dist/{text-atlas-BHPSDU7C.js → text-atlas-WRYJT3E7.js} +1 -1
- package/dist/transform.cjs +1 -1
- package/dist/transform.d.ts +1 -1
- package/dist/transform.js +1 -1
- package/dist/webpack-loader.cjs +1 -1
- package/dist/webpack-loader.d.ts +1 -1
- package/dist/webpack-loader.js +1 -1
- package/package.json +3 -3
- package/dist/chunk-4M7M55NS.js +0 -93
- package/dist/chunk-5X5NS5EW.js +0 -18
- package/dist/chunk-J6OESAZM.js +0 -76
- package/dist/chunk-NE7SC2BX.js +0 -2
- package/dist/chunk-NEWSG5RX.js +0 -3
- package/dist/chunk-PAH76FDD.js +0 -14
- package/dist/chunk-PY2ZLMZF.cjs +0 -1
- package/dist/chunk-ZDNZCQUQ.js +0 -2
- package/dist/environment-bake-5P4IAL4O.js +0 -4
- package/dist/shader-config-BYBJUL3C.js +0 -2
- package/dist/shader-watch-FVQNE263.js +0 -2
- package/dist/shader-workflow-HZWFWHTS.js +0 -2
- package/dist/status-TV3G3PG4.js +0 -2
package/dist/chunk-4M7M55NS.js
DELETED
|
@@ -1,93 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import {b,c}from'./chunk-NE7SC2BX.js';import {a as a$3}from'./chunk-ZT6T2W4B.js';import {a as a$2,c as c$2}from'./chunk-ZDNZCQUQ.js';import {a as a$1,c as c$1,d,f,e,i,j,k}from'./chunk-5L2VS3BN.js';import {a}from'./chunk-HOZDD6PW.js';import _ from'process';import {createServer}from'http';import {createRequire}from'module';import {mkdtemp,rm,lstat,readFile,unlink,mkdir,readdir,realpath}from'fs/promises';import g from'path';import {tmpdir}from'os';import {pathToFileURL}from'url';import {THREE_WEBGPU_R185_COMPATIBILITY,THREE_R186DEV_VERSION,THREE_WEBGPU_R186DEV_COMPATIBILITY,parsePrecompiledManifest,SHADER_HYDRATION_SCHEMA_VERSION,SHADER_RECIPE_SCHEMA_VERSION,SHADER_ADDRESS_SCHEMA_VERSION,PRECOMPILED_MANIFEST_VERSION}from'three-blocks/shaders';import {transformThreeWebgpuProviderHooks,transformThreeWebgpuCaptureInstrumentation}from'three-blocks/vite';function v(r){if(/^0\.185\./u.test(r))return THREE_WEBGPU_R185_COMPATIBILITY;if(r===THREE_R186DEV_VERSION)return THREE_WEBGPU_R186DEV_COMPATIBILITY;throw new Error(`Three.js ${r} is outside the supported shader compatibility contracts.`)}a(v,"shaderCompatibilityForThree");var I=54,Ae="timing.local.json",je="timing.json",de="parity.json",Q=4096,lr=4096;function se(r,e,t=8192){if(typeof r!="string"||r.length===0||r.length>t||/[\u0000\u007f]/u.test(r))throw new Error(`${e} must be a bounded non-empty string.`);return r}a(se,"boundedString");function S(r,e,t=true){if(typeof r!="number"||!Number.isFinite(r)||r<0||t&&!Number.isSafeInteger(r))throw new Error(`${e} must be a non-negative ${t?"integer":"finite number"}.`);return r}a(S,"nonNegativeNumber");function mr(r){if(!a$2(r))throw new Error("Shader capture stats are missing.");let e={buildCalls:S(r.buildCalls,"capture stats.buildCalls"),renderBuilds:S(r.renderBuilds,"capture stats.renderBuilds"),computeBuilds:S(r.computeBuilds,"capture stats.computeBuilds"),registeredBuilds:S(r.registeredBuilds,"capture stats.registeredBuilds"),registeredRenderBuilds:S(r.registeredRenderBuilds,"capture stats.registeredRenderBuilds"),registeredComputeBuilds:S(r.registeredComputeBuilds,"capture stats.registeredComputeBuilds"),buildMs:S(r.buildMs,"capture stats.buildMs",false),syncBuildMs:S(r.syncBuildMs,"capture stats.syncBuildMs",false),asyncBuildElapsedMs:S(r.asyncBuildElapsedMs,"capture stats.asyncBuildElapsedMs",false),precompiledSetupMs:S(r.precompiledSetupMs,"capture stats.precompiledSetupMs",false),maxSyncBuildMs:S(r.maxSyncBuildMs??r.syncBuildMs,"capture stats.maxSyncBuildMs",false),maxPrecompiledSetupMs:S(r.maxPrecompiledSetupMs??r.precompiledSetupMs,"capture stats.maxPrecompiledSetupMs",false),hydrationMs:S(r.hydrationMs??0,"capture stats.hydrationMs",false),maxHydrationMs:S(r.maxHydrationMs??r.hydrationMs??0,"capture stats.maxHydrationMs",false),injected:S(r.injected,"capture stats.injected"),injectedRender:S(r.injectedRender,"capture stats.injectedRender"),injectedCompute:S(r.injectedCompute,"capture stats.injectedCompute"),missed:S(r.missed,"capture stats.missed"),missedRender:S(r.missedRender,"capture stats.missedRender"),missedCompute:S(r.missedCompute,"capture stats.missedCompute"),...Array.isArray(r.missedKeys)&&r.missedKeys.every(t=>typeof t=="string")?{missedKeys:r.missedKeys.slice(0,Q)}:{}};if(e.renderBuilds+e.computeBuilds!==e.buildCalls||e.registeredRenderBuilds+e.registeredComputeBuilds!==e.registeredBuilds||e.injectedRender+e.injectedCompute!==e.injected||e.missedRender+e.missedCompute!==e.missed||e.registeredBuilds>e.buildCalls||Math.abs(e.syncBuildMs+e.asyncBuildElapsedMs-e.buildMs)>.001||e.maxSyncBuildMs>e.syncBuildMs+.001||e.maxPrecompiledSetupMs>e.precompiledSetupMs+.001||e.maxHydrationMs>e.hydrationMs+.001)throw new Error("Shader capture stats totals are inconsistent.");return e}a(mr,"captureStats");function pr(r){if(!Array.isArray(r)||r.length>Q)throw new Error("Shader capture skipped builds are invalid.");return r.map((e,t)=>{if(!a$2(e)||e.kind!=="render"&&e.kind!=="compute")throw new Error(`Shader capture skipped build ${t} is invalid.`);return {kind:e.kind,name:se(e.name,`skipped build ${t} name`,512),reason:se(e.reason,`skipped build ${t} reason`)}})}a(pr,"skippedBuilds");function hr(r){let e=0,t=0,n=0,s=0;for(let i of Object.values(r.entries)){let a=r.states[i];a!==void 0&&((a.vertex!==null||a.fragment!==null)&&e++,a.vertex!==null&&t++,a.fragment!==null&&n++,a.compute!==null&&s++);}return {render:e,vertex:t,fragment:n,compute:s}}a(hr,"shaderCoverage");function it(r,e){if(!a$2(r))throw new Error("Shader capture payload must be an object.");if(r.scene!==e.scene)throw new Error(`Shader capture scene does not match "${e.scene}".`);if(r.protocolVersion!==2)throw new Error("Shader capture protocolVersion must be 2.");let t=v(e.runtime.three);if(r.compatibility!==t)throw new Error(`Shader capture compatibility must be "${t}".`);if(!a$2(r.entries))throw new Error("Shader capture entries must be an object.");if(typeof r.requiresSetup!="boolean")throw new Error("Shader capture requiresSetup must be boolean.");let n=Object.keys(r.entries).length;if(n===0||n>Q)throw new Error(`Shader capture must contain 1...${Q} entries.`);if(!Array.isArray(r.errors)||r.errors.length>lr)throw new Error("Shader capture errors are invalid.");let s=r.errors.map((m,d)=>se(m,`capture error ${d}`,64*1024));if(s.length>0)throw new Error(`Shader capture failed:
|
|
3
|
-
- ${s.join(`
|
|
4
|
-
- `)}`);let i=pr(r.skipped),a=mr(r.stats),o=a$2(r.timing)?r.timing:void 0,l=o===void 0?void 0:Object.fromEntries(["launch","firstRequest","readiness","lastBuild","settled","posted"].flatMap(m=>{let d=o[m];if(d===void 0)return [];if(typeof d!="number"||!Number.isFinite(d)||d<0)throw new Error(`Shader capture timing.${m} is invalid.`);return [[m,d]]})),h;if(r.provenance!==void 0){if(!a$2(r.provenance)||typeof r.provenance.userAgent!="string"||r.provenance.userAgent.length>1024||typeof r.provenance.adapter!="string"||r.provenance.adapter.length>1024||!Array.isArray(r.provenance.features)||r.provenance.features.length>256||!r.provenance.features.every(m=>typeof m=="string"&&m.length<=128))throw new Error("Shader capture provenance is invalid.");h={userAgent:r.provenance.userAgent,adapter:r.provenance.adapter,features:[...new Set(r.provenance.features)].sort()};}let p=parsePrecompiledManifest({version:PRECOMPILED_MANIFEST_VERSION,scene:e.scene,three:e.runtime.three,threeBlocks:e.runtime.threeBlocks,runtime:{id:t,address:SHADER_ADDRESS_SCHEMA_VERSION,recipe:SHADER_RECIPE_SCHEMA_VERSION,hydration:SHADER_HYDRATION_SCHEMA_VERSION},...r.automatic===void 0?{}:{automatic:r.automatic},requiresSetup:r.requiresSetup,modules:r.modules,nodes:r.nodes,layouts:r.layouts,attributePlans:r.attributePlans,updatePlans:r.updatePlans,requirementPlans:r.requirementPlans,states:r.states,entries:r.entries}),f=hr(p);if(a.registeredRenderBuilds<f.render||a.registeredComputeBuilds<f.compute)throw new Error("Shader capture did not live-build every distinct registered render/compute entry.");return {scene:e.scene,manifest:p,skipped:i,stats:a,coverage:f,...l===void 0?{}:{timing:l},...h===void 0?{}:{provenance:h}}}a(it,"validateShaderCapture");function C(r,e=0){let t=" ".repeat(e),n=" ".repeat(e+1);if(Array.isArray(r))return r.length===0?"[]":r.every(i=>i===null||["number","string","boolean"].includes(typeof i))?JSON.stringify(r):`[
|
|
5
|
-
${r.map(i=>`${n}${C(i,e+1)}`).join(`,
|
|
6
|
-
`)}
|
|
7
|
-
${t}]`;if(r!==null&&typeof r=="object"){let i=r,a=Object.keys(i).sort();return a.length===0?"{}":`{
|
|
8
|
-
${a.map(o=>{let l=i[o];return `${n}${JSON.stringify(o)}: ${C(l,e+1)}`}).join(`,
|
|
9
|
-
`)}
|
|
10
|
-
${t}}`}let s=JSON.stringify(r);if(s===void 0)throw new Error("Shader artifact contains a non-serializable value.");return s}a(C,"stableStringify");function fr(r){return ["// GENERATED FILE \u2014 do not edit by hand.","// Produced by @three-blocks/devtools.","import type { PrecompiledManifest } from 'three-blocks/shaders';","",`export default ${C(r)} satisfies PrecompiledManifest;`,""].join(`
|
|
11
|
-
`)}a(fr,"serializeShaderManifest");function ve(r,e){if(typeof r!="string"||r.length===0||r.length>256||/[\u0000-\u001f\u007f]/u.test(r))throw new Error(`${e} is invalid.`);return r}a(ve,"timingLabel");function ae(r){if(!a$2(r)||r.schemaVersion!==3||r.source!=="latest-local-capture"&&r.source!=="committed-capture"||typeof r.receiptHash!="string"||!/^[a-f0-9]{64}$/u.test(r.receiptHash)||typeof r.measuredAt!="string"||!Number.isFinite(Date.parse(r.measuredAt))||!a$2(r.scenes))throw new Error("Shader timing is invalid.");let e={};for(let[n,s]of Object.entries(r.scenes)){if(n.length===0||n.length>128||!a$2(s))throw new Error("Shader timing scene is invalid.");let i={builds:S(s.builds,`timing ${n}.builds`),setupMeasured:s.setupMeasured===true,liveBuildMs:S(s.liveBuildMs,`timing ${n}.liveBuildMs`,false),precompiledBuildMs:S(s.precompiledBuildMs,`timing ${n}.precompiledBuildMs`,false),avoidedBuildMs:S(s.avoidedBuildMs,`timing ${n}.avoidedBuildMs`,false),runs:S(s.runs,`timing ${n}.runs`),spreadMs:S(s.spreadMs,`timing ${n}.spreadMs`,false)};if(i.runs<1)throw new Error(`Shader timing runs are invalid for scene "${n}".`);if(Math.abs(i.avoidedBuildMs-Math.max(0,i.liveBuildMs-i.precompiledBuildMs))>.001)throw new Error(`Shader timing delta is inconsistent for scene "${n}".`);e[n]=i;}if(Object.keys(e).length===0)throw new Error("Shader timing contains no scenes.");let t={schemaVersion:3,receiptHash:r.receiptHash,measuredAt:r.measuredAt,scenes:e};return r.source==="latest-local-capture"?{...t,source:"latest-local-capture"}:{...t,source:"committed-capture",adapter:ve(r.adapter,"Shader timing adapter"),platform:ve(r.platform,"Shader timing platform")}}a(ae,"parseShaderTiming");function X(r){return /^[a-z0-9][a-z0-9_-]{0,63}$/u.test(r)}a(X,"validParityScene");function Pe(r){return typeof r=="string"&&Number.isFinite(Date.parse(r))}a(Pe,"validParityTimestamp");function ce(r){if(!a$2(r))throw new Error("Shader parity evidence is invalid.");if(r.schemaVersion===1){if(typeof r.receiptHash!="string"||!/^[a-f0-9]{64}$/u.test(r.receiptHash)||!Pe(r.verifiedAt)||!Array.isArray(r.scenes)||r.scenes.length===0||r.scenes.length>64||!r.scenes.every(n=>typeof n=="string"&&X(n)))throw new Error("Shader parity evidence is invalid.");return {schemaVersion:1,receiptHash:r.receiptHash,verifiedAt:r.verifiedAt,scenes:[...new Set(r.scenes)].sort()}}if(r.schemaVersion!==2||!a$2(r.scenes))throw new Error("Shader parity evidence is invalid.");let e=Object.entries(r.scenes);if(e.length===0||e.length>64)throw new Error("Shader parity evidence is invalid.");let t={};for(let[n,s]of e.sort(([i],[a])=>i.localeCompare(a))){if(!X(n)||!a$2(s)||typeof s.fingerprint!="string"||!/^[a-f0-9]{64}$/u.test(s.fingerprint)||!Pe(s.verifiedAt))throw new Error("Shader parity evidence is invalid.");t[n]={fingerprint:s.fingerprint,verifiedAt:s.verifiedAt};}return {schemaVersion:2,scenes:t}}a(ce,"parseShaderParityEvidence");function oe(r,e){let t=r.scenes[e];if(t===void 0)throw new Error(`Shader receipt has no scene "${e}" for parity evidence.`);return c$1(C({runtime:{three:r.runtime.three,threeBlocks:r.runtime.threeBlocks,threeBlocksShaderClosure:r.runtime.threeBlocksShaderClosure},...r.tool===void 0?{}:{tool:r.tool},scene:t}))}a(oe,"shaderSceneParityFingerprint");async function ke(r,e,t,n){let s=g.join(r,t);try{if(!await d(s))return;let i=await lstat(s);if(i.isSymbolicLink()||!i.isFile()||i.size>1024*1024)return;let a=ae(JSON.parse(await readFile(s,"utf8")));return a.source===n&&a.receiptHash===c$1(e)?a:void 0}catch{return}}a(ke,"readShaderTimingFile");async function st(r,e){return await ke(r,e,Ae,"latest-local-capture")??await ke(r,e,je,"committed-capture")}a(st,"readShaderTiming");async function Oe(r,e){let t=g.join(r,de);try{if(!await d(t))return;let n=await lstat(t);if(n.isSymbolicLink()||!n.isFile()||n.size>1024*1024)return;let s=ce(JSON.parse(await readFile(t,"utf8"))),i=c$2(JSON.parse(Buffer.from(e).toString("utf8"))),a={};if(s.schemaVersion===1){if(s.receiptHash!==c$1(e))return;for(let o of s.scenes)i.scenes[o]!==void 0&&(a[o]={fingerprint:oe(i,o),verifiedAt:s.verifiedAt});}else for(let[o,l]of Object.entries(s.scenes))i.scenes[o]===void 0||l.fingerprint!==oe(i,o)||(a[o]=l);return Object.keys(a).length===0?void 0:{schemaVersion:2,scenes:a}}catch{return}}a(Oe,"readShaderParityEvidence");async function Ie(r,e,t){let n=await Z(r),s=g.join(n,"meta.json"),i=await lstat(s);if(i.isSymbolicLink()||!i.isFile())throw new Error("Shader receipt must be a regular file before timing.");let a=await readFile(s),o=new Date().toISOString(),l=Object.fromEntries(Object.entries(e).sort(([f],[m])=>f.localeCompare(m))),h=ae({schemaVersion:3,receiptHash:c$1(a),measuredAt:o,source:"latest-local-capture",scenes:l});if(await f(g.join(n,Ae),`${C(h)}
|
|
12
|
-
`),t===void 0)return {local:h};let p=ae({schemaVersion:3,receiptHash:c$1(a),measuredAt:o,source:"committed-capture",adapter:t.adapter,platform:t.platform,scenes:l});return await f(g.join(n,je),`${C(p)}
|
|
13
|
-
`),{local:h,committed:p}}a(Ie,"writeShaderTimings");async function at(r,e){return (await Ie(r,e)).local}a(at,"writeShaderLocalTiming");async function ot(r,e,t){if(e.length===0||e.length>64||e.some(m=>!X(m)))throw new Error("Shader parity evidence must contain 1...64 valid scene keys.");let n=await Z(r),s=g.join(n,"meta.json"),i=await lstat(s);if(i.isSymbolicLink()||!i.isFile())throw new Error("Shader receipt must be a regular file before parity evidence.");let a=await readFile(s);if(t!==void 0&&c$1(a)!==c$1(t))throw new Error("Shader receipt changed during browser parity verification; completed observations were not attached to the new receipt.");let o=c$2(JSON.parse(a.toString("utf8"))),l=await Oe(n,a),h=new Date().toISOString(),p={...l?.scenes};for(let m of [...new Set(e)].sort())p[m]={fingerprint:oe(o,m),verifiedAt:h};let f$1=ce({schemaVersion:2,scenes:p});return await f(g.join(n,de),`${C(f$1)}
|
|
14
|
-
`),f$1}a(ot,"writeShaderParityEvidence");async function dt(r,e,t){if(e.length===0||e.length>64||e.some(p=>!X(p)))throw new Error("Shader parity invalidation must contain 1...64 valid scene keys.");let n=await Z(r),s=await readFile(g.join(n,"meta.json"));if(c$1(s)!==c$1(t))throw new Error("Shader receipt changed before prior parity evidence could be invalidated.");let i=await Oe(n,s);if(i===void 0)return;let a=new Set(e),o=Object.fromEntries(Object.entries(i.scenes).filter(([p])=>!a.has(p))),l=g.join(n,de);if(Object.keys(o).length===0){await unlink(l).catch(p=>{if(!a$2(p)||p.code!=="ENOENT")throw p});return}let h=ce({schemaVersion:2,scenes:o});await f(l,`${C(h)}
|
|
15
|
-
`);}a(dt,"removeShaderParityEvidence");async function ct(r,e,t){let n=await Ie(r,e,t);if(n.committed===void 0)throw new Error("Committed shader timing was not written.");return {local:n.local,committed:n.committed}}a(ct,"writeShaderTimingTwins");async function Ce(r){if(!await d(r)){await mkdir(r);return}let e=await lstat(r);if(e.isSymbolicLink()||!e.isDirectory())throw new Error(`Shader artifact path is not a real directory: ${r}.`)}a(Ce,"assertDirectory");async function Z(r){let e=g.resolve(r),t=g.join(e,".three-blocks");await Ce(t);let n=g.join(t,"shaders");return await Ce(n),n}a(Z,"artifactRoot");async function ut(r){let e$1=await Z(r.root),t=v(r.runtime.three),n=g.resolve(r.root),s=g.resolve(n,r.publicDirectory??"public");if(!e(n,s)||s===n)throw new Error("Shader public directory must stay inside the project root.");let i$1=g.join(s,"three-blocks","shaders");await mkdir(i$1,{recursive:true}),await i(n,i$1,"Shader static-asset directory");let a={},o=[];for(let d of [...r.scenes].sort((u,y)=>u.key.localeCompare(y.key))){let u=r.captures.get(d.key),y=r.inputs.get(d.key);if(y===void 0)throw new Error(`Shader input matrix is missing scene "${d.key}".`);if(u===void 0){let R=r.previousReceipt?.scenes[d.key];if(R===void 0)throw new Error(`Capture matrix is missing scene "${d.key}".`);let N=await readFile(g.join(e$1,R.artifact));if(c$1(N)!==R.artifactHash)throw new Error(`Preserved shader artifact checksum differs for scene "${d.key}".`);if(R.asset!==void 0&&R.assetHash!==void 0){let H=await readFile(g.join(s,R.asset));if(c$1(H)!==R.assetHash)throw new Error(`Preserved static shader manifest checksum differs for scene "${d.key}".`)}a[d.key]={...R,inputs:Object.fromEntries(Object.entries(y).sort(([H],[z])=>H.localeCompare(z)))},o.push(R.artifact),R.asset!==void 0&&o.push(g.relative(n,g.join(s,R.asset)).split(g.sep).join("/"));continue}if(u.scene!==d.key||u.manifest.scene!==d.key)throw new Error(`Capture matrix scene "${d.key}" is inconsistent.`);let b=`${d.key}.webgpu.ts`,w=fr(u.manifest);await f(g.join(e$1,b),w),o.push(b);let P=`three-blocks/shaders/${d.key}.json`,B=`${C(u.manifest)}
|
|
16
|
-
`;await f(g.join(s,P),B),o.push(g.relative(n,g.join(s,P)).split(g.sep).join("/"));let M=u.skipped.filter(R=>R.kind==="render").length,k=u.skipped.length-M;a[d.key]={artifact:b,artifactHash:c$1(w),asset:P,assetHash:c$1(B),inputs:Object.fromEntries(Object.entries(y).sort(([R],[N])=>R.localeCompare(N))),coverage:u.coverage,bytes:Buffer.byteLength(w),skipped:{render:M,compute:k}};}let l=[...r.captures.values()].find(d=>d.provenance!==void 0)?.provenance??r.previousReceipt?.runtime.capture,h={schemaVersion:2,runtime:{...r.runtime,...l===void 0?{}:{capture:l}},tool:{name:"@three-blocks/devtools",version:a$3,compatibility:t,transform:I,address:SHADER_ADDRESS_SCHEMA_VERSION,recipe:SHADER_RECIPE_SCHEMA_VERSION,hydration:SHADER_HYDRATION_SCHEMA_VERSION},scenes:a},p=new Set(o);for(let d of await readdir(e$1,{withFileTypes:true}))if(!(!d.name.endsWith(".webgpu.ts")||p.has(d.name))){if(d.isSymbolicLink()||!d.isFile())throw new Error(`Orphan shader artifact is not a regular file: ${d.name}.`);await unlink(g.join(e$1,d.name));}let f$1=new Set(r.scenes.map(d=>`${d.key}.json`)),m=new Set(Object.values(r.previousReceipt?.scenes??{}).map(d=>d.asset===void 0?void 0:g.posix.basename(d.asset)).filter(d=>d!==void 0));try{let d=c$2(JSON.parse(await readFile(g.join(e$1,"meta.json"),"utf8")));for(let u of Object.values(d.scenes))u.asset!==void 0&&m.add(g.posix.basename(u.asset));}catch{}for(let d of await readdir(i$1,{withFileTypes:true}))if(!(!d.name.endsWith(".json")||f$1.has(d.name))&&m.has(d.name)){if(d.isSymbolicLink()||!d.isFile())throw new Error(`Orphan shader static asset is not a regular file: ${d.name}.`);await unlink(g.join(i$1,d.name));}return await f(g.join(e$1,"meta.json"),`${C(h)}
|
|
17
|
-
`),o.push("meta.json"),{directory:e$1,receipt:h,files:o}}a(ut,"writeShaderArtifacts");var Le="three-blocks.shader-capture.runtime.v1";var W;async function F(){W===void 0&&(W=(async()=>{let e=createRequire(g.join(process.cwd(),"package.json")).resolve("@three-blocks/devtools/browser/shader-capture"),t=g.resolve(g.dirname(e),"../..");return (await j(t,e,a$1.metadata,"Shader capture browser runtime")).data.toString("utf8")})());let r=W;try{return await r}catch(e){throw W===r&&(W=void 0),e}}a(F,"loadShaderCaptureRuntimeSource");var De="virtual:three-blocks-shader-capture-client",$e="\0three-blocks:shader-capture-client",le="virtual:three-blocks-shader-capture-runtime",Fe="\0three-blocks:shader-capture-runtime";async function He(){let r=await F(),e=r.replace(/\bexport\{[^{}]*\};?\s*$/u,"");if(e===r)throw new Error("Shader capture browser runtime no longer has the expected final ESM export list.");return e}a(He,"loadShaderCaptureRuntimeScriptSource");function br(r){let e=r.split("?",1)[0];return e===void 0?false:e.split(g.sep).join("/").endsWith("/build/three.webgpu.js")}a(br,"isThreeWebGPUModule");function Ue(r){let e=/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/u.exec(r);return e?.[1]==="0"&&e[2]==="185"}a(Ue,"supportedVersion");function Er(r,e,t={}){if(!Ue(e))throw new Error(`Shader provider transform ${THREE_WEBGPU_R185_COMPATIBILITY} supports Three.js 0.185.x; received "${e}".`);let n=transformThreeWebgpuProviderHooks(r,{threeVersion:e,...t.threeRevision===void 0?{}:{threeRevision:t.threeRevision},id:"three/build/three.webgpu.js"}),s=n.state==="already-applied",i=n.code;return t.instrumentCapture&&(i=transformThreeWebgpuCaptureInstrumentation(i,{...t.captureRuntimeImport===void 0?{}:{runtimeImport:t.captureRuntimeImport}}).code),{code:i,alreadyPresent:s,captureApplied:t.instrumentCapture===true}}a(Er,"applyShaderProviderTransform");var Rr=/this\.trackTimestamp\s*=\s*\(\s*parameters\.trackTimestamp\s*===\s*true\s*\);/gu,Tr="Object.defineProperty( this, 'trackTimestamp', { get: () => false, set: () => {} } );";function Ve(r,e={}){if(!Ue(r))throw new Error(`Shader provider transform ${THREE_WEBGPU_R185_COMPATIBILITY} supports Three.js 0.185.x; received "${r}".`);let t={seen:false,applied:false,alreadyPresent:false};return {plugin:{name:"three-blocks:shader-provider-transform",enforce:"pre",config(){return {optimizeDeps:{exclude:["three","three/webgpu","three/tsl"]},resolve:{dedupe:["three"]}}},resolveId(s){return e.capture&&s===De?$e:e.capture&&s===le?Fe:null},async load(s){return e.capture?s===Fe?F():s===$e?[`export * from '${le}';`,`import { configureThreeBlocksShaderCapture } from '${le}';`,`configureThreeBlocksShaderCapture( ${JSON.stringify({capture:e.capture.capture,forceLive:e.capture.forceLive,settleFrames:e.capture.settleFrames,settleTimeoutMs:e.capture.settleTimeoutMs,visibilityGuard:e.capture.visibilityGuard,captureId:e.capture.captureId,sessionKey:e.capture.sessionKey,token:e.capture.token,readiness:e.capture.readiness??{},transform:I})} );`].join(`
|
|
18
|
-
`):null:null},transform(s,i){if(!br(i))return null;t.seen=true,t.id=i;try{let a=Er(s,r,{instrumentCapture:e.capture!==void 0,...e.capture!==void 0?{captureRuntimeImport:De}:{}}),o=e.disableTimestampQueries===!0?a.code.replace(Rr,Tr):a.code;if(e.disableTimestampQueries===!0&&o===a.code)throw new Error("Three.js timestamp tracking anchor drifted; refusing software WebGPU capture.");return t.applied=!0,t.alreadyPresent=a.alreadyPresent,t.captureApplied=a.captureApplied,o===s?null:{code:o,map:null}}catch(a){throw t.error=a instanceof Error?a.message:String(a),a}}},status:t}}a(Ve,"createShaderProviderTransform");function me(r){if(r.error)throw new Error(r.error);if(!r.seen||!r.applied)throw new Error(`The version-gated shader provider transform was not applied (${r.seen?"module seen":"three/webgpu not seen"}).`)}a(me,"assertShaderProviderTransform");var Qe="/__three-blocks/shaders/capture",te="/__three-blocks/shaders/telemetry",Xe="/__three-blocks/shaders/runtime.js",Ze="/__three-blocks/shaders/bootstrap.js",er="/__three-blocks/shaders/bridge.js",rr=a$1.manifest*2,fe=/^[a-z0-9][a-z0-9_-]{0,63}$/u,tr=64,nr=2e3,xr=[/is not valid JSON/iu,/WebGPU is experimental/iu];async function Ar(){try{return (await import('playwright')).chromium}catch(r){throw new Error('Shader browser work requires the optional "playwright" package. Install it in the project and run `npx playwright install chromium`.',{cause:r})}}a(Ar,"loadChromium");async function jr(r){let e;try{e=createRequire(g.join(r,"package.json")).resolve("vite");}catch(n){throw new Error("Shader capture requires Vite in the target project.",{cause:n})}let t=await import(pathToFileURL(e).href);if(typeof t.createServer!="function")throw new Error(`The target project's Vite entry does not export createServer(): ${e}`);return t.createServer}a(jr,"loadProjectCreateServer");var ye=class{static{a(this,"CaptureInbox");}#e=new Map;#r=new Map;wait(e,t){let n=this.#r.get(e);if(n!==void 0)return this.#r.delete(e),Promise.resolve(n);if(this.#e.has(e))throw new Error(`A shader capture is already waiting for scene "${e}".`);return new Promise((s,i)=>{let a=setTimeout(()=>{this.#e.delete(e),i(new Error(`Shader capture "${e}" timed out after ${t}ms.`));},t);this.#e.set(e,{resolve:s,reject:i,timer:a});})}receive(e){if(!a$2(e)||typeof e.scene!="string"||!fe.test(e.scene))throw new Error("Capture POST has no safe scene key.");if(!this.#r.has(e.scene)&&!this.#e.has(e.scene)&&this.#r.size>=tr)throw new Error("Capture POST exceeds the scene inbox limit.");let t=this.#e.get(e.scene);t?(clearTimeout(t.timer),this.#e.delete(e.scene),t.resolve(e)):this.#r.set(e.scene,e);}cancel(e,t){let n=this.#e.get(e);n&&(clearTimeout(n.timer),this.#e.delete(e),n.reject(t));}rejectAll(e){for(let t of this.#e.values())clearTimeout(t.timer),t.reject(e);this.#e.clear(),this.#r.clear();}};async function Or(r,e){let t=await Promise.race([e.then(n=>({kind:"capture",value:n})),r.then(()=>({kind:"navigation"}))]);return t.kind==="capture"?t.value:e}a(Or,"waitForShaderCaptureAcrossNavigation");var ge=class{static{a(this,"TelemetryHub");}#e=new Map;#r=new Map;markFirstRequest(e){fe.test(e)&&!this.#r.has(e)&&this.#r.set(e,Date.now());}firstRequest(e){return this.#r.get(e)}receive(e){if(!a$2(e)||typeof e.scene!="string"||!fe.test(e.scene))throw new Error("Shader telemetry has no bounded scene key.");if(!this.#e.has(e.scene)&&this.#e.size>=tr)throw new Error("Shader telemetry exceeds the scene limit.");this.#e.set(e.scene,e);}read(e){return this.#e.get(e)}clear(e){this.#e.delete(e),this.#r.delete(e);}},Ir=a(async(r,e,t,n,s)=>{let i=0;for(;r.__threeBlocksParityUsesAnimationLoop!==true&&i<e;)await n(),i+=1;if(r.__threeBlocksParityUsesAnimationLoop===true){let a=Number(r.__threeBlocksParityCompletedFrame||0),o=Number(t),l=Number.isSafeInteger(o)&&o>=a?o:a+e;for(r.__threeBlocksParityTargetFrame=l;Number(r.__threeBlocksParityCompletedFrame||0)<l;)await n();}return await s(),Number(r.__threeBlocksParityCompletedFrame||0)},"settleShaderParityFrames");function Se(r){return `(() => {
|
|
19
|
-
const root = globalThis;
|
|
20
|
-
const scene = new URL(location.href).searchParams.get('captureId')
|
|
21
|
-
|| 'default';
|
|
22
|
-
const randomSeed = (value) => {
|
|
23
|
-
let state = 2166136261;
|
|
24
|
-
for (let index = 0; index < value.length; index++) state = Math.imul(state ^ value.charCodeAt(index), 16777619) >>> 0;
|
|
25
|
-
return state === 0 ? 0x9e3779b9 : state;
|
|
26
|
-
};
|
|
27
|
-
const advanceRandom = (state) => {
|
|
28
|
-
state ^= state << 13;
|
|
29
|
-
state ^= state >>> 17;
|
|
30
|
-
state ^= state << 5;
|
|
31
|
-
return state >>> 0;
|
|
32
|
-
};
|
|
33
|
-
const parityMode = new URL(location.href).searchParams.get('threeBlocksShaderMode');
|
|
34
|
-
if (parityMode === 'live' || parityMode === 'precompiled') {
|
|
35
|
-
root.__threeBlocksParityEpoch = 1700000000000;
|
|
36
|
-
root.__threeBlocksParityTime = 0;
|
|
37
|
-
Date.now = () => root.__threeBlocksParityEpoch + Number(root.__threeBlocksParityTime || 0);
|
|
38
|
-
}
|
|
39
|
-
const randomStreams = new Map();
|
|
40
|
-
Math.random = () => {
|
|
41
|
-
const stackLine = String(new Error().stack || '').split('\\n')[2] || 'unknown';
|
|
42
|
-
const originIndex = stackLine.indexOf(location.origin);
|
|
43
|
-
const callsite = (originIndex >= 0 ? stackLine.slice(0, originIndex) : stackLine).trim() || 'anonymous';
|
|
44
|
-
const next = advanceRandom(randomStreams.get(callsite) ?? randomSeed(scene + '|' + callsite));
|
|
45
|
-
randomStreams.set(callsite, next);
|
|
46
|
-
return next / 4294967296;
|
|
47
|
-
};
|
|
48
|
-
const readiness = { workerReady: false, assetsReady: false, textReady: false, compileEnd: false, firstFrame: false };
|
|
49
|
-
const stats = { buildCalls: 0, renderBuilds: 0, computeBuilds: 0, registeredBuilds: 0, registeredRenderBuilds: 0, registeredComputeBuilds: 0, buildMs: 0, syncBuildMs: 0, asyncBuildElapsedMs: 0, precompiledSetupMs: 0, maxSyncBuildMs: 0, maxPrecompiledSetupMs: 0, hydrationMs: 0, maxHydrationMs: 0, injected: 0, injectedRender: 0, injectedCompute: 0, missed: 0, missedRender: 0, missedCompute: 0, missedKeys: [] };
|
|
50
|
-
const settleParityFrames = ${Ir.toString()};
|
|
51
|
-
const settle = (frames, requestedTarget) => settleParityFrames(
|
|
52
|
-
root,
|
|
53
|
-
frames,
|
|
54
|
-
requestedTarget,
|
|
55
|
-
() => new Promise((resolve) => requestAnimationFrame(resolve)),
|
|
56
|
-
() => new Promise((resolve) => setTimeout(resolve, 100)),
|
|
57
|
-
);
|
|
58
|
-
const bridge = { protocolVersion: 1, compatibility: ${JSON.stringify(r)}, transform: ${I}, readiness, stats, settle };
|
|
59
|
-
root.__threeBlocksShaderTools = bridge;
|
|
60
|
-
requestAnimationFrame(() => requestAnimationFrame(() => { readiness.firstFrame = true; }));
|
|
61
|
-
const poll = async () => {
|
|
62
|
-
try {
|
|
63
|
-
const response = await fetch('/__three-blocks/shaders/telemetry?scene=' + encodeURIComponent(scene), { cache: 'no-store' });
|
|
64
|
-
if (response.status !== 204 && response.ok) {
|
|
65
|
-
const payload = await response.json();
|
|
66
|
-
if (payload.protocolVersion !== 1 || payload.compatibility !== bridge.compatibility || payload.transform !== bridge.transform) throw new Error('incompatible shader telemetry');
|
|
67
|
-
Object.assign(stats, payload.stats);
|
|
68
|
-
readiness.workerReady = true;
|
|
69
|
-
if (payload.settled === true) {
|
|
70
|
-
readiness.assetsReady = true;
|
|
71
|
-
readiness.textReady = true;
|
|
72
|
-
readiness.compileEnd = true;
|
|
73
|
-
}
|
|
74
|
-
const smoke = root.__threeBlocksSmoke && typeof root.__threeBlocksSmoke === 'object' ? root.__threeBlocksSmoke : { protocolVersion: 1, worker: { offscreenCanvas: true, visible: true }, readiness: {} };
|
|
75
|
-
smoke.readiness = { ...(smoke.readiness || {}), ...readiness };
|
|
76
|
-
root.__threeBlocksSmoke = smoke;
|
|
77
|
-
}
|
|
78
|
-
} catch {}
|
|
79
|
-
setTimeout(poll, 40);
|
|
80
|
-
};
|
|
81
|
-
void poll();
|
|
82
|
-
})();`}a(Se,"publicBridgeScript");function ir(r,e,t,n,s=false){let i=new URL(r.url??"/","http://three-blocks.invalid"),a=i.pathname;if(s&&r.method==="GET"&&/^\/three-blocks\/shaders\/[a-z0-9][a-z0-9_-]{0,63}\.json$/u.test(a))return e.statusCode=204,e.end(),true;if(a===te&&r.method==="GET"){let m=i.searchParams.get("scene")??"",d=n.read(m);return d===void 0?(e.statusCode=204,e.end()):(e.statusCode=200,e.setHeader("Content-Type","application/json"),e.end(JSON.stringify(d))),true}let o=a===Qe,l=a===te;if(!o&&!l)return false;if(r.method!=="POST")return e.statusCode=405,e.end("POST required"),true;let h=[],p=0,f=false;return r.on("data",m=>{p+=m.byteLength,p>rr?f=true:h.push(m);}),r.on("end",()=>{if(f){e.statusCode=413,e.end("capture payload too large");return}try{let m=JSON.parse(Buffer.concat(h).toString("utf8"));l?n.receive(m):t.receive(m),e.statusCode=204,e.end();}catch(m){e.statusCode=400,e.end(m instanceof Error?m.message:String(m));}}),true}a(ir,"handleCaptureEndpoint");function Lr(r,e,t,n){return {name:"three-blocks:shader-capture-endpoint",transformIndexHtml(){return [{tag:"script",children:Se(n),injectTo:"head-prepend"}]},configureServer(s){s.middlewares.use((i,a,o)=>{let h=new URL(i.url??"/","http://three-blocks.invalid").searchParams.get("captureId");h!==null&&e.markFirstRequest(h),!ir(i,a,r,e,t)&&o();});}}}a(Lr,"captureEndpointPlugin");function We(r,e,t){let n=new URL(e.url,r);for(let[s,i]of Object.entries(t))n.searchParams.set(s,i);return n.href}a(We,"browserUrl");function Dr(r,e){let t=new URL(e.url,r);for(let n of ["capture","precompiled"])t.searchParams.delete(n);return t.searchParams.set("captureId",e.key),t.searchParams.set("threeBlocksShaderMode","precompiled"),t.searchParams.set("tbStats","1"),t.href}a(Dr,"publishedBrowserUrl");function qe(r){return xr.some(e=>e.test(r))}a(qe,"knownNoise");async function L(r){let e;try{await Promise.race([r(),new Promise(t=>{e=setTimeout(t,nr);})]);}catch{}finally{e&&clearTimeout(e);}}a(L,"closeBrowserResource");async function Ke(r){let e;try{return await Promise.race([r().catch(()=>null),new Promise(t=>{e=setTimeout(()=>t(null),nr);})])}finally{e!==void 0&&clearTimeout(e);}}a(Ke,"readPageDiagnostic");function pe(r){let e=a(()=>{},"resolveFirst"),t=new Promise(a=>{e=a;}),n={console:[],page:[],first:t},s=false,i=a(a=>{s||(s=true,e(new Error(a)));},"report");return r.on("console",a=>{let o=a.type()==="warning"&&/\[three-blocks\/shaders\].*(?:has no entry|manifest miss|hydration)/iu.test(a.text());if(a.type()!=="error"&&!o||qe(a.text()))return;let l=a.location().url,h=l.length>0?`${a.text()} (${l})`:a.text();n.console.push(h),i(`Browser console ${o?"warning":"error"}: ${h}`);}),r.on("pageerror",a=>{if(qe(a.message))return;let o=a.stack||a.message;n.page.push(o),i(`Browser page error: ${o}`);}),r.on("crash",()=>i("Browser page crashed before shader capture completed.")),r.on("close",()=>i("Browser page closed before shader capture completed.")),n}a(pe,"collectErrors");function q(r,e,t=false){return typeof r[e]=="boolean"?r[e]:t}a(q,"booleanField");function $r(r){if(!a$2(r))throw new Error("Browser shader stats are unavailable.");let e=a((t,n=true)=>{let s=r[t];if(typeof s!="number"||!Number.isFinite(s)||s<0||n&&!Number.isSafeInteger(s))throw new Error(`Browser shader stats.${t} is invalid.`);return s},"read");return {buildCalls:e("buildCalls"),renderBuilds:e("renderBuilds"),computeBuilds:e("computeBuilds"),registeredBuilds:e("registeredBuilds"),registeredRenderBuilds:e("registeredRenderBuilds"),registeredComputeBuilds:e("registeredComputeBuilds"),buildMs:e("buildMs",false),syncBuildMs:e("syncBuildMs",false),asyncBuildElapsedMs:e("asyncBuildElapsedMs",false),precompiledSetupMs:e("precompiledSetupMs",false),maxSyncBuildMs:e("maxSyncBuildMs",false),maxPrecompiledSetupMs:e("maxPrecompiledSetupMs",false),hydrationMs:e("hydrationMs",false),maxHydrationMs:e("maxHydrationMs",false),injected:e("injected"),injectedRender:e("injectedRender"),injectedCompute:e("injectedCompute"),missed:e("missed"),missedRender:e("missedRender"),missedCompute:e("missedCompute"),...Array.isArray(r.missedKeys)&&r.missedKeys.every(t=>typeof t=="string")?{missedKeys:r.missedKeys}:{}}}a($r,"parseStats");function ee(r,e,t,n,s){if(!a$2(r))throw new Error("The page did not expose the public shader devtools bridge.");if(!t&&r.protocolVersion!==1)throw new Error(`Scene "${e.key}" exposed an unsupported shader bridge protocol.`);let i=r.readiness;if(!a$2(i))throw new Error("The shader bridge readiness snapshot is invalid.");let a={workerReady:q(i,"workerReady"),assetsReady:q(i,"assetsReady"),textReady:e.requiresText?q(i,"textReady"):true,compileEnd:q(i,"compileEnd"),firstFrame:q(i,"firstFrame",t)};if(!a.workerReady||!a.assetsReady||!a.textReady||!a.compileEnd)throw new Error(`Scene "${e.key}" did not reach worker/assets/text/compile readiness.`);let o=t?s:r.compatibility,l=t?I:r.transform;if(o!==s||l!==I)throw new Error(`Scene "${e.key}" exposed incompatible shader bridge metadata.`);return me(n),{compatibility:s,transform:l,readiness:a,stats:$r(r.stats)}}a(ee,"parseBridge");async function re(r,e){return r.evaluate(t=>{let n=globalThis;if(!t)return n.__threeBlocksShaderTools??null;let s=n.__threeBlocks,i=n.__threeBlocksTslStats;if(!s||typeof s!="object")return null;let a=s;return {readiness:{workerReady:a.workerReady===true,assetsReady:a.loadEnd===true||a.assetsReady===true,textReady:a.textReady===true,compileEnd:a.compileEnd===true,firstFrame:true},stats:i}},e)}a(re,"readBridge");async function K(r,e,t,n){let s=r.evaluate(async a$1=>{let l=globalThis.__threeBlocksShaderTools;if(l&&typeof l=="object"){let f=Reflect.get(l,"settle");if(typeof f=="function"){let m=await f(a$1.frames,a$1.targetFrame);return typeof m=="number"&&Number.isSafeInteger(m)?m:0}}if(!a$1.legacy||!a$1.modulePath)throw new Error("The public shader bridge does not provide deterministic settle().");let h=await import(a$1.modulePath);if(!h.store||typeof h.store!="object")throw new Error("Legacy deterministic store is unavailable.");let p=h.store;return p.recordFrameCount=0,p.recordFrameRate=60,p.recordTotalFrames=a$1.frames,p.recording=true,await new Promise((f,m)=>{let d=Date.now(),u=a(()=>{if(p.recording===false)return f();if(Date.now()-d>a$1.timeoutMs)return m(new Error("Legacy deterministic settle timed out."));setTimeout(u,25);},"poll");u();}),0},{frames:t,targetFrame:n,legacy:e.bridge.legacyLab,modulePath:e.bridge.deterministicModule??null,timeoutMs:e.timeoutMs}),i;try{return await Promise.race([s,new Promise((a,o)=>{i=setTimeout(()=>o(new Error(`Shader parity settle timed out after ${e.timeoutMs}ms.`)),e.timeoutMs);})])}finally{i!==void 0&&clearTimeout(i);}}a(K,"settlePage");async function Je(r,e,t){e.readiness.selector===void 0&&e.readiness.global===void 0||await Promise.race([r.waitForFunction(n=>{let s=globalThis;if(n.selector!==void 0&&s.document?.querySelector(n.selector)==null)return false;if(n.global===void 0)return true;let i=s;for(let l of n.global.split(".")){if((typeof i!="object"||i===null)&&typeof i!="function")return false;i=Reflect.get(i,l);}if(i===true)return true;if(typeof i!="object"||i===null||typeof Reflect.get(i,"then")!="function")return false;let a=s.__threeBlocksReadinessState,o=a instanceof Map?a:new Map;return a instanceof Map||(s.__threeBlocksReadinessState=o),o.has(i)||(o.set(i,false),Promise.resolve(i).then(()=>o.set(i,true),()=>o.set(i,false))),o.get(i)===true},e.readiness,{timeout:e.timeoutMs}),t.first.then(n=>Promise.reject(n))]);}a(Je,"waitForConfiguredReadiness");async function ze(r){let e=r.locator("canvas"),n=(await e.evaluateAll(s=>s.map((i,a)=>{let o=i.getBoundingClientRect();return {index:a,area:Math.max(0,o.width)*Math.max(0,o.height)}}))).sort((s,i)=>i.area-s.area)[0];if(n===void 0||n.area<=0)throw new Error("Published page has no visible renderer canvas.");return Buffer.from(await e.nth(n.index).screenshot({type:"png"}))}a(ze,"primaryCanvasScreenshot");async function he(r,e,t,n,s,i){let a=sr(n,s),o=await He(),l=`(() => {
|
|
83
|
-
const runtime = globalThis[Symbol.for(${JSON.stringify(Le)})];
|
|
84
|
-
if (!runtime || typeof runtime.configureThreeBlocksShaderCapture !== 'function') {
|
|
85
|
-
throw new Error('@three-blocks/devtools attached shader capture runtime is incompatible.');
|
|
86
|
-
}
|
|
87
|
-
runtime.configureThreeBlocksShaderCapture(${JSON.stringify(a).replaceAll("<","\\u003c")});
|
|
88
|
-
})();`;await r.addInitScript({content:`${o}
|
|
89
|
-
${l}`}),await r.addInitScript({content:Se(i)}),await r.route("**/*",async h=>{let p=h.request(),f=new URL(p.url()),m=f.pathname;if(p.method()==="GET"&&n!=="precompiled"&&/^\/three-blocks\/shaders\/[a-z0-9][a-z0-9_-]{0,63}\.json$/u.test(m)){await h.fulfill({status:204});return}if(m===te&&p.method()==="GET"){let y=t.read(f.searchParams.get("scene")??"");await h.fulfill(y===void 0?{status:204}:{status:200,contentType:"application/json",body:JSON.stringify(y)});return}let d=m===Qe,u=m===te;if((d||u)&&p.method()==="POST"){let y=p.postDataBuffer()??Buffer.alloc(0);if(y.byteLength>rr){await h.fulfill({status:413,body:"capture payload too large"});return}try{let b=JSON.parse(y.toString("utf8"));u?t.receive(b):e.receive(b),await h.fulfill({status:204});}catch(b){await h.fulfill({status:400,body:b instanceof Error?b.message:String(b)});}return}await h.continue();});}a(he,"configureAttachedContext");var Fr=Object.freeze({".avif":"image/avif",".css":"text/css; charset=utf-8",".gif":"image/gif",".html":"text/html; charset=utf-8",".ico":"image/x-icon",".jpeg":"image/jpeg",".jpg":"image/jpeg",".js":"text/javascript; charset=utf-8",".json":"application/json; charset=utf-8",".mjs":"text/javascript; charset=utf-8",".mp4":"video/mp4",".png":"image/png",".svg":"image/svg+xml",".wasm":"application/wasm",".webm":"video/webm",".webp":"image/webp",".woff":"font/woff",".woff2":"font/woff2"});function Nr(r){let e=[`<script src="${er}"></script>`,`<script type="module" src="${Ze}"></script>`].join(""),t=/<head(?:\s[^>]*)?>/iu.exec(r);return t===null?`${e}${r}`:`${r.slice(0,t.index+t[0].length)}${e}${r.slice(t.index+t[0].length)}`}a(Nr,"injectStaticShaderCaptureHtml");function Hr(r,e){let t=sr(r,e);return [`import { configureThreeBlocksShaderCapture } from ${JSON.stringify(Xe)};`,`configureThreeBlocksShaderCapture( ${JSON.stringify(t).replaceAll("<","\\u003c")} );`].join(`
|
|
90
|
-
`)}a(Hr,"staticCaptureBootstrap");function sr(r,e){return {capture:r==="capture",forceLive:r!=="precompiled",settleFrames:e.settleFrames,settleTimeoutMs:e.settleTimeoutMs??3e4,readiness:e.readiness,transform:I}}a(sr,"shaderCaptureConfiguration");async function Ur(r,e){let t=await k(r,e,a=>/\.(?:c|m)?js$/u.test(a),16384),n=false,s=false,i;for(let a of t){let o=(await j(r,a,a$1.texture,"Static application JavaScript")).data.toString("utf8");if(o.includes("nodeBuilderStateProvider")&&(n=true),o.includes("three-blocks.shader-capture.runtime.v1")&&(s=true,i??=a),n&&s)break}if(!n||!s)throw new Error("The static build does not contain the Three.js shader capture transform. Run `shaders capture` without an explicit driver or URL to preview adapter wiring and build automatically, or add the manual adapter from the package README and rebuild.");return {seen:true,applied:true,alreadyPresent:false,captureApplied:true,...i===void 0?{}:{id:i}}}a(Ur,"inspectStaticCaptureTransform");async function Vr(r,e$1){let t;try{t=decodeURIComponent(e$1);}catch{return}if(t.includes("\0"))return;let n=t.replace(/^\/+/u,""),s=g.resolve(r,n.length===0?"index.html":n);if(!e(r,s)||s===r||(await d(s)&&(await lstat(s)).isDirectory()&&(s=g.join(s,"index.html")),!await d(s)&&g.extname(s).length===0&&(s=g.join(r,"index.html")),!await d(s)))return;let i=await j(r,s,a$1.texture,"Static application asset");return {data:i.data,file:i.path}}a(Vr,"staticRequestFile");async function Gr(r,e$1,t,n,s){let i=await realpath(r.root),a=await realpath(g.resolve(i,r.serve));if(!e(i,a)||a===i)throw new Error("--serve must name a built application directory inside the project root.");let o=await Ur(i,a),l=await F(),h=Hr(e$1,t),p=Se(v(r.runtime.three)),f=createServer((d,u)=>{(async()=>{if(ir(d,u,n,s,e$1!=="precompiled"))return;let y=new URL(d.url??"/","http://three-blocks.invalid");if(d.method!=="GET"&&d.method!=="HEAD"){u.statusCode=405,u.end("GET or HEAD required");return}let b=y.pathname===Xe?l:y.pathname===Ze?h:y.pathname===er?p:void 0;if(b!==void 0){u.statusCode=200,u.setHeader("Content-Type","text/javascript; charset=utf-8"),u.setHeader("Cache-Control","no-store"),u.end(d.method==="HEAD"?void 0:b);return}let w=await Vr(a,y.pathname);if(w===void 0){u.statusCode=404,u.end("Not found");return}let P=g.extname(w.file).toLowerCase(),B=P===".html"?Buffer.from(Nr(w.data.toString("utf8"))):w.data;u.statusCode=200,u.setHeader("Content-Type",Fr[P]??"application/octet-stream"),u.setHeader("Content-Length",String(B.byteLength)),u.setHeader("Cache-Control","no-store"),u.end(d.method==="HEAD"?void 0:B);})().catch(y=>{if(u.headersSent)return u.destroy(y instanceof Error?y:void 0);u.statusCode=500,u.end(y instanceof Error?y.message:String(y));});});await new Promise((d,u)=>{f.once("error",u),f.listen(0,"127.0.0.1",()=>{f.off("error",u),d();});});let m=f.address();if(!m||typeof m=="string")throw new Error("Static capture server did not expose an ephemeral TCP address.");return {server:f,baseUrl:`http://127.0.0.1:${m.port}`,transform:o}}a(Gr,"startStaticShaderServer");function Wr(r,e,t){return r===e?true:t&&r!==void 0&&r!=="capture"&&e!=="capture"}a(Wr,"canReuseShaderBrowserSession");function Ye(r){let e=r instanceof Error?r.message:String(r);return e.includes("Execution context was destroyed")&&e.includes("navigation")||/^launch: Timeout \d+ms exceeded\./u.test(e)}a(Ye,"isRetryableShaderObservationNavigation");var J=class{static{a(this,"PlaywrightShaderDriver");}#e;#r=new ye;#n=new ge;#m;#p;#a;#o;#t;#i;#h;#c;#f;#u=0;#l;constructor(e){this.#e=e;}#d(){return this.#m?.status??this.#p??{seen:false,applied:false,alreadyPresent:false}}async#y(e){if(this.#t?.isConnected()===true)return;this.#t=void 0;let t=await Ar();this.#l??=await mkdtemp(g.join(tmpdir(),"three-blocks-shader-cache-")),this.#t=await t.launch({headless:c(this.#e.headed===true),args:[...b(),`--disk-cache-dir=${this.#l}`],timeout:e.timeoutMs}),this.#u=0;}async#s(e,t,n){let s;try{return await Promise.race([n(),new Promise((i,a)=>{s=setTimeout(()=>a(new Error(`launch: Timeout ${t.timeoutMs}ms exceeded.`)),t.timeoutMs);})])}catch(i){throw this.#t===e&&(this.#t=void 0),await L(()=>e.close()),i}finally{s!==void 0&&clearTimeout(s);}}async#g(e,t){let n=this.#a!==void 0||this.#o!==void 0||this.#e.url!==void 0&&this.#i!==void 0,s=this.#o!==void 0?this.#c===e:Wr(this.#c,e,t.bridge.legacyLab);if(n&&s){this.#c=e,await this.#y(t);return}if(n&&await this.close(),this.#c=e,this.#e.url!==void 0){let i=new URL(this.#e.url);if(!["http:","https:"].includes(i.protocol)||i.username||i.password||i.hash)throw new Error("Attached shader URL must be an HTTP(S) URL without credentials or a fragment.");this.#i=i.href,this.#p={seen:true,applied:true,alreadyPresent:false,captureApplied:true,id:"attached-application"},await this.#y(t);return}if(this.#e.serve!==void 0)try{let i=await Gr({root:this.#e.root,runtime:this.#e.runtime,serve:this.#e.serve,...this.#e.headed===void 0?{}:{headed:this.#e.headed}},e,t,this.#r,this.#n);this.#o=i.server,this.#p=i.transform,this.#i=i.baseUrl,await this.#y(t);return}catch(i){throw await this.close(),i}this.#m=Ve(this.#e.runtime.three,{disableTimestampQueries:_.env.THREE_BLOCKS_SOFTWARE_WEBGPU==="1",...t.bridge.legacyLab?{}:{capture:{capture:e==="capture",forceLive:e!=="precompiled",settleFrames:t.settleFrames,settleTimeoutMs:t.settleTimeoutMs??3e4,readiness:t.readiness}}}),this.#h={THREE_BLOCKS_SHADER_TOOL:_.env.THREE_BLOCKS_SHADER_TOOL,THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER:_.env.THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER},_.env.THREE_BLOCKS_SHADER_TOOL="1",_.env.THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER="1";try{let i=await jr(this.#e.root);this.#a=await i({root:this.#e.root,logLevel:"error",plugins:[this.#m.plugin,Lr(this.#r,this.#n,e!=="precompiled",v(this.#e.runtime.three))],server:{host:"127.0.0.1",port:0}}),await this.#a.listen();let a=this.#a.httpServer?.address();if(!a||typeof a=="string")throw new Error("Vite did not expose an ephemeral TCP address.");this.#i=`http://127.0.0.1:${a.port}`,await this.#y(t);}catch(i){throw await this.close(),i}}async capture(e,t){let n=Date.now();if(await this.#g("capture",t),!this.#t||!this.#i)throw new Error("Shader browser driver did not start.");let s=this.#t,i=await this.#s(s,t,()=>s.newContext({viewport:t.viewport}));this.#e.url!==void 0&&await this.#s(s,t,()=>he(i,this.#r,this.#n,"capture",t,v(this.#e.runtime.three)));let a$1=await this.#s(s,t,()=>i.newPage()),o=pe(a$1);this.#n.clear(e.key);let l=this.#r.wait(e.key,t.timeoutMs),h=Promise.race([l,o.first.then(d=>Promise.reject(d))]),p=a(()=>{},"resolveDisconnected"),f=new Promise(d=>{p=d;}),m=a(()=>p(new Error("Shader capture browser disconnected before posting a manifest.")),"onDisconnected");s.on("disconnected",m);try{let d=a$1.goto(We(this.#i,e,{threeBlocksShaderCapture:"1",capture:"1",captureId:e.key,captureFrames:String(Math.max(4,t.settleFrames)),settleFrames:String(t.settleFrames)}),{waitUntil:"domcontentloaded",timeout:t.timeoutMs}),u=await Or(d,Promise.race([h,f.then(b=>Promise.reject(b))]));me(this.#d());let y=[...o.page,...o.console];if(y.length>0)throw new Error(`Capture browser errors:
|
|
91
|
-
- ${y.join(`
|
|
92
|
-
- `)}`);return a$2(u)?{...u,timing:{...a$2(u.timing)?u.timing:{},launch:n,...this.#n.firstRequest(e.key)===void 0?{}:{firstRequest:this.#n.firstRequest(e.key)},posted:Date.now()}}:u}catch(d){let u=d instanceof Error?d:new Error(String(d));this.#r.cancel(e.key,u),await l.catch(()=>{});let y=this.#n.read(e.key);if(u.message.includes("timed out")){let b=await Ke(()=>a$1.evaluate(()=>{let w=globalThis,P=w.__threeBlocksShaderTools,B=P&&typeof P=="object"?P:void 0,M=w.document,k=Reflect.get(w,Symbol.for("three-blocks.shader-capture.cache-value.v1")),R=w.location,N=R!==null&&typeof R=="object"&&typeof Reflect.get(R,"href")=="string"?String(Reflect.get(R,"href")):"http://three-blocks.invalid/",H=new URL(N).searchParams.get("captureId")??"default",z=k!==null&&typeof k=="object"&&typeof Reflect.get(k,"registrations")=="function"?Reflect.apply(Reflect.get(k,"registrations"),k,[H]):void 0;return {documentReadyState:M?.readyState??null,parityTargetFrame:Number(w.__threeBlocksParityTargetFrame??0),parityCompletedFrame:Number(w.__threeBlocksParityCompletedFrame??0),readiness:B?.readiness??null,captureCache:k!==null&&typeof k=="object"?{activeScene:Reflect.get(k,"activeScene")??null,registrations:Array.isArray(z)?z.slice(0,16).map(x=>x!==null&&typeof x=="object"?{key:Reflect.get(x,"key")??null,kind:Reflect.get(x,"kind")??null}:null):null}:null,threeRuntimeResources:performance.getEntriesByType("resource").map(x=>x.name).filter(x=>x.includes("three.webgpu"))}}));throw new Error(`${u.message} Last capture state for "${e.key}": ${JSON.stringify({page:b,telemetry:y??null,transform:this.#d()})}`)}throw u}finally{s.off("disconnected",m),await L(()=>i.close()),this.#u++,(!s.isConnected()||this.#u>=(t.browserRelaunchScenes??8))&&(this.#t===s&&(this.#t=void 0),await L(()=>s.close()),this.#u=0);}}async observe(e,t,n,s){for(let i=0;i<2;i++)try{return await this.#S(e,t,n,s)}catch(a){if(i===0&&Ye(a))continue;throw a}throw new Error(`Shader observation retry was exhausted for scene "${e.key}".`)}async#S(e,t,n,s){if(await this.#g(t,n),!this.#t||!this.#i)throw new Error("Shader browser driver did not start.");let i=this.#t,a=await this.#s(i,n,()=>i.newContext({viewport:n.viewport}));this.#e.url!==void 0&&await this.#s(i,n,()=>he(a,this.#r,this.#n,t,n,v(this.#e.runtime.three)));let o=await this.#s(i,n,()=>a.newPage()),l=pe(o);this.#n.clear(e.key);try{await o.goto(We(this.#i,e,{threeBlocksShaderCapture:"1",threeBlocksShaderMode:t,captureId:e.key,...t==="live"?{precompiled:"0"}:{}}),{waitUntil:"domcontentloaded",timeout:n.timeoutMs}),await Promise.race([o.waitForFunction(n.bridge.legacyLab?"globalThis.__threeBlocks?.compileEnd === true":"globalThis.__threeBlocksShaderTools?.readiness?.compileEnd === true",void 0,{timeout:n.timeoutMs}),l.first.then(u=>Promise.reject(u))]),ee(await re(o,n.bridge.legacyLab),e,n.bridge.legacyLab,this.#d(),v(this.#e.runtime.three)),await Je(o,n,l),await Promise.race([o.waitForFunction(n.bridge.legacyLab?"true":"globalThis.__threeBlocksShaderTools?.readiness?.firstFrame === true",void 0,{timeout:n.timeoutMs}),l.first.then(u=>Promise.reject(u))]),await K(o,n,1);let h=Buffer.from(await o.screenshot({type:"png"})),p=e.parityFrames??n.parity.frames,f=await K(o,n,p,s),m=Buffer.from(await o.screenshot({type:"png"}));e.parityFrames!==void 0&&p<n.parity.frames&&await K(o,n,n.parity.frames-p);let d=ee(await re(o,n.bridge.legacyLab),e,n.bridge.legacyLab,this.#d(),v(this.#e.runtime.three));return this.#f===void 0&&(this.#f=await o.evaluate(async()=>{let u=Reflect.get(navigator,"gpu"),y=typeof u=="object"&&u!==null?Reflect.get(u,"requestAdapter"):void 0,b=typeof y=="function"?await Reflect.apply(y,u,[]):void 0,w=typeof b=="object"&&b!==null?Reflect.get(b,"info"):void 0,P=["description","device","architecture","vendor"].flatMap(B=>{let M=typeof w=="object"&&w!==null?Reflect.get(w,B):void 0;return typeof M=="string"&&M.length>0?[M]:[]});return {adapter:[...new Set(P)].join(" \xB7 ")||"WebGPU adapter",platform:navigator.platform||navigator.userAgent}})),{scene:e.key,mode:t,...d,frame:f,firstFrameScreenshot:h,screenshot:m,errors:[...l.page,...l.console]}}catch(h){let p=h instanceof Error?h:new Error(String(h));if(/(?:timed?\s*out|timeout)/iu.test(p.message)){let f=this.#n.read(e.key),m=await Ke(()=>o.evaluate(()=>{let d=globalThis,u=d.__threeBlocksShaderTools,y=u&&typeof u=="object"?u:void 0;return {documentReadyState:d.document?.readyState??null,parityTargetFrame:Number(d.__threeBlocksParityTargetFrame??0),parityCompletedFrame:Number(d.__threeBlocksParityCompletedFrame??0),readiness:y?.readiness??null,threeRuntimeResources:performance.getEntriesByType("resource").map(w=>w.name).filter(w=>w.includes("three.webgpu"))}}));throw new Error(`${p.message} Last ${t} state for "${e.key}": ${JSON.stringify({page:m,telemetry:f??null})}`)}throw p}finally{await L(()=>a.close());}}async observePublished(e,t){for(let n=0;n<2;n++)try{return await this.#w(e,t)}catch(s){if(n===0&&Ye(s))continue;throw s}throw new Error(`Published shader observation retry was exhausted for scene "${e.key}".`)}async#w(e,t){if(await this.#g("precompiled",t),!this.#t||!this.#i)throw new Error("Shader browser driver did not start.");let n=this.#t,s=await this.#s(n,t,()=>n.newContext({viewport:t.viewport}));this.#e.url!==void 0&&await this.#s(n,t,()=>he(s,this.#r,this.#n,"precompiled",t,v(this.#e.runtime.three)));let i=await this.#s(n,t,()=>s.newPage()),a=pe(i);this.#n.clear(e.key);try{await i.goto(Dr(this.#i,e),{waitUntil:"domcontentloaded",timeout:t.timeoutMs}),await Promise.race([i.waitForFunction(t.bridge.legacyLab?"globalThis.__threeBlocks?.compileEnd === true":"globalThis.__threeBlocksShaderTools?.readiness?.compileEnd === true",void 0,{timeout:t.timeoutMs}),a.first.then(f=>Promise.reject(f))]),await Je(i,t,a),ee(await re(i,t.bridge.legacyLab),e,t.bridge.legacyLab,this.#d(),v(this.#e.runtime.three)),await K(i,t,2);let o=await ze(i),l=await K(i,t,120),h=await ze(i),p=ee(await re(i,t.bridge.legacyLab),e,t.bridge.legacyLab,this.#d(),v(this.#e.runtime.three));return {scene:e.key,mode:"precompiled",...p,frame:l,firstFrameScreenshot:o,beforeScreenshot:o,screenshot:h,errors:[...a.page,...a.console]}}finally{await L(()=>s.close());}}timingEnvironment(){return this.#f??{adapter:"WebGPU adapter",platform:`${_.platform}/${_.arch}`}}async close(){this.#r.rejectAll(new Error("Shader browser driver closed.")),this.#t&&await L(()=>this.#t?.close()??Promise.resolve());let e=this.#a?.httpServer,t=e?Reflect.get(e,"closeAllConnections"):void 0;if(e&&typeof t=="function"&&Reflect.apply(t,e,[]),this.#a&&await L(()=>this.#a?.close()??Promise.resolve()),this.#o){let n=this.#o;n.closeAllConnections(),await L(()=>new Promise(s=>{n.close(()=>s());}));}if(this.#t=void 0,this.#a=void 0,this.#o=void 0,this.#i=void 0,this.#m=void 0,this.#p=void 0,this.#c=void 0,this.#f=void 0,this.#u=0,this.#l!==void 0&&(await rm(this.#l,{recursive:true,force:true}),this.#l=void 0),this.#h){for(let[n,s]of Object.entries(this.#h))s===void 0?delete _.env[n]:_.env[n]=s;this.#h=void 0;}}};function Ut(r){return new J(r)}a(Ut,"createPlaywrightShaderDriver");function Vt(r){return new J(r)}a(Vt,"createStaticPlaywrightShaderDriver");function Gt(r){return new J(r)}a(Gt,"createAttachedPlaywrightShaderDriver");
|
|
93
|
-
export{v as a,I as b,it as c,C as d,st as e,at as f,ot as g,dt as h,ct as i,ut as j,Or as k,Ir as l,Se as m,Wr as n,Ye as o,Ut as p,Vt as q,Gt as r};
|
package/dist/chunk-5X5NS5EW.js
DELETED
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
import {a}from'./chunk-EI7MMDWY.js';import {createHash,randomUUID}from'crypto';import {lstat,open,realpath,mkdir,rename,rm,link,readdir,readFile,unlink}from'fs/promises';import p from'path';import {THREE_WEBGPU_R185_COMPATIBILITY,THREE_R186DEV_VERSION,THREE_WEBGPU_R186DEV_COMPATIBILITY,parsePrecompiledManifest,SHADER_HYDRATION_SCHEMA_VERSION,SHADER_RECIPE_SCHEMA_VERSION,SHADER_ADDRESS_SCHEMA_VERSION,PRECOMPILED_MANIFEST_VERSION}from'three-blocks/shaders';import {createRequire}from'module';import {transformThreeWebgpuProviderHooks,transformThreeWebgpuCaptureInstrumentation}from'three-blocks/vite';var D=/^[a-f0-9]{64}$/,Ye=/^[0-9A-Za-z][0-9A-Za-z.+_-]{0,127}$/,be=/^[a-z0-9][a-z0-9_-]{0,63}$/,we=/^[0-9A-Za-z][0-9A-Za-z._/-]{0,127}$/;function c(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}a(c,"isRecord");function P(e){return typeof e=="string"&&Ye.test(e)}a(P,"isSafeVersion");function Q(e){if(e.length===0||e.length>512||e.includes("\\")||/[\u0000-\u001f\u007f]/.test(e))return false;let r=e.split("/");return !e.startsWith("/")&&r.every(t=>t.length>0&&t!=="."&&t!=="..")}a(Q,"isSafeRelativePath");function Ee(e){if(!c(e)||e.schemaVersion!==2)throw new Error("three-blocks.json must use schemaVersion 2.");if(typeof e.template!="string"||!be.test(e.template))throw new Error("three-blocks.json has an invalid default shader scene key.");if(!Array.isArray(e.layers)||!e.layers.every(r=>typeof r=="string"&&we.test(r))||new Set(e.layers).size!==e.layers.length)throw new Error("three-blocks.json has invalid layers.");if(e.generator!==void 0&&(!c(e.generator)||typeof e.generator.name!="string"||!we.test(e.generator.name)||!P(e.generator.version)))throw new Error("three-blocks.json has invalid generator metadata.");if(!c(e.runtime)||!P(e.runtime.three)||!P(e.runtime.threeBlocks))throw new Error("three-blocks.json has invalid runtime versions.");if(!c(e.features)||typeof e.features.text!="boolean")throw new Error("three-blocks.json has invalid feature metadata.");if(!c(e.protocol)||e.protocol.resultFile!==1)throw new Error("three-blocks.json has an unsupported protocol schema.");if(e.artifacts!==void 0){if(!c(e.artifacts)||typeof e.artifacts.shaders!="string"||!["fresh","pending"].includes(e.artifacts.shaders)||typeof e.artifacts.text!="string"||!["fresh","pending","not-applicable"].includes(e.artifacts.text))throw new Error("three-blocks.json has invalid artifact metadata.");if(e.features.text?e.artifacts.text==="not-applicable":e.artifacts.text!=="not-applicable")throw new Error("three-blocks.json text artifact state does not match the text capability.")}return {schemaVersion:2,template:e.template,layers:e.layers,...e.generator===void 0?{}:{generator:{name:e.generator.name,version:e.generator.version}},runtime:{three:e.runtime.three,threeBlocks:e.runtime.threeBlocks},features:{text:e.features.text},...e.artifacts===void 0?{}:{artifacts:{shaders:e.artifacts.shaders,text:e.artifacts.text}},protocol:{resultFile:1}}}a(Ee,"parseProjectMetadata");function Xe(e){if(!c(e))throw new Error("Shader coverage is missing.");for(let r of ["render","vertex","fragment","compute"])if(typeof e[r]!="number"||!Number.isSafeInteger(e[r])||e[r]<0)throw new Error(`Shader coverage.${r} must be a non-negative integer.`);return e}a(Xe,"parseCoverage");function Ze(e,r){if(!c(e))throw new Error(`Shader receipt inputs for "${r}" are invalid.`);let t=Object.entries(e);if(t.length===0||t.length>4096)throw new Error(`Shader receipt inputs for "${r}" must contain between 1 and 4096 files.`);for(let[n,i]of t)if(!Q(n)||typeof i!="string"||!D.test(i))throw new Error(`Shader receipt input for "${r}" is invalid.`)}a(Ze,"parseInputs");function F(e){if(!c(e)||e.schemaVersion!==2||!c(e.runtime)||!P(e.runtime.three)||!P(e.runtime.threeBlocks)||typeof e.runtime.threeBlocksShaderClosure!="string"||!D.test(e.runtime.threeBlocksShaderClosure)||!c(e.scenes))throw new Error("Shader meta.json does not match receipt schema 2.");if(e.runtime.capture!==void 0&&(!c(e.runtime.capture)||typeof e.runtime.capture.userAgent!="string"||e.runtime.capture.userAgent.length>1024||typeof e.runtime.capture.adapter!="string"||e.runtime.capture.adapter.length>1024||!Array.isArray(e.runtime.capture.features)||e.runtime.capture.features.length>256||!e.runtime.capture.features.every(t=>typeof t=="string"&&t.length>0&&t.length<=128)))throw new Error("Shader meta.json has invalid browser capture provenance.");let r=Object.entries(e.scenes);if(r.length===0)throw new Error("Shader meta.json contains no scenes.");for(let[t,n]of r){if(!be.test(t)||!c(n)||typeof n.artifact!="string"||!Q(n.artifact)||!n.artifact.endsWith(".webgpu.ts")||typeof n.artifactHash!="string"||!D.test(n.artifactHash))throw new Error(`Shader receipt for "${t}" is invalid.`);if(n.asset===void 0!=(n.assetHash===void 0)||n.asset!==void 0&&(typeof n.asset!="string"||!Q(n.asset)||!n.asset.endsWith(".json")||typeof n.assetHash!="string"||!D.test(n.assetHash)))throw new Error(`Shader static asset receipt for "${t}" is invalid.`);if(Ze(n.inputs,t),Xe(n.coverage),n.bytes!==void 0&&(!Number.isSafeInteger(n.bytes)||Number(n.bytes)<0))throw new Error(`Shader receipt byte count for "${t}" is invalid.`);if(n.skipped!==void 0&&(!c(n.skipped)||!Number.isSafeInteger(n.skipped.render)||Number(n.skipped.render)<0||!Number.isSafeInteger(n.skipped.compute)||Number(n.skipped.compute)<0))throw new Error(`Shader receipt skipped-build counts for "${t}" are invalid.`)}if(e.tool!==void 0&&(!c(e.tool)||e.tool.name!=="@three-blocks/devtools"||!P(e.tool.version)||typeof e.tool.compatibility!="string"||!Number.isSafeInteger(e.tool.transform)||!Number.isSafeInteger(e.tool.address)||!Number.isSafeInteger(e.tool.recipe)||!Number.isSafeInteger(e.tool.hydration)))throw new Error("Shader meta.json has invalid tool compatibility metadata.");return e}a(F,"parseShaderReceipt");var _=Object.freeze({metadata:1024*1024,receipt:2*1024*1024,manifest:32*1024*1024,semanticInput:8*1024*1024,semanticTotal:64*1024*1024,metrics:8*1024*1024,texture:128*1024*1024,packageJson:1024*1024});function re(e){return typeof e=="object"&&e!==null&&"code"in e&&typeof e.code=="string"?e.code:void 0}a(re,"errorCode");function R(e){return createHash("sha256").update(e).digest("hex")}a(R,"sha256");async function b(e){try{return await lstat(e),!0}catch(r){if(re(r)==="ENOENT")return false;throw r}}a(b,"pathExists");function M(e,r){let t=p.relative(e,r);return t===""||!p.isAbsolute(t)&&t!==".."&&!t.startsWith(`..${p.sep}`)}a(M,"isWithin");function C(e){return JSON.stringify(e)}a(C,"displayPath");async function Ae(e,r,t){let n=await open(e,"r");try{let[i,o,s]=await Promise.all([lstat(e),n.stat(),realpath(e)]);if(i.isSymbolicLink())throw new Error(`${t} must not be a symbolic link: ${C(e)}.`);if(!o.isFile())throw new Error(`${t} must be a regular file: ${C(e)}.`);if(o.size>r)throw new Error(`${t} exceeds the ${r}-byte inspection limit: ${C(e)}.`);let d=await n.readFile();if(d.byteLength>r)throw new Error(`${t} grew beyond the ${r}-byte inspection limit while being read.`);return {path:s,data:d}}finally{await n.close();}}a(Ae,"readBoundedRegularFile");async function x(e,r){let t=p.dirname(e);await mkdir(t,{recursive:true});try{if((await lstat(e)).isSymbolicLink())throw new Error(`Atomic write target must not be a symbolic link: ${C(e)}.`)}catch(o){if(re(o)!=="ENOENT")throw o}let n=p.join(t,`.${p.basename(e)}.${process.pid}.${randomUUID()}.tmp`),i;try{i=await open(n,"wx",384),await i.writeFile(r),await i.sync(),await i.close(),i=void 0,await rename(n,e);}finally{await i?.close().catch(()=>{}),await rm(n,{force:true});}}a(x,"writeAtomicRegularFile");async function xe(e,r){let t=p.dirname(e);await mkdir(t,{recursive:true});let n=p.join(t,`.${p.basename(e)}.${process.pid}.${randomUUID()}.tmp`),i;try{i=await open(n,"wx",384),await i.writeFile(r),await i.sync(),await i.close(),i=void 0;try{return await link(n,e),!0}catch(o){if(re(o)==="EEXIST")return !1;throw o}}finally{await i?.close().catch(()=>{}),await rm(n,{force:true});}}a(xe,"writeNewRegularFile");async function _r(e,r,t){return Ae(e,r,t)}a(_r,"readExternalRegularFile");async function V(e,r,t){let n=p.resolve(e),i=p.resolve(r);if(!M(n,i))throw new Error(`${t} escapes its allowed directory.`);let o=await lstat(i);if(o.isSymbolicLink())throw new Error(`${t} must not be a symbolic link.`);if(!o.isDirectory())throw new Error(`${t} must be a directory.`);let[s,d]=await Promise.all([realpath(n),realpath(i)]);if(!M(s,d))throw new Error(`${t} resolves outside its allowed directory.`);return d}a(V,"canonicalDirectoryWithin");async function $(e,r,t,n){let i=p.resolve(e),o=p.resolve(r);if(!M(i,o)||i===o)throw new Error(`${n} escapes its allowed directory.`);let s=await Ae(o,t,n),d=await realpath(i);if(!M(d,s.path)||d===s.path)throw new Error(`${n} resolves outside its allowed directory.`);return s}a($,"readRegularFileWithin");async function $r(e,r,t,n=8192){let o=[await V(e,r,"Inspected directory")],s=[],d=0;for(;o.length>0;){let l=o.shift();if(l===void 0)break;let g=(await readdir(l,{withFileTypes:true})).sort((f,y)=>f.name.localeCompare(y.name));for(let f of g){if(d+=1,d>n)throw new Error(`Inspected directory exceeds the ${n}-entry limit.`);let y=p.join(l,f.name);if(f.isSymbolicLink())throw new Error(`Inspected directory contains a symbolic link: ${C(p.relative(e,y))}.`);if(f.isDirectory()){o.push(await V(e,y,"Nested inspected directory"));continue}if(f.isFile()&&t(f.name))s.push(y);else if(t(f.name))throw new Error(`Semantic input is not a regular file: ${C(y)}.`)}}return s.sort()}a($r,"listRegularFilesRecursively");var ne="three-blocks.shaders.json",Lr=".three-blocks/shaders",Vr=".three-blocks/shaders/parity",ir=/^[a-z0-9][a-z0-9_-]{0,63}$/u,or=/^[A-Za-z_$][A-Za-z0-9_$]*(?:\.[A-Za-z_$][A-Za-z0-9_$]*)*$/u,je=64,Pe=64,Ce={schemaVersion:1,scenes:[{key:"default",url:"/"}]};function Me(e,r,t){if(e===void 0)return t;if(typeof e!="string"||e.length===0||e.length>512||p.isAbsolute(e)||/[\u0000-\u001f\u007f]/u.test(e))throw new Error(`${r} must be a bounded project-relative directory.`);let n=p.posix.normalize(e.replaceAll("\\","/")).replace(/\/+$/u,"");if(n==="."||n===".."||n.startsWith("../"))throw new Error(`${r} must stay inside the project.`);return n}a(Me,"safeProjectDirectory");function sr(e,r){let t=Me(e,r,"");if(typeof e!="string"||e.endsWith("/"))throw new Error(`${r} must be a project-relative file.`);return t}a(sr,"safeProjectFile");function A(e,r,t,n,i){if(e===void 0)return i;if(!Number.isSafeInteger(e)||Number(e)<t||Number(e)>n)throw new Error(`${r} must be an integer in ${t}...${n}.`);return Number(e)}a(A,"boundedInteger");function _e(e,r,t){if(e===void 0)return t;if(typeof e!="number"||!Number.isFinite(e)||e<0||e>1)throw new Error(`${r} must be a finite ratio in 0...1.`);return e}a(_e,"finiteRatio");function $e(e,r){if(typeof e!="string"||e.length===0||e.length>2048||/[\u0000-\u001f\u007f]/u.test(e))throw new Error(`${r} must be a bounded project-relative URL.`);let t;try{t=new URL(e,"http://three-blocks.invalid/");}catch{throw new Error(`${r} is not a valid URL.`)}if(t.origin!=="http://three-blocks.invalid"||t.hash.length>0)throw new Error(`${r} must stay within the project and must not contain a fragment.`);return `${t.pathname}${t.search}`}a($e,"safeBrowserUrl");function ar(e){if(!Array.isArray(e)||e.length===0||e.length>je)throw new Error(`Shader config scenes must contain 1...${je} entries.`);let r=new Set;return e.map((t,n)=>{if(!c(t)||typeof t.key!="string"||!ir.test(t.key))throw new Error(`Shader config scene ${n} has an invalid key.`);if(r.has(t.key))throw new Error(`Shader config scene key "${t.key}" is duplicated.`);r.add(t.key);let i=t.parityFrames,o=t.maxDiffRatio;if(t.inputs!==void 0&&(!Array.isArray(t.inputs)||t.inputs.length===0||t.inputs.length>Pe))throw new Error(`Shader config scene "${t.key}" inputs must contain 1...${Pe} files.`);let s=t.inputs===void 0?void 0:t.inputs.map((d,l)=>sr(d,`Shader config scene "${t.key}" input ${l}`));if(s!==void 0&&new Set(s).size!==s.length)throw new Error(`Shader config scene "${t.key}" inputs must be unique.`);if(t.runtimeMotion!==void 0&&typeof t.runtimeMotion!="boolean")throw new Error(`Shader config scene "${t.key}" runtimeMotion must be a boolean.`);return {key:t.key,url:$e(t.url,`Shader config scene "${t.key}" URL`),requiresText:t.requiresText===true,...s===void 0?{}:{inputs:s},...i===void 0?{}:{parityFrames:A(i,`Shader config scene "${t.key}" parityFrames`,0,1e4,0)},...o===void 0?{}:{maxDiffRatio:_e(o,`Shader config scene "${t.key}" maxDiffRatio`,.01)},...t.runtimeMotion===true?{runtimeMotion:true}:{}}})}a(ar,"parseScenes");function v(e){if(!c(e)||e.schemaVersion!==void 0&&e.schemaVersion!==1)throw new Error("Shader config must use schemaVersion 1.");let r=e.viewport;if(r!==void 0&&!c(r))throw new Error("Shader config viewport must be an object.");let t=e.parity;if(t!==void 0&&!c(t))throw new Error("Shader config parity must be an object.");let n=e.bridge;if(n!==void 0&&!c(n))throw new Error("Shader config bridge must be an object.");let i=c(n)?n.deterministicModule:void 0;i!==void 0&&$e(i,"Shader deterministic module");let o=e.readiness;if(o!==void 0&&!c(o))throw new Error("Shader config readiness must be an object.");let s=c(o)?o.selector:void 0;if(s!==void 0&&(typeof s!="string"||s.length===0||s.length>512||/[\u0000-\u001f\u007f]/u.test(s)))throw new Error("Shader readiness selector must be a bounded, non-empty CSS selector.");let d=c(o)?o.global:void 0;if(d!==void 0&&(typeof d!="string"||!or.test(d)))throw new Error("Shader readiness global must be a dot-separated JavaScript property path.");return {schemaVersion:1,scenes:ar(e.scenes),settleFrames:A(e.settleFrames,"Shader settleFrames",0,1e4,60),settleTimeoutMs:A(e.settleTimeoutMs,"Shader settleTimeoutMs",1e3,15*6e4,3e4),browserRelaunchScenes:A(e.browserRelaunchScenes,"Shader browserRelaunchScenes",1,64,8),timeoutMs:A(e.timeoutMs,"Shader timeoutMs",1e3,15*6e4,24e4),viewport:{width:A(c(r)?r.width:void 0,"Shader viewport width",64,8192,1024),height:A(c(r)?r.height:void 0,"Shader viewport height",64,8192,640)},parity:{frames:A(c(t)?t.frames:void 0,"Shader parity frames",0,1e4,90),channelTolerance:A(c(t)?t.channelTolerance:void 0,"Shader parity channelTolerance",0,255,8),maxDiffRatio:_e(c(t)?t.maxDiffRatio:void 0,"Shader parity maxDiffRatio",.01)},bridge:{legacyLab:c(n)&&n.legacyLab===true,...typeof i=="string"?{deterministicModule:i}:{}},readiness:{...typeof s=="string"?{selector:s}:{},...typeof d=="string"?{global:d}:{}},publicDir:Me(e.publicDir,"Shader publicDir","public"),allowLiveBuilds:e.allowLiveBuilds!==false}}a(v,"parseShaderToolConfig");async function Hr(e=process.cwd()){let r=p.resolve(e);for(;;){if(await b(p.join(r,ne))||await b(p.join(r,"three-blocks.json")))return realpath(r);let t=p.join(r,"package.json");if(await b(t)){let i=await $(r,t,_.packageJson,"Project package.json"),o;try{o=JSON.parse(i.data.toString("utf8"));}catch{throw new Error(`Project package.json is not valid JSON: ${t}.`)}if(c(o)&&[o.dependencies,o.devDependencies,o.peerDependencies,o.optionalDependencies].filter(c).some(l=>typeof l.three=="string"||typeof l["three-blocks"]=="string"||typeof l["@three-blocks/devtools"]=="string"))return realpath(r)}let n=p.dirname(r);if(n===r)throw new Error(`No Three Blocks shader project found from ${JSON.stringify(p.resolve(e))}; add Three.js to package.json or pass --root.`);r=n;}}a(Hr,"findShaderProjectRoot");async function te(e){let r=await realpath(e),t=p.join(r,ne);if(await b(t)){let i=await $(r,t,_.metadata,"Shader configuration");return v(JSON.parse(i.data.toString("utf8")))}let n=p.join(r,"three-blocks.json");if(await b(n)){let i=Ee(JSON.parse(await readFile(n,"utf8")));return v({schemaVersion:1,scenes:[{key:i.template,url:"/",requiresText:i.features.text}]})}return v(Ce)}a(te,"loadShaderToolConfig");async function vr(e){let r=await realpath(e);for(let o of ["vite.config.ts","vite.config.mts","vite.config.js","vite.config.mjs","vite.config.cts","vite.config.cjs"])if(await b(p.join(r,o)))return {driverKind:"vite",reason:`Detected ${o}.`};let t,n=p.join(r,"package.json");if(await b(n)){let o=await $(r,n,_.packageJson,"Project package.json"),s=JSON.parse(o.data.toString("utf8"));c(s)&&(t=s);}let i=a(o=>[t?.dependencies,t?.devDependencies,t?.peerDependencies,t?.optionalDependencies].some(s=>c(s)&&typeof s[o]=="string"),"hasDependency");if(i("vite"))return {driverKind:"vite",reason:"Detected the Vite dependency."};for(let o of ["dist","build","out"])if(await b(p.join(r,o,"index.html")))return {driverKind:"static",serve:o,reason:`Detected the built ${o}/index.html application.`};if(i("next"))throw new Error("Detected Next.js without an attach URL. Run `shaders capture` without an explicit driver or URL to preview the withThreeBlocksNext adapter and start a project-local capture server, or pass --url <local-url> for a server you manage.");if(i("webpack")||i("esbuild")||i("rollup"))throw new Error("Detected a non-Vite bundler but no static index.html. Run `shaders capture` without an explicit driver or URL to preview adapter wiring and build the project, or build it yourself and pass --driver static --serve <directory>.");return {driverKind:"vite",reason:"Using the Vite golden-path driver."}}a(vr,"inferShaderCaptureTarget");async function Ur(e){let r=await realpath(e),t=p.join(r,ne);if(await b(t))return {config:await te(r),file:t,created:false};let n=p.join(r,"three-blocks.json");if(await b(n))return {config:await te(r),file:n,created:false};let i=Ce,o=v(i),s=await xe(t,`${JSON.stringify(i,null,2)}
|
|
2
|
-
`);return {config:s?o:await te(r),file:t,created:s}}a(Ur,"ensureShaderToolConfig");function ie(e){if(/^0\.185\./u.test(e))return THREE_WEBGPU_R185_COMPATIBILITY;if(e===THREE_R186DEV_VERSION)return THREE_WEBGPU_R186DEV_COMPATIBILITY;throw new Error(`Three.js ${e} is outside the supported shader compatibility contracts.`)}a(ie,"shaderCompatibilityForThree");var oe="0.1.0";var ue=54,pe="timing.local.json",le="timing.json",fe="parity.json",U=4096,fr=4096;function ae(e,r,t=8192){if(typeof e!="string"||e.length===0||e.length>t||/[\u0000\u007f]/u.test(e))throw new Error(`${r} must be a bounded non-empty string.`);return e}a(ae,"boundedString");function m(e,r,t=true){if(typeof e!="number"||!Number.isFinite(e)||e<0||t&&!Number.isSafeInteger(e))throw new Error(`${r} must be a non-negative ${t?"integer":"finite number"}.`);return e}a(m,"nonNegativeNumber");function mr(e){if(!c(e))throw new Error("Shader capture stats are missing.");let r={buildCalls:m(e.buildCalls,"capture stats.buildCalls"),renderBuilds:m(e.renderBuilds,"capture stats.renderBuilds"),computeBuilds:m(e.computeBuilds,"capture stats.computeBuilds"),registeredBuilds:m(e.registeredBuilds,"capture stats.registeredBuilds"),registeredRenderBuilds:m(e.registeredRenderBuilds,"capture stats.registeredRenderBuilds"),registeredComputeBuilds:m(e.registeredComputeBuilds,"capture stats.registeredComputeBuilds"),buildMs:m(e.buildMs,"capture stats.buildMs",false),syncBuildMs:m(e.syncBuildMs,"capture stats.syncBuildMs",false),asyncBuildElapsedMs:m(e.asyncBuildElapsedMs,"capture stats.asyncBuildElapsedMs",false),precompiledSetupMs:m(e.precompiledSetupMs,"capture stats.precompiledSetupMs",false),maxSyncBuildMs:m(e.maxSyncBuildMs??e.syncBuildMs,"capture stats.maxSyncBuildMs",false),maxPrecompiledSetupMs:m(e.maxPrecompiledSetupMs??e.precompiledSetupMs,"capture stats.maxPrecompiledSetupMs",false),hydrationMs:m(e.hydrationMs??0,"capture stats.hydrationMs",false),maxHydrationMs:m(e.maxHydrationMs??e.hydrationMs??0,"capture stats.maxHydrationMs",false),injected:m(e.injected,"capture stats.injected"),injectedRender:m(e.injectedRender,"capture stats.injectedRender"),injectedCompute:m(e.injectedCompute,"capture stats.injectedCompute"),missed:m(e.missed,"capture stats.missed"),missedRender:m(e.missedRender,"capture stats.missedRender"),missedCompute:m(e.missedCompute,"capture stats.missedCompute"),...Array.isArray(e.missedKeys)&&e.missedKeys.every(t=>typeof t=="string")?{missedKeys:e.missedKeys.slice(0,U)}:{}};if(r.renderBuilds+r.computeBuilds!==r.buildCalls||r.registeredRenderBuilds+r.registeredComputeBuilds!==r.registeredBuilds||r.injectedRender+r.injectedCompute!==r.injected||r.missedRender+r.missedCompute!==r.missed||r.registeredBuilds>r.buildCalls||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(mr,"captureStats");function hr(e){if(!Array.isArray(e)||e.length>U)throw new Error("Shader capture skipped builds are invalid.");return e.map((r,t)=>{if(!c(r)||r.kind!=="render"&&r.kind!=="compute")throw new Error(`Shader capture skipped build ${t} is invalid.`);return {kind:r.kind,name:ae(r.name,`skipped build ${t} name`,512),reason:ae(r.reason,`skipped build ${t} reason`)}})}a(hr,"skippedBuilds");function yr(e){let r=0,t=0,n=0,i=0;for(let o of Object.values(e.entries)){let s=e.states[o];s!==void 0&&((s.vertex!==null||s.fragment!==null)&&r++,s.vertex!==null&&t++,s.fragment!==null&&n++,s.compute!==null&&i++);}return {render:r,vertex:t,fragment:n,compute:i}}a(yr,"shaderCoverage");function ot(e,r){if(!c(e))throw new Error("Shader capture payload must be an object.");if(e.scene!==r.scene)throw new Error(`Shader capture scene does not match "${r.scene}".`);if(e.protocolVersion!==2)throw new Error("Shader capture protocolVersion must be 2.");let t=ie(r.runtime.three);if(e.compatibility!==t)throw new Error(`Shader capture compatibility must be "${t}".`);if(!c(e.entries))throw new Error("Shader capture entries must be an object.");if(typeof e.requiresSetup!="boolean")throw new Error("Shader capture requiresSetup must be boolean.");let n=Object.keys(e.entries).length;if(n===0||n>U)throw new Error(`Shader capture must contain 1...${U} entries.`);if(!Array.isArray(e.errors)||e.errors.length>fr)throw new Error("Shader capture errors are invalid.");let i=e.errors.map((h,u)=>ae(h,`capture error ${u}`,64*1024));if(i.length>0)throw new Error(`Shader capture failed:
|
|
3
|
-
- ${i.join(`
|
|
4
|
-
- `)}`);let o=hr(e.skipped),s=mr(e.stats),d=c(e.timing)?e.timing:void 0,l=d===void 0?void 0:Object.fromEntries(["launch","firstRequest","readiness","lastBuild","settled","posted"].flatMap(h=>{let u=d[h];if(u===void 0)return [];if(typeof u!="number"||!Number.isFinite(u)||u<0)throw new Error(`Shader capture timing.${h} is invalid.`);return [[h,u]]})),g;if(e.provenance!==void 0){if(!c(e.provenance)||typeof e.provenance.userAgent!="string"||e.provenance.userAgent.length>1024||typeof e.provenance.adapter!="string"||e.provenance.adapter.length>1024||!Array.isArray(e.provenance.features)||e.provenance.features.length>256||!e.provenance.features.every(h=>typeof h=="string"&&h.length<=128))throw new Error("Shader capture provenance is invalid.");g={userAgent:e.provenance.userAgent,adapter:e.provenance.adapter,features:[...new Set(e.provenance.features)].sort()};}let f=parsePrecompiledManifest({version:PRECOMPILED_MANIFEST_VERSION,scene:r.scene,three:r.runtime.three,threeBlocks:r.runtime.threeBlocks,runtime:{id:t,address:SHADER_ADDRESS_SCHEMA_VERSION,recipe:SHADER_RECIPE_SCHEMA_VERSION,hydration:SHADER_HYDRATION_SCHEMA_VERSION},...e.automatic===void 0?{}:{automatic:e.automatic},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}),y=yr(f);if(s.registeredRenderBuilds<y.render||s.registeredComputeBuilds<y.compute)throw new Error("Shader capture did not live-build every distinct registered render/compute entry.");return {scene:r.scene,manifest:f,skipped:o,stats:s,coverage:y,...l===void 0?{}:{timing:l},...g===void 0?{}:{provenance:g}}}a(ot,"validateShaderCapture");function T(e,r=0){let t=" ".repeat(r),n=" ".repeat(r+1);if(Array.isArray(e))return e.length===0?"[]":e.every(o=>o===null||["number","string","boolean"].includes(typeof o))?JSON.stringify(e):`[
|
|
5
|
-
${e.map(o=>`${n}${T(o,r+1)}`).join(`,
|
|
6
|
-
`)}
|
|
7
|
-
${t}]`;if(e!==null&&typeof e=="object"){let o=e,s=Object.keys(o).sort();return s.length===0?"{}":`{
|
|
8
|
-
${s.map(d=>{let l=o[d];return `${n}${JSON.stringify(d)}: ${T(l,r+1)}`}).join(`,
|
|
9
|
-
`)}
|
|
10
|
-
${t}}`}let i=JSON.stringify(e);if(i===void 0)throw new Error("Shader artifact contains a non-serializable value.");return i}a(T,"stableStringify");function gr(e){return ["// GENERATED FILE \u2014 do not edit by hand.","// Produced by @three-blocks/devtools.","import type { PrecompiledManifest } from 'three-blocks/shaders';","",`export default ${T(e)} satisfies PrecompiledManifest;`,""].join(`
|
|
11
|
-
`)}a(gr,"serializeShaderManifest");function Be(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(Be,"timingLabel");function de(e){if(!c(e)||e.schemaVersion!==3||e.source!=="latest-local-capture"&&e.source!=="committed-capture"||typeof e.receiptHash!="string"||!/^[a-f0-9]{64}$/u.test(e.receiptHash)||typeof e.measuredAt!="string"||!Number.isFinite(Date.parse(e.measuredAt))||!c(e.scenes))throw new Error("Shader timing is invalid.");let r={};for(let[n,i]of Object.entries(e.scenes)){if(n.length===0||n.length>128||!c(i))throw new Error("Shader timing scene is invalid.");let o={builds:m(i.builds,`timing ${n}.builds`),setupMeasured:i.setupMeasured===true,liveBuildMs:m(i.liveBuildMs,`timing ${n}.liveBuildMs`,false),precompiledBuildMs:m(i.precompiledBuildMs,`timing ${n}.precompiledBuildMs`,false),avoidedBuildMs:m(i.avoidedBuildMs,`timing ${n}.avoidedBuildMs`,false),runs:m(i.runs,`timing ${n}.runs`),spreadMs:m(i.spreadMs,`timing ${n}.spreadMs`,false)};if(o.runs<1)throw new Error(`Shader timing runs are invalid for scene "${n}".`);if(Math.abs(o.avoidedBuildMs-Math.max(0,o.liveBuildMs-o.precompiledBuildMs))>.001)throw new Error(`Shader timing delta is inconsistent for scene "${n}".`);r[n]=o;}if(Object.keys(r).length===0)throw new Error("Shader timing contains no scenes.");let t={schemaVersion:3,receiptHash:e.receiptHash,measuredAt:e.measuredAt,scenes:r};return e.source==="latest-local-capture"?{...t,source:"latest-local-capture"}:{...t,source:"committed-capture",adapter:Be(e.adapter,"Shader timing adapter"),platform:Be(e.platform,"Shader timing platform")}}a(de,"parseShaderTiming");function W(e){return /^[a-z0-9][a-z0-9_-]{0,63}$/u.test(e)}a(W,"validParityScene");function Oe(e){return typeof e=="string"&&Number.isFinite(Date.parse(e))}a(Oe,"validParityTimestamp");function me(e){if(!c(e))throw new Error("Shader parity evidence is invalid.");if(e.schemaVersion===1){if(typeof e.receiptHash!="string"||!/^[a-f0-9]{64}$/u.test(e.receiptHash)||!Oe(e.verifiedAt)||!Array.isArray(e.scenes)||e.scenes.length===0||e.scenes.length>64||!e.scenes.every(n=>typeof n=="string"&&W(n)))throw new Error("Shader parity evidence is invalid.");return {schemaVersion:1,receiptHash:e.receiptHash,verifiedAt:e.verifiedAt,scenes:[...new Set(e.scenes)].sort()}}if(e.schemaVersion!==2||!c(e.scenes))throw new Error("Shader parity evidence is invalid.");let r=Object.entries(e.scenes);if(r.length===0||r.length>64)throw new Error("Shader parity evidence is invalid.");let t={};for(let[n,i]of r.sort(([o],[s])=>o.localeCompare(s))){if(!W(n)||!c(i)||typeof i.fingerprint!="string"||!/^[a-f0-9]{64}$/u.test(i.fingerprint)||!Oe(i.verifiedAt))throw new Error("Shader parity evidence is invalid.");t[n]={fingerprint:i.fingerprint,verifiedAt:i.verifiedAt};}return {schemaVersion:2,scenes:t}}a(me,"parseShaderParityEvidence");function ce(e,r){let t=e.scenes[r];if(t===void 0)throw new Error(`Shader receipt has no scene "${r}" for parity evidence.`);return R(T({runtime:{three:e.runtime.three,threeBlocks:e.runtime.threeBlocks,threeBlocksShaderClosure:e.runtime.threeBlocksShaderClosure},...e.tool===void 0?{}:{tool:e.tool},scene:t}))}a(ce,"shaderSceneParityFingerprint");async function z(e,r,t,n){let i=p.join(e,t);try{if(!await b(i))return;let o=await lstat(i);if(o.isSymbolicLink()||!o.isFile()||o.size>1024*1024)return;let s=de(JSON.parse(await readFile(i,"utf8")));return s.source===n&&s.receiptHash===R(r)?s:void 0}catch{return}}a(z,"readShaderTimingFile");async function st(e,r){let t=await z(e,r,pe,"latest-local-capture");return t?.source==="latest-local-capture"?t:void 0}a(st,"readShaderLocalTiming");async function at(e,r){return await z(e,r,pe,"latest-local-capture")??await z(e,r,le,"committed-capture")}a(at,"readShaderTiming");async function He(e,r){let t=p.join(e,fe);try{if(!await b(t))return;let n=await lstat(t);if(n.isSymbolicLink()||!n.isFile()||n.size>1024*1024)return;let i=me(JSON.parse(await readFile(t,"utf8"))),o=F(JSON.parse(Buffer.from(r).toString("utf8"))),s={};if(i.schemaVersion===1){if(i.receiptHash!==R(r))return;for(let d of i.scenes)o.scenes[d]!==void 0&&(s[d]={fingerprint:ce(o,d),verifiedAt:i.verifiedAt});}else for(let[d,l]of Object.entries(i.scenes))o.scenes[d]===void 0||l.fingerprint!==ce(o,d)||(s[d]=l);return Object.keys(s).length===0?void 0:{schemaVersion:2,scenes:s}}catch{return}}a(He,"readShaderParityEvidence");async function dt(e,r){let t=await z(e,r,le,"committed-capture");return t?.source==="committed-capture"?t:void 0}a(dt,"readShaderCommittedTiming");async function ve(e,r,t){let n=await G(e),i=p.join(n,"meta.json"),o=await lstat(i);if(o.isSymbolicLink()||!o.isFile())throw new Error("Shader receipt must be a regular file before timing.");let s=await readFile(i),d=new Date().toISOString(),l=Object.fromEntries(Object.entries(r).sort(([y],[h])=>y.localeCompare(h))),g=de({schemaVersion:3,receiptHash:R(s),measuredAt:d,source:"latest-local-capture",scenes:l});if(await x(p.join(n,pe),`${T(g)}
|
|
12
|
-
`),t===void 0)return {local:g};let f=de({schemaVersion:3,receiptHash:R(s),measuredAt:d,source:"committed-capture",adapter:t.adapter,platform:t.platform,scenes:l});return await x(p.join(n,le),`${T(f)}
|
|
13
|
-
`),{local:g,committed:f}}a(ve,"writeShaderTimings");async function ct(e,r){return (await ve(e,r)).local}a(ct,"writeShaderLocalTiming");async function ut(e,r,t){if(r.length===0||r.length>64||r.some(h=>!W(h)))throw new Error("Shader parity evidence must contain 1...64 valid scene keys.");let n=await G(e),i=p.join(n,"meta.json"),o=await lstat(i);if(o.isSymbolicLink()||!o.isFile())throw new Error("Shader receipt must be a regular file before parity evidence.");let s=await readFile(i);if(t!==void 0&&R(s)!==R(t))throw new Error("Shader receipt changed during browser parity verification; completed observations were not attached to the new receipt.");let d=F(JSON.parse(s.toString("utf8"))),l=await He(n,s),g=new Date().toISOString(),f={...l?.scenes};for(let h of [...new Set(r)].sort())f[h]={fingerprint:ce(d,h),verifiedAt:g};let y=me({schemaVersion:2,scenes:f});return await x(p.join(n,fe),`${T(y)}
|
|
14
|
-
`),y}a(ut,"writeShaderParityEvidence");async function pt(e,r,t){if(r.length===0||r.length>64||r.some(f=>!W(f)))throw new Error("Shader parity invalidation must contain 1...64 valid scene keys.");let n=await G(e),i=await readFile(p.join(n,"meta.json"));if(R(i)!==R(t))throw new Error("Shader receipt changed before prior parity evidence could be invalidated.");let o=await He(n,i);if(o===void 0)return;let s=new Set(r),d=Object.fromEntries(Object.entries(o.scenes).filter(([f])=>!s.has(f))),l=p.join(n,fe);if(Object.keys(d).length===0){await unlink(l).catch(f=>{if(!c(f)||f.code!=="ENOENT")throw f});return}let g=me({schemaVersion:2,scenes:d});await x(l,`${T(g)}
|
|
15
|
-
`);}a(pt,"removeShaderParityEvidence");async function lt(e,r,t){let n=await ve(e,r,t);if(n.committed===void 0)throw new Error("Committed shader timing was not written.");return {local:n.local,committed:n.committed}}a(lt,"writeShaderTimingTwins");async function Ne(e){if(!await b(e)){await mkdir(e);return}let r=await lstat(e);if(r.isSymbolicLink()||!r.isDirectory())throw new Error(`Shader artifact path is not a real directory: ${e}.`)}a(Ne,"assertDirectory");async function G(e){let r=p.resolve(e),t=p.join(r,".three-blocks");await Ne(t);let n=p.join(t,"shaders");return await Ne(n),n}a(G,"artifactRoot");async function ft(e){let r=await G(e.root),t=ie(e.runtime.three),n=p.resolve(e.root),i=p.resolve(n,e.publicDirectory??"public");if(!M(n,i)||i===n)throw new Error("Shader public directory must stay inside the project root.");let o=p.join(i,"three-blocks","shaders");await mkdir(o,{recursive:true}),await V(n,o,"Shader static-asset directory");let s={},d=[];for(let u of [...e.scenes].sort((k,I)=>k.key.localeCompare(I.key))){let k=e.captures.get(u.key),I=e.inputs.get(u.key);if(I===void 0)throw new Error(`Shader input matrix is missing scene "${u.key}".`);if(k===void 0){let S=e.previousReceipt?.scenes[u.key];if(S===void 0)throw new Error(`Capture matrix is missing scene "${u.key}".`);let X=await readFile(p.join(r,S.artifact));if(R(X)!==S.artifactHash)throw new Error(`Preserved shader artifact checksum differs for scene "${u.key}".`);if(S.asset!==void 0&&S.assetHash!==void 0){let Z=await readFile(p.join(i,S.asset));if(R(Z)!==S.assetHash)throw new Error(`Preserved static shader manifest checksum differs for scene "${u.key}".`)}s[u.key]={...S,inputs:Object.fromEntries(Object.entries(I).sort(([Z],[Ke])=>Z.localeCompare(Ke)))},d.push(S.artifact),S.asset!==void 0&&d.push(p.relative(n,p.join(i,S.asset)).split(p.sep).join("/"));continue}if(k.scene!==u.key||k.manifest.scene!==u.key)throw new Error(`Capture matrix scene "${u.key}" is inconsistent.`);let q=`${u.key}.webgpu.ts`,K=gr(k.manifest);await x(p.join(r,q),K),d.push(q);let Y=`three-blocks/shaders/${u.key}.json`,ge=`${T(k.manifest)}
|
|
16
|
-
`;await x(p.join(i,Y),ge),d.push(p.relative(n,p.join(i,Y)).split(p.sep).join("/"));let Se=k.skipped.filter(S=>S.kind==="render").length,qe=k.skipped.length-Se;s[u.key]={artifact:q,artifactHash:R(K),asset:Y,assetHash:R(ge),inputs:Object.fromEntries(Object.entries(I).sort(([S],[X])=>S.localeCompare(X))),coverage:k.coverage,bytes:Buffer.byteLength(K),skipped:{render:Se,compute:qe}};}let l=[...e.captures.values()].find(u=>u.provenance!==void 0)?.provenance??e.previousReceipt?.runtime.capture,g={schemaVersion:2,runtime:{...e.runtime,...l===void 0?{}:{capture:l}},tool:{name:"@three-blocks/devtools",version:oe,compatibility:t,transform:ue,address:SHADER_ADDRESS_SCHEMA_VERSION,recipe:SHADER_RECIPE_SCHEMA_VERSION,hydration:SHADER_HYDRATION_SCHEMA_VERSION},scenes:s},f=new Set(d);for(let u of await readdir(r,{withFileTypes:true}))if(!(!u.name.endsWith(".webgpu.ts")||f.has(u.name))){if(u.isSymbolicLink()||!u.isFile())throw new Error(`Orphan shader artifact is not a regular file: ${u.name}.`);await unlink(p.join(r,u.name));}let y=new Set(e.scenes.map(u=>`${u.key}.json`)),h=new Set(Object.values(e.previousReceipt?.scenes??{}).map(u=>u.asset===void 0?void 0:p.posix.basename(u.asset)).filter(u=>u!==void 0));try{let u=F(JSON.parse(await readFile(p.join(r,"meta.json"),"utf8")));for(let k of Object.values(u.scenes))k.asset!==void 0&&h.add(p.posix.basename(k.asset));}catch{}for(let u of await readdir(o,{withFileTypes:true}))if(!(!u.name.endsWith(".json")||y.has(u.name))&&h.has(u.name)){if(u.isSymbolicLink()||!u.isFile())throw new Error(`Orphan shader static asset is not a regular file: ${u.name}.`);await unlink(p.join(o,u.name));}return await x(p.join(r,"meta.json"),`${T(g)}
|
|
17
|
-
`),d.push("meta.json"),{directory:r,receipt:g,files:d}}a(ft,"writeShaderArtifacts");var N;async function J(){N===void 0&&(N=(async()=>{let r=createRequire(p.join(process.cwd(),"package.json")).resolve("@three-blocks/devtools/browser/shader-capture"),t=p.resolve(p.dirname(r),"../..");return (await $(t,r,_.metadata,"Shader capture browser runtime")).data.toString("utf8")})());let e=N;try{return await e}catch(r){throw N===e&&(N=void 0),r}}a(J,"loadShaderCaptureRuntimeSource");var Ue="virtual:three-blocks-shader-capture-client",We="\0three-blocks:shader-capture-client",ye="virtual:three-blocks-shader-capture-runtime",ze="\0three-blocks:shader-capture-runtime";async function jt(){let e=await J(),r=e.replace(/\bexport\{[^{}]*\};?\s*$/u,"");if(r===e)throw new Error("Shader capture browser runtime no longer has the expected final ESM export list.");return r}a(jt,"loadShaderCaptureRuntimeScriptSource");function Rr(e){let r=e.split("?",1)[0];return r===void 0?false:r.split(p.sep).join("/").endsWith("/build/three.webgpu.js")}a(Rr,"isThreeWebGPUModule");function Je(e){let r=/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/u.exec(e);return r?.[1]==="0"&&r[2]==="185"}a(Je,"supportedVersion");function kr(e,r,t={}){if(!Je(r))throw new Error(`Shader provider transform ${THREE_WEBGPU_R185_COMPATIBILITY} supports Three.js 0.185.x; received "${r}".`);let n=transformThreeWebgpuProviderHooks(e,{threeVersion:r,...t.threeRevision===void 0?{}:{threeRevision:t.threeRevision},id:"three/build/three.webgpu.js"}),i=n.state==="already-applied",o=n.code;return t.instrumentCapture&&(o=transformThreeWebgpuCaptureInstrumentation(o,{...t.captureRuntimeImport===void 0?{}:{runtimeImport:t.captureRuntimeImport}}).code),{code:o,alreadyPresent:i,captureApplied:t.instrumentCapture===true}}a(kr,"applyShaderProviderTransform");var Tr=/this\.trackTimestamp\s*=\s*\(\s*parameters\.trackTimestamp\s*===\s*true\s*\);/gu,Ar="Object.defineProperty( this, 'trackTimestamp', { get: () => false, set: () => {} } );";function Pt(e,r={}){if(!Je(e))throw new Error(`Shader provider transform ${THREE_WEBGPU_R185_COMPATIBILITY} supports Three.js 0.185.x; received "${e}".`);let t={seen:false,applied:false,alreadyPresent:false};return {plugin:{name:"three-blocks:shader-provider-transform",enforce:"pre",config(){return {optimizeDeps:{exclude:["three","three/webgpu","three/tsl"]},resolve:{dedupe:["three"]}}},resolveId(i){return r.capture&&i===Ue?We:r.capture&&i===ye?ze:null},async load(i){return r.capture?i===ze?J():i===We?[`export * from '${ye}';`,`import { configureThreeBlocksShaderCapture } from '${ye}';`,`configureThreeBlocksShaderCapture( ${JSON.stringify({capture:r.capture.capture,forceLive:r.capture.forceLive,settleFrames:r.capture.settleFrames,settleTimeoutMs:r.capture.settleTimeoutMs,visibilityGuard:r.capture.visibilityGuard,captureId:r.capture.captureId,sessionKey:r.capture.sessionKey,token:r.capture.token,readiness:r.capture.readiness??{},transform:ue})} );`].join(`
|
|
18
|
-
`):null:null},transform(i,o){if(!Rr(o))return null;t.seen=true,t.id=o;try{let s=kr(i,e,{instrumentCapture:r.capture!==void 0,...r.capture!==void 0?{captureRuntimeImport:Ue}:{}}),d=r.disableTimestampQueries===!0?s.code.replace(Tr,Ar):s.code;if(r.disableTimestampQueries===!0&&d===s.code)throw new Error("Three.js timestamp tracking anchor drifted; refusing software WebGPU capture.");return t.applied=!0,t.alreadyPresent=s.alreadyPresent,t.captureApplied=s.captureApplied,d===i?null:{code:d,map:null}}catch(s){throw t.error=s instanceof Error?s.message:String(s),s}}},status:t}}a(Pt,"createShaderProviderTransform");function Ct(e){if(e.error)throw new Error(e.error);if(!e.seen||!e.applied)throw new Error(`The version-gated shader provider transform was not applied (${e.seen?"module seen":"three/webgpu not seen"}).`)}a(Ct,"assertShaderProviderTransform");export{fe as A,yr as B,ot as C,T as D,gr as E,st as F,at as G,He as H,dt as I,ct as J,ut as K,pt as L,lt as M,ft as N,J as O,Ue as P,jt as Q,Rr as R,kr as S,Pt as T,Ct as U,c as a,Ee as b,F as c,_ as d,re as e,R as f,b as g,M as h,x as i,_r as j,V as k,$ as l,$r as m,ne as n,Lr as o,Vr as p,v as q,Hr as r,te as s,vr as t,Ur as u,ie as v,oe as w,ue as x,pe as y,le as z};
|
package/dist/chunk-J6OESAZM.js
DELETED
|
@@ -1,76 +0,0 @@
|
|
|
1
|
-
import {d,a as a$1,T,v,U,x as x$1,Q,m,l,h,g,O as O$1}from'./chunk-5X5NS5EW.js';import {a}from'./chunk-EI7MMDWY.js';import b from'process';import {createServer}from'http';import {createRequire}from'module';import {mkdtemp,rm,lstat,realpath}from'fs/promises';import k from'path';import {tmpdir}from'os';import {pathToFileURL}from'url';var ve=Object.freeze([{id:"three-inspector-invalid-json",pattern:/is not valid JSON/iu},{id:"chromium-webgpu-experimental",pattern:/WebGPU is experimental/iu}]);function We(r){return ve.some(e=>e.pattern.test(r))}a(We,"isDocumentedBrowserNoise");function ee(r=b.env,e=b.platform){let t=r.THREE_BLOCKS_WEBGPU_BROWSER_ARGS?.split(/\s+/u).filter(Boolean);if(t&&t.length>0)return t;let n=["--enable-unsafe-webgpu"];return e==="darwin"&&n.push("--enable-gpu","--use-angle=metal"),e==="linux"&&n.push("--enable-features=Vulkan","--disable-vulkan-surface","--ignore-gpu-blocklist","--disable-gpu-driver-bug-workarounds","--disable-gpu-watchdog"),n}a(ee,"webgpuBrowserArgs");function te(r=false,e=b.env){return r!==true&&e.THREE_BLOCKS_SOFTWARE_WEBGPU!=="1"}a(te,"webgpuBrowserHeadless");var re="three-blocks.shader-capture.runtime.v1";var ce="/__three-blocks/shaders/capture",N="/__three-blocks/shaders/telemetry",ue="/__three-blocks/shaders/runtime.js",he="/__three-blocks/shaders/bootstrap.js",me="/__three-blocks/shaders/bridge.js",fe=d.manifest*2,W=/^[a-z0-9][a-z0-9_-]{0,63}$/u,pe=64,we=2e3,Be=[/is not valid JSON/iu,/WebGPU is experimental/iu];async function xe(){try{return (await import('playwright')).chromium}catch(r){throw new Error('Shader browser work requires the optional "playwright" package. Install it in the project and run `npx playwright install chromium`.',{cause:r})}}a(xe,"loadChromium");async function Oe(r){let e;try{e=createRequire(k.join(r,"package.json")).resolve("vite");}catch(n){throw new Error("Shader capture requires Vite in the target project.",{cause:n})}let t=await import(pathToFileURL(e).href);if(typeof t.createServer!="function")throw new Error(`The target project's Vite entry does not export createServer(): ${e}`);return t.createServer}a(Oe,"loadProjectCreateServer");var q=class{static{a(this,"CaptureInbox");}#e=new Map;#t=new Map;wait(e,t){let n=this.#t.get(e);if(n!==void 0)return this.#t.delete(e),Promise.resolve(n);if(this.#e.has(e))throw new Error(`A shader capture is already waiting for scene "${e}".`);return new Promise((o,s)=>{let i=setTimeout(()=>{this.#e.delete(e),s(new Error(`Shader capture "${e}" timed out after ${t}ms.`));},t);this.#e.set(e,{resolve:o,reject:s,timer:i});})}receive(e){if(!a$1(e)||typeof e.scene!="string"||!W.test(e.scene))throw new Error("Capture POST has no safe scene key.");if(!this.#t.has(e.scene)&&!this.#e.has(e.scene)&&this.#t.size>=pe)throw new Error("Capture POST exceeds the scene inbox limit.");let t=this.#e.get(e.scene);t?(clearTimeout(t.timer),this.#e.delete(e.scene),t.resolve(e)):this.#t.set(e.scene,e);}cancel(e,t){let n=this.#e.get(e);n&&(clearTimeout(n.timer),this.#e.delete(e),n.reject(t));}rejectAll(e){for(let t of this.#e.values())clearTimeout(t.timer),t.reject(e);this.#e.clear(),this.#t.clear();}};async function Me(r,e){let t=await Promise.race([e.then(n=>({kind:"capture",value:n})),r.then(()=>({kind:"navigation"}))]);return t.kind==="capture"?t.value:e}a(Me,"waitForShaderCaptureAcrossNavigation");var G=class{static{a(this,"TelemetryHub");}#e=new Map;#t=new Map;markFirstRequest(e){W.test(e)&&!this.#t.has(e)&&this.#t.set(e,Date.now());}firstRequest(e){return this.#t.get(e)}receive(e){if(!a$1(e)||typeof e.scene!="string"||!W.test(e.scene))throw new Error("Shader telemetry has no bounded scene key.");if(!this.#e.has(e.scene)&&this.#e.size>=pe)throw new Error("Shader telemetry exceeds the scene limit.");this.#e.set(e.scene,e);}read(e){return this.#e.get(e)}clear(e){this.#e.delete(e),this.#t.delete(e);}},je=a(async(r,e,t,n,o)=>{let s=0;for(;r.__threeBlocksParityUsesAnimationLoop!==true&&s<e;)await n(),s+=1;if(r.__threeBlocksParityUsesAnimationLoop===true){let i=Number(r.__threeBlocksParityCompletedFrame||0),a=Number(t),c=Number.isSafeInteger(a)&&a>=i?a:i+e;for(r.__threeBlocksParityTargetFrame=c;Number(r.__threeBlocksParityCompletedFrame||0)<c;)await n();}return await o(),Number(r.__threeBlocksParityCompletedFrame||0)},"settleShaderParityFrames");function J(r){return `(() => {
|
|
2
|
-
const root = globalThis;
|
|
3
|
-
const scene = new URL(location.href).searchParams.get('captureId')
|
|
4
|
-
|| 'default';
|
|
5
|
-
const randomSeed = (value) => {
|
|
6
|
-
let state = 2166136261;
|
|
7
|
-
for (let index = 0; index < value.length; index++) state = Math.imul(state ^ value.charCodeAt(index), 16777619) >>> 0;
|
|
8
|
-
return state === 0 ? 0x9e3779b9 : state;
|
|
9
|
-
};
|
|
10
|
-
const advanceRandom = (state) => {
|
|
11
|
-
state ^= state << 13;
|
|
12
|
-
state ^= state >>> 17;
|
|
13
|
-
state ^= state << 5;
|
|
14
|
-
return state >>> 0;
|
|
15
|
-
};
|
|
16
|
-
const parityMode = new URL(location.href).searchParams.get('threeBlocksShaderMode');
|
|
17
|
-
if (parityMode === 'live' || parityMode === 'precompiled') {
|
|
18
|
-
root.__threeBlocksParityEpoch = 1700000000000;
|
|
19
|
-
root.__threeBlocksParityTime = 0;
|
|
20
|
-
Date.now = () => root.__threeBlocksParityEpoch + Number(root.__threeBlocksParityTime || 0);
|
|
21
|
-
}
|
|
22
|
-
const randomStreams = new Map();
|
|
23
|
-
Math.random = () => {
|
|
24
|
-
const stackLine = String(new Error().stack || '').split('\\n')[2] || 'unknown';
|
|
25
|
-
const originIndex = stackLine.indexOf(location.origin);
|
|
26
|
-
const callsite = (originIndex >= 0 ? stackLine.slice(0, originIndex) : stackLine).trim() || 'anonymous';
|
|
27
|
-
const next = advanceRandom(randomStreams.get(callsite) ?? randomSeed(scene + '|' + callsite));
|
|
28
|
-
randomStreams.set(callsite, next);
|
|
29
|
-
return next / 4294967296;
|
|
30
|
-
};
|
|
31
|
-
const readiness = { workerReady: false, assetsReady: false, textReady: false, compileEnd: false, firstFrame: false };
|
|
32
|
-
const stats = { buildCalls: 0, renderBuilds: 0, computeBuilds: 0, registeredBuilds: 0, registeredRenderBuilds: 0, registeredComputeBuilds: 0, buildMs: 0, syncBuildMs: 0, asyncBuildElapsedMs: 0, precompiledSetupMs: 0, maxSyncBuildMs: 0, maxPrecompiledSetupMs: 0, hydrationMs: 0, maxHydrationMs: 0, injected: 0, injectedRender: 0, injectedCompute: 0, missed: 0, missedRender: 0, missedCompute: 0, missedKeys: [] };
|
|
33
|
-
const settleParityFrames = ${je.toString()};
|
|
34
|
-
const settle = (frames, requestedTarget) => settleParityFrames(
|
|
35
|
-
root,
|
|
36
|
-
frames,
|
|
37
|
-
requestedTarget,
|
|
38
|
-
() => new Promise((resolve) => requestAnimationFrame(resolve)),
|
|
39
|
-
() => new Promise((resolve) => setTimeout(resolve, 100)),
|
|
40
|
-
);
|
|
41
|
-
const bridge = { protocolVersion: 1, compatibility: ${JSON.stringify(r)}, transform: ${x$1}, readiness, stats, settle };
|
|
42
|
-
root.__threeBlocksShaderTools = bridge;
|
|
43
|
-
requestAnimationFrame(() => requestAnimationFrame(() => { readiness.firstFrame = true; }));
|
|
44
|
-
const poll = async () => {
|
|
45
|
-
try {
|
|
46
|
-
const response = await fetch('/__three-blocks/shaders/telemetry?scene=' + encodeURIComponent(scene), { cache: 'no-store' });
|
|
47
|
-
if (response.status !== 204 && response.ok) {
|
|
48
|
-
const payload = await response.json();
|
|
49
|
-
if (payload.protocolVersion !== 1 || payload.compatibility !== bridge.compatibility || payload.transform !== bridge.transform) throw new Error('incompatible shader telemetry');
|
|
50
|
-
Object.assign(stats, payload.stats);
|
|
51
|
-
readiness.workerReady = true;
|
|
52
|
-
if (payload.settled === true) {
|
|
53
|
-
readiness.assetsReady = true;
|
|
54
|
-
readiness.textReady = true;
|
|
55
|
-
readiness.compileEnd = true;
|
|
56
|
-
}
|
|
57
|
-
const smoke = root.__threeBlocksSmoke && typeof root.__threeBlocksSmoke === 'object' ? root.__threeBlocksSmoke : { protocolVersion: 1, worker: { offscreenCanvas: true, visible: true }, readiness: {} };
|
|
58
|
-
smoke.readiness = { ...(smoke.readiness || {}), ...readiness };
|
|
59
|
-
root.__threeBlocksSmoke = smoke;
|
|
60
|
-
}
|
|
61
|
-
} catch {}
|
|
62
|
-
setTimeout(poll, 40);
|
|
63
|
-
};
|
|
64
|
-
void poll();
|
|
65
|
-
})();`}a(J,"publicBridgeScript");function ye(r,e,t,n,o=false){let s=new URL(r.url??"/","http://three-blocks.invalid"),i=s.pathname;if(o&&r.method==="GET"&&/^\/three-blocks\/shaders\/[a-z0-9][a-z0-9_-]{0,63}\.json$/u.test(i))return e.statusCode=204,e.end(),true;if(i===N&&r.method==="GET"){let u=s.searchParams.get("scene")??"",m=n.read(u);return m===void 0?(e.statusCode=204,e.end()):(e.statusCode=200,e.setHeader("Content-Type","application/json"),e.end(JSON.stringify(m))),true}let a=i===ce,c=i===N;if(!a&&!c)return false;if(r.method!=="POST")return e.statusCode=405,e.end("POST required"),true;let h=[],f=0,w=false;return r.on("data",u=>{f+=u.byteLength,f>fe?w=true:h.push(u);}),r.on("end",()=>{if(w){e.statusCode=413,e.end("capture payload too large");return}try{let u=JSON.parse(Buffer.concat(h).toString("utf8"));c?n.receive(u):t.receive(u),e.statusCode=204,e.end();}catch(u){e.statusCode=400,e.end(u instanceof Error?u.message:String(u));}}),true}a(ye,"handleCaptureEndpoint");function Fe(r,e,t,n){return {name:"three-blocks:shader-capture-endpoint",transformIndexHtml(){return [{tag:"script",children:J(n),injectTo:"head-prepend"}]},configureServer(o){o.middlewares.use((s,i,a)=>{let h=new URL(s.url??"/","http://three-blocks.invalid").searchParams.get("captureId");h!==null&&e.markFirstRequest(h),!ye(s,i,r,e,t)&&a();});}}}a(Fe,"captureEndpointPlugin");function se(r,e,t){let n=new URL(e.url,r);for(let[o,s]of Object.entries(t))n.searchParams.set(o,s);return n.href}a(se,"browserUrl");function Le(r,e){let t=new URL(e.url,r);for(let n of ["capture","precompiled"])t.searchParams.delete(n);return t.searchParams.set("captureId",e.key),t.searchParams.set("threeBlocksShaderMode","precompiled"),t.searchParams.set("tbStats","1"),t.href}a(Le,"publishedBrowserUrl");function oe(r){return Be.some(e=>e.test(r))}a(oe,"knownNoise");async function E(r){let e;try{await Promise.race([r(),new Promise(t=>{e=setTimeout(t,we);})]);}catch{}finally{e&&clearTimeout(e);}}a(E,"closeBrowserResource");async function ie(r){let e;try{return await Promise.race([r().catch(()=>null),new Promise(t=>{e=setTimeout(()=>t(null),we);})])}finally{e!==void 0&&clearTimeout(e);}}a(ie,"readPageDiagnostic");function V(r){let e=a(()=>{},"resolveFirst"),t=new Promise(i=>{e=i;}),n={console:[],page:[],first:t},o=false,s=a(i=>{o||(o=true,e(new Error(i)));},"report");return r.on("console",i=>{let a=i.type()==="warning"&&/\[three-blocks\/shaders\].*(?:has no entry|manifest miss|hydration)/iu.test(i.text());if(i.type()!=="error"&&!a||oe(i.text()))return;let c=i.location().url,h=c.length>0?`${i.text()} (${c})`:i.text();n.console.push(h),s(`Browser console ${a?"warning":"error"}: ${h}`);}),r.on("pageerror",i=>{if(oe(i.message))return;let a=i.stack||i.message;n.page.push(a),s(`Browser page error: ${a}`);}),r.on("crash",()=>s("Browser page crashed before shader capture completed.")),r.on("close",()=>s("Browser page closed before shader capture completed.")),n}a(V,"collectErrors");function x(r,e,t=false){return typeof r[e]=="boolean"?r[e]:t}a(x,"booleanField");function Ae(r){if(!a$1(r))throw new Error("Browser shader stats are unavailable.");let e=a((t,n=true)=>{let o=r[t];if(typeof o!="number"||!Number.isFinite(o)||o<0||n&&!Number.isSafeInteger(o))throw new Error(`Browser shader stats.${t} is invalid.`);return o},"read");return {buildCalls:e("buildCalls"),renderBuilds:e("renderBuilds"),computeBuilds:e("computeBuilds"),registeredBuilds:e("registeredBuilds"),registeredRenderBuilds:e("registeredRenderBuilds"),registeredComputeBuilds:e("registeredComputeBuilds"),buildMs:e("buildMs",false),syncBuildMs:e("syncBuildMs",false),asyncBuildElapsedMs:e("asyncBuildElapsedMs",false),precompiledSetupMs:e("precompiledSetupMs",false),maxSyncBuildMs:e("maxSyncBuildMs",false),maxPrecompiledSetupMs:e("maxPrecompiledSetupMs",false),hydrationMs:e("hydrationMs",false),maxHydrationMs:e("maxHydrationMs",false),injected:e("injected"),injectedRender:e("injectedRender"),injectedCompute:e("injectedCompute"),missed:e("missed"),missedRender:e("missedRender"),missedCompute:e("missedCompute"),...Array.isArray(r.missedKeys)&&r.missedKeys.every(t=>typeof t=="string")?{missedKeys:r.missedKeys}:{}}}a(Ae,"parseStats");function A(r,e,t,n,o){if(!a$1(r))throw new Error("The page did not expose the public shader devtools bridge.");if(!t&&r.protocolVersion!==1)throw new Error(`Scene "${e.key}" exposed an unsupported shader bridge protocol.`);let s=r.readiness;if(!a$1(s))throw new Error("The shader bridge readiness snapshot is invalid.");let i={workerReady:x(s,"workerReady"),assetsReady:x(s,"assetsReady"),textReady:e.requiresText?x(s,"textReady"):true,compileEnd:x(s,"compileEnd"),firstFrame:x(s,"firstFrame",t)};if(!i.workerReady||!i.assetsReady||!i.textReady||!i.compileEnd)throw new Error(`Scene "${e.key}" did not reach worker/assets/text/compile readiness.`);let a=t?o:r.compatibility,c=t?x$1:r.transform;if(a!==o||c!==x$1)throw new Error(`Scene "${e.key}" exposed incompatible shader bridge metadata.`);return U(n),{compatibility:o,transform:c,readiness:i,stats:Ae(r.stats)}}a(A,"parseBridge");async function D(r,e){return r.evaluate(t=>{let n=globalThis;if(!t)return n.__threeBlocksShaderTools??null;let o=n.__threeBlocks,s=n.__threeBlocksTslStats;if(!o||typeof o!="object")return null;let i=o;return {readiness:{workerReady:i.workerReady===true,assetsReady:i.loadEnd===true||i.assetsReady===true,textReady:i.textReady===true,compileEnd:i.compileEnd===true,firstFrame:true},stats:s}},e)}a(D,"readBridge");async function O(r,e,t,n){let o=r.evaluate(async i=>{let c=globalThis.__threeBlocksShaderTools;if(c&&typeof c=="object"){let w=Reflect.get(c,"settle");if(typeof w=="function"){let u=await w(i.frames,i.targetFrame);return typeof u=="number"&&Number.isSafeInteger(u)?u:0}}if(!i.legacy||!i.modulePath)throw new Error("The public shader bridge does not provide deterministic settle().");let h=await import(i.modulePath);if(!h.store||typeof h.store!="object")throw new Error("Legacy deterministic store is unavailable.");let f=h.store;return f.recordFrameCount=0,f.recordFrameRate=60,f.recordTotalFrames=i.frames,f.recording=true,await new Promise((w,u)=>{let m=Date.now(),d=a(()=>{if(f.recording===false)return w();if(Date.now()-m>i.timeoutMs)return u(new Error("Legacy deterministic settle timed out."));setTimeout(d,25);},"poll");d();}),0},{frames:t,targetFrame:n,legacy:e.bridge.legacyLab,modulePath:e.bridge.deterministicModule??null,timeoutMs:e.timeoutMs}),s;try{return await Promise.race([o,new Promise((i,a)=>{s=setTimeout(()=>a(new Error(`Shader parity settle timed out after ${e.timeoutMs}ms.`)),e.timeoutMs);})])}finally{s!==void 0&&clearTimeout(s);}}a(O,"settlePage");async function ae(r,e,t){e.readiness.selector===void 0&&e.readiness.global===void 0||await Promise.race([r.waitForFunction(n=>{let o=globalThis;if(n.selector!==void 0&&o.document?.querySelector(n.selector)==null)return false;if(n.global===void 0)return true;let s=o;for(let c of n.global.split(".")){if((typeof s!="object"||s===null)&&typeof s!="function")return false;s=Reflect.get(s,c);}if(s===true)return true;if(typeof s!="object"||s===null||typeof Reflect.get(s,"then")!="function")return false;let i=o.__threeBlocksReadinessState,a=i instanceof Map?i:new Map;return i instanceof Map||(o.__threeBlocksReadinessState=a),a.has(s)||(a.set(s,false),Promise.resolve(s).then(()=>a.set(s,true),()=>a.set(s,false))),a.get(s)===true},e.readiness,{timeout:e.timeoutMs}),t.first.then(n=>Promise.reject(n))]);}a(ae,"waitForConfiguredReadiness");async function de(r){let e=r.locator("canvas"),n=(await e.evaluateAll(o=>o.map((s,i)=>{let a=s.getBoundingClientRect();return {index:i,area:Math.max(0,a.width)*Math.max(0,a.height)}}))).sort((o,s)=>s.area-o.area)[0];if(n===void 0||n.area<=0)throw new Error("Published page has no visible renderer canvas.");return Buffer.from(await e.nth(n.index).screenshot({type:"png"}))}a(de,"primaryCanvasScreenshot");async function K(r,e,t,n,o,s){let i=ge(n,o),a=await Q(),c=`(() => {
|
|
66
|
-
const runtime = globalThis[Symbol.for(${JSON.stringify(re)})];
|
|
67
|
-
if (!runtime || typeof runtime.configureThreeBlocksShaderCapture !== 'function') {
|
|
68
|
-
throw new Error('@three-blocks/devtools attached shader capture runtime is incompatible.');
|
|
69
|
-
}
|
|
70
|
-
runtime.configureThreeBlocksShaderCapture(${JSON.stringify(i).replaceAll("<","\\u003c")});
|
|
71
|
-
})();`;await r.addInitScript({content:`${a}
|
|
72
|
-
${c}`}),await r.addInitScript({content:J(s)}),await r.route("**/*",async h=>{let f=h.request(),w=new URL(f.url()),u=w.pathname;if(f.method()==="GET"&&n!=="precompiled"&&/^\/three-blocks\/shaders\/[a-z0-9][a-z0-9_-]{0,63}\.json$/u.test(u)){await h.fulfill({status:204});return}if(u===N&&f.method()==="GET"){let p=t.read(w.searchParams.get("scene")??"");await h.fulfill(p===void 0?{status:204}:{status:200,contentType:"application/json",body:JSON.stringify(p)});return}let m=u===ce,d=u===N;if((m||d)&&f.method()==="POST"){let p=f.postDataBuffer()??Buffer.alloc(0);if(p.byteLength>fe){await h.fulfill({status:413,body:"capture payload too large"});return}try{let g=JSON.parse(p.toString("utf8"));d?t.receive(g):e.receive(g),await h.fulfill({status:204});}catch(g){await h.fulfill({status:400,body:g instanceof Error?g.message:String(g)});}return}await h.continue();});}a(K,"configureAttachedContext");var De=Object.freeze({".avif":"image/avif",".css":"text/css; charset=utf-8",".gif":"image/gif",".html":"text/html; charset=utf-8",".ico":"image/x-icon",".jpeg":"image/jpeg",".jpg":"image/jpeg",".js":"text/javascript; charset=utf-8",".json":"application/json; charset=utf-8",".mjs":"text/javascript; charset=utf-8",".mp4":"video/mp4",".png":"image/png",".svg":"image/svg+xml",".wasm":"application/wasm",".webm":"video/webm",".webp":"image/webp",".woff":"font/woff",".woff2":"font/woff2"});function Ne(r){let e=[`<script src="${me}"></script>`,`<script type="module" src="${he}"></script>`].join(""),t=/<head(?:\s[^>]*)?>/iu.exec(r);return t===null?`${e}${r}`:`${r.slice(0,t.index+t[0].length)}${e}${r.slice(t.index+t[0].length)}`}a(Ne,"injectStaticShaderCaptureHtml");function Ie(r,e){let t=ge(r,e);return [`import { configureThreeBlocksShaderCapture } from ${JSON.stringify(ue)};`,`configureThreeBlocksShaderCapture( ${JSON.stringify(t).replaceAll("<","\\u003c")} );`].join(`
|
|
73
|
-
`)}a(Ie,"staticCaptureBootstrap");function ge(r,e){return {capture:r==="capture",forceLive:r!=="precompiled",settleFrames:e.settleFrames,settleTimeoutMs:e.settleTimeoutMs??3e4,readiness:e.readiness,transform:x$1}}a(ge,"shaderCaptureConfiguration");async function Ue(r,e){let t=await m(r,e,i=>/\.(?:c|m)?js$/u.test(i),16384),n=false,o=false,s;for(let i of t){let a=(await l(r,i,d.texture,"Static application JavaScript")).data.toString("utf8");if(a.includes("nodeBuilderStateProvider")&&(n=true),a.includes("three-blocks.shader-capture.runtime.v1")&&(o=true,s??=i),n&&o)break}if(!n||!o)throw new Error("The static build does not contain the Three.js shader capture transform. Run `shaders capture` without an explicit driver or URL to preview adapter wiring and build automatically, or add the manual adapter from the package README and rebuild.");return {seen:true,applied:true,alreadyPresent:false,captureApplied:true,...s===void 0?{}:{id:s}}}a(Ue,"inspectStaticCaptureTransform");async function $e(r,e){let t;try{t=decodeURIComponent(e);}catch{return}if(t.includes("\0"))return;let n=t.replace(/^\/+/u,""),o=k.resolve(r,n.length===0?"index.html":n);if(!h(r,o)||o===r||(await g(o)&&(await lstat(o)).isDirectory()&&(o=k.join(o,"index.html")),!await g(o)&&k.extname(o).length===0&&(o=k.join(r,"index.html")),!await g(o)))return;let s=await l(r,o,d.texture,"Static application asset");return {data:s.data,file:s.path}}a($e,"staticRequestFile");async function He(r,e,t,n,o){let s=await realpath(r.root),i=await realpath(k.resolve(s,r.serve));if(!h(s,i)||i===s)throw new Error("--serve must name a built application directory inside the project root.");let a=await Ue(s,i),c=await O$1(),h$1=Ie(e,t),f=J(v(r.runtime.three)),w=createServer((m,d)=>{(async()=>{if(ye(m,d,n,o,e!=="precompiled"))return;let p=new URL(m.url??"/","http://three-blocks.invalid");if(m.method!=="GET"&&m.method!=="HEAD"){d.statusCode=405,d.end("GET or HEAD required");return}let g=p.pathname===ue?c:p.pathname===he?h$1:p.pathname===me?f:void 0;if(g!==void 0){d.statusCode=200,d.setHeader("Content-Type","text/javascript; charset=utf-8"),d.setHeader("Cache-Control","no-store"),d.end(m.method==="HEAD"?void 0:g);return}let y=await $e(i,p.pathname);if(y===void 0){d.statusCode=404,d.end("Not found");return}let v=k.extname(y.file).toLowerCase(),C=v===".html"?Buffer.from(Ne(y.data.toString("utf8"))):y.data;d.statusCode=200,d.setHeader("Content-Type",De[v]??"application/octet-stream"),d.setHeader("Content-Length",String(C.byteLength)),d.setHeader("Cache-Control","no-store"),d.end(m.method==="HEAD"?void 0:C);})().catch(p=>{if(d.headersSent)return d.destroy(p instanceof Error?p:void 0);d.statusCode=500,d.end(p instanceof Error?p.message:String(p));});});await new Promise((m,d)=>{w.once("error",d),w.listen(0,"127.0.0.1",()=>{w.off("error",d),m();});});let u=w.address();if(!u||typeof u=="string")throw new Error("Static capture server did not expose an ephemeral TCP address.");return {server:w,baseUrl:`http://127.0.0.1:${u.port}`,transform:a}}a(He,"startStaticShaderServer");function Ve(r,e,t){return r===e?true:t&&r!==void 0&&r!=="capture"&&e!=="capture"}a(Ve,"canReuseShaderBrowserSession");function le(r){let e=r instanceof Error?r.message:String(r);return e.includes("Execution context was destroyed")&&e.includes("navigation")||/^launch: Timeout \d+ms exceeded\./u.test(e)}a(le,"isRetryableShaderObservationNavigation");var M=class{static{a(this,"PlaywrightShaderDriver");}#e;#t=new q;#n=new G;#h;#m;#i;#a;#r;#s;#f;#l;#p;#c=0;#u;constructor(e){this.#e=e;}#d(){return this.#h?.status??this.#m??{seen:false,applied:false,alreadyPresent:false}}async#w(e){if(this.#r?.isConnected()===true)return;this.#r=void 0;let t=await xe();this.#u??=await mkdtemp(k.join(tmpdir(),"three-blocks-shader-cache-")),this.#r=await t.launch({headless:te(this.#e.headed===true),args:[...ee(),`--disk-cache-dir=${this.#u}`],timeout:e.timeoutMs}),this.#c=0;}async#o(e,t,n){let o;try{return await Promise.race([n(),new Promise((s,i)=>{o=setTimeout(()=>i(new Error(`launch: Timeout ${t.timeoutMs}ms exceeded.`)),t.timeoutMs);})])}catch(s){throw this.#r===e&&(this.#r=void 0),await E(()=>e.close()),s}finally{o!==void 0&&clearTimeout(o);}}async#y(e,t){let n=this.#i!==void 0||this.#a!==void 0||this.#e.url!==void 0&&this.#s!==void 0,o=this.#a!==void 0?this.#l===e:Ve(this.#l,e,t.bridge.legacyLab);if(n&&o){this.#l=e,await this.#w(t);return}if(n&&await this.close(),this.#l=e,this.#e.url!==void 0){let s=new URL(this.#e.url);if(!["http:","https:"].includes(s.protocol)||s.username||s.password||s.hash)throw new Error("Attached shader URL must be an HTTP(S) URL without credentials or a fragment.");this.#s=s.href,this.#m={seen:true,applied:true,alreadyPresent:false,captureApplied:true,id:"attached-application"},await this.#w(t);return}if(this.#e.serve!==void 0)try{let s=await He({root:this.#e.root,runtime:this.#e.runtime,serve:this.#e.serve,...this.#e.headed===void 0?{}:{headed:this.#e.headed}},e,t,this.#t,this.#n);this.#a=s.server,this.#m=s.transform,this.#s=s.baseUrl,await this.#w(t);return}catch(s){throw await this.close(),s}this.#h=T(this.#e.runtime.three,{disableTimestampQueries:b.env.THREE_BLOCKS_SOFTWARE_WEBGPU==="1",...t.bridge.legacyLab?{}:{capture:{capture:e==="capture",forceLive:e!=="precompiled",settleFrames:t.settleFrames,settleTimeoutMs:t.settleTimeoutMs??3e4,readiness:t.readiness}}}),this.#f={THREE_BLOCKS_SHADER_TOOL:b.env.THREE_BLOCKS_SHADER_TOOL,THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER:b.env.THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER},b.env.THREE_BLOCKS_SHADER_TOOL="1",b.env.THREE_BLOCKS_PRECOMPILE_CAPTURE_SERVER="1";try{let s=await Oe(this.#e.root);this.#i=await s({root:this.#e.root,logLevel:"error",plugins:[this.#h.plugin,Fe(this.#t,this.#n,e!=="precompiled",v(this.#e.runtime.three))],server:{host:"127.0.0.1",port:0}}),await this.#i.listen();let i=this.#i.httpServer?.address();if(!i||typeof i=="string")throw new Error("Vite did not expose an ephemeral TCP address.");this.#s=`http://127.0.0.1:${i.port}`,await this.#w(t);}catch(s){throw await this.close(),s}}async capture(e,t){let n=Date.now();if(await this.#y("capture",t),!this.#r||!this.#s)throw new Error("Shader browser driver did not start.");let o=this.#r,s=await this.#o(o,t,()=>o.newContext({viewport:t.viewport}));this.#e.url!==void 0&&await this.#o(o,t,()=>K(s,this.#t,this.#n,"capture",t,v(this.#e.runtime.three)));let i=await this.#o(o,t,()=>s.newPage()),a$2=V(i);this.#n.clear(e.key);let c=this.#t.wait(e.key,t.timeoutMs),h=Promise.race([c,a$2.first.then(m=>Promise.reject(m))]),f=a(()=>{},"resolveDisconnected"),w=new Promise(m=>{f=m;}),u=a(()=>f(new Error("Shader capture browser disconnected before posting a manifest.")),"onDisconnected");o.on("disconnected",u);try{let m=i.goto(se(this.#s,e,{threeBlocksShaderCapture:"1",capture:"1",captureId:e.key,captureFrames:String(Math.max(4,t.settleFrames)),settleFrames:String(t.settleFrames)}),{waitUntil:"domcontentloaded",timeout:t.timeoutMs}),d=await Me(m,Promise.race([h,w.then(g=>Promise.reject(g))]));U(this.#d());let p=[...a$2.page,...a$2.console];if(p.length>0)throw new Error(`Capture browser errors:
|
|
74
|
-
- ${p.join(`
|
|
75
|
-
- `)}`);return a$1(d)?{...d,timing:{...a$1(d.timing)?d.timing:{},launch:n,...this.#n.firstRequest(e.key)===void 0?{}:{firstRequest:this.#n.firstRequest(e.key)},posted:Date.now()}}:d}catch(m){let d=m instanceof Error?m:new Error(String(m));this.#t.cancel(e.key,d),await c.catch(()=>{});let p=this.#n.read(e.key);if(d.message.includes("timed out")){let g=await ie(()=>i.evaluate(()=>{let y=globalThis,v=y.__threeBlocksShaderTools,C=v&&typeof v=="object"?v:void 0,_=y.document,T=Reflect.get(y,Symbol.for("three-blocks.shader-capture.cache-value.v1")),j=y.location,Se=j!==null&&typeof j=="object"&&typeof Reflect.get(j,"href")=="string"?String(Reflect.get(j,"href")):"http://three-blocks.invalid/",be=new URL(Se).searchParams.get("captureId")??"default",z=T!==null&&typeof T=="object"&&typeof Reflect.get(T,"registrations")=="function"?Reflect.apply(Reflect.get(T,"registrations"),T,[be]):void 0;return {documentReadyState:_?.readyState??null,parityTargetFrame:Number(y.__threeBlocksParityTargetFrame??0),parityCompletedFrame:Number(y.__threeBlocksParityCompletedFrame??0),readiness:C?.readiness??null,captureCache:T!==null&&typeof T=="object"?{activeScene:Reflect.get(T,"activeScene")??null,registrations:Array.isArray(z)?z.slice(0,16).map(R=>R!==null&&typeof R=="object"?{key:Reflect.get(R,"key")??null,kind:Reflect.get(R,"kind")??null}:null):null}:null,threeRuntimeResources:performance.getEntriesByType("resource").map(R=>R.name).filter(R=>R.includes("three.webgpu"))}}));throw new Error(`${d.message} Last capture state for "${e.key}": ${JSON.stringify({page:g,telemetry:p??null,transform:this.#d()})}`)}throw d}finally{o.off("disconnected",u),await E(()=>s.close()),this.#c++,(!o.isConnected()||this.#c>=(t.browserRelaunchScenes??8))&&(this.#r===o&&(this.#r=void 0),await E(()=>o.close()),this.#c=0);}}async observe(e,t,n,o){for(let s=0;s<2;s++)try{return await this.#g(e,t,n,o)}catch(i){if(s===0&&le(i))continue;throw i}throw new Error(`Shader observation retry was exhausted for scene "${e.key}".`)}async#g(e,t,n,o){if(await this.#y(t,n),!this.#r||!this.#s)throw new Error("Shader browser driver did not start.");let s=this.#r,i=await this.#o(s,n,()=>s.newContext({viewport:n.viewport}));this.#e.url!==void 0&&await this.#o(s,n,()=>K(i,this.#t,this.#n,t,n,v(this.#e.runtime.three)));let a=await this.#o(s,n,()=>i.newPage()),c=V(a);this.#n.clear(e.key);try{await a.goto(se(this.#s,e,{threeBlocksShaderCapture:"1",threeBlocksShaderMode:t,captureId:e.key,...t==="live"?{precompiled:"0"}:{}}),{waitUntil:"domcontentloaded",timeout:n.timeoutMs}),await Promise.race([a.waitForFunction(n.bridge.legacyLab?"globalThis.__threeBlocks?.compileEnd === true":"globalThis.__threeBlocksShaderTools?.readiness?.compileEnd === true",void 0,{timeout:n.timeoutMs}),c.first.then(d=>Promise.reject(d))]),A(await D(a,n.bridge.legacyLab),e,n.bridge.legacyLab,this.#d(),v(this.#e.runtime.three)),await ae(a,n,c),await Promise.race([a.waitForFunction(n.bridge.legacyLab?"true":"globalThis.__threeBlocksShaderTools?.readiness?.firstFrame === true",void 0,{timeout:n.timeoutMs}),c.first.then(d=>Promise.reject(d))]),await O(a,n,1);let h=Buffer.from(await a.screenshot({type:"png"})),f=e.parityFrames??n.parity.frames,w=await O(a,n,f,o),u=Buffer.from(await a.screenshot({type:"png"}));e.parityFrames!==void 0&&f<n.parity.frames&&await O(a,n,n.parity.frames-f);let m=A(await D(a,n.bridge.legacyLab),e,n.bridge.legacyLab,this.#d(),v(this.#e.runtime.three));return this.#p===void 0&&(this.#p=await a.evaluate(async()=>{let d=Reflect.get(navigator,"gpu"),p=typeof d=="object"&&d!==null?Reflect.get(d,"requestAdapter"):void 0,g=typeof p=="function"?await Reflect.apply(p,d,[]):void 0,y=typeof g=="object"&&g!==null?Reflect.get(g,"info"):void 0,v=["description","device","architecture","vendor"].flatMap(C=>{let _=typeof y=="object"&&y!==null?Reflect.get(y,C):void 0;return typeof _=="string"&&_.length>0?[_]:[]});return {adapter:[...new Set(v)].join(" \xB7 ")||"WebGPU adapter",platform:navigator.platform||navigator.userAgent}})),{scene:e.key,mode:t,...m,frame:w,firstFrameScreenshot:h,screenshot:u,errors:[...c.page,...c.console]}}catch(h){let f=h instanceof Error?h:new Error(String(h));if(/(?:timed?\s*out|timeout)/iu.test(f.message)){let w=this.#n.read(e.key),u=await ie(()=>a.evaluate(()=>{let m=globalThis,d=m.__threeBlocksShaderTools,p=d&&typeof d=="object"?d:void 0;return {documentReadyState:m.document?.readyState??null,parityTargetFrame:Number(m.__threeBlocksParityTargetFrame??0),parityCompletedFrame:Number(m.__threeBlocksParityCompletedFrame??0),readiness:p?.readiness??null,threeRuntimeResources:performance.getEntriesByType("resource").map(y=>y.name).filter(y=>y.includes("three.webgpu"))}}));throw new Error(`${f.message} Last ${t} state for "${e.key}": ${JSON.stringify({page:u,telemetry:w??null})}`)}throw f}finally{await E(()=>i.close());}}async observePublished(e,t){for(let n=0;n<2;n++)try{return await this.#S(e,t)}catch(o){if(n===0&&le(o))continue;throw o}throw new Error(`Published shader observation retry was exhausted for scene "${e.key}".`)}async#S(e,t){if(await this.#y("precompiled",t),!this.#r||!this.#s)throw new Error("Shader browser driver did not start.");let n=this.#r,o=await this.#o(n,t,()=>n.newContext({viewport:t.viewport}));this.#e.url!==void 0&&await this.#o(n,t,()=>K(o,this.#t,this.#n,"precompiled",t,v(this.#e.runtime.three)));let s=await this.#o(n,t,()=>o.newPage()),i=V(s);this.#n.clear(e.key);try{await s.goto(Le(this.#s,e),{waitUntil:"domcontentloaded",timeout:t.timeoutMs}),await Promise.race([s.waitForFunction(t.bridge.legacyLab?"globalThis.__threeBlocks?.compileEnd === true":"globalThis.__threeBlocksShaderTools?.readiness?.compileEnd === true",void 0,{timeout:t.timeoutMs}),i.first.then(w=>Promise.reject(w))]),await ae(s,t,i),A(await D(s,t.bridge.legacyLab),e,t.bridge.legacyLab,this.#d(),v(this.#e.runtime.three)),await O(s,t,2);let a=await de(s),c=await O(s,t,120),h=await de(s),f=A(await D(s,t.bridge.legacyLab),e,t.bridge.legacyLab,this.#d(),v(this.#e.runtime.three));return {scene:e.key,mode:"precompiled",...f,frame:c,firstFrameScreenshot:a,beforeScreenshot:a,screenshot:h,errors:[...i.page,...i.console]}}finally{await E(()=>o.close());}}timingEnvironment(){return this.#p??{adapter:"WebGPU adapter",platform:`${b.platform}/${b.arch}`}}async close(){this.#t.rejectAll(new Error("Shader browser driver closed.")),this.#r&&await E(()=>this.#r?.close()??Promise.resolve());let e=this.#i?.httpServer,t=e?Reflect.get(e,"closeAllConnections"):void 0;if(e&&typeof t=="function"&&Reflect.apply(t,e,[]),this.#i&&await E(()=>this.#i?.close()??Promise.resolve()),this.#a){let n=this.#a;n.closeAllConnections(),await E(()=>new Promise(o=>{n.close(()=>o());}));}if(this.#r=void 0,this.#i=void 0,this.#a=void 0,this.#s=void 0,this.#h=void 0,this.#m=void 0,this.#l=void 0,this.#p=void 0,this.#c=0,this.#u!==void 0&&(await rm(this.#u,{recursive:true,force:true}),this.#u=void 0),this.#f){for(let[n,o]of Object.entries(this.#f))o===void 0?delete b.env[n]:b.env[n]=o;this.#f=void 0;}}};function lt(r){return new M(r)}a(lt,"createPlaywrightShaderDriver");function ct(r){return new M(r)}a(ct,"createStaticPlaywrightShaderDriver");function ut(r){return new M(r)}a(ut,"createAttachedPlaywrightShaderDriver");
|
|
76
|
-
export{ve as a,We as b,ee as c,te as d,Me as e,je as f,J as g,Ve as h,le as i,lt as j,ct as k,ut as l};
|
package/dist/chunk-NE7SC2BX.js
DELETED
|
@@ -1,2 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import {a as a$1}from'./chunk-HOZDD6PW.js';import o from'process';var i=Object.freeze([{id:"three-inspector-invalid-json",pattern:/is not valid JSON/iu},{id:"chromium-webgpu-experimental",pattern:/WebGPU is experimental/iu}]);function a(r){return i.some(e=>e.pattern.test(r))}a$1(a,"isDocumentedBrowserNoise");function l(r=o.env,e=o.platform){let t=r.THREE_BLOCKS_WEBGPU_BROWSER_ARGS?.split(/\s+/u).filter(Boolean);if(t&&t.length>0)return t;let s=["--enable-unsafe-webgpu"];return e==="darwin"&&s.push("--enable-gpu","--use-angle=metal"),e==="linux"&&s.push("--enable-features=Vulkan","--disable-vulkan-surface","--ignore-gpu-blocklist","--disable-gpu-driver-bug-workarounds","--disable-gpu-watchdog"),s}a$1(l,"webgpuBrowserArgs");function p(r=false,e=o.env){return r!==true&&e.THREE_BLOCKS_SOFTWARE_WEBGPU!=="1"}a$1(p,"webgpuBrowserHeadless");export{a,l as b,p as c};
|
package/dist/chunk-NEWSG5RX.js
DELETED
|
@@ -1,3 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import {a as a$1,b as b$1}from'./chunk-ZDNZCQUQ.js';import {d as d$1,j as j$1,a as a$2,g}from'./chunk-5L2VS3BN.js';import {a}from'./chunk-HOZDD6PW.js';import {realpath,readFile}from'fs/promises';import d from'path';var b="three-blocks.shaders.json",I=".three-blocks/shaders",O=".three-blocks/shaders/parity",_=/^[a-z0-9][a-z0-9_-]{0,63}$/u,C=/^[A-Za-z_$][A-Za-z0-9_$]*(?:\.[A-Za-z_$][A-Za-z0-9_$]*)*$/u,E=64,R=64,j={schemaVersion:1,scenes:[{key:"default",url:"/"}]};function x(n,r,e){if(n===void 0)return e;if(typeof n!="string"||n.length===0||n.length>512||d.isAbsolute(n)||/[\u0000-\u001f\u007f]/u.test(n))throw new Error(`${r} must be a bounded project-relative directory.`);let i=d.posix.normalize(n.replaceAll("\\","/")).replace(/\/+$/u,"");if(i==="."||i===".."||i.startsWith("../"))throw new Error(`${r} must stay inside the project.`);return i}a(x,"safeProjectDirectory");function A(n,r){let e=x(n,r,"");if(typeof n!="string"||n.endsWith("/"))throw new Error(`${r} must be a project-relative file.`);return e}a(A,"safeProjectFile");function u(n,r,e,i,o){if(n===void 0)return o;if(!Number.isSafeInteger(n)||Number(n)<e||Number(n)>i)throw new Error(`${r} must be an integer in ${e}...${i}.`);return Number(n)}a(u,"boundedInteger");function T(n,r,e){if(n===void 0)return e;if(typeof n!="number"||!Number.isFinite(n)||n<0||n>1)throw new Error(`${r} must be a finite ratio in 0...1.`);return n}a(T,"finiteRatio");function $(n,r){if(typeof n!="string"||n.length===0||n.length>2048||/[\u0000-\u001f\u007f]/u.test(n))throw new Error(`${r} must be a bounded project-relative URL.`);let e;try{e=new URL(n,"http://three-blocks.invalid/");}catch{throw new Error(`${r} is not a valid URL.`)}if(e.origin!=="http://three-blocks.invalid"||e.hash.length>0)throw new Error(`${r} must stay within the project and must not contain a fragment.`);return `${e.pathname}${e.search}`}a($,"safeBrowserUrl");function F(n){if(!Array.isArray(n)||n.length===0||n.length>E)throw new Error(`Shader config scenes must contain 1...${E} entries.`);let r=new Set;return n.map((e,i)=>{if(!a$1(e)||typeof e.key!="string"||!_.test(e.key))throw new Error(`Shader config scene ${i} has an invalid key.`);if(r.has(e.key))throw new Error(`Shader config scene key "${e.key}" is duplicated.`);r.add(e.key);let o=e.parityFrames,t=e.maxDiffRatio;if(e.inputs!==void 0&&(!Array.isArray(e.inputs)||e.inputs.length===0||e.inputs.length>R))throw new Error(`Shader config scene "${e.key}" inputs must contain 1...${R} files.`);let a=e.inputs===void 0?void 0:e.inputs.map((h,l)=>A(h,`Shader config scene "${e.key}" input ${l}`));if(a!==void 0&&new Set(a).size!==a.length)throw new Error(`Shader config scene "${e.key}" inputs must be unique.`);if(e.runtimeMotion!==void 0&&typeof e.runtimeMotion!="boolean")throw new Error(`Shader config scene "${e.key}" runtimeMotion must be a boolean.`);return {key:e.key,url:$(e.url,`Shader config scene "${e.key}" URL`),requiresText:e.requiresText===true,...a===void 0?{}:{inputs:a},...o===void 0?{}:{parityFrames:u(o,`Shader config scene "${e.key}" parityFrames`,0,1e4,0)},...t===void 0?{}:{maxDiffRatio:T(t,`Shader config scene "${e.key}" maxDiffRatio`,.01)},...e.runtimeMotion===true?{runtimeMotion:true}:{}}})}a(F,"parseScenes");function y(n){if(!a$1(n)||n.schemaVersion!==void 0&&n.schemaVersion!==1)throw new Error("Shader config must use schemaVersion 1.");let r=n.viewport;if(r!==void 0&&!a$1(r))throw new Error("Shader config viewport must be an object.");let e=n.parity;if(e!==void 0&&!a$1(e))throw new Error("Shader config parity must be an object.");let i=n.bridge;if(i!==void 0&&!a$1(i))throw new Error("Shader config bridge must be an object.");let o=a$1(i)?i.deterministicModule:void 0;o!==void 0&&$(o,"Shader deterministic module");let t=n.readiness;if(t!==void 0&&!a$1(t))throw new Error("Shader config readiness must be an object.");let a=a$1(t)?t.selector:void 0;if(a!==void 0&&(typeof a!="string"||a.length===0||a.length>512||/[\u0000-\u001f\u007f]/u.test(a)))throw new Error("Shader readiness selector must be a bounded, non-empty CSS selector.");let h=a$1(t)?t.global:void 0;if(h!==void 0&&(typeof h!="string"||!C.test(h)))throw new Error("Shader readiness global must be a dot-separated JavaScript property path.");return {schemaVersion:1,scenes:F(n.scenes),settleFrames:u(n.settleFrames,"Shader settleFrames",0,1e4,60),settleTimeoutMs:u(n.settleTimeoutMs,"Shader settleTimeoutMs",1e3,15*6e4,3e4),browserRelaunchScenes:u(n.browserRelaunchScenes,"Shader browserRelaunchScenes",1,64,8),timeoutMs:u(n.timeoutMs,"Shader timeoutMs",1e3,15*6e4,24e4),viewport:{width:u(a$1(r)?r.width:void 0,"Shader viewport width",64,8192,1024),height:u(a$1(r)?r.height:void 0,"Shader viewport height",64,8192,640)},parity:{frames:u(a$1(e)?e.frames:void 0,"Shader parity frames",0,1e4,90),channelTolerance:u(a$1(e)?e.channelTolerance:void 0,"Shader parity channelTolerance",0,255,8),maxDiffRatio:T(a$1(e)?e.maxDiffRatio:void 0,"Shader parity maxDiffRatio",.01)},bridge:{legacyLab:a$1(i)&&i.legacyLab===true,...typeof o=="string"?{deterministicModule:o}:{}},readiness:{...typeof a=="string"?{selector:a}:{},...typeof h=="string"?{global:h}:{}},publicDir:x(n.publicDir,"Shader publicDir","public"),allowLiveBuilds:n.allowLiveBuilds!==false}}a(y,"parseShaderToolConfig");async function v(n=process.cwd()){let r=d.resolve(n);for(;;){if(await d$1(d.join(r,b))||await d$1(d.join(r,"three-blocks.json")))return realpath(r);let e=d.join(r,"package.json");if(await d$1(e)){let o=await j$1(r,e,a$2.packageJson,"Project package.json"),t;try{t=JSON.parse(o.data.toString("utf8"));}catch{throw new Error(`Project package.json is not valid JSON: ${e}.`)}if(a$1(t)&&[t.dependencies,t.devDependencies,t.peerDependencies,t.optionalDependencies].filter(a$1).some(l=>typeof l.three=="string"||typeof l["three-blocks"]=="string"||typeof l["@three-blocks/devtools"]=="string"))return realpath(r)}let i=d.dirname(r);if(i===r)throw new Error(`No Three Blocks shader project found from ${JSON.stringify(d.resolve(n))}; add Three.js to package.json or pass --root.`);r=i;}}a(v,"findShaderProjectRoot");async function w(n){let r=await realpath(n),e=d.join(r,b);if(await d$1(e)){let o=await j$1(r,e,a$2.metadata,"Shader configuration");return y(JSON.parse(o.data.toString("utf8")))}let i=d.join(r,"three-blocks.json");if(await d$1(i)){let o=b$1(JSON.parse(await readFile(i,"utf8")));return y({schemaVersion:1,scenes:[{key:o.template,url:"/",requiresText:o.features.text}]})}return y(j)}a(w,"loadShaderToolConfig");async function U(n){let r=await realpath(n);for(let t of ["vite.config.ts","vite.config.mts","vite.config.js","vite.config.mjs","vite.config.cts","vite.config.cjs"])if(await d$1(d.join(r,t)))return {driverKind:"vite",reason:`Detected ${t}.`};let e,i=d.join(r,"package.json");if(await d$1(i)){let t=await j$1(r,i,a$2.packageJson,"Project package.json"),a=JSON.parse(t.data.toString("utf8"));a$1(a)&&(e=a);}let o=a(t=>[e?.dependencies,e?.devDependencies,e?.peerDependencies,e?.optionalDependencies].some(a=>a$1(a)&&typeof a[t]=="string"),"hasDependency");if(o("vite"))return {driverKind:"vite",reason:"Detected the Vite dependency."};for(let t of ["dist","build","out"])if(await d$1(d.join(r,t,"index.html")))return {driverKind:"static",serve:t,reason:`Detected the built ${t}/index.html application.`};if(o("next"))throw new Error("Detected Next.js without an attach URL. Run `shaders capture` without an explicit driver or URL to preview the withThreeBlocksNext adapter and start a project-local capture server, or pass --url <local-url> for a server you manage.");if(o("webpack")||o("esbuild")||o("rollup"))throw new Error("Detected a non-Vite bundler but no static index.html. Run `shaders capture` without an explicit driver or URL to preview adapter wiring and build the project, or build it yourself and pass --driver static --serve <directory>.");return {driverKind:"vite",reason:"Using the Vite golden-path driver."}}a(U,"inferShaderCaptureTarget");async function V(n){let r=await realpath(n),e=d.join(r,b);if(await d$1(e))return {config:await w(r),file:e,created:false};let i=d.join(r,"three-blocks.json");if(await d$1(i))return {config:await w(r),file:i,created:false};let o=j,t=y(o),a=await g(e,`${JSON.stringify(o,null,2)}
|
|
3
|
-
`);return {config:a?t:await w(r),file:e,created:a}}a(V,"ensureShaderToolConfig");export{b as a,I as b,O as c,y as d,v as e,w as f,U as g,V as h};
|