@rosalana/sandbox 0.0.4 → 0.1.0

package/dist/index.cjs.js

@@ -1,8 +1,834 @@
-"use strict";var w=Object.defineProperty;var k=(o,t,e)=>t in o?w(o,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):o[t]=e;var i=(o,t,e)=>k(o,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class u{constructor(t,e,r,s){this.target=t,this.type=e,this.listener=r,this.options=s,this.target.addEventListener(this.type,this.listener,this.options)}remove(){this.target.removeEventListener(this.type,this.listener,this.options)}static on(t,e,r,s){return t.addEventListener(e,r,s),()=>t.removeEventListener(e,r,s)}}class l extends Error{constructor(t,e){super(t),this.code=e,this.name="SandboxError"}}class S extends l{constructor(t){const e=t==="not_supported"?"WebGL is not supported in this browser.":"Failed to create WebGL context. The GPU may be unavailable.";super(e,t==="not_supported"?"WEBGL_NOT_SUPPORTED":"CONTEXT_CREATION_FAILED"),this.name="SandboxContextError"}}class L extends l{constructor(t,e){super(`Vertex and fragment shader WebGL versions do not match (${t} vs ${e})`,"SHADER_VERSION_MISMATCH"),this.vertexVersion=t,this.fragmentVersion=e,this.name="SandboxShaderVersionMismatchError"}}class f extends l{constructor(e,r,s){const n=f.parseErrorLines(s),a=n.length>0?` at line(s): ${n.join(", ")}`:"";super(`${e} shader compilation failed${a}
+"use strict";var te=Object.defineProperty;var ie=(u,e,n)=>e in u?te(u,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):u[e]=n;var a=(u,e,n)=>ie(u,typeof e!="symbol"?e+"":e,n);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class x{constructor(e,n,t,i){this.target=e,this.type=n,this.listener=t,this.options=i,this.target.addEventListener(this.type,this.listener,this.options)}remove(){this.target.removeEventListener(this.type,this.listener,this.options)}static on(e,n,t,i){return e.addEventListener(n,t,i),()=>e.removeEventListener(n,t,i)}}class h extends Error{constructor(n,t){super(n);a(this,"name","SandboxError");this.code=t}}class V extends h{constructor(){super("WebGL is not supported in this browser.","CONTEXT_ERROR")}}class re extends h{constructor(){super("Failed to create WebGL context. The GPU may be unavailable.","CONTEXT_ERROR")}}class $ extends h{constructor(e,n){super(`Vertex and fragment shader WebGL versions do not match (${e} vs ${n})`,"VALIDATION_ERROR"),this.vertexVersion=e,this.fragmentVersion=n}}class w extends h{constructor(n,t,i){const r=w.parseErrorLines(i),o=r.length>0?` at line(s): ${r.join(", ")}`:"";super(`${n} shader compilation failed${o}
 
-${s}`,"SHADER_COMPILATION_FAILED");i(this,"lines");this.shaderType=e,this.source=r,this.infoLog=s,this.name="SandboxShaderCompilationError",this.lines=n}static parseErrorLines(e){const r=[/ERROR:\s*\d*:(\d+)/g,/(\d+):(\d+)\(\d+\):/g,/^(\d+):/gm],s=new Set;for(const n of r){let a;for(;(a=n.exec(e))!==null;){const c=parseInt(a[1],10);c>0&&s.add(c)}}return[...s].sort((n,a)=>n-a)}}class d extends l{constructor(t){super(`Shader program linking failed
+${i}`,"SHADER_ERROR");a(this,"lines");this.shaderType=n,this.source=t,this.infoLog=i,this.lines=r}static parseErrorLines(n){const t=[/ERROR:\s*\d*:(\d+)/g,/(\d+):(\d+)\(\d+\):/g,/^(\d+):/gm],i=new Set;for(const r of t){let o;for(;(o=r.exec(n))!==null;){const s=parseInt(o[1],10);s>0&&i.add(s)}}return[...i].sort((r,o)=>r-o)}}class A extends h{constructor(e,n,t,i){super(`The shader ${e} "${n}" has type "${i}" but expected "${t}"`,"SHADER_ERROR"),this.requirement=e,this.name=n,this.expectedType=t,this.actualType=i}}class T extends h{constructor(){super("Shader source does not contain any function.","SHADER_ERROR")}}class I extends h{constructor(e,n){super(`Syntax error in shader import statement at line ${e}: ${n}`,"SHADER_ERROR"),this.line=e,this.details=n}}class P extends h{constructor(e,n){super(`Duplicate import name "${e}" found at line ${n}. Each import must have a unique name.`,"SHADER_ERROR"),this.name=e,this.line=n}}class B extends h{constructor(e){super(`Can not find module '${e}'. Check if it is defined before usage or if the name is correct.`,"MODULE_ERROR"),this.moduleName=e}}class D extends h{constructor(e,n){super(`Method '${n}' not found in shader module '${e}'. Check if the method is defined in the module source code or if the name is correct.`,"MODULE_ERROR"),this.moduleName=e,this.methodName=n}}class N extends h{constructor(e){super(`Importing 'main' function from module '${e}' is forbidden.`,"MODULE_ERROR"),this.moduleName=e}}class z extends h{constructor(e){super(`Name 'default' is reserved and cannot be used as a function name in module '${e}'.`,"MODULE_ERROR"),this.moduleName=e}}class G extends h{constructor(e){super(`Module name '${e}' is not allowed. Module names cannot be 'sandbox' or start with 'sandbox/'.`,"MODULE_ERROR"),this.moduleName=e}}class W extends h{constructor(e){super(`Module '${e}' is already defined. Overwriting existing modules is not allowed.`,"MODULE_ERROR"),this.moduleName=e}}class q extends h{constructor(e,n,t){super(`Uniform '${t}' mentioned for function '${n}' of module '${e}' was not found among the module's declared uniforms. Check if the uniform is declared in the module source code or if the name is correct.`,"MODULE_ERROR"),this.moduleName=e,this.functionName=n,this.uniformName=t}}class H extends h{constructor(e,n){super(`Uniform '${n}' mentioned for function '${e}' was not imported from any module. Check if the function is imported from the correct module and if the uniform is declared in that module's source code with the correct name.`,"MODULE_ERROR"),this.functionName=e,this.uniformName=n}}class j extends h{constructor(e,n){super(`Mention '${e}' called in function '${n}' could not be replaced with the corresponding uniform reference. There might be an issue with the compilation process because the referenced uniform was not found among the shader requirements. Try use a different name for uniforms you want to mention in functions or check if the uniform is properly declared and mentioned in the module source code.`,"MODULE_ERROR"),this.mentionName=e,this.calledInFunction=n}}class E extends h{constructor(e){super(`Shader program linking failed
 
-${t}`,"PROGRAM_LINK_FAILED"),this.infoLog=t,this.name="SandboxProgramError"}}class R{constructor(){i(this,"time",0);i(this,"delta",0);i(this,"frame",0);i(this,"running",!1);i(this,"startTime",0);i(this,"lastTime",0);i(this,"rafId",null);i(this,"callback",null);this.loop=this.loop.bind(this)}start(t){if(this.running)return this;this.callback=t,this.running=!0;const e=performance.now();return this.frame===0?this.startTime=e:this.startTime=e-this.time*1e3,this.lastTime=e,this.rafId=requestAnimationFrame(this.loop),this}stop(){return this.running?(this.running=!1,this.rafId!==null&&(cancelAnimationFrame(this.rafId),this.rafId=null),this):this}reset(){return this.stop(),this.time=0,this.delta=0,this.frame=0,this}getState(){return{time:this.time,delta:this.delta,frame:this.frame}}tick(t=0){return this.delta=t,this.time+=t,this.frame++,this.callback&&this.callback(this.getState()),this}setTime(t){return this.time=t,this}destroy(){this.reset(),this.callback=null}loop(t){this.running&&(this.delta=(t-this.lastTime)/1e3,this.lastTime=t,this.time=(t-this.startTime)/1e3,this.frame++,this.callback&&this.callback(this.getState()),this.rafId=requestAnimationFrame(this.loop))}}class p{constructor(t){i(this,"gl");i(this,"vao",null);i(this,"vbo",null);i(this,"ibo",null);i(this,"vertexCount",0);i(this,"indexCount",0);i(this,"useIndices",!1);i(this,"vaoExt",null);i(this,"isWebGL2");this.gl=t,this.isWebGL2=t instanceof WebGL2RenderingContext,this.isWebGL2||(this.vaoExt=t.getExtension("OES_vertex_array_object"))}static fullscreenQuad(t){const e=new p(t),r=new Float32Array([-1,-1,0,0,1,-1,1,0,-1,1,0,1,1,1,1,1]),s=new Uint16Array([0,1,2,2,1,3]);return e.setup(r,s),e}setup(t,e){const r=this.gl;return this.createVAO(),this.bindVAO(),this.vbo=r.createBuffer(),r.bindBuffer(r.ARRAY_BUFFER,this.vbo),r.bufferData(r.ARRAY_BUFFER,t,r.STATIC_DRAW),this.vertexCount=t.length/4,e&&(this.ibo=r.createBuffer(),r.bindBuffer(r.ELEMENT_ARRAY_BUFFER,this.ibo),r.bufferData(r.ELEMENT_ARRAY_BUFFER,e,r.STATIC_DRAW),this.indexCount=e.length,this.useIndices=!0),this.unbindVAO(),this}linkAttributes(t){const e=this.gl;this.bindVAO(),e.bindBuffer(e.ARRAY_BUFFER,this.vbo);const r=4*Float32Array.BYTES_PER_ELEMENT,s=this.getPositionLocation(t);s>=0&&(e.enableVertexAttribArray(s),e.vertexAttribPointer(s,2,e.FLOAT,!1,r,0));const n=this.getTexcoordLocation(t);return n>=0&&(e.enableVertexAttribArray(n),e.vertexAttribPointer(n,2,e.FLOAT,!1,r,2*Float32Array.BYTES_PER_ELEMENT)),this.useIndices&&e.bindBuffer(e.ELEMENT_ARRAY_BUFFER,this.ibo),this.unbindVAO(),this}bind(){return this.bindVAO(),this}unbind(){return this.unbindVAO(),this}draw(){const t=this.gl;return this.bindVAO(),this.useIndices?t.drawElements(t.TRIANGLES,this.indexCount,t.UNSIGNED_SHORT,0):t.drawArrays(t.TRIANGLE_STRIP,0,this.vertexCount),this}destroy(){const t=this.gl;this.deleteVAO(),this.vbo&&(t.deleteBuffer(this.vbo),this.vbo=null),this.ibo&&(t.deleteBuffer(this.ibo),this.ibo=null)}getPositionLocation(t){let e=t.getAttribLocation("a_position");return e>=0||(e=t.getAttribLocation("aPosition"),e>=0)||(e=t.getAttribLocation("position"),e>=0)?e:-1}getTexcoordLocation(t){let e=t.getAttribLocation("a_texcoord");return e>=0||(e=t.getAttribLocation("aTexCoord"),e>=0)||(e=t.getAttribLocation("texcoord"),e>=0)||(e=t.getAttribLocation("a_uv"),e>=0)?e:-1}createVAO(){this.isWebGL2?this.vao=this.gl.createVertexArray():this.vaoExt&&(this.vao=this.vaoExt.createVertexArrayOES())}bindVAO(){this.vao&&(this.isWebGL2?this.gl.bindVertexArray(this.vao):this.vaoExt&&this.vaoExt.bindVertexArrayOES(this.vao))}unbindVAO(){this.isWebGL2?this.gl.bindVertexArray(null):this.vaoExt&&this.vaoExt.bindVertexArrayOES(null)}deleteVAO(){this.vao&&(this.isWebGL2?this.gl.deleteVertexArray(this.vao):this.vaoExt&&this.vaoExt.deleteVertexArrayOES(this.vao),this.vao=null)}}class h{constructor(t){i(this,"gl");i(this,"program",null);i(this,"vertexShader",null);i(this,"fragmentShader",null);i(this,"version",1);this.gl=t}static detectVersion(t){return/^\s*#version\s+300\s+es/m.test(t)?2:1}compile(t,e){this.destroy();const r=h.detectVersion(t),s=h.detectVersion(e);if(r!=s)throw new L(r,s);return this.version=Math.max(r,s),this.vertexShader=this.compileShader("vertex",t),this.fragmentShader=this.compileShader("fragment",e),this.linkProgram(),this}use(){return this.program&&this.gl.useProgram(this.program),this}getProgram(){return this.program}getVersion(){return this.version}getAttribLocation(t){return this.program?this.gl.getAttribLocation(this.program,t):-1}getUniformLocation(t){return this.program?this.gl.getUniformLocation(this.program,t):null}destroy(){const t=this.gl;this.program&&(this.vertexShader&&t.detachShader(this.program,this.vertexShader),this.fragmentShader&&t.detachShader(this.program,this.fragmentShader),t.deleteProgram(this.program),this.program=null),this.vertexShader&&(t.deleteShader(this.vertexShader),this.vertexShader=null),this.fragmentShader&&(t.deleteShader(this.fragmentShader),this.fragmentShader=null)}compileShader(t,e){const r=this.gl,s=t==="vertex"?r.VERTEX_SHADER:r.FRAGMENT_SHADER,n=r.createShader(s);if(!n)throw new f(t,e,"Failed to create shader object");if(r.shaderSource(n,e),r.compileShader(n),!r.getShaderParameter(n,r.COMPILE_STATUS)){const c=r.getShaderInfoLog(n)||"Unknown error";throw r.deleteShader(n),new f(t,e,c)}return n}linkProgram(){const t=this.gl;if(!this.vertexShader||!this.fragmentShader)throw new d("Shaders not compiled");const e=t.createProgram();if(!e)throw new d("Failed to create program object");if(t.attachShader(e,this.vertexShader),t.attachShader(e,this.fragmentShader),t.linkProgram(e),!t.getProgramParameter(e,t.LINK_STATUS)){const s=t.getProgramInfoLog(e)||"Unknown error";throw t.deleteProgram(e),new d(s)}this.program=e}}class x{constructor(t,e){i(this,"name");i(this,"method");i(this,"isArray");i(this,"isMatrix");i(this,"location",null);i(this,"locationResolved",!1);i(this,"value");this.name=t,this.value=e;const r=x.inferMethodInfo(e);this.method=r.method,this.isArray=r.isArray,this.isMatrix=r.isMatrix}static inferMethodInfo(t){if(typeof t=="boolean")return{method:"uniform1i",isArray:!1,isMatrix:!1};if(typeof t=="number")return{method:"uniform1f",isArray:!1,isMatrix:!1};if(!Array.isArray(t))return{method:"uniform1f",isArray:!1,isMatrix:!1};const e=t.length,r=t[0];if(Array.isArray(r))switch(r.length){case 2:return{method:"uniform2fv",isArray:!0,isMatrix:!1};case 3:return{method:"uniform3fv",isArray:!0,isMatrix:!1};case 4:return{method:"uniform4fv",isArray:!0,isMatrix:!1};default:return{method:"uniform1fv",isArray:!0,isMatrix:!1}}switch(e){case 2:return{method:"uniform2fv",isArray:!1,isMatrix:!1};case 3:return{method:"uniform3fv",isArray:!1,isMatrix:!1};case 4:return{method:"uniform4fv",isArray:!1,isMatrix:!1};case 9:return{method:"uniformMatrix3fv",isArray:!1,isMatrix:!0};case 16:return{method:"uniformMatrix4fv",isArray:!1,isMatrix:!0};default:return{method:"uniform1fv",isArray:!0,isMatrix:!1}}}resolveLocation(t,e){return this.locationResolved||(this.location=t.getUniformLocation(e,this.name),this.locationResolved=!0),this.location}invalidateLocation(){this.location=null,this.locationResolved=!1}setValue(t){this.value=t}getValue(){return this.value}upload(t,e){const r=this.resolveLocation(t,e);if(r===null)return;const s=this.value;let n;switch(typeof s=="boolean"?n=s?1:0:typeof s=="number"?n=s:this.isArray&&Array.isArray(s[0])?n=new Float32Array(s.flat()):n=new Float32Array(s),this.method){case"uniform1f":t.uniform1f(r,n);break;case"uniform1i":t.uniform1i(r,n);break;case"uniform1fv":t.uniform1fv(r,n);break;case"uniform2fv":t.uniform2fv(r,n);break;case"uniform3fv":t.uniform3fv(r,n);break;case"uniform4fv":t.uniform4fv(r,n);break;case"uniformMatrix2fv":t.uniformMatrix2fv(r,!1,n);break;case"uniformMatrix3fv":t.uniformMatrix3fv(r,!1,n);break;case"uniformMatrix4fv":t.uniformMatrix4fv(r,!1,n);break}}}const m=class m{constructor(t){i(this,"gl");i(this,"program",null);i(this,"uniforms",new Map);this.gl=t}attachProgram(t){this.program=t;for(const e of this.uniforms.values())e.invalidateLocation();return this}set(t,e){const r=this.uniforms.get(t);return r?r.setValue(e):this.uniforms.set(t,new x(t,e)),this}setMany(t){for(const[e,r]of Object.entries(t))this.set(e,r);return this}get(t){var e;return(e=this.uniforms.get(t))==null?void 0:e.getValue()}has(t){return this.uniforms.has(t)}delete(t){return this.uniforms.delete(t)}uploadAll(){if(!this.program)return this;for(const t of this.uniforms.values())t.upload(this.gl,this.program);return this}uploadBuiltIns(t,e,r){if(this.set("u_resolution",e),this.set("u_time",t.time),this.set("u_delta",t.delta),this.set("u_mouse",r),this.set("u_frame",t.frame),!this.program)return this;for(const s of m.BUILT_INS){const n=this.uniforms.get(s);n&&n.upload(this.gl,this.program)}return this}clear(){this.uniforms.clear()}destroy(){this.uniforms.clear(),this.program=null}keys(){return this.uniforms.keys()}get size(){return this.uniforms.size}};i(m,"BUILT_INS",new Set(["u_resolution","u_time","u_delta","u_mouse","u_frame"]));let v=m;class A{constructor(){i(this,"hooks",new Map)}id(){return Math.random().toString(36).substring(2,10)}add(t){const e=this.id();return this.hooks.set(e,t),()=>this.remove(e)}remove(t){this.hooks.delete(t)}run(t){for(const[e,r]of this.hooks)r(t)===!1&&this.remove(e)}destroy(){this.hooks.clear()}}class b{constructor(t,e){i(this,"canvas");i(this,"gl");i(this,"options");i(this,"onBeforeHooks",new A);i(this,"onAfterHooks",new A);i(this,"_program");i(this,"_geometry");i(this,"_uniforms");i(this,"_clock");i(this,"_resolution",[1,1]);i(this,"_mouse",[0,0]);i(this,"_version",1);i(this,"playing",!1);this.canvas=t,this.options=e,this.gl=this.initContext(),this.enableExtensions(),this._program=new h(this.gl),this._geometry=p.fullscreenQuad(this.gl),this._uniforms=new v(this.gl),this._clock=new R,this.options.onBeforeRender&&this.onBeforeHooks.add(this.options.onBeforeRender),this.options.onAfterRender&&this.onAfterHooks.add(this.options.onAfterRender),this.onRender=this.onRender.bind(this)}static setup(t,e){const r=new b(t,e);return e.vertex&&e.fragment&&r.shader(e.vertex,e.fragment),e.uniforms&&r._uniforms.setMany(e.uniforms),r}initContext(){const t={antialias:this.options.antialias,preserveDrawingBuffer:this.options.preserveDrawingBuffer,alpha:!0,depth:!1,stencil:!1},e=this.canvas.getContext("webgl2",t);if(e)return this._version=2,e;const r=this.canvas.getContext("webgl",t);if(r)return this._version=1,r;const s=new S("not_supported");throw this.options.onError(s),s}enableExtensions(){this.gl.getExtension("OES_standard_derivatives"),this.gl.getExtension("OES_texture_float"),this.gl.getExtension("OES_texture_float_linear"),this._version===1&&this.gl.getExtension("OES_vertex_array_object")}viewport(t,e,r,s){return this.canvas.width=r,this.canvas.height=s,this.gl.viewport(t,e,r,s),this._resolution=[r,s],this}clock(t){return this._clock.setTime(t),this}mouse(t,e){return this._mouse=[t,e],this}uniform(t,e){return this._uniforms.set(t,e),this}uniforms(t){return this._uniforms.setMany(t),this}getUniform(t){return this._uniforms.get(t)}shader(t,e){try{this._program.compile(t,e),this._version=this._program.getVersion(),this._geometry.linkAttributes(this._program);const r=this._program.getProgram();r&&this._uniforms.attachProgram(r)}catch(r){r instanceof l&&this.options.onError(r)}return this}play(){return this.playing?this:(this.playing=!0,this._clock.start(this.onRender),this)}pause(){if(!this.playing)return this;const t=this._clock.getState();return this.onBeforeHooks.run(t),this.playing=!1,this._clock.stop(),this.onAfterHooks.run(t),this}render(){return this.onRender(this._clock.getState()),this}getContext(){return this.gl}getVersion(){return this._version}destroy(){this.pause(),this._clock.destroy(),this._geometry.destroy(),this._program.destroy(),this._uniforms.destroy(),this.onAfterHooks.destroy(),this.onBeforeHooks.destroy()}onRender(t){const e=this.gl;this.onBeforeHooks.run(t),e.clearColor(0,0,0,0),e.clear(e.COLOR_BUFFER_BIT),this._program.use(),this._uniforms.uploadBuiltIns(t,this._resolution,this._mouse),this._uniforms.uploadAll(),this._geometry.bind(),this._geometry.draw(),this.onAfterHooks.run(t)}}const g=`#ifdef GL_ES
+${e}`,"PROGRAM_ERROR"),this.infoLog=e}}class Y extends h{constructor(e){super(`Error in onLoad callback: ${e}`,"UNKNOWN_ERROR")}}class K extends h{constructor(e,n){super(`Error in onBefore/onAfter hook callback with ID ${e}: ${n}`,"UNKNOWN_ERROR")}}class oe{constructor(){a(this,"time",0);a(this,"delta",0);a(this,"frame",0);a(this,"running",!1);a(this,"fps",0);a(this,"startTime",0);a(this,"lastTime",0);a(this,"rafId",null);a(this,"callback",null);a(this,"maxFps",0);this.loop=this.loop.bind(this)}start(e){if(this.running)return this;this.callback=e,this.running=!0;const n=performance.now();return this.frame===0?this.startTime=n:this.startTime=n-this.time*1e3,this.lastTime=n,this.rafId=requestAnimationFrame(this.loop),this}stop(){return this.running?(this.running=!1,this.rafId!==null&&(cancelAnimationFrame(this.rafId),this.rafId=null),this):this}reset(){return this.stop(),this.time=0,this.delta=0,this.frame=0,this.fps=0,this}getState(){return{time:this.time,delta:this.delta,frame:this.frame,running:this.running,fps:Math.round(this.fps)}}tick(e=0){return this.delta=e,this.time+=e,this.frame++,this.callback&&this.callback(this.getState()),this}setTime(e){return this.time=e,this}destroy(){this.reset(),this.callback=null}setMaxFps(e){return this.maxFps=e,this}loop(e){if(!this.running)return;if(this.maxFps>0){const t=1e3/this.maxFps;if(e-this.lastTime<t){this.rafId=requestAnimationFrame(this.loop);return}}this.delta=(e-this.lastTime)/1e3,this.lastTime=e;const n=this.delta>0?1/this.delta:0;this.fps=this.fps*.95+n*.05,this.time=(e-this.startTime)/1e3,this.frame++,this.callback&&this.callback(this.getState()),this.rafId=requestAnimationFrame(this.loop)}}class k{constructor(e){a(this,"gl");a(this,"vao",null);a(this,"vbo",null);a(this,"ibo",null);a(this,"vertexCount",0);a(this,"indexCount",0);a(this,"useIndices",!1);a(this,"vaoExt",null);a(this,"isWebGL2");this.gl=e,this.isWebGL2=e instanceof WebGL2RenderingContext,this.isWebGL2||(this.vaoExt=e.getExtension("OES_vertex_array_object"))}static fullscreenQuad(e){const n=new k(e),t=new Float32Array([-1,-1,0,0,1,-1,1,0,-1,1,0,1,1,1,1,1]),i=new Uint16Array([0,1,2,2,1,3]);return n.setup(t,i),n}setup(e,n){const t=this.gl;return this.createVAO(),this.bindVAO(),this.vbo=t.createBuffer(),t.bindBuffer(t.ARRAY_BUFFER,this.vbo),t.bufferData(t.ARRAY_BUFFER,e,t.STATIC_DRAW),this.vertexCount=e.length/4,n&&(this.ibo=t.createBuffer(),t.bindBuffer(t.ELEMENT_ARRAY_BUFFER,this.ibo),t.bufferData(t.ELEMENT_ARRAY_BUFFER,n,t.STATIC_DRAW),this.indexCount=n.length,this.useIndices=!0),this.unbindVAO(),this}linkAttributes(e){const n=this.gl;this.bindVAO(),n.bindBuffer(n.ARRAY_BUFFER,this.vbo);const t=4*Float32Array.BYTES_PER_ELEMENT,i=this.getPositionLocation(e);i>=0&&(n.enableVertexAttribArray(i),n.vertexAttribPointer(i,2,n.FLOAT,!1,t,0));const r=this.getTexcoordLocation(e);return r>=0&&(n.enableVertexAttribArray(r),n.vertexAttribPointer(r,2,n.FLOAT,!1,t,2*Float32Array.BYTES_PER_ELEMENT)),this.useIndices&&n.bindBuffer(n.ELEMENT_ARRAY_BUFFER,this.ibo),this.unbindVAO(),this}bind(){return this.bindVAO(),this}unbind(){return this.unbindVAO(),this}draw(){const e=this.gl;return this.bindVAO(),this.useIndices?e.drawElements(e.TRIANGLES,this.indexCount,e.UNSIGNED_SHORT,0):e.drawArrays(e.TRIANGLE_STRIP,0,this.vertexCount),this}destroy(){const e=this.gl;this.deleteVAO(),this.vbo&&(e.deleteBuffer(this.vbo),this.vbo=null),this.ibo&&(e.deleteBuffer(this.ibo),this.ibo=null)}getPositionLocation(e){let n=e.getAttribLocation("a_position");return n>=0||(n=e.getAttribLocation("aPosition"),n>=0)||(n=e.getAttribLocation("position"),n>=0)?n:-1}getTexcoordLocation(e){let n=e.getAttribLocation("a_texcoord");return n>=0||(n=e.getAttribLocation("aTexCoord"),n>=0)||(n=e.getAttribLocation("texcoord"),n>=0)||(n=e.getAttribLocation("a_uv"),n>=0)?n:-1}createVAO(){this.isWebGL2?this.vao=this.gl.createVertexArray():this.vaoExt&&(this.vao=this.vaoExt.createVertexArrayOES())}bindVAO(){this.vao&&(this.isWebGL2?this.gl.bindVertexArray(this.vao):this.vaoExt&&this.vaoExt.bindVertexArrayOES(this.vao))}unbindVAO(){this.isWebGL2?this.gl.bindVertexArray(null):this.vaoExt&&this.vaoExt.bindVertexArrayOES(null)}deleteVAO(){this.vao&&(this.isWebGL2?this.gl.deleteVertexArray(this.vao):this.vaoExt&&this.vaoExt.deleteVertexArrayOES(this.vao),this.vao=null)}}class se{constructor(e){a(this,"gl");a(this,"program",null);a(this,"vertexShader",null);a(this,"fragmentShader",null);this.gl=e}compile(e,n){return this.destroy(),this.vertexShader=this.compileShader("vertex",e),this.fragmentShader=this.compileShader("fragment",n),this.linkProgram(),this}use(){return this.program&&this.gl.useProgram(this.program),this}getProgram(){return this.program}getAttribLocation(e){return this.program?this.gl.getAttribLocation(this.program,e):-1}getUniformLocation(e){return this.program?this.gl.getUniformLocation(this.program,e):null}destroy(){const e=this.gl;this.program&&(this.vertexShader&&e.detachShader(this.program,this.vertexShader),this.fragmentShader&&e.detachShader(this.program,this.fragmentShader),e.deleteProgram(this.program),this.program=null),this.vertexShader&&(e.deleteShader(this.vertexShader),this.vertexShader=null),this.fragmentShader&&(e.deleteShader(this.fragmentShader),this.fragmentShader=null)}compileShader(e,n){const t=this.gl,i=e==="vertex"?t.VERTEX_SHADER:t.FRAGMENT_SHADER,r=t.createShader(i);if(!r)throw new w(e,n,"Failed to create shader object");if(t.shaderSource(r,n),t.compileShader(r),!t.getShaderParameter(r,t.COMPILE_STATUS)){const s=t.getShaderInfoLog(r)||"Unknown error";throw t.deleteShader(r),new w(e,n,s)}return r}linkProgram(){const e=this.gl;if(!this.vertexShader||!this.fragmentShader)throw new E("Shaders not compiled");const n=e.createProgram();if(!n)throw new E("Failed to create program object");if(e.attachShader(n,this.vertexShader),e.attachShader(n,this.fragmentShader),e.linkProgram(n),!e.getProgramParameter(n,e.LINK_STATUS)){const i=e.getProgramInfoLog(n)||"Unknown error";throw e.deleteProgram(n),new E(i)}this.program=n}}class M{constructor(e,n){a(this,"name");a(this,"method");a(this,"isArray");a(this,"isMatrix");a(this,"location",null);a(this,"locationResolved",!1);a(this,"value");this.name=e,this.value=n;const t=M.inferMethodInfo(n);this.method=t.method,this.isArray=t.isArray,this.isMatrix=t.isMatrix}static inferMethodInfo(e){if(typeof e=="boolean")return{method:"uniform1i",isArray:!1,isMatrix:!1};if(typeof e=="number")return{method:"uniform1f",isArray:!1,isMatrix:!1};if(!Array.isArray(e))return{method:"uniform1f",isArray:!1,isMatrix:!1};const n=e.length,t=e[0];if(Array.isArray(t))switch(t.length){case 2:return{method:"uniform2fv",isArray:!0,isMatrix:!1};case 3:return{method:"uniform3fv",isArray:!0,isMatrix:!1};case 4:return{method:"uniform4fv",isArray:!0,isMatrix:!1};default:return{method:"uniform1fv",isArray:!0,isMatrix:!1}}switch(n){case 2:return{method:"uniform2fv",isArray:!1,isMatrix:!1};case 3:return{method:"uniform3fv",isArray:!1,isMatrix:!1};case 4:return{method:"uniform4fv",isArray:!1,isMatrix:!1};case 9:return{method:"uniformMatrix3fv",isArray:!1,isMatrix:!0};case 16:return{method:"uniformMatrix4fv",isArray:!1,isMatrix:!0};default:return{method:"uniform1fv",isArray:!0,isMatrix:!1}}}resolveLocation(e,n){return this.locationResolved||(this.location=e.getUniformLocation(n,this.name),this.locationResolved=!0),this.location}invalidateLocation(){this.location=null,this.locationResolved=!1}setValue(e){this.value=e}getValue(){return this.value}upload(e,n){const t=this.resolveLocation(e,n);if(t===null)return;const i=this.value;let r;switch(typeof i=="boolean"?r=i?1:0:typeof i=="number"?r=i:this.isArray&&Array.isArray(i[0])?r=new Float32Array(i.flat()):r=new Float32Array(i),this.method){case"uniform1f":e.uniform1f(t,r);break;case"uniform1i":e.uniform1i(t,r);break;case"uniform1fv":e.uniform1fv(t,r);break;case"uniform2fv":e.uniform2fv(t,r);break;case"uniform3fv":e.uniform3fv(t,r);break;case"uniform4fv":e.uniform4fv(t,r);break;case"uniformMatrix2fv":e.uniformMatrix2fv(t,!1,r);break;case"uniformMatrix3fv":e.uniformMatrix3fv(t,!1,r);break;case"uniformMatrix4fv":e.uniformMatrix4fv(t,!1,r);break}}}class _{constructor(e){a(this,"parsed",null);this.source=e}parse(){if(this.parsed)return this.parsed;const e=this.detectVersion(),n=this.detectImports(),t=this.detectUniforms(),i=this.detectFunctions(t);return this.parsed={version:e,imports:n,uniforms:t,functions:i}}isParsed(){return this.parsed!==null}setSource(e){this.source=e,this.parsed=null}version(){return this.detectVersion()}detectVersion(){return/^\s*#version\s+300\s+es/m.test(this.source)?2:1}detectImports(){const e=/^[ \t]*#import\s+(\w+)(?:\s+as\s+(\w+))?\s+from\s+["'](.+)["']/gm,n=/^[ \t]*[^\w\s]?import\b/gm,t=[],i=new Set;let r,o=1,s=0;for(;(r=e.exec(this.source))!==null;){o+=(this.source.substring(s,r.index).match(/\n/g)||[]).length,s=r.index,i.add(o);const f=r[1],c=r[2]||r[1],d=r[3];if(t.some(p=>p.alias===c))throw new P(c,o);t.push({name:f,alias:c,module:d,line:o})}let l;for(;(l=n.exec(this.source))!==null;){const f=(this.source.substring(0,l.index).match(/\n/g)||[]).length+1;if(i.has(f))continue;const c=this.source.split(`
+`)[f-1].trim();throw new I(f,this.diagnoseImport(c))}return t}diagnoseImport(e){const n=e.match(/^([^\w\s])import\b/);if(n&&n[1]!=="#")return`Invalid prefix '${n[1]}'. Expected: #import <function> from '<module>'`;if(/^import\b/.test(e))return"Missing '#' prefix. Expected: #import <function> from '<module>'";if(/^#import\s+from\b/.test(e))return"Missing function name. Expected: #import <function> from '<module>'";if(/^#import\s+\w+\s*$/.test(e))return`Missing 'from' clause. Expected: #import ${e.split(/\s+/)[1]} from '<module>'`;if(/^#import\s+\w+\s+as\s*$/.test(e)||/^#import\s+\w+\s+as\s+from\b/.test(e))return`Missing alias name after 'as'. Expected: #import ${e.split(/\s+/)[1]} as <alias> from '<module>'`;if(/^#import\s+\w+\s+as\s+\w+\s*$/.test(e)){const t=e.split(/\s+/);return`Missing 'from' clause. Expected: #import ${t[1]} as ${t[3]} from '<module>'`}if(/^#import\s+\w+(?:\s+as\s+\w+)?\s+from\s+\w+/.test(e)){const t=e.match(/from\s+(\S+)/);return`Module name must be quoted. Expected: from '${t==null?void 0:t[1]}'`}return"Invalid syntax. Expected: #import <function> from '<module>'"}detectUniforms(){const e=/^[ \t]*uniform\s+(?:(?:highp|mediump|lowp)\s+)?(\w+)\s+(\w+)(?:\[(\d+)\])?\s*;/gm,n=[];let t,i=1,r=0;for(;(t=e.exec(this.source))!==null;){i+=(this.source.substring(r,t.index).match(/\n/g)||[]).length,r=t.index;const o=t[1],s=t[2],l=t[3]?parseInt(t[3],10):void 0;n.push({name:s,type:o,line:i,arrayNum:l})}return n}detectFunctions(e){const n=[],t="void|float|int|uint|bool|vec[234]|ivec[234]|uvec[234]|bvec[234]|mat[234](?:x[234])?|sampler2D|samplerCube|sampler3D|sampler2DArray",i=new RegExp(`^[ \\t]*(${t})\\s+(\\w+)\\s*\\(([^)]*)\\)\\s*\\{`,"gm");let r;for(;(r=i.exec(this.source))!==null;){const o=r[1],s=r[2],l=r[3].trim(),f=r.index,c=(this.source.substring(0,f).match(/\n/g)||[]).length+1,d=this.source.indexOf("{",f),p=this.findClosingBrace(this.source,d);if(p===-1)continue;const g=this.source.slice(d,p+1),J=this.parseParams(l),Z=this.findFunctionCalls(g),ee=this.findUniformCalls(g,e),ne=this.findMentionCalls(g);n.push({name:s,type:o,params:J,body:g,dependencies:[...Z,...ee,...ne],line:c})}return n}parseParams(e){if(!e.trim())return[];const n=[],t=e.split(",");for(const i of t){const r=i.trim();if(!r)continue;const s=r.replace(/\b(in|out|inout|const|highp|mediump|lowp)\b\s*/g,"").trim().match(/^(\w+)\s+(\w+)(?:\[\d*\])?$/);s&&n.push({type:s[1],name:s[2]})}return n}findClosingBrace(e,n){let t=0,i=!1,r=!1,o=!1,s=!1;for(let l=n;l<e.length;l++){const f=e[l],c=e[l+1],d=e[l-1];if(!r&&!s&&f==="/"&&c==="/"){o=!0;continue}if(o&&f===`
+`){o=!1;continue}if(!r&&!o&&f==="/"&&c==="*"){s=!0,l++;continue}if(s&&f==="*"&&c==="/"){s=!1,l++;continue}if(!(o||s)){if(f==='"'&&d!=="\\"){r=!r;continue}if(!r){if(f==="{")t++,i=!0;else if(f==="}"&&(t--,i&&t===0))return l}}}return-1}findFunctionCalls(e){const n=[],t=new Set(["if","else","for","while","do","switch","case","return","break","continue","discard"]),i=/\b([a-zA-Z_]\w*)\s*\(/g;let r;for(;(r=i.exec(e))!==null;){const o=r[1];t.has(o)||n.push({name:o,type:"function",index:r.index})}return n}findUniformCalls(e,n){const t=[];for(const i of n){const r=new RegExp(`\\b${i.name}\\b`,"g");let o;for(;(o=r.exec(e))!==null;)t.push({name:i.name,type:"uniform",index:o.index})}return t}findMentionCalls(e){const n=[],t=/@(\w+)\.([a-zA-Z_]\w*)/g;let i;for(;(i=t.exec(e))!==null;){const r=i[1],o=i[2];n.push({name:`${r}.${o}`,type:"mention",index:i.index})}return n}}class X{constructor(e){a(this,"isCompiled",!1);a(this,"original");a(this,"compiled");a(this,"requirements",{uniforms:new Map,functions:new Map});this.original=new _(e),this.compiled=new _(e)}version(){return this.original.version()}source(){return this.original.source}recompile(){return this.isCompiled=!1,this.compile()}compile(){return this.isCompiled?this.compiled.source:(this.original.parse().imports.length>0&&this.processImports(),this.compiled.setSource(this.build()),this.isCompiled=!0,this.compiled.source)}processImports(){const e=this.original.parse(),n=e.functions.flatMap(t=>t.dependencies.filter(i=>i.type==="mention").map(i=>({name:i.name.split(".")[0],uniform:i.name.split(".")[1]})));for(const t of e.imports){const i=b.resolve(t.module),r=i.extract(t.name);let o=n.filter(l=>l.name===r.function.name);if(o.length>0){const l=i.getDefinition().uniforms;if(o=o.filter(f=>{const c=l.find(d=>d.name===`u_${f.uniform}`||d.name===f.uniform);if(c){r.dependencies.uniforms.some(p=>p.name===c.name)||r.dependencies.uniforms.push(c);const d=n.indexOf(f);return d>-1&&n.splice(d,1),!1}return!0}),o.length>0)throw new q(t.module,r.function.name,o[0].uniform)}const s=i.copy();this.processExtraction(r,t.alias,s.options),y.merge(t.module,s)}if(n.length>0)throw new H(n[0].name,n[0].uniform)}processExtraction(e,n,t={}){const i=e.function,r=Math.random().toString(36).substring(2,8),o=`${n}_${r}`;for(let l=e.dependencies.functions.length-1;l>=0;l--){const f=e.dependencies.functions[l],c=this.rewriteFunction(f,n,{uniforms:e.dependencies.uniforms,functions:e.dependencies.functions,unique:o});this.requirements.functions.set(c.name,c)}const s=this.rewriteFunction(i,n,{uniforms:e.dependencies.uniforms,functions:e.dependencies.functions,rename:!0,unique:o});this.requirements.functions.set(s.name,s);for(const l of e.dependencies.uniforms){if(S.has(l.name))continue;const f={...l,name:`${o}_${l.name}${l.arrayNum?`[${l.arrayNum}]`:""}`};if(t[i.name]){const c=Object.entries(t[i.name]).find(([d,p])=>p.uniform===l.name);c&&(c[1].uniform=`${o}_${l.name}`)}this.requirements.uniforms.set(f.name,f)}t[i.name]&&n!==i.name&&(t[n]=t[i.name],delete t[i.name])}rewriteFunction(e,n,t={rename:!1,uniforms:[],functions:[],unique:""}){const i=new Set(t.uniforms.map(c=>c.name)),r=new Set(t.functions.map(c=>c.name)),o=[],s=t.unique?t.unique:n;for(const c of e.dependencies)if(c.index!==void 0)if(c.type==="uniform"&&i.has(c.name)){if(S.has(c.name))continue;o.push({index:c.index,oldText:c.name,newText:`${s}_${c.name}`})}else c.type==="function"&&r.has(c.name)&&o.push({index:c.index,oldText:c.name,newText:`${s}_${c.name}`});const l=this.applyRewrites(e.body,o),f=t.rename?n:`${s}_${e.name}`;return{...e,name:f,body:l}}applyRewrites(e,n){const t=[...n].sort((r,o)=>o.index-r.index);let i=e;for(const r of t)i=i.slice(0,r.index)+r.newText+i.slice(r.index+r.oldText.length);return i}build(){const e=this.original.parse();let n=this.original.source;n=this.removeImportLines(n,e);const t=this.findInsertionPointForUniforms(n),i=this.generateUniformsCode();i&&(n=n.slice(0,t)+i+`
+`+n.slice(t));const r=this.findInsertionPointForFunctions(n),o=this.generateFunctionCode();return o&&(n=n.slice(0,r)+o+n.slice(r)),n=n.replace(/\n{3,}/g,`
+
+`),n=this.replaceMentions(n,e),n}replaceMentions(e,n){let t=e;const i=n.functions.filter(r=>r.dependencies.some(o=>o.type==="mention"));for(const r of i){const o=r.dependencies.filter(s=>s.type==="mention");for(const s of o){const l=s.name.split("."),f=new RegExp(`\\b${l[0]}_(\\w+)_${l[1]}\\b`,"g"),c=this.requirements.uniforms.keys().find(p=>{var g;return((g=p.match(f))==null?void 0:g[0])===p});if(!c)throw new j(s.name,r.name);const d=new RegExp(`@\\b${s.name}\\b`,"g");t=t.replace(d,c)}}return t}removeImportLines(e,n){const t=e.split(`
+`),i=new Set(n.imports.map(r=>r.line));return t.filter((r,o)=>{const s=i.has(o+1);if(!s&&r.trim()===""&&o>0){const l=o-1;if(i.has(l+1))return!1}return!s}).join(`
+`)}findInsertionPointForUniforms(e){const n=new _(e).parse(),t=n.uniforms.find(s=>s.line===Math.max(...n.uniforms.map(l=>l.line??0))),i=e.split(`
+`);let r=0;if(t&&t.line)r=t.line;else for(let s=0;s<i.length;s++){const l=i[s].trim();if(l.startsWith("#version")){r=s+1;continue}if(l.startsWith("precision ")){r=s+1;continue}if(l===""||l.startsWith("//")){r===s&&(r=s+1);continue}break}let o=0;for(let s=0;s<r;s++)o+=i[s].length+1;return o}findInsertionPointForFunctions(e){const n=new _(e).parse(),t=n.functions.find(s=>s.line===Math.min(...n.functions.map(l=>l.line??1/0))),i=e.split(`
+`);let r=0;if(t&&t.line)r=t.line-2;else throw new T;let o=0;for(let s=0;s<r;s++)o+=i[s].length+1;return o}generateUniformsCode(){const e=[];if(this.requirements.uniforms.size>0)for(const n of this.checkUniformsPresence())e.push(`uniform ${n.type} ${n.name};`);return e.length===0?"":e.join(`
+`)+`
+`}generateFunctionCode(){const e=[];if(this.requirements.functions.size>0)for(const n of this.checkFunctionsPresence()){const t=n.params.map(i=>`${i.type} ${i.name}`).join(", ");e.push(`
+${n.type} ${n.name}(${t}) ${n.body}`)}return e.length===0?"":e.join(`
+`)+`
+`}checkUniformsPresence(){const e=this.original.parse(),n=[],t=this.requirements.uniforms;for(const[i,r]of t){const o=e.uniforms.find(s=>s.name===i);if(!o){n.push(r);continue}if(o.type!==r.type)throw new A("uniform",i,r.type,o.type)}return n}checkFunctionsPresence(){const e=this.original.parse(),n=[],t=this.requirements.functions;for(const[i,r]of t){const o=e.functions.find(s=>s.name===i);if(!o){n.push(r);continue}if(o.type!==r.type)throw new A("function",i,r.type,o.type)}return n}}class v extends X{constructor(n,t,i={}){super(t);a(this,"name");a(this,"options",{});this.name=n,this.options=this.resolveOptions(i)}resolveOptions(n){if(!(n!=null&&n.default))return n||{};const t=this.original.parse(),i=n.default;for(const r of t.functions)if(!(r.name==="main"||r.name==="default"))if(n[r.name]){const o=n[r.name];for(const s in i)s in o||(o[s]=i[s])}else n[r.name]={...i};return delete n.default,n||{}}static define(n){const{name:t,source:i,options:r}=n;if(t==="sandbox"||t.startsWith("sandbox/"))throw new G(t);const o=new v(t,i,r);if(b.has(t))throw new W(t);return b.register(t,o),o}static resolve(n){return b.resolve(n)}copy(n="original"){return new v(this.name,this[n].source,JSON.parse(JSON.stringify(this.options)))}merge(n){this.options=this.options||{};const t=this.getDefinition().uniforms.map(i=>i.name);for(const[i,r]of Object.entries(n.options??{}))if(!this.options[i])this.options[i]=r;else for(const[o,s]of Object.entries(r))t.includes(s.uniform)||(this.options[i][o]=s)}getDefinition(){return this.compile(),{name:this.name,methods:this.compiled.parse().functions.map(n=>n.name).filter(n=>n!=="main"&&n!=="default"),uniforms:this.compiled.parse().uniforms.map(n=>({name:n.name,type:n.type})),options:this.options}}extract(n){if(this.compile(),n==="main")throw new N(this.name);if(n==="default")throw new z(this.name);const t=this.compiled.parse(),i=t.functions.find(s=>s.name===n);if(!i)throw new D(this.name,n);const r=new Map,o=new Map;return this.collectDependencies({current:i,scope:{functions:t.functions,uniforms:t.uniforms},collected:{functions:r,uniforms:o},visited:new Set([n])}),{function:i,dependencies:{functions:Array.from(r.values()),uniforms:Array.from(o.values())}}}collectDependencies(n){for(const t of n.current.dependencies)if(t.type==="function"){if(n.visited.has(t.name))continue;const i=n.scope.functions.find(r=>r.name===t.name);i&&(n.visited.add(t.name),n.collected.functions.set(t.name,i),this.collectDependencies({current:i,scope:{functions:n.scope.functions,uniforms:n.scope.uniforms},collected:{functions:n.collected.functions,uniforms:n.collected.uniforms},visited:n.visited}))}else if(t.type==="uniform"){const i=n.scope.uniforms.find(r=>r.name===t.name);i&&!n.collected.uniforms.has(t.name)&&n.collected.uniforms.set(t.name,i)}}}class Q{constructor(e=[]){a(this,"modules",new Map);e.forEach(n=>{this.register(n.name,n)})}compile(){this.modules.forEach(e=>{e.compile()})}available(){return Array.from(this.modules.values()).map(e=>e.getDefinition())}defaults(){const e={};return this.modules.forEach(n=>{const t=n.getDefinition();if(t.options)for(const i in t.options){const r=t.options[i];for(const o in r){const s=r[o];s.default!==void 0&&!t.uniforms.map(l=>l.name).includes(s.uniform)&&(e[s.uniform]=s.default)}}}),e}resolveOptions(e){for(const n of this.modules.values())if(n.options&&n.options[e])return n.options[e];return null}register(e,n){this.modules.set(e,n)}merge(e,n){if(!this.modules.has(e))return this.register(e,n);const t=this.modules.get(e);t.merge(n),this.modules.set(e,t)}resolve(e){const n=this.modules.get(e);if(!n)throw new B(e);return n}has(e){return this.modules.has(e)}isEmpty(){return this.modules.size===0}remove(e){this.modules.delete(e)}load(e){e.forEach(n=>{this.register(n.name,n)})}clear(){this.modules.clear()}}const ae=`// ─── Constants ──────────────────────────────────────────────
+
+const float PI = 3.14159265359;
+const float TAU = 6.28318530718;
+
+// ─── UV Transforms ──────────────────────────────────────────
+
+/**
+ * Center UV coordinates — remap to range where (0,0) is canvas center.
+ * Aspect-ratio corrected using resolution length.
+ * @uv-modifier
+ */
+vec2 center(vec2 uv) {
+    return (uv - 0.5 * u_resolution) / length(u_resolution);
+}
+
+/**
+ * Translate UV coordinates by offset.
+ * @uv-modifier
+ */
+vec2 translate(vec2 uv, vec2 offset) {
+    return uv - offset;
+}
+
+/**
+ * Scale UV coordinates by factor around origin.
+ * @uv-modifier
+ */
+vec2 scale(vec2 uv, float factor) {
+    return uv * factor;
+}
+
+/**
+ * Zoom — scale UV with aspect ratio correction.
+ * Expects centered UV (use center() first).
+ * Pushes UV outward/inward from origin.
+ * factor = zoom factor (>1 = zoom in, <1 = zoom out)
+ * @uv-modifier
+ */
+vec2 zoom(vec2 uv, float factor) {
+    return uv / max(factor, 0.001);
+}
+
+/**
+ * Normalize UV to range -1 to 1 with aspect ratio correction.
+ * @uv-modifier
+ */
+vec2 norm(vec2 uv) {
+    uv *= min(u_resolution.x, u_resolution.y) / length(u_resolution);
+    return uv;
+}
+
+/**
+ * Rotate UV coordinates around origin by angle (radians).
+ * @uv-modifier
+ */
+vec2 rotate(vec2 uv, float angle) {
+    float c = cos(angle);
+    float s = sin(angle);
+    return vec2(uv.x * c - uv.y * s, uv.x * s + uv.y * c);
+}
+
+/**
+ * Tile — repeat coordinates in a grid of given size.
+ * @uv-modifier
+ */
+vec2 tile(vec2 uv, float size) {
+    return fract(uv / size) * size;
+}
+
+/**
+ * Cartesian to polar coordinates.
+ * Returns vec2(angle, radius) where angle is -PI to PI.
+ */
+vec2 polar(vec2 uv) {
+    return vec2(atan(uv.y, uv.x), length(uv));
+}
+
+/**
+ * Aspect ratio correction — makes UV square regardless of canvas shape.
+ * @uv-modifier
+ */
+vec2 aspect(vec2 uv) {
+    return uv * vec2(u_resolution.x / u_resolution.y, 1.0);
+}
+
+// ─── Math Utilities ─────────────────────────────────────────
+
+/**
+ * Remap a value from one range to another.
+ * map(0.5, 0.0, 1.0, -1.0, 1.0) → 0.0
+ */
+float map(float value, float inMin, float inMax, float outMin, float outMax) {
+    return outMin + (value - inMin) * (outMax - outMin) / (inMax - inMin);
+}
+
+// ─── Noise & Random ─────────────────────────────────────────
+
+/**
+ * Pseudo-random hash from 2D coordinates.
+ * Returns float in 0–1 range.
+ */
+float hash(vec2 p) {
+    return fract(sin(dot(p, vec2(127.1, 311.7))) * 43758.5453123);
+}
+
+/**
+ * 2D pseudo-random hash.
+ * Returns vec2 in 0–1 range — used for point scattering (worley etc).
+ */
+vec2 hash2(vec2 p) {
+    p = vec2(dot(p, vec2(127.1, 311.7)), dot(p, vec2(269.5, 183.3)));
+    return fract(sin(p) * 43758.5453123);
+}
+
+/**
+ * Smooth value noise — interpolated hash grid.
+ */
+float noise(vec2 p) {
+    vec2 i = floor(p);
+    vec2 f = fract(p);
+    vec2 u = f * f * (3.0 - 2.0 * f);
+
+    return mix(
+        mix(hash(i), hash(i + vec2(1.0, 0.0)), u.x),
+        mix(hash(i + vec2(0.0, 1.0)), hash(i + vec2(1.0, 1.0)), u.x),
+        u.y
+    );
+}
+
+/**
+ * Fractal Brownian Motion — 6 octaves of layered noise.
+ * Returns ~0–1 range. Great for clouds, terrain, organic textures.
+ */
+float fbm(vec2 p) {
+    float value = 0.0;
+    float amplitude = 0.5;
+
+    for (int i = 0; i < 6; i++) {
+        value += amplitude * noise(p);
+        p *= 2.0;
+        amplitude *= 0.5;
+    }
+
+    return value;
+}
+
+/**
+ * Worley (cellular / voronoi) noise.
+ * Returns distance to nearest random cell point.
+ * Great for cells, cracks, organic patterns.
+ */
+float worley(vec2 p) {
+    vec2 i = floor(p);
+    vec2 f = fract(p);
+    float minDist = 1.0;
+
+    for (int y = -1; y <= 1; y++) {
+        for (int x = -1; x <= 1; x++) {
+            vec2 neighbor = vec2(float(x), float(y));
+            vec2 point = hash2(i + neighbor);
+            float dist = length(neighbor + point - f);
+            minDist = min(minDist, dist);
+        }
+    }
+
+    return minDist;
+}
+
+/**
+ * Waves — layered sine wave interference pattern.
+ * Creates clean, regular wave lines like fabric or moiré.
+ * frequency = wave density (5.0 = fabric, 10.0 = fine lines)
+ * Returns 0–1 range.
+ */
+float waves(vec2 p, float frequency) {
+    return 0.6 + 0.4 * sin(
+        frequency * (p.x + p.y + cos(3.0 * p.x + 5.0 * p.y)) +
+        sin(frequency * 4.0 * (p.x + p.y))
+    );
+}
+
+/**
+ * Voronoi cell lookup — returns the position of the nearest cell point.
+ * Same algorithm as worley, but returns the point instead of distance.
+ * Great for UV snapping, cell-based effects.
+ */
+vec2 voronoi(vec2 p) {
+    vec2 i = floor(p);
+    vec2 f = fract(p);
+    float minDist = 10.0;
+    vec2 nearest = vec2(0.0);
+
+    for (int y = -1; y <= 1; y++) {
+        for (int x = -1; x <= 1; x++) {
+            vec2 neighbor = vec2(float(x), float(y));
+            vec2 point = hash2(i + neighbor);
+            float dist = length(neighbor + point - f);
+            if (dist < minDist) {
+                minDist = dist;
+                nearest = i + neighbor + point;
+            }
+        }
+    }
+
+    return nearest;
+}
+
+void main() {}
+`,le=`/**
+ * Hex integer to RGB.
+ * Usage: hex(0xFF6600) → orange
+ */
+vec3 hex(int value) {
+    float v = float(value);
+    float r = floor(v / 65536.0);
+    float g = floor((v - r * 65536.0) / 256.0);
+    float b = v - r * 65536.0 - g * 256.0;
+    return vec3(r, g, b) / 255.0;
+}
+
+/**
+ * RGB 0–255 to normalized RGB 0–1.
+ * Usage: rgb255(255.0, 128.0, 0.0) → orange
+ */
+vec3 rgb255(float r, float g, float b) {
+    return vec3(r, g, b) / 255.0;
+}
+
+/**
+ * HSV to RGB.
+ * Input: vec3(hue 0–1, saturation 0–1, value 0–1)
+ */
+vec3 hsv(vec3 c) {
+    vec4 K = vec4(1.0, 2.0 / 3.0, 1.0 / 3.0, 3.0);
+    vec3 p = abs(fract(c.xxx + K.xyz) * 6.0 - K.www);
+    return c.z * mix(K.xxx, clamp(p - K.xxx, 0.0, 1.0), c.y);
+}
+
+/**
+ * HSL to RGB.
+ * Input: vec3(hue 0–1, saturation 0–1, lightness 0–1)
+ */
+vec3 hsl(vec3 c) {
+    vec3 rgb = clamp(abs(mod(c.x * 6.0 + vec3(0.0, 4.0, 2.0), 6.0) - 3.0) - 1.0, 0.0, 1.0);
+    return c.z + c.y * (rgb - 0.5) * (1.0 - abs(2.0 * c.z - 1.0));
+}
+
+/**
+ * Linear gradient between two colors.
+ * t is clamped to 0–1.
+ */
+vec3 gradient(vec3 a, vec3 b, float t) {
+    return mix(a, b, clamp(t, 0.0, 1.0));
+}
+
+/**
+ * 3-stop gradient.
+ * t=0 → a, t=0.5 → b, t=1 → c
+ */
+vec3 gradient3(vec3 a, vec3 b, vec3 c, float t) {
+    t = clamp(t, 0.0, 1.0);
+    return t < 0.5
+        ? mix(a, b, t * 2.0)
+        : mix(b, c, (t - 0.5) * 2.0);
+}
+
+/**
+ * Cosine palette — Inigo Quilez formula.
+ * color = a + b * cos(2π(c·t + d))
+ * Generates infinite smooth color ramps from 4 vec3 params.
+ */
+vec3 palette(vec3 a, vec3 b, vec3 c, vec3 d, float t) {
+    return a + b * cos(6.28318 * (c * t + d));
+}
+
+/**
+ * Banded gradient — 3-zone color mapping with sharp transitions.
+ * Uses tent functions instead of linear interpolation.
+ * t=0 → b (center), t=1 → a (middle), t=2 → c (outer).
+ * sharpness = transition width (2.0 = sharp, 1.0 = soft).
+ */
+vec3 bands(vec3 a, vec3 b, vec3 c, float t, float sharpness) {
+    float w1 = max(0.0, 1.0 - sharpness * abs(1.0 - t));
+    float w2 = max(0.0, 1.0 - sharpness * abs(t));
+    float w3 = 1.0 - min(1.0, w1 + w2);
+    return a * w1 + b * w2 + c * w3;
+}
+
+/**
+ * Iridescent — iterative interference color pattern.
+ * Generates rainbow-like colors from UV through trigonometric iteration.
+ * Creates shimmering, oil-slick-like color fields.
+ * time = animation time (pass u_time), speed = animation speed
+ */
+vec3 iridescent(vec2 uv, float time, float speed) {
+    float d = -time * 0.5 * speed;
+    float a = 0.0;
+    for (int i = 0; i < 8; i++) {
+        a += cos(float(i) - d - a * uv.x);
+        d += sin(uv.y * float(i) + a);
+    }
+    d += time * 0.5 * speed;
+    vec3 col = vec3(cos(uv * vec2(d, a)) * 0.6 + 0.4, cos(a + d) * 0.5 + 0.5);
+    return cos(col * cos(vec3(d, a, 2.5)) * 0.5 + 0.5);
+}
+
+void main() {}
+`,ce=`// ─── Time Shapers ──────────────────────────────────────────
+// Convert raw time (u_time) to normalized 0–1 range.
+// Output feeds directly into easing functions.
+
+/**
+ * Loop — repeating sawtooth 0→1→0→1...
+ * duration = cycle length in seconds
+ */
+float loop(float t, float duration) {
+    return fract(t / duration);
+}
+
+/**
+ * Pingpong — triangle wave 0→1→0→1...
+ * duration = half-cycle length (0→1 takes \`duration\` seconds)
+ */
+float pingpong(float t, float duration) {
+    float m = mod(t, duration * 2.0);
+    return m < duration ? m / duration : 2.0 - m / duration;
+}
+
+/**
+ * Once — single play 0→1, then stays at 1.
+ * duration = animation length in seconds
+ * Use with delay: once(u_time - 2.0, 3.0) starts at 2s, takes 3s.
+ */
+float once(float t, float duration) {
+    return clamp(t / duration, 0.0, 1.0);
+}
+
+/**
+ * Reverse — flip animation direction.
+ * Turns 0→1 into 1→0. Works with any easing or shaper.
+ * Usage: reverse(spring(loop(u_time, 2.0))) for spring zoom-in.
+ */
+float reverse(float t) {
+    return 1.0 - t;
+}
+
+// ─── Easing Curves ─────────────────────────────────────────
+// All take t (0–1) and return shaped t (0–1).
+// Compose with time shapers: ease_in(loop(u_time, 2.0))
+
+/**
+ * Ease in — cubic acceleration. Slow start, fast end.
+ */
+float ease_in(float t) {
+    return t * t * t;
+}
+
+/**
+ * Ease out — cubic deceleration. Fast start, slow end.
+ */
+float ease_out(float t) {
+    float f = 1.0 - t;
+    return 1.0 - f * f * f;
+}
+
+/**
+ * Ease in-out — cubic smooth both ends.
+ */
+float ease_in_out(float t) {
+    return t < 0.5
+        ? 4.0 * t * t * t
+        : 1.0 - pow(-2.0 * t + 2.0, 3.0) * 0.5;
+}
+
+/**
+ * Spring — damped oscillation. Overshoots then settles at 1.
+ */
+float spring(float t) {
+    return 1.0 - exp(-6.0 * t) * cos(12.0 * t);
+}
+
+/**
+ * Bounce — bouncing ball landing. Multiple bounces settling at 1.
+ */
+float bounce(float t) {
+    if (t < 1.0 / 2.75) {
+        return 7.5625 * t * t;
+    } else if (t < 2.0 / 2.75) {
+        t -= 1.5 / 2.75;
+        return 7.5625 * t * t + 0.75;
+    } else if (t < 2.5 / 2.75) {
+        t -= 2.25 / 2.75;
+        return 7.5625 * t * t + 0.9375;
+    } else {
+        t -= 2.625 / 2.75;
+        return 7.5625 * t * t + 0.984375;
+    }
+}
+
+/**
+ * Elastic — springy overshoot with oscillation.
+ */
+float elastic(float t) {
+    return sin(13.0 * 3.14159 * 0.5 * t) * pow(2.0, -10.0 * t) + 1.0;
+}
+
+/**
+ * Overshoot — goes past 1, then pulls back. Slight rubber-band feel.
+ */
+float overshoot(float t) {
+    float s = 1.70158;
+    float f = 1.0 - t;
+    return 1.0 - f * f * (f * (s + 1.0) - s);
+}
+
+/**
+ * Teleport — barely creeps, then near-instant jump with spring settle.
+ * Duration mostly = wait time. Jump happens at ~85% of t.
+ * Tiny slow drift → snap → spring overshoot → settle at 1.
+ */
+float teleport(float t) {
+    float jump = smoothstep(0.8, 0.85, t);
+    float creep = pow(t / 0.8, 4.0) * 0.1 * (1.0 - jump);
+    float s = max(t - 0.85, 0.0) * 6.667;
+    float settle = exp(-5.0 * s) * sin(s * 15.0) * 0.15;
+    return creep + jump + settle;
+}
+
+void main() {}
+`,ue=`#import hash from 'sandbox'
+#import noise from 'sandbox'
+#import fbm from 'sandbox'
+#import voronoi from 'sandbox'
+#import worley from 'sandbox'
+
+uniform float u_intensity;
+
+// ─── UV Effects ─────────────────────────────────────────────
+// Each function takes UV and returns modified UV.
+// All use u_intensity uniform for configuration.
+
+/**
+ * Pixelate — blocky mosaic effect.
+ * Snaps UV to a grid. Higher intensity = larger pixels.
+ * intensity = pixel count along shortest axis (default: 20)
+ * @uv-modifier
+ */
+vec2 pixelate(vec2 uv, float intensity) {
+    float size = length(u_resolution) / (max(intensity, 1.0) * 10.0);
+    return floor(uv / size) * size;
+}
+
+/**
+ * Twist — spiral distortion from center outward.
+ * Expects centered UV (use center() first).
+ * intensity = twist strength (0.4 = subtle, 1.0 = full spiral)
+ * @uv-modifier
+ */
+vec2 twist(vec2 uv, float intensity) {
+    float dist = length(uv);
+    float angle = atan(uv.y, uv.x) - intensity * 20.0 * dist;
+    return vec2(cos(angle), sin(angle)) * dist;
+}
+
+/**
+ * Ripple — concentric wave distortion from center.
+ * Expects centered UV (use center() first).
+ * Creates water-drop-like rings.
+ * intensity = wave amplitude (0.5 = gentle, 2.0 = strong)
+ * @uv-modifier
+ */
+vec2 ripple(vec2 uv, float intensity) {
+    float dist = length(uv);
+    float wave = sin(dist * 40.0 - u_time * 3.0) * intensity * 0.02;
+    return uv + normalize(uv + 0.001) * wave;
+}
+
+/**
+ * Fisheye — barrel distortion from center.
+ * Expects centered UV (use center() first).
+ * Bends space outward like a fisheye lens.
+ * intensity = distortion power (0.5 = subtle, 2.0 = extreme)
+ * @uv-modifier
+ */
+vec2 fisheye(vec2 uv, float intensity) {
+    float dist = length(uv);
+    float power = pow(dist, intensity) / dist;
+    return uv * power;
+}
+
+/**
+ * Wobble — animated sine wave displacement.
+ * Creates a jelly-like horizontal wobble.
+ * intensity = wobble amount (1.0 = gentle, 5.0 = wild)
+ * @uv-modifier
+ */
+vec2 wobble(vec2 uv, float intensity) {
+    uv.x += sin(uv.y * 10.0 + u_time * 2.0) * intensity * 0.01;
+    uv.y += cos(uv.x * 10.0 + u_time * 2.0) * intensity * 0.01;
+    return uv;
+}
+
+/**
+ * Organic — iterative fluid morph distortion.
+ * Creates marble-like flowing patterns.
+ * intensity = animation speed (3.0 = default)
+ * @uv-modifier
+ */
+vec2 organic(vec2 uv, float intensity) {
+    float speed = u_time * intensity;
+    vec2 acc = vec2(uv.x + uv.y);
+
+    for (int i = 0; i < 5; i++) {
+        acc += sin(max(uv.x, uv.y)) + uv;
+        uv += 0.5 * vec2(
+            cos(5.1123314 + 0.353 * acc.y + speed * 0.131121),
+            sin(acc.x - 0.113 * speed)
+        );
+        uv -= cos(uv.x + uv.y) - sin(uv.x * 0.711 - uv.y);
+    }
+
+    return uv;
+}
+
+/**
+ * Glitch — random horizontal line displacement.
+ * Creates digital glitch artifact bands.
+ * intensity = glitch strength (0.5 = subtle, 3.0 = heavy)
+ * @uv-modifier
+ */
+vec2 glitch(vec2 uv, float intensity) {
+    float line = floor(uv.y * 50.0);
+    float shift = hash(vec2(line, floor(u_time * 8.0)));
+    shift = step(0.9, shift) * (shift - 0.9) * 10.0;
+    uv.x += shift * intensity * 0.1 * u_resolution.x;
+    return uv;
+}
+
+/**
+ * Mirror — reflect UV across a chosen axis.
+ * Creates bilateral symmetry.
+ * intensity = 0 for horizontal mirror, 1 for vertical mirror
+ * @uv-modifier
+ */
+vec2 mirror(vec2 uv, float intensity) {
+    if (intensity < 0.5) {
+        uv.x = abs(uv.x);
+    } else {
+        uv.y = abs(uv.y);
+    }
+    return uv;
+}
+
+/**
+ * Kaleidoscope — repeating angular symmetry.
+ * Expects centered UV (use center() first).
+ * Creates mandala-like radial repeats.
+ * intensity = number of segments (4 = quad, 6 = hex, 8 = octa)
+ * @uv-modifier
+ */
+vec2 kaleidoscope(vec2 uv, float intensity) {
+    float segments = max(intensity, 1.0);
+    float angle = atan(uv.y, uv.x);
+    float segment_angle = 6.28318 / segments;
+    angle = mod(angle, segment_angle);
+    angle = abs(angle - segment_angle * 0.5);
+    float r = length(uv);
+    return vec2(cos(angle), sin(angle)) * r;
+}
+
+/**
+ * Warp — domain warping using fractal noise.
+ * Displaces UV by layered fbm noise for smoke/cloud-like distortion.
+ * Animated over time.
+ * intensity = warp strength (0.5 = subtle haze, 3.0 = heavy distortion)
+ * @uv-modifier
+ */
+vec2 warp(vec2 uv, float intensity) {
+    vec2 offset = vec2(
+        fbm(uv + u_time * 0.3),
+        fbm(uv + vec2(5.2, 1.3) + u_time * 0.3)
+    );
+    return uv + offset * intensity * 0.1;
+}
+
+/**
+ * Displace — noise-based UV displacement.
+ * Shifts UV using smooth value noise for a wavy, heat-haze look.
+ * Animated over time.
+ * intensity = displacement amount (1.0 = gentle, 5.0 = strong)
+ * @uv-modifier
+ */
+vec2 displace(vec2 uv, float intensity) {
+    float nx = noise(uv * 5.0 + u_time);
+    float ny = noise(uv * 5.0 + vec2(3.7, 7.1) + u_time);
+    return uv + (vec2(nx, ny) - 0.5) * intensity * 0.05;
+}
+
+/**
+ * Shatter — voronoi cell-based UV snapping.
+ * Snaps UV to nearest cell point, creating a broken-glass look.
+ * intensity = cell density (5.0 = large shards, 20.0 = fine fragments)
+ * @uv-modifier
+ */
+vec2 shatter(vec2 uv, float intensity) {
+    return voronoi(uv * intensity) / intensity;
+}
+
+/**
+ * Cells — cellular distortion using Worley distance.
+ * Displaces UV outward from cell edges, like looking through textured glass.
+ * intensity = cell scale (3.0 = large bubbles, 15.0 = fine texture)
+ * @uv-modifier
+ */
+vec2 cells(vec2 uv, float intensity) {
+    float dist = worley(uv * intensity);
+    vec2 grad = vec2(
+        worley(uv * intensity + vec2(0.01, 0.0)) - dist,
+        worley(uv * intensity + vec2(0.0, 0.01)) - dist
+    );
+    return uv + grad * dist * 2.0;
+}
+
+void main() {}
+`,fe=`#import hash from 'sandbox'
+
+uniform float u_intensity;
+
+// ─── Color Filters ──────────────────────────────────────────
+// Each function takes a color and returns modified color.
+// All use u_intensity uniform for configuration.
+
+/**
+ * Contrast — adjust contrast around mid-gray.
+ * intensity: 1.0 = original, >1 = more contrast, <1 = flatter
+ * @color-modifier
+ */
+vec3 contrast(vec3 color, float intensity) {
+    return (color - 0.5) * intensity + 0.5;
+}
+
+/**
+ * Brightness — multiply overall brightness.
+ * intensity: 1.0 = original, >1 = brighter, <1 = darker
+ * @color-modifier
+ */
+vec3 brightness(vec3 color, float intensity) {
+    return color * intensity;
+}
+
+/**
+ * Saturate — adjust color saturation.
+ * intensity: 0 = grayscale, 1.0 = original, >1 = oversaturated
+ * @color-modifier
+ */
+vec3 saturate(vec3 color, float intensity) {
+    float gray = dot(color, vec3(0.299, 0.587, 0.114));
+    return mix(vec3(gray), color, intensity);
+}
+
+/**
+ * Posterize — reduce color to N discrete levels per channel.
+ * intensity = number of levels (4 = retro, 16 = subtle, 256 = nearly smooth)
+ * @color-modifier
+ */
+vec3 posterize(vec3 color, float intensity) {
+    float levels = max(intensity, 1.0);
+    return floor(color * levels + 0.5) / levels;
+}
+
+/**
+ * Threshold — convert to black and white based on cutoff.
+ * intensity = cutoff point (0.5 = balanced, lower = more white)
+ * @color-modifier
+ */
+vec3 threshold(vec3 color, float intensity) {
+    float avg = dot(color, vec3(0.299, 0.587, 0.114));
+    return avg > intensity ? vec3(1.0) : vec3(0.0);
+}
+
+/**
+ * Invert — flip all color channels.
+ * intensity: 0.0 = original, 1.0 = fully inverted, 0.5 = mid-gray
+ * @color-modifier
+ */
+vec3 invert(vec3 color, float intensity) {
+    return mix(color, 1.0 - color, intensity);
+}
+
+/**
+ * Glow — luminance-based bloom, bright areas get amplified.
+ * intensity = glow strength (0.5 = subtle, 2.0 = intense)
+ * @color-modifier
+ */
+vec3 glow(vec3 color, float intensity) {
+    float luminance = dot(color, vec3(0.299, 0.587, 0.114));
+    return color + color * luminance * intensity;
+}
+
+/**
+ * Grain — animated film noise overlay.
+ * intensity = noise strength (0.1 = subtle, 0.5 = heavy)
+ * @color-modifier
+ */
+vec3 grain(vec3 color, vec2 uv, float intensity) {
+    float n = (hash(uv * 1000.0 + u_time) - 0.5) * intensity;
+    return color + n;
+}
+
+/**
+ * Vignette — darken canvas edges.
+ * Applies circular falloff from center.
+ * intensity = darkness strength (1.0 = subtle, 2.0 = strong)
+ * @color-modifier
+ */
+vec3 vignette(vec3 color, vec2 uv, float intensity) {
+    vec2 centered = uv / u_resolution - 0.5;
+    float dist = length(centered);
+    float falloff = 1.0 - smoothstep(0.3, 0.7, dist * intensity);
+    return color * falloff;
+}
+
+/**
+ * Sepia — warm brownish tint like old photographs.
+ * intensity: 0.0 = original, 1.0 = full sepia
+ * @color-modifier
+ */
+vec3 sepia(vec3 color, float intensity) {
+    vec3 s;
+    s.r = dot(color, vec3(0.393, 0.769, 0.189));
+    s.g = dot(color, vec3(0.349, 0.686, 0.168));
+    s.b = dot(color, vec3(0.272, 0.534, 0.131));
+    return mix(color, s, intensity);
+}
+
+/**
+ * Gamma — apply gamma correction curve.
+ * intensity = gamma value (1.0 = linear, 2.2 = standard sRGB, <1 = brighten darks)
+ * @color-modifier
+ */
+vec3 gamma(vec3 color, float intensity) {
+    return pow(max(color, 0.0), vec3(1.0 / max(intensity, 0.001)));
+}
+
+/**
+ * Tint — blend color toward a target tint.
+ * intensity: 0.0 = original, 1.0 = fully tinted
+ * @color-modifier
+ */
+vec3 tint(vec3 color, vec3 tintColor, float intensity) {
+    return mix(color, color * tintColor, intensity);
+}
+
+/**
+ * Highlights — add white light to bright areas.
+ * Uses max channel brightness so even saturated colors trigger highlights.
+ * intensity = highlight strength (0.2 = subtle sheen, 1.0 = strong gloss)
+ * @color-modifier
+ */
+vec3 highlights(vec3 color, float intensity) {
+    float bright = max(color.r, max(color.g, color.b + 0.3));
+    return color + max(bright * 5.5 - 4.0, 0.0) * intensity;
+}
+
+/**
+ * Bayer 8×8 threshold matrix — computed mathematically.
+ * Returns threshold value 0–1 for ordered dithering.
+ */
+float bayer8(vec2 p) {
+    p = mod(floor(p), 8.0);
+    float value = 0.0;
+    float divisor = 1.0;
+    float multiplier = 16.0;
+
+    for (int i = 0; i < 3; i++) {
+        vec2 q = mod(floor(p / divisor), 2.0);
+        value += (q.x * 2.0 + q.y * 3.0 - q.x * q.y * 4.0) * multiplier;
+        divisor *= 2.0;
+        multiplier *= 0.25;
+    }
+
+    return value / 64.0;
+}
+
+/**
+ * Dither — ordered Bayer 8×8 dithering.
+ * Reduces color to discrete levels with a threshold pattern.
+ * Use pixelate() on UV before coloring for blocky dither cells.
+ * intensity = number of color levels (2 = 1-bit, 4 = retro, 8 = subtle)
+ * @color-modifier
+ */
+vec3 dither(vec3 color, vec2 uv, float intensity) {
+    float levels = max(intensity, 2.0);
+    float threshold = bayer8(uv) - 0.5;
+    float stepSize = 1.0 / (levels - 1.0);
+    color += threshold * stepSize;
+    return clamp(floor(color * (levels - 1.0) + 0.5) / (levels - 1.0), 0.0, 1.0);
+}
+
+/**
+ * Arcade — pixelated Bayer dithering.
+ * Combines pixelation and ordered dither for retro 8-bit look.
+ * intensity = number of color levels (2 = 1-bit, 4 = retro, 8 = subtle)
+ * @color-modifier
+ */
+vec3 arcade(vec3 color, vec2 uv, float intensity) {
+    vec2 grid = uv * u_resolution * 0.5;
+    return dither(color, grid, intensity);
+}
+
+void main() {}
+`,b=new Q([new v("sandbox",ae),new v("sandbox/colors",le),new v("sandbox/time",ce),new v("sandbox/effects",ue,{default:{intensity:{uniform:"u_intensity",default:1}},pixelate:{intensity:{uniform:"u_intensity",default:20}},twist:{intensity:{uniform:"u_intensity",default:1}},ripple:{intensity:{uniform:"u_intensity",default:1}},fisheye:{intensity:{uniform:"u_intensity",default:1}},wobble:{intensity:{uniform:"u_intensity",default:1}},organic:{intensity:{uniform:"u_intensity",default:3}},glitch:{intensity:{uniform:"u_intensity",default:1}},mirror:{intensity:{uniform:"u_intensity",default:0}},kaleidoscope:{intensity:{uniform:"u_intensity",default:6}},zoom:{intensity:{uniform:"u_intensity",default:1}},warp:{intensity:{uniform:"u_intensity",default:1}},displace:{intensity:{uniform:"u_intensity",default:1}},shatter:{intensity:{uniform:"u_intensity",default:10}},cells:{intensity:{uniform:"u_intensity",default:8}},glass:{intensity:{uniform:"u_intensity",default:1}}}),new v("sandbox/filters",fe,{default:{intensity:{uniform:"u_intensity",default:1}},posterize:{intensity:{uniform:"u_intensity",default:8}},threshold:{intensity:{uniform:"u_intensity",default:.5}},grain:{intensity:{uniform:"u_intensity",default:.1}},vignette:{intensity:{uniform:"u_intensity",default:1.4}},glow:{intensity:{uniform:"u_intensity",default:.5}},gamma:{intensity:{uniform:"u_intensity",default:2.2}},dither:{intensity:{uniform:"u_intensity",default:4}},highlights:{intensity:{uniform:"u_intensity",default:.5}}})]),y=new Q,S=new Map([["u_resolution","vec2"],["u_time","float"],["u_delta","float"],["u_mouse","vec2"],["u_frame","int"]]);class he{constructor(e){a(this,"gl");a(this,"program",null);a(this,"uniforms",new Map);this.gl=e}attachProgram(e){this.program=e;for(const n of this.uniforms.values())n.invalidateLocation();return this}set(e,n){const t=this.uniforms.get(e);return t?t.setValue(n):this.uniforms.set(e,new M(e,n)),this}setMany(e){for(const[n,t]of Object.entries(e))this.set(n,t);return this}get(e){var n;return(n=this.uniforms.get(e))==null?void 0:n.getValue()}has(e){return this.uniforms.has(e)}delete(e){return this.uniforms.delete(e)}uploadAll(){if(!this.program)return this;for(const e of this.uniforms.values())e.upload(this.gl,this.program);return this}uploadBuiltIns(e,n,t){if(this.set("u_resolution",n),this.set("u_time",e.time),this.set("u_delta",e.delta),this.set("u_mouse",t),this.set("u_frame",e.frame),!this.program)return this;for(const i of S.keys()){const r=this.uniforms.get(i);r&&r.upload(this.gl,this.program)}return this}clear(){this.uniforms.clear()}destroy(){this.uniforms.clear(),this.program=null}keys(){return this.uniforms.keys()}get size(){return this.uniforms.size}}class L{constructor(){a(this,"hooks",new Map)}id(){return Math.random().toString(36).substring(2,10)}add(e){const n=this.id();return this.hooks.set(n,e),()=>this.remove(n)}remove(e){this.hooks.delete(e)}run(e){for(const[n,t]of this.hooks)try{t(e)===!1&&this.remove(n)}catch(i){throw new K(n,i instanceof Error?i.message:String(i))}}destroy(){this.hooks.clear()}}class C{constructor(e,n){a(this,"canvas");a(this,"gl");a(this,"options");a(this,"onBeforeHooks",new L);a(this,"onAfterHooks",new L);a(this,"_program");a(this,"_geometry");a(this,"_uniforms");a(this,"_clock");a(this,"_resolution",[1,1]);a(this,"_mouse",[0,0]);a(this,"_version",1);a(this,"playing",!1);this.canvas=e,this.options=n,this.gl=this.initContext(),this.enableExtensions(),this._program=new se(this.gl),this._geometry=k.fullscreenQuad(this.gl),this._uniforms=new he(this.gl),this._clock=new oe,this.options.fps&&this._clock.setMaxFps(this.options.fps),this.options.onBeforeRender&&this.onBeforeHooks.add(this.options.onBeforeRender),this.options.onAfterRender&&this.onAfterHooks.add(this.options.onAfterRender),this.onRender=this.onRender.bind(this)}static setup(e,n){const t=new C(e,n);return n.vertex&&n.fragment&&t.shader(n.vertex,n.fragment),n.uniforms&&t._uniforms.setMany(n.uniforms),y.isEmpty()||t._uniforms.setMany(y.defaults()),t}initContext(){const e={antialias:this.options.antialias,preserveDrawingBuffer:this.options.preserveDrawingBuffer,alpha:!0,depth:!1,stencil:!1},n=this.canvas.getContext("webgl2",e);if(n)return this._version=2,n;const t=this.canvas.getContext("webgl",e);if(t)return this._version=1,t;const i=new V;throw this.options.onError(i),i}enableExtensions(){this.gl.getExtension("OES_standard_derivatives"),this.gl.getExtension("OES_texture_float"),this.gl.getExtension("OES_texture_float_linear"),this._version===1&&this.gl.getExtension("OES_vertex_array_object")}viewport(e,n,t,i){return this.canvas.width=t,this.canvas.height=i,this.gl.viewport(e,n,t,i),this._resolution=[t,i],this}clock(e){return this._clock.setTime(e),this}mouse(e,n){return this._mouse=[e,n],this}uniform(e,n){return this._uniforms.set(e,n),this}uniforms(e){return this._uniforms.setMany(e),this}getUniform(e){return this._uniforms.get(e)}shader(e,n){try{if(y.clear(),e.version()!==n.version())throw new $(e.version(),n.version());this._program.compile(e.source(),n.compile()),this._version=n.version(),this._geometry.linkAttributes(this._program);const t=this._program.getProgram();t&&this._uniforms.attachProgram(t);try{this.options.onLoad()}catch(i){throw new Y(i instanceof Error?i.message:String(i))}}catch(t){t instanceof h&&this.options.onError(t)}return this}play(){return this.playing?this:(this.playing=!0,this._clock.start(this.onRender),this)}pause(){if(!this.playing)return this;const e=this._clock.getState();try{this.onBeforeHooks.run(e)}catch(n){n instanceof h&&this.options.onError(n)}this.playing=!1,this._clock.stop();try{this.onAfterHooks.run(e)}catch(n){n instanceof h&&this.options.onError(n)}return this}render(){return this.onRender(this._clock.getState()),this}getContext(){return this.gl}getVersion(){return this._version}getClock(){return this._clock}destroy(){this.pause(),this._clock.destroy(),this._geometry.destroy(),this._program.destroy(),this._uniforms.destroy(),this.onAfterHooks.destroy(),this.onBeforeHooks.destroy(),y.clear()}onRender(e){const n=this.gl;try{this.onBeforeHooks.run(e)}catch(t){t instanceof h&&this.options.onError(t)}n.clearColor(0,0,0,0),n.clear(n.COLOR_BUFFER_BIT),this._program.use(),this._uniforms.uploadBuiltIns(e,this._resolution,this._mouse),this._uniforms.uploadAll(),this._geometry.bind(),this._geometry.draw();try{this.onAfterHooks.run(e)}catch(t){t instanceof h&&this.options.onError(t)}}}class m extends X{constructor(e){super(e),S.forEach((n,t)=>{this.requirements.uniforms.set(t,{name:t,type:n,line:0})})}}const R=`#ifdef GL_ES
 precision mediump float;
 #endif
 
@@ -15,7 +841,7 @@ void main() {
   v_texcoord = a_texcoord;
   gl_Position = vec4(a_position, 0.0, 1.0);
 }
-`,y=`#ifdef GL_ES
+`,F=`#ifdef GL_ES
 precision mediump float;
 #endif
 
@@ -29,7 +855,7 @@ void main() {
   vec3 color = vec3(uv.x, uv.y, 0.5 + 0.5 * sin(u_time));
   gl_FragColor = vec4(color, 1.0);
 }
-`,E=`#version 300 es
+`,U=`#version 300 es
 
 in vec2 a_position;
 in vec2 a_texcoord;
@@ -39,7 +865,7 @@ out vec2 v_texcoord;
 void main() {
     v_texcoord = a_texcoord;
     gl_Position = vec4(a_position, 0.0, 1.0);
-}`,M=`#version 300 es
+}`,de=`#version 300 es
 precision highp float;
 
 uniform vec2 u_resolution;
@@ -53,5 +879,5 @@ void main() {
     vec2 uv = gl_FragCoord.xy / u_resolution;
     vec3 color = vec3(uv.x, uv.y, 0.5 + 0.5 * sin(u_time));
     fragColor = vec4(color, 1.0);
-}`;class _{constructor(t,e){i(this,"listeners",[]);i(this,"canvas");i(this,"options");i(this,"engine");this.canvas=t,this.options=this.resolveOptions(e),this.engine=b.setup(this.canvas,this.options),this.setupListeners(),this.setViewport(),this.options.onLoad(),this.options.autoplay&&this.play()}static create(t,e){return new _(t,e)}resolveOptions(t){const e={vertex:g,fragment:y,autoplay:!0,pauseWhenHidden:!0,dpr:"auto",preserveDrawingBuffer:!1,antialias:!0,onError:r=>{console.error("Oops!",r,`
-You can handle errors programmatically by providing an onError callback to suppress this log and implement custom fallback behavior.`)},onLoad:()=>{},onBeforeRender:null,onAfterRender:null,uniforms:{}};if(t!=null&&t.vertex&&!(t!=null&&t.fragment)){const r=h.detectVersion(t.vertex);e.vertex=t.vertex,e.fragment=r===2?M:y}if(t!=null&&t.fragment&&!(t!=null&&t.vertex)){const r=h.detectVersion(t.fragment);e.fragment=t.fragment,e.vertex=r===2?E:g}return{...e,...t}}setupListeners(){this.listeners.push(u.on(window,"resize",()=>{this.setViewport()}),u.on(this.canvas,"resize",()=>{this.setViewport()}),(()=>{let t=!1;return u.on(document,"scroll",e=>{this.options.pauseWhenHidden&&(this.isInViewport()?t&&!this.isPlaying()&&(this.play(),t=!1):this.isPlaying()&&(this.pause(),t=!0))})})(),u.on(document,"mousemove",t=>{this.setMouse(t.clientX||t.pageX,t.clientY||t.pageY)}),u.on(document,"touchmove",t=>{t.touches.length>0&&this.setMouse(t.touches[0].clientX,t.touches[0].clientY)}))}destroyListeners(){this.listeners.forEach(t=>t()),this.listeners=[]}setViewport(){const t=this.options.dpr==="auto"?Math.min(2,window.devicePixelRatio||1):this.options.dpr,e=this.canvas.clientWidth||this.canvas.width||1,r=this.canvas.clientHeight||this.canvas.height||1;this.engine.viewport(0,0,Math.max(1,Math.floor(e*t)),Math.max(1,Math.floor(r*t)))}isInViewport(){const t=this.canvas.getBoundingClientRect();return t.bottom>=0&&t.right>=0&&t.top<=(window.innerHeight||document.documentElement.clientHeight)&&t.left<=(window.innerWidth||document.documentElement.clientWidth)}setMouse(t,e){const r=this.canvas.getBoundingClientRect();t>=r.left&&t<=r.right&&e>=r.top&&e<=r.bottom&&this.engine.mouse(t-r.left,e-r.top)}setUniform(t,e){return this.engine.uniform(t,e),this}setUniforms(t){return this.engine.uniforms(t),this}getUniform(t){return this.engine.getUniform(t)}setShader(t,e){return this.engine.shader(t,e),this}setFragment(t){const r=this.webglVersion()===1?g:E;return this.engine.shader(r,t),this}hook(t,e="before"){return e==="before"?this.engine.onBeforeHooks.add(t):this.engine.onAfterHooks.add(t)}play(){return this.engine.play(),this}playAt(t){return this.engine.clock(t),this.engine.play(),this}pause(){return this.engine.pause(),this}pauseAt(t){const e=this.hook(r=>{r.time>=t&&(e(),this.pause())},"after");return this}toggle(){return this.engine.playing?this.pause():this.play(),this}time(t){return this.engine.clock(t),this}render(){return this.engine.render(),this}renderAt(t){return this.engine.clock(t),this.engine.render(),this}isPlaying(){return this.engine.playing}webglVersion(){return this.engine.getVersion()}canvasElement(){return this.canvas}destroy(){this.destroyListeners(),this.engine.destroy()}}exports.Sandbox=_;exports.SandboxContextError=S;exports.SandboxError=l;exports.SandboxProgramError=d;exports.SandboxShaderCompilationError=f;exports.SandboxShaderVersionMismatchError=L;
+}`;class O{constructor(e,n){a(this,"listeners",[]);a(this,"canvasEl");a(this,"options");a(this,"engine");a(this,"usingCustomVertex",!1);if(this.canvasEl=e,this.options=this.resolveOptions(n),this.engine=C.setup(this.canvasEl,this.options),this.setupListeners(),this.setViewport(),this.options.modules)for(const[t,i]of Object.entries(this.options.modules))this.module(t,i);this.options.autoplay&&this.play()}static create(e,n){return new O(e,n)}static defineModule(e,n,t={}){v.define({name:e,source:n,options:t})}static availableModules(){return b.available()}static compile(e){return new m(e).compile()}resolveOptions(e){const n={vertex:new m(R),fragment:new m(F),autoplay:!0,pauseWhenHidden:!0,dpr:"auto",fps:0,preserveDrawingBuffer:!1,antialias:!0,onError:o=>{console.error("Oops!",o,`
+You can handle errors programmatically by providing an onError callback to suppress this log and implement custom fallback behavior.`)},onLoad:()=>{},onBeforeRender:null,onAfterRender:null,uniforms:{},modules:{}};if(e!=null&&e.vertex&&(this.usingCustomVertex=!0),e!=null&&e.vertex&&!(e!=null&&e.fragment)){n.vertex=new m(e.vertex);const o=n.vertex.version();n.fragment=new m(o===2?de:F)}if(e!=null&&e.fragment&&!(e!=null&&e.vertex)){n.fragment=new m(e.fragment);const o=n.fragment.version();n.vertex=new m(o===2?U:R)}e!=null&&e.vertex&&(e!=null&&e.fragment)&&(n.vertex=new m(e.vertex),n.fragment=new m(e.fragment));const{vertex:t,fragment:i,...r}=e||{};return{...n,...r}}setupListeners(){this.listeners.push(x.on(window,"resize",()=>{this.setViewport()}),x.on(this.canvasEl,"resize",()=>{this.setViewport()}),(()=>{let e=!1;return x.on(document,"scroll",n=>{this.options.pauseWhenHidden&&(this.isInViewport()?e&&!this.isPlaying()&&(this.play(),e=!1):this.isPlaying()&&(this.pause(),e=!0))})})(),x.on(document,"mousemove",e=>{this.setMouse(e.clientX||e.pageX,e.clientY||e.pageY)}),x.on(document,"touchmove",e=>{e.touches.length>0&&this.setMouse(e.touches[0].clientX,e.touches[0].clientY)}))}destroyListeners(){this.listeners.forEach(e=>e()),this.listeners=[]}setViewport(){const e=this.options.dpr==="auto"?Math.min(2,window.devicePixelRatio||1):this.options.dpr,n=this.canvasEl.clientWidth||this.canvasEl.width||1,t=this.canvasEl.clientHeight||this.canvasEl.height||1;this.engine.viewport(0,0,Math.max(1,Math.floor(n*e)),Math.max(1,Math.floor(t*e)))}isInViewport(){const e=this.canvasEl.getBoundingClientRect();return e.bottom>=0&&e.right>=0&&e.top<=(window.innerHeight||document.documentElement.clientHeight)&&e.left<=(window.innerWidth||document.documentElement.clientWidth)}setMouse(e,n){const t=this.canvasEl.getBoundingClientRect();e>=t.left&&e<=t.right&&n>=t.top&&n<=t.bottom&&this.engine.mouse(e-t.left,n-t.top)}setUniform(e,n){return this.engine.uniform(e,n),this}setUniforms(e){return this.engine.uniforms(e),this}getUniform(e){return this.engine.getUniform(e)}setShader(e,n){return this.options.vertex=new m(e),this.options.fragment=new m(n),this.usingCustomVertex=!0,this.engine.shader(this.options.vertex,this.options.fragment),this}setFragment(e){const n=new m(e),t=n.version(),i=this.options.vertex.version();return this.options.fragment=n,t!==i&&(this.usingCustomVertex||(this.options.vertex=new m(t===2?U:R))),this.engine.shader(this.options.vertex,this.options.fragment),this}getFragment(){return this.options.fragment.source()}getVertex(){return this.options.vertex.source()}setFps(e){return this.engine.getClock().setMaxFps(e),this}hook(e,n="before"){return n==="before"?this.engine.onBeforeHooks.add(e):this.engine.onAfterHooks.add(e)}module(e,n){const t=y.resolveOptions(e);if(!t)return console.warn(`Sandbox: Counld not find options for '${e}' function. Make sure you used the correct imported name and the module is currently in use by the shader.`),this;for(const[i,r]of Object.entries(n)){const o=t[i];if(!o){console.warn(`Sandbox: Option '${i}' not found for function '${e}'. Make sure to check available options with Sandbox.availableModules() and provide the correct option name.`);continue}this.setUniform(o.uniform,r)}return this}play(){return this.engine.play(),this}playAt(e){return this.engine.clock(e),this.engine.play(),this}pause(){return this.engine.pause(),this}pauseAt(e){const n=this.hook(t=>{t.time>=e&&(n(),this.pause())},"after");return this}toggle(){return this.engine.playing?this.pause():this.play(),this}time(e){return this.engine.clock(e),this}render(){return this.engine.render(),this}renderAt(e){return this.engine.clock(e),this.engine.render(),this}isPlaying(){return this.engine.playing}get version(){return this.engine.getVersion()}get canvas(){return this.canvasEl}destroy(){this.destroyListeners(),this.engine.destroy()}}exports.Sandbox=O;exports.SandboxAttemptedToImportDefaultFunctionError=z;exports.SandboxAttemptedToImportMainFunctionError=N;exports.SandboxContextCreationError=re;exports.SandboxError=h;exports.SandboxForbiddenModuleNameError=G;exports.SandboxGLSLShaderCompilationError=w;exports.SandboxMentionCouldNotBeReplacedError=j;exports.SandboxMentionFunctionNotFoundError=H;exports.SandboxMentionUniformNotFoundError=q;exports.SandboxModuleMethodNotFoundError=D;exports.SandboxModuleNotFoundError=B;exports.SandboxOnHookCallbackError=K;exports.SandboxOnLoadCallbackError=Y;exports.SandboxOverwriteModuleError=W;exports.SandboxProgramError=E;exports.SandboxShaderDuplicateImportNameError=P;exports.SandboxShaderImportSyntaxError=I;exports.SandboxShaderRequirementMismatchError=A;exports.SandboxShaderVersionMismatchError=$;exports.SandboxShaderWithoutFunctionError=T;exports.SandboxWebGLNotSupportedError=V;