npm - @rosalana/sandbox - Versions diffs - 0.1.0 → 0.2.1 - Mend

@rosalana/sandbox 0.1.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/README.md +135 -3
package/dist/errors/base.d.ts +1 -1
package/dist/errors/index.d.ts +1 -0
package/dist/errors/texture.d.ts +12 -0
package/dist/globals.d.ts +0 -5
package/dist/index.cjs.js +24 -24
package/dist/index.d.ts +57 -1
package/dist/index.es.js +812 -477
package/dist/tools/compilable.d.ts +2 -1
package/dist/tools/texture.d.ts +64 -0
package/dist/tools/textures.d.ts +48 -0
package/dist/tools/web_gl.d.ts +20 -1
package/dist/types.d.ts +33 -0
package/package.json +1 -1

package/dist/index.es.js CHANGED Viewed

@@ -1,9 +1,9 @@
-var D = Object.defineProperty;
-var N = (u, e, n) => e in u ? D(u, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : u[e] = n;
-var a = (u, e, n) => N(u, typeof e != "symbol" ? e + "" : e, n);
-class x {
-  constructor(e, n, t, i) {
-    this.target = e, this.type = n, this.listener = t, this.options = i, this.target.addEventListener(
+var B = Object.defineProperty;
+var N = (u, e, t) => e in u ? B(u, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : u[e] = t;
+var a = (u, e, t) => N(u, typeof e != "symbol" ? e + "" : e, t);
+class y {
+  constructor(e, t, n, i) {
+    this.target = e, this.type = t, this.listener = n, this.options = i, this.target.addEventListener(
       this.type,
       this.listener,
       this.options
@@ -16,23 +16,23 @@ class x {
       this.options
     );
   }
-  static on(e, n, t, i) {
-    return e.addEventListener(n, t, i), () => e.removeEventListener(n, t, i);
+  static on(e, t, n, i) {
+    return e.addEventListener(t, n, i), () => e.removeEventListener(t, n, i);
   }
 }
 class h extends Error {
-  constructor(n, t) {
-    super(n);
+  constructor(t, n) {
+    super(t);
     a(this, "name", "SandboxError");
-    this.code = t;
+    this.code = n;
   }
 }
-class z extends h {
+class G extends h {
   constructor() {
     super("WebGL is not supported in this browser.", "CONTEXT_ERROR");
   }
 }
-class de extends h {
+class pe extends h {
   constructor() {
     super(
       "Failed to create WebGL context. The GPU may be unavailable.",
@@ -40,35 +40,35 @@ class de extends h {
     );
   }
 }
-class G extends h {
-  constructor(e, n) {
+class W extends h {
+  constructor(e, t) {
     super(
-      `Vertex and fragment shader WebGL versions do not match (${e} vs ${n})`,
+      `Vertex and fragment shader WebGL versions do not match (${e} vs ${t})`,
       "VALIDATION_ERROR"
-    ), this.vertexVersion = e, this.fragmentVersion = n;
+    ), this.vertexVersion = e, this.fragmentVersion = t;
   }
 }
 class _ extends h {
-  constructor(n, t, i) {
+  constructor(t, n, i) {
     const r = _.parseErrorLines(i), s = r.length > 0 ? ` at line(s): ${r.join(", ")}` : "";
     super(
-      `${n} shader compilation failed${s}
+      `${t} shader compilation failed${s}
 ${i}`,
       "SHADER_ERROR"
     );
     a(this, "lines");
-    this.shaderType = n, this.source = t, this.infoLog = i, this.lines = r;
+    this.shaderType = t, this.source = n, this.infoLog = i, this.lines = r;
   }
-  static parseErrorLines(n) {
-    const t = [
+  static parseErrorLines(t) {
+    const n = [
       /ERROR:\s*\d*:(\d+)/g,
       /(\d+):(\d+)\(\d+\):/g,
       /^(\d+):/gm
     ], i = /* @__PURE__ */ new Set();
-    for (const r of t) {
+    for (const r of n) {
       let s;
-      for (; (s = r.exec(n)) !== null; ) {
+      for (; (s = r.exec(t)) !== null; ) {
         const o = parseInt(s[1], 10);
         o > 0 && i.add(o);
       }
@@ -76,33 +76,33 @@ ${i}`,
     return [...i].sort((r, s) => r - s);
   }
 }
-class C extends h {
-  constructor(e, n, t, i) {
+class T extends h {
+  constructor(e, t, n, i) {
     super(
-      `The shader ${e} "${n}" has type "${i}" but expected "${t}"`,
+      `The shader ${e} "${t}" has type "${i}" but expected "${n}"`,
       "SHADER_ERROR"
-    ), this.requirement = e, this.name = n, this.expectedType = t, this.actualType = i;
+    ), this.requirement = e, this.name = t, this.expectedType = n, this.actualType = i;
   }
 }
-class W extends h {
+class z extends h {
   constructor() {
     super("Shader source does not contain any function.", "SHADER_ERROR");
   }
 }
-class q extends h {
-  constructor(e, n) {
+class H extends h {
+  constructor(e, t) {
     super(
-      `Syntax error in shader import statement at line ${e}: ${n}`,
+      `Syntax error in shader import statement at line ${e}: ${t}`,
       "SHADER_ERROR"
-    ), this.line = e, this.details = n;
+    ), this.line = e, this.details = t;
   }
 }
-class H extends h {
-  constructor(e, n) {
+class q extends h {
+  constructor(e, t) {
     super(
-      `Duplicate import name "${e}" found at line ${n}. Each import must have a unique name.`,
+      `Duplicate import name "${e}" found at line ${t}. Each import must have a unique name.`,
       "SHADER_ERROR"
-    ), this.name = e, this.line = n;
+    ), this.name = e, this.line = t;
   }
 }
 class j extends h {
@@ -113,15 +113,15 @@ class j extends h {
     ), this.moduleName = e;
   }
 }
-class Y extends h {
-  constructor(e, n) {
+class X extends h {
+  constructor(e, t) {
     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.`,
+      `Method '${t}' 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;
+    ), this.moduleName = e, this.methodName = t;
   }
 }
-class K extends h {
+class Y extends h {
   constructor(e) {
     super(
       `Importing 'main' function from module '${e}' is forbidden.`,
@@ -129,7 +129,7 @@ class K extends h {
     ), this.moduleName = e;
   }
 }
-class X extends h {
+class K extends h {
   constructor(e) {
     super(
       `Name 'default' is reserved and cannot be used as a function name in module '${e}'.`,
@@ -154,27 +154,27 @@ class J extends h {
   }
 }
 class Z extends h {
-  constructor(e, n, t) {
+  constructor(e, t, n) {
     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.`,
+      `Uniform '${n}' mentioned for function '${t}' 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;
+    ), this.moduleName = e, this.functionName = t, this.uniformName = n;
   }
 }
 class ee extends h {
-  constructor(e, n) {
+  constructor(e, t) {
     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.`,
+      `Uniform '${t}' 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;
+    ), this.functionName = e, this.uniformName = t;
   }
 }
-class ne extends h {
-  constructor(e, n) {
+class te extends h {
+  constructor(e, t) {
     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.`,
+      `Mention '${e}' called in function '${t}' 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;
+    ), this.mentionName = e, this.calledInFunction = t;
   }
 }
 class R extends h {
@@ -184,14 +184,34 @@ class R extends h {
 ${e}`, "PROGRAM_ERROR"), this.infoLog = e;
   }
 }
-class te extends h {
+class ve extends h {
+  constructor(t) {
+    super(
+      `Failed to create WebGL texture for "${t}".`,
+      "TEXTURE_ERROR"
+    );
+    a(this, "name", "SandboxTextureCreationError");
+    this.textureName = t;
+  }
+}
+class ge extends h {
+  constructor(t, n) {
+    super(
+      `Cannot bind texture "${t}": all ${n} texture units are in use.`,
+      "TEXTURE_ERROR"
+    );
+    a(this, "name", "SandboxTextureUnitLimitError");
+    this.textureName = t, this.maxUnits = n;
+  }
+}
+class ne extends h {
   constructor(e) {
     super(`Error in onLoad callback: ${e}`, "UNKNOWN_ERROR");
   }
 }
 class ie extends h {
-  constructor(e, n) {
-    super(`Error in onBefore/onAfter hook callback with ID ${e}: ${n}`, "UNKNOWN_ERROR");
+  constructor(e, t) {
+    super(`Error in onBefore/onAfter hook callback with ID ${e}: ${t}`, "UNKNOWN_ERROR");
   }
 }
 class re {
@@ -219,8 +239,8 @@ class re {
   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;
+    const t = performance.now();
+    return this.frame === 0 ? this.startTime = t : this.startTime = t - this.time * 1e3, this.lastTime = t, this.rafId = requestAnimationFrame(this.loop), this;
   }
   /**
    * Stop the animation loop.
@@ -278,15 +298,15 @@ class re {
   loop(e) {
     if (!this.running) return;
     if (this.maxFps > 0) {
-      const t = 1e3 / this.maxFps;
-      if (e - this.lastTime < t) {
+      const n = 1e3 / this.maxFps;
+      if (e - this.lastTime < n) {
         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 * 0.95 + n * 0.05, this.time = (e - this.startTime) / 1e3, this.frame++, this.callback && this.callback(this.getState()), this.rafId = requestAnimationFrame(this.loop);
+    const t = this.delta > 0 ? 1 / this.delta : 0;
+    this.fps = this.fps * 0.95 + t * 0.05, this.time = (e - this.startTime) / 1e3, this.frame++, this.callback && this.callback(this.getState()), this.rafId = requestAnimationFrame(this.loop);
   }
 }
 class A {
@@ -308,7 +328,7 @@ class A {
    * This is the most common use case for shader effects.
    */
   static fullscreenQuad(e) {
-    const n = new A(e), t = new Float32Array([
+    const t = new A(e), n = new Float32Array([
       // position    texcoord
       -1,
       -1,
@@ -340,33 +360,33 @@ class A {
       3
       // second triangle
     ]);
-    return n.setup(t, i), n;
+    return t.setup(n, i), t;
   }
   /**
    * Setup geometry from vertex and index data.
    */
-  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;
+  setup(e, t) {
+    const n = this.gl;
+    return this.createVAO(), this.bindVAO(), this.vbo = n.createBuffer(), n.bindBuffer(n.ARRAY_BUFFER, this.vbo), n.bufferData(n.ARRAY_BUFFER, e, n.STATIC_DRAW), this.vertexCount = e.length / 4, t && (this.ibo = n.createBuffer(), n.bindBuffer(n.ELEMENT_ARRAY_BUFFER, this.ibo), n.bufferData(n.ELEMENT_ARRAY_BUFFER, t, n.STATIC_DRAW), this.indexCount = t.length, this.useIndices = !0), this.unbindVAO(), this;
   }
   /**
    * Link vertex attributes to shader program.
    * Call this after compiling shaders.
    */
   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 t = this.gl;
+    this.bindVAO(), t.bindBuffer(t.ARRAY_BUFFER, this.vbo);
+    const n = 4 * Float32Array.BYTES_PER_ELEMENT, i = this.getPositionLocation(e);
+    i >= 0 && (t.enableVertexAttribArray(i), t.vertexAttribPointer(i, 2, t.FLOAT, !1, n, 0));
     const r = this.getTexcoordLocation(e);
-    return r >= 0 && (n.enableVertexAttribArray(r), n.vertexAttribPointer(
+    return r >= 0 && (t.enableVertexAttribArray(r), t.vertexAttribPointer(
       r,
       2,
-      n.FLOAT,
+      t.FLOAT,
       !1,
-      t,
+      n,
       2 * Float32Array.BYTES_PER_ELEMENT
-    )), this.useIndices && n.bindBuffer(n.ELEMENT_ARRAY_BUFFER, this.ibo), this.unbindVAO(), this;
+    )), this.useIndices && t.bindBuffer(t.ELEMENT_ARRAY_BUFFER, this.ibo), this.unbindVAO(), this;
   }
   /**
    * Bind geometry for rendering.
@@ -399,16 +419,16 @@ class A {
    * Tries common naming conventions.
    */
   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;
+    let t = e.getAttribLocation("a_position");
+    return t >= 0 || (t = e.getAttribLocation("aPosition"), t >= 0) || (t = e.getAttribLocation("position"), t >= 0) ? t : -1;
   }
   /**
    * Get texcoord attribute location.
    * Tries common naming conventions.
    */
   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;
+    let t = e.getAttribLocation("a_texcoord");
+    return t >= 0 || (t = e.getAttribLocation("aTexCoord"), t >= 0) || (t = e.getAttribLocation("texcoord"), t >= 0) || (t = e.getAttribLocation("a_uv"), t >= 0) ? t : -1;
   }
   // ============================================================================
   // VAO helpers (handle WebGL1 vs WebGL2 differences)
@@ -439,8 +459,8 @@ class se {
    * @throws ShaderCompilationError if compilation fails
    * @throws ProgramLinkError if linking fails
    */
-  compile(e, n) {
-    return this.destroy(), this.vertexShader = this.compileShader("vertex", e), this.fragmentShader = this.compileShader("fragment", n), this.linkProgram(), this;
+  compile(e, t) {
+    return this.destroy(), this.vertexShader = this.compileShader("vertex", e), this.fragmentShader = this.compileShader("fragment", t), this.linkProgram(), this;
   }
   /**
    * Bind this program for rendering.
@@ -477,17 +497,17 @@ class se {
    * Compile a single shader.
    * @throws ShaderCompilationError if compilation fails
    */
-  compileShader(e, n) {
-    const t = this.gl, i = e === "vertex" ? t.VERTEX_SHADER : t.FRAGMENT_SHADER, r = t.createShader(i);
+  compileShader(e, t) {
+    const n = this.gl, i = e === "vertex" ? n.VERTEX_SHADER : n.FRAGMENT_SHADER, r = n.createShader(i);
     if (!r)
       throw new _(
         e,
-        n,
+        t,
         "Failed to create shader object"
       );
-    if (t.shaderSource(r, n), t.compileShader(r), !t.getShaderParameter(r, t.COMPILE_STATUS)) {
-      const o = t.getShaderInfoLog(r) || "Unknown error";
-      throw t.deleteShader(r), new _(e, n, o);
+    if (n.shaderSource(r, t), n.compileShader(r), !n.getShaderParameter(r, n.COMPILE_STATUS)) {
+      const o = n.getShaderInfoLog(r) || "Unknown error";
+      throw n.deleteShader(r), new _(e, t, o);
     }
     return r;
   }
@@ -499,18 +519,18 @@ class se {
     const e = this.gl;
     if (!this.vertexShader || !this.fragmentShader)
       throw new R("Shaders not compiled");
-    const n = e.createProgram();
-    if (!n)
+    const t = e.createProgram();
+    if (!t)
       throw new R("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 R(i);
+    if (e.attachShader(t, this.vertexShader), e.attachShader(t, this.fragmentShader), e.linkProgram(t), !e.getProgramParameter(t, e.LINK_STATUS)) {
+      const i = e.getProgramInfoLog(t) || "Unknown error";
+      throw e.deleteProgram(t), new R(i);
     }
-    this.program = n;
+    this.program = t;
   }
 }
-class k {
-  constructor(e, n) {
+class M {
+  constructor(e, t) {
     a(this, "name");
     a(this, "method");
     a(this, "isArray");
@@ -518,9 +538,9 @@ class k {
     a(this, "location", null);
     a(this, "locationResolved", !1);
     a(this, "value");
-    this.name = e, this.value = n;
-    const t = k.inferMethodInfo(n);
-    this.method = t.method, this.isArray = t.isArray, this.isMatrix = t.isMatrix;
+    this.name = e, this.value = t;
+    const n = M.inferMethodInfo(t);
+    this.method = n.method, this.isArray = n.isArray, this.isMatrix = n.isMatrix;
   }
   /**
    * Infer WebGL method and metadata from value type.
@@ -532,9 +552,9 @@ class k {
       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) {
+    const t = e.length, n = e[0];
+    if (Array.isArray(n))
+      switch (n.length) {
         case 2:
           return { method: "uniform2fv", isArray: !0, isMatrix: !1 };
         case 3:
@@ -544,7 +564,7 @@ class k {
         default:
           return { method: "uniform1fv", isArray: !0, isMatrix: !1 };
       }
-    switch (n) {
+    switch (t) {
       case 2:
         return { method: "uniform2fv", isArray: !1, isMatrix: !1 };
       case 3:
@@ -563,8 +583,8 @@ class k {
    * Resolve and cache uniform location from program.
    * Returns null if uniform doesn't exist (optimized out by compiler, etc.)
    */
-  resolveLocation(e, n) {
-    return this.locationResolved || (this.location = e.getUniformLocation(n, this.name), this.locationResolved = !0), this.location;
+  resolveLocation(e, t) {
+    return this.locationResolved || (this.location = e.getUniformLocation(t, this.name), this.locationResolved = !0), this.location;
   }
   /**
    * Invalidate cached location (call when program changes).
@@ -589,9 +609,9 @@ class k {
    * @param gl - WebGL context
    * @param program - Current WebGL program (for location resolution)
    */
-  upload(e, n) {
-    const t = this.resolveLocation(e, n);
-    if (t === null)
+  upload(e, t) {
+    const n = this.resolveLocation(e, t);
+    if (n === null)
       return;
     const i = this.value;
     let r;
@@ -599,31 +619,31 @@ class k {
       i.flat()
     ) : r = new Float32Array(i), this.method) {
       case "uniform1f":
-        e.uniform1f(t, r);
+        e.uniform1f(n, r);
         break;
       case "uniform1i":
-        e.uniform1i(t, r);
+        e.uniform1i(n, r);
         break;
       case "uniform1fv":
-        e.uniform1fv(t, r);
+        e.uniform1fv(n, r);
         break;
       case "uniform2fv":
-        e.uniform2fv(t, r);
+        e.uniform2fv(n, r);
         break;
       case "uniform3fv":
-        e.uniform3fv(t, r);
+        e.uniform3fv(n, r);
         break;
       case "uniform4fv":
-        e.uniform4fv(t, r);
+        e.uniform4fv(n, r);
         break;
       case "uniformMatrix2fv":
-        e.uniformMatrix2fv(t, !1, r);
+        e.uniformMatrix2fv(n, !1, r);
         break;
       case "uniformMatrix3fv":
-        e.uniformMatrix3fv(t, !1, r);
+        e.uniformMatrix3fv(n, !1, r);
         break;
       case "uniformMatrix4fv":
-        e.uniformMatrix4fv(t, !1, r);
+        e.uniformMatrix4fv(n, !1, r);
         break;
     }
   }
@@ -638,11 +658,11 @@ class w {
    */
   parse() {
     if (this.parsed) return this.parsed;
-    const e = this.detectVersion(), n = this.detectImports(), t = this.detectUniforms(), i = this.detectFunctions(t);
+    const e = this.detectVersion(), t = this.detectImports(), n = this.detectUniforms(), i = this.detectFunctions(n);
     return this.parsed = {
       version: e,
-      imports: n,
-      uniforms: t,
+      imports: t,
+      uniforms: n,
       functions: i
     };
   }
@@ -668,32 +688,32 @@ class w {
     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 = /* @__PURE__ */ new Set();
+    const e = /^[ \t]*#import\s+(\w+)(?:\s+as\s+(\w+))?\s+from\s+["'](.+)["']/gm, t = /^[ \t]*[^\w\s]?import\b/gm, n = [], i = /* @__PURE__ */ new Set();
     let r, s = 1, o = 0;
     for (; (r = e.exec(this.source)) !== null; ) {
       s += (this.source.substring(o, r.index).match(/\n/g) || []).length, o = r.index, i.add(s);
-      const f = r[1], c = r[2] || r[1], m = r[3];
-      if (t.some((p) => p.alias === c))
-        throw new H(c, s);
-      t.push({ name: f, alias: c, module: m, line: s });
+      const f = r[1], c = r[2] || r[1], d = r[3];
+      if (n.some((m) => m.alias === c))
+        throw new q(c, s);
+      n.push({ name: f, alias: c, module: d, line: s });
     }
     let l;
-    for (; (l = n.exec(this.source)) !== null; ) {
+    for (; (l = t.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 q(
+      throw new H(
         f,
         this.diagnoseImport(c)
       );
     }
-    return t;
+    return n;
   }
   diagnoseImport(e) {
-    const n = e.match(/^([^\w\s])import\b/);
-    if (n && n[1] !== "#")
-      return `Invalid prefix '${n[1]}'. Expected: #import <function> from '<module>'`;
+    const t = e.match(/^([^\w\s])import\b/);
+    if (t && t[1] !== "#")
+      return `Invalid prefix '${t[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))
@@ -703,64 +723,64 @@ class w {
     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>'`;
+      const n = e.split(/\s+/);
+      return `Missing 'from' clause. Expected: #import ${n[1]} as ${n[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]}'`;
+      const n = e.match(/from\s+(\S+)/);
+      return `Module name must be quoted. Expected: from '${n == null ? void 0 : n[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 s = t[1], o = t[2], l = t[3] ? parseInt(t[3], 10) : void 0;
-      n.push({ name: o, type: s, line: i, arrayNum: l });
+    const e = /^[ \t]*uniform\s+(?:(?:highp|mediump|lowp)\s+)?(\w+)\s+(\w+)(?:\[(\d+)\])?\s*;/gm, t = [];
+    let n, i = 1, r = 0;
+    for (; (n = e.exec(this.source)) !== null; ) {
+      i += (this.source.substring(r, n.index).match(/\n/g) || []).length, r = n.index;
+      const s = n[1], o = n[2], l = n[3] ? parseInt(n[3], 10) : void 0;
+      t.push({ name: o, type: s, line: i, arrayNum: l });
     }
-    return n;
+    return t;
   }
   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*\\{`,
+    const t = [], n = "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]*(${n})\\s+(\\w+)\\s*\\(([^)]*)\\)\\s*\\{`,
       "gm"
     );
     let r;
     for (; (r = i.exec(this.source)) !== null; ) {
-      const s = r[1], o = r[2], l = r[3].trim(), f = r.index, c = (this.source.substring(0, f).match(/\n/g) || []).length + 1, m = this.source.indexOf("{", f), p = this.findClosingBrace(this.source, m);
-      if (p === -1) continue;
-      const g = this.source.slice(m, p + 1), T = this.parseParams(l), I = this.findFunctionCalls(g), P = this.findUniformCalls(g, e), B = this.findMentionCalls(g);
-      n.push({
+      const s = r[1], o = 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), m = this.findClosingBrace(this.source, d);
+      if (m === -1) continue;
+      const v = this.source.slice(d, m + 1), I = this.parseParams(l), P = this.findFunctionCalls(v), $ = this.findUniformCalls(v, e), D = this.findMentionCalls(v);
+      t.push({
         name: o,
         type: s,
-        params: T,
-        body: g,
-        dependencies: [...I, ...P, ...B],
+        params: I,
+        body: v,
+        dependencies: [...P, ...$, ...D],
         line: c
       });
     }
-    return n;
+    return t;
   }
   parseParams(e) {
     if (!e.trim()) return [];
-    const n = [], t = e.split(",");
-    for (const i of t) {
+    const t = [], n = e.split(",");
+    for (const i of n) {
       const r = i.trim();
       if (!r) continue;
       const o = r.replace(/\b(in|out|inout|const|highp|mediump|lowp)\b\s*/g, "").trim().match(/^(\w+)\s+(\w+)(?:\[\d*\])?$/);
-      o && n.push({
+      o && t.push({
         type: o[1],
         name: o[2]
       });
     }
-    return n;
+    return t;
   }
-  findClosingBrace(e, n) {
-    let t = 0, i = !1, r = !1, s = !1, o = !1;
-    for (let l = n; l < e.length; l++) {
-      const f = e[l], c = e[l + 1], m = e[l - 1];
+  findClosingBrace(e, t) {
+    let n = 0, i = !1, r = !1, s = !1, o = !1;
+    for (let l = t; l < e.length; l++) {
+      const f = e[l], c = e[l + 1], d = e[l - 1];
       if (!r && !o && f === "/" && c === "/") {
         s = !0;
         continue;
@@ -779,14 +799,14 @@ class w {
         continue;
       }
       if (!(s || o)) {
-        if (f === '"' && m !== "\\") {
+        if (f === '"' && d !== "\\") {
           r = !r;
           continue;
         }
         if (!r) {
           if (f === "{")
-            t++, i = !0;
-          else if (f === "}" && (t--, i && t === 0))
+            n++, i = !0;
+          else if (f === "}" && (n--, i && n === 0))
             return l;
         }
       }
@@ -794,7 +814,7 @@ class w {
     return -1;
   }
   findFunctionCalls(e) {
-    const n = [], t = /* @__PURE__ */ new Set([
+    const t = [], n = /* @__PURE__ */ new Set([
       "if",
       "else",
       "for",
@@ -810,43 +830,43 @@ class w {
     let r;
     for (; (r = i.exec(e)) !== null; ) {
       const s = r[1];
-      t.has(s) || n.push({
+      n.has(s) || t.push({
         name: s,
         type: "function",
         index: r.index
       });
     }
-    return n;
+    return t;
   }
-  findUniformCalls(e, n) {
-    const t = [];
-    for (const i of n) {
+  findUniformCalls(e, t) {
+    const n = [];
+    for (const i of t) {
       const r = new RegExp(`\\b${i.name}\\b`, "g");
       let s;
       for (; (s = r.exec(e)) !== null; )
-        t.push({
+        n.push({
           name: i.name,
           type: "uniform",
           index: s.index
         });
     }
-    return t;
+    return n;
   }
   findMentionCalls(e) {
-    const n = [], t = /@(\w+)\.([a-zA-Z_]\w*)/g;
+    const t = [], n = /@(\w+)\.([a-zA-Z_]\w*)/g;
     let i;
-    for (; (i = t.exec(e)) !== null; ) {
+    for (; (i = n.exec(e)) !== null; ) {
       const r = i[1], s = i[2];
-      n.push({
+      t.push({
         name: `${r}.${s}`,
         type: "mention",
         index: i.index
       });
     }
-    return n;
+    return t;
   }
 }
-class F {
+class C {
   constructor(e) {
     /** Flag to track if the shader has been compiled */
     a(this, "isCompiled", !1);
@@ -883,45 +903,45 @@ class F {
   /**
    * Compile the shader source, resolving all imports
    */
-  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);
+  compile(e) {
+    return this.isCompiled ? this.compiled.source : (this.original.parse().imports.length > 0 && this.processImports(e), this.compiled.setSource(this.build()), this.isCompiled = !0, this.compiled.source);
   }
   /**
    * Process all #import directives
    */
-  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]
+  processImports(e) {
+    const t = this.original.parse(), n = t.functions.flatMap((i) => i.dependencies.filter((r) => r.type === "mention").map((r) => ({
+      name: r.name.split(".")[0],
+      uniform: r.name.split(".")[1]
     })));
-    for (const t of e.imports) {
-      const i = b.resolve(t.module), r = i.extract(t.name);
-      let s = n.filter(
-        (l) => l.name === r.function.name
+    for (const i of t.imports) {
+      const r = b.resolve(i.module), s = r.extract(i.name);
+      let o = n.filter(
+        (f) => f.name === s.function.name
       );
-      if (s.length > 0) {
-        const l = i.getDefinition().uniforms;
-        if (s = s.filter((f) => {
-          const c = l.find(
-            (m) => m.name === `u_${f.uniform}` || m.name === f.uniform
+      if (o.length > 0) {
+        const f = r.getDefinition().uniforms;
+        if (o = o.filter((c) => {
+          const d = f.find(
+            (m) => m.name === `u_${c.uniform}` || m.name === c.uniform
           );
-          if (c) {
-            r.dependencies.uniforms.some(
-              (p) => p.name === c.name
-            ) || r.dependencies.uniforms.push(c);
-            const m = n.indexOf(f);
+          if (d) {
+            s.dependencies.uniforms.some(
+              (v) => v.name === d.name
+            ) || s.dependencies.uniforms.push(d);
+            const m = n.indexOf(c);
             return m > -1 && n.splice(m, 1), !1;
           }
           return !0;
-        }), s.length > 0)
+        }), o.length > 0)
           throw new Z(
-            t.module,
-            r.function.name,
-            s[0].uniform
+            i.module,
+            s.function.name,
+            o[0].uniform
           );
       }
-      const o = i.copy();
-      this.processExtraction(r, t.alias, o.options), y.merge(t.module, o);
+      const l = r.copy();
+      this.processExtraction(s, i.alias, l.options), e == null || e.merge(i.module, l);
     }
     if (n.length > 0)
       throw new ee(
@@ -932,17 +952,17 @@ class F {
   /**
    * Process an extraction: rewrite names and collect as requirements
    */
-  processExtraction(e, n, t = {}) {
-    const i = e.function, r = Math.random().toString(36).substring(2, 8), s = `${n}_${r}`;
+  processExtraction(e, t, n = {}) {
+    const i = e.function, r = Math.random().toString(36).substring(2, 8), s = `${t}_${r}`;
     for (let l = e.dependencies.functions.length - 1; l >= 0; l--) {
-      const f = e.dependencies.functions[l], c = this.rewriteFunction(f, n, {
+      const f = e.dependencies.functions[l], c = this.rewriteFunction(f, t, {
         uniforms: e.dependencies.uniforms,
         functions: e.dependencies.functions,
         unique: s
       });
       this.requirements.functions.set(c.name, c);
     }
-    const o = this.rewriteFunction(i, n, {
+    const o = this.rewriteFunction(i, t, {
       uniforms: e.dependencies.uniforms,
       functions: e.dependencies.functions,
       rename: !0,
@@ -955,21 +975,21 @@ class F {
         ...l,
         name: `${s}_${l.name}${l.arrayNum ? `[${l.arrayNum}]` : ""}`
       };
-      if (t[i.name]) {
-        const c = Object.entries(t[i.name]).find(
-          ([m, p]) => p.uniform === l.name
+      if (n[i.name]) {
+        const c = Object.entries(n[i.name]).find(
+          ([d, m]) => m.uniform === l.name
         );
         c && (c[1].uniform = `${s}_${l.name}`);
       }
       this.requirements.uniforms.set(f.name, f);
     }
-    t[i.name] && n !== i.name && (t[n] = t[i.name], delete t[i.name]);
+    n[i.name] && t !== i.name && (n[t] = n[i.name], delete n[i.name]);
   }
   /**
    * Rewrite a function: namespace all uniform and helper function references
    */
-  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)), s = [], o = t.unique ? t.unique : n;
+  rewriteFunction(e, t, n = { rename: !1, uniforms: [], functions: [], unique: "" }) {
+    const i = new Set(n.uniforms.map((c) => c.name)), r = new Set(n.functions.map((c) => c.name)), s = [], o = n.unique ? n.unique : t;
     for (const c of e.dependencies)
       if (c.index !== void 0)
         if (c.type === "uniform" && i.has(c.name)) {
@@ -984,7 +1004,7 @@ class F {
           oldText: c.name,
           newText: `${o}_${c.name}`
         });
-    const l = this.applyRewrites(e.body, s), f = t.rename ? n : `${o}_${e.name}`;
+    const l = this.applyRewrites(e.body, s), f = n.rename ? t : `${o}_${e.name}`;
     return {
       ...e,
       name: f,
@@ -994,10 +1014,10 @@ class F {
   /**
    * Apply rewrite operations to a string, processing from end to start
    */
-  applyRewrites(e, n) {
-    const t = [...n].sort((r, s) => s.index - r.index);
+  applyRewrites(e, t) {
+    const n = [...t].sort((r, s) => s.index - r.index);
     let i = e;
-    for (const r of t)
+    for (const r of n)
       i = i.slice(0, r.index) + r.newText + i.slice(r.index + r.oldText.length);
     return i;
   }
@@ -1006,46 +1026,46 @@ class F {
    */
   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), s = this.generateFunctionCode();
-    return s && (n = n.slice(0, r) + s + 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(
+    let t = this.original.source;
+    t = this.removeImportLines(t, e);
+    const n = this.findInsertionPointForUniforms(t), i = this.generateUniformsCode();
+    i && (t = t.slice(0, n) + i + `
+` + t.slice(n));
+    const r = this.findInsertionPointForFunctions(t), s = this.generateFunctionCode();
+    return s && (t = t.slice(0, r) + s + t.slice(r)), t = t.replace(/\n{3,}/g, `
+`), t = this.replaceMentions(t, e), t;
+  }
+  replaceMentions(e, t) {
+    let n = e;
+    const i = t.functions.filter(
       (r) => r.dependencies.some((s) => s.type === "mention")
     );
     for (const r of i) {
       const s = r.dependencies.filter((o) => o.type === "mention");
       for (const o of s) {
-        const l = o.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;
+        const l = o.name.split("."), f = new RegExp(`\\b${l[0]}_(\\w+)_${l[1]}\\b`, "g"), c = this.requirements.uniforms.keys().find((m) => {
+          var v;
+          return ((v = m.match(f)) == null ? void 0 : v[0]) === m;
         });
         if (!c)
-          throw new ne(
+          throw new te(
             o.name,
             r.name
           );
-        const m = new RegExp(`@\\b${o.name}\\b`, "g");
-        t = t.replace(m, c);
+        const d = new RegExp(`@\\b${o.name}\\b`, "g");
+        n = n.replace(d, c);
       }
     }
-    return t;
+    return n;
   }
   /**
    * Remove #import lines from shader source
    */
-  removeImportLines(e, n) {
-    const t = e.split(`
-`), i = new Set(n.imports.map((r) => r.line));
-    return t.filter((r, s) => {
+  removeImportLines(e, t) {
+    const n = e.split(`
+`), i = new Set(t.imports.map((r) => r.line));
+    return n.filter((r, s) => {
       const o = i.has(s + 1);
       if (!o && r.trim() === "" && s > 0) {
         const l = s - 1;
@@ -1060,13 +1080,13 @@ class F {
    * Find insertion point for uniforms (after existing uniforms)
    */
   findInsertionPointForUniforms(e) {
-    const n = new w(e).parse(), t = n.uniforms.find(
-      (o) => o.line === Math.max(...n.uniforms.map((l) => l.line ?? 0))
+    const t = new w(e).parse(), n = t.uniforms.find(
+      (o) => o.line === Math.max(...t.uniforms.map((l) => l.line ?? 0))
     ), i = e.split(`
 `);
     let r = 0;
-    if (t && t.line)
-      r = t.line;
+    if (n && n.line)
+      r = n.line;
     else
       for (let o = 0; o < i.length; o++) {
         const l = i[o].trim();
@@ -1090,15 +1110,15 @@ class F {
     return s;
   }
   findInsertionPointForFunctions(e) {
-    const n = new w(e).parse(), t = n.functions.find(
-      (o) => o.line === Math.min(...n.functions.map((l) => l.line ?? 1 / 0))
+    const t = new w(e).parse(), n = t.functions.find(
+      (o) => o.line === Math.min(...t.functions.map((l) => l.line ?? 1 / 0))
     ), i = e.split(`
 `);
     let r = 0;
-    if (t && t.line)
-      r = t.line - 2;
+    if (n && n.line)
+      r = n.line - 2;
     else
-      throw new W();
+      throw new z();
     let s = 0;
     for (let o = 0; o < r; o++)
       s += i[o].length + 1;
@@ -1110,8 +1130,8 @@ class F {
   generateUniformsCode() {
     const e = [];
     if (this.requirements.uniforms.size > 0)
-      for (const n of this.checkUniformsPresence())
-        e.push(`uniform ${n.type} ${n.name};`);
+      for (const t of this.checkUniformsPresence())
+        e.push(`uniform ${t.type} ${t.name};`);
     return e.length === 0 ? "" : e.join(`
 `) + `
 `;
@@ -1122,10 +1142,10 @@ class F {
   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(", ");
+      for (const t of this.checkFunctionsPresence()) {
+        const n = t.params.map((i) => `${i.type} ${i.name}`).join(", ");
         e.push(`
-${n.type} ${n.name}(${t}) ${n.body}`);
+${t.type} ${t.name}(${n}) ${t.body}`);
       }
     return e.length === 0 ? "" : e.join(`
 `) + `
@@ -1135,91 +1155,91 @@ ${n.type} ${n.name}(${t}) ${n.body}`);
    * Check which required uniforms are missing from the original shader
    */
   checkUniformsPresence() {
-    const e = this.original.parse(), n = [], t = this.requirements.uniforms;
-    for (const [i, r] of t) {
+    const e = this.original.parse(), t = [], n = this.requirements.uniforms;
+    for (const [i, r] of n) {
       const s = e.uniforms.find((o) => o.name === i);
       if (!s) {
-        n.push(r);
+        t.push(r);
         continue;
       }
       if (s.type !== r.type)
-        throw new C(
+        throw new T(
           "uniform",
           i,
           r.type,
           s.type
         );
     }
-    return n;
+    return t;
   }
   /**
    * Check which required functions are missing from the original shader
    */
   checkFunctionsPresence() {
-    const e = this.original.parse(), n = [], t = this.requirements.functions;
-    for (const [i, r] of t) {
+    const e = this.original.parse(), t = [], n = this.requirements.functions;
+    for (const [i, r] of n) {
       const s = e.functions.find((o) => o.name === i);
       if (!s) {
-        n.push(r);
+        t.push(r);
         continue;
       }
       if (s.type !== r.type)
-        throw new C(
+        throw new T(
           "function",
           i,
           r.type,
           s.type
         );
     }
-    return n;
+    return t;
   }
 }
-class v extends F {
-  constructor(n, t, i = {}) {
-    super(t);
+class g extends C {
+  constructor(t, n, i = {}) {
+    super(n);
     a(this, "name");
     a(this, "options", {});
-    this.name = n, this.options = this.resolveOptions(i);
+    this.name = t, 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)
+  resolveOptions(t) {
+    if (!(t != null && t.default)) return t || {};
+    const n = this.original.parse(), i = t.default;
+    for (const r of n.functions)
       if (!(r.name === "main" || r.name === "default"))
-        if (n[r.name]) {
-          const s = n[r.name];
+        if (t[r.name]) {
+          const s = t[r.name];
           for (const o in i)
             o in s || (s[o] = i[o]);
         } else
-          n[r.name] = { ...i };
-    return delete n.default, n || {};
+          t[r.name] = { ...i };
+    return delete t.default, t || {};
   }
   /**
    * Define a module with given name and source, and register it
    */
-  static define(n) {
-    const { name: t, source: i, options: r } = n;
-    if (t === "sandbox" || t.startsWith("sandbox/"))
-      throw new Q(t);
-    const s = new v(t, i, r);
-    if (b.has(t))
-      throw new J(t);
-    return b.register(t, s), s;
+  static define(t) {
+    const { name: n, source: i, options: r } = t;
+    if (n === "sandbox" || n.startsWith("sandbox/"))
+      throw new Q(n);
+    const s = new g(n, i, r);
+    if (b.has(n))
+      throw new J(n);
+    return b.register(n, s), s;
   }
   /**
    * Resolve a module by name from the registry, throwing an error if not found
    */
-  static resolve(n) {
-    return b.resolve(n);
+  static resolve(t) {
+    return b.resolve(t);
   }
   /**
    * Create a copy of the module. To unplug references to the original object.
    * Used when copying module to the runtime registry to allow independent runtime changes to options without affecting the original module definition.
    */
-  copy(n = "original") {
-    return new v(
+  copy(t = "original") {
+    return new g(
       this.name,
-      this[n].source,
+      this[t].source,
       JSON.parse(JSON.stringify(this.options))
     );
   }
@@ -1227,14 +1247,14 @@ class v extends F {
    * Merge options from another module into this one, without affecting the original module definition.
    * Used when merging imported modules into the runtime registry.
    */
-  merge(n) {
+  merge(t) {
     this.options = this.options || {};
-    const t = this.getDefinition().uniforms.map((i) => i.name);
-    for (const [i, r] of Object.entries(n.options ?? {}))
+    const n = this.getDefinition().uniforms.map((i) => i.name);
+    for (const [i, r] of Object.entries(t.options ?? {}))
       if (!this.options[i]) this.options[i] = r;
       else
         for (const [s, o] of Object.entries(r))
-          t.includes(o.uniform) || (this.options[i][s] = o);
+          n.includes(o.uniform) || (this.options[i][s] = o);
   }
   /**
    * Get the module definition
@@ -1242,34 +1262,34 @@ class v extends F {
   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 })),
+      methods: this.compiled.parse().functions.map((t) => t.name).filter((t) => t !== "main" && t !== "default"),
+      uniforms: this.compiled.parse().uniforms.map((t) => ({ name: t.name, type: t.type })),
       options: this.options
     };
   }
   /**
    * Extract a method with all its dependencies
    */
-  extract(n) {
-    if (this.compile(), n === "main")
+  extract(t) {
+    if (this.compile(), t === "main")
+      throw new Y(this.name);
+    if (t === "default")
       throw new K(this.name);
-    if (n === "default")
-      throw new X(this.name);
-    const t = this.compiled.parse(), i = t.functions.find((o) => o.name === n);
+    const n = this.compiled.parse(), i = n.functions.find((o) => o.name === t);
     if (!i)
-      throw new Y(this.name, n);
+      throw new X(this.name, t);
     const r = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Map();
     return this.collectDependencies({
       current: i,
       scope: {
-        functions: t.functions,
-        uniforms: t.uniforms
+        functions: n.functions,
+        uniforms: n.uniforms
       },
       collected: {
         functions: r,
         uniforms: s
       },
-      visited: /* @__PURE__ */ new Set([n])
+      visited: /* @__PURE__ */ new Set([t])
     }), {
       function: i,
       dependencies: {
@@ -1281,36 +1301,36 @@ class v extends F {
   /**
    * Recursively collect all function and uniform dependencies
    */
-  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({
+  collectDependencies(t) {
+    for (const n of t.current.dependencies)
+      if (n.type === "function") {
+        if (t.visited.has(n.name)) continue;
+        const i = t.scope.functions.find((r) => r.name === n.name);
+        i && (t.visited.add(n.name), t.collected.functions.set(n.name, i), this.collectDependencies({
           current: i,
           scope: {
-            functions: n.scope.functions,
-            uniforms: n.scope.uniforms
+            functions: t.scope.functions,
+            uniforms: t.scope.uniforms
           },
           collected: {
-            functions: n.collected.functions,
-            uniforms: n.collected.uniforms
+            functions: t.collected.functions,
+            uniforms: t.collected.uniforms
           },
-          visited: n.visited
+          visited: t.visited
         }));
-      } else if (t.type === "uniform") {
-        const i = n.scope.uniforms.find(
-          (r) => r.name === t.name
+      } else if (n.type === "uniform") {
+        const i = t.scope.uniforms.find(
+          (r) => r.name === n.name
         );
-        i && !n.collected.uniforms.has(t.name) && n.collected.uniforms.set(t.name, i);
+        i && !t.collected.uniforms.has(n.name) && t.collected.uniforms.set(n.name, i);
       }
   }
 }
-class V {
+class F {
   constructor(e = []) {
     a(this, "modules", /* @__PURE__ */ new Map());
-    e.forEach((n) => {
-      this.register(n.name, n);
+    e.forEach((t) => {
+      this.register(t.name, t);
     });
   }
   /**
@@ -1335,14 +1355,14 @@ class V {
    */
   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];
+    return this.modules.forEach((t) => {
+      const n = t.getDefinition();
+      if (n.options)
+        for (const i in n.options) {
+          const r = n.options[i];
           for (const s in r) {
             const o = r[s];
-            o.default !== void 0 && !t.uniforms.map((l) => l.name).includes(o.uniform) && (e[o.uniform] = o.default);
+            o.default !== void 0 && !n.uniforms.map((l) => l.name).includes(o.uniform) && (e[o.uniform] = o.default);
           }
         }
     }), e;
@@ -1351,33 +1371,33 @@ class V {
    * Resolve the options from the module definitions for a given function name.
    */
   resolveOptions(e) {
-    for (const n of this.modules.values())
-      if (n.options && n.options[e])
-        return n.options[e];
+    for (const t of this.modules.values())
+      if (t.options && t.options[e])
+        return t.options[e];
     return null;
   }
   /**
    * Register a new module in the registry.
    */
-  register(e, n) {
-    this.modules.set(e, n);
+  register(e, t) {
+    this.modules.set(e, t);
   }
   /**
    * Merge a module into the registry. If a module with the same name already exists, options will be merged together.
    */
-  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);
+  merge(e, t) {
+    if (!this.modules.has(e)) return this.register(e, t);
+    const n = this.modules.get(e);
+    n.merge(t), this.modules.set(e, n);
   }
   /**
    * Resolve a module by name. Throws an error if the module is not found.
    */
   resolve(e) {
-    const n = this.modules.get(e);
-    if (!n)
+    const t = this.modules.get(e);
+    if (!t)
       throw new j(e);
-    return n;
+    return t;
   }
   /**
    * Check if a module exists in the registry by name.
@@ -1401,8 +1421,8 @@ class V {
    * Load multiple modules into the registry at once.
    */
   load(e) {
-    e.forEach((n) => {
-      this.register(n.name, n);
+    e.forEach((t) => {
+      this.register(t.name, t);
     });
   }
   /**
@@ -2224,11 +2244,11 @@ vec3 arcade(vec3 color, vec2 uv, float intensity) {
 }
 void main() {}
-`, b = new V([
-  new v("sandbox", oe),
-  new v("sandbox/colors", ae),
-  new v("sandbox/time", le),
-  new v("sandbox/effects", ce, {
+`, b = new F([
+  new g("sandbox", oe),
+  new g("sandbox/colors", ae),
+  new g("sandbox/time", le),
+  new g("sandbox/effects", ce, {
     default: {
       intensity: { uniform: "u_intensity", default: 1 }
     },
@@ -2278,7 +2298,7 @@ void main() {}
       intensity: { uniform: "u_intensity", default: 1 }
     }
   }),
-  new v("sandbox/filters", ue, {
+  new g("sandbox/filters", ue, {
     default: {
       intensity: { uniform: "u_intensity", default: 1 }
     },
@@ -2307,7 +2327,7 @@ void main() {}
       intensity: { uniform: "u_intensity", default: 0.5 }
     }
   })
-]), y = new V(), E = /* @__PURE__ */ new Map([
+]), E = /* @__PURE__ */ new Map([
   ["u_resolution", "vec2"],
   ["u_time", "float"],
   ["u_delta", "float"],
@@ -2327,32 +2347,32 @@ class fe {
    */
   attachProgram(e) {
     this.program = e;
-    for (const n of this.uniforms.values())
-      n.invalidateLocation();
+    for (const t of this.uniforms.values())
+      t.invalidateLocation();
     return this;
   }
   /**
    * Set a uniform value.
    * Creates the uniform if it doesn't exist, updates if it does.
    */
-  set(e, n) {
-    const t = this.uniforms.get(e);
-    return t ? t.setValue(n) : this.uniforms.set(e, new k(e, n)), this;
+  set(e, t) {
+    const n = this.uniforms.get(e);
+    return n ? n.setValue(t) : this.uniforms.set(e, new M(e, t)), this;
   }
   /**
    * Set multiple uniforms at once.
    */
   setMany(e) {
-    for (const [n, t] of Object.entries(e))
-      this.set(n, t);
+    for (const [t, n] of Object.entries(e))
+      this.set(t, n);
     return this;
   }
   /**
    * Get current uniform value.
    */
   get(e) {
-    var n;
-    return (n = this.uniforms.get(e)) == null ? void 0 : n.getValue();
+    var t;
+    return (t = this.uniforms.get(e)) == null ? void 0 : t.getValue();
   }
   /**
    * Check if uniform exists.
@@ -2381,8 +2401,8 @@ class fe {
    * Upload only built-in uniforms (u_resolution, u_time, u_delta, u_mouse, u_frame).
    * Call this every frame with current values.
    */
-  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)
+  uploadBuiltIns(e, t, n) {
+    if (this.set("u_resolution", t), this.set("u_time", e.time), this.set("u_delta", e.delta), this.set("u_mouse", n), this.set("u_frame", e.frame), !this.program)
       return this;
     for (const i of E.keys()) {
       const r = this.uniforms.get(i);
@@ -2415,7 +2435,207 @@ class fe {
     return this.uniforms.size;
   }
 }
-class O {
+class x {
+  constructor(e, t, n, i) {
+    a(this, "name");
+    a(this, "gl");
+    a(this, "texture", null);
+    a(this, "location", null);
+    a(this, "locationResolved", !1);
+    a(this, "source");
+    a(this, "options");
+    a(this, "dynamicOverride");
+    a(this, "needsUpload", !0);
+    a(this, "needsReupload", !1);
+    this.gl = e, this.name = t, this.source = n, this.dynamicOverride = i == null ? void 0 : i.dynamic, this.options = x.resolveOptions(n, i), this.needsReupload = this.options.dynamic;
+  }
+  /**
+   * Update the texture source.
+   * Marks texture for re-upload on next bind.
+   * Respects the original `dynamic` option if explicitly set, otherwise re-infers from source type.
+   */
+  setSource(e) {
+    this.source = e, this.needsUpload = !0, this.needsReupload = this.dynamicOverride ?? x.isDynamicSource(e);
+  }
+  /**
+   * Resolve and cache uniform location from program.
+   * Returns null if the sampler uniform doesn't exist in the shader.
+   */
+  resolveLocation(e, t) {
+    return this.locationResolved || (this.location = e.getUniformLocation(t, this.name), this.locationResolved = !0), this.location;
+  }
+  /**
+   * Invalidate cached location (call when program changes).
+   */
+  invalidateLocation() {
+    this.location = null, this.locationResolved = !1;
+  }
+  /**
+   * Bind texture to a texture unit and set the sampler uniform.
+   * @param program - Current WebGL program (for location resolution)
+   * @param unit - Texture unit index (0, 1, 2, ...)
+   */
+  upload(e, t) {
+    const n = this.gl, i = this.resolveLocation(n, e);
+    if (i !== null) {
+      if (!this.texture) {
+        if (this.texture = n.createTexture(), !this.texture) return;
+        this.needsUpload = !0;
+      }
+      n.activeTexture(n.TEXTURE0 + t), n.bindTexture(n.TEXTURE_2D, this.texture), (this.needsUpload || this.needsReupload) && (this.uploadPixels(), this.needsUpload = !1), n.uniform1i(i, t);
+    }
+  }
+  /**
+   * Cleanup WebGL texture resource.
+   */
+  destroy() {
+    this.texture && (this.gl.deleteTexture(this.texture), this.texture = null), this.location = null, this.locationResolved = !1;
+  }
+  /**
+   * Upload pixel data from source and apply texture parameters.
+   */
+  uploadPixels() {
+    const e = this.gl;
+    e.pixelStorei(e.UNPACK_FLIP_Y_WEBGL, this.options.flipY), e.texImage2D(
+      e.TEXTURE_2D,
+      0,
+      e.RGBA,
+      e.RGBA,
+      e.UNSIGNED_BYTE,
+      this.source
+    ), this.applyParameters();
+  }
+  /**
+   * Apply texture wrap and filter parameters.
+   */
+  applyParameters() {
+    const e = this.gl;
+    e.texParameteri(
+      e.TEXTURE_2D,
+      e.TEXTURE_WRAP_S,
+      x.resolveWrap(e, this.options.wrapS)
+    ), e.texParameteri(
+      e.TEXTURE_2D,
+      e.TEXTURE_WRAP_T,
+      x.resolveWrap(e, this.options.wrapT)
+    ), e.texParameteri(
+      e.TEXTURE_2D,
+      e.TEXTURE_MIN_FILTER,
+      this.options.minFilter === "nearest" ? e.NEAREST : e.LINEAR
+    ), e.texParameteri(
+      e.TEXTURE_2D,
+      e.TEXTURE_MAG_FILTER,
+      this.options.magFilter === "nearest" ? e.NEAREST : e.LINEAR
+    );
+  }
+  /**
+   * Resolve wrap mode string to WebGL constant.
+   */
+  static resolveWrap(e, t) {
+    switch (t) {
+      case "repeat":
+        return e.REPEAT;
+      case "mirror":
+        return e.MIRRORED_REPEAT;
+      case "clamp":
+      default:
+        return e.CLAMP_TO_EDGE;
+    }
+  }
+  /**
+   * Resolve texture options with defaults.
+   */
+  static resolveOptions(e, t) {
+    const n = (t == null ? void 0 : t.wrap) ?? "clamp";
+    return {
+      wrap: n,
+      wrapS: (t == null ? void 0 : t.wrapS) ?? n,
+      wrapT: (t == null ? void 0 : t.wrapT) ?? n,
+      minFilter: (t == null ? void 0 : t.minFilter) ?? "linear",
+      magFilter: (t == null ? void 0 : t.magFilter) ?? "linear",
+      flipY: (t == null ? void 0 : t.flipY) ?? !0,
+      dynamic: (t == null ? void 0 : t.dynamic) ?? x.isDynamicSource(e)
+    };
+  }
+  /**
+   * Check if a source is dynamic (needs re-upload every frame).
+   */
+  static isDynamicSource(e) {
+    return e instanceof HTMLVideoElement;
+  }
+}
+class he {
+  constructor(e) {
+    a(this, "gl");
+    a(this, "program", null);
+    a(this, "textures", /* @__PURE__ */ new Map());
+    this.gl = e;
+  }
+  /**
+   * Attach to a WebGL program.
+   * Invalidates all cached locations since they're program-specific.
+   */
+  attachProgram(e) {
+    this.program = e;
+    for (const t of this.textures.values())
+      t.invalidateLocation();
+    return this;
+  }
+  /**
+   * Set a texture.
+   * Creates the texture entry if it doesn't exist, updates source if it does.
+   */
+  set(e, t, n) {
+    const i = this.textures.get(e);
+    return i ? i.setSource(t) : this.textures.set(e, new x(this.gl, e, t, n)), this;
+  }
+  /**
+   * Get a texture by name.
+   */
+  get(e) {
+    return this.textures.get(e);
+  }
+  /**
+   * Check if a texture exists.
+   */
+  has(e) {
+    return this.textures.has(e);
+  }
+  /**
+   * Remove a texture and free its GPU resources.
+   */
+  delete(e) {
+    const t = this.textures.get(e);
+    return t ? (t.destroy(), this.textures.delete(e)) : !1;
+  }
+  /**
+   * Upload all textures to their respective texture units.
+   * Units are assigned sequentially (0, 1, 2, ...).
+   */
+  uploadAll() {
+    if (!this.program)
+      return this;
+    let e = 0;
+    for (const t of this.textures.values())
+      t.upload(this.program, e), e++;
+    return this;
+  }
+  /**
+   * Get texture count.
+   */
+  get size() {
+    return this.textures.size;
+  }
+  /**
+   * Cleanup all textures.
+   */
+  destroy() {
+    for (const e of this.textures.values())
+      e.destroy();
+    this.textures.clear(), this.program = null;
+  }
+}
+class U {
   constructor() {
     a(this, "hooks", /* @__PURE__ */ new Map());
   }
@@ -2424,8 +2644,8 @@ class O {
   }
   /** Add a new hook, returns a removal function */
   add(e) {
-    const n = this.id();
-    return this.hooks.set(n, e), () => this.remove(n);
+    const t = this.id();
+    return this.hooks.set(t, e), () => this.remove(t);
   }
   /** Remove a hook by its ID */
   remove(e) {
@@ -2433,12 +2653,12 @@ class O {
   }
   /** Run all hooks with the given state */
   run(e) {
-    for (const [n, t] of this.hooks)
+    for (const [t, n] of this.hooks)
       try {
-        t(e) === !1 && this.remove(n);
+        n(e) === !1 && this.remove(t);
       } catch (i) {
         throw new ie(
-          n,
+          t,
           i instanceof Error ? i.message : String(i)
         );
       }
@@ -2447,29 +2667,31 @@ class O {
     this.hooks.clear();
   }
 }
-class M {
-  constructor(e, n) {
+class k {
+  constructor(e, t) {
     a(this, "canvas");
     a(this, "gl");
     a(this, "options");
-    a(this, "onBeforeHooks", new O());
-    a(this, "onAfterHooks", new O());
+    a(this, "onBeforeHooks", new U());
+    a(this, "onAfterHooks", new U());
     a(this, "_program");
     a(this, "_geometry");
     a(this, "_uniforms");
+    a(this, "_textures");
     a(this, "_clock");
     a(this, "_resolution", [1, 1]);
     a(this, "_mouse", [0, 0]);
     a(this, "_version", 1);
+    a(this, "_runtimeModules", new F());
     a(this, "playing", !1);
-    this.canvas = e, this.options = n, this.gl = this.initContext(), this.enableExtensions(), this._program = new se(this.gl), this._geometry = A.fullscreenQuad(this.gl), this._uniforms = new fe(this.gl), this._clock = new re(), 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);
+    this.canvas = e, this.options = t, this.gl = this.initContext(), this.enableExtensions(), this._program = new se(this.gl), this._geometry = A.fullscreenQuad(this.gl), this._uniforms = new fe(this.gl), this._textures = new he(this.gl), this._clock = new re(), 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);
   }
   /**
    * Factory method to create and setup WebGL instance.
    */
-  static setup(e, n) {
-    const t = new M(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;
+  static setup(e, t) {
+    const n = new k(e, t);
+    return t.vertex && t.fragment && n.shader(t.vertex, t.fragment), t.uniforms && n._uniforms.setMany(t.uniforms), t.textures && n.texturesFromSchema(t.textures), n._runtimeModules.isEmpty() || n._uniforms.setMany(n._runtimeModules.defaults()), n;
   }
   /**
    * Initialize WebGL context.
@@ -2483,13 +2705,13 @@ class M {
       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);
+    }, t = this.canvas.getContext("webgl2", e);
     if (t)
-      return this._version = 1, t;
-    const i = new z();
+      return this._version = 2, t;
+    const n = this.canvas.getContext("webgl", e);
+    if (n)
+      return this._version = 1, n;
+    const i = new G();
     throw this.options.onError(i), i;
   }
   /**
@@ -2501,8 +2723,8 @@ class M {
   /**
    * Set viewport dimensions.
    */
-  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;
+  viewport(e, t, n, i) {
+    return this.canvas.width = n, this.canvas.height = i, this.gl.viewport(e, t, n, i), this._resolution = [n, i], this;
   }
   /**
    * Set the clock time
@@ -2513,14 +2735,14 @@ class M {
   /**
    * Update mouse position.
    */
-  mouse(e, n) {
-    return this._mouse = [e, n], this;
+  mouse(e, t) {
+    return this._mouse = [e, t], this;
   }
   /**
    * Set a uniform value.
    */
-  uniform(e, n) {
-    return this._uniforms.set(e, n), this;
+  uniform(e, t) {
+    return this._uniforms.set(e, t), this;
   }
   /**
    * Set multiple uniforms.
@@ -2534,29 +2756,54 @@ class M {
   getUniform(e) {
     return this._uniforms.get(e);
   }
+  /**
+   * Set a texture.
+   */
+  texture(e, t, n) {
+    return this._textures.set(e, t, n), this;
+  }
+  /**
+   * Set multiple textures from a schema.
+   */
+  texturesFromSchema(e) {
+    for (const [t, n] of Object.entries(e))
+      if (n instanceof HTMLImageElement || n instanceof HTMLCanvasElement || n instanceof HTMLVideoElement || n instanceof ImageBitmap || n instanceof ImageData || n instanceof OffscreenCanvas)
+        this._textures.set(t, n);
+      else {
+        const { source: i, ...r } = n;
+        this._textures.set(t, i, r);
+      }
+    return this;
+  }
+  /**
+   * Remove a texture.
+   */
+  removeTexture(e) {
+    return this._textures.delete(e), this;
+  }
   /**
    * Compile and link shaders.
    * Errors are handled via onError callback, never thrown.
    */
-  shader(e, n) {
+  shader(e, t) {
     try {
-      if (y.clear(), e.version() !== n.version())
-        throw new G(
+      if (this._runtimeModules.clear(), e.version() !== t.version())
+        throw new W(
           e.version(),
-          n.version()
+          t.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);
+      this._program.compile(e.source(), t.compile(this._runtimeModules)), this._version = t.version(), this._geometry.linkAttributes(this._program);
+      const n = this._program.getProgram();
+      n && (this._uniforms.attachProgram(n), this._textures.attachProgram(n));
       try {
         this.options.onLoad();
       } catch (i) {
-        throw new te(
+        throw new ne(
           i instanceof Error ? i.message : String(i)
         );
       }
-    } catch (t) {
-      t instanceof h && this.options.onError(t);
+    } catch (n) {
+      n instanceof h && this.options.onError(n);
     }
     return this;
   }
@@ -2574,14 +2821,14 @@ class M {
     const e = this._clock.getState();
     try {
       this.onBeforeHooks.run(e);
-    } catch (n) {
-      n instanceof h && this.options.onError(n);
+    } catch (t) {
+      t instanceof h && this.options.onError(t);
     }
     this.playing = !1, this._clock.stop();
     try {
       this.onAfterHooks.run(e);
-    } catch (n) {
-      n instanceof h && this.options.onError(n);
+    } catch (t) {
+      t instanceof h && this.options.onError(t);
     }
     return this;
   }
@@ -2597,6 +2844,12 @@ class M {
   getContext() {
     return this.gl;
   }
+  /**
+   * Get registered runtime modules.
+   */
+  getUsingModules() {
+    return this._runtimeModules;
+  }
   /**
    * Get detected WebGL version.
    */
@@ -2613,30 +2866,30 @@ class M {
    * Cleanup all resources.
    */
   destroy() {
-    this.pause(), this._clock.destroy(), this._geometry.destroy(), this._program.destroy(), this._uniforms.destroy(), this.onAfterHooks.destroy(), this.onBeforeHooks.destroy(), y.clear();
+    this.pause(), this._clock.destroy(), this._geometry.destroy(), this._program.destroy(), this._uniforms.destroy(), this._textures.destroy(), this.onAfterHooks.destroy(), this.onBeforeHooks.destroy(), this._runtimeModules.clear();
   }
   /**
    * Internal render callback.
    */
   onRender(e) {
-    const n = this.gl;
+    const t = this.gl;
     try {
       this.onBeforeHooks.run(e);
-    } catch (t) {
-      t instanceof h && this.options.onError(t);
+    } catch (n) {
+      n instanceof h && this.options.onError(n);
     }
-    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();
+    t.clearColor(0, 0, 0, 0), t.clear(t.COLOR_BUFFER_BIT), this._program.use(), this._uniforms.uploadBuiltIns(e, this._resolution, this._mouse), this._uniforms.uploadAll(), this._textures.uploadAll(), this._geometry.bind(), this._geometry.draw();
     try {
       this.onAfterHooks.run(e);
-    } catch (t) {
-      t instanceof h && this.options.onError(t);
+    } catch (n) {
+      n instanceof h && this.options.onError(n);
     }
   }
 }
-class d extends F {
+class p extends C {
   constructor(e) {
-    super(e), E.forEach((n, t) => {
-      this.requirements.uniforms.set(t, { name: t, type: n, line: 0 });
+    super(e), E.forEach((t, n) => {
+      this.requirements.uniforms.set(n, { name: n, type: t, line: 0 });
     });
   }
 }
@@ -2667,7 +2920,7 @@ void main() {
   vec3 color = vec3(uv.x, uv.y, 0.5 + 0.5 * sin(u_time));
   gl_FragColor = vec4(color, 1.0);
 }
-`, U = `#version 300 es
+`, O = `#version 300 es
 in vec2 a_position;
 in vec2 a_texcoord;
@@ -2677,7 +2930,7 @@ out vec2 v_texcoord;
 void main() {
     v_texcoord = a_texcoord;
     gl_Position = vec4(a_position, 0.0, 1.0);
-}`, he = `#version 300 es
+}`, me = `#version 300 es
 precision highp float;
 uniform vec2 u_resolution;
@@ -2692,8 +2945,8 @@ void main() {
     vec3 color = vec3(uv.x, uv.y, 0.5 + 0.5 * sin(u_time));
     fragColor = vec4(color, 1.0);
 }`;
-class $ {
-  constructor(e, n) {
+class V {
+  constructor(e, t) {
     /** Active event listeners */
     a(this, "listeners", []);
     /** HTML canvas element */
@@ -2704,9 +2957,9 @@ class $ {
     a(this, "engine");
     /** User sets custom vertex shader */
     a(this, "usingCustomVertex", !1);
-    if (this.canvasEl = e, this.options = this.resolveOptions(n), this.engine = M.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);
+    if (this.canvasEl = e, this.options = this.resolveOptions(t), this.engine = k.setup(this.canvasEl, this.options), this.setupListeners(), this.setViewport(), this.options.modules)
+      for (const [n, i] of Object.entries(this.options.modules))
+        this.module(n, i);
     this.options.autoplay && this.play();
   }
   /**
@@ -2727,8 +2980,8 @@ class $ {
    *   autoplay: true,
    * });
    */
-  static create(e, n) {
-    return new $(e, n);
+  static create(e, t) {
+    return new V(e, t);
   }
   /**
    * Define a shader module that can be imported in shader source with `#import <function> from "module_name"`.
@@ -2740,8 +2993,8 @@ class $ {
    * //   myFunc();
    * // }
    */
-  static defineModule(e, n, t = {}) {
-    v.define({ name: e, source: n, options: t });
+  static defineModule(e, t, n = {}) {
+    g.define({ name: e, source: t, options: n });
   }
   /**
    * Get the list of available shader modules that can be used with `#import` in shader source.
@@ -2754,12 +3007,12 @@ class $ {
    * This is useful for debugging shader code or precompiling shaders for production use.
    */
   static compile(e) {
-    return new d(e).compile();
+    return new p(e).compile();
   }
   resolveOptions(e) {
-    const n = {
-      vertex: new d(S),
-      fragment: new d(L),
+    const t = {
+      vertex: new p(S),
+      fragment: new p(L),
       autoplay: !0,
       pauseWhenHidden: !0,
       dpr: "auto",
@@ -2779,45 +3032,46 @@ You can handle errors programmatically by providing an onError callback to suppr
       onBeforeRender: null,
       onAfterRender: null,
       uniforms: {},
-      modules: {}
+      modules: {},
+      textures: {}
     };
     if (e != null && e.vertex && (this.usingCustomVertex = !0), e != null && e.vertex && !(e != null && e.fragment)) {
-      n.vertex = new d(e.vertex);
-      const s = n.vertex.version();
-      n.fragment = new d(s === 2 ? he : L);
+      t.vertex = new p(e.vertex);
+      const s = t.vertex.version();
+      t.fragment = new p(s === 2 ? me : L);
     }
     if (e != null && e.fragment && !(e != null && e.vertex)) {
-      n.fragment = new d(e.fragment);
-      const s = n.fragment.version();
-      n.vertex = new d(s === 2 ? U : S);
+      t.fragment = new p(e.fragment);
+      const s = t.fragment.version();
+      t.vertex = new p(s === 2 ? O : S);
     }
-    e != null && e.vertex && (e != null && e.fragment) && (n.vertex = new d(e.vertex), n.fragment = new d(e.fragment));
-    const { vertex: t, fragment: i, ...r } = e || {};
-    return { ...n, ...r };
+    e != null && e.vertex && (e != null && e.fragment) && (t.vertex = new p(e.vertex), t.fragment = new p(e.fragment));
+    const { vertex: n, fragment: i, ...r } = e || {};
+    return { ...t, ...r };
   }
   setupListeners() {
     this.listeners.push(
       // Window resize
-      x.on(window, "resize", () => {
+      y.on(window, "resize", () => {
         this.setViewport();
       }),
       // Canvas resize
-      x.on(this.canvasEl, "resize", () => {
+      y.on(this.canvasEl, "resize", () => {
         this.setViewport();
       }),
       // Visibility check on scroll
       (() => {
         let e = !1;
-        return x.on(document, "scroll", (n) => {
+        return y.on(document, "scroll", (t) => {
           this.options.pauseWhenHidden && (this.isInViewport() ? e && !this.isPlaying() && (this.play(), e = !1) : this.isPlaying() && (this.pause(), e = !0));
         });
       })(),
       // Mouse tracking
-      x.on(document, "mousemove", (e) => {
+      y.on(document, "mousemove", (e) => {
         this.setMouse(e.clientX || e.pageX, e.clientY || e.pageY);
       }),
       // Touch tracking
-      x.on(document, "touchmove", (e) => {
+      y.on(document, "touchmove", (e) => {
         e.touches.length > 0 && this.setMouse(e.touches[0].clientX, e.touches[0].clientY);
       })
     );
@@ -2826,21 +3080,21 @@ You can handle errors programmatically by providing an onError callback to suppr
     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;
+    const e = this.options.dpr === "auto" ? Math.min(2, window.devicePixelRatio || 1) : this.options.dpr, t = this.canvasEl.clientWidth || this.canvasEl.width || 1, n = 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))
+      Math.max(1, Math.floor(t * e)),
+      Math.max(1, Math.floor(n * 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);
+  setMouse(e, t) {
+    const n = this.canvasEl.getBoundingClientRect();
+    e >= n.left && e <= n.right && t >= n.top && t <= n.bottom && this.engine.mouse(e - n.left, t - n.top);
   }
   /**
    * Set a single uniform value with type checking.
@@ -2849,8 +3103,8 @@ You can handle errors programmatically by providing an onError callback to suppr
    * sandbox.setUniform<number>("u_time", 1.5);
    * sandbox.setUniform<Vec3[]>("u_colors", [[1, 0, 0], [0, 1, 0]]);
    */
-  setUniform(e, n) {
-    return this.engine.uniform(e, n), this;
+  setUniform(e, t) {
+    return this.engine.uniform(e, t), this;
   }
   /**
    * Set multiple uniforms at once with type checking.
@@ -2875,13 +3129,41 @@ You can handle errors programmatically by providing an onError callback to suppr
   getUniform(e) {
     return this.engine.getUniform(e);
   }
+  /**
+   * Set a texture for a sampler2D uniform.
+   * @example
+   * sandbox.setTexture("u_texture", imageElement);
+   * sandbox.setTexture("u_texture", imageElement, { wrap: "repeat" });
+   */
+  setTexture(e, t, n) {
+    return this.engine.texture(e, t, n), this;
+  }
+  /**
+   * Set multiple textures at once.
+   * @example
+   * sandbox.setTextures({
+   *   u_texture: imageElement,
+   *   u_detail: { source: detailImg, wrap: "repeat" },
+   * });
+   */
+  setTextures(e) {
+    return this.engine.texturesFromSchema(e), this;
+  }
+  /**
+   * Remove a texture and free its GPU resources.
+   * @example
+   * sandbox.removeTexture("u_texture");
+   */
+  removeTexture(e) {
+    return this.engine.removeTexture(e), this;
+  }
   /**
    * Update shaders.
    * @example
    * sandbox.setShader(vertexSource, fragmentSource);
    */
-  setShader(e, n) {
-    return this.options.vertex = new d(e), this.options.fragment = new d(n), this.usingCustomVertex = !0, this.engine.shader(this.options.vertex, this.options.fragment), this;
+  setShader(e, t) {
+    return this.options.vertex = new p(e), this.options.fragment = new p(t), this.usingCustomVertex = !0, this.engine.shader(this.options.vertex, this.options.fragment), this;
   }
   /**
    * Update only fragment shader (uses default vertex).
@@ -2889,9 +3171,9 @@ You can handle errors programmatically by providing an onError callback to suppr
    * sandbox.setFragment(fragmentSource);
    */
   setFragment(e) {
-    const n = new d(e), t = n.version(), i = this.options.vertex.version();
-    return this.options.fragment = n, t !== i && (this.usingCustomVertex || (this.options.vertex = new d(
-      t === 2 ? U : S
+    const t = new p(e), n = t.version(), i = this.options.vertex.version();
+    return this.options.fragment = t, n !== i && (this.usingCustomVertex || (this.options.vertex = new p(
+      n === 2 ? O : S
     ))), this.engine.shader(this.options.vertex, this.options.fragment), this;
   }
   /**
@@ -2919,29 +3201,29 @@ You can handle errors programmatically by providing an onError callback to suppr
   /**
    * Add a runtime render hook.
    */
-  hook(e, n = "before") {
-    return n === "before" ? this.engine.onBeforeHooks.add(e) : this.engine.onAfterHooks.add(e);
+  hook(e, t = "before") {
+    return t === "before" ? this.engine.onBeforeHooks.add(e) : this.engine.onAfterHooks.add(e);
   }
   /**
    * Runtime configure the module behavior
    * @example
    * sandbox.module("my_module", { intensity: 0.5 });
    */
-  module(e, n) {
-    const t = y.resolveOptions(e);
-    if (!t)
+  module(e, t) {
+    const i = this.engine.getUsingModules().resolveOptions(e);
+    if (!i)
       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 s = t[i];
-      if (!s) {
+    for (const [r, s] of Object.entries(t)) {
+      const o = i[r];
+      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.`
+          `Sandbox: Option '${r}' not found for function '${e}'. Make sure to check available options with Sandbox.availableModules() and provide the correct option name.`
         );
         continue;
       }
-      this.setUniform(s.uniform, r);
+      this.setUniform(o.uniform, s);
     }
     return this;
   }
@@ -2967,8 +3249,8 @@ You can handle errors programmatically by providing an onError callback to suppr
    * Pause animation loop at specific time (in seconds).
    */
   pauseAt(e) {
-    const n = this.hook((t) => {
-      t.time >= e && (n(), this.pause());
+    const t = this.hook((n) => {
+      n.time >= e && (t(), this.pause());
     }, "after");
     return this;
   }
@@ -3018,6 +3300,57 @@ You can handle errors programmatically by providing an onError callback to suppr
   get canvas() {
     return this.canvasEl;
   }
+  /**
+   * Export current frame as a data URL string.
+   * Requires `preserveDrawingBuffer: true` if called while playing.
+   * @example
+   * const url = sandbox.renderAt(1.5).exportAsURL("image/png");
+   */
+  exportAsURL(e = "image/png", t) {
+    return this.canvas.toDataURL(e, t);
+  }
+  /**
+   * Export current frame as a Blob.
+   * Requires `preserveDrawingBuffer: true` if called while playing.
+   * @example
+   * const blob = await sandbox.renderAt(1.5).exportAsBlob("image/png");
+   */
+  exportAsBlob(e = "image/png", t) {
+    return new Promise((n, i) => {
+      this.canvas.toBlob(
+        (r) => {
+          r ? n(r) : i(new Error("Failed to create blob from canvas."));
+        },
+        e,
+        t
+      );
+    });
+  }
+  /**
+   * Export current frame as an HTMLImageElement.
+   * Requires `preserveDrawingBuffer: true` if called while playing.
+   * @example
+   * const img = sandbox.renderAt(1.5).exportAsImage("image/png");
+   * img.onload = () => document.body.appendChild(img);
+   */
+  exportAsImage(e = "image/png", t) {
+    const n = new Image();
+    return n.src = this.exportAsURL(e, t), n;
+  }
+  /**
+   * Capture the canvas as a MediaStream for video calls or recording.
+   * @example
+   * // WebRTC video call
+   * const stream = sandbox.stream(30);
+   * peerConnection.addTrack(stream.getVideoTracks()[0], stream);
+   *
+   * @example
+   * // Record to video file
+   * const recorder = new MediaRecorder(sandbox.stream(30));
+   */
+  stream(e) {
+    return this.canvasEl.captureStream(e);
+  }
   /**
    * Destroy sandbox and release all resources.
    * @example
@@ -3030,26 +3363,28 @@ You can handle errors programmatically by providing an onError callback to suppr
   }
 }
 export {
-  $ as Sandbox,
-  X as SandboxAttemptedToImportDefaultFunctionError,
-  K as SandboxAttemptedToImportMainFunctionError,
-  de as SandboxContextCreationError,
+  V as Sandbox,
+  K as SandboxAttemptedToImportDefaultFunctionError,
+  Y as SandboxAttemptedToImportMainFunctionError,
+  pe as SandboxContextCreationError,
   h as SandboxError,
   Q as SandboxForbiddenModuleNameError,
   _ as SandboxGLSLShaderCompilationError,
-  ne as SandboxMentionCouldNotBeReplacedError,
+  te as SandboxMentionCouldNotBeReplacedError,
   ee as SandboxMentionFunctionNotFoundError,
   Z as SandboxMentionUniformNotFoundError,
-  Y as SandboxModuleMethodNotFoundError,
+  X as SandboxModuleMethodNotFoundError,
   j as SandboxModuleNotFoundError,
   ie as SandboxOnHookCallbackError,
-  te as SandboxOnLoadCallbackError,
+  ne as SandboxOnLoadCallbackError,
   J as SandboxOverwriteModuleError,
   R as SandboxProgramError,
-  H as SandboxShaderDuplicateImportNameError,
-  q as SandboxShaderImportSyntaxError,
-  C as SandboxShaderRequirementMismatchError,
-  G as SandboxShaderVersionMismatchError,
-  W as SandboxShaderWithoutFunctionError,
-  z as SandboxWebGLNotSupportedError
+  q as SandboxShaderDuplicateImportNameError,
+  H as SandboxShaderImportSyntaxError,
+  T as SandboxShaderRequirementMismatchError,
+  W as SandboxShaderVersionMismatchError,
+  z as SandboxShaderWithoutFunctionError,
+  ve as SandboxTextureCreationError,
+  ge as SandboxTextureUnitLimitError,
+  G as SandboxWebGLNotSupportedError
 };