@wave3d/core 0.2.2 → 0.3.0

package/README.md

@@ -46,6 +46,53 @@ const blob = await handle.snapshot(); // resolves null until running. options: {
 </script>
 ```
 
+## Interactive waves
+
+Interactivity is **per wave** and **off by default** — omit it and the wave (and its compiled shader) is byte-for-byte unchanged. Each wave takes an optional `interaction` with three parts:
+
+- **`hover`** — the cursor-follow field: `agitate` (local churn), `push` (a ± dome that repels or attracts the surface), `wake` (a trailing trough behind the moving cursor), `thin`, `hueShift`, `lighten`, and `smoothing` (this wave's follow-lag — vary it across a stack for a parallax drag).
+- **`press`** — `ripple` (rings from a click / tap).
+- **`bindings`** — inputs that drive this wave's params: `{ source, target, from?, to }`.
+
+```tsx
+// React — the flat `interaction` prop targets the first wave:
+<Wave3D
+  interaction={{
+    hover: { agitate: 6, thin: 0.4 }, // local churn + strand-thinning under the cursor
+    press: { ripple: 6 }, // click ripples
+    bindings: [{ source: "hover", target: "displaceAmount", to: 12 }], // taller folds while hovered
+  }}
+/>
+```
+
+Each binding rests at the authored value (`from` defaults to it) and moves toward `to` as its input rises 0→1 — sources: `scroll`, `hover`, `pointerX` / `pointerY`, `pointerSpeed`, `press`, `scrollVelocity`, `appear`, and `custom:*`.
+
+Shared inputs (one cursor + scroll) and scene-wide effects live on the scene-level `interaction`:
+
+```ts
+createWave(el, {
+  interaction: {
+    radius: 0.3, // shared pointer falloff (fraction of viewport height)
+    touch: false, // follow touch pointers too
+    bindings: [{ source: "scroll", target: "timeOffset", to: 40 }], // scrub the whole wave with scroll
+  },
+  waves: [
+    /* each wave carries its own `interaction` (hover / press / bindings) */
+  ],
+});
+```
+
+Pair `scroll → timeOffset` with a low `speed` for a wave that scrubs _with_ the page instead of drifting on its own. Feed your own signal with a `custom:` source and `setInteractionInput`:
+
+```tsx
+<Wave3D
+  interaction={{ bindings: [{ source: "custom:audio", target: "displaceAmount", to: 30 }] }}
+  onReady={(r) => {
+    analyser.onLevel = (v) => r.setInteractionInput("audio", v); // v in 0..1
+  }}
+/>
+```
+
 ## Entry points
 
 | Import                    | What                                                           |

package/dist/config/model.d.ts

@@ -152,6 +152,96 @@ interface WaveConfig {
   opacity: number;
   /** Phase/seed so waves don't move in lockstep. */
   seed: number;
+  /** Optional per-wave interactivity: how THIS wave reacts to the shared pointer + inputs (hover
+   *  field, click ripples, param bindings). ABSENT = this wave is inert / byte-identical. */
+  interaction?: WaveInteractionConfig;
+}
+/**
+ * An interaction INPUT: a normalized signal that can smoothly drive config params through an
+ * {@link InteractionBinding}. Every source is exponentially smoothed before it is applied.
+ */
+type InteractionSource = "scroll" | "hover" | "pointerX" | "pointerY" | "pointerSpeed" | "press" | "scrollVelocity" | "appear" | `custom:${string}`;
+/** Per-WAVE params a binding may drive. Single source of truth for WAVE_APPLIERS in
+ *  renderer/interaction.ts (checked via `satisfies`) and validated by normalizeWaveInteraction. */
+declare const WAVE_TARGET_NAMES: readonly ["displaceAmount", "detailAmount", "twistPowerX", "twistPowerY", "twistPowerZ", "twistFrequencyX", "twistFrequencyY", "twistFrequencyZ", "hueShift", "gradientShift", "colorSaturation", "opacity", "lineThickness", "lineAmount", "fiberStrength", "sheen", "iridescence", "positionX", "positionY"];
+/** A per-wave param a {@link WaveInteractionBinding} can drive. */
+type WaveInteractionTarget = (typeof WAVE_TARGET_NAMES)[number];
+/** SCENE params a binding may drive (post / camera / time — shared, not per wave). Single source of
+ *  truth for SCENE_APPLIERS in renderer/interaction.ts, validated by normalizeSceneInteraction. */
+declare const SCENE_TARGET_NAMES: readonly ["timeOffset", "cameraZoom", "blur", "grain"];
+/** A scene-level param a {@link SceneInteractionBinding} can drive. */
+type SceneInteractionTarget = (typeof SCENE_TARGET_NAMES)[number];
+/** Shared fields of an input→param binding: per frame `value = mix(from ?? authoredBase, to,
+ *  smoothedSource)`, written straight to uniforms — never mutates config, so any refresh restores
+ *  the authored base (removal needs no undo step). */
+interface InteractionBindingBase {
+  /** The input signal driving this binding. */
+  source: InteractionSource;
+  /** Value at source = 0. OMITTED = the authored base value, so at rest the authored look shows. */
+  from?: number;
+  /** Value at source = 1. */
+  to: number;
+  /** Exponential smoothing time constant, seconds (default 0.25); also shapes the `appear` ramp. */
+  smoothing?: number;
+}
+/** A binding on a wave, driving one of that wave's params. */
+interface WaveInteractionBinding extends InteractionBindingBase {
+  target: WaveInteractionTarget;
+}
+/** A scene-level binding, driving a shared scene param. */
+interface SceneInteractionBinding extends InteractionBindingBase {
+  target: SceneInteractionTarget;
+}
+/** Hover pointer-field: localized effects that follow the cursor over this wave. Present ⇒ the
+ *  POINTER_FX shader path compiles for this wave; an absent effect is 0 (inert). */
+interface WaveHoverConfig {
+  /** Local churn-octave amplitude near the cursor — the wave agitates under the pointer. The studio
+   *  defaults this positive when you enable a hover field, so a fresh hover reacts out of the box. */
+  agitate?: number;
+  /** Membrane push/pull: a smooth dome at the cursor that swells toward you (repel, +) or dents away
+   *  (attract, −), carried by the sprung field so it drags like a poke under fabric. World units;
+   *  0 = off. */
+  push?: number;
+  /** Drag-wake: while the cursor moves, the surface just BEHIND it is pulled into a trailing trough
+   *  that heals once you stop; scales with pointer speed. World units; 0 = off. */
+  wake?: number;
+  /** 0..1 — wireframe strands taper to hairlines; solid gains local translucency. */
+  thin?: number;
+  /** Local hue rotation near the cursor, degrees. */
+  hueShift?: number;
+  /** Local brightness lift near the cursor, -1..1. */
+  lighten?: number;
+  /** Pointer-follow smoothing for THIS wave's hover field, seconds — how quickly the swell trails
+   *  the cursor. Vary it across a stack so strands lag at different rates (a parallax drag).
+   *  Default 0.12. */
+  smoothing?: number;
+}
+/** Click / touch pointer-field: what a tap or click on this wave triggers. */
+interface WavePressConfig {
+  /** Click-ripple amplitude; 0 keeps this wave's POINTER_RIPPLES path uncompiled. */
+  ripple?: number;
+}
+/** Per-wave interactivity: this wave's own reaction to the shared pointer + inputs. ABSENT ⇒ inert. */
+interface WaveInteractionConfig {
+  /** Hover field (cursor-follow agitation / thinning / hue-lighten). */
+  hover?: WaveHoverConfig;
+  /** Click & touch (ripples radiating from a tap/click on this wave). */
+  press?: WavePressConfig;
+  /** Input→param bindings driving THIS wave's params (any source, incl. scroll / hover / custom). */
+  bindings?: WaveInteractionBinding[];
+}
+/** Scene-level interactivity: the SHARED inputs (one cursor + scroll, touch) plus bindings that
+ *  drive shared scene params. Pointer-follow smoothing is per-wave (see WaveHoverConfig.smoothing).
+ *  ABSENT ⇒ inputs use defaults; `enabled: false` is the master OFF switch for the whole layer. */
+interface SceneInteractionConfig {
+  /** Master switch for the whole interaction layer. Default true (only `false` turns it all off). */
+  enabled?: boolean;
+  /** Pointer falloff radius, as a fraction of viewport height. Default 0.3. */
+  radius?: number;
+  /** Follow coarse (touch) pointers. Default false — touch is ignored unless this is true. */
+  touch?: boolean;
+  /** Input→param bindings driving SCENE params (timeOffset, cameraZoom, blur, grain). */
+  bindings?: SceneInteractionBinding[];
 }
 /**
  * Scene-level settings shared by every wave: output/background/camera/lights, the post-fx
@@ -207,6 +297,9 @@ interface SceneConfig {
   /** Mirror the whole composition on screen (world-space flip). */
   mirrorH: boolean;
   mirrorV: boolean;
+  /** Shared interaction inputs (one cursor + scroll) + scene-param bindings. Per-wave response
+   *  lives on each WaveConfig.interaction. ABSENT = defaults; `enabled:false` disables the layer. */
+  interaction?: SceneInteractionConfig;
 }
 /** The full save-state: scene settings + one or more complete waves. */
 interface StudioConfig extends SceneConfig {
@@ -231,10 +324,20 @@ declare function ensureCamera(config: StudioConfig): void;
 declare function normalizeWave(s: WaveConfig): void;
 /** Backfill scene-level defaults (background/camera/post/lights/quality/mirror). */
 declare function ensureSceneDefaults(config: StudioConfig): void;
+/**
+ * Present-only normalizer for a WAVE's interaction block: clamp the hover/press numerics that are
+ * present (absent fields stay absent, so the block stays lean and the renderer's defaults apply) and
+ * drop bindings with an unknown source/target or a non-finite `to`. NEVER call when the block is
+ * absent — absence is inert and byte-identical (normalizeWave gates on presence).
+ */
+declare function normalizeWaveInteraction(wave: WaveConfig): void;
+/** Present-only normalizer for the SCENE interaction block: clamp the shared pointer inputs and drop
+ *  invalid scene bindings. NEVER call when the block is absent. */
+declare function normalizeSceneInteraction(config: StudioConfig): void;
 /** Normalize an ingested config to the wave model: backfill the scene + every wave, and drop in
  *  a default wave if none are present. Idempotent, so it is safe on the renderer's own config as
  *  well as freshly loaded save-states / share links. */
 declare function ensureStudioConfig(input: StudioConfig): StudioConfig;
 //#endregion
-export { BackgroundImageFit, BackgroundMode, BasicGradientType, BlendMode, ColorStop, DEFAULT_LIGHT_POSITION, GradientType, LightConfig, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, MeshGradientPoint, NoiseBand, PaletteSource, SceneConfig, StudioConfig, Vec2, Vec3, WaveConfig, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, normalizeBackground, normalizeWave, resizeWaves };
+export { BackgroundImageFit, BackgroundMode, BasicGradientType, BlendMode, ColorStop, DEFAULT_LIGHT_POSITION, GradientType, InteractionSource, LightConfig, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, MeshGradientPoint, NoiseBand, PaletteSource, SceneConfig, SceneInteractionBinding, SceneInteractionConfig, SceneInteractionTarget, StudioConfig, Vec2, Vec3, WaveConfig, WaveHoverConfig, WaveInteractionBinding, WaveInteractionConfig, WaveInteractionTarget, WavePressConfig, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, normalizeBackground, normalizeSceneInteraction, normalizeWave, normalizeWaveInteraction, resizeWaves };
 //# sourceMappingURL=model.d.ts.map

package/dist/config/model.js

@@ -89,6 +89,49 @@ function createDefaultMeshPoints() {
 		}
 	];
 }
+/** The built-in interaction input names (the open-ended `custom:*` family is handled separately).
+*  Kept in sync by hand with the {@link InteractionSource} union below. */
+const INTERACTION_SOURCE_NAMES = [
+	"scroll",
+	"hover",
+	"pointerX",
+	"pointerY",
+	"pointerSpeed",
+	"press",
+	"scrollVelocity",
+	"appear"
+];
+/** Per-WAVE params a binding may drive. Single source of truth for WAVE_APPLIERS in
+*  renderer/interaction.ts (checked via `satisfies`) and validated by normalizeWaveInteraction. */
+const WAVE_TARGET_NAMES = [
+	"displaceAmount",
+	"detailAmount",
+	"twistPowerX",
+	"twistPowerY",
+	"twistPowerZ",
+	"twistFrequencyX",
+	"twistFrequencyY",
+	"twistFrequencyZ",
+	"hueShift",
+	"gradientShift",
+	"colorSaturation",
+	"opacity",
+	"lineThickness",
+	"lineAmount",
+	"fiberStrength",
+	"sheen",
+	"iridescence",
+	"positionX",
+	"positionY"
+];
+/** SCENE params a binding may drive (post / camera / time — shared, not per wave). Single source of
+*  truth for SCENE_APPLIERS in renderer/interaction.ts, validated by normalizeSceneInteraction. */
+const SCENE_TARGET_NAMES = [
+	"timeOffset",
+	"cameraZoom",
+	"blur",
+	"grain"
+];
 /** Spread a base wave into `count` overlapping waves — each with a slightly varied hue, width,
 *  speed, phase, vertical offset and roll so a stack reads as one composition. `count === 1`
 *  returns the base unchanged. Used to author multi-wave presets. */
@@ -458,6 +501,7 @@ function normalizeWave(s) {
 	if (typeof s.speed !== "number") s.speed = .04;
 	if (typeof s.opacity !== "number") s.opacity = 1;
 	if (typeof s.seed !== "number") s.seed = 0;
+	if (s.interaction) normalizeWaveInteraction(s);
 }
 /** Backfill scene-level defaults (background/camera/post/lights/quality/mirror). */
 function ensureSceneDefaults(config) {
@@ -479,6 +523,71 @@ function ensureSceneDefaults(config) {
 	if (typeof config.mirrorH !== "boolean") config.mirrorH = false;
 	if (typeof config.mirrorV !== "boolean") config.mirrorV = false;
 }
+/** Clamp an untrusted numeric field, falling back to `dflt` when it isn't a finite number. */
+function clampNumber(v, min, max, dflt) {
+	const n = Number(v);
+	return Number.isFinite(n) ? clamp(n, min, max) : dflt;
+}
+/** True for a valid interaction source string: a built-in name or a non-empty `custom:<name>`. */
+function isInteractionSource(v) {
+	return typeof v === "string" && (INTERACTION_SOURCE_NAMES.includes(v) || v.startsWith("custom:") && v.length > 7);
+}
+/** Rebuild an untrusted bindings array into valid bindings for `valid` targets (loaded share-links /
+*  presets are untrusted JSON; we validate source/target/to and rebuild clean objects). */
+function cleanBindings(raw, valid) {
+	const out = [];
+	if (!Array.isArray(raw)) return out;
+	for (const item of raw) {
+		if (!item || typeof item !== "object") continue;
+		const b = item;
+		if (!isInteractionSource(b.source)) continue;
+		if (!valid.includes(b.target)) continue;
+		const to = Number(b.to);
+		if (!Number.isFinite(to)) continue;
+		const clean = {
+			source: b.source,
+			target: b.target,
+			to
+		};
+		if (b.from !== void 0) {
+			const f = Number(b.from);
+			if (Number.isFinite(f)) clean.from = f;
+		}
+		if (b.smoothing !== void 0) clean.smoothing = clampNumber(b.smoothing, 0, 2, .25);
+		out.push(clean);
+	}
+	return out;
+}
+/**
+* Present-only normalizer for a WAVE's interaction block: clamp the hover/press numerics that are
+* present (absent fields stay absent, so the block stays lean and the renderer's defaults apply) and
+* drop bindings with an unknown source/target or a non-finite `to`. NEVER call when the block is
+* absent — absence is inert and byte-identical (normalizeWave gates on presence).
+*/
+function normalizeWaveInteraction(wave) {
+	const it = wave.interaction;
+	if (!it) return;
+	const h = it.hover;
+	if (h) {
+		if (h.agitate !== void 0) h.agitate = clampNumber(h.agitate, 0, 60, 0);
+		if (h.push !== void 0) h.push = clampNumber(h.push, -40, 40, 0);
+		if (h.wake !== void 0) h.wake = clampNumber(h.wake, 0, 40, 0);
+		if (h.thin !== void 0) h.thin = clampNumber(h.thin, 0, 1, 0);
+		if (h.hueShift !== void 0) h.hueShift = clampNumber(h.hueShift, -360, 360, 0);
+		if (h.lighten !== void 0) h.lighten = clampNumber(h.lighten, -1, 1, 0);
+		if (h.smoothing !== void 0) h.smoothing = clampNumber(h.smoothing, 0, 2, .12);
+	}
+	if (it.press && it.press.ripple !== void 0) it.press.ripple = clampNumber(it.press.ripple, 0, 60, 0);
+	if (it.bindings !== void 0) it.bindings = cleanBindings(it.bindings, WAVE_TARGET_NAMES);
+}
+/** Present-only normalizer for the SCENE interaction block: clamp the shared pointer inputs and drop
+*  invalid scene bindings. NEVER call when the block is absent. */
+function normalizeSceneInteraction(config) {
+	const it = config.interaction;
+	if (!it) return;
+	if (it.radius !== void 0) it.radius = clampNumber(it.radius, .02, 2, .3);
+	if (it.bindings !== void 0) it.bindings = cleanBindings(it.bindings, SCENE_TARGET_NAMES);
+}
 /** Normalize an ingested config to the wave model: backfill the scene + every wave, and drop in
 *  a default wave if none are present. Idempotent, so it is safe on the renderer's own config as
 *  well as freshly loaded save-states / share links. */
@@ -488,9 +597,10 @@ function ensureStudioConfig(input) {
 	if (!Array.isArray(config.waves) || config.waves.length === 0) config.waves = [makeWave()];
 	config.waves.forEach(normalizeWave);
 	config.waveCount = config.waves.length;
+	if (config.interaction) normalizeSceneInteraction(config);
 	return config;
 }
 //#endregion
-export { DEFAULT_LIGHT_POSITION, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, normalizeBackground, normalizeWave, resizeWaves };
+export { DEFAULT_LIGHT_POSITION, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, normalizeBackground, normalizeSceneInteraction, normalizeWave, normalizeWaveInteraction, resizeWaves };
 
 //# sourceMappingURL=model.js.map

package/dist/config/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","names":[],"sources":["../../src/config/model.ts"],"sourcesContent":["/**\n * Configuration schema for the wave: a flat sheet displaced by noise (X/Z frequency\n * + amount) then twisted by three axis-rotations (twistFrequency + twistPower per\n * axis), then scaled / rotated / positioned. Plain JSON — doubles as the save-state\n * format.\n */\n\nimport { clamp, clamp01 } from \"../util/math\";\n\nexport const MAX_COLORS = 8;\nexport const MAX_MESH_POINTS = 8;\nexport const MAX_LIGHTS = 8;\nexport const MAX_NOISE_BANDS = 4;\n/** Cap on stacked waves (keeps total geometry bounded — see WaveRenderer segment scaling). */\nexport const MAX_WAVES = 6;\n\nexport interface Vec2 {\n  x: number;\n  y: number;\n}\n\nexport interface Vec3 {\n  x: number;\n  y: number;\n  z: number;\n}\n\n// \"squared\" = the hero material blend: SrcColor × Zero (framebuffer = fragColor²), which\n// deepens the colours — the faithful default. \"normal\"/\"additive\"/\"multiply\" are authoring\n// overrides (\"multiply\" darkens where waves/background overlap).\nexport type BlendMode = \"squared\" | \"normal\" | \"additive\" | \"multiply\";\n\n/** How the palette is mapped across the surface. */\nexport type BasicGradientType = \"linear\" | \"radial\" | \"conic\";\nexport type GradientType = BasicGradientType | \"mesh\";\n\nexport type BackgroundMode = \"color\" | \"gradient\" | \"image\";\nexport type BackgroundImageFit = \"cover\" | \"contain\" | \"stretch\";\n\n/** What fills the 2D palette texture: the baked hero LUT, our editable stops, or\n *  a named built-in map (see PALETTE_MAPS). Any string is allowed for forward-compat. */\nexport type PaletteSource = \"hero\" | \"stops\" | (string & {});\n\n/** A positionable light. `position` lives in the same 3D space as the wave. */\nexport interface LightConfig {\n  position: Vec3;\n  color: string;\n  intensity: number;\n}\n\n/** A default light; pass overrides for added fill lights. */\nexport function createLight(\n  position: Vec3 = { x: 300, y: 500, z: 800 },\n  intensity = 1,\n): LightConfig {\n  return { position: { ...position }, color: \"#ffffff\", intensity };\n}\n\n/** Where the first light lands when you engage lights from an empty scene. Shared by the\n *  \"drag in 3D\" control and the camera-rig minimap, which previews a light marker here so the\n *  rig always shows the light — even before one has been explicitly added. */\nexport const DEFAULT_LIGHT_POSITION: Vec3 = { x: 800, y: 900, z: 1100 };\n\n/**\n * A noise band: inside a rectangular uv region (startX..endX along the length,\n * startY..endY across the width, softened by `feather`), the fiber streaks are\n * overridden — strength, frequency (density), colourAttenuation (how much the local\n * colour suppresses them), and the end-weighting parabolaPower. Lets the fibers vary\n * per region instead of uniform.\n */\nexport interface NoiseBand {\n  startX: number;\n  endX: number;\n  startY: number;\n  endY: number;\n  feather: number;\n  strength: number;\n  frequency: number;\n  colorAttenuation: number;\n  parabolaPower: number;\n}\n\n/** A default band: a strong, coarse streak region over the first half. */\nexport function createNoiseBand(): NoiseBand {\n  return {\n    startX: 0.0,\n    endX: 0.5,\n    startY: 0.0,\n    endY: 1.0,\n    feather: 0.3,\n    strength: 1.0,\n    frequency: 220,\n    colorAttenuation: 0.0,\n    parabolaPower: 2.0,\n  };\n}\n\n/** One gradient stop: a colour at a normalized position (0–1) across the width. */\nexport interface ColorStop {\n  color: string;\n  pos: number;\n}\n\n/** One colour influence point in the 2D mesh-gradient field. */\nexport interface MeshGradientPoint {\n  color: string;\n  /** Horizontal UV position (0–1). */\n  x: number;\n  /** Vertical UV position (0–1). */\n  y: number;\n  /** Relative reach of this point's colour field. */\n  influence: number;\n}\n\n/** Build evenly-spaced stops from a plain list of colours. */\nexport function makeStops(colors: string[]): ColorStop[] {\n  const n = colors.length;\n  return colors.map((color, i) => ({ color, pos: n > 1 ? i / (n - 1) : 0 }));\n}\n\n/** A balanced iOS-style field shown the first time Mesh is selected. */\nexport function createDefaultMeshPoints(): MeshGradientPoint[] {\n  return [\n    { color: \"#5e5ce6\", x: 0.08, y: 0.12, influence: 0.78 },\n    { color: \"#64d2ff\", x: 0.88, y: 0.08, influence: 0.72 },\n    { color: \"#ff375f\", x: 0.12, y: 0.88, influence: 0.72 },\n    { color: \"#ff9f0a\", x: 0.9, y: 0.86, influence: 0.78 },\n    { color: \"#bf5af2\", x: 0.5, y: 0.48, influence: 0.58 },\n  ];\n}\n\n/**\n * A single wave: a COMPLETE, self-contained wave — its own shape, twist, colour, finish,\n * transform and blend. Stacking waves composites independent waves; there is no shared\n * \"base wave\" any more, so nothing is duplicated between a global section and the waves.\n * Field names mirror the legacy top-level wave fields so migration + the per-section helpers\n * (normalizeWaveColour, randomize*) map 1:1.\n */\nexport interface WaveConfig {\n  // Colour & gradient\n  palette: ColorStop[];\n  gradientType: GradientType;\n  gradientAngle: number;\n  gradientShift: number;\n  meshGradientPoints: MeshGradientPoint[];\n  meshGradientSoftness: number;\n  usePaletteTexture: boolean;\n  paletteSource: PaletteSource;\n  paletteImageUrl?: string;\n  paletteVideoUrl?: string;\n  paletteTextureScale: Vec2;\n  paletteTextureOffset: Vec2;\n  paletteTextureRotation: number;\n  /** Palette-offset drift per second (animates colour independently of the geometry; 0 = static).\n   *  Applies to any texture palette (not mesh / procedural stops). */\n  paletteDriftX: number;\n  paletteDriftY: number;\n  paletteEdgeColor: string;\n  paletteEdgeAmount: number;\n  hueShift: number;\n  colorContrast: number;\n  colorSaturation: number;\n  // Surface finish\n  fiberCount: number;\n  fiberStrength: number;\n  noiseBands: NoiseBand[];\n  texture: number;\n  creaseLight: number;\n  creaseSharpness: number;\n  creaseSoftness: number;\n  sheen: number;\n  roundness: number;\n  /** Thin-film / holographic hue response that shifts with view angle (0 = off). */\n  iridescence: number;\n  edgeFade: number;\n  /** Softness of the ribbon's long edges (smoothstep width across uv.y). 0.1 = the original\n   *  hardcoded value; smaller = razor-crisp graphic ribbons, larger = soft vapor. */\n  edgeFeather: number;\n  /** Depth tint (solid theme): fade far fragments toward depthTintColor for atmospheric\n   *  separation in multi-wave stacks (0 = off). */\n  depthTint: number;\n  depthTintColor: string;\n  // Displacement + twist (the wave shape)\n  displaceFrequency: Vec2;\n  displaceAmount: number;\n  /** Optional 2nd displacement octave: finer ripples riding on the broad swell (amount 0 = off). */\n  detailFrequency: number;\n  detailAmount: number;\n  twistFrequency: Vec3;\n  twistPower: Vec3;\n  twistMotion?: boolean;\n  // Material (\"solid\" surface vs \"wireframe\" line shader)\n  theme?: \"solid\" | \"wireframe\";\n  lineAmount?: number;\n  lineThickness?: number;\n  lineDerivativePower?: number;\n  maxWidth?: number;\n  // Transform (absolute — no shared base to offset from)\n  position: Vec3;\n  rotation: Vec3;\n  scale: Vec3;\n  // Compositing\n  blendMode: BlendMode;\n  /** Absolute animation speed for this wave (legacy global speed × per-layer multiplier). */\n  speed: number;\n  /** Overall opacity of this wave. */\n  opacity: number;\n  /** Phase/seed so waves don't move in lockstep. */\n  seed: number;\n}\n\n/**\n * Scene-level settings shared by every wave: output/background/camera/lights, the post-fx\n * pass (grain/blur), playback, quality, and the whole-composition mirror. Everything that\n * describes an individual wave lives on WaveConfig instead.\n */\nexport interface SceneConfig {\n  background: string;\n  transparentBackground: boolean;\n  backgroundMode: BackgroundMode;\n  backgroundPalette: ColorStop[];\n  backgroundGradientType: GradientType;\n  backgroundGradientAngle: number;\n  backgroundGradientSource: PaletteSource;\n  backgroundMeshPoints: MeshGradientPoint[];\n  backgroundMeshSoftness: number;\n  backgroundImageSource: PaletteSource;\n  backgroundImageUrl?: string;\n  backgroundVideoUrl?: string;\n  backgroundImageFit: BackgroundImageFit;\n  backgroundImageZoom: number;\n  backgroundImagePosition: Vec2;\n  /** Number of stacked waves (kept in sync with waves.length). */\n  waveCount: number;\n  quality: number;\n  dprMax: number;\n  paused: boolean;\n  /** Noise phase offset — scrubs the noise pattern to pick a still frame. */\n  timeOffset?: number;\n  /** Seamless-loop period in seconds (0 = off). When >0, the motion is mapped onto a circle in\n   *  noise space so it repeats exactly every `loopSeconds` — scene-level so a multi-wave stack\n   *  shares one period and the whole composite loops. */\n  loopSeconds?: number;\n  introRamp?: boolean;\n  showCameraRig: boolean;\n  cameraDistance: number;\n  cameraZoom: number;\n  cameraPosition: Vec3;\n  cameraTarget: Vec3;\n  /** Film grain amount (post pass). */\n  grain: number;\n  /** Soft-focus / spin blur amount (post pass). */\n  blur: number;\n  blurSamples?: number;\n  /** Bloom (post pass, UnrealBloomPass). strength 0 removes the pass entirely, so cost and pixels\n   *  are identical to bloom-off; radius/threshold only take effect once strength > 0. */\n  bloomStrength?: number;\n  bloomRadius?: number;\n  bloomThreshold?: number;\n  /** Base ambient light level (0–1). */\n  ambient: number;\n  lights: LightConfig[];\n  /** Mirror the whole composition on screen (world-space flip). */\n  mirrorH: boolean;\n  mirrorV: boolean;\n}\n\n/** The full save-state: scene settings + one or more complete waves. */\nexport interface StudioConfig extends SceneConfig {\n  waves: WaveConfig[];\n}\n\n/** Spread a base wave into `count` overlapping waves — each with a slightly varied hue, width,\n *  speed, phase, vertical offset and roll so a stack reads as one composition. `count === 1`\n *  returns the base unchanged. Used to author multi-wave presets. */\nexport function makeWaveSpread(base: WaveConfig, count: number): WaveConfig[] {\n  if (count <= 1) return [structuredClone(base)];\n  const out: WaveConfig[] = [];\n  for (let i = 0; i < count; i++) {\n    const f = i / (count - 1);\n    const w = structuredClone(base);\n    w.opacity = 1.0 - f * 0.3;\n    w.hueShift = base.hueShift + i * 18;\n    w.scale = { x: base.scale.x, y: base.scale.y * (1 - f * 0.2), z: base.scale.z };\n    w.speed = base.speed * (1 + f * 0.15);\n    w.seed = i * 3.3;\n    w.position = {\n      x: base.position.x,\n      y: base.position.y + (f - 0.5) * 1.5,\n      z: base.position.z - i * 0.8,\n    };\n    w.rotation = { x: base.rotation.x, y: base.rotation.y, z: base.rotation.z + i * 20 };\n    out.push(w);\n  }\n  return out;\n}\n\n/** The hero wave (a single complete wave) — the base for the default config and most presets. */\nfunction defaultWave(): WaveConfig {\n  return {\n    // The hero palette: a periwinkle tip/edge, a dominant orange core, then coral → magenta →\n    // pink, with a violet twist tip. gradientShift warps it to mimic a baked 2D palette texture.\n    palette: [\n      { color: \"#8e9dff\", pos: 0 }, // periwinkle (blue tip/edge)\n      { color: \"#c98fd0\", pos: 0.14 }, // lavender transition\n      { color: \"#ff9326\", pos: 0.3 }, // orange (rising)\n      { color: \"#fd8108\", pos: 0.52 }, // orange core\n      { color: \"#fb7a36\", pos: 0.64 }, // orange-coral (keeps orange dominant)\n      { color: \"#d24ecc\", pos: 0.78 }, // true magenta (hue ~303, not pink)\n      { color: \"#e95cae\", pos: 0.9 }, // pink-magenta\n      { color: \"#9b6ae0\", pos: 1.0 }, // violet (twist tip)\n    ],\n    gradientType: \"linear\",\n    gradientAngle: 90, // 90° = the gradient runs ALONG the length (uv.x)\n    gradientShift: 0.15,\n    meshGradientPoints: createDefaultMeshPoints(),\n    meshGradientSoftness: 0.62,\n    usePaletteTexture: true, // default to the baked hero LUT\n    paletteSource: \"hero\",\n    paletteTextureScale: { x: 1, y: 1 },\n    paletteTextureOffset: { x: 0, y: 0 },\n    paletteTextureRotation: 0,\n    paletteDriftX: 0,\n    paletteDriftY: 0,\n    paletteEdgeColor: \"#8e9dff\",\n    paletteEdgeAmount: 0.3,\n    hueShift: -1.81, // hero colorHueShift ≈ -1.81°\n    colorContrast: 1.0,\n    colorSaturation: 1.15,\n    // Hero fibers: the surfaceColor fragment hardcodes freq 600 / strength 0.2; the line* fields\n    // feed the wireframe theme (unused by the solid hero).\n    fiberCount: 600,\n    fiberStrength: 0.2,\n    noiseBands: [],\n    texture: 0,\n    creaseLight: 0.6,\n    creaseSharpness: 0.589,\n    creaseSoftness: 1.0,\n    // sheen 0 + roundness 0: the ortho crop makes crease low, so the hero look comes from the\n    // SrcColor² blend + the palette, not the derivative white-lift.\n    sheen: 0.0,\n    roundness: 0.0,\n    iridescence: 0,\n    edgeFade: 0.04,\n    edgeFeather: 0.1, // the original hardcoded ribbon-edge softness\n    depthTint: 0,\n    depthTintColor: \"#0a2540\",\n    // Hero deformation on the native 400-unit folded() geometry.\n    displaceFrequency: { x: 0.003234, y: 0.00799 },\n    displaceAmount: 6.051,\n    detailFrequency: 0.04, // finer than the base swell; only bites once detailAmount > 0\n    detailAmount: 0,\n    // Small twist frequencies + high powers — a gentle twist; the drama is the ortho crop.\n    twistFrequency: { x: -0.055, y: 0.077, z: -0.518 },\n    twistPower: { x: 3.95, y: 5.85, z: 6.33 },\n    twistMotion: false,\n    theme: \"solid\",\n    lineAmount: 425, // wireframe-theme line params (defaults)\n    lineThickness: 1,\n    lineDerivativePower: 0.95,\n    maxWidth: 1232,\n    // Hero mesh transform at FULL scale (the ortho camera frames in pixels).\n    position: { x: -24.3, y: -56.4, z: -11.1 },\n    rotation: { x: -9.14, y: -16.25, z: -161.32 },\n    scale: { x: 10, y: 10, z: 7 },\n    blendMode: \"squared\", // the hero squaring blend (SrcColor²)\n    speed: 0.04, // hero speed: 4e-5 vs ms-time ≈ 0.04/s\n    opacity: 1,\n    seed: 0,\n  };\n}\n\n/** A fresh default wave (the hero wave as one complete wave). */\nexport function makeWave(): WaveConfig {\n  return defaultWave();\n}\n\n/** Resize `waves` to match `waveCount`. New waves CLONE the last one (inherit every\n *  property of the preceding wave); extras are dropped. */\nexport function resizeWaves(config: StudioConfig): void {\n  const target = Math.max(1, Math.round(config.waveCount) || 1);\n  if (!Array.isArray(config.waves) || config.waves.length === 0) {\n    config.waves = [makeWave()];\n  }\n  while (config.waves.length < target) {\n    config.waves.push(structuredClone(config.waves[config.waves.length - 1]));\n  }\n  while (config.waves.length > target) config.waves.pop();\n  config.waveCount = config.waves.length;\n}\n\n/** The default studio config: the hero wave + its scene, in the canonical wave model. */\nexport function createDefaultConfig(): StudioConfig {\n  return {\n    background: \"#ffffff\",\n    transparentBackground: true,\n    backgroundMode: \"color\",\n    backgroundPalette: makeStops([\"#0a2540\", \"#425466\", \"#7a73ff\", \"#f6f9fc\"]),\n    backgroundGradientType: \"linear\",\n    backgroundGradientAngle: 135,\n    backgroundGradientSource: \"stops\",\n    backgroundMeshPoints: createDefaultMeshPoints(),\n    backgroundMeshSoftness: 0.62,\n    backgroundImageSource: \"vaporwave\",\n    backgroundImageFit: \"cover\",\n    backgroundImageZoom: 1,\n    backgroundImagePosition: { x: 0, y: 0 },\n    waveCount: 1,\n    quality: 1,\n    dprMax: 2,\n    paused: false,\n    timeOffset: 0, // noise phase (scrub to pick a still)\n    introRamp: true, // ease the animation in over ~1s on load (skipped in dev; see WaveRenderer.updateTime)\n    showCameraRig: false,\n    // The hero camera: ORTHOGRAPHIC at (100,0,5000) looking at the origin. The mesh is ×10 so\n    // the wave overflows the frame and only the twist shows. cameraZoom is a user multiplier on\n    // the responsive base zoom (1 = the hero crop); cameraTarget pans the look-at to the twist.\n    cameraDistance: 5001,\n    cameraPosition: { x: 100, y: 0, z: 5000 },\n    cameraTarget: { x: -44, y: -250, z: 0 },\n    cameraZoom: 1.0,\n    // Post (one pass over the whole composite): hero grain 1.1, blur 0.02.\n    grain: 1.1,\n    blur: 0.02,\n    blurSamples: 6,\n    ambient: 0.45,\n    lights: [], // hero has no lights — colour is the palette + the SrcColor² blend\n    mirrorH: false,\n    mirrorV: false,\n    waves: [defaultWave()],\n  };\n}\n\n/** Clamp/backfill a single wave's colour + palette fields (legacy `string[]` palettes become\n *  ColorStop[]; mesh points + texture transform are clamped). */\nfunction normalizeWaveColour(config: WaveConfig): void {\n  const p = config.palette as unknown as Array<string | ColorStop>;\n  if (p.length > 0 && typeof p[0] === \"string\") {\n    config.palette = makeStops(p as string[]);\n  }\n  if (\n    config.gradientType !== \"radial\" &&\n    config.gradientType !== \"conic\" &&\n    config.gradientType !== \"mesh\" &&\n    config.gradientType !== \"linear\"\n  ) {\n    config.gradientType = \"linear\";\n  }\n  const rawMeshPoints = config.meshGradientPoints as MeshGradientPoint[] | undefined;\n  if (!Array.isArray(rawMeshPoints) || rawMeshPoints.length < 2) {\n    config.meshGradientPoints = createDefaultMeshPoints();\n  } else {\n    const defaults = createDefaultMeshPoints();\n    config.meshGradientPoints = rawMeshPoints.slice(0, MAX_MESH_POINTS).map((point, index) => {\n      const fallback = defaults[index] ?? defaults[defaults.length - 1];\n      const x = Number(point.x);\n      const y = Number(point.y);\n      const influence = Number(point.influence);\n      return {\n        color: typeof point.color === \"string\" ? point.color : fallback.color,\n        x: clamp01(Number.isFinite(x) ? x : fallback.x),\n        y: clamp01(Number.isFinite(y) ? y : fallback.y),\n        influence: clamp(Number.isFinite(influence) ? influence : fallback.influence, 0.15, 1.5),\n      };\n    });\n  }\n  if (!Number.isFinite(config.meshGradientSoftness)) config.meshGradientSoftness = 0.62;\n  config.meshGradientSoftness = clamp01(config.meshGradientSoftness);\n  if (!config.paletteTextureScale) config.paletteTextureScale = { x: 1, y: 1 };\n  if (!config.paletteTextureOffset) config.paletteTextureOffset = { x: 0, y: 0 };\n  config.paletteTextureScale.x = clamp(Number(config.paletteTextureScale.x) || 1, 0.1, 8);\n  config.paletteTextureScale.y = clamp(Number(config.paletteTextureScale.y) || 1, 0.1, 8);\n  config.paletteTextureOffset.x = clamp(Number(config.paletteTextureOffset.x) || 0, -4, 4);\n  config.paletteTextureOffset.y = clamp(Number(config.paletteTextureOffset.y) || 0, -4, 4);\n  config.paletteTextureRotation = clamp(Number(config.paletteTextureRotation) || 0, -180, 180);\n}\n\n/** Backfill background styling for states saved before gradient/image backgrounds existed. */\nexport function normalizeBackground(config: StudioConfig): void {\n  if (\n    config.backgroundMode !== \"gradient\" &&\n    config.backgroundMode !== \"image\" &&\n    config.backgroundMode !== \"color\"\n  ) {\n    config.backgroundMode = \"color\";\n  }\n  const palette = config.backgroundPalette as unknown as Array<string | ColorStop> | undefined;\n  if (!palette || palette.length < 2) {\n    config.backgroundPalette = makeStops([\"#0a2540\", \"#425466\", \"#7a73ff\", \"#f6f9fc\"]);\n  } else if (typeof palette[0] === \"string\") {\n    config.backgroundPalette = makeStops(palette as string[]);\n  }\n  if (\n    config.backgroundGradientType !== \"radial\" &&\n    config.backgroundGradientType !== \"conic\" &&\n    config.backgroundGradientType !== \"mesh\" &&\n    config.backgroundGradientType !== \"linear\"\n  ) {\n    config.backgroundGradientType = \"linear\";\n  }\n  const bgMesh = config.backgroundMeshPoints as MeshGradientPoint[] | undefined;\n  if (!Array.isArray(bgMesh) || bgMesh.length < 2) {\n    config.backgroundMeshPoints = createDefaultMeshPoints();\n  }\n  if (!Number.isFinite(config.backgroundMeshSoftness)) config.backgroundMeshSoftness = 0.62;\n  config.backgroundMeshSoftness = clamp01(config.backgroundMeshSoftness);\n  if (typeof config.backgroundGradientAngle !== \"number\") config.backgroundGradientAngle = 135;\n  if (typeof config.backgroundGradientSource !== \"string\")\n    config.backgroundGradientSource = \"stops\";\n  if (typeof config.backgroundImageSource !== \"string\") config.backgroundImageSource = \"vaporwave\";\n  if (\n    config.backgroundImageFit !== \"contain\" &&\n    config.backgroundImageFit !== \"stretch\" &&\n    config.backgroundImageFit !== \"cover\"\n  ) {\n    config.backgroundImageFit = \"cover\";\n  }\n  if (typeof config.backgroundImageZoom !== \"number\") config.backgroundImageZoom = 1;\n  config.backgroundImageZoom = clamp(config.backgroundImageZoom, 0.1, 8);\n  if (!config.backgroundImagePosition) config.backgroundImagePosition = { x: 0, y: 0 };\n  if (typeof config.backgroundImagePosition.x !== \"number\") config.backgroundImagePosition.x = 0;\n  if (typeof config.backgroundImagePosition.y !== \"number\") config.backgroundImagePosition.y = 0;\n  config.backgroundImagePosition.x = clamp(config.backgroundImagePosition.x, -100, 100);\n  config.backgroundImagePosition.y = clamp(config.backgroundImagePosition.y, -100, 100);\n}\n\n/** Backfill camera position/target for states saved before they existed. */\nexport function ensureCamera(config: StudioConfig): void {\n  if (!config.cameraPosition)\n    config.cameraPosition = { x: 0, y: 0, z: config.cameraDistance ?? 62 };\n  if (!config.cameraTarget) config.cameraTarget = { x: 0, y: 0, z: 0 };\n  if (typeof config.cameraZoom !== \"number\") config.cameraZoom = 1;\n}\n\n/** Backfill/repair a wave so the renderer can consume it (covers partial wave-model JSON). */\nexport function normalizeWave(s: WaveConfig): void {\n  normalizeWaveColour(s);\n  if (typeof s.gradientAngle !== \"number\") s.gradientAngle = 90;\n  if (typeof s.gradientShift !== \"number\") s.gradientShift = 0.15;\n  if (typeof s.usePaletteTexture !== \"boolean\") s.usePaletteTexture = true;\n  if (typeof s.paletteSource !== \"string\") s.paletteSource = \"hero\";\n  if (typeof s.paletteEdgeColor !== \"string\") s.paletteEdgeColor = \"#8e9dff\";\n  if (typeof s.paletteEdgeAmount !== \"number\") s.paletteEdgeAmount = 0.3;\n  if (typeof s.paletteDriftX !== \"number\") s.paletteDriftX = 0;\n  if (typeof s.paletteDriftY !== \"number\") s.paletteDriftY = 0;\n  if (typeof s.hueShift !== \"number\") s.hueShift = 0;\n  if (typeof s.colorContrast !== \"number\") s.colorContrast = 1;\n  if (typeof s.colorSaturation !== \"number\") s.colorSaturation = 1;\n  if (typeof s.fiberCount !== \"number\") s.fiberCount = 600;\n  if (typeof s.fiberStrength !== \"number\") s.fiberStrength = 0.2;\n  if (!Array.isArray(s.noiseBands)) s.noiseBands = [];\n  if (typeof s.texture !== \"number\") s.texture = 0;\n  if (typeof s.creaseLight !== \"number\") s.creaseLight = 0.6;\n  if (typeof s.creaseSharpness !== \"number\") s.creaseSharpness = 0.589;\n  if (typeof s.creaseSoftness !== \"number\") s.creaseSoftness = 1;\n  if (typeof s.sheen !== \"number\") s.sheen = 0;\n  if (typeof s.roundness !== \"number\") s.roundness = 0;\n  if (typeof s.iridescence !== \"number\") s.iridescence = 0;\n  if (typeof s.edgeFade !== \"number\") s.edgeFade = 0.04;\n  if (typeof s.edgeFeather !== \"number\") s.edgeFeather = 0.1;\n  if (typeof s.depthTint !== \"number\") s.depthTint = 0;\n  if (typeof s.depthTintColor !== \"string\") s.depthTintColor = \"#0a2540\";\n  if (!s.displaceFrequency) s.displaceFrequency = { x: 0.003234, y: 0.00799 };\n  if (typeof s.displaceAmount !== \"number\") s.displaceAmount = 6.051;\n  if (typeof s.detailFrequency !== \"number\") s.detailFrequency = 0.04;\n  if (typeof s.detailAmount !== \"number\") s.detailAmount = 0;\n  if (!s.twistFrequency) s.twistFrequency = { x: -0.055, y: 0.077, z: -0.518 };\n  if (!s.twistPower) s.twistPower = { x: 3.95, y: 5.85, z: 6.33 };\n  if (typeof s.theme !== \"string\") s.theme = \"solid\";\n  if (typeof s.lineAmount !== \"number\") s.lineAmount = 425;\n  if (typeof s.lineThickness !== \"number\") s.lineThickness = 1;\n  if (typeof s.lineDerivativePower !== \"number\") s.lineDerivativePower = 0.95;\n  if (typeof s.maxWidth !== \"number\") s.maxWidth = 1232;\n  if (!s.position) s.position = { x: 0, y: 0, z: 0 };\n  if (!s.rotation) s.rotation = { x: 0, y: 0, z: 0 };\n  if (!s.scale) s.scale = { x: 10, y: 10, z: 7 };\n  if (typeof s.blendMode !== \"string\") s.blendMode = \"squared\";\n  if (typeof s.speed !== \"number\") s.speed = 0.04;\n  if (typeof s.opacity !== \"number\") s.opacity = 1;\n  if (typeof s.seed !== \"number\") s.seed = 0;\n}\n\n/** Backfill scene-level defaults (background/camera/post/lights/quality/mirror). */\nexport function ensureSceneDefaults(config: StudioConfig): void {\n  normalizeBackground(config);\n  ensureCamera(config);\n  if (typeof config.ambient !== \"number\") config.ambient = 0.45;\n  if (!Array.isArray(config.lights)) config.lights = [];\n  if (typeof config.quality !== \"number\") config.quality = 1;\n  if (typeof config.dprMax !== \"number\") config.dprMax = 2;\n  if (typeof config.grain !== \"number\") config.grain = 1.1;\n  if (typeof config.blur !== \"number\") config.blur = 0.02;\n  if (typeof config.blurSamples !== \"number\") config.blurSamples = 6;\n  if (typeof config.bloomStrength !== \"number\") config.bloomStrength = 0;\n  if (typeof config.bloomRadius !== \"number\") config.bloomRadius = 0.4;\n  if (typeof config.bloomThreshold !== \"number\") config.bloomThreshold = 0.85;\n  if (typeof config.showCameraRig !== \"boolean\") config.showCameraRig = false;\n  if (typeof config.paused !== \"boolean\") config.paused = false;\n  if (typeof config.loopSeconds !== \"number\") config.loopSeconds = 0;\n  if (typeof config.mirrorH !== \"boolean\") config.mirrorH = false;\n  if (typeof config.mirrorV !== \"boolean\") config.mirrorV = false;\n}\n\n/** Normalize an ingested config to the wave model: backfill the scene + every wave, and drop in\n *  a default wave if none are present. Idempotent, so it is safe on the renderer's own config as\n *  well as freshly loaded save-states / share links. */\nexport function ensureStudioConfig(input: StudioConfig): StudioConfig {\n  const config = input;\n  ensureSceneDefaults(config);\n  if (!Array.isArray(config.waves) || config.waves.length === 0) {\n    config.waves = [makeWave()];\n  }\n  config.waves.forEach(normalizeWave);\n  config.waveCount = config.waves.length;\n  return config;\n}\n"],"mappings":"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"}
+{"version":3,"file":"model.js","names":[],"sources":["../../src/config/model.ts"],"sourcesContent":["/**\n * Configuration schema for the wave: a flat sheet displaced by noise (X/Z frequency\n * + amount) then twisted by three axis-rotations (twistFrequency + twistPower per\n * axis), then scaled / rotated / positioned. Plain JSON — doubles as the save-state\n * format.\n */\n\nimport { clamp, clamp01 } from \"../util/math\";\n\nexport const MAX_COLORS = 8;\nexport const MAX_MESH_POINTS = 8;\nexport const MAX_LIGHTS = 8;\nexport const MAX_NOISE_BANDS = 4;\n/** Cap on stacked waves (keeps total geometry bounded — see WaveRenderer segment scaling). */\nexport const MAX_WAVES = 6;\n\nexport interface Vec2 {\n  x: number;\n  y: number;\n}\n\nexport interface Vec3 {\n  x: number;\n  y: number;\n  z: number;\n}\n\n// \"squared\" = the hero material blend: SrcColor × Zero (framebuffer = fragColor²), which\n// deepens the colours — the faithful default. \"normal\"/\"additive\"/\"multiply\" are authoring\n// overrides (\"multiply\" darkens where waves/background overlap).\nexport type BlendMode = \"squared\" | \"normal\" | \"additive\" | \"multiply\";\n\n/** How the palette is mapped across the surface. */\nexport type BasicGradientType = \"linear\" | \"radial\" | \"conic\";\nexport type GradientType = BasicGradientType | \"mesh\";\n\nexport type BackgroundMode = \"color\" | \"gradient\" | \"image\";\nexport type BackgroundImageFit = \"cover\" | \"contain\" | \"stretch\";\n\n/** What fills the 2D palette texture: the baked hero LUT, our editable stops, or\n *  a named built-in map (see PALETTE_MAPS). Any string is allowed for forward-compat. */\nexport type PaletteSource = \"hero\" | \"stops\" | (string & {});\n\n/** A positionable light. `position` lives in the same 3D space as the wave. */\nexport interface LightConfig {\n  position: Vec3;\n  color: string;\n  intensity: number;\n}\n\n/** A default light; pass overrides for added fill lights. */\nexport function createLight(\n  position: Vec3 = { x: 300, y: 500, z: 800 },\n  intensity = 1,\n): LightConfig {\n  return { position: { ...position }, color: \"#ffffff\", intensity };\n}\n\n/** Where the first light lands when you engage lights from an empty scene. Shared by the\n *  \"drag in 3D\" control and the camera-rig minimap, which previews a light marker here so the\n *  rig always shows the light — even before one has been explicitly added. */\nexport const DEFAULT_LIGHT_POSITION: Vec3 = { x: 800, y: 900, z: 1100 };\n\n/**\n * A noise band: inside a rectangular uv region (startX..endX along the length,\n * startY..endY across the width, softened by `feather`), the fiber streaks are\n * overridden — strength, frequency (density), colourAttenuation (how much the local\n * colour suppresses them), and the end-weighting parabolaPower. Lets the fibers vary\n * per region instead of uniform.\n */\nexport interface NoiseBand {\n  startX: number;\n  endX: number;\n  startY: number;\n  endY: number;\n  feather: number;\n  strength: number;\n  frequency: number;\n  colorAttenuation: number;\n  parabolaPower: number;\n}\n\n/** A default band: a strong, coarse streak region over the first half. */\nexport function createNoiseBand(): NoiseBand {\n  return {\n    startX: 0.0,\n    endX: 0.5,\n    startY: 0.0,\n    endY: 1.0,\n    feather: 0.3,\n    strength: 1.0,\n    frequency: 220,\n    colorAttenuation: 0.0,\n    parabolaPower: 2.0,\n  };\n}\n\n/** One gradient stop: a colour at a normalized position (0–1) across the width. */\nexport interface ColorStop {\n  color: string;\n  pos: number;\n}\n\n/** One colour influence point in the 2D mesh-gradient field. */\nexport interface MeshGradientPoint {\n  color: string;\n  /** Horizontal UV position (0–1). */\n  x: number;\n  /** Vertical UV position (0–1). */\n  y: number;\n  /** Relative reach of this point's colour field. */\n  influence: number;\n}\n\n/** Build evenly-spaced stops from a plain list of colours. */\nexport function makeStops(colors: string[]): ColorStop[] {\n  const n = colors.length;\n  return colors.map((color, i) => ({ color, pos: n > 1 ? i / (n - 1) : 0 }));\n}\n\n/** A balanced iOS-style field shown the first time Mesh is selected. */\nexport function createDefaultMeshPoints(): MeshGradientPoint[] {\n  return [\n    { color: \"#5e5ce6\", x: 0.08, y: 0.12, influence: 0.78 },\n    { color: \"#64d2ff\", x: 0.88, y: 0.08, influence: 0.72 },\n    { color: \"#ff375f\", x: 0.12, y: 0.88, influence: 0.72 },\n    { color: \"#ff9f0a\", x: 0.9, y: 0.86, influence: 0.78 },\n    { color: \"#bf5af2\", x: 0.5, y: 0.48, influence: 0.58 },\n  ];\n}\n\n/**\n * A single wave: a COMPLETE, self-contained wave — its own shape, twist, colour, finish,\n * transform and blend. Stacking waves composites independent waves; there is no shared\n * \"base wave\" any more, so nothing is duplicated between a global section and the waves.\n * Field names mirror the legacy top-level wave fields so migration + the per-section helpers\n * (normalizeWaveColour, randomize*) map 1:1.\n */\nexport interface WaveConfig {\n  // Colour & gradient\n  palette: ColorStop[];\n  gradientType: GradientType;\n  gradientAngle: number;\n  gradientShift: number;\n  meshGradientPoints: MeshGradientPoint[];\n  meshGradientSoftness: number;\n  usePaletteTexture: boolean;\n  paletteSource: PaletteSource;\n  paletteImageUrl?: string;\n  paletteVideoUrl?: string;\n  paletteTextureScale: Vec2;\n  paletteTextureOffset: Vec2;\n  paletteTextureRotation: number;\n  /** Palette-offset drift per second (animates colour independently of the geometry; 0 = static).\n   *  Applies to any texture palette (not mesh / procedural stops). */\n  paletteDriftX: number;\n  paletteDriftY: number;\n  paletteEdgeColor: string;\n  paletteEdgeAmount: number;\n  hueShift: number;\n  colorContrast: number;\n  colorSaturation: number;\n  // Surface finish\n  fiberCount: number;\n  fiberStrength: number;\n  noiseBands: NoiseBand[];\n  texture: number;\n  creaseLight: number;\n  creaseSharpness: number;\n  creaseSoftness: number;\n  sheen: number;\n  roundness: number;\n  /** Thin-film / holographic hue response that shifts with view angle (0 = off). */\n  iridescence: number;\n  edgeFade: number;\n  /** Softness of the ribbon's long edges (smoothstep width across uv.y). 0.1 = the original\n   *  hardcoded value; smaller = razor-crisp graphic ribbons, larger = soft vapor. */\n  edgeFeather: number;\n  /** Depth tint (solid theme): fade far fragments toward depthTintColor for atmospheric\n   *  separation in multi-wave stacks (0 = off). */\n  depthTint: number;\n  depthTintColor: string;\n  // Displacement + twist (the wave shape)\n  displaceFrequency: Vec2;\n  displaceAmount: number;\n  /** Optional 2nd displacement octave: finer ripples riding on the broad swell (amount 0 = off). */\n  detailFrequency: number;\n  detailAmount: number;\n  twistFrequency: Vec3;\n  twistPower: Vec3;\n  twistMotion?: boolean;\n  // Material (\"solid\" surface vs \"wireframe\" line shader)\n  theme?: \"solid\" | \"wireframe\";\n  lineAmount?: number;\n  lineThickness?: number;\n  lineDerivativePower?: number;\n  maxWidth?: number;\n  // Transform (absolute — no shared base to offset from)\n  position: Vec3;\n  rotation: Vec3;\n  scale: Vec3;\n  // Compositing\n  blendMode: BlendMode;\n  /** Absolute animation speed for this wave (legacy global speed × per-layer multiplier). */\n  speed: number;\n  /** Overall opacity of this wave. */\n  opacity: number;\n  /** Phase/seed so waves don't move in lockstep. */\n  seed: number;\n  /** Optional per-wave interactivity: how THIS wave reacts to the shared pointer + inputs (hover\n   *  field, click ripples, param bindings). ABSENT = this wave is inert / byte-identical. */\n  interaction?: WaveInteractionConfig;\n}\n\n// ---------------------------------------------------------------------------------------------\n// Interactivity layer (optional, additive, default-off). Split by concern: the SHARED inputs (one\n// cursor + scroll + smoothing/touch) and scene-param effects live on SceneConfig.interaction; each\n// wave's own RESPONSE (hover field, click ripples, param bindings) lives on WaveConfig.interaction.\n// ABSENT blocks mean fully off — the compiled shader and rendered pixels stay byte-identical to a\n// non-interactive wave (the normalizers below run present-only; ensureSceneDefaults never calls them).\n// ---------------------------------------------------------------------------------------------\n\n/** The built-in interaction input names (the open-ended `custom:*` family is handled separately).\n *  Kept in sync by hand with the {@link InteractionSource} union below. */\nconst INTERACTION_SOURCE_NAMES = [\n  \"scroll\",\n  \"hover\",\n  \"pointerX\",\n  \"pointerY\",\n  \"pointerSpeed\",\n  \"press\",\n  \"scrollVelocity\",\n  \"appear\",\n] as const;\n\n/**\n * An interaction INPUT: a normalized signal that can smoothly drive config params through an\n * {@link InteractionBinding}. Every source is exponentially smoothed before it is applied.\n */\nexport type InteractionSource =\n  | \"scroll\" // container progress through the viewport, 0 (entering) .. 1 (scrolled past)\n  | \"hover\" // smoothed pointer presence over the container, 0..1\n  | \"pointerX\" // smoothed pointer X across the container, 0..1; relaxes to 0.5 on leave\n  | \"pointerY\" // smoothed pointer Y across the container, 0..1; relaxes to 0.5 on leave\n  | \"pointerSpeed\" // normalized smoothed pointer speed, 0..1\n  | \"press\" // pointer button / touch held, smoothed 0..1\n  | \"scrollVelocity\" // normalized smoothed |d(scroll progress)/dt|, 0..1\n  | \"appear\" // one-shot 0→1 latch on first visibility (entrance choreography)\n  | `custom:${string}`; // developer-fed each frame via setInteractionInput(name, value)\n\n/** Per-WAVE params a binding may drive. Single source of truth for WAVE_APPLIERS in\n *  renderer/interaction.ts (checked via `satisfies`) and validated by normalizeWaveInteraction. */\nconst WAVE_TARGET_NAMES = [\n  \"displaceAmount\",\n  \"detailAmount\",\n  \"twistPowerX\",\n  \"twistPowerY\",\n  \"twistPowerZ\",\n  \"twistFrequencyX\",\n  \"twistFrequencyY\",\n  \"twistFrequencyZ\",\n  \"hueShift\",\n  \"gradientShift\",\n  \"colorSaturation\",\n  \"opacity\",\n  \"lineThickness\",\n  \"lineAmount\",\n  \"fiberStrength\",\n  \"sheen\",\n  \"iridescence\",\n  \"positionX\",\n  \"positionY\",\n] as const;\n/** A per-wave param a {@link WaveInteractionBinding} can drive. */\nexport type WaveInteractionTarget = (typeof WAVE_TARGET_NAMES)[number];\n\n/** SCENE params a binding may drive (post / camera / time — shared, not per wave). Single source of\n *  truth for SCENE_APPLIERS in renderer/interaction.ts, validated by normalizeSceneInteraction. */\nconst SCENE_TARGET_NAMES = [\"timeOffset\", \"cameraZoom\", \"blur\", \"grain\"] as const;\n/** A scene-level param a {@link SceneInteractionBinding} can drive. */\nexport type SceneInteractionTarget = (typeof SCENE_TARGET_NAMES)[number];\n\n/** Shared fields of an input→param binding: per frame `value = mix(from ?? authoredBase, to,\n *  smoothedSource)`, written straight to uniforms — never mutates config, so any refresh restores\n *  the authored base (removal needs no undo step). */\ninterface InteractionBindingBase {\n  /** The input signal driving this binding. */\n  source: InteractionSource;\n  /** Value at source = 0. OMITTED = the authored base value, so at rest the authored look shows. */\n  from?: number;\n  /** Value at source = 1. */\n  to: number;\n  /** Exponential smoothing time constant, seconds (default 0.25); also shapes the `appear` ramp. */\n  smoothing?: number;\n}\n/** A binding on a wave, driving one of that wave's params. */\nexport interface WaveInteractionBinding extends InteractionBindingBase {\n  target: WaveInteractionTarget;\n}\n/** A scene-level binding, driving a shared scene param. */\nexport interface SceneInteractionBinding extends InteractionBindingBase {\n  target: SceneInteractionTarget;\n}\n\n/** Hover pointer-field: localized effects that follow the cursor over this wave. Present ⇒ the\n *  POINTER_FX shader path compiles for this wave; an absent effect is 0 (inert). */\nexport interface WaveHoverConfig {\n  /** Local churn-octave amplitude near the cursor — the wave agitates under the pointer. The studio\n   *  defaults this positive when you enable a hover field, so a fresh hover reacts out of the box. */\n  agitate?: number;\n  /** Membrane push/pull: a smooth dome at the cursor that swells toward you (repel, +) or dents away\n   *  (attract, −), carried by the sprung field so it drags like a poke under fabric. World units;\n   *  0 = off. */\n  push?: number;\n  /** Drag-wake: while the cursor moves, the surface just BEHIND it is pulled into a trailing trough\n   *  that heals once you stop; scales with pointer speed. World units; 0 = off. */\n  wake?: number;\n  /** 0..1 — wireframe strands taper to hairlines; solid gains local translucency. */\n  thin?: number;\n  /** Local hue rotation near the cursor, degrees. */\n  hueShift?: number;\n  /** Local brightness lift near the cursor, -1..1. */\n  lighten?: number;\n  /** Pointer-follow smoothing for THIS wave's hover field, seconds — how quickly the swell trails\n   *  the cursor. Vary it across a stack so strands lag at different rates (a parallax drag).\n   *  Default 0.12. */\n  smoothing?: number;\n}\n\n/** Click / touch pointer-field: what a tap or click on this wave triggers. */\nexport interface WavePressConfig {\n  /** Click-ripple amplitude; 0 keeps this wave's POINTER_RIPPLES path uncompiled. */\n  ripple?: number;\n}\n\n/** Per-wave interactivity: this wave's own reaction to the shared pointer + inputs. ABSENT ⇒ inert. */\nexport interface WaveInteractionConfig {\n  /** Hover field (cursor-follow agitation / thinning / hue-lighten). */\n  hover?: WaveHoverConfig;\n  /** Click & touch (ripples radiating from a tap/click on this wave). */\n  press?: WavePressConfig;\n  /** Input→param bindings driving THIS wave's params (any source, incl. scroll / hover / custom). */\n  bindings?: WaveInteractionBinding[];\n}\n\n/** Scene-level interactivity: the SHARED inputs (one cursor + scroll, touch) plus bindings that\n *  drive shared scene params. Pointer-follow smoothing is per-wave (see WaveHoverConfig.smoothing).\n *  ABSENT ⇒ inputs use defaults; `enabled: false` is the master OFF switch for the whole layer. */\nexport interface SceneInteractionConfig {\n  /** Master switch for the whole interaction layer. Default true (only `false` turns it all off). */\n  enabled?: boolean;\n  /** Pointer falloff radius, as a fraction of viewport height. Default 0.3. */\n  radius?: number;\n  /** Follow coarse (touch) pointers. Default false — touch is ignored unless this is true. */\n  touch?: boolean;\n  /** Input→param bindings driving SCENE params (timeOffset, cameraZoom, blur, grain). */\n  bindings?: SceneInteractionBinding[];\n}\n\n/**\n * Scene-level settings shared by every wave: output/background/camera/lights, the post-fx\n * pass (grain/blur), playback, quality, and the whole-composition mirror. Everything that\n * describes an individual wave lives on WaveConfig instead.\n */\nexport interface SceneConfig {\n  background: string;\n  transparentBackground: boolean;\n  backgroundMode: BackgroundMode;\n  backgroundPalette: ColorStop[];\n  backgroundGradientType: GradientType;\n  backgroundGradientAngle: number;\n  backgroundGradientSource: PaletteSource;\n  backgroundMeshPoints: MeshGradientPoint[];\n  backgroundMeshSoftness: number;\n  backgroundImageSource: PaletteSource;\n  backgroundImageUrl?: string;\n  backgroundVideoUrl?: string;\n  backgroundImageFit: BackgroundImageFit;\n  backgroundImageZoom: number;\n  backgroundImagePosition: Vec2;\n  /** Number of stacked waves (kept in sync with waves.length). */\n  waveCount: number;\n  quality: number;\n  dprMax: number;\n  paused: boolean;\n  /** Noise phase offset — scrubs the noise pattern to pick a still frame. */\n  timeOffset?: number;\n  /** Seamless-loop period in seconds (0 = off). When >0, the motion is mapped onto a circle in\n   *  noise space so it repeats exactly every `loopSeconds` — scene-level so a multi-wave stack\n   *  shares one period and the whole composite loops. */\n  loopSeconds?: number;\n  introRamp?: boolean;\n  showCameraRig: boolean;\n  cameraDistance: number;\n  cameraZoom: number;\n  cameraPosition: Vec3;\n  cameraTarget: Vec3;\n  /** Film grain amount (post pass). */\n  grain: number;\n  /** Soft-focus / spin blur amount (post pass). */\n  blur: number;\n  blurSamples?: number;\n  /** Bloom (post pass, UnrealBloomPass). strength 0 removes the pass entirely, so cost and pixels\n   *  are identical to bloom-off; radius/threshold only take effect once strength > 0. */\n  bloomStrength?: number;\n  bloomRadius?: number;\n  bloomThreshold?: number;\n  /** Base ambient light level (0–1). */\n  ambient: number;\n  lights: LightConfig[];\n  /** Mirror the whole composition on screen (world-space flip). */\n  mirrorH: boolean;\n  mirrorV: boolean;\n  /** Shared interaction inputs (one cursor + scroll) + scene-param bindings. Per-wave response\n   *  lives on each WaveConfig.interaction. ABSENT = defaults; `enabled:false` disables the layer. */\n  interaction?: SceneInteractionConfig;\n}\n\n/** The full save-state: scene settings + one or more complete waves. */\nexport interface StudioConfig extends SceneConfig {\n  waves: WaveConfig[];\n}\n\n/** Spread a base wave into `count` overlapping waves — each with a slightly varied hue, width,\n *  speed, phase, vertical offset and roll so a stack reads as one composition. `count === 1`\n *  returns the base unchanged. Used to author multi-wave presets. */\nexport function makeWaveSpread(base: WaveConfig, count: number): WaveConfig[] {\n  if (count <= 1) return [structuredClone(base)];\n  const out: WaveConfig[] = [];\n  for (let i = 0; i < count; i++) {\n    const f = i / (count - 1);\n    const w = structuredClone(base);\n    w.opacity = 1.0 - f * 0.3;\n    w.hueShift = base.hueShift + i * 18;\n    w.scale = { x: base.scale.x, y: base.scale.y * (1 - f * 0.2), z: base.scale.z };\n    w.speed = base.speed * (1 + f * 0.15);\n    w.seed = i * 3.3;\n    w.position = {\n      x: base.position.x,\n      y: base.position.y + (f - 0.5) * 1.5,\n      z: base.position.z - i * 0.8,\n    };\n    w.rotation = { x: base.rotation.x, y: base.rotation.y, z: base.rotation.z + i * 20 };\n    out.push(w);\n  }\n  return out;\n}\n\n/** The hero wave (a single complete wave) — the base for the default config and most presets. */\nfunction defaultWave(): WaveConfig {\n  return {\n    // The hero palette: a periwinkle tip/edge, a dominant orange core, then coral → magenta →\n    // pink, with a violet twist tip. gradientShift warps it to mimic a baked 2D palette texture.\n    palette: [\n      { color: \"#8e9dff\", pos: 0 }, // periwinkle (blue tip/edge)\n      { color: \"#c98fd0\", pos: 0.14 }, // lavender transition\n      { color: \"#ff9326\", pos: 0.3 }, // orange (rising)\n      { color: \"#fd8108\", pos: 0.52 }, // orange core\n      { color: \"#fb7a36\", pos: 0.64 }, // orange-coral (keeps orange dominant)\n      { color: \"#d24ecc\", pos: 0.78 }, // true magenta (hue ~303, not pink)\n      { color: \"#e95cae\", pos: 0.9 }, // pink-magenta\n      { color: \"#9b6ae0\", pos: 1.0 }, // violet (twist tip)\n    ],\n    gradientType: \"linear\",\n    gradientAngle: 90, // 90° = the gradient runs ALONG the length (uv.x)\n    gradientShift: 0.15,\n    meshGradientPoints: createDefaultMeshPoints(),\n    meshGradientSoftness: 0.62,\n    usePaletteTexture: true, // default to the baked hero LUT\n    paletteSource: \"hero\",\n    paletteTextureScale: { x: 1, y: 1 },\n    paletteTextureOffset: { x: 0, y: 0 },\n    paletteTextureRotation: 0,\n    paletteDriftX: 0,\n    paletteDriftY: 0,\n    paletteEdgeColor: \"#8e9dff\",\n    paletteEdgeAmount: 0.3,\n    hueShift: -1.81, // hero colorHueShift ≈ -1.81°\n    colorContrast: 1.0,\n    colorSaturation: 1.15,\n    // Hero fibers: the surfaceColor fragment hardcodes freq 600 / strength 0.2; the line* fields\n    // feed the wireframe theme (unused by the solid hero).\n    fiberCount: 600,\n    fiberStrength: 0.2,\n    noiseBands: [],\n    texture: 0,\n    creaseLight: 0.6,\n    creaseSharpness: 0.589,\n    creaseSoftness: 1.0,\n    // sheen 0 + roundness 0: the ortho crop makes crease low, so the hero look comes from the\n    // SrcColor² blend + the palette, not the derivative white-lift.\n    sheen: 0.0,\n    roundness: 0.0,\n    iridescence: 0,\n    edgeFade: 0.04,\n    edgeFeather: 0.1, // the original hardcoded ribbon-edge softness\n    depthTint: 0,\n    depthTintColor: \"#0a2540\",\n    // Hero deformation on the native 400-unit folded() geometry.\n    displaceFrequency: { x: 0.003234, y: 0.00799 },\n    displaceAmount: 6.051,\n    detailFrequency: 0.04, // finer than the base swell; only bites once detailAmount > 0\n    detailAmount: 0,\n    // Small twist frequencies + high powers — a gentle twist; the drama is the ortho crop.\n    twistFrequency: { x: -0.055, y: 0.077, z: -0.518 },\n    twistPower: { x: 3.95, y: 5.85, z: 6.33 },\n    twistMotion: false,\n    theme: \"solid\",\n    lineAmount: 425, // wireframe-theme line params (defaults)\n    lineThickness: 1,\n    lineDerivativePower: 0.95,\n    maxWidth: 1232,\n    // Hero mesh transform at FULL scale (the ortho camera frames in pixels).\n    position: { x: -24.3, y: -56.4, z: -11.1 },\n    rotation: { x: -9.14, y: -16.25, z: -161.32 },\n    scale: { x: 10, y: 10, z: 7 },\n    blendMode: \"squared\", // the hero squaring blend (SrcColor²)\n    speed: 0.04, // hero speed: 4e-5 vs ms-time ≈ 0.04/s\n    opacity: 1,\n    seed: 0,\n  };\n}\n\n/** A fresh default wave (the hero wave as one complete wave). */\nexport function makeWave(): WaveConfig {\n  return defaultWave();\n}\n\n/** Resize `waves` to match `waveCount`. New waves CLONE the last one (inherit every\n *  property of the preceding wave); extras are dropped. */\nexport function resizeWaves(config: StudioConfig): void {\n  const target = Math.max(1, Math.round(config.waveCount) || 1);\n  if (!Array.isArray(config.waves) || config.waves.length === 0) {\n    config.waves = [makeWave()];\n  }\n  while (config.waves.length < target) {\n    config.waves.push(structuredClone(config.waves[config.waves.length - 1]));\n  }\n  while (config.waves.length > target) config.waves.pop();\n  config.waveCount = config.waves.length;\n}\n\n/** The default studio config: the hero wave + its scene, in the canonical wave model. */\nexport function createDefaultConfig(): StudioConfig {\n  return {\n    background: \"#ffffff\",\n    transparentBackground: true,\n    backgroundMode: \"color\",\n    backgroundPalette: makeStops([\"#0a2540\", \"#425466\", \"#7a73ff\", \"#f6f9fc\"]),\n    backgroundGradientType: \"linear\",\n    backgroundGradientAngle: 135,\n    backgroundGradientSource: \"stops\",\n    backgroundMeshPoints: createDefaultMeshPoints(),\n    backgroundMeshSoftness: 0.62,\n    backgroundImageSource: \"vaporwave\",\n    backgroundImageFit: \"cover\",\n    backgroundImageZoom: 1,\n    backgroundImagePosition: { x: 0, y: 0 },\n    waveCount: 1,\n    quality: 1,\n    dprMax: 2,\n    paused: false,\n    timeOffset: 0, // noise phase (scrub to pick a still)\n    introRamp: true, // ease the animation in over ~1s on load (skipped in dev; see WaveRenderer.updateTime)\n    showCameraRig: false,\n    // The hero camera: ORTHOGRAPHIC at (100,0,5000) looking at the origin. The mesh is ×10 so\n    // the wave overflows the frame and only the twist shows. cameraZoom is a user multiplier on\n    // the responsive base zoom (1 = the hero crop); cameraTarget pans the look-at to the twist.\n    cameraDistance: 5001,\n    cameraPosition: { x: 100, y: 0, z: 5000 },\n    cameraTarget: { x: -44, y: -250, z: 0 },\n    cameraZoom: 1.0,\n    // Post (one pass over the whole composite): hero grain 1.1, blur 0.02.\n    grain: 1.1,\n    blur: 0.02,\n    blurSamples: 6,\n    ambient: 0.45,\n    lights: [], // hero has no lights — colour is the palette + the SrcColor² blend\n    mirrorH: false,\n    mirrorV: false,\n    waves: [defaultWave()],\n  };\n}\n\n/** Clamp/backfill a single wave's colour + palette fields (legacy `string[]` palettes become\n *  ColorStop[]; mesh points + texture transform are clamped). */\nfunction normalizeWaveColour(config: WaveConfig): void {\n  const p = config.palette as unknown as Array<string | ColorStop>;\n  if (p.length > 0 && typeof p[0] === \"string\") {\n    config.palette = makeStops(p as string[]);\n  }\n  if (\n    config.gradientType !== \"radial\" &&\n    config.gradientType !== \"conic\" &&\n    config.gradientType !== \"mesh\" &&\n    config.gradientType !== \"linear\"\n  ) {\n    config.gradientType = \"linear\";\n  }\n  const rawMeshPoints = config.meshGradientPoints as MeshGradientPoint[] | undefined;\n  if (!Array.isArray(rawMeshPoints) || rawMeshPoints.length < 2) {\n    config.meshGradientPoints = createDefaultMeshPoints();\n  } else {\n    const defaults = createDefaultMeshPoints();\n    config.meshGradientPoints = rawMeshPoints.slice(0, MAX_MESH_POINTS).map((point, index) => {\n      const fallback = defaults[index] ?? defaults[defaults.length - 1];\n      const x = Number(point.x);\n      const y = Number(point.y);\n      const influence = Number(point.influence);\n      return {\n        color: typeof point.color === \"string\" ? point.color : fallback.color,\n        x: clamp01(Number.isFinite(x) ? x : fallback.x),\n        y: clamp01(Number.isFinite(y) ? y : fallback.y),\n        influence: clamp(Number.isFinite(influence) ? influence : fallback.influence, 0.15, 1.5),\n      };\n    });\n  }\n  if (!Number.isFinite(config.meshGradientSoftness)) config.meshGradientSoftness = 0.62;\n  config.meshGradientSoftness = clamp01(config.meshGradientSoftness);\n  if (!config.paletteTextureScale) config.paletteTextureScale = { x: 1, y: 1 };\n  if (!config.paletteTextureOffset) config.paletteTextureOffset = { x: 0, y: 0 };\n  config.paletteTextureScale.x = clamp(Number(config.paletteTextureScale.x) || 1, 0.1, 8);\n  config.paletteTextureScale.y = clamp(Number(config.paletteTextureScale.y) || 1, 0.1, 8);\n  config.paletteTextureOffset.x = clamp(Number(config.paletteTextureOffset.x) || 0, -4, 4);\n  config.paletteTextureOffset.y = clamp(Number(config.paletteTextureOffset.y) || 0, -4, 4);\n  config.paletteTextureRotation = clamp(Number(config.paletteTextureRotation) || 0, -180, 180);\n}\n\n/** Backfill background styling for states saved before gradient/image backgrounds existed. */\nexport function normalizeBackground(config: StudioConfig): void {\n  if (\n    config.backgroundMode !== \"gradient\" &&\n    config.backgroundMode !== \"image\" &&\n    config.backgroundMode !== \"color\"\n  ) {\n    config.backgroundMode = \"color\";\n  }\n  const palette = config.backgroundPalette as unknown as Array<string | ColorStop> | undefined;\n  if (!palette || palette.length < 2) {\n    config.backgroundPalette = makeStops([\"#0a2540\", \"#425466\", \"#7a73ff\", \"#f6f9fc\"]);\n  } else if (typeof palette[0] === \"string\") {\n    config.backgroundPalette = makeStops(palette as string[]);\n  }\n  if (\n    config.backgroundGradientType !== \"radial\" &&\n    config.backgroundGradientType !== \"conic\" &&\n    config.backgroundGradientType !== \"mesh\" &&\n    config.backgroundGradientType !== \"linear\"\n  ) {\n    config.backgroundGradientType = \"linear\";\n  }\n  const bgMesh = config.backgroundMeshPoints as MeshGradientPoint[] | undefined;\n  if (!Array.isArray(bgMesh) || bgMesh.length < 2) {\n    config.backgroundMeshPoints = createDefaultMeshPoints();\n  }\n  if (!Number.isFinite(config.backgroundMeshSoftness)) config.backgroundMeshSoftness = 0.62;\n  config.backgroundMeshSoftness = clamp01(config.backgroundMeshSoftness);\n  if (typeof config.backgroundGradientAngle !== \"number\") config.backgroundGradientAngle = 135;\n  if (typeof config.backgroundGradientSource !== \"string\")\n    config.backgroundGradientSource = \"stops\";\n  if (typeof config.backgroundImageSource !== \"string\") config.backgroundImageSource = \"vaporwave\";\n  if (\n    config.backgroundImageFit !== \"contain\" &&\n    config.backgroundImageFit !== \"stretch\" &&\n    config.backgroundImageFit !== \"cover\"\n  ) {\n    config.backgroundImageFit = \"cover\";\n  }\n  if (typeof config.backgroundImageZoom !== \"number\") config.backgroundImageZoom = 1;\n  config.backgroundImageZoom = clamp(config.backgroundImageZoom, 0.1, 8);\n  if (!config.backgroundImagePosition) config.backgroundImagePosition = { x: 0, y: 0 };\n  if (typeof config.backgroundImagePosition.x !== \"number\") config.backgroundImagePosition.x = 0;\n  if (typeof config.backgroundImagePosition.y !== \"number\") config.backgroundImagePosition.y = 0;\n  config.backgroundImagePosition.x = clamp(config.backgroundImagePosition.x, -100, 100);\n  config.backgroundImagePosition.y = clamp(config.backgroundImagePosition.y, -100, 100);\n}\n\n/** Backfill camera position/target for states saved before they existed. */\nexport function ensureCamera(config: StudioConfig): void {\n  if (!config.cameraPosition)\n    config.cameraPosition = { x: 0, y: 0, z: config.cameraDistance ?? 62 };\n  if (!config.cameraTarget) config.cameraTarget = { x: 0, y: 0, z: 0 };\n  if (typeof config.cameraZoom !== \"number\") config.cameraZoom = 1;\n}\n\n/** Backfill/repair a wave so the renderer can consume it (covers partial wave-model JSON). */\nexport function normalizeWave(s: WaveConfig): void {\n  normalizeWaveColour(s);\n  if (typeof s.gradientAngle !== \"number\") s.gradientAngle = 90;\n  if (typeof s.gradientShift !== \"number\") s.gradientShift = 0.15;\n  if (typeof s.usePaletteTexture !== \"boolean\") s.usePaletteTexture = true;\n  if (typeof s.paletteSource !== \"string\") s.paletteSource = \"hero\";\n  if (typeof s.paletteEdgeColor !== \"string\") s.paletteEdgeColor = \"#8e9dff\";\n  if (typeof s.paletteEdgeAmount !== \"number\") s.paletteEdgeAmount = 0.3;\n  if (typeof s.paletteDriftX !== \"number\") s.paletteDriftX = 0;\n  if (typeof s.paletteDriftY !== \"number\") s.paletteDriftY = 0;\n  if (typeof s.hueShift !== \"number\") s.hueShift = 0;\n  if (typeof s.colorContrast !== \"number\") s.colorContrast = 1;\n  if (typeof s.colorSaturation !== \"number\") s.colorSaturation = 1;\n  if (typeof s.fiberCount !== \"number\") s.fiberCount = 600;\n  if (typeof s.fiberStrength !== \"number\") s.fiberStrength = 0.2;\n  if (!Array.isArray(s.noiseBands)) s.noiseBands = [];\n  if (typeof s.texture !== \"number\") s.texture = 0;\n  if (typeof s.creaseLight !== \"number\") s.creaseLight = 0.6;\n  if (typeof s.creaseSharpness !== \"number\") s.creaseSharpness = 0.589;\n  if (typeof s.creaseSoftness !== \"number\") s.creaseSoftness = 1;\n  if (typeof s.sheen !== \"number\") s.sheen = 0;\n  if (typeof s.roundness !== \"number\") s.roundness = 0;\n  if (typeof s.iridescence !== \"number\") s.iridescence = 0;\n  if (typeof s.edgeFade !== \"number\") s.edgeFade = 0.04;\n  if (typeof s.edgeFeather !== \"number\") s.edgeFeather = 0.1;\n  if (typeof s.depthTint !== \"number\") s.depthTint = 0;\n  if (typeof s.depthTintColor !== \"string\") s.depthTintColor = \"#0a2540\";\n  if (!s.displaceFrequency) s.displaceFrequency = { x: 0.003234, y: 0.00799 };\n  if (typeof s.displaceAmount !== \"number\") s.displaceAmount = 6.051;\n  if (typeof s.detailFrequency !== \"number\") s.detailFrequency = 0.04;\n  if (typeof s.detailAmount !== \"number\") s.detailAmount = 0;\n  if (!s.twistFrequency) s.twistFrequency = { x: -0.055, y: 0.077, z: -0.518 };\n  if (!s.twistPower) s.twistPower = { x: 3.95, y: 5.85, z: 6.33 };\n  if (typeof s.theme !== \"string\") s.theme = \"solid\";\n  if (typeof s.lineAmount !== \"number\") s.lineAmount = 425;\n  if (typeof s.lineThickness !== \"number\") s.lineThickness = 1;\n  if (typeof s.lineDerivativePower !== \"number\") s.lineDerivativePower = 0.95;\n  if (typeof s.maxWidth !== \"number\") s.maxWidth = 1232;\n  if (!s.position) s.position = { x: 0, y: 0, z: 0 };\n  if (!s.rotation) s.rotation = { x: 0, y: 0, z: 0 };\n  if (!s.scale) s.scale = { x: 10, y: 10, z: 7 };\n  if (typeof s.blendMode !== \"string\") s.blendMode = \"squared\";\n  if (typeof s.speed !== \"number\") s.speed = 0.04;\n  if (typeof s.opacity !== \"number\") s.opacity = 1;\n  if (typeof s.seed !== \"number\") s.seed = 0;\n  if (s.interaction) normalizeWaveInteraction(s); // present-only; absence stays inert\n}\n\n/** Backfill scene-level defaults (background/camera/post/lights/quality/mirror). */\nexport function ensureSceneDefaults(config: StudioConfig): void {\n  normalizeBackground(config);\n  ensureCamera(config);\n  if (typeof config.ambient !== \"number\") config.ambient = 0.45;\n  if (!Array.isArray(config.lights)) config.lights = [];\n  if (typeof config.quality !== \"number\") config.quality = 1;\n  if (typeof config.dprMax !== \"number\") config.dprMax = 2;\n  if (typeof config.grain !== \"number\") config.grain = 1.1;\n  if (typeof config.blur !== \"number\") config.blur = 0.02;\n  if (typeof config.blurSamples !== \"number\") config.blurSamples = 6;\n  if (typeof config.bloomStrength !== \"number\") config.bloomStrength = 0;\n  if (typeof config.bloomRadius !== \"number\") config.bloomRadius = 0.4;\n  if (typeof config.bloomThreshold !== \"number\") config.bloomThreshold = 0.85;\n  if (typeof config.showCameraRig !== \"boolean\") config.showCameraRig = false;\n  if (typeof config.paused !== \"boolean\") config.paused = false;\n  if (typeof config.loopSeconds !== \"number\") config.loopSeconds = 0;\n  if (typeof config.mirrorH !== \"boolean\") config.mirrorH = false;\n  if (typeof config.mirrorV !== \"boolean\") config.mirrorV = false;\n  // NOTE: `interaction` (scene + per-wave) is deliberately NOT backfilled — absence is semantically\n  // \"off\" and keeps the compiled shader byte-identical. The present-only normalizers below run from\n  // ensureStudioConfig / normalizeWave only when a block is actually present.\n}\n\n/** Clamp an untrusted numeric field, falling back to `dflt` when it isn't a finite number. */\nfunction clampNumber(v: unknown, min: number, max: number, dflt: number): number {\n  const n = Number(v);\n  return Number.isFinite(n) ? clamp(n, min, max) : dflt;\n}\n\n/** True for a valid interaction source string: a built-in name or a non-empty `custom:<name>`. */\nfunction isInteractionSource(v: unknown): v is InteractionSource {\n  return (\n    typeof v === \"string\" &&\n    ((INTERACTION_SOURCE_NAMES as readonly string[]).includes(v) ||\n      (v.startsWith(\"custom:\") && v.length > \"custom:\".length))\n  );\n}\n\n/** Rebuild an untrusted bindings array into valid bindings for `valid` targets (loaded share-links /\n *  presets are untrusted JSON; we validate source/target/to and rebuild clean objects). */\nfunction cleanBindings<T extends string>(\n  raw: unknown,\n  valid: readonly string[],\n): Array<InteractionBindingBase & { target: T }> {\n  const out: Array<InteractionBindingBase & { target: T }> = [];\n  if (!Array.isArray(raw)) return out;\n  for (const item of raw) {\n    if (!item || typeof item !== \"object\") continue;\n    const b = item as Record<string, unknown>;\n    if (!isInteractionSource(b.source)) continue;\n    if (!valid.includes(b.target as string)) continue;\n    const to = Number(b.to);\n    if (!Number.isFinite(to)) continue;\n    const clean: InteractionBindingBase & { target: T } = {\n      source: b.source,\n      target: b.target as T,\n      to,\n    };\n    if (b.from !== undefined) {\n      const f = Number(b.from);\n      if (Number.isFinite(f)) clean.from = f;\n    }\n    if (b.smoothing !== undefined) clean.smoothing = clampNumber(b.smoothing, 0, 2, 0.25);\n    out.push(clean);\n  }\n  return out;\n}\n\n/**\n * Present-only normalizer for a WAVE's interaction block: clamp the hover/press numerics that are\n * present (absent fields stay absent, so the block stays lean and the renderer's defaults apply) and\n * drop bindings with an unknown source/target or a non-finite `to`. NEVER call when the block is\n * absent — absence is inert and byte-identical (normalizeWave gates on presence).\n */\nexport function normalizeWaveInteraction(wave: WaveConfig): void {\n  const it = wave.interaction;\n  if (!it) return;\n  const h = it.hover;\n  if (h) {\n    if (h.agitate !== undefined) h.agitate = clampNumber(h.agitate, 0, 60, 0);\n    if (h.push !== undefined) h.push = clampNumber(h.push, -40, 40, 0);\n    if (h.wake !== undefined) h.wake = clampNumber(h.wake, 0, 40, 0);\n    if (h.thin !== undefined) h.thin = clampNumber(h.thin, 0, 1, 0);\n    if (h.hueShift !== undefined) h.hueShift = clampNumber(h.hueShift, -360, 360, 0);\n    if (h.lighten !== undefined) h.lighten = clampNumber(h.lighten, -1, 1, 0);\n    if (h.smoothing !== undefined) h.smoothing = clampNumber(h.smoothing, 0, 2, 0.12);\n  }\n  if (it.press && it.press.ripple !== undefined) {\n    it.press.ripple = clampNumber(it.press.ripple, 0, 60, 0);\n  }\n  if (it.bindings !== undefined) {\n    it.bindings = cleanBindings<WaveInteractionTarget>(it.bindings, WAVE_TARGET_NAMES);\n  }\n}\n\n/** Present-only normalizer for the SCENE interaction block: clamp the shared pointer inputs and drop\n *  invalid scene bindings. NEVER call when the block is absent. */\nexport function normalizeSceneInteraction(config: StudioConfig): void {\n  const it = config.interaction;\n  if (!it) return;\n  if (it.radius !== undefined) it.radius = clampNumber(it.radius, 0.02, 2, 0.3);\n  if (it.bindings !== undefined) {\n    it.bindings = cleanBindings<SceneInteractionTarget>(it.bindings, SCENE_TARGET_NAMES);\n  }\n}\n\n/** Normalize an ingested config to the wave model: backfill the scene + every wave, and drop in\n *  a default wave if none are present. Idempotent, so it is safe on the renderer's own config as\n *  well as freshly loaded save-states / share links. */\nexport function ensureStudioConfig(input: StudioConfig): StudioConfig {\n  const config = input;\n  ensureSceneDefaults(config);\n  if (!Array.isArray(config.waves) || config.waves.length === 0) {\n    config.waves = [makeWave()];\n  }\n  config.waves.forEach(normalizeWave); // each wave's normalizeWave runs normalizeWaveInteraction\n  config.waveCount = config.waves.length;\n  // Present-only: a config without a scene `interaction` block is left untouched (stays \"off\").\n  if (config.interaction) normalizeSceneInteraction(config);\n  return config;\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { BackgroundImageFit, BackgroundMode, BasicGradientType, BlendMode, ColorStop, DEFAULT_LIGHT_POSITION, GradientType, LightConfig, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, MeshGradientPoint, NoiseBand, PaletteSource, SceneConfig, StudioConfig, Vec2, Vec3, WaveConfig, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, normalizeBackground, normalizeWave, resizeWaves } from "./config/model.js";
+import { BackgroundImageFit, BackgroundMode, BasicGradientType, BlendMode, ColorStop, DEFAULT_LIGHT_POSITION, GradientType, InteractionSource, LightConfig, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, MeshGradientPoint, NoiseBand, PaletteSource, SceneConfig, SceneInteractionBinding, SceneInteractionConfig, SceneInteractionTarget, StudioConfig, Vec2, Vec3, WaveConfig, WaveHoverConfig, WaveInteractionBinding, WaveInteractionConfig, WaveInteractionTarget, WavePressConfig, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, normalizeBackground, normalizeSceneInteraction, normalizeWave, normalizeWaveInteraction, resizeWaves } from "./config/model.js";
 import { WaveRenderer, WaveRendererOptions } from "./renderer/WaveRenderer.js";
+import { PosterFit } from "./shell/poster.js";
 import { FallbackReason, SnapshotOptions, WaveHandle, WaveOptions, WaveState, createWave, mountWave } from "./shell/createWave.js";
-export { BackgroundImageFit, BackgroundMode, BasicGradientType, BlendMode, ColorStop, DEFAULT_LIGHT_POSITION, type FallbackReason, GradientType, LightConfig, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, MeshGradientPoint, NoiseBand, PaletteSource, SceneConfig, type SnapshotOptions, StudioConfig, Vec2, Vec3, WaveConfig, type WaveHandle, type WaveOptions, type WaveRenderer, type WaveRendererOptions, type WaveState, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, createWave, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, mountWave, normalizeBackground, normalizeWave, resizeWaves };
+export { BackgroundImageFit, BackgroundMode, BasicGradientType, BlendMode, ColorStop, DEFAULT_LIGHT_POSITION, type FallbackReason, GradientType, InteractionSource, LightConfig, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, MeshGradientPoint, NoiseBand, PaletteSource, type PosterFit, SceneConfig, SceneInteractionBinding, SceneInteractionConfig, SceneInteractionTarget, type SnapshotOptions, StudioConfig, Vec2, Vec3, WaveConfig, type WaveHandle, WaveHoverConfig, WaveInteractionBinding, WaveInteractionConfig, WaveInteractionTarget, type WaveOptions, WavePressConfig, type WaveRenderer, type WaveRendererOptions, type WaveState, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, createWave, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, mountWave, normalizeBackground, normalizeSceneInteraction, normalizeWave, normalizeWaveInteraction, resizeWaves };

package/dist/index.js

@@ -1,3 +1,3 @@
-import { DEFAULT_LIGHT_POSITION, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, normalizeBackground, normalizeWave, resizeWaves } from "./config/model.js";
+import { DEFAULT_LIGHT_POSITION, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, normalizeBackground, normalizeSceneInteraction, normalizeWave, normalizeWaveInteraction, resizeWaves } from "./config/model.js";
 import { createWave, mountWave } from "./shell/createWave.js";
-export { DEFAULT_LIGHT_POSITION, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, createWave, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, mountWave, normalizeBackground, normalizeWave, resizeWaves };
+export { DEFAULT_LIGHT_POSITION, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, createWave, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, mountWave, normalizeBackground, normalizeSceneInteraction, normalizeWave, normalizeWaveInteraction, resizeWaves };

package/dist/presets.js

@@ -504,6 +504,21 @@ const PRESETS = {
 		c.transparentBackground = true;
 		return c;
 	},
+	Spain: () => {
+		const c = PRESETS["Hero"]();
+		const w = c.waves[0];
+		w.paletteSource = "spain";
+		w.blendMode = "normal";
+		w.hueShift = 0;
+		w.colorContrast = 1.18;
+		w.colorSaturation = 1.25;
+		w.creaseLight = 1.6;
+		c.grain = .3;
+		c.background = "#1a0608";
+		c.backgroundMode = "color";
+		c.transparentBackground = false;
+		return c;
+	},
 	"Vaporwave Sunset": () => {
 		const c = PRESETS["Hero"]();
 		const w = c.waves[0];