shadertown 0.1.0 → 0.2.0

package/dist/registry.d.ts

@@ -1,4 +1,4 @@
-import type { ColorControl } from "./types.js";
+import type { ColorControl, ShaderKind } from "./types.js";
 export declare const shaderRegistry: {
     readonly aurora: {
         readonly name: "Aurora";
@@ -1917,12 +1917,1061 @@ export declare const shaderRegistry: {
             readonly colorC: ColorControl;
         };
     };
+    readonly glass: {
+        readonly name: "Glass";
+        readonly tagline: "A refracting, frosted sheet over the layer behind it";
+        readonly description: "A drifting height field read as a surface: its slope bends the layer underneath, spreads the red and blue ends apart, and catches light along the steep ground. Frost blurs along an axis the height rotates, so the sheet grains up instead of banding. Point it at an image, a video, or another shadertown shader.";
+        readonly family: "optical";
+        readonly tags: readonly ["glass", "refraction", "overlay"];
+        readonly cost: "medium";
+        readonly defaultSource: "neon-grid";
+        readonly controls: {
+            readonly speed: {
+                readonly default: 0.35;
+                readonly max: 2;
+                readonly slot: "speed";
+                readonly label: "Speed";
+                readonly min: 0;
+                readonly step: 0.01;
+                readonly hint: "Time multiplier. 0 freezes the shader on its current frame.";
+            };
+            readonly scale: {
+                readonly default: 1;
+                readonly slot: "scale";
+                readonly label: "Scale";
+                readonly min: 0.2;
+                readonly max: 3;
+                readonly step: 0.01;
+                readonly hint: "Zoom of the underlying field. Lower is bigger, softer shapes.";
+            };
+            readonly intensity: {
+                readonly default: 1;
+                readonly slot: "intensity";
+                readonly label: "Strength";
+                readonly min: 0;
+                readonly max: 2.5;
+                readonly step: 0.01;
+                readonly hint: "Overall brightness of the effect before the post chain.";
+            };
+            readonly grain: {
+                readonly default: 0.02;
+                readonly slot: "grain";
+                readonly label: "Grain";
+                readonly min: 0;
+                readonly max: 0.35;
+                readonly step: 0.005;
+                readonly hint: "Per-pixel noise. A little hides banding on flat gradients.";
+            };
+            readonly vignette: {
+                readonly default: 0.2;
+                readonly slot: "vignette";
+                readonly label: "Vignette";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly hint: "Darkening towards the edges of the frame.";
+            };
+            readonly warp: {
+                readonly label: "Refraction";
+                readonly default: 0.8;
+                readonly max: 2.5;
+                readonly hint: "How far the sheet bends what is behind it.";
+                readonly slot: "warp";
+                readonly min: 0;
+                readonly step: 0.01;
+            };
+            readonly frost: {
+                readonly slot: "a";
+                readonly label: "Frost";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.35;
+                readonly hint: "Blur radius. Past about 0.6 the layer below stops being readable.";
+            };
+            readonly dispersion: {
+                readonly slot: "b";
+                readonly label: "Dispersion";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.25;
+                readonly hint: "Colour fringing where the sheet is steepest, as in real glass.";
+            };
+            readonly edge: {
+                readonly slot: "c";
+                readonly label: "Edge light";
+                readonly min: 0;
+                readonly max: 2;
+                readonly step: 0.01;
+                readonly default: 0.6;
+                readonly hint: "Highlight along the ridges. This is what makes it read as thick.";
+            };
+            readonly tint: {
+                readonly slot: "d";
+                readonly label: "Tint";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.15;
+                readonly hint: "Pulls the whole sheet towards the palette. 0 leaves it colourless.";
+            };
+            readonly vibrancy: {
+                readonly slot: "vibrancy";
+                readonly label: "Vibrancy";
+                readonly min: 0;
+                readonly max: 2;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Saturation. 0 is greyscale, 1 is as authored, 2 is punched.";
+            };
+        };
+        readonly colors: {
+            readonly colorA: ColorControl;
+            readonly colorB: ColorControl;
+            readonly colorC: ColorControl;
+        };
+    };
+    readonly lens: {
+        readonly name: "Lens";
+        readonly tagline: "Barrel distortion, colour fringing and soft corners";
+        readonly description: "A camera lens rather than a filter: one radial distortion constant per colour channel, so straight lines bow outwards, the fringing is invisible in the middle and worst in the corners, and the corners lose both light and sharpness. Set distortion below zero for the pincushion a long lens gives you instead.";
+        readonly family: "optical";
+        readonly tags: readonly ["camera", "distortion", "retro"];
+        readonly cost: "medium";
+        readonly defaultSource: "neon-grid";
+        readonly controls: {
+            readonly vignette: {
+                readonly default: 0.15;
+                readonly slot: "vignette";
+                readonly label: "Vignette";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly hint: "Darkening towards the edges of the frame.";
+            };
+            readonly warp: {
+                readonly label: "Distortion";
+                readonly min: -1;
+                readonly max: 2;
+                readonly default: 0.5;
+                readonly hint: "Above zero bows outwards (barrel), below zero pulls inwards (pincushion).";
+                readonly slot: "warp";
+                readonly step: 0.01;
+            };
+            readonly softness: {
+                readonly slot: "a";
+                readonly label: "Corner softness";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.35;
+                readonly hint: "How far off the focal plane the corners sit.";
+            };
+            readonly fringing: {
+                readonly slot: "b";
+                readonly label: "Fringing";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.4;
+                readonly hint: "How far apart the red and blue ends are bent.";
+            };
+            readonly zoom: {
+                readonly slot: "c";
+                readonly label: "Zoom";
+                readonly min: 0.5;
+                readonly max: 1.5;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Below 1 pulls back and shows the black outside the frame.";
+            };
+            readonly falloff: {
+                readonly slot: "d";
+                readonly label: "Corner falloff";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.4;
+                readonly hint: "Light lost towards the corners, as distortion spreads it thinner.";
+            };
+            readonly intensity: {
+                readonly slot: "intensity";
+                readonly label: "Strength";
+                readonly min: 0;
+                readonly max: 2.5;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Overall brightness of the effect before the post chain.";
+            };
+            readonly vibrancy: {
+                readonly slot: "vibrancy";
+                readonly label: "Vibrancy";
+                readonly min: 0;
+                readonly max: 2;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Saturation. 0 is greyscale, 1 is as authored, 2 is punched.";
+            };
+            readonly grain: {
+                readonly slot: "grain";
+                readonly label: "Grain";
+                readonly min: 0;
+                readonly max: 0.35;
+                readonly step: 0.005;
+                readonly default: 0.03;
+                readonly hint: "Per-pixel noise. A little hides banding on flat gradients.";
+            };
+        };
+        readonly colors: {
+            readonly colorA: ColorControl;
+            readonly colorB: ColorControl;
+            readonly colorC: ColorControl;
+        };
+    };
+    readonly bloom: {
+        readonly name: "Bloom";
+        readonly tagline: "Light bleeding out of the bright parts of the layer below";
+        readonly description: "A threshold picks out what is already bright, and a wide spiral spreads it. Each tap is thresholded on its own rather than blurring first, so a dark neighbour never dims a highlight. Streak stretches the spiral sideways into the flare an anamorphic lens puts on every point of light.";
+        readonly family: "optical";
+        readonly tags: readonly ["glow", "light", "hero"];
+        readonly cost: "heavy";
+        readonly defaultSource: "starfield";
+        readonly controls: {
+            readonly vignette: {
+                readonly default: 0.1;
+                readonly slot: "vignette";
+                readonly label: "Vignette";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly hint: "Darkening towards the edges of the frame.";
+            };
+            readonly warp: {
+                readonly label: "Streak";
+                readonly min: 0;
+                readonly max: 1;
+                readonly default: 0.15;
+                readonly hint: "Stretches the halo sideways. Small values read as a lens, large as a smear.";
+                readonly slot: "warp";
+                readonly step: 0.01;
+            };
+            readonly threshold: {
+                readonly slot: "a";
+                readonly label: "Threshold";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.55;
+                readonly hint: "How bright a pixel has to be before it blooms at all.";
+            };
+            readonly radius: {
+                readonly slot: "b";
+                readonly label: "Radius";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.5;
+                readonly hint: "How far the light carries. Wide radii need bright, sparse sources.";
+            };
+            readonly amount: {
+                readonly slot: "c";
+                readonly label: "Amount";
+                readonly min: 0;
+                readonly max: 3;
+                readonly step: 0.01;
+                readonly default: 1.2;
+                readonly hint: "How much of the halo is added back on top.";
+            };
+            readonly tint: {
+                readonly slot: "d";
+                readonly label: "Tint";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.3;
+                readonly hint: "Colours the halo from the palette. Real coatings are rarely neutral.";
+            };
+            readonly intensity: {
+                readonly slot: "intensity";
+                readonly label: "Strength";
+                readonly min: 0;
+                readonly max: 2.5;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Overall brightness of the effect before the post chain.";
+            };
+            readonly vibrancy: {
+                readonly slot: "vibrancy";
+                readonly label: "Vibrancy";
+                readonly min: 0;
+                readonly max: 2;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Saturation. 0 is greyscale, 1 is as authored, 2 is punched.";
+            };
+            readonly grain: {
+                readonly slot: "grain";
+                readonly label: "Grain";
+                readonly min: 0;
+                readonly max: 0.35;
+                readonly step: 0.005;
+                readonly default: 0.03;
+                readonly hint: "Per-pixel noise. A little hides banding on flat gradients.";
+            };
+        };
+        readonly colors: {
+            readonly colorA: ColorControl;
+            readonly colorB: ColorControl;
+            readonly colorC: ColorControl;
+        };
+    };
+    readonly shockwave: {
+        readonly name: "Shockwave";
+        readonly tagline: "Expanding rings that shove the layer aside as they pass";
+        readonly description: "Three gaussian bands, staggered in phase and spending their force as they grow. The displacement is signed by which side of the crest a pixel is on, so the front compresses ahead of itself and rarefies behind — which is what makes it read as a wave rather than a glowing ring. Turn pointer tracking on and it starts wherever the cursor is.";
+        readonly family: "distortion";
+        readonly tags: readonly ["impact", "pulse", "interactive"];
+        readonly cost: "medium";
+        readonly defaultSource: "truchet";
+        readonly controls: {
+            readonly speed: {
+                readonly default: 0.8;
+                readonly slot: "speed";
+                readonly label: "Speed";
+                readonly min: 0;
+                readonly max: 3;
+                readonly step: 0.01;
+                readonly hint: "Time multiplier. 0 freezes the shader on its current frame.";
+            };
+            readonly grain: {
+                readonly default: 0.02;
+                readonly slot: "grain";
+                readonly label: "Grain";
+                readonly min: 0;
+                readonly max: 0.35;
+                readonly step: 0.005;
+                readonly hint: "Per-pixel noise. A little hides banding on flat gradients.";
+            };
+            readonly vignette: {
+                readonly default: 0.15;
+                readonly slot: "vignette";
+                readonly label: "Vignette";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly hint: "Darkening towards the edges of the frame.";
+            };
+            readonly warp: {
+                readonly label: "Force";
+                readonly min: 0;
+                readonly max: 2;
+                readonly default: 0.9;
+                readonly hint: "How far the front shoves what it passes over.";
+                readonly slot: "warp";
+                readonly step: 0.01;
+            };
+            readonly reach: {
+                readonly slot: "a";
+                readonly label: "Reach";
+                readonly min: 0.1;
+                readonly max: 2;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "How far a ring travels before it is spent.";
+            };
+            readonly width: {
+                readonly slot: "b";
+                readonly label: "Width";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.35;
+                readonly hint: "Thickness of the front. Thin is a crack, thick is a swell.";
+            };
+            readonly decay: {
+                readonly slot: "c";
+                readonly label: "Decay";
+                readonly min: 0.1;
+                readonly max: 4;
+                readonly step: 0.01;
+                readonly default: 1.5;
+                readonly hint: "How quickly a ring loses force. High values die close to the centre.";
+            };
+            readonly fringing: {
+                readonly slot: "d";
+                readonly label: "Fringing";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.4;
+                readonly hint: "Colour separation across the crest.";
+            };
+            readonly scale: {
+                readonly slot: "scale";
+                readonly label: "Scale";
+                readonly min: 0.2;
+                readonly max: 3;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Zoom of the underlying field. Lower is bigger, softer shapes.";
+            };
+            readonly intensity: {
+                readonly slot: "intensity";
+                readonly label: "Strength";
+                readonly min: 0;
+                readonly max: 2.5;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Overall brightness of the effect before the post chain.";
+            };
+            readonly vibrancy: {
+                readonly slot: "vibrancy";
+                readonly label: "Vibrancy";
+                readonly min: 0;
+                readonly max: 2;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Saturation. 0 is greyscale, 1 is as authored, 2 is punched.";
+            };
+        };
+        readonly colors: {
+            readonly colorA: ColorControl;
+            readonly colorB: ColorControl;
+            readonly colorC: ColorControl;
+        };
+    };
+    readonly swirl: {
+        readonly name: "Swirl";
+        readonly tagline: "A vortex that winds the layer around a point";
+        readonly description: "Rotation that falls off with distance, so the middle turns and the edges stay put. Falloff decides the whole character: near 1 it is a gentle whirlpool, near 4 a tight knot in still water. The colour channels wind by slightly different angles, which smears them along the direction of travel and sells the spin.";
+        readonly family: "distortion";
+        readonly tags: readonly ["vortex", "twist", "interactive"];
+        readonly cost: "light";
+        readonly defaultSource: "voronoi";
+        readonly controls: {
+            readonly speed: {
+                readonly default: 1;
+                readonly slot: "speed";
+                readonly label: "Speed";
+                readonly min: 0;
+                readonly max: 3;
+                readonly step: 0.01;
+                readonly hint: "Time multiplier. 0 freezes the shader on its current frame.";
+            };
+            readonly grain: {
+                readonly default: 0.02;
+                readonly slot: "grain";
+                readonly label: "Grain";
+                readonly min: 0;
+                readonly max: 0.35;
+                readonly step: 0.005;
+                readonly hint: "Per-pixel noise. A little hides banding on flat gradients.";
+            };
+            readonly vignette: {
+                readonly default: 0.15;
+                readonly slot: "vignette";
+                readonly label: "Vignette";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly hint: "Darkening towards the edges of the frame.";
+            };
+            readonly warp: {
+                readonly label: "Twist";
+                readonly min: 0;
+                readonly max: 3;
+                readonly default: 1.2;
+                readonly hint: "Turns at the centre. Past about 2 the middle stops being readable.";
+                readonly slot: "warp";
+                readonly step: 0.01;
+            };
+            readonly radius: {
+                readonly slot: "a";
+                readonly label: "Radius";
+                readonly min: 0.02;
+                readonly max: 1.2;
+                readonly step: 0.01;
+                readonly default: 0.55;
+                readonly hint: "How far the vortex reaches before the layer is untouched.";
+            };
+            readonly falloff: {
+                readonly slot: "b";
+                readonly label: "Falloff";
+                readonly min: 0.1;
+                readonly max: 5;
+                readonly step: 0.01;
+                readonly default: 1.6;
+                readonly hint: "Shape of the edge. Low is a wide whirlpool, high is a tight knot.";
+            };
+            readonly spin: {
+                readonly slot: "c";
+                readonly label: "Spin";
+                readonly min: -1;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.15;
+                readonly hint: "Steady rotation over time. Negative winds the other way.";
+            };
+            readonly smear: {
+                readonly slot: "d";
+                readonly label: "Smear";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.3;
+                readonly hint: "Colour trailing along the direction of travel.";
+            };
+            readonly scale: {
+                readonly slot: "scale";
+                readonly label: "Scale";
+                readonly min: 0.2;
+                readonly max: 3;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Zoom of the underlying field. Lower is bigger, softer shapes.";
+            };
+            readonly intensity: {
+                readonly slot: "intensity";
+                readonly label: "Strength";
+                readonly min: 0;
+                readonly max: 2.5;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Overall brightness of the effect before the post chain.";
+            };
+            readonly vibrancy: {
+                readonly slot: "vibrancy";
+                readonly label: "Vibrancy";
+                readonly min: 0;
+                readonly max: 2;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Saturation. 0 is greyscale, 1 is as authored, 2 is punched.";
+            };
+        };
+        readonly colors: {
+            readonly colorA: ColorControl;
+            readonly colorB: ColorControl;
+            readonly colorC: ColorControl;
+        };
+    };
+    readonly flow: {
+        readonly name: "Flow";
+        readonly tagline: "The layer pushed around by a slow, turbulent field";
+        readonly description: "Two noise fields drive a displacement, then curl turns it from a drift into a circulation. Smearing runs along the flow rather than in a circle, so the result looks stirred instead of merely blurred. Turbulence trades broad lazy currents for stringy filaments.";
+        readonly family: "distortion";
+        readonly tags: readonly ["liquid", "organic", "ambient"];
+        readonly cost: "heavy";
+        readonly defaultSource: "halftone";
+        readonly controls: {
+            readonly speed: {
+                readonly default: 0.5;
+                readonly max: 2;
+                readonly slot: "speed";
+                readonly label: "Speed";
+                readonly min: 0;
+                readonly step: 0.01;
+                readonly hint: "Time multiplier. 0 freezes the shader on its current frame.";
+            };
+            readonly scale: {
+                readonly default: 1;
+                readonly slot: "scale";
+                readonly label: "Scale";
+                readonly min: 0.2;
+                readonly max: 3;
+                readonly step: 0.01;
+                readonly hint: "Zoom of the underlying field. Lower is bigger, softer shapes.";
+            };
+            readonly grain: {
+                readonly default: 0.02;
+                readonly slot: "grain";
+                readonly label: "Grain";
+                readonly min: 0;
+                readonly max: 0.35;
+                readonly step: 0.005;
+                readonly hint: "Per-pixel noise. A little hides banding on flat gradients.";
+            };
+            readonly vignette: {
+                readonly default: 0.2;
+                readonly slot: "vignette";
+                readonly label: "Vignette";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly hint: "Darkening towards the edges of the frame.";
+            };
+            readonly warp: {
+                readonly label: "Strength";
+                readonly min: 0;
+                readonly max: 2;
+                readonly default: 0.7;
+                readonly hint: "How far the field pushes the layer.";
+                readonly slot: "warp";
+                readonly step: 0.01;
+            };
+            readonly turbulence: {
+                readonly slot: "a";
+                readonly label: "Turbulence";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.4;
+                readonly hint: "0 is broad lazy currents, 1 is sharp filaments.";
+            };
+            readonly curl: {
+                readonly slot: "b";
+                readonly label: "Curl";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.75;
+                readonly hint: "Turns the drift into circulation. 0 pulls everything one way.";
+            };
+            readonly smear: {
+                readonly slot: "c";
+                readonly label: "Smear";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.35;
+                readonly hint: "Blur along the flow, which is what reads as motion.";
+            };
+            readonly tint: {
+                readonly slot: "d";
+                readonly label: "Tint";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.2;
+                readonly hint: "Colours the fast water from the palette.";
+            };
+            readonly intensity: {
+                readonly slot: "intensity";
+                readonly label: "Strength";
+                readonly min: 0;
+                readonly max: 2.5;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Overall brightness of the effect before the post chain.";
+            };
+            readonly vibrancy: {
+                readonly slot: "vibrancy";
+                readonly label: "Vibrancy";
+                readonly min: 0;
+                readonly max: 2;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Saturation. 0 is greyscale, 1 is as authored, 2 is punched.";
+            };
+        };
+        readonly colors: {
+            readonly colorA: ColorControl;
+            readonly colorB: ColorControl;
+            readonly colorC: ColorControl;
+        };
+    };
+    readonly duotone: {
+        readonly name: "Duotone";
+        readonly tagline: "The layer's brightness read through your palette";
+        readonly description: "Luminance is set between a black and a white point, then contrasted about the midpoint, then used to walk the three-stop palette. In that order: a hard contrast applied first would clip before the range is set. Keep colour mixes the original chroma back, for when a busy photograph should not become a flat poster.";
+        readonly family: "image";
+        readonly tags: readonly ["colour", "poster", "brand"];
+        readonly cost: "light";
+        readonly defaultSource: "julia";
+        readonly controls: {
+            readonly grain: {
+                readonly default: 0.02;
+                readonly slot: "grain";
+                readonly label: "Grain";
+                readonly min: 0;
+                readonly max: 0.35;
+                readonly step: 0.005;
+                readonly hint: "Per-pixel noise. A little hides banding on flat gradients.";
+            };
+            readonly vignette: {
+                readonly default: 0.2;
+                readonly slot: "vignette";
+                readonly label: "Vignette";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly hint: "Darkening towards the edges of the frame.";
+            };
+            readonly black: {
+                readonly slot: "a";
+                readonly label: "Black point";
+                readonly min: 0;
+                readonly max: 0.6;
+                readonly step: 0.01;
+                readonly default: 0.05;
+                readonly hint: "Brightness that maps to the first colour. Raise it to crush shadows.";
+            };
+            readonly white: {
+                readonly slot: "b";
+                readonly label: "White point";
+                readonly min: 0.4;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.9;
+                readonly hint: "Brightness that maps to the last colour. Lower it to blow highlights.";
+            };
+            readonly contrast: {
+                readonly slot: "c";
+                readonly label: "Contrast";
+                readonly min: 0.2;
+                readonly max: 3;
+                readonly step: 0.01;
+                readonly default: 1.2;
+                readonly hint: "Steepness of the ramp between the two points.";
+            };
+            readonly keep: {
+                readonly slot: "d";
+                readonly label: "Keep colour";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0;
+                readonly hint: "Mixes the original chroma back over the mapped tone.";
+            };
+            readonly intensity: {
+                readonly slot: "intensity";
+                readonly label: "Strength";
+                readonly min: 0;
+                readonly max: 2.5;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Overall brightness of the effect before the post chain.";
+            };
+            readonly vibrancy: {
+                readonly slot: "vibrancy";
+                readonly label: "Vibrancy";
+                readonly min: 0;
+                readonly max: 2;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Saturation. 0 is greyscale, 1 is as authored, 2 is punched.";
+            };
+        };
+        readonly colors: {
+            readonly colorA: ColorControl;
+            readonly colorB: ColorControl;
+            readonly colorC: ColorControl;
+        };
+    };
+    readonly edges: {
+        readonly name: "Edges";
+        readonly tagline: "The layer reduced to its outlines";
+        readonly description: "A Sobel kernel over luminance, with the step widened past a single texel — a sub-texel step would just sample the same texel three times, and widening it is what turns a hairline into a drawn line. Fill decides how much of the original shows under the ink, from a clean line drawing to a traced photograph.";
+        readonly family: "image";
+        readonly tags: readonly ["outline", "line art", "technical"];
+        readonly cost: "medium";
+        readonly defaultSource: "truchet";
+        readonly controls: {
+            readonly grain: {
+                readonly default: 0.01;
+                readonly slot: "grain";
+                readonly label: "Grain";
+                readonly min: 0;
+                readonly max: 0.35;
+                readonly step: 0.005;
+                readonly hint: "Per-pixel noise. A little hides banding on flat gradients.";
+            };
+            readonly vignette: {
+                readonly default: 0.2;
+                readonly slot: "vignette";
+                readonly label: "Vignette";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly hint: "Darkening towards the edges of the frame.";
+            };
+            readonly thickness: {
+                readonly slot: "a";
+                readonly label: "Thickness";
+                readonly min: 0.5;
+                readonly max: 6;
+                readonly step: 0.1;
+                readonly default: 1.5;
+                readonly hint: "How far apart the kernel taps sit, in source texels.";
+            };
+            readonly threshold: {
+                readonly slot: "b";
+                readonly label: "Threshold";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.15;
+                readonly hint: "How steep a gradient has to be to count as an edge.";
+            };
+            readonly fill: {
+                readonly slot: "c";
+                readonly label: "Fill";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0;
+                readonly hint: "How much of the original shows under the lines.";
+            };
+            readonly glow: {
+                readonly slot: "d";
+                readonly label: "Glow";
+                readonly min: 0;
+                readonly max: 2;
+                readonly step: 0.01;
+                readonly default: 0.4;
+                readonly hint: "Bleed off the line, which reads as ink rather than aliasing.";
+            };
+            readonly intensity: {
+                readonly slot: "intensity";
+                readonly label: "Strength";
+                readonly min: 0;
+                readonly max: 2.5;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Overall brightness of the effect before the post chain.";
+            };
+            readonly vibrancy: {
+                readonly slot: "vibrancy";
+                readonly label: "Vibrancy";
+                readonly min: 0;
+                readonly max: 2;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Saturation. 0 is greyscale, 1 is as authored, 2 is punched.";
+            };
+        };
+        readonly colors: {
+            readonly colorA: ColorControl;
+            readonly colorB: ColorControl;
+            readonly colorC: ColorControl;
+        };
+    };
+    readonly mosaic: {
+        readonly name: "Mosaic";
+        readonly tagline: "The layer rebuilt out of tiles";
+        readonly description: "One tap at each tile's centre, not an average of it — the hard colour is the point, and averaging would only reinvent a blur. Posterising after sampling is what makes it look assembled from a limited set rather than merely coarse. Roundness grows a dot whose size follows the tile's brightness, the way a printed screen does.";
+        readonly family: "image";
+        readonly tags: readonly ["pixelate", "print", "retro"];
+        readonly cost: "light";
+        readonly defaultSource: "aurora";
+        readonly controls: {
+            readonly grain: {
+                readonly default: 0;
+                readonly slot: "grain";
+                readonly label: "Grain";
+                readonly min: 0;
+                readonly max: 0.35;
+                readonly step: 0.005;
+                readonly hint: "Per-pixel noise. A little hides banding on flat gradients.";
+            };
+            readonly vignette: {
+                readonly default: 0.2;
+                readonly slot: "vignette";
+                readonly label: "Vignette";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly hint: "Darkening towards the edges of the frame.";
+            };
+            readonly tiles: {
+                readonly slot: "a";
+                readonly label: "Tiles";
+                readonly min: 4;
+                readonly max: 160;
+                readonly step: 1;
+                readonly default: 42;
+                readonly hint: "Tiles across the short axis. They stay square on any canvas.";
+            };
+            readonly roundness: {
+                readonly slot: "b";
+                readonly label: "Roundness";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0;
+                readonly hint: "0 is a solid tile, 1 is a dot that shrinks as the tile darkens.";
+            };
+            readonly gap: {
+                readonly slot: "c";
+                readonly label: "Gap";
+                readonly min: 0;
+                readonly max: 0.45;
+                readonly step: 0.01;
+                readonly default: 0.02;
+                readonly hint: "Ground left showing between tiles.";
+            };
+            readonly steps: {
+                readonly slot: "d";
+                readonly label: "Colour steps";
+                readonly min: 2;
+                readonly max: 32;
+                readonly step: 1;
+                readonly default: 12;
+                readonly hint: "Levels each channel is quantised to. Low values band on purpose.";
+            };
+            readonly intensity: {
+                readonly slot: "intensity";
+                readonly label: "Strength";
+                readonly min: 0;
+                readonly max: 2.5;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Overall brightness of the effect before the post chain.";
+            };
+            readonly vibrancy: {
+                readonly slot: "vibrancy";
+                readonly label: "Vibrancy";
+                readonly min: 0;
+                readonly max: 2;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Saturation. 0 is greyscale, 1 is as authored, 2 is punched.";
+            };
+        };
+        readonly colors: {
+            readonly colorA: ColorControl;
+            readonly colorB: ColorControl;
+            readonly colorC: ColorControl;
+        };
+    };
+    readonly reveal: {
+        readonly name: "Reveal";
+        readonly tagline: "The layer wiped in over a colour ground";
+        readonly description: "A threshold cutting through a field: noise dissolves, a rotated ramp wipes, and shape slides between the two. At speed 0 the progress control is a scrubber you can drive from your own code — bind it to a scroll position or a load event. Above 0 it loops on its own, which is what makes it worth looking at on a card.";
+        readonly family: "transition";
+        readonly tags: readonly ["wipe", "dissolve", "entrance"];
+        readonly cost: "light";
+        readonly defaultSource: "mesh-gradient";
+        readonly controls: {
+            readonly speed: {
+                readonly default: 0.6;
+                readonly max: 2;
+                readonly slot: "speed";
+                readonly label: "Speed";
+                readonly min: 0;
+                readonly step: 0.01;
+                readonly hint: "Time multiplier. 0 freezes the shader on its current frame.";
+            };
+            readonly scale: {
+                readonly default: 1;
+                readonly slot: "scale";
+                readonly label: "Scale";
+                readonly min: 0.2;
+                readonly max: 3;
+                readonly step: 0.01;
+                readonly hint: "Zoom of the underlying field. Lower is bigger, softer shapes.";
+            };
+            readonly grain: {
+                readonly default: 0.02;
+                readonly slot: "grain";
+                readonly label: "Grain";
+                readonly min: 0;
+                readonly max: 0.35;
+                readonly step: 0.005;
+                readonly hint: "Per-pixel noise. A little hides banding on flat gradients.";
+            };
+            readonly vignette: {
+                readonly default: 0.2;
+                readonly slot: "vignette";
+                readonly label: "Vignette";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly hint: "Darkening towards the edges of the frame.";
+            };
+            readonly warp: {
+                readonly label: "Edge glow";
+                readonly min: 0;
+                readonly max: 2;
+                readonly default: 0.6;
+                readonly hint: "Light riding the boundary, the way a burn does.";
+                readonly slot: "warp";
+                readonly step: 0.01;
+            };
+            readonly progress: {
+                readonly slot: "a";
+                readonly label: "Progress";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0;
+                readonly hint: "Position of the wipe. Set speed to 0 and drive this yourself.";
+            };
+            readonly shape: {
+                readonly slot: "b";
+                readonly label: "Shape";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0.35;
+                readonly hint: "0 dissolves through noise, 1 wipes along a straight edge.";
+            };
+            readonly angle: {
+                readonly slot: "c";
+                readonly label: "Angle";
+                readonly min: 0;
+                readonly max: 1;
+                readonly step: 0.01;
+                readonly default: 0;
+                readonly hint: "Direction of the wipe, as a full turn from 0 to 1.";
+            };
+            readonly softness: {
+                readonly slot: "d";
+                readonly label: "Softness";
+                readonly min: 0.001;
+                readonly max: 0.4;
+                readonly step: 0.001;
+                readonly default: 0.08;
+                readonly hint: "Width of the boundary band. Small is a hard cut.";
+            };
+            readonly intensity: {
+                readonly slot: "intensity";
+                readonly label: "Strength";
+                readonly min: 0;
+                readonly max: 2.5;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Overall brightness of the effect before the post chain.";
+            };
+            readonly vibrancy: {
+                readonly slot: "vibrancy";
+                readonly label: "Vibrancy";
+                readonly min: 0;
+                readonly max: 2;
+                readonly step: 0.01;
+                readonly default: 1;
+                readonly hint: "Saturation. 0 is greyscale, 1 is as authored, 2 is punched.";
+            };
+        };
+        readonly colors: {
+            readonly colorA: ColorControl;
+            readonly colorB: ColorControl;
+            readonly colorC: ColorControl;
+        };
+    };
 };
 export type ShaderRegistry = typeof shaderRegistry;
 export type ShaderName = keyof ShaderRegistry;
 export declare const shaderNames: ShaderName[];
 export declare function getShader<K extends ShaderName>(name: K): ShaderRegistry[K];
 export declare function isShaderName(value: string): value is ShaderName;
+/**
+ * Whether a shader invents its picture or reads one.
+ *
+ * Comes from the build, which reads it off the folder the WGSL lives in, so it
+ * cannot disagree with the bindings the shader actually declares.
+ */
+export declare function shaderKind(name: ShaderName): ShaderKind;
+export declare function isSourceShader(name: ShaderName): boolean;
+/**
+ * The shader a source shader reads when the caller supplies nothing.
+ *
+ * Read through the wide `ShaderDefinition` type on purpose: only source shaders
+ * carry `defaultSource`, so the narrowed literal union does not have the
+ * property and every call site would otherwise need its own cast.
+ */
+export declare function defaultSourceOf(name: ShaderName): ShaderName | undefined;
 /** Every control name a given shader exposes. */
 export type ControlName<K extends ShaderName> = keyof ShaderRegistry[K]["controls"];
 /** The params object a user writes in a config for shader `K`. */