shaders 4.0.3 → 4.0.4

package/dist/core/docs-manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "engineVersion": "4.0.3",
-  "generatedAt": "2026-10-08T23:34:23.198Z",
+  "engineVersion": "4.0.4",
+  "generatedAt": "2026-10-09T13:23:52.458Z",
   "groups": [
     {
       "id": "define",
@@ -1940,9 +1940,11 @@
         "effects.blurs.BlurPathSpec",
         "effects.blurs.ComputeBackedEffect",
         "effects.blurs.GatherFrame",
+        "effects.blurs.MotionBlurDetailSlots",
         "effects.blurs.OverlayStage",
         "effects.blurs.PeelShade",
-        "effects.blurs.SampleStage"
+        "effects.blurs.SampleStage",
+        "effects.blurs.VariableBlurDetailSlots"
       ],
       "intro": "Effects that read the layer inside them (the child) as a texture and rebuild it: blurs, glows,\nsharpening, pixelation, shadows, retro screens, glitches, fluted glass, page peels and mirror\nfloors. A **pointwise** effect edits the child's color at one pixel; the words here are\n**gather** effects, which sample the child at other pixels too, so they can smear, spread and\ndisplace it. Every word here goes in a filter definition's `effect:` field, or spreads into a\ndefinition when it needs its own pass over the child first.\n\nFinished effects are one call: `gaussianBlur`, `motionBlur`, `bloom`, `pixelate`, `sharpen`,\n`scatter`, `bokehDefocus`. Stacked looks are assembled with `gatherStack` from a **sampling\nstage** (how the child is first read: `rgbSplit`, `chromaSmearTaps`, `crispTap`, `childTap`)\nand ordered **overlay stages** that edit the result (`scanlines`, `adjust`, `rimLit`,\n`shadowComposite`). When several stages need the same geometry, build a **frame** once\n(`sphereFrame`, `glitchFrame`, `fluteFrame`, `peelFrame`) and hand it to each of them.\n\nBlurs that need a separate pass (`gaussianBlur`, `channelBlur`, `progressiveBlur`,\n`tiltShift`, `bloom`, `bokehDefocus`) return both halves at once. Spread them into a definition\nthat declares `species: 'custom'`, `requiresRTT: true` and `requiresChild: true` instead of\nusing `effect:`.",
       "example": "import {defineShader, p, effects, transformColor, transformBoolean} from 'shaders/std'\n\nconst {gatherStack, childTap, shadowOffset, silhouetteCoverage, shadowComposite} = effects.blurs\n\n// A soft drop shadow: read the child's silhouette offset in a compass direction, blur it,\n// tint it, and place it behind the child.\nexport const SoftShadow = defineShader({\n  name: 'SoftShadow',\n  props: {\n    color: {default: '#000000', transform: transformColor},\n    distance: {default: 0.1},\n    angle: {default: 135},\n    blur: {default: 5},\n    intensity: {default: 0.5},\n    cutout: {default: false, transform: transformBoolean, compileTime: true},\n  },\n  effect: gatherStack(childTap(), [\n    shadowComposite({\n      coverage: silhouetteCoverage({\n        at: shadowOffset({angle: p('angle'), distance: p('distance')}),\n        blur: p('blur'),\n      }),\n      color: p('color'),\n      intensity: p('intensity'),\n      cutout: p('cutout'),\n    }),\n  ]),\n})",
@@ -3472,22 +3474,28 @@
         "usage": "crosses"
       },
       "usedBy": [
+        "AngularBlur",
         "BrightnessContrast",
+        "DiffuseBlur",
         "Exposure",
         "FilmGrain",
         "FilmStock",
         "Glow",
         "GradientMap",
         "HueShift",
+        "LinearBlur",
         "MeshGradient",
+        "ProgressiveBlur",
         "Repeater",
         "Saturation",
         "Sharpness",
         "Solarize",
         "Sparkle",
+        "TiltShift",
         "Vibrance",
         "Vignette",
-        "Watercolor"
+        "Watercolor",
+        "ZoomBlur"
       ],
       "documented": true,
       "source": {
@@ -20157,12 +20165,14 @@
       "category": "effects.blurs",
       "module": "std/effects/blurs.ts",
       "summary": "Smears the child along a path: a straight streak, an arc around a point, or a zoom out of a point.",
-      "description": "`amount` is a 0–100 intensity. A linear streak spans about twice `amount` in pixels; at 100 an orbit sweeps about 29 degrees and a zoom pulls in from twice the distance to its center.",
+      "description": "`amount` is a 0–100 intensity. A linear streak spans about twice `amount` in pixels; at 100 an orbit sweeps about 29 degrees and a zoom pulls in from twice the distance to its center. `detail` adds the lens dials (`dispersion`, `falloff`, `focus`) and streak dials (`bias`, `highlights`, `jitter`, and `spiral` for a zoom); all are off at 0 and cost nothing until one is set.",
       "examples": [
-        "effect: motionBlur({path: blurPath.linear(p('angle')), amount: p('intensity')})"
+        "effect: motionBlur({path: blurPath.linear(p('angle')), amount: p('intensity')})",
+        "effect: motionBlur({path: blurPath.zoom(p('center')), amount: p('intensity'), detail: {dispersion: p('dispersion'), falloff: p('falloff'), focus: p('focus'), bias: p('bias'), highlights: p('highlights'), jitter: p('jitter'), spiral: p('spiral')}})"
       ],
       "tips": [
-        "Samples past the canvas edge repeat the border color. Wrap the layer in a larger group if the smear must fade out instead."
+        "Samples past the canvas edge repeat the border color. Wrap the layer in a larger group if the smear must fade out instead.",
+        "Give every `detail` prop `recompile: crosses(0)`; the detail gather is only compiled while one of them is non-zero."
       ],
       "see": [
         "effects.blurs.blurPath",
@@ -20181,14 +20191,14 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 396
+        "line": 429
       },
       "kind": "function",
-      "signature": "motionBlur(opts: {path: BlurPathSpec; amount: ArgSpec}): GatherEffect",
+      "signature": "motionBlur(opts: {path: BlurPathSpec; amount: ArgSpec; detail?: MotionBlurDetailSlots}): GatherEffect",
       "params": [
         {
           "name": "opts",
-          "type": "{path: BlurPathSpec; amount: ArgSpec}",
+          "type": "{path: BlurPathSpec; amount: ArgSpec; detail?: MotionBlurDetailSlots}",
           "optional": false
         }
       ]
@@ -20200,7 +20210,7 @@
       "category": "effects.blurs",
       "module": "std/effects/blurs.ts",
       "summary": "Scatters every pixel of the child by a random offset: a grainy diffusion, not a smooth blur.",
-      "description": "`amount` is the largest offset in pixels. `edges` is a prop with `transform: transformEdges` and `compileTime: true` ('stretch' | 'transparent' | 'mirror' | 'wrap') that says what to read where an offset lands outside the canvas.",
+      "description": "`amount` is the largest offset in pixels. `edges` is a prop with `transform: transformEdges` and `compileTime: true` ('stretch' | 'transparent' | 'mirror' | 'wrap') that says what to read where an offset lands outside the canvas. `chromatic` (0–1, optional) scatters red and blue on their own, for a sparkly colour grain; it is off at 0, so give it `recompile: crosses(0)`.",
       "examples": [
         "effect: scatter({amount: p('intensity'), edges: p('edges')})"
       ],
@@ -20219,14 +20229,14 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 428
+        "line": 491
       },
       "kind": "function",
-      "signature": "scatter(opts: {amount: ArgSpec; edges: PropRef}): GatherEffect",
+      "signature": "scatter(opts: {amount: ArgSpec; edges: PropRef; chromatic?: PropRef}): GatherEffect",
       "params": [
         {
           "name": "opts",
-          "type": "{amount: ArgSpec; edges: PropRef}",
+          "type": "{amount: ArgSpec; edges: PropRef; chromatic?: PropRef}",
           "optional": false
         }
       ]
@@ -20259,7 +20269,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 457
+        "line": 521
       },
       "kind": "function",
       "signature": "sharpen(amount: ArgSpec): GatherEffect",
@@ -20297,7 +20307,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 485
+        "line": 549
       },
       "kind": "function",
       "signature": "pixelate(opts: {scale: ArgSpec; gap: ArgSpec; roundness: ArgSpec}): GatherEffect",
@@ -20336,7 +20346,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 516
+        "line": 580
       },
       "kind": "function",
       "signature": "sphereFrame(opts: {center: ArgSpec; radius: ArgSpec; depth: ArgSpec}): GatherFrame",
@@ -20375,7 +20385,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 539
+        "line": 603
       },
       "kind": "function",
       "signature": "crispTap(frame: GatherFrame): SampleStage",
@@ -20414,7 +20424,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 562
+        "line": 626
       },
       "kind": "function",
       "signature": "rimLit(frame: GatherFrame, opts: {\n    position: ArgSpec\n    intensity: ArgSpec\n    softness: ArgSpec\n    color: PropRef\n}): OverlayStage",
@@ -20459,7 +20469,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 596
+        "line": 660
       },
       "kind": "function",
       "signature": "glitchFrame(opts: {\n    intensity: ArgSpec\n    speed: ArgSpec\n    blockDensity: ArgSpec\n    mirrorAmount: ArgSpec\n}): GatherFrame",
@@ -20498,7 +20508,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 622
+        "line": 686
       },
       "kind": "function",
       "signature": "glitchRgbSplit(frame: GatherFrame, opts: {shift: ArgSpec}): SampleStage",
@@ -20542,7 +20552,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 649
+        "line": 713
       },
       "kind": "function",
       "signature": "colorBarFills(frame: GatherFrame, opts: {intensity: ArgSpec}): OverlayStage",
@@ -20585,7 +20595,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 671
+        "line": 735
       },
       "kind": "function",
       "signature": "distortedScanlines(frame: GatherFrame, opts: {intensity: ArgSpec}): OverlayStage",
@@ -20633,7 +20643,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 721
+        "line": 785
       },
       "kind": "function",
       "signature": "gaussianBlur(opts: {intensity: PropRef}): ComputeBackedEffect",
@@ -20671,7 +20681,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 771
+        "line": 835
       },
       "kind": "function",
       "signature": "channelBlur(opts: {red: PropRef; green: PropRef; blue: PropRef}): ComputeBackedEffect",
@@ -20690,7 +20700,7 @@
       "category": "effects.blurs",
       "module": "std/effects/blurs.ts",
       "summary": "A blur that ramps from sharp to full strength in one direction across the child.",
-      "description": "The ramp starts at `center` (a position in uv) and runs along `angle` (degrees, 0 points right), reaching full blur `falloff` (0–1, in uv) past the center. `intensity` (0–100) is the blur at the far end; 100 is a radius of about 36 pixels. Bind `intensity` to a map to vary the ceiling per pixel. Alpha stays sharp.",
+      "description": "The ramp starts at `center` (a position in uv) and runs along `angle` (degrees, 0 points right), reaching full blur `falloff` (0–1, in uv) past the center. `intensity` (0–100) is the blur at the far end; 100 is a radius of about 36 pixels. Bind `intensity` to a map to vary the ceiling per pixel. Alpha stays sharp. `detail` adds the lens dials (see `VariableBlurDetailSlots`), both off at 0.",
       "examples": [
         "...progressiveBlur({intensity: p('intensity'), angle: p('angle'), center: p('center'), falloff: p('falloff')})"
       ],
@@ -20709,14 +20719,14 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 811
+        "line": 904
       },
       "kind": "function",
-      "signature": "progressiveBlur(opts: {\n    intensity: PropRef\n    angle: PropRef\n    center: PropRef\n    falloff: PropRef\n}): ComputeBackedEffect",
+      "signature": "progressiveBlur(opts: {\n    intensity: PropRef\n    angle: PropRef\n    center: PropRef\n    falloff: PropRef\n    detail?: VariableBlurDetailSlots\n}): ComputeBackedEffect",
       "params": [
         {
           "name": "opts",
-          "type": "{\n    intensity: PropRef\n    angle: PropRef\n    center: PropRef\n    falloff: PropRef\n}",
+          "type": "{\n    intensity: PropRef\n    angle: PropRef\n    center: PropRef\n    falloff: PropRef\n    detail?: VariableBlurDetailSlots\n}",
           "optional": false
         }
       ]
@@ -20728,7 +20738,7 @@
       "category": "effects.blurs",
       "module": "std/effects/blurs.ts",
       "summary": "Keeps a band of the child in focus and blurs everything beyond it, like a tilt-shift lens.",
-      "description": "The band runs through `center` (a position in uv) at `angle` (degrees, 0 is horizontal) and is `width` wide (0–1, in uv). Beyond it the blur ramps to full strength over `falloff` (0–1). `intensity` (0–100) is the blur at the far edges. Pixels inside the band stay pixel-sharp.",
+      "description": "The band runs through `center` (a position in uv) at `angle` (degrees, 0 is horizontal) and is `width` wide (0–1, in uv). Beyond it the blur ramps to full strength over `falloff` (0–1). `intensity` (0–100) is the blur at the far edges. Pixels inside the band stay pixel-sharp. `detail` adds the lens dials (see `VariableBlurDetailSlots`), both off at 0.",
       "examples": [
         "...tiltShift({intensity: p('intensity'), width: p('width'), falloff: p('falloff'), angle: p('angle'), center: p('center')})"
       ],
@@ -20748,14 +20758,14 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 885
+        "line": 983
       },
       "kind": "function",
-      "signature": "tiltShift(opts: {\n    intensity: PropRef\n    width: PropRef\n    falloff: PropRef\n    angle: PropRef\n    center: PropRef\n}): ComputeBackedEffect",
+      "signature": "tiltShift(opts: {\n    intensity: PropRef\n    width: PropRef\n    falloff: PropRef\n    angle: PropRef\n    center: PropRef\n    detail?: VariableBlurDetailSlots\n}): ComputeBackedEffect",
       "params": [
         {
           "name": "opts",
-          "type": "{\n    intensity: PropRef\n    width: PropRef\n    falloff: PropRef\n    angle: PropRef\n    center: PropRef\n}",
+          "type": "{\n    intensity: PropRef\n    width: PropRef\n    falloff: PropRef\n    angle: PropRef\n    center: PropRef\n    detail?: VariableBlurDetailSlots\n}",
           "optional": false
         }
       ]
@@ -20787,7 +20797,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 967
+        "line": 1069
       },
       "kind": "function",
       "signature": "bloom(opts: {intensity: PropRef; threshold: PropRef; size: PropRef}): ComputeBackedEffect",
@@ -20825,7 +20835,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1005
+        "line": 1107
       },
       "kind": "function",
       "signature": "childTap(): SampleStage",
@@ -20857,7 +20867,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1023
+        "line": 1125
       },
       "kind": "function",
       "signature": "shadowOffset(opts: {angle: ArgSpec; distance: ArgSpec}): (params: RttFilterParams) => Expr",
@@ -20895,7 +20905,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1044
+        "line": 1146
       },
       "kind": "function",
       "signature": "silhouetteCoverage(opts: {at: (params: RttFilterParams) => Expr; blur: ArgSpec}): (params: RttFilterParams) => Expr",
@@ -20934,7 +20944,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1069
+        "line": 1171
       },
       "kind": "function",
       "signature": "shadowComposite(opts: {\n    coverage: (params: RttFilterParams) => Expr\n    color: PropRef\n    intensity: ArgSpec\n    cutout: PropRef\n}): OverlayStage",
@@ -20973,7 +20983,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1115
+        "line": 1217
       },
       "kind": "function",
       "signature": "fluteFrame(opts: {\n    shape: PropRef\n    angle: ArgSpec\n    frequency: ArgSpec\n    softness: ArgSpec\n    waveAmplitude: ArgSpec\n    waveFrequency: ArgSpec\n    refraction: ArgSpec\n    aberration: ArgSpec\n}): GatherFrame",
@@ -21012,7 +21022,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1158
+        "line": 1260
       },
       "kind": "function",
       "signature": "refractedTaps(frame: GatherFrame, opts: {aberration: PropRef; edges: PropRef}): SampleStage",
@@ -21056,7 +21066,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1188
+        "line": 1290
       },
       "kind": "function",
       "signature": "fluteHighlight(frame: GatherFrame, opts: {\n    lightAngle: ArgSpec\n    highlight: ArgSpec\n    softness: ArgSpec\n    color: PropRef\n}): OverlayStage",
@@ -21104,7 +21114,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1233
+        "line": 1335
       },
       "kind": "function",
       "signature": "peelFrame(opts: {corner: PropRef; amount: ArgSpec; radius: ArgSpec}): GatherFrame",
@@ -21143,7 +21153,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1256
+        "line": 1358
       },
       "kind": "function",
       "signature": "curlShading(frame: GatherFrame, opts: {shading: ArgSpec}): PeelShade",
@@ -21187,7 +21197,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1272
+        "line": 1374
       },
       "kind": "function",
       "signature": "curlSheen(frame: GatherFrame, opts: {highlight: ArgSpec; softness: ArgSpec}): PeelShade",
@@ -21231,7 +21241,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1290
+        "line": 1392
       },
       "kind": "function",
       "signature": "overhangShadow(frame: GatherFrame, opts: {amount: ArgSpec; shadow: ArgSpec}): PeelShade",
@@ -21275,7 +21285,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1311
+        "line": 1413
       },
       "kind": "function",
       "signature": "revealShadow(frame: GatherFrame, opts: {amount: ArgSpec; shadow: ArgSpec}): PeelShade",
@@ -21321,7 +21331,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1335
+        "line": 1437
       },
       "kind": "function",
       "signature": "peelCompose(frame: GatherFrame, parts: {\n    shade: PeelShade\n    sheen: PeelShade\n    overhang: PeelShade\n    reveal: PeelShade\n}): SampleStage",
@@ -21364,7 +21374,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1443
+        "line": 1545
       },
       "kind": "function",
       "signature": "mirrorAcrossRow(line: PropRef): (params: GpuFragmentParams) => Expr",
@@ -21403,7 +21413,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1465
+        "line": 1567
       },
       "kind": "function",
       "signature": "depthRampBlur(opts: {line: PropRef; blur: PropRef; blurDistance: PropRef; halfKernel: number}): {compute: GpuComputeNode}",
@@ -21441,7 +21451,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1496
+        "line": 1598
       },
       "kind": "function",
       "signature": "planarReflection(opts: {line: PropRef; distance: PropRef; falloff: PropRef; edges: PropRef}, original: Expr, reflection: (uv: Expr) => Expr, reflectedUV: (params: GpuFragmentParams) => Expr): (params: GpuFragmentParams) => Expr",
@@ -21496,7 +21506,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1555
+        "line": 1657
       },
       "kind": "function",
       "signature": "screenedBloom(slots: {\n    strength: PropRef\n    radius: PropRef\n    tint: [number, number, number]\n    threshold: number\n    output: string\n    extractName: string\n}): {\n    compute: GpuComputeNode\n    screen: (base: Expr, at: Expr, params: GpuFragmentParams) => Expr\n}",
@@ -21535,7 +21545,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1626
+        "line": 1728
       },
       "kind": "function",
       "signature": "frameSway(slots: {amount: PropRef; field: string}): (params: GpuFragmentParams) => Expr",
@@ -21554,7 +21564,7 @@
       "category": "effects.blurs",
       "module": "std/effects/blurs.ts",
       "summary": "A photographic lens blur where bright highlights bloom into aperture-shaped discs.",
-      "description": "`radius` (0–100) is the defocus; 100 is a disc about 80 pixels across. `gain` (0–10) is how strongly highlights bloom and `threshold` (0–1) the brightness they must pass. `shape` is a string prop: 'blades' | 'circle' | 'star' | 'heart' | 'flower' | 'cross' | 'ring'. `blades` (0–9) counts blades or points for the blades, star and flower shapes; 0–2 is a round iris. `rotation` is in degrees and `fringe` (0–1) adds color fringing at the disc edges. Both color and coverage blur, so silhouettes soften like a real lens. Changing the aperture never recompiles. Spread it into a definition with `species: 'custom'`, `requiresRTT: true` and `requiresChild: true`.",
+      "description": "`radius` (0–100) is the defocus; 100 is a disc about 80 pixels across. `gain` (0–10) is how strongly highlights bloom and `threshold` (0–1) the brightness they must pass. `shape` is a string prop: 'blades' | 'circle' | 'star' | 'heart' | 'flower' | 'cross' | 'ring'. `blades` (0–9) counts blades or points for the blades, star and flower shapes; 0–2 is a round iris. `rotation` is in degrees and `fringe` (0–1) adds color fringing at the disc edges. `catEye` (0–1, optional) clips the discs into cat-eye shapes toward the frame corners, the way a lens barrel vignettes its aperture; 0 is off. Both color and coverage blur, so silhouettes soften like a real lens. Changing the aperture never recompiles. Spread it into a definition with `species: 'custom'`, `requiresRTT: true` and `requiresChild: true`.",
       "examples": [
         "...bokehDefocus({radius: p('radius'), gain: p('highlightGain'), threshold: p('highlightThreshold'), shape: p('bladeShape'), blades: p('bladeCount'), rotation: p('bladeRotation'), fringe: p('chromaticFringe')})"
       ],
@@ -21574,14 +21584,14 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1690
+        "line": 1793
       },
       "kind": "function",
-      "signature": "bokehDefocus(opts: {\n    radius: PropRef\n    gain: PropRef\n    threshold: PropRef\n    shape: PropRef\n    blades: PropRef\n    rotation: PropRef\n    fringe: PropRef\n}): {compute: GpuComputeNode; gpu: {fragment: (params: GpuFragmentParams) => Expr}}",
+      "signature": "bokehDefocus(opts: {\n    radius: PropRef\n    gain: PropRef\n    threshold: PropRef\n    shape: PropRef\n    blades: PropRef\n    rotation: PropRef\n    fringe: PropRef\n    catEye?: PropRef\n}): {compute: GpuComputeNode; gpu: {fragment: (params: GpuFragmentParams) => Expr}}",
       "params": [
         {
           "name": "opts",
-          "type": "{\n    radius: PropRef\n    gain: PropRef\n    threshold: PropRef\n    shape: PropRef\n    blades: PropRef\n    rotation: PropRef\n    fringe: PropRef\n}",
+          "type": "{\n    radius: PropRef\n    gain: PropRef\n    threshold: PropRef\n    shape: PropRef\n    blades: PropRef\n    rotation: PropRef\n    fringe: PropRef\n    catEye?: PropRef\n}",
           "optional": false
         }
       ]
@@ -28314,6 +28324,20 @@
         "line": 337
       }
     },
+    "effects.blurs.MotionBlurDetailSlots": {
+      "id": "effects.blurs.MotionBlurDetailSlots",
+      "name": "MotionBlurDetailSlots",
+      "category": "effects.blurs",
+      "module": "std/effects/blurs.ts",
+      "kind": "interface",
+      "text": "interface MotionBlurDetailSlots {\n    /** −1 to 1: tint the taps along the streak with a spectrum, red at one end and violet at the other; the sign swaps the ends. */\n    dispersion?: PropRef\n    /** 0–1: concentrate the dispersion away from the centre; 0 spreads it evenly. */\n    falloff?: PropRef\n    /** 0–1: a clean zone around the centre that the blur leaves untouched. */\n    focus?: PropRef\n    /** −1 to 1: trail the streak off one side of each pixel instead of both. */\n    bias?: PropRef\n    /** 0–1: let bright pixels streak further than dark ones. */\n    highlights?: PropRef\n    /** 0–1: dither the tap comb with per-pixel noise so long streaks do not band. */\n    jitter?: PropRef\n    /** −1 to 1, zoom paths only: corkscrew the streak around the centre. */\n    spiral?: PropRef\n}",
+      "summary": "The optional lens and streak dials of `motionBlur`.",
+      "description": "Each is a prop ref whose value 0 is off; give every one `recompile: crosses(0)` so the shader switches between the plain gather and the detail gather exactly when a dial leaves or returns to 0.",
+      "source": {
+        "file": "std/effects/blurs.ts",
+        "line": 386
+      }
+    },
     "effects.blurs.ComputeBackedEffect": {
       "id": "effects.blurs.ComputeBackedEffect",
       "name": "ComputeBackedEffect",
@@ -28325,7 +28349,21 @@
       "description": "Spread the whole object into a definition that declares `species: 'custom'`, `requiresRTT: true` and `requiresChild: true`.",
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 698
+        "line": 762
+      }
+    },
+    "effects.blurs.VariableBlurDetailSlots": {
+      "id": "effects.blurs.VariableBlurDetailSlots",
+      "name": "VariableBlurDetailSlots",
+      "category": "effects.blurs",
+      "module": "std/effects/blurs.ts",
+      "kind": "interface",
+      "text": "interface VariableBlurDetailSlots {\n    dispersion?: PropRef\n    jitter?: PropRef\n}",
+      "summary": "The optional lens dials of `progressiveBlur` and `tiltShift`.",
+      "description": "`dispersion` (−1 to 1) blurs red and blue by different radii for a defocus colour fringe that grows with the blur; `jitter` (0–1) dithers the tap comb so long radii do not band. Both are off at 0 and read per frame; give `dispersion` `recompile: crosses(0)`, since its kernel is only built while it is non-zero.",
+      "source": {
+        "file": "std/effects/blurs.ts",
+        "line": 864
       }
     },
     "effects.blurs.PeelShade": {
@@ -28339,7 +28377,7 @@
       "description": "`curlShading`, `curlSheen`, `overhangShadow` and `revealShadow` each make one; `peelCompose` takes all four.",
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1212
+        "line": 1314
       }
     },
     "effects.stylize.GatherStage": {

package/dist/core/gpu/kit/blur.d.ts

@@ -71,6 +71,12 @@ export interface VariableBlurComputeResult {
     setInputDimensions: (width: number, height: number) => void;
     /** blur-run: (re)bind the source texture the H pass reads (see GaussianBlurComputeResult). */
     setInputTexture: (input: BlurInputTexture) => void;
+    /**
+     * Per-frame detail dials: `jitter` (0–1) dithers the tap comb; `dispersion` (signed) is the
+     * per-channel radius spread, read only by a graph built with `chromatic: true`. Patches the
+     * uniforms only when a value changes.
+     */
+    setDetail: (jitter: number, dispersion: number) => void;
 }
 /**
  * GPU-free construction of the fixed-blur node graph: bind-group layouts + kernel fns. No
@@ -138,11 +144,21 @@ export declare function buildFixedBlurGraph(halfKernel: number, computeWidth: nu
  * @param computeWidth/computeHeight - fixed internal compute resolution (never reallocated).
  */
 export declare function createGaussianBlurCompute(root: TgpuRoot, inputTexture: BlurInputTexture | null, inputWidth: number, inputHeight: number, onCleanup: (cb: () => void) => void, halfKernel?: number, computeWidth?: number, computeHeight?: number): GaussianBlurComputeResult;
+export interface VariableBlurGraphOptions {
+    /**
+     * Blur red, green and blue by different radii (`radius × (1 ± dispersion)`) for a defocus
+     * colour fringe. A build-time variant — three loads per tap instead of one — so callers only
+     * enable it while the dispersion is non-zero.
+     */
+    chromatic?: boolean;
+}
 /**
- * GPU-free construction of the variable-blur node graph. `jitterTaps` is a build-time constant
- * baked into the kernel bodies (comptime), so enabling it changes the emitted WGSL.
+ * GPU-free construction of the variable-blur node graph. The tap comb is dithered by
+ * interleaved gradient noise (Jimenez 2014) scaled by the runtime `jitter` uniform — at 0 the
+ * offsets are exactly the undithered comb. `options.chromatic` selects the three-radius kernel
+ * bodies (comptime), so enabling it changes the emitted WGSL.
  */
-export declare function buildVariableBlurGraph(halfKernel: number, computeWidth: number, computeHeight: number, jitterTaps: boolean): {
+export declare function buildVariableBlurGraph(halfKernel: number, computeWidth: number, computeHeight: number, options?: VariableBlurGraphOptions): {
     hLayout: TgpuBindGroupLayout<{
         blurMap: {
             storageTexture: d.WgslStorageTexture2d<"rgba32float", string>;
@@ -161,6 +177,8 @@ export declare function buildVariableBlurGraph(halfKernel: number, computeWidth:
             uniform: d.WgslStruct<{
                 inputWidth: d.F32;
                 inputHeight: d.F32;
+                jitter: d.F32;
+                dispersion: d.F32;
             }>;
         };
     }>;
@@ -181,6 +199,8 @@ export declare function buildVariableBlurGraph(halfKernel: number, computeWidth:
         params: {
             uniform: d.WgslStruct<{
                 scaleY: d.F32;
+                jitter: d.F32;
+                dispersion: d.F32;
             }>;
         };
     }>;
@@ -189,9 +209,13 @@ export declare function buildVariableBlurGraph(halfKernel: number, computeWidth:
     HParams: d.WgslStruct<{
         inputWidth: d.F32;
         inputHeight: d.F32;
+        jitter: d.F32;
+        dispersion: d.F32;
     }>;
     VParams: d.WgslStruct<{
         scaleY: d.F32;
+        jitter: d.F32;
+        dispersion: d.F32;
     }>;
     KERNEL_SIZE: number;
 };
@@ -201,11 +225,12 @@ export declare function buildVariableBlurGraph(halfKernel: number, computeWidth:
  * pixel. The CALLER fills the map in their own compute pass by binding `blurMapTexture` to a
  * write-only storage-texture entry (the `blurMapWriteNode` replacement).
  *
- * @param options.jitterTaps - opt-in interleaved-gradient-noise tap jitter (decorrelates the
- *   fixed tap comb's moiré against periodic content). Baked into the WGSL at build time.
+ * @param options.chromatic - the three-radius (per-channel) kernel variant; baked into the WGSL.
+ * @param options.jitter - initial tap-comb jitter (0–1, runtime; `setDetail` changes it per frame).
  */
 export declare function createVariableGaussianBlurCompute(root: TgpuRoot, inputTexture: BlurInputTexture | null, inputWidth: number, inputHeight: number, onCleanup: (cb: () => void) => void, halfKernel?: number, computeWidth?: number, computeHeight?: number, options?: {
-    jitterTaps?: boolean;
+    chromatic?: boolean;
+    jitter?: number;
 }): VariableBlurComputeResult;
 /**
  * Normalized Gaussian weights for `count` taps spread over ±1 of a Gaussian with std-dev `sigma`,
@@ -433,6 +458,13 @@ export interface VariableBlurComputeConfig {
     /** Map-driven radius: pass `getMapInfo(prop)`. Its source RTT is bound late, like the child. */
     source?: GpuMapInfo;
     halfKernel?: number;
+    /** Build the three-radius (per-channel) kernel variant. Enable only while the dispersion is non-zero. */
+    chromatic?: boolean;
+    /** Per-frame detail dials (see `VariableBlurComputeResult.setDetail`). */
+    detail?: () => {
+        jitter: number;
+        dispersion: number;
+    };
     outputKey?: string;
 }
 /**
@@ -492,6 +524,11 @@ export declare function composeBlurredOverSharp(params: GpuFragmentParams, compo
  */
 export declare const INTENSITY_TO_RADIUS = 0.36;
 export declare const intensityToRadius: (intensity: number) => number;
+/**
+ * How far a full `dispersion` of ±1 spreads the per-channel radii of the chromatic variable blur:
+ * red at `radius × (1 + 0.5)`, blue at `radius × (1 − 0.5)`.
+ */
+export declare const VARIABLE_BLUR_DISPERSION_SPREAD = 0.5;
 /**
  * ChannelBlur's per-channel UI intensity (0–100) → Gaussian pixel radius via the `× 0.1` factor. A
  * single fixed Gaussian runs at the MAX per-channel radius; the fragment then mixes each channel
@@ -864,6 +901,7 @@ export declare function buildBokehGraph(computeWidth: number, computeHeight: num
                 rotCos: d.F32;
                 rotSin: d.F32;
                 chromaticFringe: d.F32;
+                catEye: d.F32;
                 inputWidth: d.F32;
                 inputHeight: d.F32;
             }>;
@@ -880,6 +918,7 @@ export declare function buildBokehGraph(computeWidth: number, computeHeight: num
         rotCos: d.F32;
         rotSin: d.F32;
         chromaticFringe: d.F32;
+        catEye: d.F32;
         inputWidth: d.F32;
         inputHeight: d.F32;
     }>;
@@ -916,6 +955,7 @@ export declare function buildBokehMapGraph(computeWidth: number, computeHeight:
                 rotCos: d.F32;
                 rotSin: d.F32;
                 chromaticFringe: d.F32;
+                catEye: d.F32;
             }>;
         };
         taps: {
@@ -936,6 +976,7 @@ export declare function buildBokehMapGraph(computeWidth: number, computeHeight:
         rotCos: d.F32;
         rotSin: d.F32;
         chromaticFringe: d.F32;
+        catEye: d.F32;
     }>;
     TapArray: d.WgslArray<d.Vec4f>;
 };