@mkbabb/glass-ui 5.0.0 → 7.0.0

package/dist/components/aurora/constants/presets.d.ts

@@ -1,18 +1,17 @@
 /**
- * Aurora v4.1 — library config shape.
+ * Aurora library configuration.
  *
  * Authored presets (Sky, Dawn, Meadow, Deliberative, Day9, Oil Impasto,
  * Oil Gestural, Oil Van Gogh, Crayon Sunset, Crayon Rainbow, Crayon Ocean)
  * live in the consumer — see demo/stories/substrates/aurora/presets.ts.
  *
- * Per memory rule "Presets in consumers": named themed presets belong in
- * each consumer project, not in the library. The library exports only the
- * shape + a minimum-viable DEFAULT_AURORA_CONFIG for the component's own
+ * Named themed presets belong in each consumer project. The library exports only
+ * the shape and a minimum-viable DEFAULT_AURORA_CONFIG for the component's own
  * type-check ergonomics.
  */
 import type { OklchStop } from "../../../composables/color";
 export type { OklchStop };
-import type { HueInterpolationMethod } from "@mkbabb/value.js";
+import type { HueInterpolationMethod } from "@mkbabb/value.js/color";
 export type AuroraHuePath = HueInterpolationMethod;
 export type AuroraSource = "palette" | "image";
 import type { ImageInputSource } from "../../../composables/glass/textureUpload";
@@ -55,7 +54,7 @@ export type AuroraMedium = "smooth" | "pastel" | "watercolor" | "oil" | "crayon"
 export type StrokeMode = "oil" | "knife" | "chunky";
 export type FlowPattern = "none" | "radial" | "swirl" | "diagonal" | "multi" | "tensor";
 /**
- * AW.W4.1 — how a stroke's orientation is sourced. `flow` keeps the hand-authored
+ * How a stroke's orientation is sourced. `flow` keeps the hand-authored
  * `flowField` pattern + per-cell jitter (the named legacy choice); `tensor`
  * substitutes the structure-tensor minor-eigenvector (the color field's own
  * edge-tangent flow). No default that hides one as a duplicate of the other.
@@ -63,30 +62,26 @@ export type FlowPattern = "none" | "radial" | "swirl" | "diagonal" | "multi" | "
 export type StrokeOrient = "flow" | "tensor";
 export type WarpMode = "fbm" | "cellular" | "hybrid" | "curl";
 /**
- * AW.W6/W8 — the interactivity flag SHAPE (declared at W6, default OFF; behavior
- * wired at W8). Each axis opts the aurora into a pointer/scroll response:
+ * Interactivity shape. Each axis opts Aurora into a pointer/scroll response:
  * - `light`  — the cursor drives the impasto `uLightDir` (cursor-as-light + idle orbit).
- * - `flow`   — pointer/scroll VELOCITY injects a transient swirl-burst (velocity-reactive).
  * - `scroll` — palette/breath progress couples to scroll (via `useScrollProgress`).
- * - `wake`   — the WebGPU stateful pointer wake (a ping-pong velocity texture; AW.W8.2).
+ * - `swirl`  — cursor-local warp and luminance lean on both engines.
+ * - `amplitude` — sizes the transient burst folded into cursor strength on the CPU.
  * Every axis is suppressed under `prefers-reduced-motion` + the DockBackgroundToggle
  * pause (the master tempo scalar is the single suppression seam). The wispy-sky
  * default carries no `interactivity` (every axis OFF — the default stays static).
  */
 export interface AuroraInteractivity {
     light?: boolean;
-    flow?: boolean;
     scroll?: boolean;
-    wake?: boolean;
     /**
-     * BI.W-FIELD-CORE (FC6/T-38) — the MEDIUM-GATED cursor swirl/luminance-lean (reads on the
-     * `smooth` medium via the engagement-driven `auroraCursorMapping` strength, ZERO shader
-     * edit — the T-38 dead-swirl-axis fix). The atoms door defaults it ON when interactive.
+     * Cursor-local field warp and luminance lean. The atoms
+     * door defaults it ON when interactive, including on the smooth medium.
      */
     swirl?: boolean;
     /**
-     * BI.W-FIELD-CORE (FC6) — the SIZED amplitude of the cursor's field influence (0..1) —
-     * how much the velocity burst perturbs the domain-warp path near the cursor.
+     * Sized burst amplitude (0..1). The CPU projection folds
+     * the pointer-field burst into the shared cursor strength before either engine sees it.
      */
     amplitude?: number;
 }
@@ -112,13 +107,13 @@ export interface AuroraConfig {
     noiseOctaves: 3 | 4 | 5;
     source?: AuroraSource;
     /**
-     * BG.W-AUR-IMAGE-SOURCE — the photo the `source:"image"` program dissolves. A URL
-     * string / `Blob` (decoded through the shared normalisation) OR an already-uploadable
+     * the photo the `source:"image"` program dissolves. A URL
+     * string, `Blob` (decoded through the shared normalisation) OR an already-uploadable
      * source (`ImageBitmap`/`HTMLImageElement`/…). Ignored when `source !== "image"`.
      */
     src?: AuroraImageSource;
     /**
-     * BG.W-AUR-IMAGE-SOURCE — the per-fragment blur-radius band (uv units) the drifting
+     * the per-fragment blur-radius band (uv units) the drifting
      * zone lerps between (`radius = mix(min, max, zone)`). Optional; omitted = the
      * `IMAGE_BLUR_MIN_DEFAULT`/`IMAGE_BLUR_MAX_DEFAULT` band (near-sharp → heavy-bokeh
      * dissolve). Only read on the `source:"image"` program.
@@ -126,19 +121,18 @@ export interface AuroraConfig {
     imageBlur?: AuroraImageBlur;
     medium: AuroraMedium;
     /**
-     * W5 — the hue-arc method for the OKLCh palette interpolation. Optional;
+     * Hue-arc method for OKLCh palette interpolation. Optional;
      * omitted = `"shorter"` (the OKLab-rectangular ramp — the muddy-midtone-free
      * default). `"increasing"`/`"decreasing"` request the OKLCh hue-arc for a
-     * deliberate rainbow sweep across the stops. Aliased on `/api` as `AuroraHuePath`.
+     * deliberate rainbow sweep across the stops.
      */
     huePath?: AuroraHuePath;
     flow: AuroraFlow;
     /**
-     * AW.W4.1 — how the painterly stroke direction is sourced. Optional; omitted =
-     * `"flow"` (the hand-authored `flowField` pattern — the pre-W4 path, so an
-     * unset config renders identically). `"tensor"` substitutes the structure-tensor
-     * minor eigenvector (the color field's own edge-tangent flow); the `vangogh` /
-     * `oil-pastel` mediums force it.
+     * How the painterly stroke direction is sourced. Optional; omitted =
+     * `"flow"`, the hand-authored `flowField` pattern. `"tensor"` substitutes the
+     * structure-tensor minor eigenvector, the color field's edge-tangent flow;
+     * the `vangogh` and `oil-pastel` mediums force it.
      */
     strokeOrient?: StrokeOrient;
     strokeAmount: number;
@@ -152,7 +146,7 @@ export interface AuroraConfig {
     brokenColor: number;
     canvasGrain: number;
     /**
-     * BC.W-VIZ-AURORA (T4) — the anisotropic-Kuwahara painterly-finish knobs (the
+     * Anisotropic-Kuwahara painterly-finish knobs (the
      * `medium:"kuwahara"` register; the WGSL primary's keystone). Optional; omitted =
      * the recipe defaults (radius 0.010 procedural-patch units, q 4.0 the SOFT
      * variance-weight exponent). Sectors are fixed at 8 (the soft-blend overlap floor —
@@ -162,29 +156,28 @@ export interface AuroraConfig {
     kuwaharaRadius?: number;
     kuwaharaQ?: number;
     /**
-     * BG.W-AUR-METAL-FINISH — the metal-medium knobs (the `medium:"metal"` /
-     * `"metal-gradient"` register; uMedium==8/9). Optional; omitted = the recipe
+     * Metal-medium knobs for `medium:"metal"` and `"metal-gradient"` (uMedium==8/9).
+     * Optional; omitted = the recipe
      * defaults (`METAL_POLISH_DEFAULT` catch intensity, `METAL_HEIGHT_SCALE_DEFAULT`
      * relief tilt). `metalPolish` scales the specular catch; `metalHeightScale` scales
      * the luma-relief → normal tilt (a higher value reads as sharper folds). On the WGSL
-     * primary these ride the free cursor.z/.w pad lanes; the .frag carries them as its
+     * primary these ride the free cursor.z/.w pad lanes; the.frag carries them as its
      * own uniforms. A non-metal config never reads them (no-op).
      */
     metalPolish?: number;
     metalHeightScale?: number;
     /**
-     * AW.W4.2 — the impasto relight direction (the movable directional source the
+     * Impasto relight direction (the movable directional source the
      * accumulated paint-height field catches). Optional; omitted = upper-left
-     * (matching the prior fixed-rim default, so the still default reads identically).
-     * Unit-ish [x, y, z] in screen space (z toward the viewer). AW.W8 drives this
-     * from the cursor (cursor-as-light); the shader re-normalizes it.
+     * Unit-ish [x, y, z] in screen space (z toward the viewer). The shader
+     * re-normalizes it.
      */
     lightDir?: [number, number, number];
     /**
-     * AW.W4.2 / AX.W11 — the relight tint (the impasto catch-light). Optional;
+     * Relight tint for the impasto catch-light. Optional;
      * omitted = the canonical warm-white the shared `warmCatchLight` OKLCh helper
-     * derives (the `(0.985, 0.0125, 77.5°)` anchor — perceptually the prior eyeballed
-     * warm-white, now on the OKLCh core). Author it either as a raw LINEAR-light
+     * derives (the `(0.985, 0.0125, 77.5°)` anchor — perceptually a warm-white, on
+     * the OKLCh core). Author it either as a raw LINEAR-light
      * `[r,g,b]` triple OR as an `{L,C,h}` OKLCh anchor (the bridge derives the linear
      * triple via `warmCatchLight`). The diffuse + Blinn-specular terms modulate by it.
      */
@@ -197,11 +190,11 @@ export interface AuroraConfig {
     paperGrain: number;
     alpha: number;
     /**
-     * BD.W-AUR-VIVIDNESS — the §3 chroma FLOOR (the warm-field vividness contract).
+     * the §3 chroma FLOOR (the warm-field vividness contract).
      * Optional; omitted = `DEFAULT_VIVIDNESS` (1 — high, the library's vivid identity).
      * A shader-resident OKLab chroma-floor lifts any pale zone toward `VIVID_TARGET`
      * (mode-scaled in the shader) so the field never resolves toward gray BEHIND glass
-     * — the literal fix for the "missing colorful field → gray glass" defect. The lift
+     * the literal fix for the "missing colorful field → gray glass" defect. The lift
      * is HUE-PRESERVING (scales chroma along the zone's existing OKLab direction); below
      * `VIVID_EPS` the hue is precision noise, so the floor synthesizes along the WARM
      * anchor (`VIVID_WARM_ANCHOR`) — NEVER teal/navy, the warm-floor guarantee. A
@@ -211,9 +204,8 @@ export interface AuroraConfig {
      */
     vividness?: number;
     /**
-     * AW.W6/W8 — the pointer/scroll interactivity opt-in (default OFF — the wispy-sky
-     * default stays static). W6 declares the SHAPE; W8 wires the cursor-as-light /
-     * velocity-reactive flow / scroll-coupling / WebGPU-wake behavior. Omitted = every
+     * Pointer/scroll interactivity opt-in (default OFF — the wispy-sky
+     * default stays static). Omitted = every
      * axis off. Aliased on `/api` as part of the `AuroraConfig` surface.
      */
     interactivity?: AuroraInteractivity;
@@ -229,16 +221,14 @@ export interface AuroraCursorApi {
 }
 export interface AuroraInstance extends AuroraCursorApi {
     /**
-     * Run the expensive WebGL init — context creation, shader compile + GPU
-     * link, first uniform upload, rAF arm. Idempotent. On the `"eager"` /
-     * capture `initStrategy` `createAurora` already calls this before
+     * Start GPU initialization. Idempotent. With the `"eager"` capture
+     * `initStrategy`, `createAurora` calls this before
      * returning; on `"deferred"` the consumer (e.g. `useAurora`) invokes it
-     * past first paint. Throws on WebGL2/compile/link failure (O invariant
-     * 24). A no-op once armed or once `dispose()` has run.
+     * past first paint. A no-op once armed or once `dispose()` has run.
      */
     arm(): void;
     /**
-     * BC.W-VIZ-AURORA (T2) — the device-resolved arm PROMISE. On the WebGPU
+     * Device-resolved arm promise. On the WebGPU
      * backend `renderAt`/`arm` are no-ops until this resolves the async
      * adapter→device→configure→setup prelude. A CAPTURE consumer (thumbnail bake)
      * MUST `await armAsync()` before the first `renderAt` or the frame is BLANK
@@ -250,10 +240,9 @@ export interface AuroraInstance extends AuroraCursorApi {
     renderAt(timeSec: number): void;
     pause(): void;
     resume(): void;
-    setReducedMotion(flag: boolean): void;
     dispose(): void;
 }
-export declare const MAX_NUCLEI = 6;
+export declare const MAX_NUCLEI = 8;
 export declare const MAX_STOPS = 8;
 /**
  * The default `vividness` for a bare `<Aurora>` — HIGH (the library's vivid identity).
@@ -271,7 +260,7 @@ export declare const DEFAULT_VIVIDNESS = 1;
  */
 export declare const VIVID_TARGET = 0.115;
 /**
- * The default `metalPolish` (specular catch intensity) for a `medium:"metal"` /
+ * The default `metalPolish` (specular catch intensity) for a `medium:"metal"` or
  * `"metal-gradient"` config when omitted. The metal light rakes at unit intensity.
  */
 export declare const METAL_POLISH_DEFAULT = 1;
@@ -282,7 +271,7 @@ export declare const METAL_POLISH_DEFAULT = 1;
 export declare const METAL_HEIGHT_SCALE_DEFAULT = 1;
 /**
  * The default near-sharp blur radius (uv units) at zone 0 for a `source:"image"` aurora
- * — a whisper so the recognizable zones read crisp against the dissolved ones.
+ * a whisper so the recognizable zones read crisp against the dissolved ones.
  */
 export declare const IMAGE_BLUR_MIN_DEFAULT = 0.004;
 /**
@@ -297,18 +286,18 @@ export declare const IMAGE_BLUR_MAX_DEFAULT = 0.06;
  */
 export declare const DEFAULT_AURORA_CONFIG: AuroraConfig;
 /**
- * `PAPER_WASH_GROUND` — the library-canon recessive-ground crayon calibration
- * (BA.W-ATLAS-RECONCILE A-4a; d6 9467bd16 adopt). A pure PRESET PARTIAL (no
+ * `PAPER_WASH_GROUND` — the library-canon recessive-ground crayon calibration.
+ * A pure PRESET PARTIAL (no
  * palette/nuclei/motion) pinning the recessive crayon-ground deposition dials so a
  * data-ground aurora reads as paper-on-tooth without each consumer dial-tuning the
  * same recessive calibration by hand. It carries NO palette/nuclei — the consumer
  * spreads it over its own pole-derived pigment (page-glow IS data-glow):
- * `const cfg = { ...consumerBase, ...PAPER_WASH_GROUND }`.
+ * `const cfg = {...consumerBase,...PAPER_WASH_GROUND }`.
  *
  * House-rule clean (presets-in-consumers): this is the LIBRARY's own recessive-ground
  * IDENTITY, not a consumer theme — admissible at the root. `satisfies
- * Partial<AuroraConfig>` holds (every key is a first-class `AuroraConfig` field at
- * HEAD; the `crayon` medium is `uMedium==4`).
+ * Partial<AuroraConfig>` holds (every key is a first-class `AuroraConfig` field;
+ * the `crayon` medium is `uMedium==4`).
  */
 export declare const PAPER_WASH_GROUND: {
     readonly medium: "crayon";

package/dist/components/aurora/constants/renderMode.d.ts

@@ -1,13 +1,10 @@
 export type AuroraRenderMode = "webgl" | "css" | "auto";
 /**
- * Detect a SOFTWARE / CPU WebGL renderer (SwiftShader, llvmpipe, the Microsoft
- * Basic Render Driver) via the shared `probeWebGL2Renderer` capability helper
- * (BB.W-CI-GREEN — the substrate owns the SINGLE `getContext("webgl2")`
- * bootstrap; this consumer reads the renderer STRING through it rather than
- * creating a second probe context, per `proof:webgl-substrate-single`).
+ * Detect a SOFTWARE, CPU WebGL renderer (SwiftShader, llvmpipe, the Microsoft
+ * Basic Render Driver) through the shared `probeWebGL2Renderer` capability helper,
+ * so this consumer does not create another context.
  *
- * WHY this is a `"css"` signal (the N.W5 Defect-A root cause, proven live under
- * the playwright SwiftShader harness): a full-viewport WebGL2 surface is a
+ * A full-viewport WebGL2 surface is a
  * compositor layer the rasteriser must re-raster on every composite. On a
  * software rasteriser that per-composite cost is so high that a REAL pointer
  * interaction — which forces a composite — starves the renderer's input ack and
@@ -19,68 +16,56 @@ export type AuroraRenderMode = "webgl" | "css" | "auto";
  * same palette, composites cheaply, and never stalls input. A blocklisted-GPU
  * user gets a smooth atmosphere instead of a janky/hanging one.
  *
- * A `null` probe (no WebGL2 / extension masked / throw) returns `false` — we
+ * A `null` probe (no WebGL2, extension masked, throw) returns `false` — we
  * never downgrade a renderer we cannot PROVE is software (the `"css"` path is the
  * conservative-but-lossy choice, so a false miss keeps the richer default).
  */
 export declare function isSoftwareWebGLRenderer(): boolean;
 /**
- * Resolve-mode options. The software-raster GUARD is the safe DEFAULT (see
- * {@link resolveRenderMode}); the single ESCAPE is `forceWebGLUnderSoftwareRaster`
- * (BB.W-AURORA-SWRASTER).
+ * Resolve-mode options. The software-raster guard is the safe default; the named
+ * escape is `forceWebGLUnderSoftwareRaster`.
  */
 export interface ResolveRenderModeOptions {
     /**
      * Opt OUT of the universal software-raster guard. When `true`, a forced
      * `mode:"webgl"`/`mode:"capture"` arm ARMS the live WebGL2 surface even on a
-     * detected software renderer (SwiftShader / llvmpipe / MS Basic Render) — for
+     * detected software renderer (SwiftShader, llvmpipe, MS Basic Render) — for
      * a deterministic test that ACCEPTS the per-composite raster cost. Default
      * `false`: the guard is the SAFE default (a software-raster signal forces
      * `"css"` regardless of the requested mode, so a consumer who pins
-     * `mode:"webgl"` on a headless / GPU-blocklisted device gets the static
+     * `mode:"webgl"` on a headless, GPU-blocklisted device gets the static
      * ground, never the page-wedging hang). The escape is NAMED + recorded,
      * never silent.
      */
     forceWebGLUnderSoftwareRaster?: boolean;
 }
 /**
- * Resolve `"auto"` to a concrete substrate per device tier — AND universalize the
- * software-raster guard out of the `"auto"`-only branch (BB.W-AURORA-SWRASTER).
+ * Resolve `"auto"` to a concrete substrate per device tier and apply the
+ * software-raster guard to every GPU-arming mode.
  *
- * THE GUARD (the universal first leg). A SOFTWARE WebGL renderer (SwiftShader /
- * llvmpipe / MS Basic Render — the GPU-blocklisted / headless path) forces `"css"`
+ * A software WebGL renderer (SwiftShader, llvmpipe, or MS Basic Render) forces `"css"`
  * for ANY WebGL-ARMING requested mode (`"webgl"` OR `"auto"`), not only `"auto"`.
  * A full-viewport software-rastered GL layer is so expensive to re-raster on every
  * composite that a pointer interaction starves the renderer's input ack and the
- * page goes UNRESPONSIVE (the headless-Chromium hang the speedtest harness
- * documents). A consumer (or a capture harness) that pins `mode:"webgl"` /
- * `mode:"capture"` on such a device MUST still fall to the static ground — so the
+ * page becomes unresponsive. A consumer that pins `mode:"webgl"` or
+ * `mode:"capture"` on such a device must still fall to the static ground, so the
  * probe runs BEFORE the `mode !== "auto"` short-circuit when the requested mode
  * would arm WebGL. The single ESCAPE is `options.forceWebGLUnderSoftwareRaster`
  * (default `false` — the guard is the safe default).
  *
- * BC.W-VIZ-AURORA (T1) — the DEAD-STATIC `"auto"` fall is RETIRED. The
- * `lowConcurrency` (`hardwareConcurrency <= 4`) and `saveData` heuristics are
- * GONE: they predate the offscreen-park + the `AV_AURORA_DPR_MAX` sub-2× cap +
- * the demand-gate that make a full-viewport aurora cheap, and `<= 4` is
- * false-positive-prone in 2026 (a capable base-M-series laptop / a throttled VM
- * tab reports 4 logical cores → it got a FROZEN static gradient that reads as
- * "the aurora is broken", USER-DEFECTS §E "renders SLOW"). So `"auto"` arms the
- * GPU on every Chrome-113/Safari-26/Firefox-141 device.
+ * `"auto"` arms the GPU unless the software-renderer guard fires. Core-count and
+ * save-data heuristics do not select a static substrate.
  *
  * Reduced-motion is handled SOLELY by the substrate's live `matchMedia` freeze
- * (`createCanvasLifecycle` paints ONE static frame then parks, and re-arms on
- * un-reduce) — NOT a render-mode fall (the old `"css"` fall never armed WebGL,
- * so an un-reduce mid-session could never wake it; the substrate freeze does).
- * The ONLY `"css"` signal that remains is the genuine software-raster GUARD
- * (the universal first leg above) — and even that is subsumed by
- * `BC.W-WEBGPU-EVERYWHERE`'s try-WebGPU-then-rebuild-WebGL2 picker.
+ * (`createCanvasLifecycle` paints one static frame then parks and re-arms on
+ * un-reduce), not by changing render mode. The only automatic `"css"` signal is
+ * the software-raster guard.
  *
- * THE CAPABLE PATH IS BYTE-UNTOUCHED: `isSoftwareWebGLRenderer()` returns `false`
+ * `isSoftwareWebGLRenderer()` returns `false`
  * on a real GPU (or a null probe — never a false downgrade), so a forced
  * `mode:"webgl"` on hardware passes through exactly as before.
  *
- * SSR / missing-API safe: if `navigator` / `window` / the probes are
+ * SSR, missing-API safe: if `navigator`, `window`, the probes are
  * unavailable we ASSUME a capable device and resolve `"webgl"` (the warm wash
  * still composites either way — the only question is whether it animates).
  *

package/dist/components/aurora/constants/shaders/aurora-image.wgsl.d.ts

@@ -1,3 +1,3 @@
 export declare const IMAGE_BLUR_RINGS_WGSL = 3;
 export declare const IMAGE_BLUR_SECTORS_WGSL = 8;
-export declare const AURORA_IMAGE_WGSL = "\nconst MAX_NUCLEI: i32 = 6;\nconst PI: f32 = 3.141592653589793;\nconst BLUR_RINGS: i32 = 3;\nconst BLUR_SECTORS: i32 = 8;\n\n// The image program's OWN uniform struct (packed vec4 lanes \u2014 trivial std140/WGSL\n// alignment). DISTINCT from the palette program's 576-byte struct (a separate program).\nstruct ImageUniforms {\n  // scalars0: (uTime, uWarpAmount, uWarpScale, uWarpDrift)\n  scalars0: vec4<f32>,\n  // scalars1: (uSoftmaxBeta, uNucleiDrift, uCursorStrength, uCursorRadius)\n  scalars1: vec4<f32>,\n  // scalars2: (uSaturation, uPaperGrain, uAlpha, uVividness)\n  scalars2: vec4<f32>,\n  // image: (uBlurMin, uBlurMax, uImageAspect, _)\n  image: vec4<f32>,\n  // cursor: (uCursor.x, uCursor.y, _, _)\n  cursor: vec4<f32>,\n  // ints: (uNucleiCount, uNoiseOctaves, _, _)\n  ints: vec4<i32>,\n  // nuc0[i] = (pos.x, pos.y, radius, valueBias); nuc1[i] = (driftRadius, driftPhase, elong, angle)\n  nuc0: array<vec4<f32>, 6>,\n  nuc1: array<vec4<f32>, 6>,\n};\n\n@group(0) @binding(0) var<uniform> u: ImageUniforms;\n@group(0) @binding(1) var imgTex: texture_2d<f32>;\n@group(0) @binding(2) var imgSampler: sampler;\n\nconst K_NUCLEI: f32 = 14.0;\nconst K_WARP: f32 = 5.0;\n\n// \u2500\u2500 Noise (aurora-local hash21/vnoise/fbm \u2014 the same compact foundation) \u2500\u2500\nfn hash21(p0: vec2<f32>) -> f32 {\n  var p = fract(p0 * vec2<f32>(123.34, 456.21));\n  p = p + dot(p, p + 45.32);\n  return fract(p.x * p.y);\n}\nfn vnoise(p: vec2<f32>) -> f32 {\n  let i = floor(p);\n  let f = fract(p);\n  let uu = f * f * (3.0 - 2.0 * f);\n  let a = hash21(i);\n  let b = hash21(i + vec2<f32>(1.0, 0.0));\n  let c = hash21(i + vec2<f32>(0.0, 1.0));\n  let d = hash21(i + vec2<f32>(1.0, 1.0));\n  return mix(mix(a, b, uu.x), mix(c, d, uu.x), uu.y);\n}\nconst FBM_ROT: mat2x2<f32> = mat2x2<f32>(0.8, 0.6, -0.6, 0.8);\nfn fbm(p0: vec2<f32>) -> f32 {\n  var v = 0.0;\n  var a = 0.5;\n  var p = p0;\n  let octaves = u.ints.y;\n  for (var i = 0; i < 5; i = i + 1) {\n    if (i >= octaves) { break; }\n    v = v + a * vnoise(p);\n    p = FBM_ROT * p * 2.02;\n    a = a * 0.5;\n  }\n  return v;\n}\nfn ign(p: vec2<f32>) -> f32 {\n  return fract(52.9829189 * fract(dot(p, vec2<f32>(0.06711056, 0.00583715))));\n}\n\n\nfn srgbToLinearCh(c: f32) -> f32 {\n  if (c <= 0.04045) { return c / 12.92; }\n  return pow((c + 0.055) / 1.055, 2.4);\n}\nfn srgbToLinear(c: vec3<f32>) -> vec3<f32> {\n  return vec3<f32>(srgbToLinearCh(c.r), srgbToLinearCh(c.g), srgbToLinearCh(c.b));\n}\n\nfn linearToSrgbCh(c: f32) -> f32 {\n  if (c <= 0.0031308) { return c * 12.92; }\n  return 1.055 * pow(c, 1.0 / 2.4) - 0.055;\n}\nfn linearToSrgb(c: vec3<f32>) -> vec3<f32> {\n  return vec3<f32>(linearToSrgbCh(c.r), linearToSrgbCh(c.g), linearToSrgbCh(c.b));\n}\n\n// value.js LINEAR_SRGB_TO_LMS, row-major \u2192 WGSL columns (= the transpose).\nconst LINEAR_SRGB_TO_LMS: mat3x3<f32> = mat3x3<f32>(\n  0.4122214708, 0.2119034982, 0.0883024619,\n  0.5363325363, 0.6806995451, 0.2817188376,\n  0.0514459929, 0.1073969566, 0.6299787005\n);\n\n// value.js srgbToOKLab's INLINE LMS\u2192OKLab coefficients, row-major \u2192 WGSL columns.\nconst LMS_TO_OKLAB: mat3x3<f32> = mat3x3<f32>(\n  0.2104542553, 1.9779984951, 0.0259040371,\n  0.7936177850, -2.4285922050, 0.7827717662,\n  -0.0040720468, 0.4505937099, -0.8086757660\n);\n\n// value.js OKLAB_TO_LMS_COEFF, row-major \u2192 WGSL columns.\nconst OKLAB_TO_LMS: mat3x3<f32> = mat3x3<f32>(\n  1.0, 1.0, 1.0,\n  0.3963377774, -0.1055613458, -0.0894841775,\n  0.2158037573, -0.0638541728, -1.2914855480\n);\n\n// value.js LMS_TO_LINEAR_SRGB, row-major \u2192 WGSL columns.\nconst LMS_TO_LINEAR_SRGB: mat3x3<f32> = mat3x3<f32>(\n  4.0767416621, -1.2684380046, -0.0041960863,\n  -3.3077115913, 2.6097574011, -0.7034186147,\n  0.2309699292, -0.3413193965, 1.7076147010\n);\n\nfn cbrt3(v: vec3<f32>) -> vec3<f32> {\n  return sign(v) * pow(abs(v), vec3<f32>(1.0 / 3.0));\n}\n\n// Gamma sRGB \u2192 raw OKLab (L, a, b). Mirrors value.js srgbToOKLab.\nfn srgbToOklab(c: vec3<f32>) -> vec3<f32> {\n  let lin = srgbToLinear(c);\n  let lms = LINEAR_SRGB_TO_LMS * lin;\n  return LMS_TO_OKLAB * cbrt3(lms);\n}\n\n// Raw OKLab (L, a, b) \u2192 linear sRGB. Mirrors value.js oklabToLinearSRGB.\nfn oklabToLinearSrgb(lab: vec3<f32>) -> vec3<f32> {\n  let lms_ = OKLAB_TO_LMS * lab;\n  let lms = lms_ * lms_ * lms_;\n  return LMS_TO_LINEAR_SRGB * lms;\n}\n\n// OKLab \u2192 OKLCh: H in RADIANS, folded to [0, 2pi). Mirrors value.js rawOklabToOklch.\nfn oklabToOklch(lab: vec3<f32>) -> vec3<f32> {\n  let C = length(lab.yz);\n  var H = atan2(lab.z, lab.y);\n  if (H < 0.0) { H = H + 2.0 * PI; }\n  return vec3<f32>(lab.x, C, H);\n}\n\n// OKLCh (H radians) \u2192 OKLab. Mirrors value.js rawOklchToOklab.\nfn oklchToOklab(lch: vec3<f32>) -> vec3<f32> {\n  return vec3<f32>(lch.x, lch.y * cos(lch.z), lch.y * sin(lch.z));\n}\n\nfn linOklab(lin: vec3<f32>) -> vec3<f32> {\n  let lms = LINEAR_SRGB_TO_LMS * lin;\n  return LMS_TO_OKLAB * cbrt3(lms);\n}\n\n// The Quilez double-warp (fbm) + the cursor swirl \u2014 the drift that moves the blur zone.\nfn domainWarp(p: vec2<f32>, t: f32) -> vec2<f32> {\n  let warpAmount = u.scalars0.y;\n  let warpScale = u.scalars0.z;\n  let warpDrift = u.scalars0.w;\n  let cursorStrength = u.scalars1.z;\n  let cursorRadius = u.scalars1.w;\n  let cursor = u.cursor.xy;\n  let q = vec2<f32>(fbm(p * warpScale + vec2<f32>(0.0, 0.0) + t * warpDrift * K_WARP),\n                    fbm(p * warpScale + vec2<f32>(5.2, 1.3) + t * warpDrift * K_WARP));\n  let r = vec2<f32>(fbm(p * warpScale + 4.0 * q + vec2<f32>(1.7, 9.2)),\n                    fbm(p * warpScale + 4.0 * q + vec2<f32>(8.3, 2.8)));\n  var warped = p + warpAmount * r;\n  if (cursorStrength > 0.001) {\n    let toP = p - cursor;\n    let d = length(toP);\n    let rr = max(cursorRadius, 0.01);\n    let w = exp(-(d * d) / (rr * rr * 0.45));\n    let ang = w * cursorStrength * 2.1;\n    let ca = cos(ang);\n    let sa = sin(ang);\n    let rotated = vec2<f32>(ca * toP.x - sa * toP.y, sa * toP.x + ca * toP.y) + cursor;\n    warped = mix(warped, rotated + warpAmount * r * 0.7, w * cursorStrength);\n  }\n  return warped;\n}\n\n// The drifting BLUR ZONE \u2014 the anisotropic-Gaussian nuclei softmax (the SAME field the\n// palette program reads), drift-coupled.\nfn zoneField(p: vec2<f32>, t: f32) -> f32 {\n  let nucleiCount = u.ints.x;\n  let nucleiDrift = u.scalars1.y;\n  let softmaxBeta = u.scalars1.x;\n  var accum = 0.0;\n  var accumW = 0.0;\n  for (var i = 0; i < MAX_NUCLEI; i = i + 1) {\n    if (i >= nucleiCount) { break; }\n    let n0 = u.nuc0[i];  // pos.x, pos.y, radius, valueBias\n    let n1 = u.nuc1[i];  // driftRadius, driftPhase, elong, angle\n    let posI = n0.xy + n1.x * vec2<f32>(\n      cos(t * nucleiDrift * K_NUCLEI + n1.y),\n      sin(t * nucleiDrift * K_NUCLEI + n1.y * 1.13));\n    let diff = p - posI;\n    let ca = cos(n1.w);\n    let sa = sin(n1.w);\n    let local = vec2<f32>(ca * diff.x + sa * diff.y, -sa * diff.x + ca * diff.y);\n    let along = local.x / max(n1.z, 0.01);\n    let d2 = along * along + local.y * local.y;\n    let rad = max(n0.z, 0.01);\n    let w = exp(-softmaxBeta * d2 / (rad * rad));\n    accum = accum + w * (0.5 + 0.5 * n0.w);\n    accumW = accumW + w;\n  }\n  return clamp(accum / max(accumW, 1e-4), 0.0, 1.0);\n}\n\nfn coverUv(uv: vec2<f32>) -> vec2<f32> {\n  let aspect = max(u.image.z, 0.0001);\n  var c = uv - vec2<f32>(0.5);\n  c.x = c.x * aspect;\n  let s = 1.0 / max(aspect, 1.0);\n  return c * s + vec2<f32>(0.5);\n}\n\n// The bounded 24-tap zone blur \u2014 a FIXED 3-ring \u00D7 8-sector stratified kernel, radius\n// per-fragment, sampled in LINEAR light. textureSampleLevel (explicit LOD 0) \u2014 WGSL has\n// no implicit derivative in a varying-radius loop.\nfn zoneBlur(uv: vec2<f32>, radius: f32) -> vec3<f32> {\n  let aspect = max(u.image.z, 0.0001);\n  var sum = srgbToLinear(textureSampleLevel(imgTex, imgSampler, coverUv(uv), 0.0).rgb);\n  var wsum = 1.0;\n  for (var ring = 1; ring <= BLUR_RINGS; ring = ring + 1) {\n    let rr = radius * (f32(ring) / f32(BLUR_RINGS));\n    for (var s = 0; s < BLUR_SECTORS; s = s + 1) {\n      let a = (f32(s) + 0.5 * f32(ring)) / f32(BLUR_SECTORS) * 2.0 * PI;\n      let off = vec2<f32>(cos(a) / aspect, sin(a)) * rr;\n      sum = sum + srgbToLinear(textureSampleLevel(imgTex, imgSampler, coverUv(uv + off), 0.0).rgb);\n      wsum = wsum + 1.0;\n    }\n  }\n  return sum / wsum;\n}\n\nconst VIVID_TARGET: f32 = 0.115;\nconst VIVID_EPS: f32 = 0.012;\nconst VIVID_WARM_ANCHOR: vec2<f32> = vec2<f32>(0.34202, 0.93969);\nfn vividnessFloor(c: vec3<f32>, vividness: f32) -> vec3<f32> {\n  if (vividness <= 0.0001) { return c; }\n  var lab = linOklab(c);\n  let C = length(lab.yz);\n  let modeLift = mix(1.18, 1.0, clamp(lab.x * 1.4, 0.0, 1.0));\n  let Cmin = vividness * VIVID_TARGET * modeLift;\n  var hueDir = VIVID_WARM_ANCHOR;\n  if (C > VIVID_EPS) { hueDir = lab.yz / C; }\n  let yz = hueDir * max(C, Cmin);\n  lab = vec3<f32>(lab.x, yz.x, yz.y);\n  return max(oklabToLinearSrgb(lab), vec3<f32>(0.0));\n}\n\nfn saturate3(c: vec3<f32>, amt: f32) -> vec3<f32> {\n  var lch = oklabToOklch(linOklab(c));\n  lch.y = max(lch.y * amt, 0.0);\n  return max(oklabToLinearSrgb(oklchToOklab(lch)), vec3<f32>(0.0));\n}\n\nfn aces(color0: vec3<f32>) -> vec3<f32> {\n  let startCompression = 0.8 - 0.04;\n  let desaturation = 0.15;\n  var color = color0;\n  let x = min(color.r, min(color.g, color.b));\n  var offset = 0.04;\n  if (x < 0.08) { offset = x - 6.25 * x * x; }\n  color = color - offset;\n  let peak = max(color.r, max(color.g, color.b));\n  if (peak < startCompression) { return clamp(color, vec3<f32>(0.0), vec3<f32>(1.0)); }\n  let d = 1.0 - startCompression;\n  let newPeak = 1.0 - d * d / (peak + d - startCompression);\n  color = color * (newPeak / peak);\n  let g = 1.0 - 1.0 / (desaturation * (peak - newPeak) + 1.0);\n  return clamp(mix(color, newPeak * vec3<f32>(1.0), g), vec3<f32>(0.0), vec3<f32>(1.0));\n}\n\nstruct VSOut {\n  @builtin(position) pos: vec4<f32>,\n  @location(0) uv: vec2<f32>,\n};\n\n@vertex\nfn vs_main(@builtin(vertex_index) vi: u32) -> VSOut {\n  var p = vec2<f32>(-1.0, -1.0);\n  if (vi == 1u) { p = vec2<f32>(3.0, -1.0); }\n  else if (vi == 2u) { p = vec2<f32>(-1.0, 3.0); }\n  var out: VSOut;\n  out.pos = vec4<f32>(p, 0.0, 1.0);\n  out.uv = p * 0.5 + 0.5;\n  return out;\n}\n\n@fragment\nfn fs_main(in: VSOut) -> @location(0) vec4<f32> {\n  let t = u.scalars0.x;\n  let saturation = u.scalars2.x;\n  let paperGrain = u.scalars2.y;\n  let alpha = u.scalars2.z;\n  let vividness = u.scalars2.w;\n  let blurMin = u.image.x;\n  let blurMax = u.image.y;\n\n  let uv = in.uv;\n  let p_warp = domainWarp(uv, t);\n  let zone = zoneField(p_warp, t);\n\n  let radius = mix(blurMin, blurMax, zone);\n  var col = zoneBlur(uv, radius);\n\n  col = saturate3(col, saturation);\n  col = vividnessFloor(col, vividness);\n\n  col = aces(col);\n  let fragCoord = in.pos.xy;\n  let grain = hash21(fragCoord + t * 17.0);\n  col = col + (grain - 0.5) * paperGrain;\n  col = clamp(col * 0.985 + 0.008, vec3<f32>(0.0), vec3<f32>(1.0));\n\n  col = linearToSrgb(col);\n  col = col + (1.0 / 255.0) * (ign(fragCoord) - 0.5);\n\n  return vec4<f32>(col * alpha, alpha);\n}\n";
+export declare const AURORA_IMAGE_WGSL = "\nconst MAX_NUCLEI: i32 = 8;\nconst PI: f32 = 3.141592653589793;\nconst BLUR_RINGS: i32 = 3;\nconst BLUR_SECTORS: i32 = 8;\n\n// The image program's OWN uniform struct (packed vec4 lanes \u2014 trivial std140/WGSL\n// alignment). DISTINCT from the palette program's 672-byte struct (a separate program).\nstruct ImageUniforms {\n  // scalars0: (uTime, uWarpAmount, uWarpScale, uWarpDrift)\n  scalars0: vec4<f32>,\n  // scalars1: (uSoftmaxBeta, uNucleiDrift, uCursorStrength, uCursorRadius)\n  scalars1: vec4<f32>,\n  // scalars2: (uSaturation, uPaperGrain, uAlpha, uVividness)\n  scalars2: vec4<f32>,\n  // image: (uBlurMin, uBlurMax, uImageAspect, _)\n  image: vec4<f32>,\n  // cursor: (uCursor.x, uCursor.y, _, _)\n  cursor: vec4<f32>,\n  // ints: (uNucleiCount, uNoiseOctaves, _, _)\n  ints: vec4<i32>,\n  // nuc0[i] = (pos.x, pos.y, radius, valueBias); nuc1[i] = (driftRadius, driftPhase, elong, angle)\n  nuc0: array<vec4<f32>, 8>,\n  nuc1: array<vec4<f32>, 8>,\n};\n\n@group(0) @binding(0) var<uniform> u: ImageUniforms;\n@group(0) @binding(1) var imgTex: texture_2d<f32>;\n@group(0) @binding(2) var imgSampler: sampler;\n\nconst K_NUCLEI: f32 = 14.0;\nconst K_WARP: f32 = 5.0;\n\n// \u2500\u2500 Noise (aurora-local hash21/vnoise/fbm \u2014 the same compact foundation) \u2500\u2500\nfn hash21(p0: vec2<f32>) -> f32 {\n  var p = fract(p0 * vec2<f32>(123.34, 456.21));\n  p = p + dot(p, p + 45.32);\n  return fract(p.x * p.y);\n}\nfn vnoise(p: vec2<f32>) -> f32 {\n  let i = floor(p);\n  let f = fract(p);\n  let uu = f * f * (3.0 - 2.0 * f);\n  let a = hash21(i);\n  let b = hash21(i + vec2<f32>(1.0, 0.0));\n  let c = hash21(i + vec2<f32>(0.0, 1.0));\n  let d = hash21(i + vec2<f32>(1.0, 1.0));\n  return mix(mix(a, b, uu.x), mix(c, d, uu.x), uu.y);\n}\nconst FBM_ROT: mat2x2<f32> = mat2x2<f32>(0.8, 0.6, -0.6, 0.8);\nfn fbm(p0: vec2<f32>) -> f32 {\n  var v = 0.0;\n  var a = 0.5;\n  var p = p0;\n  let octaves = u.ints.y;\n  for (var i = 0; i < 5; i = i + 1) {\n    if (i >= octaves) { break; }\n    v = v + a * vnoise(p);\n    p = FBM_ROT * p * 2.02;\n    a = a * 0.5;\n  }\n  return v;\n}\nfn ign(p: vec2<f32>) -> f32 {\n  return fract(52.9829189 * fract(dot(p, vec2<f32>(0.06711056, 0.00583715))));\n}\n\n\nfn srgbToLinearCh(c: f32) -> f32 {\n  if (c <= 0.04045) { return c / 12.92; }\n  return pow((c + 0.055) / 1.055, 2.4);\n}\nfn srgbToLinear(c: vec3<f32>) -> vec3<f32> {\n  return vec3<f32>(srgbToLinearCh(c.r), srgbToLinearCh(c.g), srgbToLinearCh(c.b));\n}\n\nfn linearToSrgbCh(c: f32) -> f32 {\n  if (c <= 0.0031308) { return c * 12.92; }\n  return 1.055 * pow(c, 1.0 / 2.4) - 0.055;\n}\nfn linearToSrgb(c: vec3<f32>) -> vec3<f32> {\n  return vec3<f32>(linearToSrgbCh(c.r), linearToSrgbCh(c.g), linearToSrgbCh(c.b));\n}\n\n// value.js LINEAR_SRGB_TO_LMS, row-major \u2192 WGSL columns (= the transpose).\nconst LINEAR_SRGB_TO_LMS: mat3x3<f32> = mat3x3<f32>(\n  0.4122214708, 0.2119034982, 0.0883024619,\n  0.5363325363, 0.6806995451, 0.2817188376,\n  0.0514459929, 0.1073969566, 0.6299787005\n);\n\n// value.js srgbToOKLab's INLINE LMS\u2192OKLab coefficients, row-major \u2192 WGSL columns.\nconst LMS_TO_OKLAB: mat3x3<f32> = mat3x3<f32>(\n  0.2104542553, 1.9779984951, 0.0259040371,\n  0.7936177850, -2.4285922050, 0.7827717662,\n  -0.0040720468, 0.4505937099, -0.8086757660\n);\n\n// value.js OKLAB_TO_LMS_COEFF, row-major \u2192 WGSL columns.\nconst OKLAB_TO_LMS: mat3x3<f32> = mat3x3<f32>(\n  1.0, 1.0, 1.0,\n  0.3963377774, -0.1055613458, -0.0894841775,\n  0.2158037573, -0.0638541728, -1.2914855480\n);\n\n// value.js LMS_TO_LINEAR_SRGB, row-major \u2192 WGSL columns.\nconst LMS_TO_LINEAR_SRGB: mat3x3<f32> = mat3x3<f32>(\n  4.0767416621, -1.2684380046, -0.0041960863,\n  -3.3077115913, 2.6097574011, -0.7034186147,\n  0.2309699292, -0.3413193965, 1.7076147010\n);\n\nfn cbrt3(v: vec3<f32>) -> vec3<f32> {\n  return sign(v) * pow(abs(v), vec3<f32>(1.0 / 3.0));\n}\n\n// Gamma sRGB \u2192 raw OKLab (L, a, b). Mirrors value.js srgbToOKLab.\nfn srgbToOklab(c: vec3<f32>) -> vec3<f32> {\n  let lin = srgbToLinear(c);\n  let lms = LINEAR_SRGB_TO_LMS * lin;\n  return LMS_TO_OKLAB * cbrt3(lms);\n}\n\n// Raw OKLab (L, a, b) \u2192 linear sRGB. Mirrors value.js oklabToLinearSRGB.\nfn oklabToLinearSrgb(lab: vec3<f32>) -> vec3<f32> {\n  let lms_ = OKLAB_TO_LMS * lab;\n  let lms = lms_ * lms_ * lms_;\n  return LMS_TO_LINEAR_SRGB * lms;\n}\n\n// OKLab \u2192 OKLCh: H in RADIANS, folded to [0, 2pi). Mirrors value.js rawOklabToOklch.\nfn oklabToOklch(lab: vec3<f32>) -> vec3<f32> {\n  let C = length(lab.yz);\n  var H = atan2(lab.z, lab.y);\n  if (H < 0.0) { H = H + 2.0 * PI; }\n  return vec3<f32>(lab.x, C, H);\n}\n\n// OKLCh (H radians) \u2192 OKLab. Mirrors value.js rawOklchToOklab.\nfn oklchToOklab(lch: vec3<f32>) -> vec3<f32> {\n  return vec3<f32>(lch.x, lch.y * cos(lch.z), lch.y * sin(lch.z));\n}\n\nfn linOklab(lin: vec3<f32>) -> vec3<f32> {\n  let lms = LINEAR_SRGB_TO_LMS * lin;\n  return LMS_TO_OKLAB * cbrt3(lms);\n}\n\n// The Quilez double-warp (fbm) + the cursor swirl \u2014 the drift that moves the blur zone.\nfn domainWarp(p: vec2<f32>, t: f32) -> vec2<f32> {\n  let warpAmount = u.scalars0.y;\n  let warpScale = u.scalars0.z;\n  let warpDrift = u.scalars0.w;\n  let cursorStrength = u.scalars1.z;\n  let cursorRadius = u.scalars1.w;\n  let cursor = u.cursor.xy;\n  let q = vec2<f32>(fbm(p * warpScale + vec2<f32>(0.0, 0.0) + t * warpDrift * K_WARP),\n                    fbm(p * warpScale + vec2<f32>(5.2, 1.3) + t * warpDrift * K_WARP));\n  let r = vec2<f32>(fbm(p * warpScale + 4.0 * q + vec2<f32>(1.7, 9.2)),\n                    fbm(p * warpScale + 4.0 * q + vec2<f32>(8.3, 2.8)));\n  var warped = p + warpAmount * r;\n  if (cursorStrength > 0.001) {\n    let toP = p - cursor;\n    let d = length(toP);\n    let rr = max(cursorRadius, 0.01);\n    let w = exp(-(d * d) / (rr * rr * 0.45));\n    let ang = w * cursorStrength * 2.1;\n    let ca = cos(ang);\n    let sa = sin(ang);\n    let rotated = vec2<f32>(ca * toP.x - sa * toP.y, sa * toP.x + ca * toP.y) + cursor;\n    warped = mix(warped, rotated + warpAmount * r * 0.7, w * cursorStrength);\n  }\n  return warped;\n}\n\n// The drifting BLUR ZONE \u2014 the anisotropic-Gaussian nuclei softmax (the SAME field the\n// palette program reads), drift-coupled.\nfn zoneField(p: vec2<f32>, t: f32) -> f32 {\n  let nucleiCount = u.ints.x;\n  let nucleiDrift = u.scalars1.y;\n  let softmaxBeta = u.scalars1.x;\n  var accum = 0.0;\n  var accumW = 0.0;\n  for (var i = 0; i < MAX_NUCLEI; i = i + 1) {\n    if (i >= nucleiCount) { break; }\n    let n0 = u.nuc0[i];  // pos.x, pos.y, radius, valueBias\n    let n1 = u.nuc1[i];  // driftRadius, driftPhase, elong, angle\n    let posI = n0.xy + n1.x * vec2<f32>(\n      cos(t * nucleiDrift * K_NUCLEI + n1.y),\n      sin(t * nucleiDrift * K_NUCLEI + n1.y * 1.13));\n    let diff = p - posI;\n    let ca = cos(n1.w);\n    let sa = sin(n1.w);\n    let local = vec2<f32>(ca * diff.x + sa * diff.y, -sa * diff.x + ca * diff.y);\n    let along = local.x / max(n1.z, 0.01);\n    let d2 = along * along + local.y * local.y;\n    let rad = max(n0.z, 0.01);\n    let w = exp(-softmaxBeta * d2 / (rad * rad));\n    accum = accum + w * (0.5 + 0.5 * n0.w);\n    accumW = accumW + w;\n  }\n  return clamp(accum / max(accumW, 1e-4), 0.0, 1.0);\n}\n\nfn coverUv(uv: vec2<f32>) -> vec2<f32> {\n  let aspect = max(u.image.z, 0.0001);\n  var c = uv - vec2<f32>(0.5);\n  c.x = c.x * aspect;\n  let s = 1.0 / max(aspect, 1.0);\n  return c * s + vec2<f32>(0.5);\n}\n\n// The bounded 24-tap zone blur \u2014 a FIXED 3-ring \u00D7 8-sector stratified kernel, radius\n// per-fragment, sampled in LINEAR light. textureSampleLevel (explicit LOD 0) \u2014 WGSL has\n// no implicit derivative in a varying-radius loop.\nfn zoneBlur(uv: vec2<f32>, radius: f32) -> vec3<f32> {\n  let aspect = max(u.image.z, 0.0001);\n  var sum = srgbToLinear(textureSampleLevel(imgTex, imgSampler, coverUv(uv), 0.0).rgb);\n  var wsum = 1.0;\n  for (var ring = 1; ring <= BLUR_RINGS; ring = ring + 1) {\n    let rr = radius * (f32(ring) / f32(BLUR_RINGS));\n    for (var s = 0; s < BLUR_SECTORS; s = s + 1) {\n      let a = (f32(s) + 0.5 * f32(ring)) / f32(BLUR_SECTORS) * 2.0 * PI;\n      let off = vec2<f32>(cos(a) / aspect, sin(a)) * rr;\n      sum = sum + srgbToLinear(textureSampleLevel(imgTex, imgSampler, coverUv(uv + off), 0.0).rgb);\n      wsum = wsum + 1.0;\n    }\n  }\n  return sum / wsum;\n}\n\nconst VIVID_TARGET: f32 = 0.115;\nconst VIVID_EPS: f32 = 0.012;\nconst VIVID_WARM_ANCHOR: vec2<f32> = vec2<f32>(0.34202, 0.93969);\nfn vividnessFloor(c: vec3<f32>, vividness: f32) -> vec3<f32> {\n  if (vividness <= 0.0001) { return c; }\n  var lab = linOklab(c);\n  let C = length(lab.yz);\n  let modeLift = mix(1.18, 1.0, clamp(lab.x * 1.4, 0.0, 1.0));\n  let Cmin = vividness * VIVID_TARGET * modeLift;\n  var hueDir = VIVID_WARM_ANCHOR;\n  if (C > VIVID_EPS) { hueDir = lab.yz / C; }\n  let yz = hueDir * max(C, Cmin);\n  lab = vec3<f32>(lab.x, yz.x, yz.y);\n  return max(oklabToLinearSrgb(lab), vec3<f32>(0.0));\n}\n\nfn saturate3(c: vec3<f32>, amt: f32) -> vec3<f32> {\n  var lch = oklabToOklch(linOklab(c));\n  lch.y = max(lch.y * amt, 0.0);\n  return max(oklabToLinearSrgb(oklchToOklab(lch)), vec3<f32>(0.0));\n}\n\nfn aces(color0: vec3<f32>) -> vec3<f32> {\n  let startCompression = 0.8 - 0.04;\n  let desaturation = 0.15;\n  var color = color0;\n  let x = min(color.r, min(color.g, color.b));\n  var offset = 0.04;\n  if (x < 0.08) { offset = x - 6.25 * x * x; }\n  color = color - offset;\n  let peak = max(color.r, max(color.g, color.b));\n  if (peak < startCompression) { return clamp(color, vec3<f32>(0.0), vec3<f32>(1.0)); }\n  let d = 1.0 - startCompression;\n  let newPeak = 1.0 - d * d / (peak + d - startCompression);\n  color = color * (newPeak / peak);\n  let g = 1.0 - 1.0 / (desaturation * (peak - newPeak) + 1.0);\n  return clamp(mix(color, newPeak * vec3<f32>(1.0), g), vec3<f32>(0.0), vec3<f32>(1.0));\n}\n\nstruct VSOut {\n  @builtin(position) pos: vec4<f32>,\n  @location(0) uv: vec2<f32>,\n};\n\n@vertex\nfn vs_main(@builtin(vertex_index) vi: u32) -> VSOut {\n  var p = vec2<f32>(-1.0, -1.0);\n  if (vi == 1u) { p = vec2<f32>(3.0, -1.0); }\n  else if (vi == 2u) { p = vec2<f32>(-1.0, 3.0); }\n  var out: VSOut;\n  out.pos = vec4<f32>(p, 0.0, 1.0);\n  out.uv = p * 0.5 + 0.5;\n  return out;\n}\n\n@fragment\nfn fs_main(in: VSOut) -> @location(0) vec4<f32> {\n  let t = u.scalars0.x;\n  let saturation = u.scalars2.x;\n  let paperGrain = u.scalars2.y;\n  let alpha = u.scalars2.z;\n  let vividness = u.scalars2.w;\n  let blurMin = u.image.x;\n  let blurMax = u.image.y;\n\n  let uv = in.uv;\n  let p_warp = domainWarp(uv, t);\n  let zone = zoneField(p_warp, t);\n\n  let radius = mix(blurMin, blurMax, zone);\n  var col = zoneBlur(uv, radius);\n\n  let cursorDelta = uv - u.cursor.xy;\n  let cursorRadius = max(u.scalars1.w, 0.01);\n  let cursorLean = exp(-dot(cursorDelta, cursorDelta) / (cursorRadius * cursorRadius * 0.5));\n  col = col * (1.0 + 0.12 * cursorLean * u.scalars1.z);\n\n  col = saturate3(col, saturation);\n  col = vividnessFloor(col, vividness);\n\n  col = aces(col);\n  let fragCoord = in.pos.xy;\n  let grain = hash21(fragCoord + t * 17.0);\n  col = col + (grain - 0.5) * paperGrain;\n  col = clamp(col * 0.985 + 0.008, vec3<f32>(0.0), vec3<f32>(1.0));\n\n  col = linearToSrgb(col);\n  col = col + (1.0 / 255.0) * (ign(fragCoord) - 0.5);\n\n  return vec4<f32>(col * alpha, alpha);\n}\n";

package/dist/components/aurora/constants/shaders/aurora-mediums.wgsl.d.ts

@@ -1 +1 @@
-export declare const AURORA_MEDIUMS_WGSL = "\n// \u2500\u2500 Painterly luma + medium scalar accessors \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nconst W_LUMA: vec3<f32> = vec3<f32>(0.2126, 0.7152, 0.0722);\n\nfn mStrokeAmount() -> f32 { return u.scalars4.x; }\nfn mStrokeScale() -> f32 { return u.scalars4.y; }\nfn mStrokeAnisotropy() -> f32 { return u.scalars4.z; }\nfn mCanvasGrain() -> f32 { return u.scalars4.w; }\nfn mWetEdge() -> f32 { return u.scalars5.x; }\nfn mGranulation() -> f32 { return u.scalars5.y; }\nfn mBrokenColor() -> f32 { return u.scalars5.z; }\nfn mKuwaharaQ() -> f32 { return u.scalars5.w; }\nfn mKuwaharaRadius() -> f32 { return u.kuwahara.x; }\n// BG.W-AUR-METAL-FINISH \u2014 the metal-medium knobs ride the FREE cursor.z/.w pad lanes\n// (uniformBridgeWGPU packs them; written 0 on a non-metal config \u2192 no-op). These read\n// the IN-STRUCT cursor \u2014 the metal light is cursor-synthesized so it crosses to WGSL\n// (a phantom uLightDir read would be flat on the primary \u2014 uLightDir is .frag-only).\nfn mMetalPolish() -> f32 { return u.cursor.z; }\nfn mMetalHeightScale() -> f32 { return u.cursor.w; }\n\n// \u2500\u2500 Gradient pack (BG.W-AUR-METAL-FINISH; the WGSL twin) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n// structureTensorField re-plumbs its already-computed luma gradient (Gx,Gy) out\n// through the return's .w lane so the metal medium pays ZERO extra taps. 12 bits per\n// bounded component ([-4,4]) into one f32; the crayon/kuwahara callers read only .xy/.z.\nfn packGrad(gx: f32, gy: f32) -> f32 {\n  let qx = floor(clamp(gx * 0.125 + 0.5, 0.0, 1.0) * 4095.0);\n  let qy = floor(clamp(gy * 0.125 + 0.5, 0.0, 1.0) * 4095.0);\n  return qx + qy * 4096.0;\n}\nfn unpackGrad(packed: f32) -> vec2<f32> {\n  let qy = floor(packed * (1.0 / 4096.0));\n  let qx = packed - qy * 4096.0;\n  return (vec2<f32>(qx, qy) * (1.0 / 4095.0) - 0.5) * 8.0;\n}\n\n// \u2500\u2500 Base color re-sample (the edge-mask operator the mediums Sobel/sector-sample) \u2500\u2500\n// The WGSL twin of mediums.glsl.ts sampleBase: warp -> nuclei field -> palette -> value.\nfn sampleBase(p: vec2<f32>, t: f32) -> vec3<f32> {\n  let pw = domainWarp(p, t);\n  let nf = nucleiField(pw, t);\n  var c = samplePalette(nf.paletteId);\n  c = c * (1.0 + u.scalars0.z * nf.valueMod);\n  return c;\n}\n\n// \u2500\u2500 Broken color (hue + chroma jitter at constant OKLCh L) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nfn brokenColorJitter(c: vec3<f32>, hueSeed: f32, valueSeed: f32, strength: f32) -> vec3<f32> {\n  let amt = clamp(mBrokenColor() * strength, 0.0, 1.0);\n  if (amt <= 0.001) { return c; }\n  var lch = oklabToOklch(linOklab(c));\n  lch.z = lch.z + (hueSeed - 0.5) * (32.0 * PI / 180.0) * amt;\n  lch.y = max(lch.y * (1.0 + (valueSeed - 0.5) * 0.28 * amt), 0.0);\n  return max(oklabToLinearSrgb(oklchToOklab(lch)), vec3<f32>(0.0));\n}\n\n// \u2500\u2500 Structure-tensor / edge-tangent-flow (AW.W4.1; the WGSL twin) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n// Returns vec4(tangent.x, tangent.y, A, packGrad(Gx,Gy)) \u2014 the minor-eigenvector\n// edge-tangent + coherence + the metal medium's packed gradient (BG.W-AUR-METAL-FINISH;\n// the .xy/.z crayon/kuwahara callers are byte-unchanged).\nfn structureTensorField(p: vec2<f32>, t: f32, fallbackDir: vec2<f32>) -> vec4<f32> {\n  let e = 0.0035;\n  let l00 = dot(sampleBase(p + vec2<f32>(-e, -e), t), W_LUMA);\n  let l10 = dot(sampleBase(p + vec2<f32>(0.0, -e), t), W_LUMA);\n  let l20 = dot(sampleBase(p + vec2<f32>( e, -e), t), W_LUMA);\n  let l01 = dot(sampleBase(p + vec2<f32>(-e, 0.0), t), W_LUMA);\n  let l21 = dot(sampleBase(p + vec2<f32>( e, 0.0), t), W_LUMA);\n  let l02 = dot(sampleBase(p + vec2<f32>(-e, e), t), W_LUMA);\n  let l12 = dot(sampleBase(p + vec2<f32>(0.0, e), t), W_LUMA);\n  let l22 = dot(sampleBase(p + vec2<f32>( e, e), t), W_LUMA);\n  let Gx = (l20 + 2.0 * l21 + l22) - (l00 + 2.0 * l01 + l02);\n  let Gy = (l02 + 2.0 * l12 + l22) - (l00 + 2.0 * l10 + l20);\n  let Jxx = Gx * Gx;\n  let Jyy = Gy * Gy;\n  let Jxy = Gx * Gy;\n  let tr = Jxx + Jyy;\n  let disc = sqrt(max((Jxx - Jyy) * (Jxx - Jyy) + 4.0 * Jxy * Jxy, 0.0));\n  let lambdaMaj = 0.5 * (tr + disc);\n  let lambdaMin = 0.5 * (tr - disc);\n  var tangent: vec2<f32>;\n  if (disc < 1e-7) {\n    tangent = fallbackDir;\n  } else {\n    let theta = 0.5 * atan2(2.0 * Jxy, Jxx - Jyy);\n    tangent = vec2<f32>(-sin(theta), cos(theta));\n  }\n  var A = (lambdaMaj - lambdaMin) / (lambdaMaj + lambdaMin + 1e-6);\n  A = clamp(A, 0.0, 1.0);\n  if (dot(tangent, fallbackDir) < 0.0) { tangent = -tangent; }\n  let blendW = pow(A, 0.28);\n  let dir = normalize(mix(fallbackDir, tangent, blendW) + vec2<f32>(1e-6, 1e-6));\n  return vec4<f32>(dir, A, packGrad(Gx, Gy));\n}\n\n// \u2500\u2500 Flow field (the WGSL twin \u2014 the simple flow seed the medium fallback dirs use) \u2500\u2500\nfn flowField(p: vec2<f32>, t: f32) -> vec2<f32> {\n  // Curl-noise-driven swirl (the medium-default dir; the full radial/swirl/diagonal\n  // dispatch rides uniforms the WGSL struct does not carry \u2014 the procedural mediums\n  // use this multi/curl seed as the fallback the structure tensor relaxes toward).\n  let n = fbm(p * 2.0 + vec2<f32>(t * 0.02, t * 0.02));\n  let a = n * 6.2831853;\n  var dir = vec2<f32>(cos(a), sin(a));\n  // Cursor swirl bias (matches the GLSL flow cursor term \u2014 the steady attraction).\n  let cursorStrength = u.scalars3.y;\n  let cursorRadius = u.scalars3.z;\n  let cursor = u.cursor.xy;\n  if (cursorStrength > 0.001) {\n    let toCur = cursor - p;\n    let d = length(toCur);\n    let r = max(cursorRadius, 0.01);\n    let w = exp(-(d * d) / (r * r * 0.5));\n    let tangent = vec2<f32>(-toCur.y, toCur.x) / max(d, 1e-4);\n    let a0 = atan2(dir.y, dir.x);\n    let a1 = atan2(tangent.y, tangent.x);\n    var da = a1 - a0;\n    da = atan2(sin(da), cos(da));\n    let aa = a0 + da * w * cursorStrength;\n    dir = vec2<f32>(cos(aa), sin(aa));\n  }\n  return dir;\n}\n\n// \u2500\u2500 Watercolor \u2014 wet-edge cauliflowers + granulation + wash banding \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nfn mediumWatercolor(col0: vec3<f32>, p: vec2<f32>, t: f32) -> vec3<f32> {\n  var col = col0;\n  let eps = 0.004;\n  let cx1 = sampleBase(p + vec2<f32>(eps, 0.0), t);\n  let cx2 = sampleBase(p - vec2<f32>(eps, 0.0), t);\n  let cy1 = sampleBase(p + vec2<f32>(0.0, eps), t);\n  let cy2 = sampleBase(p - vec2<f32>(0.0, eps), t);\n  let gx = dot(cx1 - cx2, W_LUMA);\n  let gy = dot(cy1 - cy2, W_LUMA);\n  let edge = sqrt(gx * gx + gy * gy) / (2.0 * eps);\n  let mask = smoothstep(0.0, 2.5, edge);\n  col = col * mix(1.0, 0.78, mask * mWetEdge());\n\n  let paper = 0.5 * vnoise(p * 160.0) + 0.5 * vnoise(p * 360.0);\n  let pigLoad = 1.0 - dot(col, W_LUMA);\n  col = col * (1.0 - mGranulation() * pigLoad * (paper - 0.5));\n\n  let band = fbm(vec2<f32>(p.x * 1.5, p.y * 0.4));\n  col = col * (1.0 + 0.04 * (band - 0.5));\n  return col;\n}\n\n// \u2500\u2500 Pastel \u2014 anisotropic stroke noise along the flow + tooth grain \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nfn mediumPastel(col0: vec3<f32>, p: vec2<f32>, t: f32) -> vec3<f32> {\n  var col = col0;\n  let flow = flowField(p, t);\n  let perp = vec2<f32>(-flow.y, flow.x);\n  let strokeScale = mStrokeScale();\n  let along = dot(p, flow) * strokeScale;\n  var across = dot(p, perp) * strokeScale;\n  across = across + 0.03 * (vnoise(p * 260.0) - 0.5);\n\n  let aniso = mix(1.0, 0.18, mStrokeAnisotropy());\n  let stroke = fbm(vec2<f32>(along * aniso, across));\n  col = col * mix(1.0, 0.82 + 0.32 * stroke, mStrokeAmount());\n\n  let tooth = vnoise(p * 800.0);\n  col = col * (1.0 - 0.08 * mStrokeAmount() * (tooth - 0.5));\n  return col;\n}\n\n// \u2500\u2500 Crayon \u2014 DRY wax pigment on paper tooth (the tooth-multiply + scumble) \u2500\u2500\nfn mediumCrayon(col0: vec3<f32>, p: vec2<f32>, t: f32) -> vec3<f32> {\n  let flow = structureTensorField(p, t, flowField(p, t)).xy;\n  let ang = atan2(flow.y, flow.x);\n  let ca = cos(-ang);\n  let sa = sin(-ang);\n  let pr = vec2<f32>(p.x * ca - p.y * sa, p.x * sa + p.y * ca);\n\n  let aniso = mix(0.45, 0.95, mStrokeAnisotropy());\n  let scale = max(mStrokeScale() * 1.6, 180.0);\n\n  let t1 = vnoise(vec2<f32>(pr.x * scale * aniso, pr.y * scale));\n  let t2 = vnoise(vec2<f32>(pr.x * scale * aniso * 0.4, pr.y * scale * 0.4) + vec2<f32>(11.0, 11.0));\n  let t3 = vnoise(vec2<f32>(pr.x * scale * aniso * 2.1, pr.y * scale * 2.1) + vec2<f32>(23.0, 23.0));\n  let tooth = 0.55 * t1 + 0.30 * t2 + 0.15 * t3;\n\n  let pressure = clamp(mStrokeAmount(), 0.0, 1.0);\n  let bite = mix(0.18, 0.46, pressure);\n  var result = col0 * (1.0 - bite * (0.5 - tooth));\n\n  let scumbleMask = smoothstep(0.42, 0.78, vnoise(vec2<f32>(pr.x * scale * 0.55, pr.y * scale * 0.22) + vec2<f32>(7.0, 7.0)));\n  let scumbleCoverage = scumbleMask * pressure * 0.7;\n  let paper = col0 * mix(0.80, 0.94, pressure);\n  result = mix(paper, result, scumbleCoverage);\n\n  let pigmentCell = floor(pr * max(scale * 0.18, 32.0));\n  let pigmentMask = smoothstep(0.28, 0.82, vnoise(pr * scale * 0.21 + vec2<f32>(19.0, 19.0)));\n  result = brokenColorJitter(\n    result,\n    hash21(pigmentCell + vec2<f32>(17.0, 17.0)),\n    hash21(pigmentCell * 2.1 + vec2<f32>(31.0, 31.0)),\n    0.45 + 0.55 * pigmentMask\n  );\n\n  result = saturate3(result, 1.08);\n  return result;\n}\n\n// \u2500\u2500 Kuwahara \u2014 the SOFT anisotropic generalized Kuwahara painterly finish \u2500\u2500\u2500\u2500\n// THE KEYSTONE (Kyprianidis 2010). Aurora is a PROCEDURAL field (no input texture) so the\n// operator runs over sampleBase directly: an elliptical kernel oriented along the structure\n// tensor (elongated along the edge-tangent, narrowed across by the anisotropy), 8 OVERLAPPING\n// sectors via SMOOTH gaussian-angular weights, blended by 1/(1+var^q) (the SOFT criterion \u2192\n// no 8-spoke pinwheel by construction). 4 rings \u00D7 8 angular taps = 32 procedural samples.\nfn mediumKuwahara(col0: vec3<f32>, p: vec2<f32>, t: f32) -> vec3<f32> {\n  let stf = structureTensorField(p, t, flowField(p, t));\n  let tangent = stf.xy;\n  let A = stf.z;\n  // The studio knob drives the patch radius; clamp into the procedural patch band.\n  let radius = clamp(mKuwaharaRadius() + mStrokeScale() * 0.00018, 0.006, 0.024);\n  let aniso = mix(1.0, 0.34, clamp(A, 0.0, 1.0));\n  let ax = tangent;\n  let ay = vec2<f32>(-tangent.y, tangent.x);\n\n  // Per-sector weighted sums (8 sectors). WGSL has no runtime-indexed local arrays of\n  // vectors as cleanly as GLSL, so unroll the sector accumulators explicitly.\n  var mSum: array<vec3<f32>, 8>;\n  var sSum: array<vec3<f32>, 8>;\n  var wSum: array<f32, 8>;\n  for (var i = 0; i < 8; i = i + 1) {\n    mSum[i] = vec3<f32>(0.0);\n    sSum[i] = vec3<f32>(0.0);\n    wSum[i] = 0.0;\n  }\n\n  let RINGS = 4;\n  let TAPS = 8;\n  for (var r = 1; r <= RINGS; r = r + 1) {\n    let rr = f32(r) / f32(RINGS);\n    let radial = 1.0 - 0.6 * rr;\n    for (var a = 0; a < TAPS; a = a + 1) {\n      let ang = 6.2831853 * f32(a) / f32(TAPS);\n      let dirE = ax * cos(ang) + ay * (sin(ang) * aniso);\n      let off = dirE * (radius * rr);\n      let c = sampleBase(p + off, t);\n      for (var k = 0; k < 8; k = k + 1) {\n        let sectorAng = 6.2831853 * f32(k) / 8.0;\n        var d = ang - sectorAng;\n        d = atan2(sin(d), cos(d));\n        let sw = exp(-d * d * 2.2) * radial;\n        mSum[k] = mSum[k] + c * sw;\n        sSum[k] = sSum[k] + c * c * sw;\n        wSum[k] = wSum[k] + sw;\n      }\n    }\n  }\n\n  let q = max(mKuwaharaQ(), 1.0);\n  var accum = vec3<f32>(0.0);\n  var accumW = 0.0;\n  for (var k = 0; k < 8; k = k + 1) {\n    let wk = max(wSum[k], 1e-4);\n    let mean = mSum[k] / wk;\n    let var3 = max(sSum[k] / wk - mean * mean, vec3<f32>(0.0));\n    let variance = dot(var3, W_LUMA);\n    let sectorW = 1.0 / (1.0 + pow(variance * 320.0, q));\n    accum = accum + mean * sectorW;\n    accumW = accumW + sectorW;\n  }\n  var result = accum / max(accumW, 1e-4);\n\n  // Anchor in near-flat zones so the smoothing only bites at edges.\n  let center = sampleBase(p, t);\n  result = mix(center, result, clamp(0.35 + 0.65 * A, 0.0, 1.0));\n\n  // Faint canvas tooth + pigment-saturation so the flattened patches read as oil paint.\n  let tooth = vnoise(p * 300.0) - 0.5;\n  result = result * (1.0 + tooth * 0.06 * mCanvasGrain());\n  result = saturate3(result, 1.04);\n\n  return mix(col0, result, clamp(mStrokeAmount(), 0.0, 1.0));\n}\n\n// \u2500\u2500 Metal \u2014 the two-term anisotropic BRDF (uMedium==8/9; the WGSL twin) \u2500\u2500\u2500\u2500\u2500\u2500\n// The field re-lights as warm folded metal: the luma HEIGHT field (the packed\n// structure-tensor gradient \u2192 the surface normal) catches an anisotropic Blinn streak\n// (brushed metal, running ALONG the coherent edge-tangent) plus a sharp crest, both\n// raked by the IN-STRUCT cursor-synth light (crosses to WGSL \u2014 never uLightDir). The\n// catch is the achromatic-warm anchor (never a cold chrome-blue). ZERO extra taps \u2014\n// the gradient is unpacked from the tensor's .w lane the caller already computed.\nconst METAL_CATCH_WARM: vec3<f32> = vec3<f32>(1.0, 0.97, 0.90);\nconst METAL_HEIGHT_SCALE: f32 = 2.2;\nconst METAL_LIGHT_Z: f32 = 0.55;\nconst METAL_IDLE_RAKE: vec2<f32> = vec2<f32>(0.32, 0.34);\nconst METAL_SHININESS_ANISO: f32 = 6.0;\nconst METAL_SHININESS_CREST: f32 = 40.0;\nconst METAL_COHERENCE_FLOOR: f32 = 0.22;\nconst METAL_BODY_FLOOR: f32 = 0.42;\nconst METAL_GRADIENT_FLATTEN: f32 = 0.55;\nconst METAL_SPARKLE_DENSITY: f32 = 240.0;\nconst METAL_SPARKLE_THRESH: f32 = 0.72;\nconst METAL_SPARKLE_AMP: f32 = 0.6;\n\nfn metalShade(baseCol: vec3<f32>, p: vec2<f32>, stf: vec4<f32>) -> vec3<f32> {\n  let tangent = stf.xy;\n  let A = stf.z;\n  let grad = unpackGrad(stf.w);\n  let N = normalize(vec3<f32>(grad * (METAL_HEIGHT_SCALE * mMetalHeightScale()), 1.0));\n  let V = vec3<f32>(0.0, 0.0, 1.0);\n  // Cursor-synth rake light (u.cursor is in-struct \u2014 crosses to WGSL).\n  let L = normalize(vec3<f32>((u.cursor.xy - p) + METAL_IDLE_RAKE, METAL_LIGHT_Z));\n  let H = normalize(L + V);\n  // Anisotropic streak \u2014 brushed metal along the edge-tangent.\n  let tH = dot(normalize(tangent), H.xy);\n  let sinTH = sqrt(clamp(1.0 - tH * tH, 0.0, 1.0));\n  let streak = pow(clamp(sinTH, 0.0, 1.0), METAL_SHININESS_ANISO);\n  let crest = pow(clamp(dot(N, H), 0.0, 1.0), METAL_SHININESS_CREST);\n  var spec = streak * crest;\n  spec = spec * smoothstep(0.0, METAL_COHERENCE_FLOOR, A);\n  // Technicolor valley base \u2014 the body keeps the FIELD hue; luma rides the relief.\n  let diff = clamp(dot(N, L), 0.0, 1.0);\n  let body = baseCol * (METAL_BODY_FLOOR + (1.0 - METAL_BODY_FLOOR) * diff);\n  return body + METAL_CATCH_WARM * (spec * clamp(mMetalPolish(), 0.0, 4.0));\n}\n\nfn mediumMetal(col: vec3<f32>, p: vec2<f32>, t: f32) -> vec3<f32> {\n  let stf = structureTensorField(p, t, flowField(p, t));\n  return metalShade(col, p, stf);\n}\n\n// metal-gradient (uMedium==9) \u2014 the SAME BRDF over a pre-flattened base + the\n// twinkle-in-place flake sparkle (position FIXED per cell, phase-animated, facing-gated).\nfn mediumMetalGradient(col: vec3<f32>, p: vec2<f32>, t: f32) -> vec3<f32> {\n  let stf = structureTensorField(p, t, flowField(p, t));\n  let flat = mix(col, vec3<f32>(dot(col, W_LUMA)), METAL_GRADIENT_FLATTEN);\n  var metal = metalShade(flat, p, stf);\n  let grad = unpackGrad(stf.w);\n  let facing = normalize(vec3<f32>(grad * (METAL_HEIGHT_SCALE * mMetalHeightScale()), 1.0)).z;\n  let cell = floor(p * METAL_SPARKLE_DENSITY);\n  let seed = hash21(cell);\n  let tw = pow(clamp(sin(t + seed * 6.2831853), 0.0, 1.0), 40.0);\n  let flakeGate = step(METAL_SPARKLE_THRESH, seed);\n  metal = metal + METAL_CATCH_WARM * (tw * flakeGate * clamp(facing, 0.0, 1.0) * METAL_SPARKLE_AMP);\n  return metal;\n}\n\n// \u2500\u2500 Medium dispatch (the WGSL twin of the GLSL main() if-ladder) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n// uMedium: 0 smooth \u00B7 1 pastel \u00B7 2 watercolor \u00B7 3 oil \u00B7 4 crayon \u00B7 5 vangogh \u00B7\n// 6 oil-pastel \u00B7 7 kuwahara \u00B7 8 metal \u00B7 9 metal-gradient. The cheap peer mediums\n// (pastel/watercolor/crayon) + kuwahara + metal port their own bodies; the\n// oil/vangogh/oil-pastel STROKE cascade renders the anisotropic-Kuwahara PAINTERLY\n// finish here (a real oil-paint read, never the smooth core \u2014 the \"NO FALLBACKS on\n// Safari\" mandate; the full per-dab Starry-Night stroke WGSL is the booked\n// W-AURORA-WGPU-MEDIUMS-STROKES tail).\nfn applyMedium(col: vec3<f32>, p: vec2<f32>, t: f32) -> vec3<f32> {\n  let medium = u.ints1.x;\n  if (medium == 1) { return mediumPastel(col, p, t); }\n  if (medium == 2) { return mediumWatercolor(col, p, t); }\n  if (medium == 4) { return mediumCrayon(col, p, t); }\n  // BG.W-AUR-METAL-FINISH \u2014 metal DUAL-PORTS (a .frag-only metal is invisible on the\n  // WGSL primary of both browsers); 8 metal, 9 metal-gradient.\n  if (medium == 8) { return mediumMetal(col, p, t); }\n  if (medium == 9) { return mediumMetalGradient(col, p, t); }\n  // oil(3) / vangogh(5) / oil-pastel(6) / kuwahara(7) all render the painterly\n  // anisotropic-Kuwahara finish on the WGSL primary (the WebGL2 fallback carries the\n  // full per-dab stroke cascade for oil/vangogh/oil-pastel).\n  if (medium == 3 || medium == 5 || medium == 6 || medium == 7) {\n    return mediumKuwahara(col, p, t);\n  }\n  return col;\n}\n";
+export declare const AURORA_MEDIUMS_WGSL = "\n// \u2500\u2500 Painterly luma + medium scalar accessors \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nconst W_LUMA: vec3<f32> = vec3<f32>(0.2126, 0.7152, 0.0722);\n\nfn mStrokeAmount() -> f32 { return u.scalars4.x; }\nfn mStrokeScale() -> f32 { return u.scalars4.y; }\nfn mStrokeAnisotropy() -> f32 { return u.scalars4.z; }\nfn mCanvasGrain() -> f32 { return u.scalars4.w; }\nfn mWetEdge() -> f32 { return u.scalars5.x; }\nfn mGranulation() -> f32 { return u.scalars5.y; }\nfn mBrokenColor() -> f32 { return u.scalars5.z; }\nfn mKuwaharaQ() -> f32 { return u.scalars5.w; }\nfn mKuwaharaRadius() -> f32 { return u.kuwahara.x; }\n// The metal-medium knobs ride the free cursor.z/.w pad lanes\n// (uniformBridgeWGPU packs them; written 0 on a non-metal config \u2192 no-op). These read\n// the IN-STRUCT cursor \u2014 the metal light is cursor-synthesized so it crosses to WGSL\n// (a phantom uLightDir read would be flat on the primary; uLightDir is fragment-only).\nfn mMetalPolish() -> f32 { return u.cursor.z; }\nfn mMetalHeightScale() -> f32 { return u.cursor.w; }\n\n// \u2500\u2500 Gradient pack (the WGSL twin) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n// structureTensorField re-plumbs its already-computed luma gradient (Gx,Gy) out\n// through the return value's .w lane so the metal medium pays ZERO extra taps. 12 bits per\n// bounded component ([-4,4]) fit into one f32; the crayon/kuwahara callers read only .xy/.z.\nfn packGrad(gx: f32, gy: f32) -> f32 {\n  let qx = floor(clamp(gx * 0.125 + 0.5, 0.0, 1.0) * 4095.0);\n  let qy = floor(clamp(gy * 0.125 + 0.5, 0.0, 1.0) * 4095.0);\n  return qx + qy * 4096.0;\n}\nfn unpackGrad(packed: f32) -> vec2<f32> {\n  let qy = floor(packed * (1.0 / 4096.0));\n  let qx = packed - qy * 4096.0;\n  return (vec2<f32>(qx, qy) * (1.0 / 4095.0) - 0.5) * 8.0;\n}\n\n// \u2500\u2500 Base color re-sample (the edge-mask operator the mediums Sobel/sector-sample) \u2500\u2500\n// The WGSL twin of mediums.glsl.ts sampleBase: warp -> nuclei field -> palette -> value.\nfn sampleBase(p: vec2<f32>, t: f32) -> vec3<f32> {\n  let pw = domainWarp(p, t);\n  let nf = nucleiField(pw, t);\n  var c = samplePalette(nf.paletteId);\n  c = c * (1.0 + u.scalars0.z * nf.valueMod);\n  return c;\n}\n\n// \u2500\u2500 Broken color (hue + chroma jitter at constant OKLCh L) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nfn brokenColorJitter(c: vec3<f32>, hueSeed: f32, valueSeed: f32, strength: f32) -> vec3<f32> {\n  let amt = clamp(mBrokenColor() * strength, 0.0, 1.0);\n  if (amt <= 0.001) { return c; }\n  var lch = oklabToOklch(linOklab(c));\n  lch.z = lch.z + (hueSeed - 0.5) * (32.0 * PI / 180.0) * amt;\n  lch.y = max(lch.y * (1.0 + (valueSeed - 0.5) * 0.28 * amt), 0.0);\n  return max(oklabToLinearSrgb(oklchToOklab(lch)), vec3<f32>(0.0));\n}\n\n// \u2500\u2500 Structure tensor / edge-tangent flow (the WGSL twin) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n// Returns vec4(tangent.x, tangent.y, A, packGrad(Gx,Gy)) \u2014 the minor-eigenvector\n// edge-tangent + coherence + the metal medium's packed gradient. The .xy/.z\n// crayon/kuwahara callers are byte-unchanged.\nfn structureTensorField(p: vec2<f32>, t: f32, fallbackDir: vec2<f32>) -> vec4<f32> {\n  let e = 0.0035;\n  let l00 = dot(sampleBase(p + vec2<f32>(-e, -e), t), W_LUMA);\n  let l10 = dot(sampleBase(p + vec2<f32>(0.0, -e), t), W_LUMA);\n  let l20 = dot(sampleBase(p + vec2<f32>( e, -e), t), W_LUMA);\n  let l01 = dot(sampleBase(p + vec2<f32>(-e, 0.0), t), W_LUMA);\n  let l21 = dot(sampleBase(p + vec2<f32>( e, 0.0), t), W_LUMA);\n  let l02 = dot(sampleBase(p + vec2<f32>(-e, e), t), W_LUMA);\n  let l12 = dot(sampleBase(p + vec2<f32>(0.0, e), t), W_LUMA);\n  let l22 = dot(sampleBase(p + vec2<f32>( e, e), t), W_LUMA);\n  let Gx = (l20 + 2.0 * l21 + l22) - (l00 + 2.0 * l01 + l02);\n  let Gy = (l02 + 2.0 * l12 + l22) - (l00 + 2.0 * l10 + l20);\n  let Jxx = Gx * Gx;\n  let Jyy = Gy * Gy;\n  let Jxy = Gx * Gy;\n  let tr = Jxx + Jyy;\n  let disc = sqrt(max((Jxx - Jyy) * (Jxx - Jyy) + 4.0 * Jxy * Jxy, 0.0));\n  let lambdaMaj = 0.5 * (tr + disc);\n  let lambdaMin = 0.5 * (tr - disc);\n  var tangent: vec2<f32>;\n  if (disc < 1e-7) {\n    tangent = fallbackDir;\n  } else {\n    let theta = 0.5 * atan2(2.0 * Jxy, Jxx - Jyy);\n    tangent = vec2<f32>(-sin(theta), cos(theta));\n  }\n  var A = (lambdaMaj - lambdaMin) / (lambdaMaj + lambdaMin + 1e-6);\n  A = clamp(A, 0.0, 1.0);\n  if (dot(tangent, fallbackDir) < 0.0) { tangent = -tangent; }\n  let blendW = pow(A, 0.28);\n  let dir = normalize(mix(fallbackDir, tangent, blendW) + vec2<f32>(1e-6, 1e-6));\n  return vec4<f32>(dir, A, packGrad(Gx, Gy));\n}\n\n// \u2500\u2500 Flow field (the WGSL twin \u2014 the simple flow seed the medium fallback dirs use) \u2500\u2500\nfn flowField(p: vec2<f32>, t: f32) -> vec2<f32> {\n  // Curl-noise-driven swirl (the medium-default dir; the full radial/swirl/diagonal\n  // dispatch rides uniforms the WGSL struct does not carry \u2014 the procedural mediums\n  // use this multi/curl seed as the fallback the structure tensor relaxes toward).\n  let n = fbm(p * 2.0 + vec2<f32>(t * 0.02, t * 0.02));\n  let a = n * 6.2831853;\n  var dir = vec2<f32>(cos(a), sin(a));\n  // Cursor swirl bias (matches the GLSL flow cursor term \u2014 the steady attraction).\n  let cursorStrength = u.scalars3.y;\n  let cursorRadius = u.scalars3.z;\n  let cursor = u.cursor.xy;\n  if (cursorStrength > 0.001) {\n    let toCur = cursor - p;\n    let d = length(toCur);\n    let r = max(cursorRadius, 0.01);\n    let w = exp(-(d * d) / (r * r * 0.5));\n    let tangent = vec2<f32>(-toCur.y, toCur.x) / max(d, 1e-4);\n    let a0 = atan2(dir.y, dir.x);\n    let a1 = atan2(tangent.y, tangent.x);\n    var da = a1 - a0;\n    da = atan2(sin(da), cos(da));\n    let aa = a0 + da * w * cursorStrength;\n    dir = vec2<f32>(cos(aa), sin(aa));\n  }\n  return dir;\n}\n\n// \u2500\u2500 Watercolor \u2014 wet-edge cauliflowers + granulation + wash banding \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nfn mediumWatercolor(col0: vec3<f32>, p: vec2<f32>, t: f32) -> vec3<f32> {\n  var col = col0;\n  let eps = 0.004;\n  let cx1 = sampleBase(p + vec2<f32>(eps, 0.0), t);\n  let cx2 = sampleBase(p - vec2<f32>(eps, 0.0), t);\n  let cy1 = sampleBase(p + vec2<f32>(0.0, eps), t);\n  let cy2 = sampleBase(p - vec2<f32>(0.0, eps), t);\n  let gx = dot(cx1 - cx2, W_LUMA);\n  let gy = dot(cy1 - cy2, W_LUMA);\n  let edge = sqrt(gx * gx + gy * gy) / (2.0 * eps);\n  let mask = smoothstep(0.0, 2.5, edge);\n  col = col * mix(1.0, 0.78, mask * mWetEdge());\n\n  let paper = 0.5 * vnoise(p * 160.0) + 0.5 * vnoise(p * 360.0);\n  let pigLoad = 1.0 - dot(col, W_LUMA);\n  col = col * (1.0 - mGranulation() * pigLoad * (paper - 0.5));\n\n  let band = fbm(vec2<f32>(p.x * 1.5, p.y * 0.4));\n  col = col * (1.0 + 0.04 * (band - 0.5));\n  return col;\n}\n\n// \u2500\u2500 Pastel \u2014 anisotropic stroke noise along the flow + tooth grain \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nfn mediumPastel(col0: vec3<f32>, p: vec2<f32>, t: f32) -> vec3<f32> {\n  var col = col0;\n  let flow = flowField(p, t);\n  let perp = vec2<f32>(-flow.y, flow.x);\n  let strokeScale = mStrokeScale();\n  let along = dot(p, flow) * strokeScale;\n  var across = dot(p, perp) * strokeScale;\n  across = across + 0.03 * (vnoise(p * 260.0) - 0.5);\n\n  let aniso = mix(1.0, 0.18, mStrokeAnisotropy());\n  let stroke = fbm(vec2<f32>(along * aniso, across));\n  col = col * mix(1.0, 0.82 + 0.32 * stroke, mStrokeAmount());\n\n  let tooth = vnoise(p * 800.0);\n  col = col * (1.0 - 0.08 * mStrokeAmount() * (tooth - 0.5));\n  return col;\n}\n\n// \u2500\u2500 Crayon \u2014 DRY wax pigment on paper tooth (the tooth-multiply + scumble) \u2500\u2500\nfn mediumCrayon(col0: vec3<f32>, p: vec2<f32>, t: f32) -> vec3<f32> {\n  let flow = structureTensorField(p, t, flowField(p, t)).xy;\n  let ang = atan2(flow.y, flow.x);\n  let ca = cos(-ang);\n  let sa = sin(-ang);\n  let pr = vec2<f32>(p.x * ca - p.y * sa, p.x * sa + p.y * ca);\n\n  let aniso = mix(0.45, 0.95, mStrokeAnisotropy());\n  let scale = max(mStrokeScale() * 1.6, 180.0);\n\n  let t1 = vnoise(vec2<f32>(pr.x * scale * aniso, pr.y * scale));\n  let t2 = vnoise(vec2<f32>(pr.x * scale * aniso * 0.4, pr.y * scale * 0.4) + vec2<f32>(11.0, 11.0));\n  let t3 = vnoise(vec2<f32>(pr.x * scale * aniso * 2.1, pr.y * scale * 2.1) + vec2<f32>(23.0, 23.0));\n  let tooth = 0.55 * t1 + 0.30 * t2 + 0.15 * t3;\n\n  let pressure = clamp(mStrokeAmount(), 0.0, 1.0);\n  let bite = mix(0.18, 0.46, pressure);\n  var result = col0 * (1.0 - bite * (0.5 - tooth));\n\n  let scumbleMask = smoothstep(0.42, 0.78, vnoise(vec2<f32>(pr.x * scale * 0.55, pr.y * scale * 0.22) + vec2<f32>(7.0, 7.0)));\n  let scumbleCoverage = scumbleMask * pressure * 0.7;\n  let paper = col0 * mix(0.80, 0.94, pressure);\n  result = mix(paper, result, scumbleCoverage);\n\n  let pigmentCell = floor(pr * max(scale * 0.18, 32.0));\n  let pigmentMask = smoothstep(0.28, 0.82, vnoise(pr * scale * 0.21 + vec2<f32>(19.0, 19.0)));\n  result = brokenColorJitter(\n    result,\n    hash21(pigmentCell + vec2<f32>(17.0, 17.0)),\n    hash21(pigmentCell * 2.1 + vec2<f32>(31.0, 31.0)),\n    0.45 + 0.55 * pigmentMask\n  );\n\n  result = saturate3(result, 1.08);\n  return result;\n}\n\n// \u2500\u2500 Kuwahara \u2014 the SOFT anisotropic generalized Kuwahara painterly finish \u2500\u2500\u2500\u2500\n// THE KEYSTONE (Kyprianidis 2010). Aurora is a PROCEDURAL field (no input texture) so the\n// operator runs over sampleBase directly: an elliptical kernel oriented along the structure\n// tensor (elongated along the edge-tangent, narrowed across by the anisotropy), 8 OVERLAPPING\n// sectors via SMOOTH gaussian-angular weights, blended by 1/(1+var^q) (the SOFT criterion \u2192\n// no 8-spoke pinwheel by construction). 4 rings \u00D7 8 angular taps = 32 procedural samples.\nfn mediumKuwahara(col0: vec3<f32>, p: vec2<f32>, t: f32) -> vec3<f32> {\n  let stf = structureTensorField(p, t, flowField(p, t));\n  let tangent = stf.xy;\n  let A = stf.z;\n  // The studio knob drives the patch radius; clamp into the procedural patch band.\n  let radius = clamp(mKuwaharaRadius() + mStrokeScale() * 0.00018, 0.006, 0.024);\n  let aniso = mix(1.0, 0.34, clamp(A, 0.0, 1.0));\n  let ax = tangent;\n  let ay = vec2<f32>(-tangent.y, tangent.x);\n\n  // Per-sector weighted sums (8 sectors). WGSL has no runtime-indexed local arrays of\n  // vectors as cleanly as GLSL, so unroll the sector accumulators explicitly.\n  var mSum: array<vec3<f32>, 8>;\n  var sSum: array<vec3<f32>, 8>;\n  var wSum: array<f32, 8>;\n  for (var i = 0; i < 8; i = i + 1) {\n    mSum[i] = vec3<f32>(0.0);\n    sSum[i] = vec3<f32>(0.0);\n    wSum[i] = 0.0;\n  }\n\n  let RINGS = 4;\n  let TAPS = 8;\n  for (var r = 1; r <= RINGS; r = r + 1) {\n    let rr = f32(r) / f32(RINGS);\n    let radial = 1.0 - 0.6 * rr;\n    for (var a = 0; a < TAPS; a = a + 1) {\n      let ang = 6.2831853 * f32(a) / f32(TAPS);\n      let dirE = ax * cos(ang) + ay * (sin(ang) * aniso);\n      let off = dirE * (radius * rr);\n      let c = sampleBase(p + off, t);\n      for (var k = 0; k < 8; k = k + 1) {\n        let sectorAng = 6.2831853 * f32(k) / 8.0;\n        var d = ang - sectorAng;\n        d = atan2(sin(d), cos(d));\n        let sw = exp(-d * d * 2.2) * radial;\n        mSum[k] = mSum[k] + c * sw;\n        sSum[k] = sSum[k] + c * c * sw;\n        wSum[k] = wSum[k] + sw;\n      }\n    }\n  }\n\n  let q = max(mKuwaharaQ(), 1.0);\n  var accum = vec3<f32>(0.0);\n  var accumW = 0.0;\n  for (var k = 0; k < 8; k = k + 1) {\n    let wk = max(wSum[k], 1e-4);\n    let mean = mSum[k] / wk;\n    let var3 = max(sSum[k] / wk - mean * mean, vec3<f32>(0.0));\n    let variance = dot(var3, W_LUMA);\n    let sectorW = 1.0 / (1.0 + pow(variance * 320.0, q));\n    accum = accum + mean * sectorW;\n    accumW = accumW + sectorW;\n  }\n  var result = accum / max(accumW, 1e-4);\n\n  // Anchor in near-flat zones so the smoothing only bites at edges.\n  let center = sampleBase(p, t);\n  result = mix(center, result, clamp(0.35 + 0.65 * A, 0.0, 1.0));\n\n  // Faint canvas tooth + pigment-saturation so the flattened patches read as oil paint.\n  let tooth = vnoise(p * 300.0) - 0.5;\n  result = result * (1.0 + tooth * 0.06 * mCanvasGrain());\n  result = saturate3(result, 1.04);\n\n  return mix(col0, result, clamp(mStrokeAmount(), 0.0, 1.0));\n}\n\n// \u2500\u2500 Metal \u2014 the two-term anisotropic BRDF (uMedium==8/9; the WGSL twin) \u2500\u2500\u2500\u2500\u2500\u2500\n// The field re-lights as warm folded metal: the luma HEIGHT field (the packed\n// structure-tensor gradient \u2192 the surface normal) catches an anisotropic Blinn streak\n// (brushed metal, running ALONG the coherent edge-tangent) plus a sharp crest, both\n// raked by the IN-STRUCT cursor-synth light (crosses to WGSL \u2014 never uLightDir). The\n// catch is the achromatic-warm anchor (never a cold chrome-blue). ZERO extra taps \u2014\n// the gradient is unpacked from the tensor's .w lane the caller already computed.\nconst METAL_CATCH_WARM: vec3<f32> = vec3<f32>(1.0, 0.97, 0.90);\nconst METAL_HEIGHT_SCALE: f32 = 2.2;\nconst METAL_LIGHT_Z: f32 = 0.55;\nconst METAL_IDLE_RAKE: vec2<f32> = vec2<f32>(0.32, 0.34);\nconst METAL_SHININESS_ANISO: f32 = 6.0;\nconst METAL_SHININESS_CREST: f32 = 40.0;\nconst METAL_COHERENCE_FLOOR: f32 = 0.22;\nconst METAL_BODY_FLOOR: f32 = 0.42;\nconst METAL_GRADIENT_FLATTEN: f32 = 0.55;\nconst METAL_SPARKLE_DENSITY: f32 = 240.0;\nconst METAL_SPARKLE_THRESH: f32 = 0.72;\nconst METAL_SPARKLE_AMP: f32 = 0.6;\n\nfn metalShade(baseCol: vec3<f32>, p: vec2<f32>, stf: vec4<f32>) -> vec3<f32> {\n  let tangent = stf.xy;\n  let A = stf.z;\n  let grad = unpackGrad(stf.w);\n  let N = normalize(vec3<f32>(grad * (METAL_HEIGHT_SCALE * mMetalHeightScale()), 1.0));\n  let V = vec3<f32>(0.0, 0.0, 1.0);\n  // Cursor-synth rake light (u.cursor is in-struct \u2014 crosses to WGSL).\n  let L = normalize(vec3<f32>((u.cursor.xy - p) + METAL_IDLE_RAKE, METAL_LIGHT_Z));\n  let H = normalize(L + V);\n  // Anisotropic streak \u2014 brushed metal along the edge-tangent.\n  let tH = dot(normalize(tangent), H.xy);\n  let sinTH = sqrt(clamp(1.0 - tH * tH, 0.0, 1.0));\n  let streak = pow(clamp(sinTH, 0.0, 1.0), METAL_SHININESS_ANISO);\n  let crest = pow(clamp(dot(N, H), 0.0, 1.0), METAL_SHININESS_CREST);\n  var spec = streak * crest;\n  spec = spec * smoothstep(0.0, METAL_COHERENCE_FLOOR, A);\n  // Technicolor valley base \u2014 the body keeps the FIELD hue; luma rides the relief.\n  let diff = clamp(dot(N, L), 0.0, 1.0);\n  let body = baseCol * (METAL_BODY_FLOOR + (1.0 - METAL_BODY_FLOOR) * diff);\n  return body + METAL_CATCH_WARM * (spec * clamp(mMetalPolish(), 0.0, 4.0));\n}\n\nfn mediumMetal(col: vec3<f32>, p: vec2<f32>, t: f32) -> vec3<f32> {\n  let stf = structureTensorField(p, t, flowField(p, t));\n  return metalShade(col, p, stf);\n}\n\n// metal-gradient (uMedium==9) \u2014 the SAME BRDF over a pre-flattened base + the\n// twinkle-in-place flake sparkle (position FIXED per cell, phase-animated, facing-gated).\nfn mediumMetalGradient(col: vec3<f32>, p: vec2<f32>, t: f32) -> vec3<f32> {\n  let stf = structureTensorField(p, t, flowField(p, t));\n  let flat = mix(col, vec3<f32>(dot(col, W_LUMA)), METAL_GRADIENT_FLATTEN);\n  var metal = metalShade(flat, p, stf);\n  let grad = unpackGrad(stf.w);\n  let facing = normalize(vec3<f32>(grad * (METAL_HEIGHT_SCALE * mMetalHeightScale()), 1.0)).z;\n  let cell = floor(p * METAL_SPARKLE_DENSITY);\n  let seed = hash21(cell);\n  let tw = pow(clamp(sin(t + seed * 6.2831853), 0.0, 1.0), 40.0);\n  let flakeGate = step(METAL_SPARKLE_THRESH, seed);\n  metal = metal + METAL_CATCH_WARM * (tw * flakeGate * clamp(facing, 0.0, 1.0) * METAL_SPARKLE_AMP);\n  return metal;\n}\n\n// \u2500\u2500 Medium dispatch (the WGSL twin of the GLSL main() if-ladder) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n// uMedium: 0 smooth \u00B7 1 pastel \u00B7 2 watercolor \u00B7 3 oil \u00B7 4 crayon \u00B7 5 vangogh \u00B7\n// 6 oil-pastel \u00B7 7 kuwahara \u00B7 8 metal \u00B7 9 metal-gradient. The cheap peer mediums\n// (pastel/watercolor/crayon) + kuwahara + metal port their own bodies; the\n// oil/vangogh/oil-pastel STROKE cascade renders the anisotropic-Kuwahara PAINTERLY\n// finish here (a real oil-paint read, never the smooth core \u2014 the \"NO FALLBACKS on\n// Safari\" mandate; the full per-dab Starry-Night stroke WGSL remains a separate\n// full-fidelity port).\nfn applyMedium(col: vec3<f32>, p: vec2<f32>, t: f32) -> vec3<f32> {\n  let medium = u.ints1.x;\n  if (medium == 1) { return mediumPastel(col, p, t); }\n  if (medium == 2) { return mediumWatercolor(col, p, t); }\n  if (medium == 4) { return mediumCrayon(col, p, t); }\n  // Metal uses both renderer paths; a fragment-only implementation is invisible on the\n  // WGSL primary. IDs 8 and 9 select metal and metal-gradient respectively.\n  if (medium == 8) { return mediumMetal(col, p, t); }\n  if (medium == 9) { return mediumMetalGradient(col, p, t); }\n  // oil(3), vangogh(5), oil-pastel(6), kuwahara(7) all render the painterly\n  // anisotropic-Kuwahara finish on the WGSL primary (the WebGL2 fallback carries the\n  // full per-dab stroke cascade for oil/vangogh/oil-pastel).\n  if (medium == 3 || medium == 5 || medium == 6 || medium == 7) {\n    return mediumKuwahara(col, p, t);\n  }\n  return col;\n}\n";