shadertown 0.1.0 → 0.2.0

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAoC,UAAU,EAAE,MAAM,YAAY,CAAC;AA6F7F,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0mD0B,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AACnD,MAAM,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC;AAE9C,eAAO,MAAM,WAAW,EAAkC,UAAU,EAAE,CAAC;AAEvE,wBAAgB,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAE1E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAEvD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAIxE;AAED,iDAAiD;AACjD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,UAAU,IAAI,MAAM,cAAc,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AAEpF,kEAAkE;AAClE,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,UAAU,IAAI,OAAO,CACtD,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EAAE,MAAM,CAAC,CAChF,CAAC"}

package/dist/registry.js

@@ -1,3 +1,4 @@
+import { shaderKinds } from "./generated/sources.js";
 /**
  * Controls that behave identically in every shader. Each entry is spread into
  * a shader's control map and then overridden where that shader wants a
@@ -59,6 +60,17 @@ const base = {
         hint: "Darkening towards the edges of the frame.",
     },
 };
+/**
+ * The subset of `base` that still means something to a shader with no clock of
+ * its own. An image effect has no speed to set and no field to scale, and a
+ * slider that does nothing is worse than a missing one.
+ */
+const still = {
+    intensity: base.intensity,
+    vibrancy: base.vibrancy,
+    grain: base.grain,
+    vignette: base.vignette,
+};
 const warp = {
     slot: "warp",
     label: "Warp",
@@ -1056,6 +1068,612 @@ export const shaderRegistry = {
             colorC: color("Light", "#c9f6ff", "The caustic web itself."),
         },
     },
+    glass: {
+        name: "Glass",
+        tagline: "A refracting, frosted sheet over the layer behind it",
+        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.",
+        family: "optical",
+        tags: ["glass", "refraction", "overlay"],
+        cost: "medium",
+        defaultSource: "neon-grid",
+        controls: {
+            ...base,
+            speed: { ...base.speed, default: 0.35, max: 2 },
+            scale: { ...base.scale, default: 1 },
+            intensity: { ...base.intensity, default: 1 },
+            grain: { ...base.grain, default: 0.02 },
+            vignette: { ...base.vignette, default: 0.2 },
+            warp: { ...warp, label: "Refraction", default: 0.8, max: 2.5, hint: "How far the sheet bends what is behind it." },
+            frost: {
+                slot: "a",
+                label: "Frost",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.35,
+                hint: "Blur radius. Past about 0.6 the layer below stops being readable.",
+            },
+            dispersion: {
+                slot: "b",
+                label: "Dispersion",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.25,
+                hint: "Colour fringing where the sheet is steepest, as in real glass.",
+            },
+            edge: {
+                slot: "c",
+                label: "Edge light",
+                min: 0,
+                max: 2,
+                step: 0.01,
+                default: 0.6,
+                hint: "Highlight along the ridges. This is what makes it read as thick.",
+            },
+            tint: {
+                slot: "d",
+                label: "Tint",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.15,
+                hint: "Pulls the whole sheet towards the palette. 0 leaves it colourless.",
+            },
+        },
+        colors: {
+            colorA: color("Shadow", "#0b1220", "The tint in the thick parts."),
+            colorB: color("Body", "#3b82f6", "The main colour of the pane."),
+            colorC: color("Highlight", "#e0f2fe", "Light caught on the ridges."),
+        },
+    },
+    lens: {
+        name: "Lens",
+        tagline: "Barrel distortion, colour fringing and soft corners",
+        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.",
+        family: "optical",
+        tags: ["camera", "distortion", "retro"],
+        cost: "medium",
+        defaultSource: "neon-grid",
+        controls: {
+            ...still,
+            vignette: { ...still.vignette, default: 0.15 },
+            warp: {
+                ...warp,
+                label: "Distortion",
+                min: -1,
+                max: 2,
+                default: 0.5,
+                hint: "Above zero bows outwards (barrel), below zero pulls inwards (pincushion).",
+            },
+            softness: {
+                slot: "a",
+                label: "Corner softness",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.35,
+                hint: "How far off the focal plane the corners sit.",
+            },
+            fringing: {
+                slot: "b",
+                label: "Fringing",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.4,
+                hint: "How far apart the red and blue ends are bent.",
+            },
+            zoom: {
+                slot: "c",
+                label: "Zoom",
+                min: 0.5,
+                max: 1.5,
+                step: 0.01,
+                default: 1,
+                hint: "Below 1 pulls back and shows the black outside the frame.",
+            },
+            falloff: {
+                slot: "d",
+                label: "Corner falloff",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.4,
+                hint: "Light lost towards the corners, as distortion spreads it thinner.",
+            },
+        },
+        colors: {
+            colorA: color("Shadow", "#05060a", "Unused by the optics; feeds grain and post."),
+            colorB: color("Mid", "#334155", "Unused by the optics; feeds grain and post."),
+            colorC: color("Light", "#e2e8f0", "Unused by the optics; feeds grain and post."),
+        },
+    },
+    bloom: {
+        name: "Bloom",
+        tagline: "Light bleeding out of the bright parts of the layer below",
+        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.",
+        family: "optical",
+        tags: ["glow", "light", "hero"],
+        cost: "heavy",
+        defaultSource: "starfield",
+        controls: {
+            ...still,
+            vignette: { ...still.vignette, default: 0.1 },
+            warp: {
+                ...warp,
+                label: "Streak",
+                min: 0,
+                max: 1,
+                default: 0.15,
+                hint: "Stretches the halo sideways. Small values read as a lens, large as a smear.",
+            },
+            threshold: {
+                slot: "a",
+                label: "Threshold",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.55,
+                hint: "How bright a pixel has to be before it blooms at all.",
+            },
+            radius: {
+                slot: "b",
+                label: "Radius",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.5,
+                hint: "How far the light carries. Wide radii need bright, sparse sources.",
+            },
+            amount: {
+                slot: "c",
+                label: "Amount",
+                min: 0,
+                max: 3,
+                step: 0.01,
+                default: 1.2,
+                hint: "How much of the halo is added back on top.",
+            },
+            tint: {
+                slot: "d",
+                label: "Tint",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.3,
+                hint: "Colours the halo from the palette. Real coatings are rarely neutral.",
+            },
+        },
+        colors: {
+            colorA: color("Cool", "#1e3a8a", "The halo around dimmer light."),
+            colorB: color("Warm", "#f59e0b", "The halo at mid brightness."),
+            colorC: color("Core", "#fff7ed", "The halo around the brightest points."),
+        },
+    },
+    shockwave: {
+        name: "Shockwave",
+        tagline: "Expanding rings that shove the layer aside as they pass",
+        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.",
+        family: "distortion",
+        tags: ["impact", "pulse", "interactive"],
+        cost: "medium",
+        defaultSource: "truchet",
+        controls: {
+            ...base,
+            speed: { ...base.speed, default: 0.8 },
+            grain: { ...base.grain, default: 0.02 },
+            vignette: { ...base.vignette, default: 0.15 },
+            warp: {
+                ...warp,
+                label: "Force",
+                min: 0,
+                max: 2,
+                default: 0.9,
+                hint: "How far the front shoves what it passes over.",
+            },
+            reach: {
+                slot: "a",
+                label: "Reach",
+                min: 0.1,
+                max: 2,
+                step: 0.01,
+                default: 1,
+                hint: "How far a ring travels before it is spent.",
+            },
+            width: {
+                slot: "b",
+                label: "Width",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.35,
+                hint: "Thickness of the front. Thin is a crack, thick is a swell.",
+            },
+            decay: {
+                slot: "c",
+                label: "Decay",
+                min: 0.1,
+                max: 4,
+                step: 0.01,
+                default: 1.5,
+                hint: "How quickly a ring loses force. High values die close to the centre.",
+            },
+            fringing: {
+                slot: "d",
+                label: "Fringing",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.4,
+                hint: "Colour separation across the crest.",
+            },
+        },
+        colors: {
+            colorA: color("Trough", "#0f172a", "Unused by the wave; feeds the crest ramp."),
+            colorB: color("Body", "#0ea5e9", "Unused by the wave; feeds the crest ramp."),
+            colorC: color("Crest", "#f0f9ff", "The light on the front itself."),
+        },
+    },
+    swirl: {
+        name: "Swirl",
+        tagline: "A vortex that winds the layer around a point",
+        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.",
+        family: "distortion",
+        tags: ["vortex", "twist", "interactive"],
+        cost: "light",
+        defaultSource: "voronoi",
+        controls: {
+            ...base,
+            speed: { ...base.speed, default: 1 },
+            grain: { ...base.grain, default: 0.02 },
+            vignette: { ...base.vignette, default: 0.15 },
+            warp: {
+                ...warp,
+                label: "Twist",
+                min: 0,
+                max: 3,
+                default: 1.2,
+                hint: "Turns at the centre. Past about 2 the middle stops being readable.",
+            },
+            radius: {
+                slot: "a",
+                label: "Radius",
+                min: 0.02,
+                max: 1.2,
+                step: 0.01,
+                default: 0.55,
+                hint: "How far the vortex reaches before the layer is untouched.",
+            },
+            falloff: {
+                slot: "b",
+                label: "Falloff",
+                min: 0.1,
+                max: 5,
+                step: 0.01,
+                default: 1.6,
+                hint: "Shape of the edge. Low is a wide whirlpool, high is a tight knot.",
+            },
+            spin: {
+                slot: "c",
+                label: "Spin",
+                min: -1,
+                max: 1,
+                step: 0.01,
+                default: 0.15,
+                hint: "Steady rotation over time. Negative winds the other way.",
+            },
+            smear: {
+                slot: "d",
+                label: "Smear",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.3,
+                hint: "Colour trailing along the direction of travel.",
+            },
+        },
+        colors: {
+            colorA: color("Shadow", "#0b1120", "Unused by the vortex; feeds post."),
+            colorB: color("Mid", "#6d28d9", "Unused by the vortex; feeds post."),
+            colorC: color("Light", "#f5d0fe", "Unused by the vortex; feeds post."),
+        },
+    },
+    flow: {
+        name: "Flow",
+        tagline: "The layer pushed around by a slow, turbulent field",
+        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.",
+        family: "distortion",
+        tags: ["liquid", "organic", "ambient"],
+        cost: "heavy",
+        defaultSource: "halftone",
+        controls: {
+            ...base,
+            speed: { ...base.speed, default: 0.5, max: 2 },
+            scale: { ...base.scale, default: 1 },
+            grain: { ...base.grain, default: 0.02 },
+            vignette: { ...base.vignette, default: 0.2 },
+            warp: {
+                ...warp,
+                label: "Strength",
+                min: 0,
+                max: 2,
+                default: 0.7,
+                hint: "How far the field pushes the layer.",
+            },
+            turbulence: {
+                slot: "a",
+                label: "Turbulence",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.4,
+                hint: "0 is broad lazy currents, 1 is sharp filaments.",
+            },
+            curl: {
+                slot: "b",
+                label: "Curl",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.75,
+                hint: "Turns the drift into circulation. 0 pulls everything one way.",
+            },
+            smear: {
+                slot: "c",
+                label: "Smear",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.35,
+                hint: "Blur along the flow, which is what reads as motion.",
+            },
+            tint: {
+                slot: "d",
+                label: "Tint",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.2,
+                hint: "Colours the fast water from the palette.",
+            },
+        },
+        colors: {
+            colorA: color("Still", "#082f49", "Where the field is barely moving."),
+            colorB: color("Current", "#0891b2", "Mid-speed water."),
+            colorC: color("Race", "#a5f3fc", "The fastest part of the flow."),
+        },
+    },
+    duotone: {
+        name: "Duotone",
+        tagline: "The layer's brightness read through your palette",
+        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.",
+        family: "image",
+        tags: ["colour", "poster", "brand"],
+        cost: "light",
+        defaultSource: "julia",
+        controls: {
+            ...still,
+            grain: { ...still.grain, default: 0.02 },
+            vignette: { ...still.vignette, default: 0.2 },
+            black: {
+                slot: "a",
+                label: "Black point",
+                min: 0,
+                max: 0.6,
+                step: 0.01,
+                default: 0.05,
+                hint: "Brightness that maps to the first colour. Raise it to crush shadows.",
+            },
+            white: {
+                slot: "b",
+                label: "White point",
+                min: 0.4,
+                max: 1,
+                step: 0.01,
+                default: 0.9,
+                hint: "Brightness that maps to the last colour. Lower it to blow highlights.",
+            },
+            contrast: {
+                slot: "c",
+                label: "Contrast",
+                min: 0.2,
+                max: 3,
+                step: 0.01,
+                default: 1.2,
+                hint: "Steepness of the ramp between the two points.",
+            },
+            keep: {
+                slot: "d",
+                label: "Keep colour",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0,
+                hint: "Mixes the original chroma back over the mapped tone.",
+            },
+        },
+        colors: {
+            colorA: color("Shadow", "#170b3b", "The darkest tone in the layer."),
+            colorB: color("Mid", "#c2255c", "Everything in the middle."),
+            colorC: color("Light", "#ffd166", "The brightest tone in the layer."),
+        },
+    },
+    edges: {
+        name: "Edges",
+        tagline: "The layer reduced to its outlines",
+        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.",
+        family: "image",
+        tags: ["outline", "line art", "technical"],
+        cost: "medium",
+        defaultSource: "truchet",
+        controls: {
+            ...still,
+            grain: { ...still.grain, default: 0.01 },
+            vignette: { ...still.vignette, default: 0.2 },
+            thickness: {
+                slot: "a",
+                label: "Thickness",
+                min: 0.5,
+                max: 6,
+                step: 0.1,
+                default: 1.5,
+                hint: "How far apart the kernel taps sit, in source texels.",
+            },
+            threshold: {
+                slot: "b",
+                label: "Threshold",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.15,
+                hint: "How steep a gradient has to be to count as an edge.",
+            },
+            fill: {
+                slot: "c",
+                label: "Fill",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0,
+                hint: "How much of the original shows under the lines.",
+            },
+            glow: {
+                slot: "d",
+                label: "Glow",
+                min: 0,
+                max: 2,
+                step: 0.01,
+                default: 0.4,
+                hint: "Bleed off the line, which reads as ink rather than aliasing.",
+            },
+        },
+        colors: {
+            colorA: color("Paper", "#0a0a0f", "The ground the lines are drawn on."),
+            colorB: color("Mid", "#334155", "Unused by the trace; feeds the ramp."),
+            colorC: color("Ink", "#67e8f9", "The lines themselves."),
+        },
+    },
+    mosaic: {
+        name: "Mosaic",
+        tagline: "The layer rebuilt out of tiles",
+        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.",
+        family: "image",
+        tags: ["pixelate", "print", "retro"],
+        cost: "light",
+        defaultSource: "aurora",
+        controls: {
+            ...still,
+            grain: { ...still.grain, default: 0 },
+            vignette: { ...still.vignette, default: 0.2 },
+            tiles: {
+                slot: "a",
+                label: "Tiles",
+                min: 4,
+                max: 160,
+                step: 1,
+                default: 42,
+                hint: "Tiles across the short axis. They stay square on any canvas.",
+            },
+            roundness: {
+                slot: "b",
+                label: "Roundness",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0,
+                hint: "0 is a solid tile, 1 is a dot that shrinks as the tile darkens.",
+            },
+            gap: {
+                slot: "c",
+                label: "Gap",
+                min: 0,
+                max: 0.45,
+                step: 0.01,
+                default: 0.02,
+                hint: "Ground left showing between tiles.",
+            },
+            steps: {
+                slot: "d",
+                label: "Colour steps",
+                min: 2,
+                max: 32,
+                step: 1,
+                default: 12,
+                hint: "Levels each channel is quantised to. Low values band on purpose.",
+            },
+        },
+        colors: {
+            colorA: color("Grout", "#08080c", "What shows in the gaps between tiles."),
+            colorB: color("Mid", "#475569", "Unused by the tiling; feeds post."),
+            colorC: color("Light", "#e2e8f0", "Unused by the tiling; feeds post."),
+        },
+    },
+    reveal: {
+        name: "Reveal",
+        tagline: "The layer wiped in over a colour ground",
+        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.",
+        family: "transition",
+        tags: ["wipe", "dissolve", "entrance"],
+        cost: "light",
+        defaultSource: "mesh-gradient",
+        controls: {
+            ...base,
+            speed: { ...base.speed, default: 0.6, max: 2 },
+            scale: { ...base.scale, default: 1 },
+            grain: { ...base.grain, default: 0.02 },
+            vignette: { ...base.vignette, default: 0.2 },
+            warp: {
+                ...warp,
+                label: "Edge glow",
+                min: 0,
+                max: 2,
+                default: 0.6,
+                hint: "Light riding the boundary, the way a burn does.",
+            },
+            progress: {
+                slot: "a",
+                label: "Progress",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0,
+                hint: "Position of the wipe. Set speed to 0 and drive this yourself.",
+            },
+            shape: {
+                slot: "b",
+                label: "Shape",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0.35,
+                hint: "0 dissolves through noise, 1 wipes along a straight edge.",
+            },
+            angle: {
+                slot: "c",
+                label: "Angle",
+                min: 0,
+                max: 1,
+                step: 0.01,
+                default: 0,
+                hint: "Direction of the wipe, as a full turn from 0 to 1.",
+            },
+            softness: {
+                slot: "d",
+                label: "Softness",
+                min: 0.001,
+                max: 0.4,
+                step: 0.001,
+                default: 0.08,
+                hint: "Width of the boundary band. Small is a hard cut.",
+            },
+        },
+        colors: {
+            colorA: color("Ground", "#0a0a12", "The colour the layer wipes in over."),
+            colorB: color("Mid", "#4c1d95", "The middle of the ground ramp."),
+            colorC: color("Edge", "#fbcfe8", "The light on the boundary itself."),
+        },
+    },
 };
 export const shaderNames = Object.keys(shaderRegistry);
 export function getShader(name) {
@@ -1064,4 +1682,28 @@ export function getShader(name) {
 export function isShaderName(value) {
     return Object.hasOwn(shaderRegistry, value);
 }
+/**
+ * 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 function shaderKind(name) {
+    return shaderKinds[name];
+}
+export function isSourceShader(name) {
+    return shaderKinds[name] === "source";
+}
+/**
+ * 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 function defaultSourceOf(name) {
+    const definition = shaderRegistry[name];
+    const fallback = definition.defaultSource;
+    return fallback && isShaderName(fallback) ? fallback : undefined;
+}
 //# sourceMappingURL=registry.js.map