vireglass 2.2.0 → 2.3.1

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import { V as VireGlassOptics } from './material-CnUmdKg1.cjs';
 export { A as ADAPT_RADIUS, b as ALL_EFFECTS_ON, D as DEBUG_MODES, E as EFFECTS, L as LEGACY_NAMES, c as LEGACY_OPTICS, d as LegacyOpticsName, M as MATERIAL_PRESETS, e as MATERIAL_RANGES, f as MaterialPresetName, P as PRESET_NAMES, g as PRODUCT_DIM, h as VIREGLASS_CLEAR_MATERIAL, i as VIREGLASS_CONTROL_MATERIAL, j as VIREGLASS_LYRICS_MATERIAL, k as VIREGLASS_MATERIAL, l as VIREGLASS_MATERIAL_V4, m as VIREGLASS_MATERIAL_V5, n as VIREGLASS_SHEET_MATERIAL, o as VireGlassDebugMode, p as VireGlassEffect, a as VireGlassMaterial, q as VireGlassNumericKey, r as VireGlassTint, s as VireGlassToggles, t as activeMaterial, u as applyToggles, v as debugIndex, w as materialForInk, x as resolveMaterial, y as resolveOptics } from './material-CnUmdKg1.cjs';
 export { M as MAX_BEVEL_FRACTION, a as MAX_STRETCH, R as RIM_FRACTION, V as VireGlassGeometry, b as bevelDp, c as bevelFraction, d as capsuleGeometry, e as circleGeometry, h as halfMinDp, l as lensPadDp, m as morphReachDp, r as rimDp, f as roundedRectGeometry, s as shadowOpacity, g as shadowOpacityFrom, i as shadowReachDp, j as sizeDp, k as sizeGain, n as surfacePadDp, t as thicknessDp } from './geometry-RhKd7CM5.cjs';
-import { V as VireGlassAccent } from './adapters-DugC6Qri.cjs';
-export { A as ACCENT_AMOUNT, D as DYNAMIC_UNIFORMS, I as ICON_UNIFORMS, O as OVERLAY_UNIFORMS, R as REST_LIGHT, S as SURFACE_LENGTH_UNIFORMS, a as SurfaceUniforms, b as VireGlassMorph, c as VireGlassTouch, l as lensMagnify, m as morphBetween, d as morphOutOf, t as toDeviceSurfaceUniforms, e as toLensProps, f as toSurfaceUniforms } from './adapters-DugC6Qri.cjs';
+import { V as VireGlassAccent } from './adapters-BOPIRMnL.cjs';
+export { A as ACCENT_AMOUNT, D as DYNAMIC_UNIFORMS, I as ICON_UNIFORMS, O as OVERLAY_UNIFORMS, R as REST_LIGHT, S as SURFACE_LENGTH_UNIFORMS, a as SurfaceUniforms, b as VireGlassMorph, c as VireGlassTouch, l as lensMagnify, m as morphBetween, d as morphOutOf, t as toDeviceSurfaceUniforms, e as toLensProps, f as toSurfaceUniforms } from './adapters-BOPIRMnL.cjs';
 export { a as GRADIENT, b as GroupDecision, c as GroupMember, G as GroupPlane, d as GroupSink, e as GroupState, M as MorphShape, N as NO_ACCESSIBILITY, f as SCROLL_EDGE_ENGAGE_DP, g as SETTLE, h as SMOOTH, S as ScrollEdgeStyle, T as TouchWarp, i as VG_FALLOFF, j as VG_SDF, V as VireGlassAccessibility, k as aggregate, l as applyAccessibility, m as contrastRimLuma, n as createGroupState, o as elasticAllowed, p as neckToBridge, q as probeValuesAt, s as sceneDistance, r as sceneGradient, t as scrollEdgeReachDp, u as scrollEdgeStrength, v as scrollEdgeStyle, w as sdfRoundedRect, x as sdfRoundedRectGradient, y as smin, z as smoothPlane, A as touchWarp } from './group-model-DwtixGhG.cjs';
 export { B as BackdropSample, C as CONFIRMATIONS, F as FADE_MS, a as FLIP_LUMA, I as INK_DARK, b as INK_LIGHT, R as RETURN_LUMA, c as ambientFrom, d as decisiveLuma, s as shouldInkBeLight } from './adaptation-BSbbdExK.cjs';
 
@@ -275,11 +275,16 @@ declare function convertShaderUniforms(src: string): string;
  * parentheses inside.
  */
 declare function convertEvalCalls(src: string): string;
+/** Comments are prose, and the rewrites here are regexes over raw text: a comment mentioning
+ *  "return" became one, and a brace in a comment ended the entry point early. Newlines inside
+ *  block comments survive, so a compile error still points at the source line. */
+declare function stripComments(src: string): string;
 /**
  * Early `return <expression>;` inside `main` → `fragColor = <expression>; return;`. Takes ONLY
  * the body of main (see `convertEntryPoint`) — ordinary `return`s in helper functions live
  * outside this text and are untouched. Expressions never contain a `;` of their own (shaders have
- * none — the only `;` lives inside `for(...)`, which isn't a return), so `[^;]+` is safe.
+ * none — the only `;` lives inside `for(...)`, which isn't a return), so `[^;]+` is safe once
+ * comments are gone (`stripComments`).
  */
 declare function convertReturns(mainBody: string): string;
 /**
@@ -288,6 +293,10 @@ declare function convertReturns(mainBody: string): string;
  * origin, y up. The flip via `u_resolution.y - gl_FragCoord.y` restores the original convention
  * (both coordinate systems center the pixel at `+0.5`, so no X shift or constant is needed).
  * `out vec4 fragColor` and `uniform vec2 u_resolution` are declared in the prologue (`addPrologue`).
+ *
+ * `xy` and `.eval()` are flipped together — but only inside a shader THIS function translates. A
+ * `VireGlassBackdropPass` (`web/renderer.ts`) that reads its own previous frame from an FBO is raw
+ * `gl_FragCoord`, unflipped; reusing AGSL-style helpers there needs an explicit flip of its own.
  */
 declare function convertEntryPoint(src: string): string;
 /** `#version 300 es` + `precision highp float;` — no equivalent in AGSL, WebGL2 requires them as
@@ -300,4 +309,4 @@ declare function addPrologue(src: string): string;
  *  found. */
 declare function toGLSL(shaderSource: string): string;
 
-export { type DeformOptions, type DeformSample, FRESNEL_EXPONENT, GLASS_SCALE_DEFAULT, LENS_SHADER, SURFACE_SHADER, type ShapeParent, type ShapeSpec, VireGlassAccent, VireGlassOptics, absorption, accentAmount, accentTone, addPrologue, applyAppear, applyGlassScale, blur, bodyDensity, colorPickup, concentricFit, concentricInset, concentricRadius, convertEntryPoint, convertEvalCalls, convertHalfTypes, convertReturns, convertShaderUniforms, convertVecTypes, createDeform, diffraction, dispersion, edgeDensity, edgeLight, fresnelF0, fresnelStrength, gatherRadius, iorSpread, iridescence, mediumTint, raiseIntoGlass, refractionScale, refractionStrength, resolveShape, shadowTint, specularPower, specularStrength, toAGSL, toGLSL };
+export { type DeformOptions, type DeformSample, FRESNEL_EXPONENT, GLASS_SCALE_DEFAULT, LENS_SHADER, SURFACE_SHADER, type ShapeParent, type ShapeSpec, VireGlassAccent, VireGlassOptics, absorption, accentAmount, accentTone, addPrologue, applyAppear, applyGlassScale, blur, bodyDensity, colorPickup, concentricFit, concentricInset, concentricRadius, convertEntryPoint, convertEvalCalls, convertHalfTypes, convertReturns, convertShaderUniforms, convertVecTypes, createDeform, diffraction, dispersion, edgeDensity, edgeLight, fresnelF0, fresnelStrength, gatherRadius, iorSpread, iridescence, mediumTint, raiseIntoGlass, refractionScale, refractionStrength, resolveShape, shadowTint, specularPower, specularStrength, stripComments, toAGSL, toGLSL };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { V as VireGlassOptics } from './material-CnUmdKg1.js';
 export { A as ADAPT_RADIUS, b as ALL_EFFECTS_ON, D as DEBUG_MODES, E as EFFECTS, L as LEGACY_NAMES, c as LEGACY_OPTICS, d as LegacyOpticsName, M as MATERIAL_PRESETS, e as MATERIAL_RANGES, f as MaterialPresetName, P as PRESET_NAMES, g as PRODUCT_DIM, h as VIREGLASS_CLEAR_MATERIAL, i as VIREGLASS_CONTROL_MATERIAL, j as VIREGLASS_LYRICS_MATERIAL, k as VIREGLASS_MATERIAL, l as VIREGLASS_MATERIAL_V4, m as VIREGLASS_MATERIAL_V5, n as VIREGLASS_SHEET_MATERIAL, o as VireGlassDebugMode, p as VireGlassEffect, a as VireGlassMaterial, q as VireGlassNumericKey, r as VireGlassTint, s as VireGlassToggles, t as activeMaterial, u as applyToggles, v as debugIndex, w as materialForInk, x as resolveMaterial, y as resolveOptics } from './material-CnUmdKg1.js';
 export { M as MAX_BEVEL_FRACTION, a as MAX_STRETCH, R as RIM_FRACTION, V as VireGlassGeometry, b as bevelDp, c as bevelFraction, d as capsuleGeometry, e as circleGeometry, h as halfMinDp, l as lensPadDp, m as morphReachDp, r as rimDp, f as roundedRectGeometry, s as shadowOpacity, g as shadowOpacityFrom, i as shadowReachDp, j as sizeDp, k as sizeGain, n as surfacePadDp, t as thicknessDp } from './geometry-GvXtt-_S.js';
-import { V as VireGlassAccent } from './adapters-BfeAopGO.js';
-export { A as ACCENT_AMOUNT, D as DYNAMIC_UNIFORMS, I as ICON_UNIFORMS, O as OVERLAY_UNIFORMS, R as REST_LIGHT, S as SURFACE_LENGTH_UNIFORMS, a as SurfaceUniforms, b as VireGlassMorph, c as VireGlassTouch, l as lensMagnify, m as morphBetween, d as morphOutOf, t as toDeviceSurfaceUniforms, e as toLensProps, f as toSurfaceUniforms } from './adapters-BfeAopGO.js';
+import { V as VireGlassAccent } from './adapters-B_amRBqc.js';
+export { A as ACCENT_AMOUNT, D as DYNAMIC_UNIFORMS, I as ICON_UNIFORMS, O as OVERLAY_UNIFORMS, R as REST_LIGHT, S as SURFACE_LENGTH_UNIFORMS, a as SurfaceUniforms, b as VireGlassMorph, c as VireGlassTouch, l as lensMagnify, m as morphBetween, d as morphOutOf, t as toDeviceSurfaceUniforms, e as toLensProps, f as toSurfaceUniforms } from './adapters-B_amRBqc.js';
 export { a as GRADIENT, b as GroupDecision, c as GroupMember, G as GroupPlane, d as GroupSink, e as GroupState, M as MorphShape, N as NO_ACCESSIBILITY, f as SCROLL_EDGE_ENGAGE_DP, g as SETTLE, h as SMOOTH, S as ScrollEdgeStyle, T as TouchWarp, i as VG_FALLOFF, j as VG_SDF, V as VireGlassAccessibility, k as aggregate, l as applyAccessibility, m as contrastRimLuma, n as createGroupState, o as elasticAllowed, p as neckToBridge, q as probeValuesAt, s as sceneDistance, r as sceneGradient, t as scrollEdgeReachDp, u as scrollEdgeStrength, v as scrollEdgeStyle, w as sdfRoundedRect, x as sdfRoundedRectGradient, y as smin, z as smoothPlane, A as touchWarp } from './group-model-z4N27qsC.js';
 export { B as BackdropSample, C as CONFIRMATIONS, F as FADE_MS, a as FLIP_LUMA, I as INK_DARK, b as INK_LIGHT, R as RETURN_LUMA, c as ambientFrom, d as decisiveLuma, s as shouldInkBeLight } from './adaptation-BSbbdExK.js';
 
@@ -275,11 +275,16 @@ declare function convertShaderUniforms(src: string): string;
  * parentheses inside.
  */
 declare function convertEvalCalls(src: string): string;
+/** Comments are prose, and the rewrites here are regexes over raw text: a comment mentioning
+ *  "return" became one, and a brace in a comment ended the entry point early. Newlines inside
+ *  block comments survive, so a compile error still points at the source line. */
+declare function stripComments(src: string): string;
 /**
  * Early `return <expression>;` inside `main` → `fragColor = <expression>; return;`. Takes ONLY
  * the body of main (see `convertEntryPoint`) — ordinary `return`s in helper functions live
  * outside this text and are untouched. Expressions never contain a `;` of their own (shaders have
- * none — the only `;` lives inside `for(...)`, which isn't a return), so `[^;]+` is safe.
+ * none — the only `;` lives inside `for(...)`, which isn't a return), so `[^;]+` is safe once
+ * comments are gone (`stripComments`).
  */
 declare function convertReturns(mainBody: string): string;
 /**
@@ -288,6 +293,10 @@ declare function convertReturns(mainBody: string): string;
  * origin, y up. The flip via `u_resolution.y - gl_FragCoord.y` restores the original convention
  * (both coordinate systems center the pixel at `+0.5`, so no X shift or constant is needed).
  * `out vec4 fragColor` and `uniform vec2 u_resolution` are declared in the prologue (`addPrologue`).
+ *
+ * `xy` and `.eval()` are flipped together — but only inside a shader THIS function translates. A
+ * `VireGlassBackdropPass` (`web/renderer.ts`) that reads its own previous frame from an FBO is raw
+ * `gl_FragCoord`, unflipped; reusing AGSL-style helpers there needs an explicit flip of its own.
  */
 declare function convertEntryPoint(src: string): string;
 /** `#version 300 es` + `precision highp float;` — no equivalent in AGSL, WebGL2 requires them as
@@ -300,4 +309,4 @@ declare function addPrologue(src: string): string;
  *  found. */
 declare function toGLSL(shaderSource: string): string;
 
-export { type DeformOptions, type DeformSample, FRESNEL_EXPONENT, GLASS_SCALE_DEFAULT, LENS_SHADER, SURFACE_SHADER, type ShapeParent, type ShapeSpec, VireGlassAccent, VireGlassOptics, absorption, accentAmount, accentTone, addPrologue, applyAppear, applyGlassScale, blur, bodyDensity, colorPickup, concentricFit, concentricInset, concentricRadius, convertEntryPoint, convertEvalCalls, convertHalfTypes, convertReturns, convertShaderUniforms, convertVecTypes, createDeform, diffraction, dispersion, edgeDensity, edgeLight, fresnelF0, fresnelStrength, gatherRadius, iorSpread, iridescence, mediumTint, raiseIntoGlass, refractionScale, refractionStrength, resolveShape, shadowTint, specularPower, specularStrength, toAGSL, toGLSL };
+export { type DeformOptions, type DeformSample, FRESNEL_EXPONENT, GLASS_SCALE_DEFAULT, LENS_SHADER, SURFACE_SHADER, type ShapeParent, type ShapeSpec, VireGlassAccent, VireGlassOptics, absorption, accentAmount, accentTone, addPrologue, applyAppear, applyGlassScale, blur, bodyDensity, colorPickup, concentricFit, concentricInset, concentricRadius, convertEntryPoint, convertEvalCalls, convertHalfTypes, convertReturns, convertShaderUniforms, convertVecTypes, createDeform, diffraction, dispersion, edgeDensity, edgeLight, fresnelF0, fresnelStrength, gatherRadius, iorSpread, iridescence, mediumTint, raiseIntoGlass, refractionScale, refractionStrength, resolveShape, shadowTint, specularPower, specularStrength, stripComments, toAGSL, toGLSL };

package/dist/index.js

@@ -1,7 +1,7 @@
-export { SURFACE_SHADER, addPrologue, convertEntryPoint, convertEvalCalls, convertHalfTypes, convertReturns, convertShaderUniforms, convertVecTypes, toGLSL } from './chunk-2XJJO7SC.js';
+export { SURFACE_SHADER, addPrologue, convertEntryPoint, convertEvalCalls, convertHalfTypes, convertReturns, convertShaderUniforms, convertVecTypes, stripComments, toGLSL } from './chunk-UDPJLNFW.js';
 export { GLASS_SCALE_DEFAULT, GRADIENT, NO_ACCESSIBILITY, SCROLL_EDGE_ENGAGE_DP, SETTLE, SMOOTH, accentAmount, accentTone, aggregate, applyAccessibility, applyAppear, applyGlassScale, concentricFit, concentricInset, concentricRadius, contrastRimLuma, createDeform, createGroupState, elasticAllowed, probeValuesAt, raiseIntoGlass, resolveShape, scrollEdgeReachDp, scrollEdgeStrength, scrollEdgeStyle, shadowTint, smoothPlane } from './chunk-CTTZNZFV.js';
 export { CONFIRMATIONS, FADE_MS, FLIP_LUMA, INK_DARK, INK_LIGHT, RETURN_LUMA, ambientFrom, decisiveLuma, shouldInkBeLight } from './chunk-JNRZNMJJ.js';
-export { ACCENT_AMOUNT, ADAPT_RADIUS, ALL_EFFECTS_ON, DEBUG_MODES, DYNAMIC_UNIFORMS, EFFECTS, FRESNEL_EXPONENT, ICON_UNIFORMS, LEGACY_NAMES, LEGACY_OPTICS, LENS_SHADER, MATERIAL_PRESETS, MATERIAL_RANGES, OVERLAY_UNIFORMS, PRESET_NAMES, PRODUCT_DIM, REST_LIGHT, SURFACE_LENGTH_UNIFORMS, VG_FALLOFF, VG_SDF, VIREGLASS_CLEAR_MATERIAL, VIREGLASS_CONTROL_MATERIAL, VIREGLASS_LYRICS_MATERIAL, VIREGLASS_MATERIAL, VIREGLASS_MATERIAL_V4, VIREGLASS_MATERIAL_V5, VIREGLASS_SHEET_MATERIAL, absorption, activeMaterial, applyToggles, blur, bodyDensity, colorPickup, debugIndex, diffraction, dispersion, edgeDensity, edgeLight, fresnelF0, fresnelStrength, gatherRadius, iorSpread, iridescence, lensMagnify, materialForInk, mediumTint, morphBetween, morphOutOf, neckToBridge, refractionScale, refractionStrength, resolveMaterial, resolveOptics, sceneDistance, sceneGradient, sdfRoundedRect, sdfRoundedRectGradient, smin, specularPower, specularStrength, toDeviceSurfaceUniforms, toLensProps, toSurfaceUniforms, touchWarp } from './chunk-H5QTBF67.js';
+export { ACCENT_AMOUNT, ADAPT_RADIUS, ALL_EFFECTS_ON, DEBUG_MODES, DYNAMIC_UNIFORMS, EFFECTS, FRESNEL_EXPONENT, ICON_UNIFORMS, LEGACY_NAMES, LEGACY_OPTICS, LENS_SHADER, MATERIAL_PRESETS, MATERIAL_RANGES, OVERLAY_UNIFORMS, PRESET_NAMES, PRODUCT_DIM, REST_LIGHT, SURFACE_LENGTH_UNIFORMS, VG_FALLOFF, VG_SDF, VIREGLASS_CLEAR_MATERIAL, VIREGLASS_CONTROL_MATERIAL, VIREGLASS_LYRICS_MATERIAL, VIREGLASS_MATERIAL, VIREGLASS_MATERIAL_V4, VIREGLASS_MATERIAL_V5, VIREGLASS_SHEET_MATERIAL, absorption, activeMaterial, applyToggles, blur, bodyDensity, colorPickup, debugIndex, diffraction, dispersion, edgeDensity, edgeLight, fresnelF0, fresnelStrength, gatherRadius, iorSpread, iridescence, lensMagnify, materialForInk, mediumTint, morphBetween, morphOutOf, neckToBridge, refractionScale, refractionStrength, resolveMaterial, resolveOptics, sceneDistance, sceneGradient, sdfRoundedRect, sdfRoundedRectGradient, smin, specularPower, specularStrength, toDeviceSurfaceUniforms, toLensProps, toSurfaceUniforms, touchWarp } from './chunk-V47YU75P.js';
 export { MAX_BEVEL_FRACTION, MAX_STRETCH, RIM_FRACTION, bevelDp, bevelFraction, capsuleGeometry, circleGeometry, halfMinDp, lensPadDp, morphReachDp, rimDp, roundedRectGeometry, shadowOpacity, shadowOpacityFrom, shadowReachDp, sizeDp, sizeGain, surfacePadDp, thicknessDp } from './chunk-SLRPHDV7.js';
 import './chunk-MMPK6DCK.js';
 

package/dist/web/index.cjs

@@ -1459,6 +1459,26 @@ function convertEvalCalls(src) {
   out += src.slice(cursor);
   return out;
 }
+function stripComments(src) {
+  let out = "";
+  let i = 0;
+  while (i < src.length) {
+    if (src.startsWith("//", i)) {
+      const end = src.indexOf("\n", i);
+      i = end < 0 ? src.length : end;
+    } else if (src.startsWith("/*", i)) {
+      const end = src.indexOf("*/", i + 2);
+      if (end < 0) throw new Error("vireglass/targets/glsl: unterminated block comment");
+      const stop = end + 2;
+      out += src.slice(i, stop).replace(/[^\n]/g, "");
+      i = stop;
+    } else {
+      out += src[i];
+      i += 1;
+    }
+  }
+  return out;
+}
 function convertReturns(mainBody) {
   return mainBody.replace(/\breturn\s+([^;]+);/g, "fragColor = $1; return;");
 }
@@ -1489,7 +1509,7 @@ function addPrologue(src) {
   return "#version 300 es\nprecision highp float;\n\nout vec4 fragColor;\nuniform vec2 u_resolution;\n\n" + src;
 }
 function toGLSL(shaderSource) {
-  let out = shaderSource;
+  let out = stripComments(shaderSource);
   out = convertEntryPoint(out);
   out = convertShaderUniforms(out);
   out = convertEvalCalls(out);
@@ -1546,6 +1566,7 @@ function createTexture(gl, options) {
   const internalFormat = options.internalFormat ?? gl.RGBA8;
   const format = options.format ?? gl.RGBA;
   const type = options.type ?? gl.UNSIGNED_BYTE;
+  const wrap = options.wrap ?? gl.CLAMP_TO_EDGE;
   gl.bindTexture(gl.TEXTURE_2D, texture);
   gl.texImage2D(
     gl.TEXTURE_2D,
@@ -1560,11 +1581,45 @@ function createTexture(gl, options) {
   );
   gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
   gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
-  gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
-  gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
+  gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, wrap);
+  gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, wrap);
   gl.bindTexture(gl.TEXTURE_2D, null);
   return texture;
 }
+function locationCache(gl, program) {
+  const cache = /* @__PURE__ */ new Map();
+  return (name) => {
+    let loc = cache.get(name);
+    if (loc === void 0) {
+      loc = gl.getUniformLocation(program, name);
+      cache.set(name, loc);
+    }
+    return loc;
+  };
+}
+function setUniform(gl, loc, value) {
+  if (!loc) return;
+  if (typeof value === "number") {
+    gl.uniform1f(loc, value);
+    return;
+  }
+  switch (value.length) {
+    case 1:
+      gl.uniform1f(loc, value[0]);
+      break;
+    case 2:
+      gl.uniform2f(loc, value[0], value[1]);
+      break;
+    case 3:
+      gl.uniform3f(loc, value[0], value[1], value[2]);
+      break;
+    case 4:
+      gl.uniform4f(loc, value[0], value[1], value[2], value[3]);
+      break;
+    default:
+      throw new Error(`vireglass/web: unsupported uniform size (${value.length})`);
+  }
+}
 function createFramebuffer(gl, texture) {
   const fbo = gl.createFramebuffer();
   if (!fbo) throw new Error("vireglass/web: gl.createFramebuffer returned null");
@@ -1584,6 +1639,62 @@ function bindTextureAt(gl, unit, texture, program, uniformName) {
   gl.uniform1i(loc, unit);
 }
 
+// src/web/gpu-timer.ts
+var GPU_TIMER_RING_SIZE = 3;
+function createGpuTimer(gl) {
+  const ext = gl.getExtension("EXT_disjoint_timer_query_webgl2");
+  const slots = ext ? Array.from({ length: GPU_TIMER_RING_SIZE }, () => ({
+    query: gl.createQuery(),
+    pending: false
+  })) : [];
+  let cursor = 0;
+  let active = null;
+  let lastMs = null;
+  function poll() {
+    if (!ext) return;
+    for (const slot of slots) {
+      if (!slot.pending) continue;
+      if (!gl.getQueryParameter(slot.query, gl.QUERY_RESULT_AVAILABLE)) continue;
+      slot.pending = false;
+      if (gl.getParameter(ext.GPU_DISJOINT_EXT)) continue;
+      const ns = gl.getQueryParameter(slot.query, gl.QUERY_RESULT);
+      lastMs = ns / 1e6;
+    }
+  }
+  function begin() {
+    active = null;
+    if (!ext || slots.length === 0) return;
+    poll();
+    const slot = slots[cursor];
+    if (slot.pending) return;
+    gl.beginQuery(ext.TIME_ELAPSED_EXT, slot.query);
+    active = slot;
+  }
+  function end() {
+    if (!ext || !active) return;
+    gl.endQuery(ext.TIME_ELAPSED_EXT);
+    active.pending = true;
+    cursor = (cursor + 1) % slots.length;
+    active = null;
+  }
+  function time(fn) {
+    begin();
+    try {
+      return fn();
+    } finally {
+      end();
+    }
+  }
+  function getLastMs() {
+    poll();
+    return lastMs;
+  }
+  function destroy() {
+    for (const slot of slots) gl.deleteQuery(slot.query);
+  }
+  return { time, getLastMs, destroy };
+}
+
 // src/web/probe.ts
 var PROBE_GRID_WIDTH = 48;
 var PROBE_GRID_HEIGHT = 96;
@@ -1804,40 +1915,6 @@ void main() {
   fragColor = texture(u_content, uv);
 }
 `;
-function locationCache(gl, program) {
-  const cache = /* @__PURE__ */ new Map();
-  return (name) => {
-    let loc = cache.get(name);
-    if (loc === void 0) {
-      loc = gl.getUniformLocation(program, name);
-      cache.set(name, loc);
-    }
-    return loc;
-  };
-}
-function setUniform(gl, loc, value) {
-  if (!loc) return;
-  if (typeof value === "number") {
-    gl.uniform1f(loc, value);
-    return;
-  }
-  switch (value.length) {
-    case 1:
-      gl.uniform1f(loc, value[0]);
-      break;
-    case 2:
-      gl.uniform2f(loc, value[0], value[1]);
-      break;
-    case 3:
-      gl.uniform3f(loc, value[0], value[1], value[2]);
-      break;
-    case 4:
-      gl.uniform4f(loc, value[0], value[1], value[2], value[3]);
-      break;
-    default:
-      throw new Error(`vireglass/web: unsupported uniform size (${value.length})`);
-  }
-}
 function applyChannel(gl, get, names, sizes, values) {
   let cursor = 0;
   for (let i = 0; i < names.length; i += 1) {
@@ -1900,6 +1977,12 @@ function createVireGlassRenderer(canvas) {
     width: Math.max(width, 1),
     height: Math.max(height, 1)
   });
+  let backdropFbo = null;
+  function ensureBackdropFbo() {
+    if (!backdropFbo) backdropFbo = createFramebuffer(gl, contentTexture);
+    return backdropFbo;
+  }
+  const gpuTimer = createGpuTimer(gl);
   const iconTexture = createTexture(gl, { width: 1, height: 1 });
   const colorTexture = createTexture(gl, { width: 1, height: 1 });
   gl.bindTexture(gl.TEXTURE_2D, iconTexture);
@@ -1928,128 +2011,164 @@ function createVireGlassRenderer(canvas) {
     if (!sceneCtx) throw new Error("vireglass/web: scene 2D context unavailable");
     gl.deleteTexture(contentTexture);
     contentTexture = createTexture(gl, { width, height });
+    if (backdropFbo) {
+      gl.deleteFramebuffer(backdropFbo);
+      backdropFbo = null;
+    }
   }
   function render(options) {
     if (!sceneCtx) throw new Error("vireglass/web: renderer not initialized (resize was never called)");
-    sceneCtx.clearRect(0, 0, width, height);
-    options.scene(sceneCtx, width, height, options.offsetX ?? 0, options.offsetY ?? 0, options.density);
-    gl.bindTexture(gl.TEXTURE_2D, contentTexture);
-    gl.texSubImage2D(gl.TEXTURE_2D, 0, 0, 0, gl.RGBA, gl.UNSIGNED_BYTE, sceneCanvas);
-    gl.bindTexture(gl.TEXTURE_2D, null);
-    if (options.colorLayer) {
-      gl.bindTexture(gl.TEXTURE_2D, colorTexture);
-      gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, options.colorLayer);
+    const ctx = sceneCtx;
+    if (options.backdrop && options.scene) {
+      throw new Error(
+        "vireglass/web: render() needs exactly one of options.scene or options.backdrop, not both"
+      );
     }
-    if (options.iconMask) {
-      gl.bindTexture(gl.TEXTURE_2D, iconTexture);
-      gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, options.iconMask);
-      gl.bindTexture(gl.TEXTURE_2D, null);
+    if (!options.backdrop && !options.scene) {
+      throw new Error("vireglass/web: render() needs either options.scene or options.backdrop");
     }
-    gl.bindFramebuffer(gl.FRAMEBUFFER, null);
-    gl.viewport(0, 0, width, height);
-    gl.disable(gl.BLEND);
-    gl.disable(gl.SCISSOR_TEST);
-    gl.useProgram(blitProgram);
-    bindTextureAt(gl, 0, contentTexture, blitProgram, "u_content");
-    setUniform(gl, blitLoc("u_resolution"), [width, height]);
-    drawFullscreenTriangle(gl);
-    const probes = [];
-    for (let index = 0; index < options.pieces.length; index += 1) {
-      const piece = options.pieces[index];
-      const halfWidth = piece.geometry.width * options.density / 2;
-      const halfHeight = piece.geometry.height * options.density / 2;
-      const rect = {
-        centerX: piece.centerX,
-        centerY: piece.centerY,
-        halfWidth,
-        halfHeight
-      };
-      const fresh = index === 0 ? probe.sample(contentTexture, width, height, rect) : probe.statsFor(width, height, rect);
-      const stats = fresh ? settleStats(index, fresh) : null;
-      probes.push(stats);
-      gl.bindFramebuffer(gl.FRAMEBUFFER, null);
-      gl.viewport(0, 0, width, height);
-      gl.enable(gl.BLEND);
-      gl.blendFunc(gl.ONE, gl.ONE_MINUS_SRC_ALPHA);
-      const reachOf = (m) => m ? Math.hypot(m.offsetX, m.offsetY) + Math.max(m.width, m.height) / 2 + m.smoothing : 0;
-      const morphReach = Math.max(reachOf(piece.morph), reachOf(piece.morph2));
-      const touchReach = piece.touch ? Math.hypot(piece.touch.pullX, piece.touch.pullY) + piece.touch.waveAmp * 2 + Math.max(piece.geometry.width, piece.geometry.height) * 0.05 * piece.touch.press : 0;
-      const padPx = (lensPadDp(piece.geometry, piece.optics) + surfacePadDp(piece.geometry, 0) + morphReach + touchReach) * options.density;
-      const left = Math.max(0, Math.floor(piece.centerX - halfWidth - padPx));
-      const right = Math.min(width, Math.ceil(piece.centerX + halfWidth + padPx));
-      const top = Math.max(0, Math.floor(height - (piece.centerY + halfHeight + padPx)));
-      const bottom = Math.min(height, Math.ceil(height - (piece.centerY - halfHeight - padPx)));
-      gl.enable(gl.SCISSOR_TEST);
-      gl.scissor(left, top, Math.max(0, right - left), Math.max(0, bottom - top));
-      gl.useProgram(lensProgram);
-      bindTextureAt(gl, 0, contentTexture, lensProgram, "content");
-      setUniform(gl, lensLoc("u_contentSize"), [width, height]);
-      setUniform(gl, lensLoc("u_resolution"), [width, height]);
-      setUniform(gl, lensLoc("u_center"), [piece.centerX, piece.centerY]);
-      setUniform(gl, lensLoc("u_reach"), Math.max(width, height));
-      setUniform(gl, lensLoc("u_contentMin"), [1, 1]);
-      setUniform(gl, lensLoc("u_contentMax"), [width - 1, height - 1]);
-      if (stats) {
-        setUniform(gl, lensLoc("u_probeLuma"), stats.luma);
-        setUniform(gl, lensLoc("u_probeBusy"), stats.busy);
-        setUniform(gl, lensLoc("u_probeRange"), [stats.lo, stats.hi]);
-        setUniform(gl, lensLoc("u_probeSlope"), [stats.slopeX, stats.slopeY]);
-        setUniform(gl, lensLoc("u_probe"), [stats.r, stats.g, stats.b]);
+    return gpuTimer.time(() => {
+      if (options.backdrop) {
+        const fbo = ensureBackdropFbo();
+        gl.bindFramebuffer(gl.FRAMEBUFFER, fbo);
+        gl.viewport(0, 0, width, height);
+        options.backdrop(gl, { framebuffer: fbo, width, height });
+        gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+        gl.viewport(0, 0, width, height);
+        gl.disable(gl.BLEND);
+        gl.disable(gl.SCISSOR_TEST);
+        gl.disable(gl.DEPTH_TEST);
+        gl.disable(gl.CULL_FACE);
+        gl.disable(gl.STENCIL_TEST);
+        gl.colorMask(true, true, true, true);
+        gl.depthMask(true);
+        gl.bindVertexArray(null);
+        gl.activeTexture(gl.TEXTURE0);
+        gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, false);
+        gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, false);
+        gl.pixelStorei(gl.UNPACK_COLORSPACE_CONVERSION_WEBGL, gl.BROWSER_DEFAULT_WEBGL);
       } else {
-        setUniform(gl, lensLoc("u_probeLuma"), -1);
+        ctx.clearRect(0, 0, width, height);
+        options.scene?.(ctx, width, height, options.offsetX ?? 0, options.offsetY ?? 0, options.density);
+        gl.bindTexture(gl.TEXTURE_2D, contentTexture);
+        gl.texSubImage2D(gl.TEXTURE_2D, 0, 0, 0, gl.RGBA, gl.UNSIGNED_BYTE, sceneCanvas);
+        gl.bindTexture(gl.TEXTURE_2D, null);
       }
-      const lens = toLensProps(piece.optics, piece.geometry, options.density, {
-        debug: options.debug,
-        morph: piece.morph,
-        morph2: piece.morph2,
-        touch: piece.touch,
-        progress: piece.progress,
-        light: piece.light,
-        appear: piece.appear,
-        accent: piece.accent
-      });
-      applyChannel(gl, lensLoc, lens.uniformNames, lens.uniformSizes, lens.uniformValues);
-      drawFullscreenTriangle(gl);
-      gl.useProgram(surfaceProgram);
-      const rawSurface = toSurfaceUniforms(piece.optics, piece.geometry, {
-        debug: options.debug,
-        morph: piece.morph,
-        morph2: piece.morph2,
-        bodyInLens: true,
-        touch: piece.touch,
-        progress: piece.progress,
-        // The shadow is denser over text, weaker over a flat backdrop (M 11:47). The rule lives
-        // in the core: while it lived here, Android didn't have it at all.
-        shadow: stats ? shadowOpacity(stats.busy) : 1,
-        // The probe has already computed the ambient color — the shadow gets it for free. Taken
-        // as-is: `settleStats` has already smoothed it, and rounding would bring back exactly the
-        // steps the smoothing was written to remove.
-        ambient: stats ? [stats.r, stats.g, stats.b] : void 0,
-        appear: piece.appear,
-        lift: piece.lift
-      });
-      applyObject(gl, surfaceLoc, {
-        ...toDeviceSurfaceUniforms(rawSurface, options.density),
-        u_center: [piece.centerX, piece.centerY]
-      });
-      setUniform(gl, surfaceLoc(DYNAMIC_UNIFORMS[0]), piece.press ?? 0);
-      setUniform(gl, surfaceLoc(DYNAMIC_UNIFORMS[1]), piece.active ?? 0);
-      const hasIcon = Boolean(piece.icon && options.iconMask);
-      setUniform(gl, surfaceLoc(ICON_UNIFORMS[0]), hasIcon ? 1 : 0);
-      setUniform(gl, surfaceLoc(ICON_UNIFORMS[1]), 1);
-      setUniform(gl, surfaceLoc(ICON_UNIFORMS[2]), piece.inkIdle ?? [1, 1, 1, 1]);
-      setUniform(gl, surfaceLoc(ICON_UNIFORMS[3]), piece.inkActive ?? [1, 1, 1, 1]);
-      bindTextureAt(gl, 1, iconTexture, surfaceProgram, "u_icon");
-      setUniform(gl, surfaceLoc("u_iconSize"), hasIcon ? [width, height] : [1, 1]);
-      const hasColor = Boolean(piece.overlay && options.colorLayer);
-      setUniform(gl, surfaceLoc(OVERLAY_UNIFORMS[0]), hasColor ? 1 : 0);
-      bindTextureAt(gl, 2, colorTexture, surfaceProgram, "u_overlay");
-      setUniform(gl, surfaceLoc("u_overlaySize"), hasColor ? [width, height] : [1, 1]);
-      setUniform(gl, surfaceLoc("u_resolution"), [width, height]);
+      if (options.colorLayer) {
+        gl.bindTexture(gl.TEXTURE_2D, colorTexture);
+        gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, options.colorLayer);
+      }
+      if (options.iconMask) {
+        gl.bindTexture(gl.TEXTURE_2D, iconTexture);
+        gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, options.iconMask);
+        gl.bindTexture(gl.TEXTURE_2D, null);
+      }
+      gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+      gl.viewport(0, 0, width, height);
+      gl.disable(gl.BLEND);
+      gl.disable(gl.SCISSOR_TEST);
+      gl.useProgram(blitProgram);
+      bindTextureAt(gl, 0, contentTexture, blitProgram, "u_content");
+      setUniform(gl, blitLoc("u_resolution"), [width, height]);
       drawFullscreenTriangle(gl);
-    }
-    gl.disable(gl.SCISSOR_TEST);
-    return { probes };
+      const probes = [];
+      for (let index = 0; index < options.pieces.length; index += 1) {
+        const piece = options.pieces[index];
+        const halfWidth = piece.geometry.width * options.density / 2;
+        const halfHeight = piece.geometry.height * options.density / 2;
+        const rect = {
+          centerX: piece.centerX,
+          centerY: piece.centerY,
+          halfWidth,
+          halfHeight
+        };
+        const fresh = index === 0 ? probe.sample(contentTexture, width, height, rect) : probe.statsFor(width, height, rect);
+        const stats = fresh ? settleStats(index, fresh) : null;
+        probes.push(stats);
+        gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+        gl.viewport(0, 0, width, height);
+        gl.enable(gl.BLEND);
+        gl.blendFunc(gl.ONE, gl.ONE_MINUS_SRC_ALPHA);
+        const reachOf = (m) => m ? Math.hypot(m.offsetX, m.offsetY) + Math.max(m.width, m.height) / 2 + m.smoothing : 0;
+        const morphReach = Math.max(reachOf(piece.morph), reachOf(piece.morph2));
+        const touchReach = piece.touch ? Math.hypot(piece.touch.pullX, piece.touch.pullY) + piece.touch.waveAmp * 2 + Math.max(piece.geometry.width, piece.geometry.height) * 0.05 * piece.touch.press : 0;
+        const padPx = (lensPadDp(piece.geometry, piece.optics) + surfacePadDp(piece.geometry, 0) + morphReach + touchReach) * options.density;
+        const left = Math.max(0, Math.floor(piece.centerX - halfWidth - padPx));
+        const right = Math.min(width, Math.ceil(piece.centerX + halfWidth + padPx));
+        const top = Math.max(0, Math.floor(height - (piece.centerY + halfHeight + padPx)));
+        const bottom = Math.min(height, Math.ceil(height - (piece.centerY - halfHeight - padPx)));
+        gl.enable(gl.SCISSOR_TEST);
+        gl.scissor(left, top, Math.max(0, right - left), Math.max(0, bottom - top));
+        gl.useProgram(lensProgram);
+        bindTextureAt(gl, 0, contentTexture, lensProgram, "content");
+        setUniform(gl, lensLoc("u_contentSize"), [width, height]);
+        setUniform(gl, lensLoc("u_resolution"), [width, height]);
+        setUniform(gl, lensLoc("u_center"), [piece.centerX, piece.centerY]);
+        setUniform(gl, lensLoc("u_reach"), Math.max(width, height));
+        setUniform(gl, lensLoc("u_contentMin"), [1, 1]);
+        setUniform(gl, lensLoc("u_contentMax"), [width - 1, height - 1]);
+        if (stats) {
+          setUniform(gl, lensLoc("u_probeLuma"), stats.luma);
+          setUniform(gl, lensLoc("u_probeBusy"), stats.busy);
+          setUniform(gl, lensLoc("u_probeRange"), [stats.lo, stats.hi]);
+          setUniform(gl, lensLoc("u_probeSlope"), [stats.slopeX, stats.slopeY]);
+          setUniform(gl, lensLoc("u_probe"), [stats.r, stats.g, stats.b]);
+        } else {
+          setUniform(gl, lensLoc("u_probeLuma"), -1);
+        }
+        const lens = toLensProps(piece.optics, piece.geometry, options.density, {
+          debug: options.debug,
+          morph: piece.morph,
+          morph2: piece.morph2,
+          touch: piece.touch,
+          progress: piece.progress,
+          light: piece.light,
+          appear: piece.appear,
+          accent: piece.accent
+        });
+        applyChannel(gl, lensLoc, lens.uniformNames, lens.uniformSizes, lens.uniformValues);
+        drawFullscreenTriangle(gl);
+        gl.useProgram(surfaceProgram);
+        const rawSurface = toSurfaceUniforms(piece.optics, piece.geometry, {
+          debug: options.debug,
+          morph: piece.morph,
+          morph2: piece.morph2,
+          bodyInLens: true,
+          touch: piece.touch,
+          progress: piece.progress,
+          // The shadow is denser over text, weaker over a flat backdrop (M 11:47). The rule lives
+          // in the core: while it lived here, Android didn't have it at all.
+          shadow: stats ? shadowOpacity(stats.busy) : 1,
+          // The probe has already computed the ambient color — the shadow gets it for free. Taken
+          // as-is: `settleStats` has already smoothed it, and rounding would bring back exactly the
+          // steps the smoothing was written to remove.
+          ambient: stats ? [stats.r, stats.g, stats.b] : void 0,
+          appear: piece.appear,
+          lift: piece.lift
+        });
+        applyObject(gl, surfaceLoc, {
+          ...toDeviceSurfaceUniforms(rawSurface, options.density),
+          u_center: [piece.centerX, piece.centerY]
+        });
+        setUniform(gl, surfaceLoc(DYNAMIC_UNIFORMS[0]), piece.press ?? 0);
+        setUniform(gl, surfaceLoc(DYNAMIC_UNIFORMS[1]), piece.active ?? 0);
+        const hasIcon = Boolean(piece.icon && options.iconMask);
+        setUniform(gl, surfaceLoc(ICON_UNIFORMS[0]), hasIcon ? 1 : 0);
+        setUniform(gl, surfaceLoc(ICON_UNIFORMS[1]), 1);
+        setUniform(gl, surfaceLoc(ICON_UNIFORMS[2]), piece.inkIdle ?? [1, 1, 1, 1]);
+        setUniform(gl, surfaceLoc(ICON_UNIFORMS[3]), piece.inkActive ?? [1, 1, 1, 1]);
+        bindTextureAt(gl, 1, iconTexture, surfaceProgram, "u_icon");
+        setUniform(gl, surfaceLoc("u_iconSize"), hasIcon ? [width, height] : [1, 1]);
+        const hasColor = Boolean(piece.overlay && options.colorLayer);
+        setUniform(gl, surfaceLoc(OVERLAY_UNIFORMS[0]), hasColor ? 1 : 0);
+        bindTextureAt(gl, 2, colorTexture, surfaceProgram, "u_overlay");
+        setUniform(gl, surfaceLoc("u_overlaySize"), hasColor ? [width, height] : [1, 1]);
+        setUniform(gl, surfaceLoc("u_resolution"), [width, height]);
+        drawFullscreenTriangle(gl);
+      }
+      gl.disable(gl.SCISSOR_TEST);
+      return { probes };
+    });
   }
   function destroy() {
     probe.destroy();
@@ -2059,13 +2178,24 @@ function createVireGlassRenderer(canvas) {
     gl.deleteTexture(contentTexture);
     gl.deleteTexture(iconTexture);
     gl.deleteTexture(colorTexture);
+    if (backdropFbo) gl.deleteFramebuffer(backdropFbo);
+    gpuTimer.destroy();
   }
-  return { resize, render, destroy };
+  return { resize, render, getLastGpuMs: gpuTimer.getLastMs, destroy };
 }
 
+exports.FULLSCREEN_TRIANGLE_VERTEX_SOURCE = FULLSCREEN_TRIANGLE_VERTEX_SOURCE;
 exports.PROBE_GRID_HEIGHT = PROBE_GRID_HEIGHT;
 exports.PROBE_GRID_WIDTH = PROBE_GRID_WIDTH;
+exports.bindTextureAt = bindTextureAt;
+exports.compileShader = compileShader;
+exports.createFramebuffer = createFramebuffer;
 exports.createProbe = createProbe;
+exports.createProgram = createProgram;
+exports.createTexture = createTexture;
 exports.createVireGlassRenderer = createVireGlassRenderer;
+exports.drawFullscreenTriangle = drawFullscreenTriangle;
+exports.locationCache = locationCache;
+exports.setUniform = setUniform;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map