shaders 4.0.2 → 4.0.4

package/dist/core/docs-manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "engineVersion": "4.0.2",
-  "generatedAt": "2026-10-07T22:44:35.749Z",
+  "engineVersion": "4.0.4",
+  "generatedAt": "2026-10-09T13:23:52.458Z",
   "groups": [
     {
       "id": "define",
@@ -768,10 +768,15 @@
         "noise.tonePow",
         "noise.noiseRelief",
         "noise.reliefBases",
+        "noise.clothCoords",
+        "noise.drapedFolds",
+        "noise.foldSet",
         "noise.reliefBases.stone",
         "noise.reliefBases.wool"
       ],
       "types": [
+        "noise.DrapeOptions",
+        "noise.Fold",
         "noise.ReliefBasis",
         "noise.RgbStage",
         "noise.Wave",
@@ -1032,7 +1037,9 @@
         "materials.shellRefract",
         "materials.rotationSensor",
         "materials.nearestEdge",
-        "materials.continuedField"
+        "materials.continuedField",
+        "materials.fdCurvature",
+        "materials.sheenLobe"
       ],
       "types": [
         "materials.ShapedSurfaceEffect",
@@ -1933,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})",
@@ -3357,6 +3366,7 @@
         "Repeater",
         "RippleWipe",
         "Ripples",
+        "Satin",
         "Saturation",
         "Scratches",
         "Sharpness",
@@ -3464,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": {
@@ -3968,6 +3984,7 @@
         "Marble",
         "MeshGradient",
         "Prism",
+        "Satin",
         "StudioBackground",
         "Waveform"
       ],
@@ -7523,7 +7540,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 80
+        "line": 82
       },
       "kind": "function",
       "signature": "waves(axes: {x: Expr | number; y?: Expr | number; t?: Expr | number}, schedule: WaveTerm[]): Expr",
@@ -7566,7 +7583,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 125
+        "line": 127
       },
       "kind": "function",
       "signature": "wavyLine(opts: {\n    along: Expr | number\n    time: Expr | number\n    waves: {freq: number; speed: number; amount: number; phase?: Expr | number}[]\n}): Expr",
@@ -7603,7 +7620,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 152
+        "line": 154
       },
       "kind": "function",
       "signature": "organicWaves(opts: {frequency: number; detail?: number; drift?: number; seed?: number}): WaveTerm[]",
@@ -7615,6 +7632,147 @@
         }
       ]
     },
+    "noise.foldSet": {
+      "id": "noise.foldSet",
+      "name": "foldSet",
+      "qualifiedName": "foldSet",
+      "category": "noise",
+      "module": "std/paint/noise.ts",
+      "summary": "Lays out the ridges of a draped cloth: `count` folds spread evenly across `spread`, each nudged sideways, widened and raised by a seeded amount so no two are alike.",
+      "description": "`spread` is the distance the folds cover across the drape, in the units you will pass as `across` to `drapedFolds` (the canvas aspect for a full-width curtain). `width` and `height` are the typical ridge size. `jitter` (0–1, default 0.6) is how far a fold may wander from its even slot. The same `seed` always gives the same layout. `count` is a plain number, so drive it from a compile-time prop.",
+      "examples": [
+        "const folds = foldSet({count: 7, seed: u.seed, spread: aspect, width: u.foldWidth, height: u.foldDepth})"
+      ],
+      "tips": [
+        "Call it once, outside any height function: the layout is the same at every tap."
+      ],
+      "see": [
+        "noise.drapedFolds"
+      ],
+      "import": {
+        "statement": "import {noise} from 'shaders/std'",
+        "usage": "noise.foldSet"
+      },
+      "usedBy": [
+        "Satin"
+      ],
+      "documented": true,
+      "source": {
+        "file": "std/paint/noise.ts",
+        "line": 223
+      },
+      "kind": "function",
+      "signature": "foldSet(opts: {\n    count: number\n    seed: Expr | number\n    spread: Expr | number\n    width: Expr | number\n    height: Expr | number\n    jitter?: number\n}): Fold[]",
+      "params": [
+        {
+          "name": "opts",
+          "type": "{\n    count: number\n    seed: Expr | number\n    spread: Expr | number\n    width: Expr | number\n    height: Expr | number\n    jitter?: number\n}",
+          "optional": false
+        }
+      ]
+    },
+    "noise.drapedFolds": {
+      "id": "noise.drapedFolds",
+      "name": "drapedFolds",
+      "qualifiedName": "drapedFolds",
+      "category": "noise",
+      "module": "std/paint/noise.ts",
+      "summary": "The height of a draped cloth at a point: rounded ridges running along one direction, each rippling and swaying along its length, gathered where the cloth is pinned.",
+      "description": "`coords` come from a `directionFrame`: `along` runs 0 at the pinned edge to 1 at the free edge, `across` is the distance across the drape in the units `foldSet` laid the folds out in. `ripple.waves` is a `wavyLine` wave list each spine wanders by (every fold starts at its own phase) and `ripple.gain` scales it. `sway` moves all the folds together on the clock, like a breeze. `swell` makes each ridge rise and fall along its length so neighbours merge and part. `pinning` (0–1) gathers the folds at the pinned edge: narrow and still there, wide and free at the far edge. `sharpness` (default 2) is how tightly the ridge falls away and `crease` (0–1, default 0) flattens its crest into a plateau that meets the next fold in a tight valley: 0 is a round bell, 1 a flat face with a sharp crease. The result is a height in the units of each fold's `height`. Take its slope with `fdSlope` or `fdCurvature` for relief.",
+      "examples": [
+        "const cloth = (at: Expr) => drapedFolds(drape.coordsOf(at), folds, {time: t, ripple: {waves: RIPPLE}, sway: {amount: breeze}, pinning: u.pinning})\nconst relief = fdCurvature(cloth, q, 0.004)"
+      ],
+      "tips": [
+        "Keep the wave list and swell as constants next to the definition. They are the look."
+      ],
+      "see": [
+        "noise.foldSet",
+        "noise.wavyLine",
+        "materials.fdSlope"
+      ],
+      "import": {
+        "statement": "import {noise} from 'shaders/std'",
+        "usage": "noise.drapedFolds"
+      },
+      "usedBy": [
+        "Satin"
+      ],
+      "documented": true,
+      "source": {
+        "file": "std/paint/noise.ts",
+        "line": 271
+      },
+      "kind": "function",
+      "signature": "drapedFolds(coords: {along: Expr | number; across: Expr | number}, folds: Fold[], opts: DrapeOptions): Expr",
+      "params": [
+        {
+          "name": "coords",
+          "type": "{along: Expr | number; across: Expr | number}",
+          "optional": false
+        },
+        {
+          "name": "folds",
+          "type": "Fold[]",
+          "optional": false
+        },
+        {
+          "name": "opts",
+          "type": "DrapeOptions",
+          "optional": false
+        }
+      ]
+    },
+    "noise.clothCoords": {
+      "id": "noise.clothCoords",
+      "name": "clothCoords",
+      "qualifiedName": "clothCoords",
+      "category": "noise",
+      "module": "std/paint/noise.ts",
+      "summary": "Where on the unfolded cloth a point lands: the material coordinates to draw a pattern in, so it follows the folds instead of floating over them.",
+      "description": "Takes the same `coords`, `folds` and options as `drapedFolds`. The cloth riding each ridge moves sideways with its spine, and each flank uses up cloth, so a pattern drawn in these coordinates bends with the ripples and bunches on the steep sides of every ridge. `foreshorten` (default 0.25) is how much cloth a flank consumes. Rebuild a point from the result with the drape's frame and hand it to a grain word in place of the screen point.",
+      "examples": [
+        "const m = clothCoords(drape.coordsOf(q), folds, {...drapeOpts, foreshorten: 0.25})\nconst onCloth = add(mul(drape.tangent, m.along), mul(drape.perp, m.across))\nconst threads = grainNoise(fibre.coordsOf(onCloth), {freq: [12, 420]})"
+      ],
+      "tips": [
+        "One more pass over the folds per pixel. Call it once and reuse the point."
+      ],
+      "see": [
+        "noise.drapedFolds",
+        "noise.foldSet",
+        "materials.grainNoise"
+      ],
+      "import": {
+        "statement": "import {noise} from 'shaders/std'",
+        "usage": "noise.clothCoords"
+      },
+      "usedBy": [
+        "Satin"
+      ],
+      "documented": true,
+      "source": {
+        "file": "std/paint/noise.ts",
+        "line": 299
+      },
+      "kind": "function",
+      "signature": "clothCoords(coords: {along: Expr | number; across: Expr | number}, folds: Fold[], opts: DrapeOptions & {foreshorten?: number}): {along: Expr; across: Expr}",
+      "params": [
+        {
+          "name": "coords",
+          "type": "{along: Expr | number; across: Expr | number}",
+          "optional": false
+        },
+        {
+          "name": "folds",
+          "type": "Fold[]",
+          "optional": false
+        },
+        {
+          "name": "opts",
+          "type": "DrapeOptions & {foreshorten?: number}",
+          "optional": false
+        }
+      ]
+    },
     "noise.seededPlane": {
       "id": "noise.seededPlane",
       "name": "seededPlane",
@@ -7650,7 +7808,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 209
+        "line": 414
       },
       "kind": "function",
       "signature": "seededPlane(field: Field, slots: {scale: PropRef; seed: PropRef}): Field",
@@ -7693,7 +7851,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 248
+        "line": 453
       },
       "kind": "function",
       "signature": "pixelGrid(field: Field, slots: {grain: PropRef; seed: PropRef}): Field",
@@ -7734,7 +7892,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 272
+        "line": 477
       },
       "kind": "function",
       "signature": "scaledPlane(field: Field, slots: {scale: PropRef}): Field",
@@ -7781,7 +7939,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 300
+        "line": 505
       },
       "kind": "function",
       "signature": "evolving(field: Field, opts: {rate: number}): Field",
@@ -7824,7 +7982,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 327
+        "line": 532
       },
       "kind": "function",
       "signature": "gaborGrains(slots: {frequency: PropRef}): Field",
@@ -7862,7 +8020,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 347
+        "line": 552
       },
       "kind": "function",
       "signature": "waveletBands(slots: {detail: PropRef}): Field",
@@ -7901,7 +8059,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 366
+        "line": 571
       },
       "kind": "function",
       "signature": "blueSpeckle(): Field",
@@ -7933,7 +8091,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 383
+        "line": 588
       },
       "kind": "function",
       "signature": "erosionRidges(): Field",
@@ -7965,7 +8123,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 400
+        "line": 605
       },
       "kind": "function",
       "signature": "curlSpeed(opts: {rate: number}): Field",
@@ -8003,7 +8161,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 420
+        "line": 625
       },
       "kind": "function",
       "signature": "scratchStreaks(slots: {thickness: PropRef}): Field",
@@ -8043,7 +8201,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 442
+        "line": 647
       },
       "kind": "function",
       "signature": "unitized(field: Field): Field",
@@ -8091,7 +8249,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 464
+        "line": 669
       },
       "kind": "function",
       "signature": "noiseTone(field: Field, slots?: {contrast?: PropRef; balance?: PropRef}): Field",
@@ -8134,7 +8292,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 489
+        "line": 694
       },
       "kind": "function",
       "signature": "signedTone(field: Field, slots: {contrast: PropRef; balance: PropRef}): Field",
@@ -8175,7 +8333,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 510
+        "line": 715
       },
       "kind": "function",
       "signature": "gainTone(field: Field, slots: {contrast: PropRef; balance: PropRef}): Field",
@@ -8218,7 +8376,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 531
+        "line": 736
       },
       "kind": "function",
       "signature": "linearPair(a: PropRef, b: PropRef): Palette",
@@ -8263,7 +8421,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 555
+        "line": 760
       },
       "kind": "function",
       "signature": "fractalNoise(slots: {\n    angle: PropRef\n    detail: PropRef\n    contrast: PropRef\n    octaves: PropRef\n    seed: PropRef\n    space: PropRef\n}): Paint",
@@ -8305,7 +8463,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 600
+        "line": 805
       },
       "kind": "function",
       "signature": "worleyNoise(slots: {\n    scale: PropRef\n    jitter: PropRef\n    lacunarity: PropRef\n    persistence: PropRef\n    contrast: PropRef\n    balance: PropRef\n    seed: PropRef\n    /** Compile-time prop: `'f1' | 'f2' | 'f2MinusF1' | 'f1PlusF2' | 'f1TimesF2'`. */\n    mode: PropRef\n    /** Compile-time prop: `'euclidean' | 'manhattan' | 'chebyshev'`. */\n    distance: PropRef\n    /** Compile-time prop: 1 to 4. */\n    octaves: PropRef\n    space: PropRef\n}): Paint",
@@ -8344,7 +8502,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 657
+        "line": 862
       },
       "kind": "function",
       "signature": "cellDistances(slots: {scale: PropRef; seed: PropRef}): Field",
@@ -8382,7 +8540,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 680
+        "line": 885
       },
       "kind": "function",
       "signature": "cellFill(cells: Field, slots: {edgeIntensity: PropRef}): Field",
@@ -8425,7 +8583,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 700
+        "line": 905
       },
       "kind": "function",
       "signature": "cellBorders(cells: Field, slots: {softness: PropRef; scale: PropRef}): Field",
@@ -8468,7 +8626,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 719
+        "line": 924
       },
       "kind": "function",
       "signature": "borderOverlay(paint: Paint, mask: Field, slots: {color: PropRef}): Paint",
@@ -8517,7 +8675,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 747
+        "line": 952
       },
       "kind": "function",
       "signature": "overRgb(paint: Paint, ...stages: RgbStage[]): Paint",
@@ -8560,7 +8718,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 768
+        "line": 973
       },
       "kind": "function",
       "signature": "backToP3(slots: {space?: PropRef}): RgbStage",
@@ -8597,7 +8755,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 785
+        "line": 990
       },
       "kind": "function",
       "signature": "tonePow(): RgbStage",
@@ -8632,7 +8790,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 813
+        "line": 1018
       },
       "kind": "function",
       "signature": "ribbons(slots: {\n    from: PropRef\n    to: PropRef\n    count: PropRef\n    width: PropRef\n    amplitude: PropRef\n    frequency: PropRef\n    softness: PropRef\n    spread: PropRef\n    pinEdges: PropRef\n    colorScale: PropRef\n    colorVariance: PropRef\n}): Paint",
@@ -8665,7 +8823,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 878
+        "line": 1083
       },
       "kind": "constant",
       "signature": "reliefBases.stone: { readonly fn: TgpuFn<(p: Vec2f) => F32>; readonly hint: \"stone12\"; }",
@@ -8692,7 +8850,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 880
+        "line": 1085
       },
       "kind": "constant",
       "signature": "reliefBases.wool: { readonly fn: TgpuFn<(p: Vec2f) => F32>; readonly hint: \"wool12\"; }",
@@ -8724,7 +8882,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 876
+        "line": 1081
       },
       "kind": "object",
       "signature": "reliefBases: { stone, wool }",
@@ -8762,7 +8920,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 904
+        "line": 1109
       },
       "kind": "function",
       "signature": "noiseRelief(basis: ReliefBasis): (params: GpuFragmentParams) => Expr",
@@ -8800,7 +8958,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 922
+        "line": 1127
       },
       "kind": "function",
       "signature": "transformWorleyMode(value: string): number",
@@ -8838,7 +8996,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 933
+        "line": 1138
       },
       "kind": "function",
       "signature": "transformWorleyDistance(value: string): number",
@@ -10915,7 +11073,8 @@
         "Chrome",
         "LiquidMetal",
         "Nebula",
-        "Obsidian"
+        "Obsidian",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -10923,7 +11082,7 @@
         "line": 435
       },
       "kind": "function",
-      "signature": "viewRay(params: GpuFragmentParams, field: SurfaceField, fov: number = 0.6): Expr",
+      "signature": "viewRay(params: GpuFragmentParams, field: Pick<SurfaceField, 'aspect'>, fov: number = 0.6): Expr",
       "params": [
         {
           "name": "params",
@@ -10932,7 +11091,7 @@
         },
         {
           "name": "field",
-          "type": "SurfaceField",
+          "type": "Pick<SurfaceField, 'aspect'>",
           "optional": false
         },
         {
@@ -11013,7 +11172,8 @@
         "usage": "materials.tiltNormal"
       },
       "usedBy": [
-        "BrushedMetal"
+        "BrushedMetal",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -11122,7 +11282,8 @@
         "usage": "materials.grainNoise"
       },
       "usedBy": [
-        "BrushedMetal"
+        "BrushedMetal",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -11210,7 +11371,8 @@
       },
       "usedBy": [
         "BrushedMetal",
-        "CarbonFiber"
+        "CarbonFiber",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -11258,7 +11420,8 @@
         "usage": "materials.wardAlphas"
       },
       "usedBy": [
-        "BrushedMetal"
+        "BrushedMetal",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -11266,16 +11429,16 @@
         "line": 604
       },
       "kind": "function",
-      "signature": "wardAlphas(roughness: Expr, anisotropy: Expr): {along: Expr; across: Expr}",
+      "signature": "wardAlphas(roughness: Expr | number, anisotropy: Expr | number): {along: Expr; across: Expr}",
       "params": [
         {
           "name": "roughness",
-          "type": "Expr",
+          "type": "Expr | number",
           "optional": false
         },
         {
           "name": "anisotropy",
-          "type": "Expr",
+          "type": "Expr | number",
           "optional": false
         }
       ]
@@ -11304,7 +11467,8 @@
       },
       "usedBy": [
         "BrushedMetal",
-        "CarbonFiber"
+        "CarbonFiber",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -11541,7 +11705,8 @@
       },
       "usedBy": [
         "Chrome",
-        "Nebula"
+        "Nebula",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -11584,7 +11749,8 @@
         "Chrome",
         "Frost",
         "LiquidMetal",
-        "Plastic"
+        "Plastic",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -12284,7 +12450,8 @@
         "usage": "materials.fdSlope"
       },
       "usedBy": [
-        "Crystal"
+        "Crystal",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -12317,6 +12484,62 @@
         }
       ]
     },
+    "materials.fdCurvature": {
+      "id": "materials.fdCurvature",
+      "name": "fdCurvature",
+      "qualifiedName": "fdCurvature",
+      "category": "materials",
+      "module": "std/paint/materials.ts",
+      "summary": "The value, slope and curvature of any field at a point: `value`, `dx`, `dy` and `curvature`.",
+      "description": "`fdSlope` with two more taps. The slopes are centred, so they sit on the point rather than half a step past it, and `curvature` is the field's Laplacian: negative on a crest, positive in a crease, zero on a flat or a plane. Scale it by a gain for a cavity shade that darkens creases and lifts crests. `eps` is the tap distance in the point's units.",
+      "examples": [
+        "const relief = fdCurvature(cloth, q, 0.004)\nconst cavity = clamp(sub(1, mul(relief.curvature, 0.005)), 0.6, 1.1)"
+      ],
+      "tips": [
+        "Five taps of the field per pixel. Keep the field cheap."
+      ],
+      "see": [
+        "materials.fdSlope",
+        "materials.nudgeNormal"
+      ],
+      "import": {
+        "statement": "import {materials} from 'shaders/std'",
+        "usage": "materials.fdCurvature"
+      },
+      "usedBy": [
+        "Satin"
+      ],
+      "documented": true,
+      "source": {
+        "file": "std/paint/materials.ts",
+        "line": 1027
+      },
+      "kind": "function",
+      "signature": "fdCurvature(sampleAt: (p: Expr) => Expr, p: Expr, eps: number, hint: string = 'fd'): {value: Expr; dx: Expr; dy: Expr; curvature: Expr}",
+      "params": [
+        {
+          "name": "sampleAt",
+          "type": "(p: Expr) => Expr",
+          "optional": false
+        },
+        {
+          "name": "p",
+          "type": "Expr",
+          "optional": false
+        },
+        {
+          "name": "eps",
+          "type": "number",
+          "optional": false
+        },
+        {
+          "name": "hint",
+          "type": "string",
+          "optional": true,
+          "defaultValue": "'fd'"
+        }
+      ]
+    },
     "materials.hashNoise": {
       "id": "materials.hashNoise",
       "name": "hashNoise",
@@ -12346,7 +12569,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1022
+        "line": 1057
       },
       "kind": "function",
       "signature": "hashNoise(x: Expr | number, y: Expr | number): Expr",
@@ -12387,7 +12610,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1039
+        "line": 1074
       },
       "kind": "function",
       "signature": "interleavedNoise(pixel: Expr, clock: Expr | number = 0): Expr",
@@ -12431,7 +12654,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1055
+        "line": 1090
       },
       "kind": "function",
       "signature": "valueNoise(x: Expr | number, y: Expr | number): Expr",
@@ -12474,7 +12697,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1071
+        "line": 1106
       },
       "kind": "function",
       "signature": "rotationSensor(frame: SurfaceFrame): {x: Expr; y: Expr}",
@@ -12512,7 +12735,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1094
+        "line": 1129
       },
       "kind": "function",
       "signature": "shellRefract(frame: SurfaceFrame, n: Expr, amount: Expr): {\n    x: Expr\n    y: Expr\n    centered: {x: Expr; y: Expr}\n}",
@@ -12563,7 +12786,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1122
+        "line": 1157
       },
       "kind": "function",
       "signature": "schlickFresnel(grazing: Expr, opts: {r0?: number; gain: Expr | number; power?: number}): Expr",
@@ -12605,7 +12828,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1139
+        "line": 1174
       },
       "kind": "function",
       "signature": "twinkle(t: Expr, phase: Expr, opts: {amount: Expr; rate: number; spread: number}): Expr",
@@ -12653,7 +12876,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1157
+        "line": 1192
       },
       "kind": "function",
       "signature": "pointStars(p: Expr, opts: {\n    /** Frequency of the per-point variation field relative to `p` (slow, about 0.1). */\n    variationFreq: number\n    /** Point radius as `[base, jitter]`: base plus variation times jitter. */\n    radius: [number, number]\n    /** The band of the variation field that keeps a point at all. Narrower is sparser. */\n    keep: [number, number]\n    /** Brightness as `[base, gain]`: base plus variation squared times gain. */\n    brightness: [number, number]\n    /** A per-point shimmer factor built from the variation field (see `twinkle`). */\n    shimmer?: (variation: Expr) => Expr\n    /** Overall gain. */\n    gain: Expr\n    /** Color the glints: variation mixes `from` to `to`, scaled by the glint times `gain`. */\n    tint?: {from: [number, number, number]; to: [number, number, number]; gain: number}\n    hint?: string\n}): {glint: Expr; variation: Expr; rgb?: Expr}",
@@ -12696,7 +12919,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1212
+        "line": 1247
       },
       "kind": "function",
       "signature": "placementPoint(params: GpuFragmentParams, position: Expr, hint: string = 'placed'): Expr",
@@ -12745,7 +12968,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1233
+        "line": 1268
       },
       "kind": "function",
       "signature": "continuedField(frame: SurfaceFrame, field: SurfaceField, params: GpuFragmentParams): {sdf: Expr; outward: Expr; at: (uv: Expr) => Expr}",
@@ -12794,7 +13017,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1270
+        "line": 1305
       },
       "kind": "function",
       "signature": "nearestEdge(sdfUV: Expr, sdf: Expr, slope: Expr, hint: string = 'edge'): {point: Expr; normal: Expr}",
@@ -12850,7 +13073,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1288
+        "line": 1323
       },
       "kind": "function",
       "signature": "pointLightFrom(light: {position: Expr; height: Expr | number}, at: Expr, hint: string = 'pl'): {L: Expr; toLight: Expr; distance: Expr}",
@@ -12896,12 +13119,13 @@
       },
       "usedBy": [
         "Irradiance",
+        "Satin",
         "Voxels"
       ],
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1313
+        "line": 1348
       },
       "kind": "function",
       "signature": "lambert(normal: Expr, light: Expr, opts: {wrap?: Expr | number} = {}): Expr",
@@ -12950,7 +13174,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1328
+        "line": 1363
       },
       "kind": "function",
       "signature": "inverseSquare(distance: Expr, range: Expr | number): Expr",
@@ -12993,7 +13217,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1345
+        "line": 1380
       },
       "kind": "function",
       "signature": "exposureTone(rgb: Expr): Expr",
@@ -13030,7 +13254,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1362
+        "line": 1397
       },
       "kind": "function",
       "signature": "sensorGrain(rgb: Expr, opts: {amount: Expr | number; pixel: Expr; clock: Expr | number}): Expr",
@@ -13074,7 +13298,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1380
+        "line": 1415
       },
       "kind": "function",
       "signature": "dualLobeGlint(ndh: Expr, opts: {\n    /** `[exponent, gain]` of the hot core lobe. */\n    core: [number, number]\n    /** `[exponent, gain]` of the wide halo lobe. */\n    halo: [number, number]\n    softness?: Expr\n    gain: Expr\n}): Expr",
@@ -13091,6 +13315,45 @@
         }
       ]
     },
+    "materials.sheenLobe": {
+      "id": "materials.sheenLobe",
+      "name": "sheenLobe",
+      "qualifiedName": "sheenLobe",
+      "category": "materials",
+      "module": "std/paint/materials.ts",
+      "summary": "The soft glow of light scattered off fibres where a surface turns edge-on to the viewer: the velvet sheen on the flanks of satin, velour and wool.",
+      "description": "`normal` and `light` are unit 3D vectors and `view` the view ray (`viewRay`, or a constant `vec3(0, 0, 1)`). It is zero on a face-on surface and rises along each fold's flank, so it never washes a flat sheet. `roughness` (0–1) widens it: low is a thin bright rim, high a broad soft bloom. The lobe peaks at 1 and is held back by a wrapped lambert so unlit flanks stay dark; pass `gain` or scale the result yourself. Pair it with `anisoSpecular` for a satin finish: the streak is the shine, the sheen is the body.",
+      "examples": [
+        "const velvet = sheenLobe({normal: n, light: L, view, roughness: 0.5, gain: u.sheen})"
+      ],
+      "tips": [],
+      "see": [
+        "materials.anisoSpecular",
+        "materials.lambert",
+        "materials.grazingOf"
+      ],
+      "import": {
+        "statement": "import {materials} from 'shaders/std'",
+        "usage": "materials.sheenLobe"
+      },
+      "usedBy": [
+        "Satin"
+      ],
+      "documented": true,
+      "source": {
+        "file": "std/paint/materials.ts",
+        "line": 1449
+      },
+      "kind": "function",
+      "signature": "sheenLobe(opts: {\n    normal: Expr\n    light: Expr\n    view: Expr\n    roughness: Expr | number\n    gain?: Expr | number\n}): Expr",
+      "params": [
+        {
+          "name": "opts",
+          "type": "{\n    normal: Expr\n    light: Expr\n    view: Expr\n    roughness: Expr | number\n    gain?: Expr | number\n}",
+          "optional": false
+        }
+      ]
+    },
     "volume.interiorRay": {
       "id": "volume.interiorRay",
       "name": "interiorRay",
@@ -14329,6 +14592,7 @@
         "Marble",
         "MeshGradient",
         "Prism",
+        "Satin",
         "StudioBackground",
         "Waveform"
       ],
@@ -14495,6 +14759,7 @@
         "Nebula",
         "Obsidian",
         "Plastic",
+        "Satin",
         "Water"
       ],
       "documented": true,
@@ -14542,7 +14807,8 @@
         "BrushedMetal",
         "CarbonFiber",
         "Heatmap",
-        "Obsidian"
+        "Obsidian",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -15580,6 +15846,7 @@
         "Plastic",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "Sparkle",
         "StudioBackground",
         "Voxels",
@@ -15647,6 +15914,7 @@
         "Plastic",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "StudioBackground",
         "Voxels",
         "Water",
@@ -15719,6 +15987,7 @@
         "Plastic",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "SmokeFill",
         "Sparkle",
         "StudioBackground",
@@ -15786,6 +16055,7 @@
         "Plastic",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "Sparkle",
         "StudioBackground",
         "TimeTrail",
@@ -15835,6 +16105,7 @@
       "usedBy": [
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "StudioBackground",
         "Voxels",
         "Waveform"
@@ -15883,6 +16154,7 @@
         "Hologram",
         "Nebula",
         "Plastic",
+        "Satin",
         "Water",
         "Waveform"
       ],
@@ -16530,6 +16802,7 @@
         "Plastic",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "SmokeFill",
         "StudioBackground",
         "Surface3D",
@@ -16603,6 +16876,7 @@
         "Polygon",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "Sparkle",
         "StudioBackground",
         "Voxels",
@@ -17543,6 +17817,7 @@
         "PixelSort",
         "Plastic",
         "ReactionDiffusion",
+        "Satin",
         "Sparkle",
         "Water"
       ],
@@ -17604,6 +17879,7 @@
         "PixelThrow",
         "Plastic",
         "ReactionDiffusion",
+        "Satin",
         "Sparkle",
         "StudioBackground",
         "Surface3D",
@@ -17676,6 +17952,7 @@
         "Plastic",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "Sparkle",
         "StudioBackground",
         "Surface3D",
@@ -17797,6 +18074,7 @@
         "Plastic",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "Sparkle",
         "StudioBackground",
         "Surface3D",
@@ -19887,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",
@@ -19911,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
         }
       ]
@@ -19930,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')})"
       ],
@@ -19949,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
         }
       ]
@@ -19989,7 +20269,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 457
+        "line": 521
       },
       "kind": "function",
       "signature": "sharpen(amount: ArgSpec): GatherEffect",
@@ -20027,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",
@@ -20066,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",
@@ -20105,7 +20385,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 539
+        "line": 603
       },
       "kind": "function",
       "signature": "crispTap(frame: GatherFrame): SampleStage",
@@ -20144,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",
@@ -20189,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",
@@ -20228,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",
@@ -20272,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",
@@ -20315,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",
@@ -20363,7 +20643,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 721
+        "line": 785
       },
       "kind": "function",
       "signature": "gaussianBlur(opts: {intensity: PropRef}): ComputeBackedEffect",
@@ -20401,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",
@@ -20420,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')})"
       ],
@@ -20439,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
         }
       ]
@@ -20458,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')})"
       ],
@@ -20478,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
         }
       ]
@@ -20517,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",
@@ -20555,7 +20835,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1005
+        "line": 1107
       },
       "kind": "function",
       "signature": "childTap(): SampleStage",
@@ -20587,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",
@@ -20625,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",
@@ -20664,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",
@@ -20703,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",
@@ -20742,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",
@@ -20786,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",
@@ -20834,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",
@@ -20873,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",
@@ -20917,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",
@@ -20961,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",
@@ -21005,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",
@@ -21051,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",
@@ -21094,7 +21374,7 @@
       "documented": true,
       "source": {
         "file": "std/effects/blurs.ts",
-        "line": 1443
+        "line": 1545
       },
       "kind": "function",
       "signature": "mirrorAcrossRow(line: PropRef): (params: GpuFragmentParams) => Expr",
@@ -21133,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}",
@@ -21171,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",
@@ -21226,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}",
@@ -21265,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",
@@ -21284,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')})"
       ],
@@ -21304,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
         }
       ]
@@ -27593,7 +27873,7 @@
       "description": "`x`, `y` and `t` are the wave's frequency along that axis: larger is tighter, and `t` is its drift speed along the layer's clock. Leave an axis out to ignore it. A negative value runs the wave the other way. `phase` shifts the wave, in radians.",
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 39
+        "line": 41
       }
     },
     "noise.WaveTerm": {
@@ -27607,7 +27887,35 @@
       "description": "Multiplying an x-wave by a y-wave gives an interference pattern instead of stripes. `weight` scales the term, default 1.",
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 55
+        "line": 57
+      }
+    },
+    "noise.Fold": {
+      "id": "noise.Fold",
+      "name": "Fold",
+      "category": "noise",
+      "module": "std/paint/noise.ts",
+      "kind": "interface",
+      "text": "interface Fold {\n    offset: Expr\n    width: Expr\n    height: Expr\n    phase: Expr\n}",
+      "summary": "One ridge of a draped cloth as `foldSet` lays it out: where it rests across the drape, how wide and how high it is, and the phase that keeps its ripple out of step with its neighbours.",
+      "description": "",
+      "source": {
+        "file": "std/paint/noise.ts",
+        "line": 199
+      }
+    },
+    "noise.DrapeOptions": {
+      "id": "noise.DrapeOptions",
+      "name": "DrapeOptions",
+      "category": "noise",
+      "module": "std/paint/noise.ts",
+      "kind": "interface",
+      "text": "interface DrapeOptions {\n    time: Expr | number\n    /** A `wavyLine` wave list each spine wanders by (every fold starts at its own phase), and a gain on it. */\n    ripple: {waves: {freq: number; speed: number; amount: number}[]; gain?: Expr | number}\n    /** Moves all the folds together on the clock, like a breeze. */\n    sway?: {amount: Expr | number; rate?: number}\n    /** Each ridge rises and falls along its length so neighbours merge and part. */\n    swell?: {amount: number; freq: number; speed?: number}\n    /** 0–1: gathers the folds at the pinned edge. */\n    pinning?: Expr | number\n    /** How tightly a ridge falls away (default 2). */\n    sharpness?: number\n    /** 0–1 (default 0): flattens the crest into a plateau meeting the next fold in a tight valley. */\n    crease?: number\n}",
+      "summary": "The knobs that shape and animate a draped cloth, shared by `drapedFolds` and `clothCoords`.",
+      "description": "",
+      "source": {
+        "file": "std/paint/noise.ts",
+        "line": 321
       }
     },
     "noise.RgbStage": {
@@ -27621,7 +27929,7 @@
       "description": "Alpha is not touched.",
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 732
+        "line": 937
       }
     },
     "noise.ReliefBasis": {
@@ -27635,7 +27943,7 @@
       "description": "Pick one from `reliefBases`.",
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 859
+        "line": 1064
       }
     },
     "light.LightValue": {
@@ -28016,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",
@@ -28027,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": {
@@ -28041,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": {
@@ -29124,8 +29460,8 @@
     }
   },
   "coverage": {
-    "words": 570,
-    "documented": 570,
+    "words": 575,
+    "documented": 575,
     "undocumented": [],
     "curatedCategories": [
       "compose",