shaders 4.0.2 → 4.0.3

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.3",
+  "generatedAt": "2026-10-08T23:34:23.198Z",
   "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",
@@ -3357,6 +3364,7 @@
         "Repeater",
         "RippleWipe",
         "Ripples",
+        "Satin",
         "Saturation",
         "Scratches",
         "Sharpness",
@@ -3968,6 +3976,7 @@
         "Marble",
         "MeshGradient",
         "Prism",
+        "Satin",
         "StudioBackground",
         "Waveform"
       ],
@@ -7523,7 +7532,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 +7575,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 +7612,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 +7624,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 +7800,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 +7843,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 +7884,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 +7931,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 +7974,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 327
+        "line": 532
       },
       "kind": "function",
       "signature": "gaborGrains(slots: {frequency: PropRef}): Field",
@@ -7862,7 +8012,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 347
+        "line": 552
       },
       "kind": "function",
       "signature": "waveletBands(slots: {detail: PropRef}): Field",
@@ -7901,7 +8051,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 366
+        "line": 571
       },
       "kind": "function",
       "signature": "blueSpeckle(): Field",
@@ -7933,7 +8083,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 383
+        "line": 588
       },
       "kind": "function",
       "signature": "erosionRidges(): Field",
@@ -7965,7 +8115,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 400
+        "line": 605
       },
       "kind": "function",
       "signature": "curlSpeed(opts: {rate: number}): Field",
@@ -8003,7 +8153,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 420
+        "line": 625
       },
       "kind": "function",
       "signature": "scratchStreaks(slots: {thickness: PropRef}): Field",
@@ -8043,7 +8193,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 442
+        "line": 647
       },
       "kind": "function",
       "signature": "unitized(field: Field): Field",
@@ -8091,7 +8241,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 +8284,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 +8325,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 +8368,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 531
+        "line": 736
       },
       "kind": "function",
       "signature": "linearPair(a: PropRef, b: PropRef): Palette",
@@ -8263,7 +8413,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 +8455,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 +8494,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 +8532,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 +8575,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 +8618,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 +8667,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 747
+        "line": 952
       },
       "kind": "function",
       "signature": "overRgb(paint: Paint, ...stages: RgbStage[]): Paint",
@@ -8560,7 +8710,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 768
+        "line": 973
       },
       "kind": "function",
       "signature": "backToP3(slots: {space?: PropRef}): RgbStage",
@@ -8597,7 +8747,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 785
+        "line": 990
       },
       "kind": "function",
       "signature": "tonePow(): RgbStage",
@@ -8632,7 +8782,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 +8815,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 +8842,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 +8874,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 876
+        "line": 1081
       },
       "kind": "object",
       "signature": "reliefBases: { stone, wool }",
@@ -8762,7 +8912,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 904
+        "line": 1109
       },
       "kind": "function",
       "signature": "noiseRelief(basis: ReliefBasis): (params: GpuFragmentParams) => Expr",
@@ -8800,7 +8950,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 922
+        "line": 1127
       },
       "kind": "function",
       "signature": "transformWorleyMode(value: string): number",
@@ -8838,7 +8988,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 933
+        "line": 1138
       },
       "kind": "function",
       "signature": "transformWorleyDistance(value: string): number",
@@ -10915,7 +11065,8 @@
         "Chrome",
         "LiquidMetal",
         "Nebula",
-        "Obsidian"
+        "Obsidian",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -10923,7 +11074,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 +11083,7 @@
         },
         {
           "name": "field",
-          "type": "SurfaceField",
+          "type": "Pick<SurfaceField, 'aspect'>",
           "optional": false
         },
         {
@@ -11013,7 +11164,8 @@
         "usage": "materials.tiltNormal"
       },
       "usedBy": [
-        "BrushedMetal"
+        "BrushedMetal",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -11122,7 +11274,8 @@
         "usage": "materials.grainNoise"
       },
       "usedBy": [
-        "BrushedMetal"
+        "BrushedMetal",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -11210,7 +11363,8 @@
       },
       "usedBy": [
         "BrushedMetal",
-        "CarbonFiber"
+        "CarbonFiber",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -11258,7 +11412,8 @@
         "usage": "materials.wardAlphas"
       },
       "usedBy": [
-        "BrushedMetal"
+        "BrushedMetal",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -11266,16 +11421,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 +11459,8 @@
       },
       "usedBy": [
         "BrushedMetal",
-        "CarbonFiber"
+        "CarbonFiber",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -11541,7 +11697,8 @@
       },
       "usedBy": [
         "Chrome",
-        "Nebula"
+        "Nebula",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -11584,7 +11741,8 @@
         "Chrome",
         "Frost",
         "LiquidMetal",
-        "Plastic"
+        "Plastic",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -12284,7 +12442,8 @@
         "usage": "materials.fdSlope"
       },
       "usedBy": [
-        "Crystal"
+        "Crystal",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -12317,6 +12476,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 +12561,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 +12602,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 +12646,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 +12689,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 +12727,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 +12778,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 +12820,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 +12868,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 +12911,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 +12960,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 +13009,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 +13065,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 +13111,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 +13166,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 +13209,7 @@
       "documented": true,
       "source": {
         "file": "std/paint/materials.ts",
-        "line": 1345
+        "line": 1380
       },
       "kind": "function",
       "signature": "exposureTone(rgb: Expr): Expr",
@@ -13030,7 +13246,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 +13290,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 +13307,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 +14584,7 @@
         "Marble",
         "MeshGradient",
         "Prism",
+        "Satin",
         "StudioBackground",
         "Waveform"
       ],
@@ -14495,6 +14751,7 @@
         "Nebula",
         "Obsidian",
         "Plastic",
+        "Satin",
         "Water"
       ],
       "documented": true,
@@ -14542,7 +14799,8 @@
         "BrushedMetal",
         "CarbonFiber",
         "Heatmap",
-        "Obsidian"
+        "Obsidian",
+        "Satin"
       ],
       "documented": true,
       "source": {
@@ -15580,6 +15838,7 @@
         "Plastic",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "Sparkle",
         "StudioBackground",
         "Voxels",
@@ -15647,6 +15906,7 @@
         "Plastic",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "StudioBackground",
         "Voxels",
         "Water",
@@ -15719,6 +15979,7 @@
         "Plastic",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "SmokeFill",
         "Sparkle",
         "StudioBackground",
@@ -15786,6 +16047,7 @@
         "Plastic",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "Sparkle",
         "StudioBackground",
         "TimeTrail",
@@ -15835,6 +16097,7 @@
       "usedBy": [
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "StudioBackground",
         "Voxels",
         "Waveform"
@@ -15883,6 +16146,7 @@
         "Hologram",
         "Nebula",
         "Plastic",
+        "Satin",
         "Water",
         "Waveform"
       ],
@@ -16530,6 +16794,7 @@
         "Plastic",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "SmokeFill",
         "StudioBackground",
         "Surface3D",
@@ -16603,6 +16868,7 @@
         "Polygon",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "Sparkle",
         "StudioBackground",
         "Voxels",
@@ -17543,6 +17809,7 @@
         "PixelSort",
         "Plastic",
         "ReactionDiffusion",
+        "Satin",
         "Sparkle",
         "Water"
       ],
@@ -17604,6 +17871,7 @@
         "PixelThrow",
         "Plastic",
         "ReactionDiffusion",
+        "Satin",
         "Sparkle",
         "StudioBackground",
         "Surface3D",
@@ -17676,6 +17944,7 @@
         "Plastic",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "Sparkle",
         "StudioBackground",
         "Surface3D",
@@ -17797,6 +18066,7 @@
         "Plastic",
         "Prism",
         "ReactionDiffusion",
+        "Satin",
         "Sparkle",
         "StudioBackground",
         "Surface3D",
@@ -27593,7 +27863,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 +27877,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 +27919,7 @@
       "description": "Alpha is not touched.",
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 732
+        "line": 937
       }
     },
     "noise.ReliefBasis": {
@@ -27635,7 +27933,7 @@
       "description": "Pick one from `reliefBases`.",
       "source": {
         "file": "std/paint/noise.ts",
-        "line": 859
+        "line": 1064
       }
     },
     "light.LightValue": {
@@ -29124,8 +29422,8 @@
     }
   },
   "coverage": {
-    "words": 570,
-    "documented": 570,
+    "words": 575,
+    "documented": 575,
     "undocumented": [],
     "curatedCategories": [
       "compose",