@hology/core 0.0.271 → 0.0.273

package/dist/scene/model.d.ts

@@ -222,6 +222,10 @@ export type TextureSettings = {
      * texture participates in.
      */
     textureArrayFileKey?: string;
+    /** Build-generated GPU-native alternatives; fileKey remains the portable fallback. */
+    nativeFileKeys?: Partial<Record<'bc7' | 'astc', string>>;
+    /** GPU-native alternatives for textureArrayFileKey, with identical layer ordering. */
+    nativeArrayFileKeys?: Partial<Record<'bc7' | 'astc', string>>;
 };
 export type AnimationRigBone = {
     /** Stable hierarchy path. Bone names alone are not guaranteed to be unique. */

package/dist/scene/native-texture.d.ts

@@ -0,0 +1,13 @@
+import { CompressedTexture } from 'three';
+export type NativeTextureFormat = 'bc7' | 'astc';
+export type NativeTextureFileKeys = Partial<Record<NativeTextureFormat, string>>;
+export declare function selectNativeTexture(variants: NativeTextureFileKeys | undefined, bc: boolean, astc: boolean): {
+    fileKey: string;
+    format: NativeTextureFormat;
+} | undefined;
+/** Read the narrowly scoped native KTX2 output emitted by our build plugin.
+ * No decoding or payload copies: mip data is viewed directly in the fetched buffer.
+ * Basis/supercompressed files continue to use Three's KTX2Loader.
+ */
+export declare function parseNativeTexture(buffer: ArrayBuffer, expectedFormat: NativeTextureFormat): CompressedTexture;
+//# sourceMappingURL=native-texture.d.ts.map

package/dist/scene/native-texture.js

@@ -0,0 +1,4 @@
+import{CompressedArrayTexture as t,CompressedTexture as e,LinearFilter as r,LinearMipmapLinearFilter as n,NoColorSpace as i,RGBA_ASTC_4x4_Format as a,RGBA_BPTC_Format as o,SRGBColorSpace as h,UnsignedByteType as c}from"three";export function selectNativeTexture(t,e,r){return e&&t?.bc7?{fileKey:t.bc7,format:"bc7"}:r&&t?.astc?{fileKey:t.astc,format:"astc"}:void 0}export function parseNativeTexture(g,s){const l=new Uint8Array(g);if(l.length<104||![171,75,84,88,32,50,48,187,13,10,26,10].every((t,e)=>l[e]===t))throw new Error("Invalid native KTX2 header");const f=new DataView(g),m=f.getUint32(12,!0),w=145===m||146===m;if("bc7"===s&&!w||"astc"===s&&!(157===m||158===m))throw new Error("Native KTX2 format does not match its variant");const U=f.getUint32(20,!0),u=f.getUint32(24,!0),p=f.getUint32(28,!0),d=f.getUint32(32,!0),v=f.getUint32(36,!0),M=f.getUint32(40,!0);if(!U||!u||p||1!==v||!M||M>Math.floor(Math.log2(Math.max(U,u)))+1||0!==f.getUint32(44,!0)||l.length<80+24*M)throw new Error("Unsupported native KTX2 layout or supercompression");const b=[];for(let t=0;t<M;t++){const e=80+24*t,r=Number(f.getBigUint64(e,!0)),n=Number(f.getBigUint64(e+8,!0)),i=Math.max(1,Math.floor(U/2**t)),a=Math.max(1,Math.floor(u/2**t)),o=Math.ceil(i/4)*Math.ceil(a/4)*16*Math.max(1,d);if(!Number.isSafeInteger(r)||r<80+24*M||n!==o||r+n>g.byteLength||f.getBigUint64(e+16,!0)!==BigInt(n))throw new Error("Invalid native KTX2 mip data");b.push({data:new Uint8Array(g,r,n),width:i,height:a})}const x=w?o:a,y=d>0?new t(b,U,u,d,x,c):new e(b,U,u,x,c);return y.colorSpace=146===m||158===m?h:i,y.minFilter=M>1?n:r,y.magFilter=r,y.needsUpdate=!0,y}/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

package/dist/shader-nodes/particle-parameter.d.ts

@@ -0,0 +1,4 @@
+import { FloatNode } from 'three-shader-graph';
+/** Stable bindings for static and animated values; static parameters skip texture sampling. */
+export declare function particleParameter(name: string, start: number, end?: number, easing?: string): FloatNode;
+//# sourceMappingURL=particle-parameter.d.ts.map

package/dist/shader-nodes/particle-parameter.js

@@ -0,0 +1,4 @@
+import{ease as e}from"@hology/nebula";import{ClampToEdgeWrapping as t,DataTexture as r,LinearFilter as n,RedFormat as a,UnsignedByteType as i,Vector3 as s}from"three";import{FloatNode as o,UniformFloatNode as l,UniformVec3Node as m,isWgslCompiler as c,textureSampler2d as p}from"three-shader-graph";import{shaderParameterUniformName as h}from"../shader/parameter.js";import{particleUniforms as u}from"./particle.js";const $=Object.keys(e);let g;export function particleParameter(o,c,u,v){const d=Math.max(0,$.indexOf("ease"+v));return new f(new l(h(o),c,void 0,!1),new m(h(o)+"_animation",new s(u??c,(d+.5)/$.length,null==u?0:1),void 0,!1),function(){if(g)return g;const s=new Uint8Array(64*$.length);for(let t=0;t<$.length;t++){const r=e[$[t]];for(let e=0;e<64;e++)s[64*t+e]=255*r(e/63)}const o=new r(s,64,$.length,a,i);return o.name="Shared particle parameter easing curves",o.minFilter=o.magFilter=n,o.wrapS=o.wrapT=t,o.generateMipmaps=!1,o.needsUpdate=!0,g=p(o),g}())}class f extends o{constructor(e,t,r){super(),this.start=e,this.settings=t,this.curve=r}compile(e){const t=e.get(this.start),r=e.get(this.settings),n=e.get(this.curve),a=e.get(u.energy),i="particle_parameter_"+e.variable(),s=c(e)?`textureSampleLevel(${n}Texture, ${n}Sampler, vec2<f32>(1.0 - ${a}, ${r}.y), 0.0).r`:`texture2D(${n}, vec2(1.0 - ${a}, ${r}.y)).r`;return{chunk:`${c(e)?`var ${i}: f32 = ${t};`:`float ${i} = ${t};`}\n        if (${r}.z > 0.5) {\n          ${i} = mix(${t}, ${r}.x, ${s});\n        }`,out:i}}}/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

package/dist/test/asset-resource-loader-texture-array.test.js

@@ -1,4 +1,4 @@
-import{describe as e,expect as t,it as r,vi as a}from"vitest";import{Texture as o}from"three";import{AssetResourceLoader as n}from"../scene/asset-resource-loader.js";function s(e,t){return{id:e,name:e,type:"texture",fileKey:`${e}.ktx2`,fileFormat:"ktx2",texture:{textureArrayFileKey:"shared-array.ktx2",textureArrayLayer:t}}}a.mock("../scene/materializer.js",()=>({applyMaterial:a.fn(),getConvertedFbxToGlbAssignedMaterialTextureFlipY:a.fn()})),a.hoisted(()=>{if("undefined"==typeof HTMLCanvasElement)return;const e=new Proxy({},{get:(e,t)=>(t in e||(e[t]=("string"!=typeof t||!t.startsWith("is"))&&a.fn()),e[t]),set:(e,t,r)=>(e[t]=r,!0)});Object.defineProperty(HTMLCanvasElement.prototype,"getContext",{configurable:!0,value:()=>e}),"undefined"==typeof AudioBuffer&&Object.defineProperty(globalThis,"AudioBuffer",{configurable:!0,value:class{}})}),e("AssetResourceLoader texture arrays",()=>{r("deduplicates concurrent loads by texture array file key",async()=>{const e=new n;let r;const l=new Promise(e=>{r=e}),i=a.fn(()=>l);e._getTextureLoader=()=>({loadAsync:i}),e.getUri=e=>e;const u=e.getTextureArray(s("texture-a",0)),d=e.getTextureArray(s("texture-b",1));t(i).toHaveBeenCalledTimes(1);const c=new o;r(c);const[y,f]=await Promise.all([u,d]);t(y.texture).toBe(c),t(f.texture).toBe(c),t(y.layerIndex).toBe(0),t(f.layerIndex).toBe(1)}),r("allows a failed texture array load to be retried",async()=>{const e=new n,r=new o,l=a.fn().mockRejectedValueOnce(new Error("load failed")).mockResolvedValueOnce(r);e._getTextureLoader=()=>({loadAsync:l}),e.getUri=e=>e;const i=s("texture-a",0);await t(e.getTextureArray(i)).rejects.toThrow("load failed"),await t(e.getTextureArray(i)).resolves.toEqual({texture:r,layerIndex:0}),t(l).toHaveBeenCalledTimes(2)})});/*
+import{describe as e,expect as t,it as a,vi as r}from"vitest";import{Texture as n}from"three";import{AssetResourceLoader as o}from"../scene/asset-resource-loader.js";function s(e=1){const t=new ArrayBuffer(120);new Uint8Array(t).set([171,75,84,88,32,50,48,187,13,10,26,10]);const a=new DataView(t);for(const[t,r]of[[12,146],[16,1],[20,4],[24,4],[32,e],[36,1],[40,1]])a.setUint32(t,r,!0);return a.setBigUint64(80,104n,!0),a.setBigUint64(88,16n,!0),a.setBigUint64(96,16n,!0),t}function i(e,t){return{id:e,name:e,type:"texture",fileKey:`${e}.ktx2`,fileFormat:"ktx2",texture:{textureArrayFileKey:"shared-array.ktx2",textureArrayLayer:t}}}r.mock("../scene/materializer.js",()=>({applyMaterial:r.fn(),getConvertedFbxToGlbAssignedMaterialTextureFlipY:r.fn()})),r.hoisted(()=>{if("undefined"==typeof HTMLCanvasElement)return;const e=new Proxy({},{get:(e,t)=>(t in e||(e[t]=("string"!=typeof t||!t.startsWith("is"))&&r.fn()),e[t]),set:(e,t,a)=>(e[t]=a,!0)});Object.defineProperty(HTMLCanvasElement.prototype,"getContext",{configurable:!0,value:()=>e}),"undefined"==typeof AudioBuffer&&Object.defineProperty(globalThis,"AudioBuffer",{configurable:!0,value:class{}})}),e("AssetResourceLoader texture arrays",()=>{a("uses native BC7 with the custom WebGPU device and deduplicates array requests",async()=>{const e=new o,a=e,n=r.spyOn(a.ktx2Loader,"detectSupport").mockReturnThis();e.initKtx2ForWebGpu({features:new Set(["texture-compression-bc"])}),a.getUri=e=>e;const l=r.spyOn(a.nativeTextureLoader,"loadAsync").mockResolvedValue(s()),c=r.spyOn(a.ktx2Loader,"loadAsync"),u=i("a",0);u.texture.nativeArrayFileKeys={bc7:"native-array.ktx2",astc:"mobile.ktx2"};const[d,x]=await Promise.all([e.getTextureArray(u),e.getTextureArray(u)]);t(d.texture).toBe(x.texture),t(d.texture.isCompressedArrayTexture).toBe(!0),t(l).toHaveBeenCalledExactlyOnceWith("native-array.ktx2"),t(c).not.toHaveBeenCalled(),t(n).toHaveBeenCalled(),r.restoreAllMocks()}),a("loads standalone native textures and falls back when their payload is invalid",async()=>{const e=new o,a=e;a.getUri=e=>e,a.nativeBcSupported=!0,e.setDataDir("data");const l=r.spyOn(a.nativeTextureLoader,"loadAsync").mockResolvedValueOnce(s(0)).mockResolvedValueOnce(new ArrayBuffer(0)),c=new n,u=r.spyOn(a.ktx2Loader,"loadAsync").mockResolvedValue(c),d=r.spyOn(console,"warn").mockImplementation(()=>{}),x=i("a",0);x.texture.nativeFileKeys={bc7:"native.ktx2"},t((await e.getTexture(x)).isCompressedTexture).toBe(!0);const y={...x,id:"b",fileKey:"fallback.ktx2"};t(await e.getTexture(y)).toBe(c),t(l).toHaveBeenCalledTimes(2),t(u).toHaveBeenCalledExactlyOnceWith("fallback.ktx2"),t(d).toHaveBeenCalled(),r.restoreAllMocks()}),a("selects native formats from WebGL extensions",async()=>{const e=new o,a=e;r.spyOn(a.ktx2Loader,"detectSupport").mockReturnThis(),e.initKtx2({extensions:{has:e=>"WEBGL_compressed_texture_astc"===e}}),t(a.nativeBcSupported).toBe(!1),t(a.nativeAstcSupported).toBe(!0),r.restoreAllMocks()}),a("deduplicates concurrent loads by texture array file key",async()=>{const e=new o;let a;const s=new Promise(e=>{a=e}),l=r.fn(()=>s);e._getTextureLoader=()=>({loadAsync:l}),e.getUri=e=>e;const c=e.getTextureArray(i("texture-a",0)),u=e.getTextureArray(i("texture-b",1));await r.waitFor(()=>t(l).toHaveBeenCalledTimes(1));const d=new n;a(d);const[x,y]=await Promise.all([c,u]);t(x.texture).toBe(d),t(y.texture).toBe(d),t(x.layerIndex).toBe(0),t(y.layerIndex).toBe(1)}),a("allows a failed texture array load to be retried",async()=>{const e=new o,a=new n,s=r.fn().mockRejectedValueOnce(new Error("load failed")).mockResolvedValueOnce(a);e._getTextureLoader=()=>({loadAsync:s}),e.getUri=e=>e;const l=i("texture-a",0);await t(e.getTextureArray(l)).rejects.toThrow("load failed"),await t(e.getTextureArray(l)).resolves.toEqual({texture:a,layerIndex:0}),t(s).toHaveBeenCalledTimes(2)})});/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/test/gpu-sprite-compiler.test.js

@@ -1,4 +1,4 @@
-import{describe as e,expect as t,it as a}from"vitest";import*as o from"three";import{NodeShaderMaterial as i,rgb as n,rgba as s,standardMaterial as r,textureSampler2d as l,uniformFloat as c,uniformSampler2d as p,uniformVec3 as m,varyingAttributes as d,vec3 as u}from"three-shader-graph";import{SerializedParamType as h}from"../scene/model.js";import{WorldCollisionMethod as y}from"../effects/vfx/vfx-asset.js";import{compileGpuSpriteEmitters as g,materializeGpuSpriteRenderClasses as f,requiresCpuVfxBackend as b,selectVfxBackend as w}from"../effects/vfx/gpu-sprite-compiler.js";import{prepareGpuSpriteBackend as C}from"../effects/vfx/gpu-sprite-backend.js";import{calculateGpuSpriteOptionalStateLayout as x,GPU_TRAIL_RENDER_CLASS_BYTES as v,GpuSpriteDirtyRange as B,getCompiledGpuSpriteMaterial as S,getGpuSpriteComputeWgsl as V,getGpuSpriteMaterialWgsl as T,getGpuTrailMaterialWgsl as M}from"../effects/vfx/gpu-sprite-runtime.js";import{Trail as E,trailUV as I}from"../effects/vfx/trail-renderer.js";import{timeUniforms as P}from"../shader-nodes/time.js";import{GpuSpriteSchedulerRuntime as O}from"../effects/vfx/gpu-sprite-scheduler-runtime.js";import{GpuSpriteTemplateCache as j,instantiateGpuSpriteTemplate as z}from"../effects/vfx/gpu-sprite-template.js";import{GpuSpriteWorldRuntime as q}from"../effects/vfx/gpu-sprite-world-runtime.js";import{GpuSpriteRenderClassCache as A}from"../effects/vfx/gpu-sprite-compiler.js";import{addGpuSpriteRenderGraphPasses as R}from"../effects/vfx/gpu-sprite-render-graph.js";import{gpuVfxCapacityClass as G}from"../effects/vfx/gpu-vfx-capacity.js";import{buildParticleLightingShaderHeader as L,ComputeKernel as _}from"@hology/webgpu-renderer";import{configureWebGpuRuntimeBindings as k}from"../rendering/webgpu-runtime-bridge.js";k({createComputeKernel:(e,t)=>new _(e,t),buildParticleLightingShaderHeader:L});import{sampleSceneColor as U}from"../shader-nodes/scene-sample.js";import{screenUV as D}from"../shader-nodes/depth.js";import{particleUniforms as W}from"../shader-nodes/particle.js";import{createGpuMeshAssetMaterial as F}from"../effects/vfx/vfx-gpu-material.js";const N=e=>({type:h.Number,value:e}),Z=e=>({type:h.Vector3,value:e});function H(e={}){return{type:"sprite",texture:"dot",color:"#ffffff",intensity:1,blendingMode:"additive",softness:0,bloom:!1,space:"world",opacityChannel:"alpha",...e}}function X(e={}){return{type:"mesh",assetId:"simple-mesh",space:"world",...e}}function Y(e={}){return{type:"trail",length:10,width:.5,taper:!0,color:"#40a0ff",colorEnd:"#ff4080",intensity:2,intensityEnd:.25,opacityStart:1,opacityEnd:0,bloom:!1,billboard:!0,opacityChannel:"alpha",space:"world",...e}}function $(e,t=H()){return{id:e,name:e,position:[0,0,0],rotation:[0,0,0],rate:{type:"once",count:2,delay:0},output:t,initializers:[{id:`${e}-life`,type:"lifetime",enabled:!0,params:{duration:N(2)}},{id:`${e}-position`,type:"positionSphere",enabled:!0,params:{position:Z([0,0,0]),radius:N(1),surface:{type:h.Boolean,value:!1}}}],behaviours:[]}}function Q(...e){return{id:"test-vfx",name:"test-vfx",type:"vfx",vfx:{emitters:e}}}e("GPU sprite compiler compatibility",()=>{a("keeps standard asset materials lit for GPU mesh particles",async()=>{const e=new o.Texture,a=new o.Texture,n=new o.Texture,s=new i({color:r({color:m("color",new o.Vector3(.3,.2,.1)).rgb.multiply(p("map",e).sample(d.uv).rgb),roughness:c("roughness",.8).multiply(p("roughnessMap",a).sample(d.uv).g),normal:p("normalMap",n).sample(d.uv).rgb,metalness:.1}),opacity:c("opacity",1)}),l=await F("material-id",{getAsset:async()=>({id:"material-id"}),getTexture:async()=>e,getMesh:async()=>new o.Mesh,getMaterial:async()=>s}),u=S(l),h=T(u,!0);t(u.requiresRendererShaderHeader).toBe(!0),t(u.needsWorldPosition).toBe(!0),t(u.fragmentMain).toContain("rendererPointLightForLight"),t(u.fragmentMain).toContain("rendererDirectionalLightForLight"),t(h).toContain("fn rendererPointLightCount()"),t(u.textures.map).toBe(e),t(u.textures.roughnessMap).toBe(a),t(u.textures.normalMap).toBe(n)}),a("bakes an authored effect input into emitter spawn delay",()=>{const e=$("bound-delay");e.rate.delayBinding={type:"vfxInput",inputId:"timing"};const a=Q(e);a.vfx.inputs=[{id:"timing",name:"Timing",type:"number",defaultValue:.5}];const i=g(a,[new o.Vector3]);t(i.compatibility.compatible).toBe(!0),t(i.emitters[0].rate.delay).toBe(.5)}),a("bakes the emitter rotation into world-space spawn position, velocity, and mesh rotation",()=>{const e=V(16,!0,!1,!1,!1,!0);t(e).toContain("zoneOffset = worldSpawnOffset(emitter, zoneOffset)"),t(e).toContain("let initialVelocity = worldSpawnDirection(emitter, localInitialVelocity)"),t(e).toContain("localInitialVelocity += randomConeDirection(sampledMeshNormal"),t(e).toContain("worldSpawnRotation(emitter), quaternionFromEulerXYZ(initialRotationEuler)"),t(e).toContain("optionalStates[meshStateOffset], quaternionFromEulerXYZ(rotationDelta)"),t(e).not.toContain("optionalStates[meshStateOffset] = quaternionFromEulerXYZ(rotationEuler)"),t(e).toContain("emitter.trailTransform0 = command.trailTransform0"),t(e).not.toMatch(/__[A-Z_]+__/)}),a("compiles pay-for-play child emitters and screen-space collision metadata",()=>{const e=$("parent");e.behaviours.push({id:"collision",type:"worldCollision",enabled:!0,params:{bounce:N(.6),friction:N(.2),lifeLoss:N(.5),debug:{type:h.Boolean,value:!0}}});const a=$("child");a.rate={type:"once",count:3,delay:0},a.spawnEvent="collision",e.children=[a];const i=g(Q(e),[new o.Vector3]);t(i.compatibility.compatible).toBe(!0),t(i.emitters).toHaveLength(2),t(i.emitters[0]).toMatchObject({hasWorldCollision:!0,collisionBounce:.6,collisionFriction:.2,collisionLifeLoss:.5,collisionDebug:!0}),t(i.emitters[1]).toMatchObject({parentEmitter:0,childParticlesPerParent:3,childSpawnEvent:2,childLevel:1,capacity:6});const n=V(16);t(n).not.toContain("collisionDepth"),t(n).not.toContain("optionalStates"),t(n).not.toContain("triangleRecord"),t(n).not.toMatch(/__[A-Z_]+__/);const s=V(16,!1,!1,!1,!1,!1,!1,0,0,!1,!1,0,0,!1,!0);t(s).toContain("var<storage, read_write> optionalStates"),t(s).toContain("let triangleRecord = optionalStates[triangleOffset]"),t(s).toContain("fn meshSamplerBoneMatrix"),t(s).toContain("meshSamplerVertexPosition(samplerOffset"),t(s).toContain("var triangleOffset = samplerOffset"),t(s).not.toContain("let triangleOffset = samplerOffset");const r=V(16,!1,!1,!1,!1,!1,!1,0,0,!0,!0,32,1);t(r).toContain("collisionDepth"),t(r).toContain("collisionStep <= 6u"),t(r).toContain("approachingVisibleSurface"),t(r).toContain("optionalStates[32u + owner.padding]"),t(r).not.toMatch(/__[A-Z_]+__/)}),a("supports local-space parent particles spawning local or world-space children",()=>{const e=$("parent",H({space:"local"})),a=$("local-child",H({space:"local"})),i=$("world-child",H({space:"world"}));e.children=[a,i];const n=g(Q(e),[new o.Vector3]);t(n.compatibility.compatible).toBe(!0),t(n.compatibility.issues).toEqual([]),t(n.emitters.map(e=>e.localSpace)).toEqual([!0,!0,!1]);const s=V(16,!1,!1,!1,!1,!1,!1,0,0,!1,!1,0,1);t(s).not.toContain("parentTransform = mat4x4");const r=V(16,!1,!1,!1,!1,!0,!1,0,0,!1,!1,0,1,!0);t(r).toContain("parentTransform = mat4x4"),t(r).toContain("parentEmitter.trail.z > 0.0 && emitter.trail.z < 0.0"),t(r).toContain("childEmissionEnd = parent.velocityLife.w"),t(r).toContain("particle.positionAge = vec4(particle.positionAge.xyz, age)"),t(r).not.toContain("childEventReady = parentAlive"),t(r).not.toMatch(/__[A-Z_]+__/)}),a("invalidates recycled parent spawn events during a new activation delay",()=>{const e=$("delayed-impact",H({space:"world"}));e.rate.delay=.13,e.children=[$("ground-impact",H({space:"world"}))];const a=g(Q(e),[new o.Vector3(12,0,8)]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].rate.delay).toBe(.13);const i=V(16,!1,!1,!1,!1,!1,!1,0,0,!1,!1,0,1);t(i).toContain("if (!emissionStarted || !stopAllowsEmission || totalSpawn <= simulationLocalSlot)"),t(i).toContain("particle.scaleAlphaEmitterGeneration.w = 0.0;"),t(i.indexOf("particle.scaleAlphaEmitterGeneration.w = 0.0;")).toBeLessThan(i.indexOf("particles[particleIndex] = particle;")),t(i).not.toMatch(/__[A-Z_]+__/),t(V(16)).not.toContain("particle.scaleAlphaEmitterGeneration.w = 0.0;")}),a("rejects world-space parents with local-space child output",()=>{const e=$("parent",H({space:"world"}));e.children=[$("child",H({space:"local"}))];const a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!1),t(a.compatibility.issues).toContainEqual(t.objectContaining({code:"child-emitter-local-space"}))}),a("orders child render classes by authored render order without changing simulation hierarchy",()=>{const e=$("parent",X({renderOrder:10})),a=$("child",H({renderOrder:-10}));e.children=[a];const i=g(Q(e),[new o.Vector3]);t(i.renderClasses.map(e=>e.output.renderOrder)).toEqual([-10,10]),t(i.emitters[0].parentEmitter).toBeUndefined(),t(i.emitters[0].renderClass).toBe(1),t(i.emitters[1]).toMatchObject({parentEmitter:0,renderClass:0})}),a("uses geometric world reservation classes without fixed template maxima",()=>{t([1,2,3,4,5,17].map(G)).toEqual([1,2,4,4,8,32])}),a("compiles stretched sprites into a velocity-aligned render class",async()=>{const e=g(Q($("stretched",function(e={}){return{type:"stretchedSprite",texture:"dot",color:"#ffffff",intensity:1,scale:.5,blendingMode:"additive",softness:0,bloom:!1,space:"world",opacityChannel:"alpha",...e}}({scale:.75}))),[new o.Vector3]);t(e.compatibility.compatible).toBe(!0);const a=await f(e.renderClasses,{getTexture:async()=>new o.Texture});t(a.renderClasses[0].stretchScale).toBe(.75);const i=T(S(a.renderClasses[0].material),!1);t(i).toContain("stretchedSpriteClipPosition"),t(i).toContain("bitcast<f32>(renderClass.data.w)")}),a("materializes billboard trails with CPU-compatible history sizing",async()=>{const e=g(Q($("trail",Y({length:9.6,uvMode:"repeat",unitsPerRepeat:.5}))),[new o.Vector3]);t(e.compatibility.compatible).toBe(!0),t(e.emitters).toHaveLength(1),t(e.emitters[0].capacity).toBe(2);const a=await f(e.renderClasses,{getTexture:async()=>new o.Texture});t(a.renderClasses[0].trail).toMatchObject({historyLength:11,width:.5,taper:!0,uvMode:"repeat",unitsPerRepeat:.5}),t(a.renderClasses[0].texture?.wrapS).toBe(o.RepeatWrapping),t(v).toBe(96);const i=V(16,!1,!1,!1,!0);t(i).toContain("@group(0) @binding(8) var<storage, read_write> optionalStates"),t(i).not.toContain("@binding(9)")}),a("streams local trail transforms through emitter commands without another storage binding",()=>{const e=g(Q($("attached-trail",Y({space:"local"}))),[new o.Vector3]);t(e.compatibility.compatible).toBe(!0);const a=V(16,!1,!1,!1,!0,!0);t(a).toContain("trailTransform0: vec4<f32>"),t(a).toContain("emitter.trailTransform3 = command.trailTransform3"),t(a).not.toContain("@binding(12)")}),a("compiles trail graph UV varyings into the procedural ribbon ABI",()=>{const e=new i({color:s(u(I.x,I.y,W.opacity),W.opacity)});E.applyTrailShaderParameters(e);const a=M(e,!0);t(a).toContain("struct GraphVertexInput"),t(a).toContain("nodeVertexID: f32"),t(a).toContain("nodeDistance: f32"),t(a).toContain("renderClass.uvSettings.x"),t(a).toContain("headDistance - mix(historyDistance(state, control), historyDistance(state, control + 1), t)"),t(a).toContain("emitterTransforms"),t(a).not.toContain("__TRAIL_"),t(a).not.toContain("output.uv ="),t(a).not.toContain("output.color ="),t(a).not.toContain("normalize(after - before)"),t(a).not.toContain("2.0, 2.0, 2.0, 0.0")}),a("binds shader graph elapsed time to the GPU particle frame clock",()=>{const e=new i({color:s(u(P.elapsed),1)}),a=M(e),o=T(S(e),!1);t(a).toContain("frame.time"),t(o).toContain("frame.time"),t(a).not.toContain("hology_elapsed_time:"),t(o).not.toContain("hology_elapsed_time:")}),a("converts authored sRGB behavior colors to the linear render space",()=>{const e=$("legacy-color",Y());e.behaviours.push({id:"color",type:"changeColor",enabled:!0,params:{a:{type:h.Color,value:"#918383"},b:{type:h.Color,value:"#4f4f4f"}}});const a=g(Q(e),[new o.Vector3]);t(a.emitters[0].colorStart.toArray()).toEqual(new o.Color("#918383").toArray()),t(a.emitters[0].colorEnd.toArray()).toEqual(new o.Color("#4f4f4f").toArray())}),a("materializes one mesh geometry and rejects mesh hierarchies with multiple geometries",async()=>{const e=$("mesh",X({space:"local"}));e.initializers.push({id:"mesh-scale-components",type:"scaleComponents",enabled:!0,params:{scale:Z([1,2,3])}},{id:"mesh-rotation",type:"rotation",enabled:!0,params:{rotation:Z([30,45,60])}}),e.behaviours.push({id:"mesh-scale-components-behaviour",type:"scaleComponents",enabled:!0,params:{a:Z([2,1,1]),b:Z([1,.5,2])}});const a=Q(e),r=g(a,[new o.Vector3]);t(r.compatibility.compatible).toBe(!0),t(r.renderClasses[0].output.type).toBe("mesh"),t(r.emitters[0].localSpace).toBe(!0),t(r.emitters[0].meshScaleStart.toArray()).toEqual([2,2,3]),t(r.emitters[0].meshScaleEnd.toArray()).toEqual([1,1,6]),t(r.emitters[0].meshRotation.w).not.toBe(1),t(r.emitters[0].meshRotationEuler.toArray()).toEqual([o.MathUtils.degToRad(30),o.MathUtils.degToRad(45),o.MathUtils.degToRad(60)]);const l=new o.Mesh(new o.BoxGeometry(1,1,1),new o.MeshBasicMaterial({color:3368601,opacity:.75})),c=await f(r.renderClasses,{getTexture:async()=>new o.Texture,getMesh:async()=>l});t(c.renderClasses[0].meshVertices?.length).toBe(288),t(c.renderClasses[0].meshColor?.getHex()).toBe(3368601),t(c.renderClasses[0].meshOpacity).toBe(.75),t(c.renderClasses[0].localSpace).toBe(!0);const p=new i({color:s(n(.4),1)}),m=await f(r.renderClasses,{getTexture:async()=>new o.Texture,getMesh:async()=>l},async()=>p);t(m.renderClasses[0].material).toBe(p);const d=new o.Group;d.add(new o.Mesh(new o.BoxGeometry),new o.Mesh(new o.BoxGeometry)),await t(f(r.renderClasses,{getTexture:async()=>new o.Texture,getMesh:async()=>d})).rejects.toThrow("exactly one mesh geometry")}),a("keeps an unconfigured mesh output GPU-compatible without rendering it",()=>{const e=g(Q($("unconfigured-mesh",X({assetId:null}))),[new o.Vector3]);t(e.compatibility.compatible).toBe(!0),t(e.compatibility.issues).toEqual([]),t(e.emitters).toEqual([]),t(e.renderClasses).toEqual([])}),a("treats an unselected mesh material override as the default material source",async()=>{const e=g(Q($("unselected-mesh-material",X({materialSource:"material",material:void 0}))),[new o.Vector3]),a=new i({color:s(n(.4),1)}),r=await f(e.renderClasses,{getTexture:async()=>new o.Texture,getMesh:async()=>new o.Mesh(new o.BoxGeometry)},async()=>a);t(e.compatibility.compatible).toBe(!0),t(r.renderClasses[0].material).toBe(a)}),a("keeps an unselected mesh shader graph on the GPU default material",async()=>{const e=g(Q($("unselected-mesh-graph",X({materialSource:"shaderGraph",shaderGraph:{source:"asset",assetId:null}}))),[new o.Vector3]),a=await f(e.renderClasses,{getTexture:async()=>new o.Texture,getMesh:async()=>new o.Mesh(new o.BoxGeometry)});t(e.compatibility.compatible).toBe(!0),t(()=>S(a.renderClasses[0].material)).not.toThrow()}),a("gates custom mesh materials on a compatible GPU material resolver",async()=>{const e=g(Q($("mesh-material",X({material:"material-id"}))),[new o.Vector3]);t(e.compatibility.compatible).toBe(!0);const a={getTexture:async()=>new o.Texture,getMesh:async()=>new o.Mesh(new o.BoxGeometry)};await t(f(e.renderClasses,a)).rejects.toThrow("compatible GPU material resolver");const n=new o.Texture,s=await f(e.renderClasses,a,async()=>new i({color:l(n).sample(d.uv)}));t(s.renderClasses[0].material).toBeInstanceOf(i);const r=S(s.renderClasses[0].material);t(Object.values(r.textures)).toEqual([n])}),a("materializes non-billboard trails with orientation history",async()=>{const e=g(Q($("oriented-trail",Y({billboard:!1}))),[new o.Vector3]);t(e.compatibility.compatible).toBe(!0);const a=await f(e.renderClasses,{getTexture:async()=>new o.Texture});t(a.renderClasses[0].trail).toMatchObject({billboard:!1});const i=V(16,!0,!1,!1,!0);t(i).toContain("trailSampleOffset + 1u"),t(i).toContain("quaternionMultiply(particleRotation, movementRotation)");const n=M(E.createBaseMaterial(),!1);t(n).toContain("renderClass.trail.w == 0u"),t(n).toContain("historySide(state, control)")}),a("changes the mesh render class when shader graph parameters change",()=>{const e={source:"asset",assetId:"mesh-graph"},a=g(Q($("mesh",X({materialSource:"shaderGraph",shaderGraph:e,shaderGraphParams:{intensity:N(1)}}))),[new o.Vector3]),i=g(Q($("mesh",X({materialSource:"shaderGraph",shaderGraph:e,shaderGraphParams:{intensity:N(2)}}))),[new o.Vector3]);t(a.renderClasses[0].key).not.toBe(i.renderClasses[0].key)}),a("preserves legacy mesh geometry transforms when requested",async()=>{const e=new o.Group,a=new o.Mesh((new o.BufferGeometry).setAttribute("position",new o.Float32BufferAttribute([1,0,0],3)));a.position.set(2,0,0),e.add(a);const i=g(Q($("modern",X())),[new o.Vector3]),n=g(Q($("legacy",X({useLegacyTransform:!0}))),[new o.Vector3]);t(i.renderClasses[0].key).not.toBe(n.renderClasses[0].key);const s={getTexture:async()=>new o.Texture,getMesh:async()=>e},r=await f(i.renderClasses,s),l=await f(n.renderClasses,s);t(r.renderClasses[0].meshVertices?.[0]).toBe(3),t(l.renderClasses[0].meshVertices?.[0]).toBe(1)}),a("does not reuse render classes across explicit template revisions",async()=>{const e=Q($("revisioned")),a={assets:{getTexture:async()=>new o.Texture},renderClassCache:new A},i=await(new j).resolve(e,{...a,revision:1}),n=await(new j).resolve(e,{...a,revision:2});t(i.template?.renderClasses[0]).not.toBe(n.template?.renderClasses[0])}),a("retains renderer-owned scene texture semantics for particle materials",()=>{const e=new i({color:U(D)}),a=S(e);t(Object.values(a.sceneTextures)).toEqual(["sceneColor"])}),a("retains the shared renderer geometry semantics for lit particle materials",()=>{const e=S(new i({color:r({color:n(6724044),roughness:.5,metalness:.1})}));t(e.needsWorldPosition).toBe(!0),t(e.needsWorldNormal).toBe(!0),t(e.requiresRendererShaderHeader).toBe(!0),t(e.fragmentMain).toContain("rendererDirectionalLightForLight"),t(L()).toContain("fn rendererCameraPosition()");const a=T(e,!0);t(a).toContain("fn rendererCameraPosition()"),t(a).toContain("rendererCameraPosition() - input.worldPosition"),t(a).toContain("@group(1) @binding(0)"),t(a).toContain("emitterTransform[0].xyz"),t(a).not.toContain("mat3x3<f32>(emitterTransforms["),t(a).toContain("fn normalMatrixFromLinearTransform"),t(a).not.toContain("inverse("),t(e.renderState.transparent).toBe(!1),t(e.renderState.depthWrite).toBe(!0),t(e.renderState.side).toBe(o.FrontSide)}),a("registers one ordered compute/render pair for a shared runtime",()=>{const e=[];let a;R({mainDepth:"depth",addPass:t=>e.push(t)},{executeCompute:()=>{},executeRender:(e,t)=>{a=t},getSceneTextureReads:()=>["sceneColorSnapshot"]},"color","WorldVfx"),t(e.map(e=>e.name)).toEqual(["WorldVfxSimulation","WorldVfxRender"]),t(e[1].dependsOn).toEqual(["WorldVfxSimulation"]),t(e[1].inputs).toMatchObject({sceneColorSnapshot:"sceneColorSnapshot"}),e[1].execute({}),t(a).toBe("color")}),a("coalesces touched emitter slots without allocating per mark",()=>{const e=new B;e.mark(7),e.mark(3),e.mark(5),t(e).toMatchObject({start:3,end:8,length:5}),e.clear(),t(e.length).toBe(0)}),a("generates particle-owner WGSL without reserved active identifiers",()=>{const e=V(16);t(e).toContain("enabled: u32"),t(e).not.toMatch(/\bactive\s*:/),t(e).not.toContain("owner.active"),t(e).toContain("fn applyEmitterCommandsMain"),t(e).toContain("@group(0) @binding(7) var<storage, read> emitterCommands"),t(e).toContain("var<storage, read_write> emitters"),t(e).toContain("timing: vec4<f32>"),t(e).toContain("let emitterDelta = select(frame.delta * emitter.timing.w, 0.0"),t(e).toContain("let sampledLife = mix(emitter.emission.z, emitter.emission.w"),t(e).toContain("particle.velocityLife = vec4(initialVelocity, particleLife)"),t(e).toContain("mix(emitter.colorStart.rgb, emitter.colorEnd.rgb, hash(particleSeed + 71u))"),t(e).toContain("select(animatedColor, particle.color.rgb, emitter.meshScaleStart.w > 0.5)")}),a("compiles random lifetime as a per-particle birth range",()=>{const e=$("random-life");e.initializers[0]={id:"random-life-range",type:"randomLifetime",enabled:!0,params:{minDuration:N(.5),maxDuration:N(2.5)}};const a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0]).toMatchObject({lifeMin:.5,life:2.5})}),a("compiles random initial color without lifetime interpolation",()=>{const e=$("random-color");e.initializers.push({id:"random-color-range",type:"randomColor",enabled:!0,params:{a:{type:h.Color,value:"#ff0000"},b:{type:h.Color,value:"#0000ff"}}});const a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].randomColor).toBe(!0)}),a("compiles point, box, line, ring, and sphere-surface spawn zones",()=>{const e=[["positionPoint",{position:Z([1,2,3])},0],["positionSphere",{position:Z([1,2,3]),radius:N(2),surface:{type:h.Boolean,value:!0}},1],["positionBox",{position:Z([1,2,3]),dimensions:Z([4,5,6])},2],["positionLine",{a:Z([1,2,3]),b:Z([4,5,6])},3],["positionRing",{position:Z([1,2,3]),rotation:Z([10,20,30]),radius:N(4),thickness:N(.5),angle:N(180)},4]];for(const[a,i,n]of e){const e=$(`zone-${a}`);e.initializers[1]={id:`zone-${a}`,type:a,enabled:!0,params:i};const s=g(Q(e),[new o.Vector3]);t(s.compatibility.compatible).toBe(!0),t(s.emitters[0].spawnZoneType).toBe(n)}const a=V(16);t(a).toContain("fn rotateSpawnPoint"),t(a).toContain("if (zoneType == 4u)")}),a("preserves legacy per-update sprite rotation behavior",()=>{const e=$("sprite-rotate");e.behaviours.push({id:"rotate-add",type:"rotateAdd",enabled:!0,params:{rotation:Z([0,0,200])}});const a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].spriteRotationStep).toBeCloseTo(o.MathUtils.degToRad(o.MathUtils.degToRad(200)));const i=V(16);t(i).toContain("var rotation = particle.color.w;"),t(i).toContain("rotation += emitter.rotationInitialSpriteStep.w * frame.padding1"),e.output=X();const n=g(Q(e),[new o.Vector3]);t(n.compatibility.compatible).toBe(!0),t(n.emitters[0].meshRotationStep.z).toBeCloseTo(o.MathUtils.degToRad(o.MathUtils.degToRad(200)));const s=V(16,!0);t(s).toContain("rotationEuler: vec4<f32>"),t(s).toContain("fn quaternionFromEulerXYZ"),t(s).toContain("emitter.rotationStep.xyz * frame.padding1"),e.initializers.push({id:"random-mesh-rotation",type:"randomRotation",enabled:!0,params:{axis:{type:h.String,value:"Y"}}});const r=g(Q(e),[new o.Vector3]);t(r.compatibility.compatible).toBe(!0),t(r.emitters[0].randomMeshRotationAxis).toBe(3),t(s).toContain("randomRotationAxis == 1u"),t(s).toContain("randomRotationAxis == 4u")}),a("compiles radial velocity without per-particle auxiliary storage",()=>{const e=$("radial-velocity");e.initializers.push({id:"radial",type:"radialVelocity",enabled:!0,params:{speed:N(4),direction:Z([0,1,0]),spread:N(30)}});const a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].hasRadialVelocity).toBe(!0),t(a.emitters[0].radialVelocitySpeed).toBe(4),t(a.emitters[0].radialVelocitySpread).toBeCloseTo(Math.PI/6);const i=V(16);t(i).toContain("fn radialVelocity"),t(i).toContain("emitter.radialMetadata.y > 0.5")}),a("compiles one attraction or repulsion field per emitter",()=>{const e=$("attraction");e.behaviours.push({id:"attract",type:"attraction",enabled:!0,params:{target:Z([1,2,3]),force:N(4),radius:N(5)}});const a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].attractionTarget.toArray()).toEqual([1,2,3]),t(a.emitters[0].attractionForce).toBe(4),e.behaviours[0].type="repulsion";const i=g(Q(e),[new o.Vector3]);t(i.compatibility.compatible).toBe(!0),t(i.emitters[0].attractionForce).toBe(-4);const n=V(16);t(n).toContain("attractionDistanceSq < attractionRadiusSq")}),a("compiles mesh alignment modes into spawn-only parameters",()=>{const e=$("aligned-mesh",X());e.initializers.push({id:"align",type:"alignRotation",enabled:!0,params:{axis:{type:h.String,value:"+X"},mode:{type:h.String,value:"AlongVelocity"},offset:Z([10,20,30]),center:Z([1,2,3])}});const a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].alignRotationAxis.toArray()).toEqual([1,0,0]),t(a.emitters[0].alignRotationMode).toBe(3),t(a.emitters[0].alignRotationOffset.x).toBeCloseTo(o.MathUtils.degToRad(10));const i=V(16,!0);t(i).toContain("fn quaternionFromUnitVectors"),t(i).toContain("alignRotationMode == 3u")}),a("groups authored render classes deterministically",()=>{const e=g(Q($("a"),$("b"),$("c",H({blendingMode:"normal"}))),[new o.Vector3]);t(e.compatibility.compatible).toBe(!0),t(e.renderClasses).toHaveLength(2),t(e.emitters.map(e=>e.renderClass)).toEqual([0,0,1])}),a("can lay out emitter allocations contiguously per dynamic effect instance",()=>{const e=Q($("first"),$("second",H({blendingMode:"normal"}))),a=[new o.Vector3,new o.Vector3(1,0,0)],i=g(e,a),n=g(e,a,"instance-major");t(i.emitters.map(e=>e.renderClass)).toEqual([0,0,1,1]),t(n.emitters.map(e=>e.renderClass)).toEqual([0,1,0,1])}),a("reports sparse active-page simulation capacity",async()=>{const e=await C({asset:Q($("paged")),instancePositions:[new o.Vector3,new o.Vector3,new o.Vector3],instanceLayout:"instance-major",particlePageSize:2,assets:{getTexture:async()=>new o.Texture}});e.runtime.setActivePages([0,2]),t(e.runtime.getStats()).toMatchObject({capacity:6,activePageCount:2,simulatedCapacity:4})}),a("compacts active page padding out of the simulation schedule",async()=>{const e=await O.create({asset:Q($("tiny-paged-effect")),maximumInstances:2,particlePageSize:256,assets:{getTexture:async()=>new o.Texture}});e.spawn(new o.Vector3),e.flushActivePages(),t(e.runtime.getStats()).toMatchObject({capacity:512,activePageCount:1,simulatedCapacity:2});const a=V(256);t(a).toContain("let particleIndex = activeParticleIndices[id.x]"),t(a).not.toContain("id.x % pageSize"),e.dispose()}),a("sizes alive indices by logical particles instead of render-class count",async()=>{const e=await C({asset:Q($("additive"),$("normal",H({blendingMode:"normal"}))),instancePositions:[new o.Vector3,new o.Vector3],instanceLayout:"instance-major",particlePageSize:4,assets:{getTexture:async()=>new o.Texture}});t(e.runtime.getStats()).toMatchObject({capacity:8,renderClassCount:2,aliveIndexCapacity:8,aliveIndexBytes:32});const a=V(4);t(a).toContain("aliveIndices[indirect[renderClass].firstInstance + outputIndex]"),t(a).not.toContain("renderClass * u32(frame.capacity)")}),a("allocates and recycles multi-page dynamic effect instances",async()=>{const e=$("paged-instance");e.position=[2,0,0];const a=await O.create({asset:Q(e),maximumInstances:2,particlePageSize:1,assets:{getTexture:async()=>new o.Texture}}),i=a.spawn(new o.Vector3);t(a.runtime.emitters[0].position.x).toBe(2),t(a.pause(i)).toBe(!0),t(a.runtime.emitters[0].paused).toBe(!0),a.update(.1),t(a.scheduler.getInstance(i.handle)).not.toBeNull(),t(a.play(i)).toBe(!0),t(a.runtime.emitters[0].paused).toBe(!1),t(a.setTimescale(i,2)).toBe(!0),t(a.runtime.emitters[0].timescale).toBe(2),t(a.stop(i)).toBe(!0),t(a.runtime.emitters[0].stopTime).toBeGreaterThanOrEqual(0),t(a.runtime.emitters[0].expireWithin).toBe(-1),t(i.pages).toHaveLength(2),a.flushActivePages(),t(a.runtime.getStats()).toMatchObject({activePageCount:2,simulatedCapacity:2}),t(a.destroy(i)).toBe(!0);const n=a.spawn(new o.Vector3(1,0,0));t(new Set(n.pages)).toEqual(new Set(i.pages)),t(n.handle.generation).not.toBe(i.handle.generation),a.dispose()}),a("caps GPU particle drain time for expire and kill lifecycle behavior",async()=>{const e=await O.create({asset:Q($("expiring")),maximumInstances:2,assets:{getTexture:async()=>new o.Texture}}),a=e.spawn(new o.Vector3);t(e.stop(a,.5)).toBe(!0),t(e.runtime.emitters[0].expireWithin).toBe(.5);for(let t=0;t<4;t++)e.update(.1);t(e.scheduler.getInstance(a.handle)).not.toBeNull(),e.update(.1),t(e.scheduler.getInstance(a.handle)).toBeNull();const i=e.spawn(new o.Vector3);t(e.stop(i,0)).toBe(!0),e.update(.001),t(e.scheduler.getInstance(i.handle)).toBeNull(),e.dispose()}),a("rejects a template pool before allocation when its storage budget is exceeded",async()=>{const e=await O.create({asset:Q($("over-budget")),maximumInstances:128,particlePageSize:1,maximumStorageBytes:1,assets:{getTexture:async()=>new o.Texture}});t(e).toBeNull()}),a("compiles delayed and finite continuous emission timing",()=>{const e=$("delayed");e.rate={type:"once",count:2,delay:.25};const a=$("finite");a.rate={type:"continuous",count:2,time:.1,delay:0,duration:1};const i=g(Q(e,a),[new o.Vector3]);t(i.compatibility.compatible).toBe(!0),t(i.emitters[0].rate).toMatchObject({type:"once",delay:.25}),t(i.emitters[1].rate).toMatchObject({type:"continuous",delay:0,duration:1})}),a("treats zero continuous duration as unlimited like the CPU rate",()=>{const e=$("unlimited");e.rate={type:"continuous",count:2,time:.1,delay:0,duration:0};const a=g(Q(e),[new o.Vector3]);t(a.compatibility.issues.map(e=>e.code)).not.toContain("rate-duration")}),a("compiles bound lifetime metadata but falls back for unsupported input targets",()=>{const e=Q($("input-test"));e.vfx.inputs=[{id:"speed",name:"Speed",type:"number",defaultValue:1}],t(g(e,[new o.Vector3]).compatibility.compatible).toBe(!0),e.vfx.emitters[0].initializers[0].params.duration.binding={type:"vfxInput",inputId:"speed"};const a=g(e,[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.inputBindings).toEqual([t.objectContaining({inputId:"speed",emitterIndex:0,target:"initializer:lifetime:duration"})]),e.vfx.emitters[0].initializers.push({id:"bound-velocity",type:"velocity",enabled:!0,params:{velocity:{type:h.Vector3,value:[0,1,0],binding:{type:"vfxInput",inputId:"speed"}}}}),t(g(e,[new o.Vector3]).compatibility.issues.map(e=>e.code)).toContain("vfx-input-binding")}),a("falls back for a bound continuous lifetime until particle capacity can grow",()=>{const e=$("continuous-bound-life");e.rate={type:"continuous",count:1,time:.1,delay:0,duration:0},e.initializers[0].params.duration.binding={type:"vfxInput",inputId:"life"};const a=Q(e);a.vfx.inputs=[{id:"life",name:"Life",type:"number",defaultValue:2}];const i=g(a,[new o.Vector3]);t(i.compatibility.compatible).toBe(!1),t(i.compatibility.issues.map(e=>e.code)).toContain("vfx-input-binding"),t(i.inputBindings).toEqual([])}),a("caches compiled templates while keeping instance emitter state independent",async()=>{const e=Q($("cached-template")),a=new j;let i=0;const n={assets:{getTexture:async()=>(i+=1,new o.Texture)}},s=await a.resolve(e,n),r=await a.resolve(e,n);t(r.template).toBe(s.template),t(i).toBe(1),t(a.getStats()).toMatchObject({builds:1,hits:1});const l=z(s.template,[new o.Vector3(1,0,0),new o.Vector3(2,0,0)]);t(l[0].position).not.toBe(l[1].position),l[0].position.x=100,t(l[1].position.x).toBe(2),t(s.template.emitters[0].position.x).toBe(0),a.invalidate(e),await a.resolve(e,n),t(a.getStats()).toMatchObject({builds:2,hits:1,invalidations:1}),await a.resolve(e,{...n,revision:2}),t(a.getStats()).toMatchObject({builds:3,hits:1,invalidations:2})}),a("applies a bound lifetime only to the addressed scheduled instance",async()=>{const e=$("bound-life");e.initializers[0].params.duration.binding={type:"vfxInput",inputId:"life"},e.initializers[1].params.radius.binding={type:"vfxInput",inputId:"radius"},e.initializers.push({id:"velocity",type:"velocity",enabled:!0,params:{velocity:{type:h.Vector3,value:[0,0,0],binding:{type:"vfxInput",inputId:"velocity"}}}});const a=Q(e);a.vfx.inputs=[{id:"life",name:"Life",type:"number",defaultValue:1},{id:"radius",name:"Radius",type:"number",defaultValue:1},{id:"velocity",name:"Velocity",type:"vec3",defaultValue:[0,0,0]}];const i=await O.create({asset:a,maximumInstances:2,particlePageSize:1,assets:{getTexture:async()=>new o.Texture}}),n=i.spawn(new o.Vector3),s=i.spawn(new o.Vector3);t(i.setInput(n,"life",4)).toBe(!0),t(i.runtime.emitters[0].life).toBe(4),t(i.runtime.emitters[1].life).toBe(2),t(i.setInput(n,"radius",3)).toBe(!0),t(i.runtime.emitters[0].positionRadius).toBe(3),t(i.setInput(n,"velocity",new o.Vector3(1,2,3))).toBe(!0),t(i.runtime.emitters[0].velocityMin.toArray()).toEqual([1,2,3]),t(i.setInput(s,"missing",5)).toBe(!1),i.dispose()}),a("schedules different templates in one arena and merges shared render classes",async()=>{const e=H(),a=await q.create({templates:[{asset:Q($("world-a",e)),maximumInstances:2},{asset:Q($("world-b",{...e})),maximumInstances:2}],assets:{getTexture:async()=>new o.Texture},templateCache:new j,renderClassCache:new A,particlePageSize:1}),i=a.spawn(0,new o.Vector3),n=a.spawn(1,new o.Vector3(1,0,0));a.flushActivePages(),t(a.templateCount).toBe(2),t(a.runtime.getStats()).toMatchObject({renderClassCount:1,activePageCount:4}),t(a.scheduler.getStats()).toMatchObject({activeInstances:2,arena:{usedPages:4}}),t(a.destroy(i)).toBe(!0),t(a.destroy(n)).toBe(!0),a.flushActivePages(),t(a.runtime.hasActiveParticles).toBe(!1),t(a.runtime.getStats()).toMatchObject({aliveParticles:0,activePageCount:0,simulatedCapacity:0}),a.dispose()}),a("routes per-instance lifecycle changes through a shared multi-template world",async()=>{const e=$("world-lifecycle");e.position=[2,0,0];const a=await q.create({templates:[{asset:Q(e),maximumInstances:1},{asset:Q($("world-neighbour")),maximumInstances:1}],assets:{getTexture:async()=>new o.Texture},particlePageSize:1}),i=a.spawn(0,new o.Vector3(3,0,0));t(a.runtime.emitters[0].position.x).toBe(5),t(a.setPosition(i,new o.Vector3(7,0,0))).toBe(!0),t(a.runtime.emitters[0].position.x).toBe(9),t(a.pause(i)).toBe(!0),t(a.runtime.emitters[0].paused).toBe(!0),t(a.play(i)).toBe(!0),t(a.setTimescale(i,.5)).toBe(!0),t(a.runtime.emitters[0].timescale).toBe(.5),t(a.stop(i,0)).toBe(!0),a.update(.001),t(a.has(i)).toBe(!1),t(a.setPosition(i,new o.Vector3)).toBe(!1),a.dispose()}),a("rejects a shared world before runtime allocation when its storage budget is exceeded",async()=>{const e=await q.create({templates:[{asset:Q($("world-over-budget")),maximumInstances:2}],assets:{getTexture:async()=>new o.Texture},particlePageSize:1,maximumStorageBytes:1});t(e).toBeNull()}),a("falls back to CPU for semantic mismatches",()=>{const e=$("soft-local",H({softness:1,space:"local",lockY:!0}));e.behaviours.push({id:"animation",type:"animation",enabled:!0,params:{}});const a=g(Q(e),[new o.Vector3]),i=w(a.compatibility);t(a.compatibility.compatible).toBe(!1),t(a.compatibility.issues.map(e=>e.code)).toEqual(t.arrayContaining(["behaviour:animation"])),t(i.backend).toBe("cpu"),t(w(a.compatibility,"gpu").backend).toBe("gpu")}),a("intentionally selects CPU simulation for physics-raycast world collision",()=>{const e=$("physics-collision");e.behaviours.push({id:"collision",type:"worldCollision",enabled:!0,params:{method:{type:h.String,value:y.PhysicsRaycast}}});const a=Q(e),i=g(a,[new o.Vector3]);t(b(a)).toBe(!0),t(i.compatibility.compatible).toBe(!1),t(i.compatibility.issues).toContainEqual(t.objectContaining({severity:"requirement",code:"physics-raycast-collision"})),t(w(i.compatibility).backend).toBe("cpu"),t(w(i.compatibility,"gpu").backend).toBe("cpu")}),a("compiles vortex with pay-for-play previous-velocity state",()=>{const e=$("vortex");e.behaviours.push({id:"vortex",type:"vortex",enabled:!0,params:{axis:Z([0,5,0]),amount:N(1.25)}});const a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].vortexAxis.toArray()).toEqual([0,5,0]),t(a.emitters[0].vortexAmount).toBe(1.25),t(V(16,!1,!1)).not.toContain("vortexVelocities");const i=V(16,!1,!0);t(i).toContain("@group(0) @binding(8)"),t(i).toContain("behaviourVelocity -= optionalStates[0u + particleIndex].xyz")}),a("compiles the remaining initializer and motion behaviours",()=>{const e=$("remaining-motion");e.initializers.push({id:"mass",type:"mass",enabled:!0,params:{min:N(2)}}),e.behaviours.push({id:"drift",type:"randomDrift",enabled:!0,params:{drift:Z([1,2,3]),delay:N(.25),ease:{type:h.String,value:"OutQuad"}}},{id:"follow",type:"followParent",enabled:!0,params:{speed:N(4)}},{id:"move",type:"moveTo",enabled:!0,params:{target:Z([5,6,7]),ease:{type:h.String,value:"InQuad"}}});const a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0]).toMatchObject({mass:2,randomDriftDelay:.25,randomDriftEasing:2,followParentSpeed:4,hasFollowParent:!0,moveToEasing:1,hasMoveTo:!0}),t(a.emitters[0].randomDrift.toArray()).toEqual([1,2,3]),t(a.emitters[0].moveToTarget.toArray()).toEqual([5,6,7])}),a("compiles authored easing independently for visual behavior channels",()=>{const e=$("easing");e.behaviours.push({id:"scale",type:"scale",enabled:!0,params:{a:N(0),b:N(1),ease:{type:h.String,value:"OutBack"}}},{id:"color",type:"changeColor",enabled:!0,params:{a:{type:h.Color,value:"#ff0000"},b:{type:h.Color,value:"#0000ff"},ease:{type:h.String,value:"InCubic"}}},{id:"opacity",type:"changeOpacity",enabled:!0,params:{a:N(0),b:N(1),ease:{type:h.String,value:"BumpSharp"}}});const a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].curveEasing.toArray()).toEqual([18,4,20,0]);const i=V(16);t(i).toContain("fn applyEasing"),t(i).toContain("mix(emitter.colorStart.rgb, emitter.colorEnd.rgb, colorProgress)"),t(i).toContain("mix(emitter.scales.xy, emitter.scales.zw, scaleProgress)")}),a("compiles disperse into optional shared particle state",()=>{const e=$("disperse");e.behaviours.push({id:"disperse",type:"disperse",enabled:!0,params:{distance:N(3),axis:{type:h.String,value:"XZ"},ease:{type:h.String,value:"InOutSine"}}});const a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].disperseDistance).toBe(3),t(a.emitters[0].dispersePlane).toBe(2),t(a.emitters[0].disperseEasing).toBe(12),t(V(16)).not.toContain("disperseStates");const i=V(16,!1,!1,!0);t(i).toContain("@group(0) @binding(8)"),t(i).toContain("optionalStates[0u + particleIndex].w = disperseProgress")}),a("consolidates every optional simulation feature into the eighth storage binding",()=>{const e=V(16,!0,!0,!0,!0,!1,!1,48,64),a=[...e.matchAll(/@group\(0\) @binding\((\d+)\) var<storage/g)].map(e=>Number(e[1]));t(a).toEqual([1,2,3,4,5,6,7,8]),t(e).toContain("optionalStates[48u + particleIndex]"),t(e).toContain("optionalStates[64u + particleIndex]"),t(e).not.toMatch(/@binding\((9|10|11)\)/)}),a("lays out optional state regions without overlap",()=>{t(x({capacity:16,particleTransforms:!0,vortex:!0,disperse:!0,trailHistoryEntries:20})).toEqual({vortexOffset:48,disperseOffset:64,collisionEventOffset:80,trailOffset:80,meshSamplerOffset:100,entries:100,bytes:1600})}),a("materializes decal outputs as shared unit-box mesh render classes",async()=>{const e=$("decal");e.output={type:"decal",space:"world",colorMap:"",alphaMap:"",color:"#ffffff",unlit:!0,intensity:1,blendingMode:"normal",bloom:!1};const a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0);const r=new i({color:s(n(1),1)}),l=await f(a.renderClasses,{getTexture:async()=>new o.Texture},async()=>r);t(l.renderClasses[0].meshVertices?.length).toBe(288),t(l.renderClasses[0].material).toBe(r)}),a("materializes generated shape outputs through the shared mesh path",async()=>{const e=$("shape");e.output={type:"shape",shape:"box",params:{},material:"shape-material",materialSource:"material",space:"world"};const a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0);const r=new i({color:s(n(1),1)}),l=await f(a.renderClasses,{getTexture:async()=>new o.Texture},async()=>r);t(l.renderClasses[0].meshVertices?.length).toBe(288)}),a("forwards the physical particle index to fragment-stage model-matrix graphs",()=>{const e=S(new i({color:s(n(1),1)})),a=T(e,!0);t(a).toContain("color: vec4<f32>, instanceIndex: u32"),t(a).toContain("gpuParticle.color, particleIndex)"),t(a).toContain("@interpolate(flat) instanceIndex: u32"),t(a).toContain("output.instanceIndex = particleIndex")}),a("compiles soft default sprites with a pay-for-play scene-depth requirement",async()=>{const e=$("soft-sprite",H({softness:2})),a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0);const i=(await f(a.renderClasses,{getTexture:async()=>new o.Texture})).renderClasses[0].material,n=S(i);t(Object.values(n.sceneTextures)).toContain("sceneDepth")}),a("disables depth writes only for transparent custom GPU sprite materials",async()=>{const e=$("graph-sprite",H({materialSource:"shaderGraph",shaderGraph:{source:"asset",assetId:"graph"}})),a=g(Q(e),[new o.Vector3]),r=new i({color:s(n(1),.5),transparent:!0}),l=await f(a.renderClasses,{getTexture:async()=>new o.Texture},async()=>r);t(l.renderClasses[0].material).toBe(r),t(r.depthWrite).toBe(!1),t(S(r).renderState.depthWrite).toBe(!1);const c=new i({color:s(n(1),1)}),p=await f(a.renderClasses,{getTexture:async()=>new o.Texture},async()=>c);t(p.renderClasses[0].material).toBe(c),t(c.depthWrite).toBe(!0),t(S(c).renderState.depthWrite).toBe(!0)}),a("supports local-space sprite render classes through the shared emitter transform table",async()=>{const e=$("local-sprite",H({space:"local"})),a=g(Q(e),[new o.Vector3(4,5,6)]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].localSpace).toBe(!0),t(a.emitters[0].position.toArray()).toEqual([0,0,0]);const i=await f(a.renderClasses,{getTexture:async()=>new o.Texture});t(i.renderClasses[0].localSpace).toBe(!0)}),a("falls back before rendering when an authored graph cannot be resolved",async()=>{const e=$("graph",H({materialSource:"shaderGraph",shaderGraph:{source:"asset",assetId:"missing-graph"}})),a=await C({asset:Q(e),instancePositions:[new o.Vector3],assets:{getTexture:async()=>new o.Texture}});t(a.backend).toBe("cpu"),t(a.runtime).toBeNull(),t(a.reasons[0]).toContain("GPU material compilation failed")}),a("compiles default flipbook, texture, UV, and particle semantics to WGSL",async()=>{const e=$("flipbook",H({flipbook:{enabled:!0,rows:4,columns:4,fps:12,mode:"loop"}})),a=g(Q(e),[new o.Vector3]),i=await f(a.renderClasses,{getTexture:async()=>new o.Texture}),n=S(i.renderClasses[0].material);t(n.fragmentMain).toContain("textureSample"),t(`${n.vertexMain}\n${n.fragmentMain}`).toContain("gpuParticle.positionAge.w"),t(n.varyings.length).toBeGreaterThan(0)}),a("supports component scale-over-life for sprites",()=>{const e=$("stretched-smoke");e.behaviours.push({id:"stretch",type:"scaleComponents",enabled:!0,params:{a:Z([.25,1,1]),b:Z([2,.5,1]),ease:{type:22,value:"Linear"}}});const a=g(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].meshScaleStart.toArray()).toEqual([.25,1,1]),t(a.emitters[0].meshScaleEnd.toArray()).toEqual([2,.5,1])}),a("compiles authored scale and rotation input bindings",()=>{const e=$("input-driven",X());e.initializers.push({id:"scale",type:"scale",enabled:!0,params:{scale:{...N(1),binding:{type:"vfxInput",inputId:"scale-input"}}}},{id:"rotation",type:"rotation",enabled:!0,params:{rotation:{...Z([0,-100,0]),binding:{type:"vfxInput",inputId:"rotation-input"}}}}),e.behaviours.push({id:"rotate",type:"rotate",enabled:!0,params:{rotation:{...Z([0,-30,0]),binding:{type:"vfxInput",inputId:"step-input"}}}});const a=Q(e);a.vfx.inputs=[{id:"scale-input",name:"Scale",type:"number",defaultValue:1},{id:"rotation-input",name:"Rotation",type:"vec3",defaultValue:[0,-100,0]},{id:"step-input",name:"Rotation step",type:"vec3",defaultValue:[0,-30,0]}];const i=g(a,[new o.Vector3]);t(i.compatibility.compatible).toBe(!0),t(i.inputBindings.map(e=>e.target)).toEqual(["initializer:scale:scale","initializer:rotation:rotation","behaviour:rotate:rotation"])})});/*
+import{describe as e,expect as t,it as a}from"vitest";import*as o from"three";import{NodeShaderMaterial as i,rgb as n,rgba as s,standardMaterial as r,textureSampler2d as l,uniformFloat as c,uniformSampler2d as p,uniformVec3 as m,varyingAttributes as d,vec3 as u}from"three-shader-graph";import{SerializedParamType as h}from"../scene/model.js";import{WorldCollisionMethod as y}from"../effects/vfx/vfx-asset.js";import{compileGpuSpriteEmitters as f,materializeGpuSpriteRenderClasses as g,requiresCpuVfxBackend as b,selectVfxBackend as w}from"../effects/vfx/gpu-sprite-compiler.js";import{prepareGpuSpriteBackend as C}from"../effects/vfx/gpu-sprite-backend.js";import{calculateGpuSpriteOptionalStateLayout as v,GPU_TRAIL_RENDER_CLASS_BYTES as x,GpuSpriteDirtyRange as B,getCompiledGpuSpriteMaterial as S,getGpuSpriteComputeWgsl as V,getGpuSpriteMaterialWgsl as T,getGpuTrailMaterialWgsl as M}from"../effects/vfx/gpu-sprite-runtime.js";import{Trail as E,trailUV as I}from"../effects/vfx/trail-renderer.js";import{timeUniforms as P}from"../shader-nodes/time.js";import{GpuSpriteSchedulerRuntime as O}from"../effects/vfx/gpu-sprite-scheduler-runtime.js";import{GpuSpriteTemplateCache as j,instantiateGpuSpriteTemplate as z}from"../effects/vfx/gpu-sprite-template.js";import{GpuSpriteWorldRuntime as q}from"../effects/vfx/gpu-sprite-world-runtime.js";import{GpuSpriteRenderClassCache as A}from"../effects/vfx/gpu-sprite-compiler.js";import{addGpuSpriteRenderGraphPasses as R}from"../effects/vfx/gpu-sprite-render-graph.js";import{gpuVfxCapacityClass as k}from"../effects/vfx/gpu-vfx-capacity.js";import{buildParticleLightingShaderHeader as G,ComputeKernel as L}from"@hology/webgpu-renderer";import{configureWebGpuRuntimeBindings as _}from"../rendering/webgpu-runtime-bridge.js";_({createComputeKernel:(e,t)=>new L(e,t),buildParticleLightingShaderHeader:G});import{sampleSceneColor as U}from"../shader-nodes/scene-sample.js";import{screenUV as D}from"../shader-nodes/depth.js";import{particleUniforms as F}from"../shader-nodes/particle.js";import{createGpuMeshAssetMaterial as W}from"../effects/vfx/vfx-gpu-material.js";const H=e=>({type:h.Number,value:e}),N=e=>({type:h.Vector3,value:e});function Z(e={}){return{type:"sprite",texture:"dot",color:"#ffffff",intensity:1,blendingMode:"additive",softness:0,bloom:!1,space:"world",opacityChannel:"alpha",...e}}function X(e={}){return{type:"mesh",assetId:"simple-mesh",space:"world",...e}}function Y(e={}){return{type:"trail",length:10,width:.5,taper:!0,color:"#40a0ff",colorEnd:"#ff4080",intensity:2,intensityEnd:.25,opacityStart:1,opacityEnd:0,bloom:!1,billboard:!0,opacityChannel:"alpha",space:"world",...e}}function $(e,t=Z()){return{id:e,name:e,position:[0,0,0],rotation:[0,0,0],rate:{type:"once",count:2,delay:0},output:t,initializers:[{id:`${e}-life`,type:"lifetime",enabled:!0,params:{duration:H(2)}},{id:`${e}-position`,type:"positionSphere",enabled:!0,params:{position:N([0,0,0]),radius:H(1),surface:{type:h.Boolean,value:!1}}}],behaviours:[]}}function Q(...e){return{id:"test-vfx",name:"test-vfx",type:"vfx",vfx:{emitters:e}}}e("GPU sprite compiler compatibility",()=>{a("keeps standard asset materials lit for GPU mesh particles",async()=>{const e=new o.Texture,a=new o.Texture,n=new o.Texture,s=new i({color:r({color:m("color",new o.Vector3(.3,.2,.1)).rgb.multiply(p("map",e).sample(d.uv).rgb),roughness:c("roughness",.8).multiply(p("roughnessMap",a).sample(d.uv).g),normal:p("normalMap",n).sample(d.uv).rgb,metalness:.1}),opacity:c("opacity",1)}),l=await W("material-id",{getAsset:async()=>({id:"material-id"}),getTexture:async()=>e,getMesh:async()=>new o.Mesh,getMaterial:async()=>s}),u=S(l),h=T(u,!0);t(u.requiresRendererShaderHeader).toBe(!0),t(u.needsWorldPosition).toBe(!0),t(u.fragmentMain).toContain("rendererPointLightForLight"),t(u.fragmentMain).toContain("rendererDirectionalLightForLight"),t(h).toContain("fn rendererPointLightCount()"),t(u.textures.map).toBe(e),t(u.textures.roughnessMap).toBe(a),t(u.textures.normalMap).toBe(n)}),a("bakes an authored effect input into emitter spawn delay",()=>{const e=$("bound-delay");e.rate.delayBinding={type:"vfxInput",inputId:"timing"};const a=Q(e);a.vfx.inputs=[{id:"timing",name:"Timing",type:"number",defaultValue:.5}];const i=f(a,[new o.Vector3]);t(i.compatibility.compatible).toBe(!0),t(i.emitters[0].rate.delay).toBe(.5)}),a("bakes the emitter rotation into world-space spawn position, velocity, and mesh rotation",()=>{const e=V(16,!0,!1,!1,!1,!0);t(e).toContain("zoneOffset = worldSpawnOffset(emitter, zoneOffset)"),t(e).toContain("let initialVelocity = worldSpawnDirection(emitter, localInitialVelocity)"),t(e).toContain("localInitialVelocity += randomConeDirection(sampledMeshNormal"),t(e).toContain("worldSpawnRotation(emitter), quaternionFromEulerXYZ(initialRotationEuler)"),t(e).toContain("optionalStates[meshStateOffset], quaternionFromEulerXYZ(rotationDelta)"),t(e).not.toContain("optionalStates[meshStateOffset] = quaternionFromEulerXYZ(rotationEuler)"),t(e).toContain("emitter.trailTransform0 = command.trailTransform0"),t(e).not.toMatch(/__[A-Z_]+__/)}),a("compiles pay-for-play child emitters and screen-space collision metadata",()=>{const e=$("parent");e.behaviours.push({id:"collision",type:"worldCollision",enabled:!0,params:{bounce:H(.6),friction:H(.2),lifeLoss:H(.5),debug:{type:h.Boolean,value:!0}}});const a=$("child");a.rate={type:"once",count:3,delay:0},a.spawnEvent="collision",e.children=[a];const i=f(Q(e),[new o.Vector3]);t(i.compatibility.compatible).toBe(!0),t(i.emitters).toHaveLength(2),t(i.emitters[0]).toMatchObject({hasWorldCollision:!0,collisionBounce:.6,collisionFriction:.2,collisionLifeLoss:.5,collisionDebug:!0}),t(i.emitters[1]).toMatchObject({parentEmitter:0,childParticlesPerParent:3,childSpawnEvent:2,childLevel:1,capacity:6});const n=V(16);t(n).not.toContain("collisionDepth"),t(n).not.toContain("optionalStates"),t(n).not.toContain("triangleRecord"),t(n).not.toMatch(/__[A-Z_]+__/);const s=V(16,!1,!1,!1,!1,!1,!1,0,0,!1,!1,0,0,!1,!0);t(s).toContain("var<storage, read_write> optionalStates"),t(s).toContain("let triangleRecord = optionalStates[triangleOffset]"),t(s).toContain("fn meshSamplerBoneMatrix"),t(s).toContain("meshSamplerVertexPosition(samplerOffset"),t(s).toContain("var triangleOffset = samplerOffset"),t(s).not.toContain("let triangleOffset = samplerOffset");const r=V(16,!1,!1,!1,!1,!1,!1,0,0,!0,!0,32,1);t(r).toContain("collisionDepth"),t(r).toContain("collisionStep <= 6u"),t(r).toContain("approachingVisibleSurface"),t(r).toContain("optionalStates[32u + owner.padding]"),t(r).not.toMatch(/__[A-Z_]+__/)}),a("supports local-space parent particles spawning local or world-space children",()=>{const e=$("parent",Z({space:"local"})),a=$("local-child",Z({space:"local"})),i=$("world-child",Z({space:"world"}));e.children=[a,i];const n=f(Q(e),[new o.Vector3]);t(n.compatibility.compatible).toBe(!0),t(n.compatibility.issues).toEqual([]),t(n.emitters.map(e=>e.localSpace)).toEqual([!0,!0,!1]);const s=V(16,!1,!1,!1,!1,!1,!1,0,0,!1,!1,0,1);t(s).not.toContain("parentTransform = mat4x4");const r=V(16,!1,!1,!1,!1,!0,!1,0,0,!1,!1,0,1,!0);t(r).toContain("parentTransform = mat4x4"),t(r).toContain("parentEmitter.trail.z > 0.0 && emitter.trail.z < 0.0"),t(r).toContain("childEmissionEnd = parent.velocityLife.w"),t(r).toContain("particle.positionAge = vec4(particle.positionAge.xyz, age)"),t(r).not.toContain("childEventReady = parentAlive"),t(r).not.toMatch(/__[A-Z_]+__/)}),a("invalidates recycled parent spawn events during a new activation delay",()=>{const e=$("delayed-impact",Z({space:"world"}));e.rate.delay=.13,e.children=[$("ground-impact",Z({space:"world"}))];const a=f(Q(e),[new o.Vector3(12,0,8)]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].rate.delay).toBe(.13);const i=V(16,!1,!1,!1,!1,!1,!1,0,0,!1,!1,0,1);t(i).toContain("if (!emissionStarted || !stopAllowsEmission || totalSpawn <= simulationLocalSlot)"),t(i).toContain("particle.scaleAlphaEmitterGeneration.w = 0.0;"),t(i.indexOf("particle.scaleAlphaEmitterGeneration.w = 0.0;")).toBeLessThan(i.indexOf("particles[particleIndex] = particle;")),t(i).not.toMatch(/__[A-Z_]+__/),t(V(16)).not.toContain("particle.scaleAlphaEmitterGeneration.w = 0.0;")}),a("rejects world-space parents with local-space child output",()=>{const e=$("parent",Z({space:"world"}));e.children=[$("child",Z({space:"local"}))];const a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!1),t(a.compatibility.issues).toContainEqual(t.objectContaining({code:"child-emitter-local-space"}))}),a("orders child render classes by authored render order without changing simulation hierarchy",()=>{const e=$("parent",X({renderOrder:10})),a=$("child",Z({renderOrder:-10}));e.children=[a];const i=f(Q(e),[new o.Vector3]);t(i.renderClasses.map(e=>e.output.renderOrder)).toEqual([-10,10]),t(i.emitters[0].parentEmitter).toBeUndefined(),t(i.emitters[0].renderClass).toBe(1),t(i.emitters[1]).toMatchObject({parentEmitter:0,renderClass:0})}),a("uses geometric world reservation classes without fixed template maxima",()=>{t([1,2,3,4,5,17].map(k)).toEqual([1,2,4,4,8,32])}),a("compiles stretched sprites into a velocity-aligned render class",async()=>{const e=f(Q($("stretched",function(e={}){return{type:"stretchedSprite",texture:"dot",color:"#ffffff",intensity:1,scale:.5,blendingMode:"additive",softness:0,bloom:!1,space:"world",opacityChannel:"alpha",...e}}({scale:.75}))),[new o.Vector3]);t(e.compatibility.compatible).toBe(!0);const a=await g(e.renderClasses,{getTexture:async()=>new o.Texture});t(a.renderClasses[0].stretchScale).toBe(.75);const i=T(S(a.renderClasses[0].material),!1);t(i).toContain("stretchedSpriteClipPosition"),t(i).toContain("bitcast<f32>(renderClass.data.w)")}),a("materializes billboard trails with CPU-compatible history sizing",async()=>{const e=f(Q($("trail",Y({length:9.6,uvMode:"repeat",unitsPerRepeat:.5}))),[new o.Vector3]);t(e.compatibility.compatible).toBe(!0),t(e.emitters).toHaveLength(1),t(e.emitters[0].capacity).toBe(2);const a=await g(e.renderClasses,{getTexture:async()=>new o.Texture});t(a.renderClasses[0].trail).toMatchObject({historyLength:11,width:.5,taper:!0,uvMode:"repeat",unitsPerRepeat:.5}),t(a.renderClasses[0].texture?.wrapS).toBe(o.RepeatWrapping),t(x).toBe(96);const i=V(16,!1,!1,!1,!0);t(i).toContain("@group(0) @binding(8) var<storage, read_write> optionalStates"),t(i).not.toContain("@binding(9)")}),a("streams local trail transforms through emitter commands without another storage binding",()=>{const e=f(Q($("attached-trail",Y({space:"local"}))),[new o.Vector3]);t(e.compatibility.compatible).toBe(!0);const a=V(16,!1,!1,!1,!0,!0);t(a).toContain("trailTransform0: vec4<f32>"),t(a).toContain("emitter.trailTransform3 = command.trailTransform3"),t(a).not.toContain("@binding(12)")}),a("compiles trail graph UV varyings into the procedural ribbon ABI",()=>{const e=new i({color:s(u(I.x,I.y,F.opacity),F.opacity)});E.applyTrailShaderParameters(e);const a=M(e,!0);t(a).toContain("struct GraphVertexInput"),t(a).toContain("nodeVertexID: f32"),t(a).toContain("nodeDistance: f32"),t(a).toContain("renderClass.uvSettings.x"),t(a).toContain("headDistance - mix(historyDistance(state, control), historyDistance(state, control + 1), t)"),t(a).toContain("emitterTransforms"),t(a).not.toContain("__TRAIL_"),t(a).not.toContain("output.uv ="),t(a).not.toContain("output.color ="),t(a).not.toContain("normalize(after - before)"),t(a).not.toContain("2.0, 2.0, 2.0, 0.0")}),a("binds shader graph elapsed time to the GPU particle frame clock",()=>{const e=new i({color:s(u(P.elapsed),1)}),a=M(e),o=T(S(e),!1);t(a).toContain("frame.time"),t(o).toContain("frame.time"),t(a).not.toContain("hology_elapsed_time:"),t(o).not.toContain("hology_elapsed_time:")}),a("converts authored sRGB behavior colors to the linear render space",()=>{const e=$("legacy-color",Y());e.behaviours.push({id:"color",type:"changeColor",enabled:!0,params:{a:{type:h.Color,value:"#918383"},b:{type:h.Color,value:"#4f4f4f"}}});const a=f(Q(e),[new o.Vector3]);t(a.emitters[0].colorStart.toArray()).toEqual(new o.Color("#918383").toArray()),t(a.emitters[0].colorEnd.toArray()).toEqual(new o.Color("#4f4f4f").toArray())}),a("materializes one mesh geometry and rejects mesh hierarchies with multiple geometries",async()=>{const e=$("mesh",X({space:"local"}));e.initializers.push({id:"mesh-scale-components",type:"scaleComponents",enabled:!0,params:{scale:N([1,2,3])}},{id:"mesh-rotation",type:"rotation",enabled:!0,params:{rotation:N([30,45,60])}}),e.behaviours.push({id:"mesh-scale-components-behaviour",type:"scaleComponents",enabled:!0,params:{a:N([2,1,1]),b:N([1,.5,2])}});const a=Q(e),r=f(a,[new o.Vector3]);t(r.compatibility.compatible).toBe(!0),t(r.renderClasses[0].output.type).toBe("mesh"),t(r.emitters[0].localSpace).toBe(!0),t(r.emitters[0].meshScaleStart.toArray()).toEqual([2,2,3]),t(r.emitters[0].meshScaleEnd.toArray()).toEqual([1,1,6]),t(r.emitters[0].meshRotation.w).not.toBe(1),t(r.emitters[0].meshRotationEuler.toArray()).toEqual([o.MathUtils.degToRad(30),o.MathUtils.degToRad(45),o.MathUtils.degToRad(60)]);const l=new o.Mesh(new o.BoxGeometry(1,1,1),new o.MeshBasicMaterial({color:3368601,opacity:.75})),c=await g(r.renderClasses,{getTexture:async()=>new o.Texture,getMesh:async()=>l});t(c.renderClasses[0].meshVertices?.length).toBe(288),t(c.renderClasses[0].meshColor?.getHex()).toBe(3368601),t(c.renderClasses[0].meshOpacity).toBe(.75),t(c.renderClasses[0].localSpace).toBe(!0);const p=new i({color:s(n(.4),1)}),m=await g(r.renderClasses,{getTexture:async()=>new o.Texture,getMesh:async()=>l},async()=>p);t(m.renderClasses[0].material).toBe(p);const d=new o.Group;d.add(new o.Mesh(new o.BoxGeometry),new o.Mesh(new o.BoxGeometry)),await t(g(r.renderClasses,{getTexture:async()=>new o.Texture,getMesh:async()=>d})).rejects.toThrow("exactly one mesh geometry")}),a("keeps an unconfigured mesh output GPU-compatible without rendering it",()=>{const e=f(Q($("unconfigured-mesh",X({assetId:null}))),[new o.Vector3]);t(e.compatibility.compatible).toBe(!0),t(e.compatibility.issues).toEqual([]),t(e.emitters).toEqual([]),t(e.renderClasses).toEqual([])}),a("treats an unselected mesh material override as the default material source",async()=>{const e=f(Q($("unselected-mesh-material",X({materialSource:"material",material:void 0}))),[new o.Vector3]),a=new i({color:s(n(.4),1)}),r=await g(e.renderClasses,{getTexture:async()=>new o.Texture,getMesh:async()=>new o.Mesh(new o.BoxGeometry)},async()=>a);t(e.compatibility.compatible).toBe(!0),t(r.renderClasses[0].material).toBe(a)}),a("keeps an unselected mesh shader graph on the GPU default material",async()=>{const e=f(Q($("unselected-mesh-graph",X({materialSource:"shaderGraph",shaderGraph:{source:"asset",assetId:null}}))),[new o.Vector3]),a=await g(e.renderClasses,{getTexture:async()=>new o.Texture,getMesh:async()=>new o.Mesh(new o.BoxGeometry)});t(e.compatibility.compatible).toBe(!0),t(()=>S(a.renderClasses[0].material)).not.toThrow()}),a("gates custom mesh materials on a compatible GPU material resolver",async()=>{const e=f(Q($("mesh-material",X({material:"material-id"}))),[new o.Vector3]);t(e.compatibility.compatible).toBe(!0);const a={getTexture:async()=>new o.Texture,getMesh:async()=>new o.Mesh(new o.BoxGeometry)};await t(g(e.renderClasses,a)).rejects.toThrow("compatible GPU material resolver");const n=new o.Texture,s=await g(e.renderClasses,a,async()=>new i({color:l(n).sample(d.uv)}));t(s.renderClasses[0].material).toBeInstanceOf(i);const r=S(s.renderClasses[0].material);t(Object.values(r.textures)).toEqual([n])}),a("materializes non-billboard trails with orientation history",async()=>{const e=f(Q($("oriented-trail",Y({billboard:!1}))),[new o.Vector3]);t(e.compatibility.compatible).toBe(!0);const a=await g(e.renderClasses,{getTexture:async()=>new o.Texture});t(a.renderClasses[0].trail).toMatchObject({billboard:!1});const i=V(16,!0,!1,!1,!0);t(i).toContain("trailSampleOffset + 1u"),t(i).toContain("quaternionMultiply(particleRotation, movementRotation)");const n=M(E.createBaseMaterial(),!1);t(n).toContain("renderClass.trail.w == 0u"),t(n).toContain("historySide(state, control)")}),a("changes the mesh render class when shader graph parameters change",()=>{const e={source:"asset",assetId:"mesh-graph"},a=f(Q($("mesh",X({materialSource:"shaderGraph",shaderGraph:e,shaderGraphParams:{intensity:H(1)}}))),[new o.Vector3]),i=f(Q($("mesh",X({materialSource:"shaderGraph",shaderGraph:e,shaderGraphParams:{intensity:H(2)}}))),[new o.Vector3]);t(a.renderClasses[0].key).not.toBe(i.renderClasses[0].key)}),a("preserves legacy mesh geometry transforms when requested",async()=>{const e=new o.Group,a=new o.Mesh((new o.BufferGeometry).setAttribute("position",new o.Float32BufferAttribute([1,0,0],3)));a.position.set(2,0,0),e.add(a);const i=f(Q($("modern",X())),[new o.Vector3]),n=f(Q($("legacy",X({useLegacyTransform:!0}))),[new o.Vector3]);t(i.renderClasses[0].key).not.toBe(n.renderClasses[0].key);const s={getTexture:async()=>new o.Texture,getMesh:async()=>e},r=await g(i.renderClasses,s),l=await g(n.renderClasses,s);t(r.renderClasses[0].meshVertices?.[0]).toBe(3),t(l.renderClasses[0].meshVertices?.[0]).toBe(1)}),a("does not reuse render classes across explicit template revisions",async()=>{const e=Q($("revisioned")),a={assets:{getTexture:async()=>new o.Texture},renderClassCache:new A},i=await(new j).resolve(e,{...a,revision:1}),n=await(new j).resolve(e,{...a,revision:2});t(i.template?.renderClasses[0]).not.toBe(n.template?.renderClasses[0])}),a("retains renderer-owned scene texture semantics for particle materials",()=>{const e=new i({color:U(D)}),a=S(e);t(Object.values(a.sceneTextures)).toEqual(["sceneColor"])}),a("retains the shared renderer geometry semantics for lit particle materials",()=>{const e=S(new i({color:r({color:n(6724044),roughness:.5,metalness:.1})}));t(e.needsWorldPosition).toBe(!0),t(e.needsWorldNormal).toBe(!0),t(e.requiresRendererShaderHeader).toBe(!0),t(e.fragmentMain).toContain("rendererDirectionalLightForLight"),t(G()).toContain("fn rendererCameraPosition()");const a=T(e,!0);t(a).toContain("fn rendererCameraPosition()"),t(a).toContain("rendererCameraPosition() - input.worldPosition"),t(a).toContain("@group(1) @binding(0)"),t(a).toContain("emitterTransform[0].xyz"),t(a).not.toContain("mat3x3<f32>(emitterTransforms["),t(a).toContain("fn normalMatrixFromLinearTransform"),t(a).not.toContain("inverse("),t(e.renderState.transparent).toBe(!1),t(e.renderState.depthWrite).toBe(!0),t(e.renderState.side).toBe(o.FrontSide)}),a("registers one ordered compute/render pair for a shared runtime",()=>{const e=[];let a;R({mainDepth:"depth",addPass:t=>e.push(t)},{executeCompute:()=>{},executeRender:(e,t)=>{a=t},getSceneTextureReads:()=>["sceneColorSnapshot"]},"color","WorldVfx"),t(e.map(e=>e.name)).toEqual(["WorldVfxSimulation","WorldVfxRender"]),t(e[1].dependsOn).toEqual(["WorldVfxSimulation"]),t(e[1].inputs).toMatchObject({sceneColorSnapshot:"sceneColorSnapshot"}),e[1].execute({}),t(a).toBe("color")}),a("coalesces touched emitter slots without allocating per mark",()=>{const e=new B;e.mark(7),e.mark(3),e.mark(5),t(e).toMatchObject({start:3,end:8,length:5}),e.clear(),t(e.length).toBe(0)}),a("generates particle-owner WGSL without reserved active identifiers",()=>{const e=V(16);t(e).toContain("enabled: u32"),t(e).not.toMatch(/\bactive\s*:/),t(e).not.toContain("owner.active"),t(e).toContain("fn applyEmitterCommandsMain"),t(e).toContain("@group(0) @binding(7) var<storage, read> emitterCommands"),t(e).toContain("var<storage, read_write> emitters"),t(e).toContain("timing: vec4<f32>"),t(e).toContain("let emitterDelta = select(frame.delta * emitter.timing.w, 0.0"),t(e).toContain("let sampledLife = mix(emitter.emission.z, emitter.emission.w"),t(e).toContain("particle.velocityLife = vec4(initialVelocity, particleLife)"),t(e).toContain("mix(emitter.colorStart.rgb, emitter.colorEnd.rgb, hash(particleSeed + 71u))"),t(e).toContain("select(animatedColor, particle.color.rgb, emitter.meshScaleStart.w > 0.5)")}),a("compiles random lifetime as a per-particle birth range",()=>{const e=$("random-life");e.initializers[0]={id:"random-life-range",type:"randomLifetime",enabled:!0,params:{minDuration:H(.5),maxDuration:H(2.5)}};const a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0]).toMatchObject({lifeMin:.5,life:2.5})}),a("compiles random initial color without lifetime interpolation",()=>{const e=$("random-color");e.initializers.push({id:"random-color-range",type:"randomColor",enabled:!0,params:{a:{type:h.Color,value:"#ff0000"},b:{type:h.Color,value:"#0000ff"}}});const a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].randomColor).toBe(!0)}),a("compiles point, box, line, ring, and sphere-surface spawn zones",()=>{const e=[["positionPoint",{position:N([1,2,3])},0],["positionSphere",{position:N([1,2,3]),radius:H(2),surface:{type:h.Boolean,value:!0}},1],["positionBox",{position:N([1,2,3]),dimensions:N([4,5,6])},2],["positionLine",{a:N([1,2,3]),b:N([4,5,6])},3],["positionRing",{position:N([1,2,3]),rotation:N([10,20,30]),radius:H(4),thickness:H(.5),angle:H(180)},4]];for(const[a,i,n]of e){const e=$(`zone-${a}`);e.initializers[1]={id:`zone-${a}`,type:a,enabled:!0,params:i};const s=f(Q(e),[new o.Vector3]);t(s.compatibility.compatible).toBe(!0),t(s.emitters[0].spawnZoneType).toBe(n)}const a=V(16);t(a).toContain("fn rotateSpawnPoint"),t(a).toContain("if (zoneType == 4u)")}),a("preserves legacy per-update sprite rotation behavior",()=>{const e=$("sprite-rotate");e.behaviours.push({id:"rotate-add",type:"rotateAdd",enabled:!0,params:{rotation:N([0,0,200])}});const a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].spriteRotationStep).toBeCloseTo(o.MathUtils.degToRad(o.MathUtils.degToRad(200)));const i=V(16);t(i).toContain("var rotation = particle.color.w;"),t(i).toContain("rotation += emitter.rotationInitialSpriteStep.w * frame.padding1"),e.output=X();const n=f(Q(e),[new o.Vector3]);t(n.compatibility.compatible).toBe(!0),t(n.emitters[0].meshRotationStep.z).toBeCloseTo(o.MathUtils.degToRad(o.MathUtils.degToRad(200)));const s=V(16,!0);t(s).toContain("rotationEuler: vec4<f32>"),t(s).toContain("fn quaternionFromEulerXYZ"),t(s).toContain("emitter.rotationStep.xyz * frame.padding1"),e.initializers.push({id:"random-mesh-rotation",type:"randomRotation",enabled:!0,params:{axis:{type:h.String,value:"Y"}}});const r=f(Q(e),[new o.Vector3]);t(r.compatibility.compatible).toBe(!0),t(r.emitters[0].randomMeshRotationAxis).toBe(3),t(s).toContain("randomRotationAxis == 1u"),t(s).toContain("randomRotationAxis == 4u")}),a("compiles radial velocity without per-particle auxiliary storage",()=>{const e=$("radial-velocity");e.initializers.push({id:"radial",type:"radialVelocity",enabled:!0,params:{speed:H(4),direction:N([0,1,0]),spread:H(30)}});const a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].hasRadialVelocity).toBe(!0),t(a.emitters[0].radialVelocitySpeed).toBe(4),t(a.emitters[0].radialVelocitySpread).toBeCloseTo(Math.PI/6);const i=V(16);t(i).toContain("fn radialVelocity"),t(i).toContain("emitter.radialMetadata.y > 0.5")}),a("compiles one attraction or repulsion field per emitter",()=>{const e=$("attraction");e.behaviours.push({id:"attract",type:"attraction",enabled:!0,params:{target:N([1,2,3]),force:H(4),radius:H(5)}});const a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].attractionTarget.toArray()).toEqual([1,2,3]),t(a.emitters[0].attractionForce).toBe(4),e.behaviours[0].type="repulsion";const i=f(Q(e),[new o.Vector3]);t(i.compatibility.compatible).toBe(!0),t(i.emitters[0].attractionForce).toBe(-4);const n=V(16);t(n).toContain("attractionDistanceSq < attractionRadiusSq")}),a("compiles mesh alignment modes into spawn-only parameters",()=>{const e=$("aligned-mesh",X());e.initializers.push({id:"align",type:"alignRotation",enabled:!0,params:{axis:{type:h.String,value:"+X"},mode:{type:h.String,value:"AlongVelocity"},offset:N([10,20,30]),center:N([1,2,3])}});const a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].alignRotationAxis.toArray()).toEqual([1,0,0]),t(a.emitters[0].alignRotationMode).toBe(3),t(a.emitters[0].alignRotationOffset.x).toBeCloseTo(o.MathUtils.degToRad(10));const i=V(16,!0);t(i).toContain("fn quaternionFromUnitVectors"),t(i).toContain("alignRotationMode == 3u")}),a("groups authored render classes deterministically",()=>{const e=f(Q($("a"),$("b"),$("c",Z({blendingMode:"normal"}))),[new o.Vector3]);t(e.compatibility.compatible).toBe(!0),t(e.renderClasses).toHaveLength(2),t(e.emitters.map(e=>e.renderClass)).toEqual([0,0,1])}),a("can lay out emitter allocations contiguously per dynamic effect instance",()=>{const e=Q($("first"),$("second",Z({blendingMode:"normal"}))),a=[new o.Vector3,new o.Vector3(1,0,0)],i=f(e,a),n=f(e,a,"instance-major");t(i.emitters.map(e=>e.renderClass)).toEqual([0,0,1,1]),t(n.emitters.map(e=>e.renderClass)).toEqual([0,1,0,1])}),a("reports sparse active-page simulation capacity",async()=>{const e=await C({asset:Q($("paged")),instancePositions:[new o.Vector3,new o.Vector3,new o.Vector3],instanceLayout:"instance-major",particlePageSize:2,assets:{getTexture:async()=>new o.Texture}});e.runtime.setActivePages([0,2]),t(e.runtime.getStats()).toMatchObject({capacity:6,activePageCount:2,simulatedCapacity:4})}),a("compacts active page padding out of the simulation schedule",async()=>{const e=await O.create({asset:Q($("tiny-paged-effect")),maximumInstances:2,particlePageSize:256,assets:{getTexture:async()=>new o.Texture}});e.spawn(new o.Vector3),e.flushActivePages(),t(e.runtime.getStats()).toMatchObject({capacity:512,activePageCount:1,simulatedCapacity:2});const a=V(256);t(a).toContain("let particleIndex = activeParticleIndices[id.x]"),t(a).not.toContain("id.x % pageSize"),e.dispose()}),a("sizes alive indices by logical particles instead of render-class count",async()=>{const e=await C({asset:Q($("additive"),$("normal",Z({blendingMode:"normal"}))),instancePositions:[new o.Vector3,new o.Vector3],instanceLayout:"instance-major",particlePageSize:4,assets:{getTexture:async()=>new o.Texture}});t(e.runtime.getStats()).toMatchObject({capacity:8,renderClassCount:2,aliveIndexCapacity:8,aliveIndexBytes:32});const a=V(4);t(a).toContain("aliveIndices[indirect[renderClass].firstInstance + outputIndex]"),t(a).not.toContain("renderClass * u32(frame.capacity)")}),a("allocates and recycles multi-page dynamic effect instances",async()=>{const e=$("paged-instance");e.position=[2,0,0];const a=await O.create({asset:Q(e),maximumInstances:2,particlePageSize:1,assets:{getTexture:async()=>new o.Texture}}),i=a.spawn(new o.Vector3);t(a.runtime.emitters[0].position.x).toBe(2),t(a.pause(i)).toBe(!0),t(a.runtime.emitters[0].paused).toBe(!0),a.update(.1),t(a.scheduler.getInstance(i.handle)).not.toBeNull(),t(a.play(i)).toBe(!0),t(a.runtime.emitters[0].paused).toBe(!1),t(a.setTimescale(i,2)).toBe(!0),t(a.runtime.emitters[0].timescale).toBe(2),t(a.stop(i)).toBe(!0),t(a.runtime.emitters[0].stopTime).toBeGreaterThanOrEqual(0),t(a.runtime.emitters[0].expireWithin).toBe(-1),t(i.pages).toHaveLength(2),a.flushActivePages(),t(a.runtime.getStats()).toMatchObject({activePageCount:2,simulatedCapacity:2}),t(a.destroy(i)).toBe(!0);const n=a.spawn(new o.Vector3(1,0,0));t(new Set(n.pages)).toEqual(new Set(i.pages)),t(n.handle.generation).not.toBe(i.handle.generation),a.dispose()}),a("caps GPU particle drain time for expire and kill lifecycle behavior",async()=>{const e=await O.create({asset:Q($("expiring")),maximumInstances:2,assets:{getTexture:async()=>new o.Texture}}),a=e.spawn(new o.Vector3);t(e.stop(a,.5)).toBe(!0),t(e.runtime.emitters[0].expireWithin).toBe(.5);for(let t=0;t<4;t++)e.update(.1);t(e.scheduler.getInstance(a.handle)).not.toBeNull(),e.update(.1),t(e.scheduler.getInstance(a.handle)).toBeNull();const i=e.spawn(new o.Vector3);t(e.stop(i,0)).toBe(!0),e.update(.001),t(e.scheduler.getInstance(i.handle)).toBeNull(),e.dispose()}),a("rejects a template pool before allocation when its storage budget is exceeded",async()=>{const e=await O.create({asset:Q($("over-budget")),maximumInstances:128,particlePageSize:1,maximumStorageBytes:1,assets:{getTexture:async()=>new o.Texture}});t(e).toBeNull()}),a("compiles delayed and finite continuous emission timing",()=>{const e=$("delayed");e.rate={type:"once",count:2,delay:.25};const a=$("finite");a.rate={type:"continuous",count:2,time:.1,delay:0,duration:1};const i=f(Q(e,a),[new o.Vector3]);t(i.compatibility.compatible).toBe(!0),t(i.emitters[0].rate).toMatchObject({type:"once",delay:.25}),t(i.emitters[1].rate).toMatchObject({type:"continuous",delay:0,duration:1})}),a("treats zero continuous duration as unlimited like the CPU rate",()=>{const e=$("unlimited");e.rate={type:"continuous",count:2,time:.1,delay:0,duration:0};const a=f(Q(e),[new o.Vector3]);t(a.compatibility.issues.map(e=>e.code)).not.toContain("rate-duration")}),a("compiles bound lifetime metadata but falls back for unsupported input targets",()=>{const e=Q($("input-test"));e.vfx.inputs=[{id:"speed",name:"Speed",type:"number",defaultValue:1}],t(f(e,[new o.Vector3]).compatibility.compatible).toBe(!0),e.vfx.emitters[0].initializers[0].params.duration.binding={type:"vfxInput",inputId:"speed"};const a=f(e,[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.inputBindings).toEqual([t.objectContaining({inputId:"speed",emitterIndex:0,target:"initializer:lifetime:duration"})]),e.vfx.emitters[0].initializers.push({id:"bound-velocity",type:"velocity",enabled:!0,params:{velocity:{type:h.Vector3,value:[0,1,0],binding:{type:"vfxInput",inputId:"speed"}}}}),t(f(e,[new o.Vector3]).compatibility.issues.map(e=>e.code)).toContain("vfx-input-binding")}),a("falls back for a bound continuous lifetime until particle capacity can grow",()=>{const e=$("continuous-bound-life");e.rate={type:"continuous",count:1,time:.1,delay:0,duration:0},e.initializers[0].params.duration.binding={type:"vfxInput",inputId:"life"};const a=Q(e);a.vfx.inputs=[{id:"life",name:"Life",type:"number",defaultValue:2}];const i=f(a,[new o.Vector3]);t(i.compatibility.compatible).toBe(!1),t(i.compatibility.issues.map(e=>e.code)).toContain("vfx-input-binding"),t(i.inputBindings).toEqual([])}),a("caches compiled templates while keeping instance emitter state independent",async()=>{const e=Q($("cached-template")),a=new j;let i=0;const n={assets:{getTexture:async()=>(i+=1,new o.Texture)}},s=await a.resolve(e,n),r=await a.resolve(e,n);t(r.template).toBe(s.template),t(i).toBe(1),t(a.getStats()).toMatchObject({builds:1,hits:1});const l=z(s.template,[new o.Vector3(1,0,0),new o.Vector3(2,0,0)]);t(l[0].position).not.toBe(l[1].position),l[0].position.x=100,t(l[1].position.x).toBe(2),t(s.template.emitters[0].position.x).toBe(0),a.invalidate(e),await a.resolve(e,n),t(a.getStats()).toMatchObject({builds:2,hits:1,invalidations:1}),await a.resolve(e,{...n,revision:2}),t(a.getStats()).toMatchObject({builds:3,hits:1,invalidations:2})}),a("applies a bound lifetime only to the addressed scheduled instance",async()=>{const e=$("bound-life");e.initializers[0].params.duration.binding={type:"vfxInput",inputId:"life"},e.initializers[1].params.radius.binding={type:"vfxInput",inputId:"radius"},e.initializers.push({id:"velocity",type:"velocity",enabled:!0,params:{velocity:{type:h.Vector3,value:[0,0,0],binding:{type:"vfxInput",inputId:"velocity"}}}});const a=Q(e);a.vfx.inputs=[{id:"life",name:"Life",type:"number",defaultValue:1},{id:"radius",name:"Radius",type:"number",defaultValue:1},{id:"velocity",name:"Velocity",type:"vec3",defaultValue:[0,0,0]}];const i=await O.create({asset:a,maximumInstances:2,particlePageSize:1,assets:{getTexture:async()=>new o.Texture}}),n=i.spawn(new o.Vector3),s=i.spawn(new o.Vector3);t(i.setInput(n,"life",4)).toBe(!0),t(i.runtime.emitters[0].life).toBe(4),t(i.runtime.emitters[1].life).toBe(2),t(i.setInput(n,"radius",3)).toBe(!0),t(i.runtime.emitters[0].positionRadius).toBe(3),t(i.setInput(n,"velocity",new o.Vector3(1,2,3))).toBe(!0),t(i.runtime.emitters[0].velocityMin.toArray()).toEqual([1,2,3]),t(i.setInput(s,"missing",5)).toBe(!1),i.dispose()}),a("schedules different templates in one arena and merges shared render classes",async()=>{const e=Z(),a=await q.create({templates:[{asset:Q($("world-a",e)),maximumInstances:2},{asset:Q($("world-b",{...e})),maximumInstances:2}],assets:{getTexture:async()=>new o.Texture},templateCache:new j,renderClassCache:new A,particlePageSize:1}),i=a.spawn(0,new o.Vector3),n=a.spawn(1,new o.Vector3(1,0,0));a.flushActivePages(),t(a.templateCount).toBe(2),t(a.runtime.getStats()).toMatchObject({renderClassCount:1,activePageCount:4}),t(a.scheduler.getStats()).toMatchObject({activeInstances:2,arena:{usedPages:4}}),t(a.destroy(i)).toBe(!0),t(a.destroy(n)).toBe(!0),a.flushActivePages(),t(a.runtime.hasActiveParticles).toBe(!1),t(a.runtime.getStats()).toMatchObject({aliveParticles:0,activePageCount:0,simulatedCapacity:0}),a.dispose()}),a("routes per-instance lifecycle changes through a shared multi-template world",async()=>{const e=$("world-lifecycle");e.position=[2,0,0];const a=await q.create({templates:[{asset:Q(e),maximumInstances:1},{asset:Q($("world-neighbour")),maximumInstances:1}],assets:{getTexture:async()=>new o.Texture},particlePageSize:1}),i=a.spawn(0,new o.Vector3(3,0,0));t(a.runtime.emitters[0].position.x).toBe(5),t(a.setPosition(i,new o.Vector3(7,0,0))).toBe(!0),t(a.runtime.emitters[0].position.x).toBe(9),t(a.pause(i)).toBe(!0),t(a.runtime.emitters[0].paused).toBe(!0),t(a.play(i)).toBe(!0),t(a.setTimescale(i,.5)).toBe(!0),t(a.runtime.emitters[0].timescale).toBe(.5),t(a.stop(i,0)).toBe(!0),a.update(.001),t(a.has(i)).toBe(!1),t(a.setPosition(i,new o.Vector3)).toBe(!1),a.dispose()}),a("rejects a shared world before runtime allocation when its storage budget is exceeded",async()=>{const e=await q.create({templates:[{asset:Q($("world-over-budget")),maximumInstances:2}],assets:{getTexture:async()=>new o.Texture},particlePageSize:1,maximumStorageBytes:1});t(e).toBeNull()}),a("falls back to CPU for semantic mismatches",()=>{const e=$("soft-local",Z({softness:1,space:"local",lockY:!0}));e.behaviours.push({id:"animation",type:"animation",enabled:!0,params:{}});const a=f(Q(e),[new o.Vector3]),i=w(a.compatibility);t(a.compatibility.compatible).toBe(!1),t(a.compatibility.issues.map(e=>e.code)).toEqual(t.arrayContaining(["behaviour:animation"])),t(i.backend).toBe("cpu"),t(w(a.compatibility,"gpu").backend).toBe("gpu")}),a("intentionally selects CPU simulation for physics-raycast world collision",()=>{const e=$("physics-collision");e.behaviours.push({id:"collision",type:"worldCollision",enabled:!0,params:{method:{type:h.String,value:y.PhysicsRaycast}}});const a=Q(e),i=f(a,[new o.Vector3]);t(b(a)).toBe(!0),t(i.compatibility.compatible).toBe(!1),t(i.compatibility.issues).toContainEqual(t.objectContaining({severity:"requirement",code:"physics-raycast-collision"})),t(w(i.compatibility).backend).toBe("cpu"),t(w(i.compatibility,"gpu").backend).toBe("cpu")}),a("compiles vortex with pay-for-play previous-velocity state",()=>{const e=$("vortex");e.behaviours.push({id:"vortex",type:"vortex",enabled:!0,params:{axis:N([0,5,0]),amount:H(1.25)}});const a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].vortexAxis.toArray()).toEqual([0,5,0]),t(a.emitters[0].vortexAmount).toBe(1.25),t(V(16,!1,!1)).not.toContain("vortexVelocities");const i=V(16,!1,!0);t(i).toContain("@group(0) @binding(8)"),t(i).toContain("behaviourVelocity -= optionalStates[0u + particleIndex].xyz")}),a("compiles the remaining initializer and motion behaviours",()=>{const e=$("remaining-motion");e.initializers.push({id:"mass",type:"mass",enabled:!0,params:{min:H(2)}}),e.behaviours.push({id:"drift",type:"randomDrift",enabled:!0,params:{drift:N([1,2,3]),delay:H(.25),ease:{type:h.String,value:"OutQuad"}}},{id:"follow",type:"followParent",enabled:!0,params:{speed:H(4)}},{id:"move",type:"moveTo",enabled:!0,params:{target:N([5,6,7]),ease:{type:h.String,value:"InQuad"}}});const a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0]).toMatchObject({mass:2,randomDriftDelay:.25,randomDriftEasing:2,followParentSpeed:4,hasFollowParent:!0,moveToEasing:1,hasMoveTo:!0}),t(a.emitters[0].randomDrift.toArray()).toEqual([1,2,3]),t(a.emitters[0].moveToTarget.toArray()).toEqual([5,6,7])}),a("compiles authored easing independently for visual behavior channels",()=>{const e=$("easing");e.behaviours.push({id:"scale",type:"scale",enabled:!0,params:{a:H(0),b:H(1),ease:{type:h.String,value:"OutBack"}}},{id:"color",type:"changeColor",enabled:!0,params:{a:{type:h.Color,value:"#ff0000"},b:{type:h.Color,value:"#0000ff"},ease:{type:h.String,value:"InCubic"}}},{id:"opacity",type:"changeOpacity",enabled:!0,params:{a:H(0),b:H(1),ease:{type:h.String,value:"BumpSharp"}}});const a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].curveEasing.toArray()).toEqual([18,4,20,0]);const i=V(16);t(i).toContain("fn applyEasing"),t(i).toContain("mix(emitter.colorStart.rgb, emitter.colorEnd.rgb, colorProgress)"),t(i).toContain("mix(emitter.scales.xy, emitter.scales.zw, scaleProgress)")}),a("compiles disperse into optional shared particle state",()=>{const e=$("disperse");e.behaviours.push({id:"disperse",type:"disperse",enabled:!0,params:{distance:H(3),axis:{type:h.String,value:"XZ"},ease:{type:h.String,value:"InOutSine"}}});const a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].disperseDistance).toBe(3),t(a.emitters[0].dispersePlane).toBe(2),t(a.emitters[0].disperseEasing).toBe(12),t(V(16)).not.toContain("disperseStates");const i=V(16,!1,!1,!0);t(i).toContain("@group(0) @binding(8)"),t(i).toContain("optionalStates[0u + particleIndex].w = disperseProgress")}),a("consolidates every optional simulation feature into the eighth storage binding",()=>{const e=V(16,!0,!0,!0,!0,!1,!1,48,64),a=[...e.matchAll(/@group\(0\) @binding\((\d+)\) var<storage/g)].map(e=>Number(e[1]));t(a).toEqual([1,2,3,4,5,6,7,8]),t(e).toContain("optionalStates[48u + particleIndex]"),t(e).toContain("optionalStates[64u + particleIndex]"),t(e).not.toMatch(/@binding\((9|10|11)\)/)}),a("lays out optional state regions without overlap",()=>{t(v({capacity:16,particleTransforms:!0,vortex:!0,disperse:!0,trailHistoryEntries:20})).toEqual({vortexOffset:48,disperseOffset:64,collisionEventOffset:80,trailOffset:80,meshSamplerOffset:100,entries:100,bytes:1600})}),a("materializes decal outputs as shared unit-box mesh render classes",async()=>{const e=$("decal");e.output={type:"decal",space:"world",colorMap:"",alphaMap:"",color:"#ffffff",unlit:!0,intensity:1,blendingMode:"normal",bloom:!1};const a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0);const r=new i({color:s(n(1),1)}),l=await g(a.renderClasses,{getTexture:async()=>new o.Texture},async()=>r);t(l.renderClasses[0].meshVertices?.length).toBe(288),t(l.renderClasses[0].material).toBe(r)}),a("materializes generated shape outputs through the shared mesh path",async()=>{const e=$("shape");e.output={type:"shape",shape:"box",params:{},material:"shape-material",materialSource:"material",space:"world"};const a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0);const r=new i({color:s(n(1),1)}),l=await g(a.renderClasses,{getTexture:async()=>new o.Texture},async()=>r);t(l.renderClasses[0].meshVertices?.length).toBe(288)}),a("forwards the physical particle index to fragment-stage model-matrix graphs",()=>{const e=S(new i({color:s(n(1),1)})),a=T(e,!0);t(a).toContain("color: vec4<f32>, instanceIndex: u32"),t(a).toContain("gpuParticle.color, particleIndex)"),t(a).toContain("@interpolate(flat) instanceIndex: u32"),t(a).toContain("output.instanceIndex = particleIndex")}),a("compiles soft default sprites with a pay-for-play scene-depth requirement",async()=>{const e=$("soft-sprite",Z({softness:2})),a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0);const i=(await g(a.renderClasses,{getTexture:async()=>new o.Texture})).renderClasses[0].material,n=S(i);t(Object.values(n.sceneTextures)).toContain("sceneDepth")}),a("disables depth writes only for transparent custom GPU sprite materials",async()=>{const e=$("graph-sprite",Z({materialSource:"shaderGraph",shaderGraph:{source:"asset",assetId:"graph"}})),a=f(Q(e),[new o.Vector3]),r=new i({color:s(n(1),.5),transparent:!0}),l=await g(a.renderClasses,{getTexture:async()=>new o.Texture},async()=>r);t(l.renderClasses[0].material).toBe(r),t(r.depthWrite).toBe(!1),t(S(r).renderState.depthWrite).toBe(!1);const c=new i({color:s(n(1),1)}),p=await g(a.renderClasses,{getTexture:async()=>new o.Texture},async()=>c);t(p.renderClasses[0].material).toBe(c),t(c.depthWrite).toBe(!0),t(S(c).renderState.depthWrite).toBe(!0)}),a("supports local-space sprite render classes through the shared emitter transform table",async()=>{const e=$("local-sprite",Z({space:"local"})),a=f(Q(e),[new o.Vector3(4,5,6)]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].localSpace).toBe(!0),t(a.emitters[0].position.toArray()).toEqual([0,0,0]);const i=await g(a.renderClasses,{getTexture:async()=>new o.Texture});t(i.renderClasses[0].localSpace).toBe(!0)}),a("falls back before rendering when an authored graph cannot be resolved",async()=>{const e=$("graph",Z({materialSource:"shaderGraph",shaderGraph:{source:"asset",assetId:"missing-graph"}})),a=await C({asset:Q(e),instancePositions:[new o.Vector3],assets:{getTexture:async()=>new o.Texture}});t(a.backend).toBe("cpu"),t(a.runtime).toBeNull(),t(a.reasons[0]).toContain("GPU material compilation failed")}),a("compiles default flipbook, texture, UV, and particle semantics to WGSL",async()=>{const e=$("flipbook",Z({flipbook:{enabled:!0,rows:4,columns:4,fps:12,mode:"loop"}})),a=f(Q(e),[new o.Vector3]),i=await g(a.renderClasses,{getTexture:async()=>new o.Texture}),n=S(i.renderClasses[0].material);t(n.fragmentMain).toContain("textureSample"),t(`${n.vertexMain}\n${n.fragmentMain}`).toContain("gpuParticle.positionAge.w"),t(n.varyings.length).toBeGreaterThan(0)}),a("supports component scale-over-life for sprites",()=>{const e=$("stretched-smoke");e.behaviours.push({id:"stretch",type:"scaleComponents",enabled:!0,params:{a:N([.25,1,1]),b:N([2,.5,1]),ease:{type:22,value:"Linear"}}});const a=f(Q(e),[new o.Vector3]);t(a.compatibility.compatible).toBe(!0),t(a.emitters[0].meshScaleStart.toArray()).toEqual([.25,1,1]),t(a.emitters[0].meshScaleEnd.toArray()).toEqual([2,.5,1])}),a("compiles authored scale and rotation input bindings",()=>{const e=$("input-driven",X());e.initializers.push({id:"scale",type:"scale",enabled:!0,params:{scale:{...H(1),binding:{type:"vfxInput",inputId:"scale-input"}}}},{id:"rotation",type:"rotation",enabled:!0,params:{rotation:{...N([0,-100,0]),binding:{type:"vfxInput",inputId:"rotation-input"}}}}),e.behaviours.push({id:"rotate",type:"rotate",enabled:!0,params:{rotation:{...N([0,-30,0]),binding:{type:"vfxInput",inputId:"step-input"}}}});const a=Q(e);a.vfx.inputs=[{id:"scale-input",name:"Scale",type:"number",defaultValue:1},{id:"rotation-input",name:"Rotation",type:"vec3",defaultValue:[0,-100,0]},{id:"step-input",name:"Rotation step",type:"vec3",defaultValue:[0,-30,0]}];const i=f(a,[new o.Vector3]);t(i.compatibility.compatible).toBe(!0),t(i.inputBindings.map(e=>e.target)).toEqual(["initializer:scale:scale","initializer:rotation:rotation","behaviour:rotate:rotation"])})}),a("shares default sprite shader source across numeric settings without merging material bindings",async()=>{const e=Z({softness:1,flipbook:{enabled:!0,columns:4,rows:4,fps:12,mode:"loop"}}),a=Z({softness:5,flipbook:{enabled:!0,columns:8,rows:8,fps:64,mode:"loop"}}),i=f(Q($("first",e),$("second",a)),[new o.Vector3]);t(i.renderClasses).toHaveLength(2);const n=new o.Texture,s=await g(i.renderClasses,{getTexture:async()=>n}),r=s.renderClasses[0].material,l=s.renderClasses[1].material;t(r.uniforms.vfxSoftness.value).toBe(.2),t(l.uniforms.vfxSoftness.value).toBe(1),t(r.uniforms.vfxFlipbookColumns.value).toBe(4),t(l.uniforms.vfxFlipbookColumns.value).toBe(8),t(r.uniforms.vfxFlipbookFps.value).toBe(12),t(l.uniforms.vfxFlipbookFps.value).toBe(64),t(T(S(r),!0)).toBe(T(S(l),!0));const c=f(Q($("first",e),$("second",{...a,softness:1})),[new o.Vector3]);t(c.renderClasses).toHaveLength(2)});/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/test/gpu-sprite-pipeline-cache.test.js

@@ -1,4 +1,4 @@
-import{afterEach as e,describe as t,expect as r,it as n,vi as a}from"vitest";import{Color as i,Texture as o,Vector3 as l}from"three";import{compileGpuSpriteEmitters as p}from"../effects/vfx/gpu-sprite-compiler.js";import{GpuSpriteRuntime as s}from"../effects/vfx/gpu-sprite-runtime.js";e(()=>a.unstubAllGlobals()),t("GPU sprite pipeline sharing",()=>{n("shares pipelines across classes and worlds while keeping their bindings independent",()=>{a.stubGlobal("GPUBufferUsage",{STORAGE:1,COPY_DST:2,UNIFORM:4,INDIRECT:8,COPY_SRC:16,MAP_READ:32}),a.stubGlobal("GPUShaderStage",{COMPUTE:1,VERTEX:2,FRAGMENT:4});const e=()=>({createBuffer:()=>({destroy:a.fn()}),createShaderModule:a.fn(()=>({})),createBindGroupLayout:a.fn(()=>({})),createPipelineLayout:()=>({}),createComputePipeline:()=>({}),createRenderPipeline:a.fn(e=>({...e})),createBindGroup:a.fn(e=>({...e})),queue:{writeBuffer:a.fn()}}),t=new o,n=new o,i=new Map([t,n].map(e=>[e,{sampler:{},view:{}}])),c=p({id:"sprite",name:"sprite",type:"vfx",vfx:{emitters:[{id:"emitter",name:"emitter",position:[0,0,0],rotation:[0,0,0],rate:{type:"once",count:1,delay:0},initializers:[],behaviours:[],output:{type:"sprite",texture:"dot",color:"#fff",intensity:1,blendingMode:"additive",space:"world"}}]}},[new l]).emitters,d=e(),u={device:d,colorFormat:"rgba16float",depthView:{},getExternalTexture:e=>i.get(e)},f=[],m=(e=u)=>{const r=new s(c,[{texture:t},{texture:n},{texture:t,localSpace:!0}]).createResource(e);return f.push(r),r.renderResources};try{const a=m();r(d.createRenderPipeline).toHaveBeenCalledTimes(2),r(a[0].pipeline).toBe(a[1].pipeline),r(a[2].pipeline).not.toBe(a[0].pipeline),r(a[0].renderClassBuffer).not.toBe(a[1].renderClassBuffer);const o=a[0].getBindGroup(u),l=a[1].getBindGroup(u);r(o).not.toBe(l),r(o.layout).toBe(l.layout),r(o.entries.some(e=>e.resource===i.get(t).view)).toBe(!0),r(l.entries.some(e=>e.resource===i.get(n).view)).toBe(!0);const p=m();r(d.createRenderPipeline).toHaveBeenCalledTimes(2),r(p[0].pipeline).toBe(a[0].pipeline),r(p[0].renderClassBuffer).not.toBe(a[0].renderClassBuffer);const s=m({...u,colorFormat:"rgba8unorm"});r(d.createRenderPipeline).toHaveBeenCalledTimes(4),r(s[0].pipeline).not.toBe(a[0].pipeline),r(s[0].pipeline.vertex.module).toBe(a[0].pipeline.vertex.module),m({...u,depthView:null}),r(d.createRenderPipeline).toHaveBeenCalledTimes(6);const c=e(),f=m({...u,device:c});r(c.createRenderPipeline).toHaveBeenCalledTimes(2),r(f[0].pipeline).not.toBe(a[0].pipeline)}finally{for(const e of f)e.dispose()}})}),t("GPU sprite async compute preparation",()=>{n("starts all compute pipelines together, waits for readiness, and reuses them on first render",async()=>{a.stubGlobal("GPUBufferUsage",{STORAGE:1,COPY_DST:2,UNIFORM:4,INDIRECT:8,COPY_SRC:16,MAP_READ:32}),a.stubGlobal("GPUShaderStage",{COMPUTE:1,VERTEX:2,FRAGMENT:4});const e=[],t={createBuffer:a.fn(()=>({destroy:a.fn()})),createShaderModule:a.fn(()=>({})),createBindGroupLayout:a.fn(()=>({})),createPipelineLayout:a.fn(()=>({})),createRenderPipeline:a.fn(()=>({})),createComputePipeline:a.fn(()=>({})),createComputePipelineAsync:a.fn(()=>new Promise(t=>e.push(t))),createBindGroup:a.fn(e=>({...e})),queue:{writeBuffer:a.fn()}},n=new s([],[{texture:new o}]),i=n.prepareComputePipelines(t);r(n.prepareComputePipelines(t)).toBe(i),await a.waitFor(()=>r(t.createComputePipelineAsync).toHaveBeenCalledTimes(3)),r(t.createComputePipeline).not.toHaveBeenCalled(),r(t.createBuffer).not.toHaveBeenCalled();let l=!1;i.then(()=>{l=!0});const p=[{},{},{}];e[0](p[0]),e[1](p[1]),await Promise.resolve(),r(l).toBe(!1),e[2](p[2]),await i;const c=n.createResource({device:t,colorFormat:"rgba16float",depthView:null,getExternalTexture:()=>({sampler:{},view:{}})});try{r(c.clearPipeline).toBe(p[0]),r(c.applyCommandsPipeline).toBe(p[1]),r(c.simulatePipeline).toBe(p[2]),r(t.createComputePipeline).not.toHaveBeenCalled(),await n.prepareComputePipelines(t),r(t.createComputePipelineAsync).toHaveBeenCalledTimes(3)}finally{c.dispose()}}),n("propagates compilation failure and allows a retry",async()=>{a.stubGlobal("GPUShaderStage",{COMPUTE:1,VERTEX:2,FRAGMENT:4});const e={createShaderModule:()=>({}),createBindGroupLayout:()=>({}),createPipelineLayout:()=>({}),createComputePipelineAsync:a.fn().mockRejectedValue(new Error("compile failed"))},t=new s([],[{texture:new o}]);await r(t.prepareComputePipelines(e)).rejects.toThrow("compile failed"),e.createComputePipelineAsync.mockResolvedValue({}),await t.prepareComputePipelines(e),r(e.createComputePipelineAsync).toHaveBeenCalledTimes(6)})}),t("GPU sprite async render preparation",()=>{n("prepares sprite, mesh and trail pipelines before resource creation and shares pending variants",async()=>{a.stubGlobal("GPUBufferUsage",{STORAGE:1,COPY_DST:2,UNIFORM:4,INDIRECT:8,COPY_SRC:16,MAP_READ:32}),a.stubGlobal("GPUShaderStage",{COMPUTE:1,VERTEX:2,FRAGMENT:4});const e=new o,t=[{texture:e},{texture:e,localSpace:!0},{texture:e,meshVertices:new Float32Array(24)},{texture:e,trail:{historyLength:4,width:1,taper:!1,colorStart:new i,colorEnd:new i,opacityStart:1,opacityEnd:0,scrollSpeed:0,uvMode:"stretch",unitsPerRepeat:1,opacityChannel:"alpha",blendingMode:"additive",billboard:!0}}],n=[],l={createBuffer:a.fn(()=>({destroy:a.fn()})),createShaderModule:a.fn(()=>({})),createBindGroupLayout:a.fn(()=>({})),createPipelineLayout:a.fn(()=>({})),createComputePipeline:a.fn(()=>({})),createRenderPipeline:a.fn(()=>({})),createRenderPipelineAsync:a.fn(e=>new Promise(t=>n.push(()=>t({...e})))),createBindGroup:a.fn(e=>({...e})),queue:{writeBuffer:a.fn()}},p=new s([],t),c=new s([],t);let d=!1;const u=Promise.all([p.prepareRenderPipelines(l,"rgba16float"),c.prepareRenderPipelines(l,"rgba16float")]).then(()=>{d=!0});await a.waitFor(()=>r(l.createRenderPipelineAsync).toHaveBeenCalledTimes(4)),r(d).toBe(!1),r(l.createBuffer).not.toHaveBeenCalled();for(const e of n)e();await u;const f={device:l,colorFormat:"rgba16float",depthView:{},getExternalTexture:()=>({sampler:{},view:{}})},m=[p,c].map(e=>e.createResource(f));try{r(l.createRenderPipeline).not.toHaveBeenCalled();for(let e=0;e<t.length;e++)r(m[0].renderResources[e].pipeline).toBe(m[1].renderResources[e].pipeline);r(m[0].renderResources[2].pipeline.vertex.buffers).toHaveLength(1),r(m[0].renderResources[0].pipeline.depthStencil.format).toBe("depth32float")}finally{m.forEach(e=>e.dispose())}}),n("removes failed pending variants so preparation can retry",async()=>{a.stubGlobal("GPUShaderStage",{COMPUTE:1,VERTEX:2,FRAGMENT:4});const e={createShaderModule:()=>({}),createBindGroupLayout:()=>({}),createPipelineLayout:()=>({}),createRenderPipelineAsync:a.fn().mockRejectedValue(new Error("render compile failed"))},t=new s([],[{texture:new o}]);await r(t.prepareRenderPipelines(e,"rgba16float")).rejects.toThrow("render compile failed"),e.createRenderPipelineAsync.mockResolvedValue({}),await t.prepareRenderPipelines(e,"rgba16float"),r(e.createRenderPipelineAsync).toHaveBeenCalledTimes(2)})});/*
+import{afterEach as e,describe as t,expect as r,it as n,vi as i}from"vitest";import{Color as a,Texture as o,Vector3 as l}from"three";import{compileGpuSpriteEmitters as p}from"../effects/vfx/gpu-sprite-compiler.js";import{GpuSpriteRuntime as s}from"../effects/vfx/gpu-sprite-runtime.js";import*as c from"../rendering/webgpu-runtime-bridge.js";e(()=>{i.unstubAllGlobals(),i.restoreAllMocks()}),t("GPU sprite pipeline sharing",()=>{n("shares pipelines across classes and worlds while keeping their bindings independent",()=>{const e=i.spyOn(c,"registerWebGpuPipelineOrigin").mockImplementation(()=>{});i.stubGlobal("GPUBufferUsage",{STORAGE:1,COPY_DST:2,UNIFORM:4,INDIRECT:8,COPY_SRC:16,MAP_READ:32}),i.stubGlobal("GPUShaderStage",{COMPUTE:1,VERTEX:2,FRAGMENT:4});const t=()=>({createBuffer:()=>({destroy:i.fn()}),createShaderModule:i.fn(()=>({})),createBindGroupLayout:i.fn(()=>({})),createPipelineLayout:()=>({}),createComputePipeline:()=>({}),createRenderPipeline:i.fn(e=>({...e})),createBindGroup:i.fn(e=>({...e})),queue:{writeBuffer:i.fn()}}),n=new o,a=new o,d=new Map([n,a].map(e=>[e,{sampler:{},view:{}}])),u=p({id:"sprite",name:"sprite",type:"vfx",vfx:{emitters:[{id:"emitter",name:"emitter",position:[0,0,0],rotation:[0,0,0],rate:{type:"once",count:1,delay:0},initializers:[],behaviours:[],output:{type:"sprite",texture:"dot",color:"#fff",intensity:1,blendingMode:"additive",space:"world"}}]}},[new l]).emitters,f=t(),m={device:f,colorFormat:"rgba16float",depthView:{},getExternalTexture:e=>d.get(e)},P=[],B=(e=m)=>{const t=new s(u,[{texture:n},{texture:a},{texture:n,localSpace:!0}]).createResource(e);return P.push(t),t.renderResources};try{const i=B();r(f.createRenderPipeline).toHaveBeenCalledTimes(2),r(e.mock.calls.find(([,,e])=>e.key.startsWith("gpu-vfx:"))?.[2]).toMatchObject({shader:{key:"builtin:sprite",name:"Default sprite"},bindings:null}),r(i[0].pipeline).toBe(i[1].pipeline),r(i[2].pipeline).not.toBe(i[0].pipeline),r(i[0].renderClassBuffer).not.toBe(i[1].renderClassBuffer);const o=i[0].getBindGroup(m),l=i[1].getBindGroup(m);r(o).not.toBe(l),r(o.layout).toBe(l.layout),r(o.entries.some(e=>e.resource===d.get(n).view)).toBe(!0),r(l.entries.some(e=>e.resource===d.get(a).view)).toBe(!0);const p=B();r(f.createRenderPipeline).toHaveBeenCalledTimes(2),r(p[0].pipeline).toBe(i[0].pipeline),r(p[0].renderClassBuffer).not.toBe(i[0].renderClassBuffer);const s=B({...m,colorFormat:"rgba8unorm"});r(f.createRenderPipeline).toHaveBeenCalledTimes(4),r(s[0].pipeline).not.toBe(i[0].pipeline),r(s[0].pipeline.vertex.module).toBe(i[0].pipeline.vertex.module),B({...m,depthView:null}),r(f.createRenderPipeline).toHaveBeenCalledTimes(6);const c=t(),u=B({...m,device:c});r(c.createRenderPipeline).toHaveBeenCalledTimes(2),r(u[0].pipeline).not.toBe(i[0].pipeline)}finally{for(const e of P)e.dispose()}})}),t("GPU sprite async compute preparation",()=>{n("starts all compute pipelines together, waits for readiness, and reuses them on first render",async()=>{i.stubGlobal("GPUBufferUsage",{STORAGE:1,COPY_DST:2,UNIFORM:4,INDIRECT:8,COPY_SRC:16,MAP_READ:32}),i.stubGlobal("GPUShaderStage",{COMPUTE:1,VERTEX:2,FRAGMENT:4});const e=[],t={createBuffer:i.fn(()=>({destroy:i.fn()})),createShaderModule:i.fn(()=>({})),createBindGroupLayout:i.fn(()=>({})),createPipelineLayout:i.fn(()=>({})),createRenderPipeline:i.fn(()=>({})),createComputePipeline:i.fn(()=>({})),createComputePipelineAsync:i.fn(()=>new Promise(t=>e.push(t))),createBindGroup:i.fn(e=>({...e})),queue:{writeBuffer:i.fn()}},n=new s([],[{texture:new o}]),a=n.prepareComputePipelines(t);r(n.prepareComputePipelines(t)).toBe(a),await i.waitFor(()=>r(t.createComputePipelineAsync).toHaveBeenCalledTimes(3)),r(t.createComputePipeline).not.toHaveBeenCalled(),r(t.createBuffer).not.toHaveBeenCalled();let l=!1;a.then(()=>{l=!0});const p=[{},{},{}];e[0](p[0]),e[1](p[1]),await Promise.resolve(),r(l).toBe(!1),e[2](p[2]),await a;const c=n.createResource({device:t,colorFormat:"rgba16float",depthView:null,getExternalTexture:()=>({sampler:{},view:{}})});try{r(c.clearPipeline).toBe(p[0]),r(c.applyCommandsPipeline).toBe(p[1]),r(c.simulatePipeline).toBe(p[2]),r(t.createComputePipeline).not.toHaveBeenCalled(),await n.prepareComputePipelines(t),r(t.createComputePipelineAsync).toHaveBeenCalledTimes(3)}finally{c.dispose()}}),n("propagates compilation failure and allows a retry",async()=>{i.stubGlobal("GPUShaderStage",{COMPUTE:1,VERTEX:2,FRAGMENT:4});const e={createShaderModule:()=>({}),createBindGroupLayout:()=>({}),createPipelineLayout:()=>({}),createComputePipelineAsync:i.fn().mockRejectedValue(new Error("compile failed"))},t=new s([],[{texture:new o}]);await r(t.prepareComputePipelines(e)).rejects.toThrow("compile failed"),e.createComputePipelineAsync.mockResolvedValue({}),await t.prepareComputePipelines(e),r(e.createComputePipelineAsync).toHaveBeenCalledTimes(6)})}),t("GPU sprite async render preparation",()=>{n("prepares sprite, mesh and trail pipelines before resource creation and shares pending variants",async()=>{i.stubGlobal("GPUBufferUsage",{STORAGE:1,COPY_DST:2,UNIFORM:4,INDIRECT:8,COPY_SRC:16,MAP_READ:32}),i.stubGlobal("GPUShaderStage",{COMPUTE:1,VERTEX:2,FRAGMENT:4});const e=new o,t=[{texture:e},{texture:e,localSpace:!0},{texture:e,meshVertices:new Float32Array(24)},{texture:e,trail:{historyLength:4,width:1,taper:!1,colorStart:new a,colorEnd:new a,opacityStart:1,opacityEnd:0,scrollSpeed:0,uvMode:"stretch",unitsPerRepeat:1,opacityChannel:"alpha",blendingMode:"additive",billboard:!0}}],n=[],l={createBuffer:i.fn(()=>({destroy:i.fn()})),createShaderModule:i.fn(()=>({})),createBindGroupLayout:i.fn(()=>({})),createPipelineLayout:i.fn(()=>({})),createComputePipeline:i.fn(()=>({})),createRenderPipeline:i.fn(()=>({})),createRenderPipelineAsync:i.fn(e=>new Promise(t=>n.push(()=>t({...e})))),createBindGroup:i.fn(e=>({...e})),queue:{writeBuffer:i.fn()}},p=new s([],t),c=new s([],t);let d=!1;const u=Promise.all([p.prepareRenderPipelines(l,"rgba16float"),c.prepareRenderPipelines(l,"rgba16float")]).then(()=>{d=!0});await i.waitFor(()=>r(l.createRenderPipelineAsync).toHaveBeenCalledTimes(4)),r(d).toBe(!1),r(l.createBuffer).not.toHaveBeenCalled();for(const e of n)e();await u;const f={device:l,colorFormat:"rgba16float",depthView:{},getExternalTexture:()=>({sampler:{},view:{}})},m=[p,c].map(e=>e.createResource(f));try{r(l.createRenderPipeline).not.toHaveBeenCalled();for(let e=0;e<t.length;e++)r(m[0].renderResources[e].pipeline).toBe(m[1].renderResources[e].pipeline);r(m[0].renderResources[2].pipeline.vertex.buffers).toHaveLength(1),r(m[0].renderResources[0].pipeline.depthStencil.format).toBe("depth32float")}finally{m.forEach(e=>e.dispose())}}),n("removes failed pending variants so preparation can retry",async()=>{i.stubGlobal("GPUShaderStage",{COMPUTE:1,VERTEX:2,FRAGMENT:4});const e={createShaderModule:()=>({}),createBindGroupLayout:()=>({}),createPipelineLayout:()=>({}),createRenderPipelineAsync:i.fn().mockRejectedValue(new Error("render compile failed"))},t=new s([],[{texture:new o}]);await r(t.prepareRenderPipelines(e,"rgba16float")).rejects.toThrow("render compile failed"),e.createRenderPipelineAsync.mockResolvedValue({}),await t.prepareRenderPipelines(e,"rgba16float"),r(e.createRenderPipelineAsync).toHaveBeenCalledTimes(2)})});/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/test/native-texture.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=native-texture.test.d.ts.map

package/dist/test/native-texture.test.js

@@ -0,0 +1,4 @@
+import{describe as e,expect as t,it as s}from"vitest";import{SRGBColorSpace as o,RGBA_BPTC_Format as r,RGBA_ASTC_4x4_Format as i}from"three";import{parseNativeTexture as n,selectNativeTexture as a}from"../scene/native-texture.js";function c(e,t){const s=[64,16,16,16].map(e=>e*Math.max(1,t)),o=new ArrayBuffer(176+s.reduce((e,t)=>e+t,0));new Uint8Array(o).set([171,75,84,88,32,50,48,187,13,10,26,10]);const r=new DataView(o);r.setUint32(12,"bc7"===e?146:158,!0),r.setUint32(16,1,!0),r.setUint32(20,8,!0),r.setUint32(24,8,!0),r.setUint32(32,t,!0),r.setUint32(36,1,!0),r.setUint32(40,4,!0);let i=176;for(let e=0;e<4;e++)r.setBigUint64(80+24*e,BigInt(i),!0),r.setBigUint64(88+24*e,BigInt(s[e]),!0),r.setBigUint64(96+24*e,BigInt(s[e]),!0),i+=s[e];return o}e("native GPU textures",()=>{s("selects only supported variants and leaves unsupported devices on the fallback",()=>{const e={bc7:"desktop.ktx2",astc:"mobile.ktx2"};t(a(e,!0,!0)?.fileKey).toBe("desktop.ktx2"),t(a(e,!1,!0)?.fileKey).toBe("mobile.ktx2"),t(a(e,!1,!1)).toBeUndefined(),t(a({astc:"mobile.ktx2"},!0,!1)).toBeUndefined()}),s.each(["bc7","astc"])("creates %s mip chains usable by the custom WebGPU renderer without copying",e=>{const s=c(e,0),a=n(s,e);t(a.format).toBe("bc7"===e?r:i),t(a.colorSpace).toBe(o),t(a.flipY).toBe(!1),t(a.generateMipmaps).toBe(!1),t(a.mipmaps).toHaveLength(4),t(a.mipmaps[3].data.buffer).toBe(s)}),s("preserves array layers for the custom WebGPU renderer",()=>{const e=n(c("bc7",3),"bc7");t(e.isCompressedArrayTexture).toBe(!0),t(e.image.depth).toBe(3),t(e.mipmaps[3].data.byteLength).toBe(48)}),s("rejects mismatched formats, truncated levels and supercompressed payloads",()=>{t(()=>n(c("astc",0),"bc7")).toThrow(/format/);const e=c("bc7",0);t(()=>n(e.slice(0,-1),"bc7")).toThrow(/mip/),new DataView(e).setUint32(44,2,!0),t(()=>n(e,"bc7")).toThrow(/supercompression/)})});/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

package/dist/test/shader-graph.test.js

@@ -1,4 +1,4 @@
-import{expect as e,test as t,vi as o}from"vitest";import{DoubleSide as a,FrontSide as r,Texture as n}from"three";o.hoisted(()=>{if("undefined"==typeof HTMLCanvasElement)return;const e=new Proxy({},{get:(e,t)=>(t in e||(e[t]=("string"!=typeof t||!t.startsWith("is"))&&o.fn()),e[t]),set:(e,t,o)=>(e[t]=o,!0)});Object.defineProperty(HTMLCanvasElement.prototype,"getContext",{configurable:!0,value:()=>e}),"undefined"==typeof AudioBuffer&&Object.defineProperty(globalThis,"AudioBuffer",{configurable:!0,value:class{}})}),o.mock("three/examples/jsm/Addons.js",async e=>({...await e(),ConvexHull:class{},SkeletonUtils:{clone:e=>e},RectAreaLightHelper:class{}})),o.mock("three-shader-graph",async e=>{const t=await e();return{...t,rgb:(e,o,a)=>null==o&&null==a&&!0===e?.isColor&&"function"==typeof e.getHexString?t.rgb("#"+e.getHexString()):t.rgb(e,o,a)}}),o.mock("../rendering.js",()=>({RenderingView:class{constructor(){this._id="test",this.csm={setupMaterial:o.fn()}}getEnvTexture(e){return e}},setRenderingPaused:o.fn()}));import{materialFromAsset as s,prepareCustomParamsFromShaderGraph as d,prepareShaderGraphParameters as u}from"../scene/materializer.js";import{SerializedParamType as i}from"../scene/model.js";import{AssetsProvider as l}from"../scene/assets-provider.js";import{AssetResourceLoader as p}from"../scene/asset-resource-loader.js";import{buildShaderGraphMaterial as c,buildShaderGraphPostProcessMaterial as m,compileShaderGraph as v,compileShaderGraphPreview as f,createDefaultPostProcessShaderGraphDocument as h,createDefaultShaderGraphDocument as g,createDefaultVfxShaderGraphDocument as y,shaderGraphPostProcessWeightUniformName as I,shaderGraphParametersToPropertyParameters as b}from"../shader/graph/index.js";import{NodeShaderMaterial as x,textureSampler2d as k,UniformFloatNode as B,UniformSampler2dArraySlice as T,vec2 as w}from"../shader-nodes/index.js";import{StandardShader as C}from"../shader/builtin/standard-shader.js";import{sceneMapUniformName as M}from"../shader-nodes/scene-sample.js";function j(e,t,o){return{version:1,target:"surface",parameters:[],nodes:e,edges:t,outputs:o}}function S(e,t){return{id:e,name:e,type:"material",material:{type:"shaderGraph",side:r,params:{},shaderParams:{},shaderGraph:t}}}t("graph validation rejects missing nodes, invalid ports, and incompatible edges",()=>{const t=g();t.outputs.color={input:{nodeId:"missing",port:"value"}},e(()=>v(t)).toThrow(/Missing shader graph node/);const o=g();o.outputs.color={input:{nodeId:"base-color",port:"missing"}},e(()=>v(o)).toThrow(/does not have output/);const a=j([{id:"a",kind:"constant.vec2",params:{value:[1,1]}},{id:"b",kind:"constant.vec3",params:{value:[1,1,1]}},{id:"add",kind:"math.add"}],[{from:{nodeId:"a",port:"value"},to:{nodeId:"add",port:"a"}},{from:{nodeId:"b",port:"value"},to:{nodeId:"add",port:"b"}}],{color:{input:{nodeId:"add",port:"value"}}});e(()=>v(a)).toThrow(/Cannot add vec2 and vec3/)}),t("scene lighting nodes expose renderer ambient and directional light values",()=>{const t=j([{id:"ambient",kind:"scene.ambientLight"},{id:"directional",kind:"scene.directionalLight"}],[],{color:{input:{nodeId:"ambient",port:"color"}}}),o=v(t);e(o.nodes.get("ambient")?.outputs.color.type).toBe("rgb"),e(o.nodes.get("directional")?.outputs.color.type).toBe("rgb"),e(o.nodes.get("directional")?.outputs.direction.type).toBe("vec3");const a=c(t);e(a.fragmentShader).toContain("ambientLightColor"),t.outputs.color={input:{nodeId:"directional",port:"color"}};const r=c(t);e(r.fragmentShader).toContain("directionalLights"),e(r.fragmentShader).toContain("NUM_DIR_LIGHTS"),e(r.fragmentShader).toMatch(/max\s*\(\s*float\s*\(\s*NUM_DIR_LIGHTS\s*\)/)}),t("named reroutes pass values through declarations to multiple usages",()=>{const t=j([{id:"source",kind:"constant.float",params:{value:.75}},{id:"declaration",kind:"utility.namedRerouteDeclaration",params:{name:"Mask"}},{id:"usage-a",kind:"utility.namedRerouteUsage",params:{declarationId:"declaration"}},{id:"usage-b",kind:"utility.namedRerouteUsage",params:{declarationId:"declaration"}},{id:"add",kind:"math.add"}],[{from:{nodeId:"source",port:"value"},to:{nodeId:"declaration",port:"value"}},{from:{nodeId:"usage-a",port:"value"},to:{nodeId:"add",port:"a"}},{from:{nodeId:"usage-b",port:"value"},to:{nodeId:"add",port:"b"}}],{color:{input:{nodeId:"add",port:"value"}}}),o=v(t),a=o.nodes.get("declaration")?.outputs.value;e(a?.type).toBe("float"),e(o.nodes.get("usage-a")?.outputs.value).toBe(a),e(o.nodes.get("usage-b")?.outputs.value).toBe(a),e(o.output.color).toBeTruthy()}),t("named reroutes preserve dynamic vector types",()=>{const t=j([{id:"source",kind:"constant.vec3",params:{value:[1,2,3]}},{id:"declaration",kind:"utility.namedRerouteDeclaration",params:{name:"Direction"}},{id:"usage",kind:"utility.namedRerouteUsage",params:{declarationId:"declaration"}}],[{from:{nodeId:"source",port:"value"},to:{nodeId:"declaration",port:"value"}}],{color:{input:{nodeId:"usage",port:"value"}}}),o=v(t);e(o.nodes.get("usage")?.outputs.value.type).toBe("vec3")}),t("named reroute validation rejects missing and invalid declarations",()=>{const t=j([{id:"usage",kind:"utility.namedRerouteUsage",params:{declarationId:"missing"}}],[],{});e(()=>v(t)).toThrow(/declaration "missing" does not exist/);const o=j([{id:"not-declaration",kind:"constant.float",params:{value:1}},{id:"usage",kind:"utility.namedRerouteUsage",params:{declarationId:"not-declaration"}}],[],{});e(()=>v(o)).toThrow(/not a named reroute declaration/)}),t("named reroute cycles report a compile error",()=>{const t=j([{id:"declaration",kind:"utility.namedRerouteDeclaration",params:{name:"Cycle"}},{id:"usage",kind:"utility.namedRerouteUsage",params:{declarationId:"declaration"}}],[{from:{nodeId:"usage",port:"value"},to:{nodeId:"declaration",port:"value"}}],{color:{input:{nodeId:"usage",port:"value"}}});e(()=>v(t)).toThrow(/contains a cycle/)}),t("surface graph compiles to NodeShaderOutput",()=>{const t=v(g("surface"));e(t.output.color).toBeTruthy(),e(t.output.transparent).toBe(!1)}),t("inline literal inputs compile without separate constant nodes",()=>{const t=j([{id:"uv",kind:"builtin.uv"},{id:"scale-uv",kind:"math.multiply",inputs:{b:{value:2,valueType:"float"}}},{id:"rotate",kind:"uv.rotate",inputs:{angle:{value:.5,valueType:"float"},center:{value:[.25,.75],valueType:"vec2"}}},{id:"translate",kind:"transform.translate",inputs:{offset:{value:[0,1,0],valueType:"vec3"}}}],[{from:{nodeId:"uv",port:"value"},to:{nodeId:"scale-uv",port:"a"}},{from:{nodeId:"scale-uv",port:"value"},to:{nodeId:"rotate",port:"uv"}}],{color:{input:{nodeId:"rotate",port:"value"}},transform:{input:{nodeId:"translate",port:"value"}}}),o=v(t);e(o.nodes.get("scale-uv")?.outputs.value.type).toBe("vec2"),e(o.nodes.get("rotate")?.outputs.value.type).toBe("vec2"),e(o.nodes.get("translate")?.outputs.value.type).toBe("mat4"),e(o.output.color).toBeTruthy(),e(o.output.transform).toBeTruthy()}),t("uv attribute node supports selecting non-default uv channels",()=>{const t=j([{id:"uv",kind:"builtin.uv",params:{channel:2}}],[],{color:{input:{nodeId:"uv",port:"value"}}}),o=v(t);e(o.nodes.get("uv")?.outputs.value.type).toBe("vec2");const a=c(t);e(a.fragmentShader).toContain("uv2")}),t.each(["surface","decal"])("world normal node compiles for %s graphs",t=>{const o=j([{id:"world-normal",kind:"builtin.worldNormal"}],[],{color:{input:{nodeId:"world-normal",port:"value"}}});o.target=t;const a=v(o);e(a.nodes.get("world-normal")?.outputs.value.type).toBe("vec3"),e(c(o).fragmentShader).toBeTruthy()}),t("sprite graph compiles with sprite-compatible material output",()=>{const t=g("sprite"),o=v(t);e(o.output.color).toBeTruthy(),e(o.output.transparent).toBe(!0)}),t("default VFX shader graphs compile mapped targets and build non-sprite materials",()=>{for(const t of["sprite","surface","decal","trail"]){const o=y(t);if(e(v(o).output.color).toBeTruthy(),"sprite"===t)continue;const a=c(o,{trailBillboard:"trail"===t});e(a.isMaterial).toBe(!0)}}),t("graph material options apply to supported material targets",()=>{const t=g("surface");t.materialOptions={side:"double",transparent:!0};const o=c(t);e(o.side).toBe(a),e(o.transparent).toBe(!0);const r=g("decal");r.materialOptions={transparent:!0};const n=c(r);e(n.transparent).toBe(!0)}),t("standard graph compiles extended material outputs and vertex transform",()=>{const t=j([{id:"metalness",kind:"constant.float",params:{value:.8}},{id:"ao",kind:"constant.float",params:{value:.5}},{id:"sheen",kind:"constant.vec3",params:{value:[.1,.2,.3]}},{id:"offset",kind:"constant.vec3",params:{value:[0,1,0]}},{id:"translate",kind:"transform.translate"}],[{from:{nodeId:"offset",port:"value"},to:{nodeId:"translate",port:"offset"}}],{metalness:{input:{nodeId:"metalness",port:"value"}},ambientOcclusion:{input:{nodeId:"ao",port:"value"}},sheenColor:{input:{nodeId:"sheen",port:"value"}},transform:{input:{nodeId:"translate",port:"value"}}}),o=v(t);e(o.output.metalness).toBeTruthy(),e(o.output.ambientOcclusion).toBeTruthy(),e(o.output.sheenColor).toBeTruthy(),e(o.output.transform).toBeTruthy();const a=c(t);e(a.outputMetalness).toBeTruthy(),e(a.outputAmbientOcclusion).toBeTruthy(),e(a.outputTransform).toBeTruthy()}),t("math multiply composes transform matrices",()=>{const t=j([{id:"translate",kind:"transform.translate",inputs:{offset:{value:[0,1,0],valueType:"vec3"}}},{id:"scale",kind:"transform.scale",inputs:{scale:{value:[2,2,2],valueType:"vec3"}}},{id:"compose",kind:"math.multiply"}],[{from:{nodeId:"translate",port:"value"},to:{nodeId:"compose",port:"a"}},{from:{nodeId:"scale",port:"value"},to:{nodeId:"compose",port:"b"}}],{transform:{input:{nodeId:"compose",port:"value"}}}),o=v(t);e(o.nodes.get("compose")?.outputs.value.type).toBe("mat4"),e(o.output.transform).toBeTruthy(),e(c(t).outputTransform).toBeTruthy()}),t("matrix input nodes compile as mat4 uniforms",()=>{for(const t of["builtin.viewMatrix","builtin.projectionMatrix","builtin.modelViewMatrix"]){const o=j([{id:"matrix",kind:t}],[],{transform:{input:{nodeId:"matrix",port:"value"}}}),a=v(o);e(a.nodes.get("matrix")?.outputs.value.type).toBe("mat4"),e(a.output.transform).toBeTruthy()}}),t("compose vec4 node compiles from float components",()=>{const t=j([{id:"compose",kind:"compose.vec4",inputs:{x:{value:.1},y:{value:.2},z:{value:.3},w:{value:1}}}],[],{color:{input:{nodeId:"compose",port:"value"}}}),o=v(t);e(o.nodes.get("compose")?.outputs.value.type).toBe("vec4"),e(o.output.color).toBeTruthy()}),t("atan2 node compiles from y and x inputs",()=>{const t=j([{id:"atan2",kind:"math.atan2",inputs:{y:{value:1},x:{value:0}}}],[],{color:{input:{nodeId:"atan2",port:"value"}}}),o=v(t);e(o.nodes.get("atan2")?.outputs.value.type).toBe("float"),e(o.output.color).toBeTruthy()}),t("built-in attribute nodes compile for fragment and transform outputs",()=>{const t=j([{id:"color",kind:"builtin.color"},{id:"normal",kind:"builtin.normal"},{id:"position",kind:"builtin.position"},{id:"worldPosition",kind:"builtin.worldPosition"},{id:"objectPosition",kind:"builtin.objectPosition"},{id:"translate",kind:"transform.translate"}],[{from:{nodeId:"objectPosition",port:"value"},to:{nodeId:"translate",port:"offset"}}],{color:{input:{nodeId:"color",port:"value"}},normal:{input:{nodeId:"normal",port:"value"}},roughness:{input:{nodeId:"position",port:"x"}},metalness:{input:{nodeId:"worldPosition",port:"x"}},transform:{input:{nodeId:"translate",port:"value"}}}),o=v(t);e(o.nodes.get("color")?.outputs.value.type).toBe("rgba"),e(o.nodes.get("normal")?.outputs.value.type).toBe("vec3"),e(o.nodes.get("position")?.outputs.value.type).toBe("vec3"),e(o.nodes.get("worldPosition")?.outputs.value.type).toBe("vec3"),e(o.nodes.get("objectPosition")?.outputs.value.type).toBe("vec3"),e(o.output.color).toBeTruthy(),e(o.output.normal).toBeTruthy(),e(o.output.transform).toBeTruthy(),e(c(t).outputTransform).toBeTruthy()}),t("painted layer mix node compiles color layers and builds a material",()=>{const t=j([{id:"base",kind:"constant.rgba",params:{value:"#224422",alpha:1}},{id:"grass",kind:"constant.rgba",params:{value:"#55aa33",alpha:1}},{id:"stone",kind:"constant.rgba",params:{value:"#777777",alpha:1}},{id:"mix",kind:"layer.mixPainted",params:{mode:"soft",enableNoise:!0,softness:.25,noiseScale:.2,noiseAmount:.4}}],[{from:{nodeId:"base",port:"value"},to:{nodeId:"mix",port:"base"}},{from:{nodeId:"grass",port:"value"},to:{nodeId:"mix",port:"layer1"}},{from:{nodeId:"stone",port:"value"},to:{nodeId:"mix",port:"layer3"}}],{color:{input:{nodeId:"mix",port:"value"}}}),o=v(t);e(o.nodes.get("mix")?.outputs.value.type).toBe("rgba"),e(o.output.color).toBeTruthy(),e(c(t).isMaterial).toBe(!0)}),t("painted layer mix node compiles sparse float layers in hard and soft modes",()=>{for(const t of["hard","soft"]){const o=j([{id:"base",kind:"constant.float",params:{value:.8}},{id:"mud",kind:"constant.float",params:{value:1}},{id:"wet",kind:"constant.float",params:{value:.25}},{id:"mix",kind:"layer.mixPainted",params:{mode:t,enableNoise:!1,softness:.3,noiseScale:.1,noiseAmount:.5}}],[{from:{nodeId:"base",port:"value"},to:{nodeId:"mix",port:"base"}},{from:{nodeId:"mud",port:"value"},to:{nodeId:"mix",port:"layer2"}},{from:{nodeId:"wet",port:"value"},to:{nodeId:"mix",port:"layer8"}}],{roughness:{input:{nodeId:"mix",port:"value"}}}),a=v(o);e(a.nodes.get("mix")?.outputs.value.type).toBe("float"),e(a.output.roughness).toBeTruthy()}}),t("painted layer mix node rejects incompatible layer types",()=>{const t=j([{id:"base",kind:"constant.vec2",params:{value:[0,1]}},{id:"layer",kind:"constant.vec3",params:{value:[1,0,0]}},{id:"mix",kind:"layer.mixPainted"}],[{from:{nodeId:"base",port:"value"},to:{nodeId:"mix",port:"base"}},{from:{nodeId:"layer",port:"value"},to:{nodeId:"mix",port:"layer1"}}],{color:{input:{nodeId:"mix",port:"value"}}});e(()=>v(t)).toThrow(/Cannot mix vec2 and vec3/)}),t("additional math, uv, shape, noise, and effect nodes compile",()=>{const t=j([{id:"uv",kind:"builtin.uv"},{id:"angle",kind:"constant.float",params:{value:.5}},{id:"scale",kind:"constant.float",params:{value:4}},{id:"half",kind:"constant.float",params:{value:.5}},{id:"axis",kind:"constant.vec3",params:{value:[0,1,0]}},{id:"rotatedUv",kind:"uv.rotate"},{id:"twirl",kind:"uv.twirl"},{id:"bulge",kind:"uv.bulge"},{id:"radial",kind:"uv.radial"},{id:"flipbook",kind:"uv.flipbook"},{id:"shape",kind:"shape.roundedRectangle"},{id:"noise",kind:"noise.simplex"},{id:"voronoi",kind:"noise.voronoi2d"},{id:"fresnel",kind:"effect.fresnel"},{id:"sin",kind:"math.sin"},{id:"pow",kind:"math.pow"},{id:"mix",kind:"math.mix"},{id:"rotateAxis",kind:"transform.rotateAxis"}],[{from:{nodeId:"uv",port:"value"},to:{nodeId:"rotatedUv",port:"uv"}},{from:{nodeId:"angle",port:"value"},to:{nodeId:"rotatedUv",port:"angle"}},{from:{nodeId:"rotatedUv",port:"value"},to:{nodeId:"twirl",port:"uv"}},{from:{nodeId:"scale",port:"value"},to:{nodeId:"twirl",port:"strength"}},{from:{nodeId:"twirl",port:"value"},to:{nodeId:"bulge",port:"uv"}},{from:{nodeId:"half",port:"value"},to:{nodeId:"bulge",port:"power"}},{from:{nodeId:"bulge",port:"value"},to:{nodeId:"radial",port:"uv"}},{from:{nodeId:"twirl",port:"value"},to:{nodeId:"flipbook",port:"uv"}},{from:{nodeId:"twirl",port:"value"},to:{nodeId:"shape",port:"uv"}},{from:{nodeId:"half",port:"value"},to:{nodeId:"shape",port:"width"}},{from:{nodeId:"half",port:"value"},to:{nodeId:"shape",port:"height"}},{from:{nodeId:"half",port:"value"},to:{nodeId:"shape",port:"radius"}},{from:{nodeId:"twirl",port:"value"},to:{nodeId:"noise",port:"uv"}},{from:{nodeId:"scale",port:"value"},to:{nodeId:"noise",port:"scale"}},{from:{nodeId:"twirl",port:"value"},to:{nodeId:"voronoi",port:"uv"}},{from:{nodeId:"scale",port:"value"},to:{nodeId:"voronoi",port:"scale"}},{from:{nodeId:"scale",port:"value"},to:{nodeId:"fresnel",port:"power"}},{from:{nodeId:"radial",port:"angle"},to:{nodeId:"sin",port:"value"}},{from:{nodeId:"noise",port:"value"},to:{nodeId:"pow",port:"a"}},{from:{nodeId:"half",port:"value"},to:{nodeId:"pow",port:"b"}},{from:{nodeId:"shape",port:"value"},to:{nodeId:"mix",port:"a"}},{from:{nodeId:"voronoi",port:"value"},to:{nodeId:"mix",port:"b"}},{from:{nodeId:"fresnel",port:"value"},to:{nodeId:"mix",port:"t"}},{from:{nodeId:"axis",port:"value"},to:{nodeId:"rotateAxis",port:"axis"}},{from:{nodeId:"angle",port:"value"},to:{nodeId:"rotateAxis",port:"angle"}}],{color:{input:{nodeId:"mix",port:"value"}},opacity:{input:{nodeId:"sin",port:"value"}},anisotropyDirection:{input:{nodeId:"flipbook",port:"value"}},transform:{input:{nodeId:"rotateAxis",port:"value"}}}),o=v(t);e(o.nodes.get("mix")?.outputs.value.type).toBe("float"),e(o.nodes.get("twirl")?.outputs.value.type).toBe("vec2"),e(o.nodes.get("bulge")?.outputs.value.type).toBe("vec2"),e(o.nodes.get("radial")?.outputs.coords.type).toBe("vec2"),e(o.nodes.get("flipbook")?.outputs.value.type).toBe("vec2"),e(o.nodes.get("rotateAxis")?.outputs.value.type).toBe("mat4"),e(o.output.color).toBeTruthy(),e(o.output.opacity).toBeTruthy(),e(o.output.transform).toBeTruthy()}),t("slider input node outputs a clamped float value",()=>{const t=j([{id:"slider",kind:"input.slider",params:{value:1.25}}],[],{roughness:{input:{nodeId:"slider",port:"value"}}}),o=v(t);e(o.nodes.get("slider")?.outputs.value.type).toBe("float"),e(o.output.roughness).toBeTruthy()}),t("comparison and boolean graph nodes compile to boolean outputs",()=>{const t=j([{id:"a",kind:"constant.float",params:{value:.75}},{id:"b",kind:"constant.float",params:{value:.5}},{id:"greater",kind:"compare.greaterThan"},{id:"lessEqual",kind:"compare.lessThanOrEqual"},{id:"not",kind:"boolean.not"},{id:"and",kind:"boolean.and"},{id:"or",kind:"boolean.or"}],[{from:{nodeId:"a",port:"value"},to:{nodeId:"greater",port:"a"}},{from:{nodeId:"b",port:"value"},to:{nodeId:"greater",port:"b"}},{from:{nodeId:"a",port:"value"},to:{nodeId:"lessEqual",port:"a"}},{from:{nodeId:"b",port:"value"},to:{nodeId:"lessEqual",port:"b"}},{from:{nodeId:"lessEqual",port:"value"},to:{nodeId:"not",port:"value"}},{from:{nodeId:"greater",port:"value"},to:{nodeId:"and",port:"a"}},{from:{nodeId:"not",port:"value"},to:{nodeId:"and",port:"b"}},{from:{nodeId:"and",port:"value"},to:{nodeId:"or",port:"a"}},{from:{nodeId:"lessEqual",port:"value"},to:{nodeId:"or",port:"b"}}],{discard:{input:{nodeId:"or",port:"value"}}}),o=v(t);e(o.nodes.get("greater")?.outputs.value.type).toBe("boolean"),e(o.nodes.get("lessEqual")?.outputs.value.type).toBe("boolean"),e(o.nodes.get("not")?.outputs.value.type).toBe("boolean"),e(o.nodes.get("and")?.outputs.value.type).toBe("boolean"),e(o.nodes.get("or")?.outputs.value.type).toBe("boolean"),e(o.output.discard).toBeTruthy()}),t("split component node exposes vector and color channels as separate outputs",()=>{const t=j([{id:"vec",kind:"constant.vec3",params:{value:[.2,.4,.6]}},{id:"color",kind:"constant.rgba",params:{value:"#336699",alpha:.75}},{id:"splitVec",kind:"decompose.split"},{id:"splitColor",kind:"decompose.split"},{id:"sum",kind:"math.add"}],[{from:{nodeId:"vec",port:"value"},to:{nodeId:"splitVec",port:"value"}},{from:{nodeId:"color",port:"value"},to:{nodeId:"splitColor",port:"value"}},{from:{nodeId:"splitVec",port:"z"},to:{nodeId:"sum",port:"a"}},{from:{nodeId:"splitColor",port:"a"},to:{nodeId:"sum",port:"b"}}],{roughness:{input:{nodeId:"sum",port:"value"}}}),o=v(t);e(Object.keys(o.nodes.get("splitVec")?.outputs??{})).toEqual(["x","y","z"]),e(Object.keys(o.nodes.get("splitColor")?.outputs??{})).toEqual(["r","g","b","a","x","y","z","w"]),e(o.nodes.get("splitVec")?.outputs.z.type).toBe("float"),e(o.nodes.get("splitColor")?.outputs.a.type).toBe("float"),e(o.output.roughness).toBeTruthy()}),t("color gradient node compiles editable stops to a sampled color",()=>{const t=j([{id:"threshold",kind:"constant.float",params:{value:.75}},{id:"gradient",kind:"color.gradient",params:{stops:[{position:0,color:"#000000",alpha:1},{position:.5,color:"#ff0000",alpha:1},{position:1,color:"#ffffff",alpha:1}]}}],[{from:{nodeId:"threshold",port:"value"},to:{nodeId:"gradient",port:"t"}}],{color:{input:{nodeId:"gradient",port:"value"}}}),o=v(t);e(o.nodes.get("gradient")?.outputs.value.type).toBe("rgba"),e(o.output.color).toBeTruthy(),e(f(t,"gradient").color).toBeTruthy()}),t("curve node compiles editable curve to a sampled float",()=>{const t=j([{id:"t",kind:"constant.float",params:{value:.75}},{id:"curve",kind:"utility.curve",params:{curve:"InOutQuad"}}],[{from:{nodeId:"t",port:"value"},to:{nodeId:"curve",port:"t"}}],{roughness:{input:{nodeId:"curve",port:"value"}}}),o=v(t);e(o.nodes.get("curve")?.outputs.value.type).toBe("float"),e(o.output.roughness).toBeTruthy(),e(f(t,"curve").color).toBeTruthy()}),t("graph parameters convert to property params and custom defaults",()=>{const t=g();t.parameters.push({name:"opacity",type:"float",group:"Surface",defaultValue:.5});const o=b(t);e(o.map(e=>e.name)).toEqual(["baseColor","opacity"]),e(o.every(e=>!0===e.options.optional)).toBe(!0),e(o.map(e=>e.options.group??null)).toEqual([null,"Surface"]);const a=d(t);e(a.baseColor).toMatchObject({type:i.RgbNode,value:"#ffffff",override:!1}),e(a.opacity).toMatchObject({type:i.FloatNode,value:.5,override:!1})}),t("existing shader graph param values keep overriding unless explicitly disabled",()=>{const t=g(),o=d(t,{baseColor:{type:i.RgbNode,value:"#ff0000"}});e(o.baseColor).toMatchObject({type:i.RgbNode,value:"#ff0000",override:!0});const a=d(t,{baseColor:{type:i.RgbNode,value:"#00ff00",override:!1}});e(a.baseColor).toMatchObject({type:i.RgbNode,value:"#ffffff",override:!1})}),t("texture graph parameter defaults serialize as sampler parameters",()=>{const t=j([],[],{});t.parameters.push({name:"map",type:"texture",defaultValue:"texture-asset-id"});const o=d(t);e(o.map).toMatchObject({type:i.Sampler2DNode,value:"texture-asset-id"})}),t("shader graph params keep graph-declared serialized types over previous string params",()=>{const t=g();t.parameters.push({name:"map",type:"texture",defaultValue:null});const o=d(t,{baseColor:{type:i.String,value:"#ff0000"},map:{type:i.String,value:"texture-asset-id"}});e(o.baseColor).toMatchObject({type:i.RgbNode,value:"#ff0000"}),e(o.map).toMatchObject({type:i.Sampler2DNode,value:"texture-asset-id"})}),t("shader graph texture params resolve asset ids before compile",async()=>{const t=j([{id:"texture",kind:"input.parameter",params:{parameter:"map"}}],[],{color:{input:{nodeId:"texture",port:"value"}}});t.parameters.push({name:"map",type:"texture",defaultValue:"texture-asset-id"});const o=await u({},t,new D([{id:"texture-asset-id",name:"Map",type:"texture",fileKey:"map.png",fileFormat:"png"}]),new O);e(o.map).toBeTruthy(),e(typeof o.map).not.toBe("string"),e(v(t,{parameters:o}).output.color).toBeTruthy()}),t("shader graph requests all texture parameters before waiting for decoding",async()=>{const t=g();let a;t.parameters=["colorMap","normalMap","controlMap"].map(e=>({name:e,type:"texture",defaultValue:e}));const r=new Promise(e=>{a=e}),s=o.fn(async()=>(await r,new n)),d=u({},t,{getAsset:async e=>({id:e,type:"texture"})},{getTexture:s});await Promise.resolve(),await Promise.resolve(),e(s).toHaveBeenCalledTimes(3),a();const i=await d;e(Object.keys(i)).toEqual(["colorMap","normalMap","controlMap"]),e(Object.values(i).every(e=>null!=e)).toBe(!0)}),t("shader graph texture array params expose named slice uniforms",async()=>{const t=j([{id:"texture",kind:"input.parameter",params:{parameter:"map"}}],[],{color:{input:{nodeId:"texture",port:"value"}}});t.parameters.push({name:"map",type:"texture",defaultValue:"texture-array-layer"});const o=await u({},t,new D([{id:"texture-array-layer",name:"Map Layer",type:"texture",fileKey:"map.png",fileFormat:"png",texture:{textureArrayFileKey:"textures/packed.ktx2",textureArrayLayer:5}}]),new P(new n,5)),a=c(t,{parameters:o});e(a.uniforms.pu_map_i?.value).toBe(5),e(a.fragmentShader).toContain("uniform float pu_map_i")}),t("standard shader height maps support texture array slices",()=>{const t=new C;t.heightMap=new T("heightMap",new n,new B("heightMap_i",3,void 0,!1)),t.map=k(new n),t.heightScale=.05;const o=t.build();e(o.fragmentShader).toContain("uniform sampler2DArray heightMap"),e(o.fragmentShader).toContain("uniform float heightMap_i"),e(o.fragmentShader).toContain("texture(heightMap, vec3(uv + vCurrOffset, heightMapLayer)).r")}),t("standard shader supports particle opacity for instanced VFX materials",()=>{const t=(new C).build();e(t.fragmentShader).toContain("IS_PARTICLE"),e(t.fragmentShader).toContain("particleData")}),t("material graph asset reference and local embedded graph both build materials",async()=>{const t={id:"graph-asset",name:"Reusable Graph",type:"shaderGraph",shaderGraph:g()},o=S("referenced",{source:"asset",assetId:t.id}),a=S("local",{source:"local",graph:g()}),r=new D([t,o,a]),n=new p;e((await s(o,null,r,n,[],!1)).isMaterial).toBe(!0),e((await s(a,null,r,n,[],!1)).isMaterial).toBe(!0)}),t("selected-node preview compiles scalar, vector, color, rgba, and boolean outputs",()=>{const t=[{id:"float",kind:"constant.float",params:{value:.25}},{id:"slider",kind:"input.slider",params:{value:.5}},{id:"vec2",kind:"constant.vec2",params:{value:[1,0]}},{id:"rgb",kind:"constant.vec3",params:{value:[1,.5,0]}},{id:"rgba",kind:"constant.rgba",params:{value:"#ff8800",alpha:.75}},{id:"boolean",kind:"constant.boolean",params:{value:!0}}];for(const o of t){const t=j([o],[],{color:{input:{nodeId:o.id,port:"value"}}});e(f(t,o.id).color).toBeTruthy()}}),t("post-process shader graph builds a fullscreen-safe material",()=>{const t=h(),o=m(t);e(o).toBeInstanceOf(x),e(o.depthWrite).toBe(!1),e(o.depthTest).toBe(!1),e(o.toneMapped).toBe(!1),e(o.transparent).toBe(!1),e(o.userData.isPostProcessShaderGraph).toBe(!0),e(o.uniforms[M]).toBeTruthy(),e(o.uniforms[I]).toBeTruthy()}),t("empty post-process shader graph defaults to identity scene color",()=>{const t=h();t.nodes=[],t.edges=[],t.outputs={};const o=v(t),a=m(t);e(o.output.color).toBeTruthy(),e(o.output.transparent).toBe(!1),e(a.uniforms[M]).toBeTruthy(),e(a.uniforms[I]).toBeTruthy()}),t("post-process color and opacity outputs expose blend weight uniform",()=>{const t=j([{id:"color",kind:"constant.rgba",params:{value:"#ff0044",alpha:1}},{id:"opacity",kind:"constant.float",params:{value:.35}}],[],{color:{input:{nodeId:"color",port:"value"}},opacity:{input:{nodeId:"opacity",port:"value"}},roughness:{value:.8}});t.target="postProcess";const o=v(t),a=m(t);e(o.output.color).toBeTruthy(),e(o.output.opacity).toBeTruthy(),e(o.output.roughness).toBeUndefined(),e(a.uniforms[I]).toBeTruthy()}),t("selected-node preview builds through post-process fullscreen path",()=>{const t=j([{id:"float",kind:"constant.float",params:{value:.25}}],[],{color:{input:{nodeId:"float",port:"value"}}});t.target="postProcess";const o=m(t,{previewNodeId:"float"});e(o).toBeInstanceOf(x),e(o.userData.isPostProcessShaderGraph).toBe(!0),e(o.uniforms[M]).toBeTruthy(),e(o.uniforms[I]).toBeTruthy()}),t("texture parameter nodes expose sampled value and channel outputs",()=>{const t=j([{id:"texture",kind:"input.parameter",params:{parameter:"albedo"}}],[],{color:{input:{nodeId:"texture",port:"value"}}});t.parameters.push({name:"albedo",type:"texture",defaultValue:null});const o=v(t,{parameters:{albedo:new n}}),a=o.nodes.get("texture")?.outputs??{};e(Object.keys(a)).toEqual(["value","rgb","r","g","b","a","sampler"]),e(a.value.type).toBe("rgba"),e(a.rgb.type).toBe("rgb"),e(a.r.type).toBe("float"),e(a.g.type).toBe("float"),e(a.b.type).toBe("float"),e(a.a.type).toBe("float"),e(a.sampler.type).toBe("sampler2d"),e(o.output.color).toBeTruthy()}),t("texture parameter nodes accept resolved sampler values",()=>{const t=j([{id:"texture",kind:"input.parameter",params:{parameter:"map"}}],[],{color:{input:{nodeId:"texture",port:"value"}}});t.parameters.push({name:"map",type:"texture",defaultValue:"texture-asset-id"});const o=v(t,{parameters:{map:k(new n)}});e(o.output.color).toBeTruthy()}),t("missing texture parameter values warn and use fallback sampler",()=>{const t=j([{id:"texture",kind:"input.parameter",params:{parameter:"missingTexture"}}],[],{color:{input:{nodeId:"texture",port:"value"}}});t.parameters.push({name:"missingTexture",type:"texture",defaultValue:null});const a=o.spyOn(console,"warn").mockImplementation(()=>{});try{const o=v(t),r=o.nodes.get("texture")?.outputs??{};e(r.sampler.type).toBe("sampler2d"),e(o.output.color).toBeTruthy(),e(a).toHaveBeenCalledWith(e.stringContaining("missingTexture"))}finally{a.mockRestore()}}),t("scene depth graph nodes expose sampled and fragment linear eye depth",()=>{const t=j([{id:"uv",kind:"builtin.screenUv"},{id:"sceneDepth",kind:"scene.sampleDepth"},{id:"fragmentDepth",kind:"scene.fragmentDepth"},{id:"depthFade",kind:"math.subtract"}],[{from:{nodeId:"uv",port:"value"},to:{nodeId:"sceneDepth",port:"uv"}},{from:{nodeId:"sceneDepth",port:"linearEyeDepth"},to:{nodeId:"depthFade",port:"a"}},{from:{nodeId:"fragmentDepth",port:"linearEyeDepth"},to:{nodeId:"depthFade",port:"b"}}],{opacity:{input:{nodeId:"depthFade",port:"value"}}}),o=v(t);e(o.nodes.get("sceneDepth")?.outputs.depth.type).toBe("float"),e(o.nodes.get("sceneDepth")?.outputs.linearEyeDepth.type).toBe("float"),e(o.nodes.get("fragmentDepth")?.outputs.linearEyeDepth.type).toBe("float"),e(o.output.opacity).toBeTruthy()}),t("screen UV builtin accepts a fullscreen compiler override",()=>{const t=j([{id:"uv",kind:"builtin.screenUv"}],[],{}),o=w(.25,.75),a=v(t,{screenUV:o});e(a.nodes.get("uv")?.outputs.value.value).toBe(o)}),t("unpack normal node compiles with various input combinations",()=>{const t=j([{id:"sample",kind:"constant.vec3",params:{value:[.5,.5,1]}},{id:"scale",kind:"constant.float",params:{value:1}},{id:"normal",kind:"builtin.normal"},{id:"toNormal",kind:"color.unpackNormal"}],[{from:{nodeId:"sample",port:"value"},to:{nodeId:"toNormal",port:"color"}},{from:{nodeId:"scale",port:"value"},to:{nodeId:"toNormal",port:"scale"}},{from:{nodeId:"normal",port:"value"},to:{nodeId:"toNormal",port:"normal"}}],{normal:{input:{nodeId:"toNormal",port:"value"}}}),o=v(t);e(o.nodes.get("toNormal")?.outputs.value.type).toBe("vec3"),e(o.output.normal).toBeTruthy()});class D extends l{constructor(e){super(),this.onCreate=null,this.onDelete=null,this.onUpdate=null,this.assets=new Map(e.map(e=>[e.id,e]))}async getAsset(e){return this.assets.get(e)}async getAssets(){return Array.from(this.assets.values())}}class O extends p{async getTexture(){return new n}async getTextureArray(){return{texture:null,layerIndex:null}}}class P extends O{constructor(e,t){super(),this.textureArray=e,this.layerIndex=t}async getTextureArray(){return{texture:this.textureArray,layerIndex:this.layerIndex}}}/*
+import{expect as e,test as t,vi as o}from"vitest";import{DoubleSide as a,FrontSide as r,Texture as n}from"three";o.hoisted(()=>{if("undefined"==typeof HTMLCanvasElement)return;const e=new Proxy({},{get:(e,t)=>(t in e||(e[t]=("string"!=typeof t||!t.startsWith("is"))&&o.fn()),e[t]),set:(e,t,o)=>(e[t]=o,!0)});Object.defineProperty(HTMLCanvasElement.prototype,"getContext",{configurable:!0,value:()=>e}),"undefined"==typeof AudioBuffer&&Object.defineProperty(globalThis,"AudioBuffer",{configurable:!0,value:class{}})}),o.mock("three/examples/jsm/Addons.js",async e=>({...await e(),ConvexHull:class{},SkeletonUtils:{clone:e=>e},RectAreaLightHelper:class{}})),o.mock("three-shader-graph",async e=>{const t=await e();return{...t,rgb:(e,o,a)=>null==o&&null==a&&!0===e?.isColor&&"function"==typeof e.getHexString?t.rgb("#"+e.getHexString()):t.rgb(e,o,a)}}),o.mock("../rendering.js",()=>({RenderingView:class{constructor(){this._id="test",this.csm={setupMaterial:o.fn()}}getEnvTexture(e){return e}},setRenderingPaused:o.fn()}));import{materialFromAsset as s,prepareCustomParamsFromShaderGraph as d,prepareShaderGraphParameters as u}from"../scene/materializer.js";import{createShaderGraphMaterial as i}from"../effects/vfx/vfx-materializer.js";import{getCompiledGpuSpriteMaterial as p,getGpuSpriteMaterialWgsl as l}from"../effects/vfx/gpu-sprite-runtime.js";import{SerializedParamType as m}from"../scene/model.js";import{AssetsProvider as c}from"../scene/assets-provider.js";import{AssetResourceLoader as v}from"../scene/asset-resource-loader.js";import{buildShaderGraphMaterial as f,buildShaderGraphPostProcessMaterial as h,compileShaderGraph as g,compileShaderGraphPreview as y,createDefaultPostProcessShaderGraphDocument as I,createDefaultShaderGraphDocument as b,createDefaultVfxShaderGraphDocument as B,shaderGraphPostProcessWeightUniformName as x,shaderGraphParametersToPropertyParameters as k}from"../shader/graph/index.js";import{NodeShaderMaterial as w,textureSampler2d as T,UniformFloatNode as M,UniformSampler2dArraySlice as S,vec2 as C}from"../shader-nodes/index.js";import{StandardShader as j}from"../shader/builtin/standard-shader.js";import{sceneMapUniformName as _}from"../shader-nodes/scene-sample.js";function O(e,t,o){return{version:1,target:"surface",parameters:[],nodes:e,edges:t,outputs:o}}function D(e,t){return{id:e,name:e,type:"material",material:{type:"shaderGraph",side:r,params:{},shaderParams:{},shaderGraph:t}}}t("VFX graph materials retain graph and animation profile diagnostic metadata",async()=>{const t=B("sprite");t.parameters.push({name:"amount",type:"float",defaultValue:1});const o=await i({type:"sprite",shaderGraph:{source:"asset",assetId:"diagnostic-graph"},shaderGraphParams:{amount:{type:m.FloatNode,value:{a:0,b:1,easing:"InQuad"},override:!0}}},"sprite",new A([{id:"diagnostic-graph",name:"Diagnostic graph",type:"shaderGraph",shaderGraph:t}]),new E,{shaders:[]});e(o?.userData.vfxShader).toMatchObject({key:"shaderGraph:diagnostic-graph",name:"Diagnostic graph",target:"sprite",parameters:{amount:{mode:"animated",easing:"InQuad"}}})}),t.each(["sprite","decal"])("VFX %s graphs share static and animated parameter shader layouts",async t=>{const o=B(t);o.shadingModel="decal"===t?"standard":"unlit",o.parameters.push({name:"amount",type:"float",defaultValue:1}),o.nodes.push({id:"amount",kind:"input.parameter",params:{parameter:"amount"}}),o.outputs.opacity={input:{nodeId:"amount",port:"value"}};const a=new A([{id:"graph",name:"Graph",type:"shaderGraph",shaderGraph:o}]),r=async e=>await i({type:t,shaderGraph:{source:"asset",assetId:"graph"},shaderGraphParams:{amount:{type:m.FloatNode,value:e,override:!0}}},t,a,new E,{shaders:[]}),n=await r(.5),s=await r({a:0,b:1,easing:"InQuad"}),d=await r({a:1,b:0,easing:"OutCubic"});e(n.userData.vfxShader.animationLayout).toBe("shared"),e(n.vertexShader).toBe(s.vertexShader),e(n.fragmentShader).toBe(s.fragmentShader),e(s.fragmentShader).toBe(d.fragmentShader);const u=[n,s,d].map(p);e(u[0].vertexMain).toBe(u[1].vertexMain),e(u[0].fragmentMain).toBe(u[1].fragmentMain),e(u[1].fragmentMain).toBe(u[2].fragmentMain),e(Object.keys(u[0].textures)).toEqual(Object.keys(u[1].textures)),e(n.uniforms.pu_amount_animation.value.z).toBe(0),e(s.uniforms.pu_amount_animation.value.z).toBe(1),e(n.transparent).toBe(s.transparent),e(n.side).toBe(s.side),e(n.depthTest).toBe(s.depthTest)}),t("graph validation rejects missing nodes, invalid ports, and incompatible edges",()=>{const t=b();t.outputs.color={input:{nodeId:"missing",port:"value"}},e(()=>g(t)).toThrow(/Missing shader graph node/);const o=b();o.outputs.color={input:{nodeId:"base-color",port:"missing"}},e(()=>g(o)).toThrow(/does not have output/);const a=O([{id:"a",kind:"constant.vec2",params:{value:[1,1]}},{id:"b",kind:"constant.vec3",params:{value:[1,1,1]}},{id:"add",kind:"math.add"}],[{from:{nodeId:"a",port:"value"},to:{nodeId:"add",port:"a"}},{from:{nodeId:"b",port:"value"},to:{nodeId:"add",port:"b"}}],{color:{input:{nodeId:"add",port:"value"}}});e(()=>g(a)).toThrow(/Cannot add vec2 and vec3/)}),t("scene lighting nodes expose renderer ambient and directional light values",()=>{const t=O([{id:"ambient",kind:"scene.ambientLight"},{id:"directional",kind:"scene.directionalLight"}],[],{color:{input:{nodeId:"ambient",port:"color"}}}),o=g(t);e(o.nodes.get("ambient")?.outputs.color.type).toBe("rgb"),e(o.nodes.get("directional")?.outputs.color.type).toBe("rgb"),e(o.nodes.get("directional")?.outputs.direction.type).toBe("vec3");const a=f(t);e(a.fragmentShader).toContain("ambientLightColor"),t.outputs.color={input:{nodeId:"directional",port:"color"}};const r=f(t);e(r.fragmentShader).toContain("directionalLights"),e(r.fragmentShader).toContain("NUM_DIR_LIGHTS"),e(r.fragmentShader).toMatch(/max\s*\(\s*float\s*\(\s*NUM_DIR_LIGHTS\s*\)/)}),t("named reroutes pass values through declarations to multiple usages",()=>{const t=O([{id:"source",kind:"constant.float",params:{value:.75}},{id:"declaration",kind:"utility.namedRerouteDeclaration",params:{name:"Mask"}},{id:"usage-a",kind:"utility.namedRerouteUsage",params:{declarationId:"declaration"}},{id:"usage-b",kind:"utility.namedRerouteUsage",params:{declarationId:"declaration"}},{id:"add",kind:"math.add"}],[{from:{nodeId:"source",port:"value"},to:{nodeId:"declaration",port:"value"}},{from:{nodeId:"usage-a",port:"value"},to:{nodeId:"add",port:"a"}},{from:{nodeId:"usage-b",port:"value"},to:{nodeId:"add",port:"b"}}],{color:{input:{nodeId:"add",port:"value"}}}),o=g(t),a=o.nodes.get("declaration")?.outputs.value;e(a?.type).toBe("float"),e(o.nodes.get("usage-a")?.outputs.value).toBe(a),e(o.nodes.get("usage-b")?.outputs.value).toBe(a),e(o.output.color).toBeTruthy()}),t("named reroutes preserve dynamic vector types",()=>{const t=O([{id:"source",kind:"constant.vec3",params:{value:[1,2,3]}},{id:"declaration",kind:"utility.namedRerouteDeclaration",params:{name:"Direction"}},{id:"usage",kind:"utility.namedRerouteUsage",params:{declarationId:"declaration"}}],[{from:{nodeId:"source",port:"value"},to:{nodeId:"declaration",port:"value"}}],{color:{input:{nodeId:"usage",port:"value"}}}),o=g(t);e(o.nodes.get("usage")?.outputs.value.type).toBe("vec3")}),t("named reroute validation rejects missing and invalid declarations",()=>{const t=O([{id:"usage",kind:"utility.namedRerouteUsage",params:{declarationId:"missing"}}],[],{});e(()=>g(t)).toThrow(/declaration "missing" does not exist/);const o=O([{id:"not-declaration",kind:"constant.float",params:{value:1}},{id:"usage",kind:"utility.namedRerouteUsage",params:{declarationId:"not-declaration"}}],[],{});e(()=>g(o)).toThrow(/not a named reroute declaration/)}),t("named reroute cycles report a compile error",()=>{const t=O([{id:"declaration",kind:"utility.namedRerouteDeclaration",params:{name:"Cycle"}},{id:"usage",kind:"utility.namedRerouteUsage",params:{declarationId:"declaration"}}],[{from:{nodeId:"usage",port:"value"},to:{nodeId:"declaration",port:"value"}}],{color:{input:{nodeId:"usage",port:"value"}}});e(()=>g(t)).toThrow(/contains a cycle/)}),t("surface graph compiles to NodeShaderOutput",()=>{const t=g(b("surface"));e(t.output.color).toBeTruthy(),e(t.output.transparent).toBe(!1)}),t("inline literal inputs compile without separate constant nodes",()=>{const t=O([{id:"uv",kind:"builtin.uv"},{id:"scale-uv",kind:"math.multiply",inputs:{b:{value:2,valueType:"float"}}},{id:"rotate",kind:"uv.rotate",inputs:{angle:{value:.5,valueType:"float"},center:{value:[.25,.75],valueType:"vec2"}}},{id:"translate",kind:"transform.translate",inputs:{offset:{value:[0,1,0],valueType:"vec3"}}}],[{from:{nodeId:"uv",port:"value"},to:{nodeId:"scale-uv",port:"a"}},{from:{nodeId:"scale-uv",port:"value"},to:{nodeId:"rotate",port:"uv"}}],{color:{input:{nodeId:"rotate",port:"value"}},transform:{input:{nodeId:"translate",port:"value"}}}),o=g(t);e(o.nodes.get("scale-uv")?.outputs.value.type).toBe("vec2"),e(o.nodes.get("rotate")?.outputs.value.type).toBe("vec2"),e(o.nodes.get("translate")?.outputs.value.type).toBe("mat4"),e(o.output.color).toBeTruthy(),e(o.output.transform).toBeTruthy()}),t("uv attribute node supports selecting non-default uv channels",()=>{const t=O([{id:"uv",kind:"builtin.uv",params:{channel:2}}],[],{color:{input:{nodeId:"uv",port:"value"}}}),o=g(t);e(o.nodes.get("uv")?.outputs.value.type).toBe("vec2");const a=f(t);e(a.fragmentShader).toContain("uv2")}),t.each(["surface","decal"])("world normal node compiles for %s graphs",t=>{const o=O([{id:"world-normal",kind:"builtin.worldNormal"}],[],{color:{input:{nodeId:"world-normal",port:"value"}}});o.target=t;const a=g(o);e(a.nodes.get("world-normal")?.outputs.value.type).toBe("vec3"),e(f(o).fragmentShader).toBeTruthy()}),t("sprite graph compiles with sprite-compatible material output",()=>{const t=b("sprite"),o=g(t);e(o.output.color).toBeTruthy(),e(o.output.transparent).toBe(!0)}),t("default VFX shader graphs compile mapped targets and build non-sprite materials",()=>{for(const t of["sprite","surface","decal","trail"]){const o=B(t);if(e(g(o).output.color).toBeTruthy(),"sprite"===t)continue;const a=f(o,{trailBillboard:"trail"===t});e(a.isMaterial).toBe(!0)}}),t("graph material options apply to supported material targets",()=>{const t=b("surface");t.materialOptions={side:"double",transparent:!0};const o=f(t);e(o.side).toBe(a),e(o.transparent).toBe(!0);const r=b("decal");r.materialOptions={transparent:!0};const n=f(r);e(n.transparent).toBe(!0)}),t("standard graph compiles extended material outputs and vertex transform",()=>{const t=O([{id:"metalness",kind:"constant.float",params:{value:.8}},{id:"ao",kind:"constant.float",params:{value:.5}},{id:"sheen",kind:"constant.vec3",params:{value:[.1,.2,.3]}},{id:"offset",kind:"constant.vec3",params:{value:[0,1,0]}},{id:"translate",kind:"transform.translate"}],[{from:{nodeId:"offset",port:"value"},to:{nodeId:"translate",port:"offset"}}],{metalness:{input:{nodeId:"metalness",port:"value"}},ambientOcclusion:{input:{nodeId:"ao",port:"value"}},sheenColor:{input:{nodeId:"sheen",port:"value"}},transform:{input:{nodeId:"translate",port:"value"}}}),o=g(t);e(o.output.metalness).toBeTruthy(),e(o.output.ambientOcclusion).toBeTruthy(),e(o.output.sheenColor).toBeTruthy(),e(o.output.transform).toBeTruthy();const a=f(t);e(a.outputMetalness).toBeTruthy(),e(a.outputAmbientOcclusion).toBeTruthy(),e(a.outputTransform).toBeTruthy()}),t("math multiply composes transform matrices",()=>{const t=O([{id:"translate",kind:"transform.translate",inputs:{offset:{value:[0,1,0],valueType:"vec3"}}},{id:"scale",kind:"transform.scale",inputs:{scale:{value:[2,2,2],valueType:"vec3"}}},{id:"compose",kind:"math.multiply"}],[{from:{nodeId:"translate",port:"value"},to:{nodeId:"compose",port:"a"}},{from:{nodeId:"scale",port:"value"},to:{nodeId:"compose",port:"b"}}],{transform:{input:{nodeId:"compose",port:"value"}}}),o=g(t);e(o.nodes.get("compose")?.outputs.value.type).toBe("mat4"),e(o.output.transform).toBeTruthy(),e(f(t).outputTransform).toBeTruthy()}),t("matrix input nodes compile as mat4 uniforms",()=>{for(const t of["builtin.viewMatrix","builtin.projectionMatrix","builtin.modelViewMatrix"]){const o=O([{id:"matrix",kind:t}],[],{transform:{input:{nodeId:"matrix",port:"value"}}}),a=g(o);e(a.nodes.get("matrix")?.outputs.value.type).toBe("mat4"),e(a.output.transform).toBeTruthy()}}),t("compose vec4 node compiles from float components",()=>{const t=O([{id:"compose",kind:"compose.vec4",inputs:{x:{value:.1},y:{value:.2},z:{value:.3},w:{value:1}}}],[],{color:{input:{nodeId:"compose",port:"value"}}}),o=g(t);e(o.nodes.get("compose")?.outputs.value.type).toBe("vec4"),e(o.output.color).toBeTruthy()}),t("atan2 node compiles from y and x inputs",()=>{const t=O([{id:"atan2",kind:"math.atan2",inputs:{y:{value:1},x:{value:0}}}],[],{color:{input:{nodeId:"atan2",port:"value"}}}),o=g(t);e(o.nodes.get("atan2")?.outputs.value.type).toBe("float"),e(o.output.color).toBeTruthy()}),t("built-in attribute nodes compile for fragment and transform outputs",()=>{const t=O([{id:"color",kind:"builtin.color"},{id:"normal",kind:"builtin.normal"},{id:"position",kind:"builtin.position"},{id:"worldPosition",kind:"builtin.worldPosition"},{id:"objectPosition",kind:"builtin.objectPosition"},{id:"translate",kind:"transform.translate"}],[{from:{nodeId:"objectPosition",port:"value"},to:{nodeId:"translate",port:"offset"}}],{color:{input:{nodeId:"color",port:"value"}},normal:{input:{nodeId:"normal",port:"value"}},roughness:{input:{nodeId:"position",port:"x"}},metalness:{input:{nodeId:"worldPosition",port:"x"}},transform:{input:{nodeId:"translate",port:"value"}}}),o=g(t);e(o.nodes.get("color")?.outputs.value.type).toBe("rgba"),e(o.nodes.get("normal")?.outputs.value.type).toBe("vec3"),e(o.nodes.get("position")?.outputs.value.type).toBe("vec3"),e(o.nodes.get("worldPosition")?.outputs.value.type).toBe("vec3"),e(o.nodes.get("objectPosition")?.outputs.value.type).toBe("vec3"),e(o.output.color).toBeTruthy(),e(o.output.normal).toBeTruthy(),e(o.output.transform).toBeTruthy(),e(f(t).outputTransform).toBeTruthy()}),t("painted layer mix node compiles color layers and builds a material",()=>{const t=O([{id:"base",kind:"constant.rgba",params:{value:"#224422",alpha:1}},{id:"grass",kind:"constant.rgba",params:{value:"#55aa33",alpha:1}},{id:"stone",kind:"constant.rgba",params:{value:"#777777",alpha:1}},{id:"mix",kind:"layer.mixPainted",params:{mode:"soft",enableNoise:!0,softness:.25,noiseScale:.2,noiseAmount:.4}}],[{from:{nodeId:"base",port:"value"},to:{nodeId:"mix",port:"base"}},{from:{nodeId:"grass",port:"value"},to:{nodeId:"mix",port:"layer1"}},{from:{nodeId:"stone",port:"value"},to:{nodeId:"mix",port:"layer3"}}],{color:{input:{nodeId:"mix",port:"value"}}}),o=g(t);e(o.nodes.get("mix")?.outputs.value.type).toBe("rgba"),e(o.output.color).toBeTruthy(),e(f(t).isMaterial).toBe(!0)}),t("painted layer mix node compiles sparse float layers in hard and soft modes",()=>{for(const t of["hard","soft"]){const o=O([{id:"base",kind:"constant.float",params:{value:.8}},{id:"mud",kind:"constant.float",params:{value:1}},{id:"wet",kind:"constant.float",params:{value:.25}},{id:"mix",kind:"layer.mixPainted",params:{mode:t,enableNoise:!1,softness:.3,noiseScale:.1,noiseAmount:.5}}],[{from:{nodeId:"base",port:"value"},to:{nodeId:"mix",port:"base"}},{from:{nodeId:"mud",port:"value"},to:{nodeId:"mix",port:"layer2"}},{from:{nodeId:"wet",port:"value"},to:{nodeId:"mix",port:"layer8"}}],{roughness:{input:{nodeId:"mix",port:"value"}}}),a=g(o);e(a.nodes.get("mix")?.outputs.value.type).toBe("float"),e(a.output.roughness).toBeTruthy()}}),t("painted layer mix node rejects incompatible layer types",()=>{const t=O([{id:"base",kind:"constant.vec2",params:{value:[0,1]}},{id:"layer",kind:"constant.vec3",params:{value:[1,0,0]}},{id:"mix",kind:"layer.mixPainted"}],[{from:{nodeId:"base",port:"value"},to:{nodeId:"mix",port:"base"}},{from:{nodeId:"layer",port:"value"},to:{nodeId:"mix",port:"layer1"}}],{color:{input:{nodeId:"mix",port:"value"}}});e(()=>g(t)).toThrow(/Cannot mix vec2 and vec3/)}),t("additional math, uv, shape, noise, and effect nodes compile",()=>{const t=O([{id:"uv",kind:"builtin.uv"},{id:"angle",kind:"constant.float",params:{value:.5}},{id:"scale",kind:"constant.float",params:{value:4}},{id:"half",kind:"constant.float",params:{value:.5}},{id:"axis",kind:"constant.vec3",params:{value:[0,1,0]}},{id:"rotatedUv",kind:"uv.rotate"},{id:"twirl",kind:"uv.twirl"},{id:"bulge",kind:"uv.bulge"},{id:"radial",kind:"uv.radial"},{id:"flipbook",kind:"uv.flipbook"},{id:"shape",kind:"shape.roundedRectangle"},{id:"noise",kind:"noise.simplex"},{id:"voronoi",kind:"noise.voronoi2d"},{id:"fresnel",kind:"effect.fresnel"},{id:"sin",kind:"math.sin"},{id:"pow",kind:"math.pow"},{id:"mix",kind:"math.mix"},{id:"rotateAxis",kind:"transform.rotateAxis"}],[{from:{nodeId:"uv",port:"value"},to:{nodeId:"rotatedUv",port:"uv"}},{from:{nodeId:"angle",port:"value"},to:{nodeId:"rotatedUv",port:"angle"}},{from:{nodeId:"rotatedUv",port:"value"},to:{nodeId:"twirl",port:"uv"}},{from:{nodeId:"scale",port:"value"},to:{nodeId:"twirl",port:"strength"}},{from:{nodeId:"twirl",port:"value"},to:{nodeId:"bulge",port:"uv"}},{from:{nodeId:"half",port:"value"},to:{nodeId:"bulge",port:"power"}},{from:{nodeId:"bulge",port:"value"},to:{nodeId:"radial",port:"uv"}},{from:{nodeId:"twirl",port:"value"},to:{nodeId:"flipbook",port:"uv"}},{from:{nodeId:"twirl",port:"value"},to:{nodeId:"shape",port:"uv"}},{from:{nodeId:"half",port:"value"},to:{nodeId:"shape",port:"width"}},{from:{nodeId:"half",port:"value"},to:{nodeId:"shape",port:"height"}},{from:{nodeId:"half",port:"value"},to:{nodeId:"shape",port:"radius"}},{from:{nodeId:"twirl",port:"value"},to:{nodeId:"noise",port:"uv"}},{from:{nodeId:"scale",port:"value"},to:{nodeId:"noise",port:"scale"}},{from:{nodeId:"twirl",port:"value"},to:{nodeId:"voronoi",port:"uv"}},{from:{nodeId:"scale",port:"value"},to:{nodeId:"voronoi",port:"scale"}},{from:{nodeId:"scale",port:"value"},to:{nodeId:"fresnel",port:"power"}},{from:{nodeId:"radial",port:"angle"},to:{nodeId:"sin",port:"value"}},{from:{nodeId:"noise",port:"value"},to:{nodeId:"pow",port:"a"}},{from:{nodeId:"half",port:"value"},to:{nodeId:"pow",port:"b"}},{from:{nodeId:"shape",port:"value"},to:{nodeId:"mix",port:"a"}},{from:{nodeId:"voronoi",port:"value"},to:{nodeId:"mix",port:"b"}},{from:{nodeId:"fresnel",port:"value"},to:{nodeId:"mix",port:"t"}},{from:{nodeId:"axis",port:"value"},to:{nodeId:"rotateAxis",port:"axis"}},{from:{nodeId:"angle",port:"value"},to:{nodeId:"rotateAxis",port:"angle"}}],{color:{input:{nodeId:"mix",port:"value"}},opacity:{input:{nodeId:"sin",port:"value"}},anisotropyDirection:{input:{nodeId:"flipbook",port:"value"}},transform:{input:{nodeId:"rotateAxis",port:"value"}}}),o=g(t);e(o.nodes.get("mix")?.outputs.value.type).toBe("float"),e(o.nodes.get("twirl")?.outputs.value.type).toBe("vec2"),e(o.nodes.get("bulge")?.outputs.value.type).toBe("vec2"),e(o.nodes.get("radial")?.outputs.coords.type).toBe("vec2"),e(o.nodes.get("flipbook")?.outputs.value.type).toBe("vec2"),e(o.nodes.get("rotateAxis")?.outputs.value.type).toBe("mat4"),e(o.output.color).toBeTruthy(),e(o.output.opacity).toBeTruthy(),e(o.output.transform).toBeTruthy()}),t("slider input node outputs a clamped float value",()=>{const t=O([{id:"slider",kind:"input.slider",params:{value:1.25}}],[],{roughness:{input:{nodeId:"slider",port:"value"}}}),o=g(t);e(o.nodes.get("slider")?.outputs.value.type).toBe("float"),e(o.output.roughness).toBeTruthy()}),t("comparison and boolean graph nodes compile to boolean outputs",()=>{const t=O([{id:"a",kind:"constant.float",params:{value:.75}},{id:"b",kind:"constant.float",params:{value:.5}},{id:"greater",kind:"compare.greaterThan"},{id:"lessEqual",kind:"compare.lessThanOrEqual"},{id:"not",kind:"boolean.not"},{id:"and",kind:"boolean.and"},{id:"or",kind:"boolean.or"}],[{from:{nodeId:"a",port:"value"},to:{nodeId:"greater",port:"a"}},{from:{nodeId:"b",port:"value"},to:{nodeId:"greater",port:"b"}},{from:{nodeId:"a",port:"value"},to:{nodeId:"lessEqual",port:"a"}},{from:{nodeId:"b",port:"value"},to:{nodeId:"lessEqual",port:"b"}},{from:{nodeId:"lessEqual",port:"value"},to:{nodeId:"not",port:"value"}},{from:{nodeId:"greater",port:"value"},to:{nodeId:"and",port:"a"}},{from:{nodeId:"not",port:"value"},to:{nodeId:"and",port:"b"}},{from:{nodeId:"and",port:"value"},to:{nodeId:"or",port:"a"}},{from:{nodeId:"lessEqual",port:"value"},to:{nodeId:"or",port:"b"}}],{discard:{input:{nodeId:"or",port:"value"}}}),o=g(t);e(o.nodes.get("greater")?.outputs.value.type).toBe("boolean"),e(o.nodes.get("lessEqual")?.outputs.value.type).toBe("boolean"),e(o.nodes.get("not")?.outputs.value.type).toBe("boolean"),e(o.nodes.get("and")?.outputs.value.type).toBe("boolean"),e(o.nodes.get("or")?.outputs.value.type).toBe("boolean"),e(o.output.discard).toBeTruthy()}),t("split component node exposes vector and color channels as separate outputs",()=>{const t=O([{id:"vec",kind:"constant.vec3",params:{value:[.2,.4,.6]}},{id:"color",kind:"constant.rgba",params:{value:"#336699",alpha:.75}},{id:"splitVec",kind:"decompose.split"},{id:"splitColor",kind:"decompose.split"},{id:"sum",kind:"math.add"}],[{from:{nodeId:"vec",port:"value"},to:{nodeId:"splitVec",port:"value"}},{from:{nodeId:"color",port:"value"},to:{nodeId:"splitColor",port:"value"}},{from:{nodeId:"splitVec",port:"z"},to:{nodeId:"sum",port:"a"}},{from:{nodeId:"splitColor",port:"a"},to:{nodeId:"sum",port:"b"}}],{roughness:{input:{nodeId:"sum",port:"value"}}}),o=g(t);e(Object.keys(o.nodes.get("splitVec")?.outputs??{})).toEqual(["x","y","z"]),e(Object.keys(o.nodes.get("splitColor")?.outputs??{})).toEqual(["r","g","b","a","x","y","z","w"]),e(o.nodes.get("splitVec")?.outputs.z.type).toBe("float"),e(o.nodes.get("splitColor")?.outputs.a.type).toBe("float"),e(o.output.roughness).toBeTruthy()}),t("color gradient node compiles editable stops to a sampled color",()=>{const t=O([{id:"threshold",kind:"constant.float",params:{value:.75}},{id:"gradient",kind:"color.gradient",params:{stops:[{position:0,color:"#000000",alpha:1},{position:.5,color:"#ff0000",alpha:1},{position:1,color:"#ffffff",alpha:1}]}}],[{from:{nodeId:"threshold",port:"value"},to:{nodeId:"gradient",port:"t"}}],{color:{input:{nodeId:"gradient",port:"value"}}}),o=g(t);e(o.nodes.get("gradient")?.outputs.value.type).toBe("rgba"),e(o.output.color).toBeTruthy(),e(y(t,"gradient").color).toBeTruthy()}),t("curve node compiles editable curve to a sampled float",()=>{const t=O([{id:"t",kind:"constant.float",params:{value:.75}},{id:"curve",kind:"utility.curve",params:{curve:"InOutQuad"}}],[{from:{nodeId:"t",port:"value"},to:{nodeId:"curve",port:"t"}}],{roughness:{input:{nodeId:"curve",port:"value"}}}),o=g(t);e(o.nodes.get("curve")?.outputs.value.type).toBe("float"),e(o.output.roughness).toBeTruthy(),e(y(t,"curve").color).toBeTruthy()}),t("graph parameters convert to property params and custom defaults",()=>{const t=b();t.parameters.push({name:"opacity",type:"float",group:"Surface",defaultValue:.5});const o=k(t);e(o.map(e=>e.name)).toEqual(["baseColor","opacity"]),e(o.every(e=>!0===e.options.optional)).toBe(!0),e(o.map(e=>e.options.group??null)).toEqual([null,"Surface"]);const a=d(t);e(a.baseColor).toMatchObject({type:m.RgbNode,value:"#ffffff",override:!1}),e(a.opacity).toMatchObject({type:m.FloatNode,value:.5,override:!1})}),t("existing shader graph param values keep overriding unless explicitly disabled",()=>{const t=b(),o=d(t,{baseColor:{type:m.RgbNode,value:"#ff0000"}});e(o.baseColor).toMatchObject({type:m.RgbNode,value:"#ff0000",override:!0});const a=d(t,{baseColor:{type:m.RgbNode,value:"#00ff00",override:!1}});e(a.baseColor).toMatchObject({type:m.RgbNode,value:"#ffffff",override:!1})}),t("texture graph parameter defaults serialize as sampler parameters",()=>{const t=O([],[],{});t.parameters.push({name:"map",type:"texture",defaultValue:"texture-asset-id"});const o=d(t);e(o.map).toMatchObject({type:m.Sampler2DNode,value:"texture-asset-id"})}),t("shader graph params keep graph-declared serialized types over previous string params",()=>{const t=b();t.parameters.push({name:"map",type:"texture",defaultValue:null});const o=d(t,{baseColor:{type:m.String,value:"#ff0000"},map:{type:m.String,value:"texture-asset-id"}});e(o.baseColor).toMatchObject({type:m.RgbNode,value:"#ff0000"}),e(o.map).toMatchObject({type:m.Sampler2DNode,value:"texture-asset-id"})}),t("shader graph texture params resolve asset ids before compile",async()=>{const t=O([{id:"texture",kind:"input.parameter",params:{parameter:"map"}}],[],{color:{input:{nodeId:"texture",port:"value"}}});t.parameters.push({name:"map",type:"texture",defaultValue:"texture-asset-id"});const o=await u({},t,new A([{id:"texture-asset-id",name:"Map",type:"texture",fileKey:"map.png",fileFormat:"png"}]),new E);e(o.map).toBeTruthy(),e(typeof o.map).not.toBe("string"),e(g(t,{parameters:o}).output.color).toBeTruthy()}),t("shader graph requests all texture parameters before waiting for decoding",async()=>{const t=b();let a;t.parameters=["colorMap","normalMap","controlMap"].map(e=>({name:e,type:"texture",defaultValue:e}));const r=new Promise(e=>{a=e}),s=o.fn(async()=>(await r,new n)),d=u({},t,{getAsset:async e=>({id:e,type:"texture"})},{getTexture:s});await Promise.resolve(),await Promise.resolve(),e(s).toHaveBeenCalledTimes(3),a();const i=await d;e(Object.keys(i)).toEqual(["colorMap","normalMap","controlMap"]),e(Object.values(i).every(e=>null!=e)).toBe(!0)}),t("shader graph texture array params expose named slice uniforms",async()=>{const t=O([{id:"texture",kind:"input.parameter",params:{parameter:"map"}}],[],{color:{input:{nodeId:"texture",port:"value"}}});t.parameters.push({name:"map",type:"texture",defaultValue:"texture-array-layer"});const o=await u({},t,new A([{id:"texture-array-layer",name:"Map Layer",type:"texture",fileKey:"map.png",fileFormat:"png",texture:{textureArrayFileKey:"textures/packed.ktx2",textureArrayLayer:5}}]),new P(new n,5)),a=f(t,{parameters:o});e(a.uniforms.pu_map_i?.value).toBe(5),e(a.fragmentShader).toContain("uniform float pu_map_i")}),t("standard shader height maps support texture array slices",()=>{const t=new j;t.heightMap=new S("heightMap",new n,new M("heightMap_i",3,void 0,!1)),t.map=T(new n),t.heightScale=.05;const o=t.build();e(o.fragmentShader).toContain("uniform sampler2DArray heightMap"),e(o.fragmentShader).toContain("uniform float heightMap_i"),e(o.fragmentShader).toContain("texture(heightMap, vec3(uv + vCurrOffset, heightMapLayer)).r")}),t("standard shader supports particle opacity for instanced VFX materials",()=>{const t=(new j).build();e(t.fragmentShader).toContain("IS_PARTICLE"),e(t.fragmentShader).toContain("particleData")}),t("material graph asset reference and local embedded graph both build materials",async()=>{const t={id:"graph-asset",name:"Reusable Graph",type:"shaderGraph",shaderGraph:b()},o=D("referenced",{source:"asset",assetId:t.id}),a=D("local",{source:"local",graph:b()}),r=new A([t,o,a]),n=new v;e((await s(o,null,r,n,[],!1)).isMaterial).toBe(!0),e((await s(a,null,r,n,[],!1)).isMaterial).toBe(!0)}),t("selected-node preview compiles scalar, vector, color, rgba, and boolean outputs",()=>{const t=[{id:"float",kind:"constant.float",params:{value:.25}},{id:"slider",kind:"input.slider",params:{value:.5}},{id:"vec2",kind:"constant.vec2",params:{value:[1,0]}},{id:"rgb",kind:"constant.vec3",params:{value:[1,.5,0]}},{id:"rgba",kind:"constant.rgba",params:{value:"#ff8800",alpha:.75}},{id:"boolean",kind:"constant.boolean",params:{value:!0}}];for(const o of t){const t=O([o],[],{color:{input:{nodeId:o.id,port:"value"}}});e(y(t,o.id).color).toBeTruthy()}}),t("post-process shader graph builds a fullscreen-safe material",()=>{const t=I(),o=h(t);e(o).toBeInstanceOf(w),e(o.depthWrite).toBe(!1),e(o.depthTest).toBe(!1),e(o.toneMapped).toBe(!1),e(o.transparent).toBe(!1),e(o.userData.isPostProcessShaderGraph).toBe(!0),e(o.uniforms[_]).toBeTruthy(),e(o.uniforms[x]).toBeTruthy()}),t("empty post-process shader graph defaults to identity scene color",()=>{const t=I();t.nodes=[],t.edges=[],t.outputs={};const o=g(t),a=h(t);e(o.output.color).toBeTruthy(),e(o.output.transparent).toBe(!1),e(a.uniforms[_]).toBeTruthy(),e(a.uniforms[x]).toBeTruthy()}),t("post-process color and opacity outputs expose blend weight uniform",()=>{const t=O([{id:"color",kind:"constant.rgba",params:{value:"#ff0044",alpha:1}},{id:"opacity",kind:"constant.float",params:{value:.35}}],[],{color:{input:{nodeId:"color",port:"value"}},opacity:{input:{nodeId:"opacity",port:"value"}},roughness:{value:.8}});t.target="postProcess";const o=g(t),a=h(t);e(o.output.color).toBeTruthy(),e(o.output.opacity).toBeTruthy(),e(o.output.roughness).toBeUndefined(),e(a.uniforms[x]).toBeTruthy()}),t("selected-node preview builds through post-process fullscreen path",()=>{const t=O([{id:"float",kind:"constant.float",params:{value:.25}}],[],{color:{input:{nodeId:"float",port:"value"}}});t.target="postProcess";const o=h(t,{previewNodeId:"float"});e(o).toBeInstanceOf(w),e(o.userData.isPostProcessShaderGraph).toBe(!0),e(o.uniforms[_]).toBeTruthy(),e(o.uniforms[x]).toBeTruthy()}),t("texture parameter nodes expose sampled value and channel outputs",()=>{const t=O([{id:"texture",kind:"input.parameter",params:{parameter:"albedo"}}],[],{color:{input:{nodeId:"texture",port:"value"}}});t.parameters.push({name:"albedo",type:"texture",defaultValue:null});const o=g(t,{parameters:{albedo:new n}}),a=o.nodes.get("texture")?.outputs??{};e(Object.keys(a)).toEqual(["value","rgb","r","g","b","a","sampler"]),e(a.value.type).toBe("rgba"),e(a.rgb.type).toBe("rgb"),e(a.r.type).toBe("float"),e(a.g.type).toBe("float"),e(a.b.type).toBe("float"),e(a.a.type).toBe("float"),e(a.sampler.type).toBe("sampler2d"),e(o.output.color).toBeTruthy()}),t("texture parameter nodes accept resolved sampler values",()=>{const t=O([{id:"texture",kind:"input.parameter",params:{parameter:"map"}}],[],{color:{input:{nodeId:"texture",port:"value"}}});t.parameters.push({name:"map",type:"texture",defaultValue:"texture-asset-id"});const o=g(t,{parameters:{map:T(new n)}});e(o.output.color).toBeTruthy()}),t("missing texture parameter values warn and use fallback sampler",()=>{const t=O([{id:"texture",kind:"input.parameter",params:{parameter:"missingTexture"}}],[],{color:{input:{nodeId:"texture",port:"value"}}});t.parameters.push({name:"missingTexture",type:"texture",defaultValue:null});const a=o.spyOn(console,"warn").mockImplementation(()=>{});try{const o=g(t),r=o.nodes.get("texture")?.outputs??{};e(r.sampler.type).toBe("sampler2d"),e(o.output.color).toBeTruthy(),e(a).toHaveBeenCalledWith(e.stringContaining("missingTexture"))}finally{a.mockRestore()}}),t("scene depth graph nodes expose sampled and fragment linear eye depth",()=>{const t=O([{id:"uv",kind:"builtin.screenUv"},{id:"sceneDepth",kind:"scene.sampleDepth"},{id:"fragmentDepth",kind:"scene.fragmentDepth"},{id:"depthFade",kind:"math.subtract"}],[{from:{nodeId:"uv",port:"value"},to:{nodeId:"sceneDepth",port:"uv"}},{from:{nodeId:"sceneDepth",port:"linearEyeDepth"},to:{nodeId:"depthFade",port:"a"}},{from:{nodeId:"fragmentDepth",port:"linearEyeDepth"},to:{nodeId:"depthFade",port:"b"}}],{opacity:{input:{nodeId:"depthFade",port:"value"}}}),o=g(t);e(o.nodes.get("sceneDepth")?.outputs.depth.type).toBe("float"),e(o.nodes.get("sceneDepth")?.outputs.linearEyeDepth.type).toBe("float"),e(o.nodes.get("fragmentDepth")?.outputs.linearEyeDepth.type).toBe("float"),e(o.output.opacity).toBeTruthy()}),t("screen UV builtin accepts a fullscreen compiler override",()=>{const t=O([{id:"uv",kind:"builtin.screenUv"}],[],{}),o=C(.25,.75),a=g(t,{screenUV:o});e(a.nodes.get("uv")?.outputs.value.value).toBe(o)}),t("unpack normal node compiles with various input combinations",()=>{const t=O([{id:"sample",kind:"constant.vec3",params:{value:[.5,.5,1]}},{id:"scale",kind:"constant.float",params:{value:1}},{id:"normal",kind:"builtin.normal"},{id:"toNormal",kind:"color.unpackNormal"}],[{from:{nodeId:"sample",port:"value"},to:{nodeId:"toNormal",port:"color"}},{from:{nodeId:"scale",port:"value"},to:{nodeId:"toNormal",port:"scale"}},{from:{nodeId:"normal",port:"value"},to:{nodeId:"toNormal",port:"normal"}}],{normal:{input:{nodeId:"toNormal",port:"value"}}}),o=g(t);e(o.nodes.get("toNormal")?.outputs.value.type).toBe("vec3"),e(o.output.normal).toBeTruthy()});class A extends c{constructor(e){super(),this.onCreate=null,this.onDelete=null,this.onUpdate=null,this.assets=new Map(e.map(e=>[e.id,e]))}async getAsset(e){return this.assets.get(e)}async getAssets(){return Array.from(this.assets.values())}}class E extends v{async getTexture(){return new n}async getTextureArray(){return{texture:null,layerIndex:null}}}class P extends E{constructor(e,t){super(),this.textureArray=e,this.layerIndex=t}async getTextureArray(){return{texture:this.textureArray,layerIndex:this.layerIndex}}}t("animated graph ranges share shader source while retaining independent endpoint uniforms",async()=>{const t=O([{id:"amount",kind:"input.parameter",params:{parameter:"amount"}}],[],{opacity:{input:{nodeId:"amount",port:"value"}}});t.parameters.push({name:"amount",type:"float",defaultValue:1});const o=async(e,o,a)=>{const r=await u({amount:{type:m.FloatNode,value:{a:e,b:o,easing:a},override:!0}},t,new A([]),new E);return f(t,{parameters:r})},a=await o(0,1,"Linear"),r=await o(2,8,"Linear"),s=await o(0,1,"InQuad");e(a.vertexShader).toBe(r.vertexShader),e(a.fragmentShader).toBe(r.fragmentShader),e(a.uniforms.pu_amount_curveEndpoints.value.toArray()).toEqual([0,1]),e(r.uniforms.pu_amount_curveEndpoints.value.toArray()).toEqual([2,8]),e(a.uniforms.pu_amount_curveEndpoints.value).not.toBe(r.uniforms.pu_amount_curveEndpoints.value);const d=e=>Object.values(e.uniforms).map(e=>e.value).find(e=>e instanceof n);e(d(a)).toBeTruthy(),e(d(a)).toBe(d(r)),e(d(a)).not.toBe(d(s))}),t("stable particle parameters share GLSL and WGSL across static values and easing profiles",async()=>{const t=O([{id:"amount",kind:"input.parameter",params:{parameter:"amount"}}],[],{opacity:{input:{nodeId:"amount",port:"value"}}});t.shadingModel="unlit",t.parameters.push({name:"amount",type:"float",defaultValue:1});const o=async(e,o=!0)=>{const a=await u({amount:{type:m.FloatNode,value:e,override:!0}},t,new A([]),new E,void 0,void 0,o);return f(t,{parameters:a})},a=await o(2),r=await o({a:0,b:3,easing:"InQuad"}),s=await o({a:-2,b:8,easing:"OutCubic"});e(a.fragmentShader).toBe(r.fragmentShader),e(r.fragmentShader).toBe(s.fragmentShader),e(a.uniforms.pu_amount.value).toBe(2),e(a.uniforms.pu_amount_animation.value.z).toBe(0),e(r.uniforms.pu_amount.value).toBe(0),e(r.uniforms.pu_amount_animation.value.x).toBe(3),e(r.uniforms.pu_amount_animation.value.z).toBe(1);const d=e=>l(p(e),!0),i=d(a);e(i).toBe(d(r)),e(i).toBe(d(s)),e(i).toContain("if ("),e(i).toContain("textureSampleLevel(");const c=e=>Object.values(e.uniforms).map(e=>e.value).filter(e=>e instanceof n);e(c(r)).toHaveLength(1),e(c(a)[0]).toBe(c(r)[0]),e(c(s)[0]).toBe(c(r)[0]);const v=c(r)[0].image,h=Math.floor(r.uniforms.pu_amount_animation.value.y*v.height),g=c(await o({a:0,b:3,easing:"InQuad"},!1))[0].image;e(Array.from(v.data.slice(h*v.width,(h+1)*v.width))).toEqual(Array.from(g.data))});/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/test/vfx-backend-partition.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vfx-backend-partition.test.d.ts.map

package/dist/test/vfx-backend-partition.test.js

@@ -0,0 +1,4 @@
+import{describe as t,expect as e,it as i}from"vitest";import{partitionVfxBackends as s}from"../effects/vfx/vfx-backend-partition.js";const n=(t,e,i)=>({id:t,name:t,output:{type:e,space:"world"},children:i});t("VFX backend partition",()=>{i("keeps independent visual roots on GPU and whole light dependency trees on CPU",()=>{const t=n("visual","sprite"),i=n("light","pointLight"),o=n("parent","mesh",[n("child-light","pointLight")]),p={id:"effect",vfx:{emitters:[t,i,o]}},r=s(p);e(r.gpu.vfx.emitters).toEqual([t]),e(r.cpu.vfx.emitters).toEqual([i,o]),e(r.cpu.vfx.emitters[1]).toBe(o),e(p.vfx.emitters).toHaveLength(3),e(s(p).gpu).toBe(r.gpu)}),i("invalidates cached partitions on revision changes",()=>{const t={id:"effect",vfx:{emitters:[n("light","pointLight")]}};e(s(t,1).gpu.vfx.emitters).toHaveLength(0),t.vfx.emitters.push(n("visual","sprite")),e(s(t,2).gpu.vfx.emitters).toHaveLength(1)})});/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */