@wave3d/core 0.2.2 → 0.3.0

package/dist/presets.js.map

@@ -1 +1 @@
-{"version":3,"file":"presets.js","names":[],"sources":["../src/presets.ts"],"sourcesContent":["/**\n * Built-in presets: each a complete studio config (scene + one or more waves) in the wave model.\n * IP-clean — no copyrighted assets. The studio layers its own extra presets (and its historical\n * \"Stripe *\" display names) on top; see apps/studio/src/presets.ts.\n */\nimport { createDefaultConfig, makeStops, makeWaveSpread } from \"./config/model\";\nimport type { StudioConfig, NoiseBand } from \"./config/model\";\n\nconst RAD = 180 / Math.PI;\n\n/** Build a preset from a set of wave parameters. rotation/hue are given in RADIANS and\n *  converted to degrees. All presets are solid-theme, so they reuse the hero palette +\n *  surfaceColor fibers (600/0.2) and sheen 0, like the hero. camTarget/zoom frame the\n *  wave (we pan the look-at to centre each one). */\nfunction buildPreset(p: {\n  speed: number;\n  contrast: number;\n  sat: number;\n  hueRad: number;\n  dispX: number;\n  dispZ: number;\n  dispAmt: number;\n  pos: [number, number, number];\n  rotRad: [number, number, number];\n  scale: [number, number, number];\n  twF: [number, number, number];\n  twP: [number, number, number];\n  glow: [number, number, number];\n  grain: number;\n  blur: number;\n  zoom: number;\n  camTarget: [number, number];\n  noiseBands?: NoiseBand[];\n  twistMotion?: boolean;\n}): StudioConfig {\n  const c = createDefaultConfig();\n  const w = c.waves[0];\n  w.speed = p.speed;\n  w.colorContrast = p.contrast;\n  w.colorSaturation = p.sat;\n  w.hueShift = p.hueRad * RAD;\n  w.displaceFrequency = { x: p.dispX, y: p.dispZ };\n  w.displaceAmount = p.dispAmt;\n  w.position = { x: p.pos[0], y: p.pos[1], z: p.pos[2] };\n  w.rotation = { x: p.rotRad[0] * RAD, y: p.rotRad[1] * RAD, z: p.rotRad[2] * RAD };\n  w.scale = { x: p.scale[0], y: p.scale[1], z: p.scale[2] };\n  w.twistFrequency = { x: p.twF[0], y: p.twF[1], z: p.twF[2] };\n  w.twistPower = { x: p.twP[0], y: p.twP[1], z: p.twP[2] };\n  w.creaseLight = p.glow[0];\n  w.creaseSharpness = p.glow[1];\n  w.creaseSoftness = p.glow[2];\n  if (p.noiseBands) w.noiseBands = p.noiseBands;\n  if (p.twistMotion) w.twistMotion = true;\n  c.grain = p.grain;\n  c.blur = p.blur;\n  c.cameraPosition = { x: 100, y: 0, z: 5000 };\n  c.cameraTarget = { x: p.camTarget[0], y: p.camTarget[1], z: 0 };\n  c.cameraZoom = p.zoom;\n  return c;\n}\n\n/** Presets: each a complete studio config (scene + one or more waves) in the wave model. */\nexport const PRESETS: Record<string, () => StudioConfig> = {\n  // The app's default wave: a centred, full-frame ribbon (window-independent framing).\n  // Shown first and named \"Hero\"; several presets below derive from it.\n  Hero: () =>\n    buildPreset({\n      speed: 0.04,\n      contrast: 1,\n      sat: 1,\n      hueRad: -0.00159265,\n      dispX: 0.005831,\n      dispZ: 0.016001,\n      dispAmt: -7.821,\n      pos: [380, -301.7, -11.1],\n      rotRad: [-0.44959, -0.11759, 1.874407],\n      scale: [9, 8, 5],\n      twF: [-0.65, 0.41, -0.58],\n      twP: [3.63, 0.7, 3.95],\n      glow: [1.98, 0.806, 0.834],\n      grain: 1.1,\n      blur: 0.02,\n      zoom: 0.55,\n      camTarget: [-420, -200], // user-tuned default framing\n    }),\n  // Stripe's real hero, recreated faithfully: an orthographic ×10 scene that overflows the\n  // frame, so only the twisted crop shows. This is the model's plain default config.\n  \"Wave 2\": () => createDefaultConfig(),\n  // camTarget on the waves below is a first-pass centring; tune per-wave. NOTE: Wave 4 also\n  // uses a variant vertex shader (animated twist-X wobble) we don't fully replicate — its\n  // STATIC frame is close, the motion differs.\n  \"Wave 3\": () =>\n    buildPreset({\n      speed: 0.08,\n      contrast: 1,\n      sat: 1,\n      hueRad: -0.00159265,\n      dispX: 0.005831,\n      dispZ: 0.016001,\n      dispAmt: -7.821,\n      pos: [-200.7, -65.4, -11.1],\n      rotRad: [-2.875593, 3.095927, -2.925927],\n      scale: [3, 3, 3],\n      twF: [0.059, 0.32, -0.397],\n      twP: [3.63, 0.44, 5.99],\n      glow: [3.86, 0.923, 1],\n      grain: 1.2,\n      blur: 0.02,\n      zoom: 1.3,\n      camTarget: [-104, 13], // centred; zoomed in (wide/flat wave)\n    }),\n  \"Wave 4\": () =>\n    buildPreset({\n      speed: 0.0525,\n      contrast: 0.969,\n      sat: 1.383,\n      hueRad: 0.0376991,\n      dispX: 0.005,\n      dispZ: 0.0212,\n      dispAmt: 6.68,\n      pos: [206.1, -438, -11.1],\n      rotRad: [-0.666018, -0.031416, 0.779115],\n      scale: [6.0501, 8.3983, 6.9854],\n      twF: [-0.424, 0.024, -1.312],\n      twP: [1.81, 0.94, 4.76],\n      glow: [1.55, 1.174, 0.972],\n      grain: 0.576,\n      blur: 0,\n      zoom: 0.9316,\n      camTarget: [194, -402], // centred on the wave\n      twistMotion: true, // variant vertex shader — animated twist-X wobble\n      noiseBands: [\n        {\n          startX: 0.856,\n          endX: 1,\n          startY: 0,\n          endY: 0.913,\n          feather: 0.5,\n          strength: 0.346,\n          frequency: 1018,\n          colorAttenuation: 1,\n          parabolaPower: 0,\n        },\n        {\n          startX: 0.038,\n          endX: 0.538,\n          startY: 0.105,\n          endY: 1,\n          feather: 0.3315,\n          strength: 1,\n          frequency: 190,\n          colorAttenuation: 0,\n          parabolaPower: 2.11,\n        },\n      ],\n    }),\n  // The dark-background hero: identical geometry/camera to the default hero, but theme\n  // \"wireframe\" → the line shader on a dark page background, with grain 1.2. Same palette.\n  Wireframe: () => {\n    const c = createDefaultConfig();\n    c.waves[0].theme = \"wireframe\";\n    c.grain = 1.2;\n    c.background = \"#0a2540\"; // dark navy page background\n    c.transparentBackground = false;\n    return c;\n  },\n  \"Neon Dark Multistrand\": () => {\n    const c = createDefaultConfig();\n    const w = c.waves[0];\n    w.theme = \"wireframe\"; // line shader on the near-black background — neon wireframe look\n    w.blendMode = \"additive\";\n    w.palette = makeStops([\"#00f5d4\", \"#00bbf9\", \"#9b5de5\", \"#f15bb5\", \"#fee440\"]);\n    w.creaseLight = 1.0;\n    c.background = \"#05060c\";\n    c.transparentBackground = false; // fill the dark bg so the neon lines read on black (not the page)\n    c.waves = makeWaveSpread(w, 3); // three overlapping neon waves\n    c.waveCount = 3;\n    return c;\n  },\n  \"Mesh Gradient\": () => {\n    const c = PRESETS[\"Hero\"](); // the centred default \"Hero\" wave\n    const w = c.waves[0];\n    w.gradientType = \"mesh\";\n    w.meshGradientPoints = [\n      { color: \"#0a84ff\", x: 0.06, y: 0.9, influence: 0.68 },\n      { color: \"#64d2ff\", x: 0.88, y: 0.92, influence: 0.72 },\n      { color: \"#bf5af2\", x: 0.5, y: 0.64, influence: 0.58 },\n      { color: \"#ff375f\", x: 0.1, y: 0.14, influence: 0.7 },\n      { color: \"#ff9f0a\", x: 0.84, y: 0.12, influence: 0.74 },\n      { color: \"#30d158\", x: 0.94, y: 0.5, influence: 0.54 },\n    ];\n    w.meshGradientSoftness = 0.68;\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1.06;\n    w.colorSaturation = 1.12;\n    w.fiberStrength = 0.14;\n    c.grain = 0.3;\n    c.blur = 0.008;\n    c.background = \"#070914\";\n    c.backgroundMode = \"color\";\n    c.transparentBackground = false;\n    return c;\n  },\n  \"Solar Bloom\": () => {\n    // Radial gradient: a warm core blooming out to a deep-indigo edge. usePaletteTexture off so\n    // our own stops map along the radial gradCoord instead of sampling the baked hero LUT.\n    const c = PRESETS[\"Hero\"]();\n    const w = c.waves[0];\n    w.usePaletteTexture = false;\n    w.gradientType = \"radial\";\n    w.gradientShift = 0.14;\n    w.palette = [\n      { color: \"#fff3c4\", pos: 0 }, // warm-white core\n      { color: \"#ffd166\", pos: 0.22 }, // gold\n      { color: \"#ff8c42\", pos: 0.42 }, // orange\n      { color: \"#ff5d8f\", pos: 0.62 }, // coral-pink\n      { color: \"#a64dff\", pos: 0.82 }, // violet\n      { color: \"#241246\", pos: 1 }, // deep indigo edge\n    ];\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1.05;\n    w.colorSaturation = 1.18;\n    w.fiberStrength = 0.12;\n    c.grain = 0.3;\n    c.blur = 0.01;\n    // Deep warm radial vignette behind the bloom.\n    c.background = \"#0a0714\";\n    c.backgroundMode = \"gradient\";\n    c.backgroundGradientType = \"radial\";\n    c.backgroundGradientSource = \"stops\";\n    c.backgroundPalette = makeStops([\"#2a1330\", \"#08040f\"]);\n    c.transparentBackground = false;\n    return c;\n  },\n  Holographic: () => {\n    // Conic gradient: an iridescent oil-slick sweep. The palette wraps (first ≈ last stop) so\n    // the conic seam is invisible.\n    const c = PRESETS[\"Hero\"]();\n    const w = c.waves[0];\n    w.usePaletteTexture = false;\n    w.gradientType = \"conic\";\n    w.gradientShift = 0.08;\n    w.palette = [\n      { color: \"#8ef6e4\", pos: 0 }, // mint (seam)\n      { color: \"#6ec3ff\", pos: 0.18 }, // sky\n      { color: \"#9b8cff\", pos: 0.36 }, // periwinkle\n      { color: \"#ff8ad8\", pos: 0.54 }, // pink\n      { color: \"#ffd98e\", pos: 0.72 }, // peach\n      { color: \"#a0f0c8\", pos: 0.88 }, // seafoam\n      { color: \"#8ef6e4\", pos: 1 }, // mint again (seamless wrap)\n    ];\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1.04;\n    w.colorSaturation = 1.12;\n    w.fiberStrength = 0.12;\n    c.grain = 0.28;\n    c.blur = 0.01;\n    // Subtle deep teal → violet wash behind the iridescence.\n    c.background = \"#05060c\";\n    c.backgroundMode = \"gradient\";\n    c.backgroundGradientType = \"linear\";\n    c.backgroundGradientAngle = 135;\n    c.backgroundGradientSource = \"stops\";\n    c.backgroundPalette = makeStops([\"#04121a\", \"#0a0518\"]);\n    c.transparentBackground = false;\n    return c;\n  },\n  Aurora: () => {\n    // Mesh gradient: a moody aurora — teals/greens drifting into violet over a night-sky base\n    // (distinct from the brighter iOS-style \"Mesh Gradient\").\n    const c = PRESETS[\"Hero\"]();\n    const w = c.waves[0];\n    w.gradientType = \"mesh\";\n    w.meshGradientPoints = [\n      { color: \"#0a1f3c\", x: 0.08, y: 0.12, influence: 0.62 },\n      { color: \"#1fddb0\", x: 0.3, y: 0.7, influence: 0.78 },\n      { color: \"#57f5a3\", x: 0.58, y: 0.86, influence: 0.7 },\n      { color: \"#3a86ff\", x: 0.82, y: 0.55, influence: 0.62 },\n      { color: \"#a15cff\", x: 0.5, y: 0.32, influence: 0.7 },\n      { color: \"#071433\", x: 0.92, y: 0.08, influence: 0.6 },\n    ];\n    w.meshGradientSoftness = 0.72;\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1.05;\n    w.colorSaturation = 1.18;\n    w.fiberStrength = 0.12;\n    c.grain = 0.3;\n    c.blur = 0.008;\n    // Dark night-sky MESH backdrop (also shows off the mesh background type).\n    c.background = \"#03060f\";\n    c.backgroundMode = \"gradient\";\n    c.backgroundGradientType = \"mesh\";\n    c.backgroundMeshPoints = [\n      { color: \"#02040c\", x: 0.15, y: 0.85, influence: 0.7 },\n      { color: \"#08243a\", x: 0.5, y: 0.5, influence: 0.75 },\n      { color: \"#0a0f2e\", x: 0.85, y: 0.7, influence: 0.7 },\n      { color: \"#04121a\", x: 0.7, y: 0.2, influence: 0.6 },\n      { color: \"#000208\", x: 0.12, y: 0.12, influence: 0.6 },\n    ];\n    c.backgroundMeshSoftness = 0.75;\n    c.transparentBackground = false;\n    return c;\n  },\n  Palestine: () => {\n    const c = PRESETS[\"Hero\"](); // the centred default \"Hero\" wave\n    const w = c.waves[0];\n    w.paletteSource = \"palestine\";\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1;\n    w.colorSaturation = 1;\n    c.grain = 0.35;\n    c.background = \"#f2efe8\";\n    c.transparentBackground = true;\n    return c;\n  },\n  \"Vaporwave Sunset\": () => {\n    // The Hero wave re-posed/re-framed, plus the vaporwave palette.\n    const c = PRESETS[\"Hero\"](); // the centred default \"Hero\" wave\n    const w = c.waves[0];\n    w.position.x = 525;\n    w.rotation.x = -0.64 * RAD;\n    w.rotation.z = 1.68 * RAD;\n    w.paletteSource = \"vaporwave\";\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1.08;\n    w.colorSaturation = 1.15;\n    w.creaseLight = 1.25;\n    c.cameraZoom = 1.1;\n    c.cameraTarget = { x: 150, y: 360, z: 0 };\n    c.background = \"#09051f\";\n    c.transparentBackground = false;\n    return c;\n  },\n  Kaleidoscope: () => {\n    const c = PRESETS[\"Wave 3\"]();\n    const w = c.waves[0];\n    w.paletteSource = \"kaleidoscope\";\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1.05;\n    w.colorSaturation = 1.12;\n    c.grain = 0.5;\n    return c;\n  },\n};\n"],"mappings":"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"}
+{"version":3,"file":"presets.js","names":[],"sources":["../src/presets.ts"],"sourcesContent":["/**\n * Built-in presets: each a complete studio config (scene + one or more waves) in the wave model.\n * IP-clean — no copyrighted assets. The studio layers its own extra presets (and its historical\n * \"Stripe *\" display names) on top; see apps/studio/src/presets.ts.\n */\nimport { createDefaultConfig, makeStops, makeWaveSpread } from \"./config/model\";\nimport type { StudioConfig, NoiseBand } from \"./config/model\";\n\nconst RAD = 180 / Math.PI;\n\n/** Build a preset from a set of wave parameters. rotation/hue are given in RADIANS and\n *  converted to degrees. All presets are solid-theme, so they reuse the hero palette +\n *  surfaceColor fibers (600/0.2) and sheen 0, like the hero. camTarget/zoom frame the\n *  wave (we pan the look-at to centre each one). */\nfunction buildPreset(p: {\n  speed: number;\n  contrast: number;\n  sat: number;\n  hueRad: number;\n  dispX: number;\n  dispZ: number;\n  dispAmt: number;\n  pos: [number, number, number];\n  rotRad: [number, number, number];\n  scale: [number, number, number];\n  twF: [number, number, number];\n  twP: [number, number, number];\n  glow: [number, number, number];\n  grain: number;\n  blur: number;\n  zoom: number;\n  camTarget: [number, number];\n  noiseBands?: NoiseBand[];\n  twistMotion?: boolean;\n}): StudioConfig {\n  const c = createDefaultConfig();\n  const w = c.waves[0];\n  w.speed = p.speed;\n  w.colorContrast = p.contrast;\n  w.colorSaturation = p.sat;\n  w.hueShift = p.hueRad * RAD;\n  w.displaceFrequency = { x: p.dispX, y: p.dispZ };\n  w.displaceAmount = p.dispAmt;\n  w.position = { x: p.pos[0], y: p.pos[1], z: p.pos[2] };\n  w.rotation = { x: p.rotRad[0] * RAD, y: p.rotRad[1] * RAD, z: p.rotRad[2] * RAD };\n  w.scale = { x: p.scale[0], y: p.scale[1], z: p.scale[2] };\n  w.twistFrequency = { x: p.twF[0], y: p.twF[1], z: p.twF[2] };\n  w.twistPower = { x: p.twP[0], y: p.twP[1], z: p.twP[2] };\n  w.creaseLight = p.glow[0];\n  w.creaseSharpness = p.glow[1];\n  w.creaseSoftness = p.glow[2];\n  if (p.noiseBands) w.noiseBands = p.noiseBands;\n  if (p.twistMotion) w.twistMotion = true;\n  c.grain = p.grain;\n  c.blur = p.blur;\n  c.cameraPosition = { x: 100, y: 0, z: 5000 };\n  c.cameraTarget = { x: p.camTarget[0], y: p.camTarget[1], z: 0 };\n  c.cameraZoom = p.zoom;\n  return c;\n}\n\n/** Presets: each a complete studio config (scene + one or more waves) in the wave model. */\nexport const PRESETS: Record<string, () => StudioConfig> = {\n  // The app's default wave: a centred, full-frame ribbon (window-independent framing).\n  // Shown first and named \"Hero\"; several presets below derive from it.\n  Hero: () =>\n    buildPreset({\n      speed: 0.04,\n      contrast: 1,\n      sat: 1,\n      hueRad: -0.00159265,\n      dispX: 0.005831,\n      dispZ: 0.016001,\n      dispAmt: -7.821,\n      pos: [380, -301.7, -11.1],\n      rotRad: [-0.44959, -0.11759, 1.874407],\n      scale: [9, 8, 5],\n      twF: [-0.65, 0.41, -0.58],\n      twP: [3.63, 0.7, 3.95],\n      glow: [1.98, 0.806, 0.834],\n      grain: 1.1,\n      blur: 0.02,\n      zoom: 0.55,\n      camTarget: [-420, -200], // user-tuned default framing\n    }),\n  // Stripe's real hero, recreated faithfully: an orthographic ×10 scene that overflows the\n  // frame, so only the twisted crop shows. This is the model's plain default config.\n  \"Wave 2\": () => createDefaultConfig(),\n  // camTarget on the waves below is a first-pass centring; tune per-wave. NOTE: Wave 4 also\n  // uses a variant vertex shader (animated twist-X wobble) we don't fully replicate — its\n  // STATIC frame is close, the motion differs.\n  \"Wave 3\": () =>\n    buildPreset({\n      speed: 0.08,\n      contrast: 1,\n      sat: 1,\n      hueRad: -0.00159265,\n      dispX: 0.005831,\n      dispZ: 0.016001,\n      dispAmt: -7.821,\n      pos: [-200.7, -65.4, -11.1],\n      rotRad: [-2.875593, 3.095927, -2.925927],\n      scale: [3, 3, 3],\n      twF: [0.059, 0.32, -0.397],\n      twP: [3.63, 0.44, 5.99],\n      glow: [3.86, 0.923, 1],\n      grain: 1.2,\n      blur: 0.02,\n      zoom: 1.3,\n      camTarget: [-104, 13], // centred; zoomed in (wide/flat wave)\n    }),\n  \"Wave 4\": () =>\n    buildPreset({\n      speed: 0.0525,\n      contrast: 0.969,\n      sat: 1.383,\n      hueRad: 0.0376991,\n      dispX: 0.005,\n      dispZ: 0.0212,\n      dispAmt: 6.68,\n      pos: [206.1, -438, -11.1],\n      rotRad: [-0.666018, -0.031416, 0.779115],\n      scale: [6.0501, 8.3983, 6.9854],\n      twF: [-0.424, 0.024, -1.312],\n      twP: [1.81, 0.94, 4.76],\n      glow: [1.55, 1.174, 0.972],\n      grain: 0.576,\n      blur: 0,\n      zoom: 0.9316,\n      camTarget: [194, -402], // centred on the wave\n      twistMotion: true, // variant vertex shader — animated twist-X wobble\n      noiseBands: [\n        {\n          startX: 0.856,\n          endX: 1,\n          startY: 0,\n          endY: 0.913,\n          feather: 0.5,\n          strength: 0.346,\n          frequency: 1018,\n          colorAttenuation: 1,\n          parabolaPower: 0,\n        },\n        {\n          startX: 0.038,\n          endX: 0.538,\n          startY: 0.105,\n          endY: 1,\n          feather: 0.3315,\n          strength: 1,\n          frequency: 190,\n          colorAttenuation: 0,\n          parabolaPower: 2.11,\n        },\n      ],\n    }),\n  // The dark-background hero: identical geometry/camera to the default hero, but theme\n  // \"wireframe\" → the line shader on a dark page background, with grain 1.2. Same palette.\n  Wireframe: () => {\n    const c = createDefaultConfig();\n    c.waves[0].theme = \"wireframe\";\n    c.grain = 1.2;\n    c.background = \"#0a2540\"; // dark navy page background\n    c.transparentBackground = false;\n    return c;\n  },\n  \"Neon Dark Multistrand\": () => {\n    const c = createDefaultConfig();\n    const w = c.waves[0];\n    w.theme = \"wireframe\"; // line shader on the near-black background — neon wireframe look\n    w.blendMode = \"additive\";\n    w.palette = makeStops([\"#00f5d4\", \"#00bbf9\", \"#9b5de5\", \"#f15bb5\", \"#fee440\"]);\n    w.creaseLight = 1.0;\n    c.background = \"#05060c\";\n    c.transparentBackground = false; // fill the dark bg so the neon lines read on black (not the page)\n    c.waves = makeWaveSpread(w, 3); // three overlapping neon waves\n    c.waveCount = 3;\n    return c;\n  },\n  \"Mesh Gradient\": () => {\n    const c = PRESETS[\"Hero\"](); // the centred default \"Hero\" wave\n    const w = c.waves[0];\n    w.gradientType = \"mesh\";\n    w.meshGradientPoints = [\n      { color: \"#0a84ff\", x: 0.06, y: 0.9, influence: 0.68 },\n      { color: \"#64d2ff\", x: 0.88, y: 0.92, influence: 0.72 },\n      { color: \"#bf5af2\", x: 0.5, y: 0.64, influence: 0.58 },\n      { color: \"#ff375f\", x: 0.1, y: 0.14, influence: 0.7 },\n      { color: \"#ff9f0a\", x: 0.84, y: 0.12, influence: 0.74 },\n      { color: \"#30d158\", x: 0.94, y: 0.5, influence: 0.54 },\n    ];\n    w.meshGradientSoftness = 0.68;\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1.06;\n    w.colorSaturation = 1.12;\n    w.fiberStrength = 0.14;\n    c.grain = 0.3;\n    c.blur = 0.008;\n    c.background = \"#070914\";\n    c.backgroundMode = \"color\";\n    c.transparentBackground = false;\n    return c;\n  },\n  \"Solar Bloom\": () => {\n    // Radial gradient: a warm core blooming out to a deep-indigo edge. usePaletteTexture off so\n    // our own stops map along the radial gradCoord instead of sampling the baked hero LUT.\n    const c = PRESETS[\"Hero\"]();\n    const w = c.waves[0];\n    w.usePaletteTexture = false;\n    w.gradientType = \"radial\";\n    w.gradientShift = 0.14;\n    w.palette = [\n      { color: \"#fff3c4\", pos: 0 }, // warm-white core\n      { color: \"#ffd166\", pos: 0.22 }, // gold\n      { color: \"#ff8c42\", pos: 0.42 }, // orange\n      { color: \"#ff5d8f\", pos: 0.62 }, // coral-pink\n      { color: \"#a64dff\", pos: 0.82 }, // violet\n      { color: \"#241246\", pos: 1 }, // deep indigo edge\n    ];\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1.05;\n    w.colorSaturation = 1.18;\n    w.fiberStrength = 0.12;\n    c.grain = 0.3;\n    c.blur = 0.01;\n    // Deep warm radial vignette behind the bloom.\n    c.background = \"#0a0714\";\n    c.backgroundMode = \"gradient\";\n    c.backgroundGradientType = \"radial\";\n    c.backgroundGradientSource = \"stops\";\n    c.backgroundPalette = makeStops([\"#2a1330\", \"#08040f\"]);\n    c.transparentBackground = false;\n    return c;\n  },\n  Holographic: () => {\n    // Conic gradient: an iridescent oil-slick sweep. The palette wraps (first ≈ last stop) so\n    // the conic seam is invisible.\n    const c = PRESETS[\"Hero\"]();\n    const w = c.waves[0];\n    w.usePaletteTexture = false;\n    w.gradientType = \"conic\";\n    w.gradientShift = 0.08;\n    w.palette = [\n      { color: \"#8ef6e4\", pos: 0 }, // mint (seam)\n      { color: \"#6ec3ff\", pos: 0.18 }, // sky\n      { color: \"#9b8cff\", pos: 0.36 }, // periwinkle\n      { color: \"#ff8ad8\", pos: 0.54 }, // pink\n      { color: \"#ffd98e\", pos: 0.72 }, // peach\n      { color: \"#a0f0c8\", pos: 0.88 }, // seafoam\n      { color: \"#8ef6e4\", pos: 1 }, // mint again (seamless wrap)\n    ];\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1.04;\n    w.colorSaturation = 1.12;\n    w.fiberStrength = 0.12;\n    c.grain = 0.28;\n    c.blur = 0.01;\n    // Subtle deep teal → violet wash behind the iridescence.\n    c.background = \"#05060c\";\n    c.backgroundMode = \"gradient\";\n    c.backgroundGradientType = \"linear\";\n    c.backgroundGradientAngle = 135;\n    c.backgroundGradientSource = \"stops\";\n    c.backgroundPalette = makeStops([\"#04121a\", \"#0a0518\"]);\n    c.transparentBackground = false;\n    return c;\n  },\n  Aurora: () => {\n    // Mesh gradient: a moody aurora — teals/greens drifting into violet over a night-sky base\n    // (distinct from the brighter iOS-style \"Mesh Gradient\").\n    const c = PRESETS[\"Hero\"]();\n    const w = c.waves[0];\n    w.gradientType = \"mesh\";\n    w.meshGradientPoints = [\n      { color: \"#0a1f3c\", x: 0.08, y: 0.12, influence: 0.62 },\n      { color: \"#1fddb0\", x: 0.3, y: 0.7, influence: 0.78 },\n      { color: \"#57f5a3\", x: 0.58, y: 0.86, influence: 0.7 },\n      { color: \"#3a86ff\", x: 0.82, y: 0.55, influence: 0.62 },\n      { color: \"#a15cff\", x: 0.5, y: 0.32, influence: 0.7 },\n      { color: \"#071433\", x: 0.92, y: 0.08, influence: 0.6 },\n    ];\n    w.meshGradientSoftness = 0.72;\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1.05;\n    w.colorSaturation = 1.18;\n    w.fiberStrength = 0.12;\n    c.grain = 0.3;\n    c.blur = 0.008;\n    // Dark night-sky MESH backdrop (also shows off the mesh background type).\n    c.background = \"#03060f\";\n    c.backgroundMode = \"gradient\";\n    c.backgroundGradientType = \"mesh\";\n    c.backgroundMeshPoints = [\n      { color: \"#02040c\", x: 0.15, y: 0.85, influence: 0.7 },\n      { color: \"#08243a\", x: 0.5, y: 0.5, influence: 0.75 },\n      { color: \"#0a0f2e\", x: 0.85, y: 0.7, influence: 0.7 },\n      { color: \"#04121a\", x: 0.7, y: 0.2, influence: 0.6 },\n      { color: \"#000208\", x: 0.12, y: 0.12, influence: 0.6 },\n    ];\n    c.backgroundMeshSoftness = 0.75;\n    c.transparentBackground = false;\n    return c;\n  },\n  Palestine: () => {\n    const c = PRESETS[\"Hero\"](); // the centred default \"Hero\" wave\n    const w = c.waves[0];\n    w.paletteSource = \"palestine\";\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1;\n    w.colorSaturation = 1;\n    c.grain = 0.35;\n    c.background = \"#f2efe8\";\n    c.transparentBackground = true;\n    return c;\n  },\n  Spain: () => {\n    const c = PRESETS[\"Hero\"](); // the centred default \"Hero\" wave\n    const w = c.waves[0];\n    w.paletteSource = \"spain\";\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1.18;\n    w.colorSaturation = 1.25;\n    w.creaseLight = 1.6; // moderate crease-light: rich crimson without washing to salmon (Hero's is 1.98)\n    c.grain = 0.3;\n    c.background = \"#1a0608\"; // deep oxblood stage\n    c.backgroundMode = \"color\";\n    c.transparentBackground = false; // opaque, so the dark stage makes the flag pop\n    return c;\n  },\n  \"Vaporwave Sunset\": () => {\n    // The Hero wave re-posed/re-framed, plus the vaporwave palette.\n    const c = PRESETS[\"Hero\"](); // the centred default \"Hero\" wave\n    const w = c.waves[0];\n    w.position.x = 525;\n    w.rotation.x = -0.64 * RAD;\n    w.rotation.z = 1.68 * RAD;\n    w.paletteSource = \"vaporwave\";\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1.08;\n    w.colorSaturation = 1.15;\n    w.creaseLight = 1.25;\n    c.cameraZoom = 1.1;\n    c.cameraTarget = { x: 150, y: 360, z: 0 };\n    c.background = \"#09051f\";\n    c.transparentBackground = false;\n    return c;\n  },\n  Kaleidoscope: () => {\n    const c = PRESETS[\"Wave 3\"]();\n    const w = c.waves[0];\n    w.paletteSource = \"kaleidoscope\";\n    w.blendMode = \"normal\";\n    w.hueShift = 0;\n    w.colorContrast = 1.05;\n    w.colorSaturation = 1.12;\n    c.grain = 0.5;\n    return c;\n  },\n};\n"],"mappings":"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"}

package/dist/renderer/WaveRenderer.d.ts

@@ -1,5 +1,6 @@
 import { StudioConfig, WaveConfig } from "../config/model.js";
 import { WaveGeometry } from "./WaveGeometry.js";
+import { InteractionController } from "./interaction.js";
 import * as THREE from "three";
 
 //#region src/renderer/WaveRenderer.d.ts
@@ -91,6 +92,15 @@ declare class WaveRenderer {
   private readonly clipSphere;
   private readonly clipTmpA;
   private readonly clipTmpB;
+  /** Created by syncInteraction() when interaction turns on, disposed when it turns off. */
+  protected interaction?: InteractionController;
+  /** Extra ortho-zoom MULTIPLIER from a cameraZoom binding (1 = none); applied in applyZoom().
+   *  Protected so the studio's writeCameraToConfig() can divide it back out (keep it out of config). */
+  protected interactionZoom: number;
+  /** Extra time-offset DELTA from a timeOffset binding (0 = none); added in updateTime(). */
+  private interactionTimeOffset;
+  /** Scene-binding out-params: appliers write into this, applyBindings() reads it back. */
+  private readonly interactionSceneOut;
   private readonly timer;
   private time;
   private rafId;
@@ -179,6 +189,30 @@ declare class WaveRenderer {
   private updateTime;
   /** Render exactly one frame at the current time. */
   renderOnce(): void;
+  /** Create/dispose the interaction controller as config toggles interaction on/off. Called from
+   *  refresh(); the compiled define set (POINTER_FX etc.) is handled separately by waveDefines(). */
+  private syncInteraction;
+  /** Per-frame interaction write: dynamic pointer-field uniforms + bindings. No-op without a
+   *  controller. While capturing it writes the REST state instead (pointer field zeroed, every bound
+   *  param at its authored base) — merely skipping the write would freeze whatever live hover/scroll
+   *  state the previous frame left in the uniforms, so exports wouldn't be deterministic. */
+  private applyInteraction;
+  /** Write the capture-frame interaction state: exactly what this config renders with no input —
+   *  pointer presence + ripple envelopes zeroed (vPointerFall gates every hover effect to 0) and each
+   *  bound param at its authored base. Live controller state is left untouched, so the frame after
+   *  the capture resumes mid-gesture; the trailing renderOnce() in captureImage restores the preview.
+   *  interactionZoom is deliberately NOT reset — captureImage strips it from camera.zoom itself, and
+   *  the post-capture restore depends on it being unchanged. */
+  private applyInteractionRest;
+  /** Write the dynamic pointer-field uniforms to every wave that HAS a pointer field. Position /
+   *  presence are PER WAVE (each trails the cursor at its own hover smoothing); ripple origins/ages
+   *  are shared. Per-wave amplitudes were already pushed statically in refresh(). */
+  private applyPointerField;
+  /** Evaluate bindings via the applier tables: value = mix(from ?? base, to, smoothedSource). Scene
+   *  bindings drive scene params; each wave's bindings drive that wave's uniforms. */
+  private applyBindings;
+  /** Feed a `custom:<name>` interaction input (developer API). No-op when interaction is off. */
+  setInteractionInput(name: string, value: number): void;
   /** Re-evaluate play/pause after `config.paused` changes. */
   refreshPlayback(): void;
   /** Jump the camera to the config's authored framing (cameraPosition / cameraTarget /

package/dist/renderer/WaveRenderer.js

@@ -1,6 +1,7 @@
 import { ensureStudioConfig } from "../config/model.js";
 import { fragmentShader, lineFragmentShader, postFragmentShader, postVertexShader, vertexShader } from "./shaders.js";
 import { WaveGeometry } from "./WaveGeometry.js";
+import { InteractionController, SCENE_APPLIERS, WAVE_APPLIERS, anyPointerFxActive, interactionActive, wavePointerFxActive, waveRipplesActive } from "./interaction.js";
 import { PALETTE_MAPS, buildBackgroundGradientCanvas, buildBackgroundImageCanvas, buildBackgroundMeshCanvas, buildPaletteTexture, canvasToTexture, configurePaletteTexture, drawBackgroundMediaFrame, loadPaletteImage, paletteMapCanvas, paletteSignature } from "./palette.js";
 import { buildHeroPaletteCanvas, buildHeroPaletteTexture } from "./heroPalette.js";
 import * as THREE from "three";
@@ -169,6 +170,18 @@ var WaveRenderer = class {
 	clipSphere = new THREE.Sphere();
 	clipTmpA = new THREE.Vector3();
 	clipTmpB = new THREE.Vector3();
+	/** Created by syncInteraction() when interaction turns on, disposed when it turns off. */
+	interaction;
+	/** Extra ortho-zoom MULTIPLIER from a cameraZoom binding (1 = none); applied in applyZoom().
+	*  Protected so the studio's writeCameraToConfig() can divide it back out (keep it out of config). */
+	interactionZoom = 1;
+	/** Extra time-offset DELTA from a timeOffset binding (0 = none); added in updateTime(). */
+	interactionTimeOffset = 0;
+	/** Scene-binding out-params: appliers write into this, applyBindings() reads it back. */
+	interactionSceneOut = {
+		timeOffset: 0,
+		zoom: 1
+	};
 	timer = new THREE.Timer();
 	time = 0;
 	rafId = 0;
@@ -276,6 +289,14 @@ var WaveRenderer = class {
 			bandParams.push(new THREE.Vector4());
 			bandParaPow.push(0);
 		}
+		const rippleOrigin = [];
+		const rippleAge = [];
+		const rippleAmp = [];
+		for (let i = 0; i < 4; i++) {
+			rippleOrigin.push(new THREE.Vector2());
+			rippleAge.push(0);
+			rippleAmp.push(0);
+		}
 		return {
 			uTime: { value: 0 },
 			uSpeed: { value: .05 },
@@ -342,7 +363,22 @@ var WaveRenderer = class {
 			uLineThickness: { value: 1 },
 			uLineDerivativePower: { value: .95 },
 			uMaxWidth: { value: 1232 },
-			uClearColor: { value: new THREE.Vector3(1, 1, 1) }
+			uClearColor: { value: new THREE.Vector3(1, 1, 1) },
+			uPointer: { value: new THREE.Vector2(0, 0) },
+			uPointerActive: { value: 0 },
+			uPointerRadius: { value: .6 },
+			uPointerAspect: { value: 1 },
+			uPointerAgitate: { value: 0 },
+			uPointerPush: { value: 0 },
+			uPointerWake: { value: 0 },
+			uPointerVel: { value: new THREE.Vector2(0, 0) },
+			uPointerThin: { value: 0 },
+			uPointerHue: { value: 0 },
+			uPointerLighten: { value: 0 },
+			uPointerRipple: { value: 0 },
+			uRippleOrigin: { value: rippleOrigin },
+			uRippleAge: { value: rippleAge },
+			uRippleAmp: { value: rippleAmp }
 		};
 	}
 	/** Vertex-shader #defines for a wave: TWIST_MOTION (per-wave animated twist wobble) and
@@ -352,9 +388,14 @@ var WaveRenderer = class {
 		const defines = {};
 		if (sc?.twistMotion) defines.TWIST_MOTION = "";
 		if ((this.config.loopSeconds ?? 0) > 0) defines.LOOP_MOTION = "";
-		if ((sc?.detailAmount ?? 0) !== 0) defines.DETAIL_OCTAVE = "";
+		const bindsDetail = sc?.interaction?.bindings?.some((b) => b.target === "detailAmount") ?? false;
+		if ((sc?.detailAmount ?? 0) !== 0 || bindsDetail) defines.DETAIL_OCTAVE = "";
 		if ((sc?.depthTint ?? 0) > 0) defines.DEPTH_TINT = "";
 		if ((sc?.edgeFeather ?? .1) !== .1) defines.EDGE_FEATHER = "";
+		if (sc && wavePointerFxActive(this.config, sc)) {
+			defines.POINTER_FX = "";
+			if (waveRipplesActive(this.config, sc)) defines.POINTER_RIPPLES = "";
+		}
 		return defines;
 	}
 	addWave() {
@@ -442,6 +483,7 @@ var WaveRenderer = class {
 	refresh() {
 		this.applyBackground();
 		this.applyPost();
+		this.syncInteraction();
 		if (!this.isCameraExternallyDriven()) {
 			const p = this.config.cameraPosition;
 			const tg = this.config.cameraTarget;
@@ -562,6 +604,21 @@ var WaveRenderer = class {
 			wave.mesh.position.set(sc.position.x, sc.position.y, sc.position.z);
 			u.uOpacity.value = sc.opacity;
 		});
+		const sharedRadius = (this.config.interaction?.radius ?? .3) * 2;
+		this.waves.forEach((wave, i) => {
+			const sc = this.config.waves[i] ?? this.config.waves[this.config.waves.length - 1];
+			if (!wavePointerFxActive(this.config, sc)) return;
+			const u = wave.material.uniforms;
+			const h = sc.interaction?.hover;
+			u.uPointerRadius.value = sharedRadius;
+			u.uPointerAgitate.value = h?.agitate ?? 0;
+			u.uPointerPush.value = h?.push ?? 0;
+			u.uPointerWake.value = h?.wake ?? 0;
+			u.uPointerThin.value = h?.thin ?? 0;
+			u.uPointerHue.value = h?.hueShift ?? 0;
+			u.uPointerLighten.value = h?.lighten ?? 0;
+			u.uPointerRipple.value = sc.interaction?.press?.ripple ?? 0;
+		});
 		this.updatePaletteTextures();
 		this.syncVideoPlayback();
 		this.group.scale.set(this.config.mirrorH ? -1 : 1, this.config.mirrorV ? -1 : 1, 1);
@@ -933,6 +990,7 @@ var WaveRenderer = class {
 		}
 		if (!this.running) {
 			this.introTimeRamp = 1;
+			this.interaction?.settle();
 			this.renderOnce();
 		}
 		this.syncVideoPlayback();
@@ -940,7 +998,9 @@ var WaveRenderer = class {
 	loop = () => {
 		if (!this.running) return;
 		this.timer.update();
-		this.time += this.timer.getDelta();
+		const dt = this.timer.getDelta();
+		this.time += dt;
+		this.interaction?.update(dt);
 		if (this.introTimeRamp < 1) this.introTimeRamp = Math.min(1, this.introTimeRamp + .016);
 		this.renderOnce();
 		this.rafId = requestAnimationFrame(this.loop);
@@ -949,7 +1009,7 @@ var WaveRenderer = class {
 	*  time = elapsed·introTimeRamp + timeOffset — the ramp eases the animation in on load. */
 	updateTime() {
 		const ramp = this.config.introRamp === false || this.skipIntroRamp ? 1 : this.introTimeRamp;
-		const t = this.time * ramp + (this.config.timeOffset ?? 0);
+		const t = this.time * ramp + (this.config.timeOffset ?? 0) + this.interactionTimeOffset;
 		for (let i = 0; i < this.waves.length; i++) {
 			const u = this.waves[i].material.uniforms;
 			u.uTime.value = t;
@@ -967,10 +1027,156 @@ var WaveRenderer = class {
 	renderOnce() {
 		this.updateBackgroundVideoFrame();
 		this.updateTime();
+		this.applyInteraction();
 		this.updateClipPlanes();
 		this.composer.render();
 		this.onAfterRenderFrame();
 	}
+	/** Create/dispose the interaction controller as config toggles interaction on/off. Called from
+	*  refresh(); the compiled define set (POINTER_FX etc.) is handled separately by waveDefines(). */
+	syncInteraction() {
+		const active = interactionActive(this.config);
+		if (active && !this.interaction) this.interaction = new InteractionController(this.container, () => this.config);
+		else if (!active && this.interaction) {
+			this.interaction.dispose();
+			this.interaction = void 0;
+			this.interactionTimeOffset = 0;
+			if (this.interactionZoom !== 1) {
+				this.interactionZoom = 1;
+				this.applyZoom();
+			}
+		}
+	}
+	/** Per-frame interaction write: dynamic pointer-field uniforms + bindings. No-op without a
+	*  controller. While capturing it writes the REST state instead (pointer field zeroed, every bound
+	*  param at its authored base) — merely skipping the write would freeze whatever live hover/scroll
+	*  state the previous frame left in the uniforms, so exports wouldn't be deterministic. */
+	applyInteraction() {
+		if (!this.interaction) return;
+		if (this.capturing) {
+			this.applyInteractionRest();
+			return;
+		}
+		if (anyPointerFxActive(this.config)) this.applyPointerField(this.interaction);
+		this.applyBindings(this.interaction);
+	}
+	/** Write the capture-frame interaction state: exactly what this config renders with no input —
+	*  pointer presence + ripple envelopes zeroed (vPointerFall gates every hover effect to 0) and each
+	*  bound param at its authored base. Live controller state is left untouched, so the frame after
+	*  the capture resumes mid-gesture; the trailing renderOnce() in captureImage restores the preview.
+	*  interactionZoom is deliberately NOT reset — captureImage strips it from camera.zoom itself, and
+	*  the post-capture restore depends on it being unchanged. */
+	applyInteractionRest() {
+		for (let i = 0; i < this.waves.length; i++) {
+			const sc = this.config.waves[i] ?? this.config.waves[this.config.waves.length - 1];
+			if (!wavePointerFxActive(this.config, sc)) continue;
+			const u = this.waves[i].material.uniforms;
+			u.uPointerActive.value = 0;
+			const rAmp = u.uRippleAmp.value;
+			for (let r = 0; r < 4; r++) rAmp[r] = 0;
+		}
+		const sceneBindings = this.config.interaction?.bindings;
+		if (sceneBindings) {
+			this.interactionSceneOut.timeOffset = this.config.timeOffset ?? 0;
+			this.interactionSceneOut.zoom = this.config.cameraZoom ?? 1;
+			const sceneArgs = {
+				post: this.postPass.uniforms,
+				out: this.interactionSceneOut
+			};
+			for (const b of sceneBindings) {
+				const applier = SCENE_APPLIERS[b.target];
+				applier.apply(applier.base(this.config), sceneArgs);
+			}
+		}
+		if (this.interactionTimeOffset !== 0) {
+			this.interactionTimeOffset = 0;
+			this.updateTime();
+		}
+		for (let i = 0; i < this.waves.length; i++) {
+			const sc = this.config.waves[i];
+			const bindings = sc?.interaction?.bindings;
+			if (!sc || !bindings || bindings.length === 0) continue;
+			const wave = this.waves[i];
+			for (const b of bindings) {
+				const applier = WAVE_APPLIERS[b.target];
+				applier.apply(applier.base(sc), {
+					u: wave.material.uniforms,
+					mesh: wave.mesh
+				});
+			}
+		}
+	}
+	/** Write the dynamic pointer-field uniforms to every wave that HAS a pointer field. Position /
+	*  presence are PER WAVE (each trails the cursor at its own hover smoothing); ripple origins/ages
+	*  are shared. Per-wave amplitudes were already pushed statically in refresh(). */
+	applyPointerField(ic) {
+		const dw = this.camera.right - this.camera.left;
+		const dh = this.camera.top - this.camera.bottom;
+		const aspect = dh !== 0 ? dw / dh : 1;
+		const ripples = ic.sample().ripples;
+		const agitateDrive = Math.min(1, .2 + .85 * ic.pointerFlux());
+		const vel = ic.pointerVelocity();
+		for (let i = 0; i < this.waves.length; i++) {
+			const sc = this.config.waves[i] ?? this.config.waves[this.config.waves.length - 1];
+			if (!wavePointerFxActive(this.config, sc)) continue;
+			const u = this.waves[i].material.uniforms;
+			u.uPointerAgitate.value = (sc.interaction?.hover?.agitate ?? 0) * agitateDrive;
+			u.uPointerVel.value.copy(vel);
+			const f = ic.fieldFor(i);
+			if (f) {
+				u.uPointer.value.copy(f.ndc);
+				u.uPointerActive.value = f.presence;
+			} else u.uPointerActive.value = 0;
+			u.uPointerAspect.value = aspect;
+			const rOrigin = u.uRippleOrigin.value;
+			const rAge = u.uRippleAge.value;
+			const rAmp = u.uRippleAmp.value;
+			for (let r = 0; r < 4; r++) {
+				rOrigin[r].copy(ripples[r].origin);
+				rAge[r] = ripples[r].age;
+				rAmp[r] = ripples[r].amp;
+			}
+		}
+	}
+	/** Evaluate bindings via the applier tables: value = mix(from ?? base, to, smoothedSource). Scene
+	*  bindings drive scene params; each wave's bindings drive that wave's uniforms. */
+	applyBindings(ic) {
+		this.interactionSceneOut.timeOffset = this.config.timeOffset ?? 0;
+		this.interactionSceneOut.zoom = this.config.cameraZoom ?? 1;
+		const sceneArgs = {
+			post: this.postPass.uniforms,
+			out: this.interactionSceneOut
+		};
+		for (const b of this.config.interaction?.bindings ?? []) {
+			const applier = SCENE_APPLIERS[b.target];
+			const value = THREE.MathUtils.lerp(b.from ?? applier.base(this.config), b.to, ic.bindingValue(b));
+			applier.apply(value, sceneArgs);
+		}
+		for (let i = 0; i < this.waves.length; i++) {
+			const sc = this.config.waves[i];
+			const bindings = sc?.interaction?.bindings;
+			if (!sc || !bindings || bindings.length === 0) continue;
+			const wave = this.waves[i];
+			for (const b of bindings) {
+				const applier = WAVE_APPLIERS[b.target];
+				const value = THREE.MathUtils.lerp(b.from ?? applier.base(sc), b.to, ic.bindingValue(b));
+				applier.apply(value, {
+					u: wave.material.uniforms,
+					mesh: wave.mesh
+				});
+			}
+		}
+		this.interactionTimeOffset = this.interactionSceneOut.timeOffset - (this.config.timeOffset ?? 0);
+		const nextZoom = this.interactionSceneOut.zoom / (this.config.cameraZoom || 1);
+		if (nextZoom !== this.interactionZoom) {
+			this.interactionZoom = nextZoom;
+			this.applyZoom();
+		}
+	}
+	/** Feed a `custom:<name>` interaction input (developer API). No-op when interaction is off. */
+	setInteractionInput(name, value) {
+		this.interaction?.setInput(name, value);
+	}
 	/** Re-evaluate play/pause after `config.paused` changes. */
 	refreshPlayback() {
 		this.updateRunning();
@@ -1005,7 +1211,7 @@ var WaveRenderer = class {
 	applyZoom() {
 		const dw = this.camera.right - this.camera.left;
 		const dh = this.camera.top - this.camera.bottom;
-		this.camera.zoom = Math.max(dw / FRAME_W, dh / 750) * (this.config.cameraZoom ?? 1);
+		this.camera.zoom = Math.max(dw / FRAME_W, dh / 750) * (this.config.cameraZoom ?? 1) * this.interactionZoom;
 		this.camera.updateProjectionMatrix();
 	}
 	/** Fit the orthographic near/far planes to the scene before every render, so no part of a wave
@@ -1025,14 +1231,21 @@ var WaveRenderer = class {
 	*  it's a handful of vector ops over 1–8 meshes with no allocation. */
 	updateClipPlanes() {
 		this.clipBox.makeEmpty();
-		for (const wave of this.waves) {
+		for (let i = 0; i < this.waves.length; i++) {
+			const wave = this.waves[i];
 			const mesh = wave.mesh;
 			mesh.updateWorldMatrix(true, false);
 			const bs = mesh.geometry.boundingSphere;
 			if (!bs) continue;
 			const center = this.clipTmpA.setFromMatrixPosition(mesh.matrixWorld);
 			const disp = Math.abs(Number(wave.material.uniforms.uDispAmount.value) || 0);
-			const radius = (bs.center.length() + bs.radius + disp) * mesh.matrixWorld.getMaxScaleOnAxis() * 1.2;
+			const sc = this.config.waves[i] ?? this.config.waves[this.config.waves.length - 1];
+			let pointerDisp = 0;
+			if (wavePointerFxActive(this.config, sc)) {
+				const h = sc.interaction?.hover;
+				pointerDisp = (h?.agitate ?? 0) + Math.abs(h?.push ?? 0) + (h?.wake ?? 0) + (sc.interaction?.press?.ripple ?? 0);
+			}
+			const radius = (bs.center.length() + bs.radius + disp + pointerDisp) * mesh.matrixWorld.getMaxScaleOnAxis() * 1.2;
 			this.clipBox.expandByPoint(this.clipTmpB.copy(center).addScalar(radius));
 			this.clipBox.expandByPoint(this.clipTmpB.copy(center).addScalar(-radius));
 		}
@@ -1065,12 +1278,22 @@ var WaveRenderer = class {
 			this.introTimeRamp = 1;
 		}
 		let blob = null;
+		const prevZoom = this.camera.zoom;
+		const strippingZoom = this.interactionZoom !== 1;
 		try {
 			this.capturing = true;
+			if (strippingZoom) {
+				this.camera.zoom = prevZoom / this.interactionZoom;
+				this.camera.updateProjectionMatrix();
+			}
 			this.renderOnce();
 			blob = await new Promise((resolve) => this.canvas.toBlob(resolve, mime, quality));
 		} finally {
 			this.capturing = false;
+			if (strippingZoom) {
+				this.camera.zoom = prevZoom;
+				this.camera.updateProjectionMatrix();
+			}
 			if (transparent !== prevBg) {
 				this.config.transparentBackground = prevBg;
 				this.applyBackground();
@@ -1104,6 +1327,8 @@ var WaveRenderer = class {
 	dispose() {
 		cancelAnimationFrame(this.rafId);
 		this.running = false;
+		this.interaction?.dispose();
+		this.interaction = void 0;
 		this.resizeObserver.disconnect();
 		this.intersectionObserver.disconnect();
 		this.motionQuery.removeEventListener("change", this.onMotionChange);