@mkbabb/glass-ui 6.0.0 → 7.0.0

package/dist/components/easing/composables/useEasingPicker.d.ts

@@ -1,12 +1,12 @@
 import { type ComputedRef, type Ref } from "vue";
-import { jumpTerms } from "@mkbabb/value.js";
+import { jumpTerms } from "@mkbabb/value.js/easing";
 /** The two curve-authoring modes — the two donor arms unified. */
 export type EasingPickerMode = "bezier" | "steps";
 /** A `(t: number) => number` easing callable — the value.js family shape. */
 export type EasingFn = (t: number) => number;
 /** The bezier control-point quad `[x1, y1, x2, y2]`. */
 export type BezierPoints = [number, number, number, number];
-/** A value.js step jump-term (`jump-start`/`end`/`both`/`none` + aliases). */
+/** A canonical CSS step jump term. */
 export type JumpTerm = (typeof jumpTerms)[number];
 /** The picker's v-model payload — the live curve callable + its re-parseable
  *  CSS literal + the mode, so a consumer can read back the authored curve. */
@@ -30,7 +30,7 @@ export interface UseEasingPickerOptions {
     initialPreset?: string;
     /** The initial step count (default 4). */
     initialSteps?: number;
-    /** The initial step term (default `"end"`). */
+    /** The initial step term (default `"jump-end"`). */
     initialTerm?: JumpTerm;
 }
 export interface UseEasingPickerReturn {
@@ -47,10 +47,7 @@ export interface UseEasingPickerReturn {
     easingFn: ComputedRef<EasingFn>;
     /** The complete re-parseable readout literal for the active mode. */
     readout: ComputedRef<string>;
-    /** Whether the steps-mode readout round-trips through value.js `parseSteps`
-     *  back to the live (n, term) — the boundary-law proof that the painted
-     *  staircase IS a re-parseable value.js literal, not a hand-rolled string
-     *  the catalogue cannot read back. `true` in bezier mode (no steps literal). */
+    /** Whether the authored readout round-trips through Value's CSS parser. */
     reparseOk: ComputedRef<boolean>;
     /** The full v-model payload (mode + css + fn + raw params). */
     value: ComputedRef<EasingPickerValue>;
@@ -71,7 +68,7 @@ export interface UseEasingPickerReturn {
     progress: Ref<number>;
     playing: Ref<boolean>;
     playbackState: ComputedRef<"idle" | "playing" | "complete">;
-    reducedMotion: Ref<boolean>;
+    reducedMotion: Readonly<Ref<boolean>>;
     playTravel: () => void;
     cancelTravel: () => void;
     stopTravel: () => void;

package/dist/components/easing/constants.d.ts

@@ -4,7 +4,7 @@ export declare const CUSTOM_PRESET: "custom";
 export declare const DEFAULT_BEZIER_PRESET: "ease-out-back";
 /** The default steps-mode jump count + term. */
 export declare const DEFAULT_STEP_COUNT = 4;
-export declare const DEFAULT_STEP_TERM: "end";
+export declare const DEFAULT_STEP_TERM: "jump-end";
 /** The steps-mode slider bounds. */
 export declare const STEP_COUNT_MIN = 1;
 export declare const STEP_COUNT_MAX = 12;

package/dist/components/expandable-container/ExpandableContainer.vue.d.ts

@@ -1,41 +1,21 @@
-import { type Surface } from "../_shared/useSurfaceAxis";
+import type { Surface } from "../_shared/axes";
 declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     buttonPosition?: "left" | "right";
-    /** Accessible name for the expand (fullscreen) button. */
     expandLabel?: string;
-    /** Accessible name for the collapse (exit fullscreen) button. */
     collapseLabel?: string;
-    /** Surface decoration register for the fullscreen overlay
-     *  (BA.W-SURFACE-AXIS) — `glass` (default) frosts over the page;
-     *  `opaque` is the solid-wall opt-out; `veil` the borderless plate. */
     surface?: Surface;
 } & {
-    /**
-     * Two-way `open` model so consumers can drive fullscreen externally
-     * (programmatic toggles, route-driven launches, etc.) while the corner
-     * buttons continue to operate without parent wiring.
-     */
     open?: boolean;
 }, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:open": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<{
     buttonPosition?: "left" | "right";
-    /** Accessible name for the expand (fullscreen) button. */
     expandLabel?: string;
-    /** Accessible name for the collapse (exit fullscreen) button. */
     collapseLabel?: string;
-    /** Surface decoration register for the fullscreen overlay
-     *  (BA.W-SURFACE-AXIS) — `glass` (default) frosts over the page;
-     *  `opaque` is the solid-wall opt-out; `veil` the borderless plate. */
     surface?: Surface;
 } & {
-    /**
-     * Two-way `open` model so consumers can drive fullscreen externally
-     * (programmatic toggles, route-driven launches, etc.) while the corner
-     * buttons continue to operate without parent wiring.
-     */
     open?: boolean;
 }> & Readonly<{
     "onUpdate:open"?: ((value: boolean) => any) | undefined;
@@ -49,10 +29,6 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
         expand: () => void;
         label: string;
     }) => any;
-} & {
-    default?: (props: {
-        fullscreen: boolean;
-    }) => any;
 } & {
     'fullscreen-chrome'?: (props: {
         collapse: () => void;

package/dist/components/expandable-container/styles.css

@@ -0,0 +1 @@
+.expandable-container { position: relative; } .expandable-container[data-state="expanded"] { position: fixed; inset: 0; z-index: var(--z-modal); display: flex; flex-direction: column; } .expandable-container__chrome { display: contents; } .expandable-container__chrome[hidden] { display: none; } .expandable-container [data-part="trigger"] { position: absolute; inset-block-start: 0.5rem; z-index: 1; display: inline-grid; min-inline-size: var(--control-h-md); min-block-size: var(--control-h-md); place-items: center; border: 1px solid color-mix(in srgb, var(--border) 40%, transparent); border-radius: var(--radius-button); background: color-mix(in srgb, var(--card) 70%, transparent); color: var(--muted-foreground); box-shadow: var(--shadow-sm); -webkit-backdrop-filter: var(--glass-blur-wash); backdrop-filter: var(--glass-blur-wash); transition: color var(--duration-fast) var(--ease-standard); } .expandable-container [data-part="trigger"][data-position="left"] { inset-inline-start: 0.5rem; } .expandable-container [data-part="trigger"][data-position="right"] { inset-inline-end: 0.5rem; } .expandable-container [data-part="trigger"]:hover { color: var(--foreground); } .expandable-container [data-part="trigger"]:focus-visible { outline: var(--focus-ring-width) solid var(--focus-ring-color); outline-offset: 2px; } .expandable-container[data-state="expanded"] [data-part="panel"] { min-block-size: 0; inline-size: 100%; block-size: 100%; } .expandable-container__icon { inline-size: var(--icon-sm); block-size: var(--icon-sm); } @media (prefers-reduced-motion: reduce) { .expandable-container [data-part="trigger"] { transition: none; } }

package/dist/components/fading-scroll/FadingScroll.vue.d.ts

@@ -5,6 +5,10 @@ type __VLS_Props = {
     fadeStart?: boolean;
     /** Feather the end edge while trailing overflow remains. Default `true`. */
     fadeEnd?: boolean;
+    /** Name the scroll port and expose it as a region. */
+    ariaLabel?: string;
+    /** Reference visible naming text and expose the scroll port as a region. */
+    ariaLabelledby?: string;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/components/fading-scroll/composables/useFadingScroll.d.ts

@@ -1,4 +1,7 @@
 import type { MaybeRef, Ref } from "vue";
+type RtlScrollType = "negative" | "positive-ascending" | "positive-descending";
+/** Normalize every browser RTL scrollLeft model to distance from inline-start. */
+export declare function normalizeHorizontalScrollLeft(scrollLeft: number, max: number, direction: string, type?: RtlScrollType): number;
 export interface UseFadingScrollOptions {
     /** Scroll axis. `"x"` reads scrollLeft/Width; `"y"` reads scrollTop/Height. Default `"x"`. */
     axis?: MaybeRef<"x" | "y">;
@@ -29,3 +32,4 @@ export interface UseFadingScrollControls {
  * @param target the scroll-port element (the same element the CSS customs apply to)
  */
 export declare function useFadingScroll(target: MaybeRef<HTMLElement | null>, options?: UseFadingScrollOptions): UseFadingScrollControls;
+export {};

package/dist/components/fading-scroll/constants.d.ts

@@ -1,6 +1,5 @@
 /**
- * The module-scope constants for the FadingScroll family — the colocation home
- * (`proof:colocation`) the dir owes once it carries a complex composable. Both
+ * Module-scope constants colocated with the FadingScroll family. Both
  * were promoted out of `composables/useFadingScroll.ts` verbatim.
  */
 /**

package/dist/components/fourier-field/FourierField.vue.d.ts

@@ -3,13 +3,12 @@ import { type BasisComponent } from "./math";
 import type { FourierFieldConfig } from "./constants";
 import type { RendererStatus } from "../../composables/glass/webgpu/rendererStatus";
 /**
- * FourierField — a Fourier epicycle field on the GPU substrate (BC.W-VIZ-FOURIER), a
+ * FourierField — a Fourier epicycle field on the GPU substrate, a
  * sibling primitive to Aurora, GooBlob, and DotFlowField. A chain of rotating circles
  * stacked tip-to-tail draws the reconstructing partial-sum curve; a glowing comet head
  * leads the fading trail. WebGPU-FIRST: the compute pass writes the partial-sum curve +
  * the epicycle chain tips, the fullscreen-fragment render pass composites the SDF field; a
- * WebGL2 GLSL twin is the genuinely-absent-tail fallback (the §E "WebGPU everywhere"
- * mandate — the Canvas2D renderer is RETIRED). It composes `useFourierField` → the
+ * WebGL2 GLSL twin is the fallback. It composes `useFourierField` with the
  * `createGpuSubstrate` picker over the ONE canvas lifecycle leaf (offscreen-pause, live-PRM
  * freeze, consumer-owned DPR) and the SHARED `usePointerVelocityField` (the pointer SCRUBS
  * the reconstruction).
@@ -17,8 +16,7 @@ import type { RendererStatus } from "../../composables/glass/webgpu/rendererStat
  * The DEFAULT palette is the warm-cream library identity (`--viz-fourier` warm-amber); a
  * demo Teal/cool preset stays demo-LOCAL (presets-in-consumers — never a library token).
  *
- * The `variant: "hero"|"final"` prop is RETIRED (BC.W-VIZ-FOURIER — the bundles fold into
- * config presets, MIGRATION row). An ambient-background consumer passes `color` (+ the
+ * Visual bundles live in config presets. An ambient-background consumer passes `color` and the
  * `colorResolver`) for a thin warm default preserving the recessive look; the studio passes
  * the full `config` + `spectrum` + `getPalette`.
  */

package/dist/components/fourier-field/composables/fourierFieldGLSetup.d.ts

@@ -11,7 +11,7 @@ export interface FourierGLSetupDeps {
     shouldContinue: () => boolean;
     onFrame?: (timeSec: number) => void;
     /**
-     * BG.W-FOURIER-BEAUTY B3 — the 2-D cursor FOLLOW (model-space center lean). Mirrors the
+     *  B3 — the 2-D cursor FOLLOW (model-space center lean). Mirrors the
      * WGSL arm exactly (both read the SAME uFit center) — parity-safe by construction.
      * `{x:0,y:0}` (ambient/PRM) is byte-identical to today.
      */

package/dist/components/fourier-field/composables/fourierFieldWGPUSetup.d.ts

@@ -16,7 +16,7 @@ export interface FourierWGPUSetupDeps {
     /** The per-frame pointer hook — useFourierField advances the shared pointer field here. */
     onFrame?: (timeSec: number) => void;
     /**
-     * BD.W-VIZ-BROKEN-FIX D6b — the 2-D cursor FOLLOW: a small MODEL-space offset added to
+     *  D6b — the 2-D cursor FOLLOW: a small MODEL-space offset added to
      * the view-fit center so the whole reconstruction LEANS toward the cursor (the spatial
      * "follow" beside D6a's velocity scrub). Reuses the EXISTING uFit center uniform (NO new
      * uniform, NO shader/bridge edit — parity-safe by construction, both arms read the same

package/dist/components/fourier-field/composables/useFourierField.d.ts

@@ -9,7 +9,7 @@ export interface UseFourierFieldOptions {
     getSpectrum: () => readonly BasisComponent[];
     /** Resolve the curve-color palette as OKLCh (the demo themes it; default warm-identity). */
     getPalette: () => OklchStop[];
-    /** When true, hold the deterministic best-frame and never advance (the capture / freeze lever). */
+    /** When true, hold the deterministic best-frame and never advance (the capture, freeze lever). */
     freeze?: () => boolean;
     /** The static deterministic best-frame parameter under `freeze`/PRM. Default 0.34. */
     frozenT?: number;
@@ -18,7 +18,7 @@ export interface UseFourierFieldOptions {
     /** `"capture"` → renderAt-only (the deterministic π capture path). Default `"live"`. */
     mode?: "live" | "capture";
     /**
-     * BI.W-FIELD-CORE — the route pointer BROADCASTER read (the SUBTLE-interactive background
+     * the route pointer BROADCASTER read (the SUBTLE-interactive background
      * register). A full-bleed `pointer-events:none` field cannot listen for its own pointer, so
      * an ambient consumer reads the route-level `useRoutePointer` and feeds the shared field
      * from here each frame (viewport-normalized ≈ host-normalized for a full-bleed field). The
@@ -41,14 +41,14 @@ export interface FourierFieldHandle {
     resume: () => void;
     /** Re-arm a parked loop on demand. */
     wake: () => void;
-    /** Draw one frame out-of-loop (capture / thumbnail). */
+    /** Draw one frame out-of-loop (capture, thumbnail). */
     renderAt: (timeSec: number) => void;
     /** The live `prefers-reduced-motion: reduce` state. */
     readonly reducedMotion: boolean;
     /** The current loop parameter `head_t ∈ [0,1)` (the scrubber reads/writes it). */
     readonly headT: number;
     readonly rendererStatus: Readonly<Ref<RendererStatus>>;
-    /** Scrub the clock directly (the transport scrubber / a pointer drag). */
+    /** Scrub the clock directly (the transport scrubber, a pointer drag). */
     setHeadT: (t: number) => void;
     /** Tear down the renderer + release GPU/GL resources. */
     dispose: () => void;

package/dist/components/fourier-field/constants.d.ts

@@ -22,10 +22,10 @@ export declare const MAX_CURVE_SAMPLES = 384;
 /** The palette-stop ceiling — the WGSL `MAX_FOURIER_STOPS` #define. */
 export declare const MAX_FOURIER_STOPS = 4;
 /**
- * The cursor-velocity → head_t clock-coupling gain (BD.W-VIZ-BROKEN-FIX D6 — the weighted
- * scrub). The cursor MOTION (not its absolute X) nudges the loop clock: a flick fast-
+ * The cursor-velocity → head_t clock-coupling gain. Cursor motion (not absolute X)
+ * nudges the loop clock: a flick fast-
  * forwards, a still cursor lets the field drift at its config speed. Velocity-continuous —
- * the head never teleports (the prior `headT = pointerX` absolute-X scrub read as "not
+ * the head never teleports (an absolute-X `headT = pointerX` scrub reads as "not
  * following" a 2-D cursor).
  */
 export declare const SCRUB_GAIN = 0.15;
@@ -35,7 +35,7 @@ export declare const SCRUB_GAIN = 0.15;
  * of it. The taper is `f(age) = RIBBON_TAIL_FRAC + (1 − RIBBON_TAIL_FRAC)·age` (LINEAR, so the
  * age-0.5 MID-BODY is `RIBBON_TAIL_FRAC + (1 − RIBBON_TAIL_FRAC)·0.5` of the head). Declared
  * ONCE here + MIRRORED verbatim as the `RIBBON_TAIL_FRAC` const in BOTH shaders (the GLSL twin
- * cannot import a TS constant); `proof:viz` FB1 cross-checks the three copies are equal so the
+ * cannot import a TS constant); keep the three copies equal so the
  * mid-body floor below can never drift off the taper.
  */
 export declare const RIBBON_TAIL_FRAC = 0.4;
@@ -55,7 +55,7 @@ export declare const RIBBON_MID_FLOOR_PX = 2.5;
  */
 export declare const RIBBON_HEAD_FLOOR_PX: number;
 /**
- * The degenerate-tangent guard (BD.W-FOURIER-LOOM §2b). At a cusp the head's instantaneous
+ * The degenerate-tangent guard ( §2b). At a cusp the head's instantaneous
  * speed `s = length(head − headBack)` collapses to ~0 and the unit tangent `T = d/s` blows
  * up; below `FOURIER_TANGENT_EPS` the shaders + the GL CPU bead path all fall back to the
  * LAST stable tangent, so `s→0` resolves IDENTICALLY across both engines (the cross-engine
@@ -63,7 +63,7 @@ export declare const RIBBON_HEAD_FLOOR_PX: number;
  */
 export declare const FOURIER_TANGENT_EPS = 0.0001;
 /**
- * The head squash-and-stretch gain (BD.W-FOURIER-LOOM §2b). The round head bead becomes a
+ * The head squash-and-stretch gain ( §2b). The round head bead becomes a
  * volume-preserving anisotropic ellipse: the tangent extent scales `1 + k·ŝ`, the normal
  * extent `1/(1 + k·ŝ)`, where `ŝ` is the normalized head speed. The library identity carries
  * a SMALL non-zero gain (cartoon-weight at rest — the head is never a dead disc); a consumer
@@ -71,7 +71,7 @@ export declare const FOURIER_TANGENT_EPS = 0.0001;
  */
 export declare const FOURIER_SQUASH_GAIN = 0.55;
 /**
- * The cartoon cel-shadow gain (BD.W-FOURIER-LOOM §3b). Each chain ring/arm/dot + the comet
+ * The cartoon cel-shadow gain ( §3b). Each chain ring/arm/dot + the comet
  * rope paints a second darker copy OFFSET opposite its travel — the 1940s technicolor ink.
  * The library identity carries a SMALL non-zero gain (a quiet weight under the chain); a
  * consumer vivid preset floors it UP. `0` = no cel pass (byte-frozen). The offset rides the
@@ -107,17 +107,17 @@ export interface FourierFieldConfig {
     palette: OklchStop[];
     /** ONE static frame then park under `prefers-reduced-motion: reduce`. */
     respectReducedMotion: boolean;
-    /** Pointer scrubs `head_t` + a flick injects clock momentum (the W-VIZ-INTERACTION consume). */
+    /** Pointer scrubs `head_t` + a flick injects clock momentum (the consume). */
     interactive: boolean;
     /**
-     * Head squash-and-stretch gain (BD.W-FOURIER-LOOM §2b). The head bead stretches along the
+     * Head squash-and-stretch gain ( §2b). The head bead stretches along the
      * curve tangent on straights, squashes across it on corners (volume-preserving). The
      * library identity carries a small non-zero default (cartoon-weight at rest); a vivid
      * consumer preset turns it to 11. 0 = the byte-frozen round disc.
      */
     squashGain: number;
     /**
-     * Cartoon cel-shadow gain (BD.W-FOURIER-LOOM §3b). A second darker copy of the chain + rope,
+     * Cartoon cel-shadow gain ( §3b). A second darker copy of the chain + rope,
      * offset opposite the head travel (the technicolor ink). The library identity carries a
      * small non-zero default; a vivid consumer preset floors it UP. 0 = no cel pass.
      */

package/dist/components/fourier-field/index.d.ts

@@ -7,9 +7,9 @@ export { DEFAULT_FOURIER_CONFIG, WARM_IDENTITY_PALETTE, MAX_PHASORS, MAX_CURVE_S
 export { useFourierField, type FourierFieldHandle, type UseFourierFieldOptions, } from "./composables/useFourierField";
 /**
  * The props a consumer forwards when wrapping `<FourierField>` (the GPU-substrate epicycle
- * field; ships via `/fourier-field`). Mirrors the component's inline `defineProps` shape (an
- * SFC cannot export its inline props type). BC.W-VIZ-FOURIER — the `variant: "hero"|"final"`
- * enum is RETIRED (folds into config presets); the renderer is the WGSL-primary GPU substrate.
+ * field; ships via `/fourier-field`). Mirrors the component's inline `defineProps` shape because
+ * an SFC cannot export its inline props type. Visual bundles live in config presets; the
+ * renderer is the WGSL-primary GPU substrate.
  */
 export interface FourierFieldProps {
     /** The full author config (the studio's `useConfiguratorState` model). Defaults to the warm identity. */

package/dist/components/fourier-field/presets.d.ts

@@ -17,10 +17,10 @@ export interface VariantPreset {
     /** The parameter `t` of the static best-frame painted under `freeze`. */
     frozenT: number;
     /** Comet-trail PEAK alpha (the head segment). The reference trail rides ~0.9
-     *  near-opaque — present, not the prior 0.45 hairline whisper. */
+     *  near-opaque — present, not a 0.45 hairline whisper. */
     peakAlpha: number;
     /** Trail stroke weight in CSS px (the reference is a BOLD 3.5px stroke, not
-     *  the prior 1.6 hairline). The single biggest faintness lever. */
+     *  a 1.6 hairline). The single biggest faintness lever. */
     trailWidth: number;
     /** Head-glow alpha — the STRONGEST layer (head-forward: > peakAlpha). */
     headGlowAlpha: number;
@@ -30,7 +30,7 @@ export interface VariantPreset {
      *  saturated core + white highlight + soft halo). 0 disables it. */
     headDotRadius: number;
     /** Epicycle scaffolding alphas ÷ peak (hero only; {0,0} disables the scaffold).
-     *  The reference circles/arms are PRESENT (≈0.5/0.75), not the prior 0.18 ghost. */
+     *  The reference circles/arms are PRESENT (≈0.5/0.75), not a 0.18 ghost. */
     epicycleRatios: {
         circle: number;
         arm: number;

package/dist/components/fourier-field/shaders/fourier-field.glsl.d.ts

@@ -1,4 +1,4 @@
 /** The instanced ribbon VERTEX — expands the unit quad to each instance's covered bbox. */
-export declare const FOURIER_FIELD_VERT_GLSL = "#version 300 es\n// BI.W-FOURIER-RIBBON \u00A72b \u2014 MUST equal the WGSL twin + FOURIER_TANGENT_EPS (constants.ts).\n#define RIBBON_UNDERGLOW_SCALE 2.2\n\nin vec2 aCorner;   // the unit quad corner \u2208 [0,1]\u00B2\nin vec4 aSeg;      // (ax, ay, bx, by) \u2014 segment endpoints in MODEL space\nin vec4 aData;     // (age, strokeHalf, arg2, _pad) \u2014 strokeHalf/age/arg2 per layer\n\nuniform vec4 uFit;         // (centerX, centerY, scale, aspect) \u2014 model\u2192clip fit\nuniform int  uLayer;       // 0 trail \u00B7 1 epicycle \u00B7 2 head \u00B7 3 cel-rope \u00B7 4 cel-arm\nuniform float uEdgeMargin; // AA-feather slop in MODEL units (a few CSS px), padding the bbox\n\nout vec2 vP;       // the MODEL-space fragment coordinate (the fs runs the SDF on it)\nout vec2 vA;\nout vec2 vB;\nout float vAge;\nout float vHalf;\nout float vArg2;\n\nvoid main() {\n  vec2 a = aSeg.xy;\n  vec2 b = aSeg.zw;\n  float strokeHalf = aData.y;\n  vA = a; vB = b; vAge = aData.x; vHalf = strokeHalf; vArg2 = aData.z;\n\n  vec2 pos;\n  if (uLayer == 1 || uLayer == 2) {\n    // AABB around a \u2014 the epicycle orbit RING (radius = |b-a|) or the head HALO.\n    float ext = (uLayer == 1) ? (length(b - a) + strokeHalf * 0.7) : (strokeHalf * 4.5);\n    ext += uEdgeMargin;\n    pos = a + (aCorner * 2.0 - 1.0) * ext;\n  } else {\n    // Capsule along a\u2192b padded by the covered extent (trail under-glow / cel stroke).\n    float ext = (uLayer == 0) ? (strokeHalf * RIBBON_UNDERGLOW_SCALE) : strokeHalf;\n    ext += uEdgeMargin;\n    vec2 d = b - a;\n    float len = length(d);\n    vec2 dir = len > 1e-6 ? d / len : vec2(1.0, 0.0);\n    vec2 perp = vec2(-dir.y, dir.x);\n    vec2 along = mix(a - dir * ext, b + dir * ext, aCorner.x);\n    pos = along + perp * (aCorner.y * 2.0 - 1.0) * ext;\n  }\n\n  vP = pos;\n  vec2 center = uFit.xy;\n  float scale = max(uFit.z, 1e-6);\n  float aspect = max(uFit.w, 1e-4);\n  // model \u2192 clip (the inverse of the fs's p = center + vClip\u00B7aspect / scale).\n  float clipX = (pos.x - center.x) * scale / aspect;\n  float clipY = (pos.y - center.y) * scale;\n  gl_Position = vec4(clipX, clipY, 0.0, 1.0);\n}\n";
+export declare const FOURIER_FIELD_VERT_GLSL = "#version 300 es\n// Must equal the WGSL twin and FOURIER_TANGENT_EPS in constants.ts.\n#define RIBBON_UNDERGLOW_SCALE 2.2\n\nin vec2 aCorner;   // the unit quad corner \u2208 [0,1]\u00B2\nin vec4 aSeg;      // (ax, ay, bx, by) \u2014 segment endpoints in MODEL space\nin vec4 aData;     // (age, strokeHalf, arg2, _pad) \u2014 strokeHalf/age/arg2 per layer\n\nuniform vec4 uFit;         // (centerX, centerY, scale, aspect) \u2014 model\u2192clip fit\nuniform int  uLayer;       // 0 trail \u00B7 1 epicycle \u00B7 2 head \u00B7 3 cel-rope \u00B7 4 cel-arm\nuniform float uEdgeMargin; // AA-feather slop in MODEL units (a few CSS px), padding the bbox\n\nout vec2 vP;       // the MODEL-space fragment coordinate (the fs runs the SDF on it)\nout vec2 vA;\nout vec2 vB;\nout float vAge;\nout float vHalf;\nout float vArg2;\n\nvoid main() {\n  vec2 a = aSeg.xy;\n  vec2 b = aSeg.zw;\n  float strokeHalf = aData.y;\n  vA = a; vB = b; vAge = aData.x; vHalf = strokeHalf; vArg2 = aData.z;\n\n  vec2 pos;\n  if (uLayer == 1 || uLayer == 2) {\n    // AABB around a \u2014 the epicycle orbit RING (radius = |b-a|) or the head HALO.\n    float ext = (uLayer == 1) ? (length(b - a) + strokeHalf * 0.7) : (strokeHalf * 4.5);\n    ext += uEdgeMargin;\n    pos = a + (aCorner * 2.0 - 1.0) * ext;\n  } else {\n    // Capsule along a\u2192b padded by the covered extent (trail under-glow, cel stroke).\n    float ext = (uLayer == 0) ? (strokeHalf * RIBBON_UNDERGLOW_SCALE) : strokeHalf;\n    ext += uEdgeMargin;\n    vec2 d = b - a;\n    float len = length(d);\n    vec2 dir = len > 1e-6 ? d / len : vec2(1.0, 0.0);\n    vec2 perp = vec2(-dir.y, dir.x);\n    vec2 along = mix(a - dir * ext, b + dir * ext, aCorner.x);\n    pos = along + perp * (aCorner.y * 2.0 - 1.0) * ext;\n  }\n\n  vP = pos;\n  vec2 center = uFit.xy;\n  float scale = max(uFit.z, 1e-6);\n  float aspect = max(uFit.w, 1e-4);\n  // model \u2192 clip (the inverse of the fs's p = center + vClip\u00B7aspect, scale).\n  float clipX = (pos.x - center.x) * scale / aspect;\n  float clipY = (pos.y - center.y) * scale;\n  gl_Position = vec4(clipX, clipY, 0.0, 1.0);\n}\n";
 /** The instanced ribbon FRAGMENT — the exact per-layer SDF over-composite, loop-free. */
-export declare const FOURIER_FIELD_FRAG_GLSL = "#version 300 es\nprecision highp float;\n\n#define MAX_FOURIER_STOPS 4\n// BD.W-FOURIER-LOOM \u00A72b \u2014 MUST equal the WGSL twin + FOURIER_TANGENT_EPS (constants.ts).\n#define TANGENT_EPS 1e-4\n#define SPEED_REF_HALFWIDTHS 6.0\n// BG.W-FOURIER-BEAUTY B1 \u2014 the THICK luminous RIBBON. RIBBON_TAIL_FRAC is MIRRORED verbatim\n// from constants.ts (the GLSL twin cannot import a TS const); proof:viz FB1 cross-checks the\n// two copies are equal so the mid-body floor (RIBBON_HEAD_FLOOR_PX) can never drift off it.\n#define RIBBON_TAIL_FRAC 0.4\n#define RIBBON_UNDERGLOW_SCALE 2.2\n#define RIBBON_UNDERGLOW_ALPHA 0.16\n\nin vec2 vP;\nin vec2 vA;\nin vec2 vB;\nin float vAge;\nin float vHalf;\nin float vArg2;\nout vec4 fragColor;\n\nuniform vec4 uTrail;      // (trailWidth, peakAlpha, headGlowAlpha, trailFadeExp)\nuniform vec4 uEnv;        // (trailFloor, intensity, showEpicycles, rainbowChain)\nuniform vec4 uLoom;       // (squashGain, celGain, _pad, _pad) \u2014 FOURIER-LOOM \u00A72b/\u00A73b\nuniform int  uLayer;      // 0 trail \u00B7 1 epicycle \u00B7 2 head \u00B7 3 cel-rope \u00B7 4 cel-arm\nuniform int  uStopCount;\nuniform vec3 uPalette[MAX_FOURIER_STOPS]; // linear-sRGB stops\n\nconst float PI = 3.141592653589793;\n\n\nfloat srgbToLinearCh(float c) {\n    return c <= 0.04045 ? c / 12.92 : pow((c + 0.055) / 1.055, 2.4);\n}\nvec3 srgbToLinear(vec3 c) {\n    return vec3(srgbToLinearCh(c.r), srgbToLinearCh(c.g), srgbToLinearCh(c.b));\n}\n\nfloat linearToSrgbCh(float c) {\n    return c <= 0.0031308 ? c * 12.92 : 1.055 * pow(c, 1.0 / 2.4) - 0.055;\n}\nvec3 linearToSrgb(vec3 c) {\n    return vec3(linearToSrgbCh(c.r), linearToSrgbCh(c.g), linearToSrgbCh(c.b));\n}\n\n// value.js LINEAR_SRGB_TO_LMS (constants.ts), row-major; written here as GLSL\n// columns (= the transpose) so mat3 * vec3 evaluates the row-major M\u00B7v.\nconst mat3 LINEAR_SRGB_TO_LMS = mat3(\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 (gamut.ts lines 295-297 \u2014\n// these differ at the ~1e-9 digit from LMS_TO_OKLAB_MATRIX; use the inline ones to\n// mirror the exact value.js path), row-major \u2192 GLSL columns.\nconst mat3 LMS_TO_OKLAB = mat3(\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 (constants.ts), row-major \u2192 GLSL columns. Rows:\n// l = [1, 0.3963377774, 0.2158037573], m = [1, -0.1055613458, -0.0638541728],\n// s = [1, -0.0894841775, -1.2914855480].\nconst mat3 OKLAB_TO_LMS = mat3(\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 (constants.ts), row-major \u2192 GLSL columns.\nconst mat3 LMS_TO_LINEAR_SRGB = mat3(\n    4.0767416621, -1.2684380046, -0.0041960863,\n    -3.3077115913, 2.6097574011, -0.7034186147,\n    0.2309699292, -0.3413193965, 1.7076147010\n);\n\n// Gamma sRGB \u2192 raw OKLab (L, a, b). Mirrors value.js srgbToOKLab.\nvec3 srgbToOklab(vec3 c) {\n    vec3 lin = srgbToLinear(c);\n    vec3 lms = LINEAR_SRGB_TO_LMS * lin;\n    vec3 lmsCbrt = sign(lms) * pow(abs(lms), vec3(1.0 / 3.0));\n    return LMS_TO_OKLAB * lmsCbrt;\n}\n\n// Raw OKLab (L, a, b) \u2192 linear sRGB. Mirrors value.js oklabToLinearSRGB.\nvec3 oklabToLinearSrgb(vec3 lab) {\n    vec3 lms_ = OKLAB_TO_LMS * lab;\n    vec3 lms = lms_ * lms_ * lms_;\n    return LMS_TO_LINEAR_SRGB * lms;\n}\n\n// OKLab \u2192 OKLCh: H in RADIANS. Mirrors value.js rawOklabToOklch (which returns\n// degrees; we stay in radians and only fold to [0, 2pi)).\nvec3 oklabToOklch(vec3 lab) {\n    float C = length(lab.yz);\n    float H = atan(lab.z, lab.y);\n    if (H < 0.0) H += 2.0 * PI;\n    return vec3(lab.x, C, H);\n}\n\n// OKLCh (H radians) \u2192 OKLab. Mirrors value.js rawOklchToOklab.\nvec3 oklchToOklab(vec3 lch) {\n    return vec3(lch.x, lch.y * cos(lch.z), lch.y * sin(lch.z));\n}\n\n// Negative-safe cube root (the WGSL chunk's cbrt3 twin; the GLSL chunk inlines it).\nvec3 cbrt3(vec3 v) { return sign(v) * pow(abs(v), vec3(1.0 / 3.0)); }\n\nvec3 samplePaletteLin(float t) {\n  if (uStopCount <= 1) return uPalette[0];\n  float n = float(uStopCount);\n  float ft = clamp(t, 0.0, 1.0) * (n - 1.0);\n  int i0 = int(floor(ft));\n  int i1 = min(i0 + 1, uStopCount - 1);\n  float f = ft - float(i0);\n  vec3 labA = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * uPalette[i0]);\n  vec3 labB = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * uPalette[i1]);\n  return oklabToLinearSrgb(mix(labA, labB, f));\n}\n\nvec3 chainColorLin(float seg, bool rainbow) {\n  vec3 baseLin = uPalette[0];\n  if (!rainbow) return baseLin;\n  vec3 lab = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * baseLin);\n  vec3 lch = oklabToOklch(lab);\n  float hueShift = mix(-0.45, 1.15, clamp(seg, 0.0, 1.0));\n  vec3 lifted = vec3(0.66, max(lch.y, 0.14), lch.z + hueShift);\n  return oklabToLinearSrgb(oklchToOklab(lifted));\n}\n\nfloat segDist(vec2 p, vec2 a, vec2 b) {\n  vec2 pa = p - a;\n  vec2 ba = b - a;\n  float h = clamp(dot(pa, ba) / max(dot(ba, ba), 1e-8), 0.0, 1.0);\n  return length(pa - ba * h);\n}\n\n// BD.W-FOURIER-LOOM \u00A72b \u2014 the head travel frame (T, \u015D), the GLSL twin of the WGSL headFrame.\nstruct HeadFrame { vec2 T; float sHat; };\nHeadFrame headFrame(vec2 head, vec2 headBack, float halfW) {\n  vec2 d = head - headBack;\n  float s = length(d);\n  HeadFrame fr;\n  if (s <= TANGENT_EPS) { fr.T = vec2(1.0, 0.0); fr.sHat = 0.0; return fr; }\n  fr.T = d / s;\n  float refScale = max(halfW * SPEED_REF_HALFWIDTHS, 1e-6);\n  fr.sHat = clamp(s / refScale, 0.0, 1.0);\n  return fr;\n}\n\n// The volume-preserving anisotropic head distance (the WGSL headAniso twin).\nfloat headAniso(vec2 p, vec2 head, HeadFrame fr, float k) {\n  float g = 1.0 + k * fr.sHat;\n  vec2 n = vec2(-fr.T.y, fr.T.x);\n  vec2 rel = p - head;\n  float along = dot(rel, fr.T) / g;\n  float across = dot(rel, n) * g;\n  return length(vec2(along, across));\n}\n\nvoid main() {\n  vec2 p = vP;\n  float aa = max(fwidth(p.x) + fwidth(p.y), 1e-5) * 0.75;\n  float peak = uTrail.y * uEnv.y;\n  float headGlow = uTrail.z * uEnv.y;\n  float fadeExp = uTrail.w;\n  float trailFloor = uEnv.x;\n  bool rainbow = uEnv.w > 0.5;\n  float squashGain = uLoom.x;\n  float celGain = uLoom.y;\n  float halfW = vHalf;\n\n  if (uLayer == 0) {\n    // \u2500\u2500 TRAIL \u2014 the tapered luminous ribbon over its own soft under-glow \u2500\u2500\n    float age = vAge;\n    float d = segDist(p, vA, vB);\n    // B1 \u2014 the head\u2192tail TAPER: the ribbon half-width scales with age (thick head, thin tail).\n    float ribbonHalf = halfW * (RIBBON_TAIL_FRAC + (1.0 - RIBBON_TAIL_FRAC) * age);\n    vec3 lin = samplePaletteLin(1.0 - age * 0.4);\n    vec3 rgb = clamp(linearToSrgb(lin), vec3(0.0), vec3(1.0));\n    // B1 \u2014 the soft UNDER-GLOW: a wider, low-alpha copy UNDER the crisp ribbon (ONE color event).\n    float glowHalf = ribbonHalf * RIBBON_UNDERGLOW_SCALE;\n    float glowCover = 1.0 - smoothstep(glowHalf, glowHalf + aa * 3.0, d);\n    float ga = peak * RIBBON_UNDERGLOW_ALPHA * pow(age, fadeExp) * glowCover;\n    // the crisp tapered ribbon core.\n    float cover = 1.0 - smoothstep(ribbonHalf, ribbonHalf + aa, d);\n    float ca = max(peak * pow(age, fadeExp), peak * trailFloor) * cover;\n    // core OVER glow OVER transparent (both premultiplied on the SAME rgb \u2192 out = rgb\u00B7outA).\n    float outA = ca + ga * (1.0 - ca);\n    fragColor = vec4(rgb * outA, outA);\n  } else if (uLayer == 1) {\n    // \u2500\u2500 EPICYCLE \u2014 orbit RING + ARM + joint DOT union (MAX-blended, no join seam) \u2500\u2500\n    float seg = vArg2;\n    vec3 lin = chainColorLin(seg, rainbow);\n    vec3 rgb = clamp(linearToSrgb(lin), vec3(0.0), vec3(1.0));\n    float radius = length(vB - vA);\n    float dRing = abs(length(p - vA) - radius);\n    float ringW = max(halfW * 0.45, aa);\n    float ringMask = (1.0 - smoothstep(ringW, ringW + aa, dRing)) * 0.5;\n    float dArm = segDist(p, vA, vB);\n    float armMask = 1.0 - smoothstep(halfW * 0.55, halfW * 0.55 + aa, dArm);\n    float dotR = max(halfW * 0.7, aa * 2.0);\n    float dDot = length(p - vA);\n    float dotMask = 1.0 - smoothstep(dotR, dotR + aa, dDot);\n    float m = clamp(max(max(ringMask, armMask), dotMask), 0.0, 1.0) * peak * 0.7;\n    fragColor = vec4(rgb * m, m);\n  } else if (uLayer == 2) {\n    // \u2500\u2500 HEAD \u2014 squash-and-stretch (\u00A72b): halo + saturated core + white specular \u2500\u2500\n    vec2 head = vA;\n    vec2 headBack = vB;\n    HeadFrame fr = headFrame(head, headBack, halfW);\n    float dHead = headAniso(p, head, fr, squashGain);\n    float coreR = halfW * 1.5;\n    float haloR = coreR * 3.0;\n    vec3 headRgb = clamp(linearToSrgb(samplePaletteLin(0.0)), vec3(0.0), vec3(1.0));\n    float halo = (1.0 - smoothstep(0.0, haloR, dHead)) * headGlow * 0.35;\n    vec4 accum = vec4(headRgb * halo, halo);\n    float core = (1.0 - smoothstep(coreR, coreR + aa, dHead)) * headGlow;\n    accum = vec4(headRgb * core, core) + accum * (1.0 - core);\n    float spec = (1.0 - smoothstep(coreR * 0.4, coreR * 0.4 + aa, dHead)) * headGlow * 0.9;\n    accum = vec4(vec3(1.0) * spec, spec) + accum * (1.0 - spec);\n    fragColor = accum;\n  } else {\n    // \u2500\u2500 CEL \u2014 the technicolor ink shadow (rope uLayer==3 / arm uLayer==4) \u2500\u2500\n    float celA = clamp(celGain, 0.0, 1.0);\n    float d = segDist(p, vA, vB);\n    float cover = 1.0 - smoothstep(halfW, halfW + aa, d);\n    float m = cover * celA * peak * vArg2; // vArg2 = celStrength (1.0 rope / 0.7 arm)\n    fragColor = vec4(0.0, 0.0, 0.0, m);\n  }\n}\n";
+export declare const FOURIER_FIELD_FRAG_GLSL = "#version 300 es\nprecision highp float;\n\n#define MAX_FOURIER_STOPS 4\n// Must equal the WGSL twin and FOURIER_TANGENT_EPS in constants.ts.\n#define TANGENT_EPS 1e-4\n#define SPEED_REF_HALFWIDTHS 6.0\n// The thick luminous ribbon mirrors RIBBON_TAIL_FRAC verbatim\n// from constants.ts because the GLSL twin cannot import a TS const; parity coverage verifies the\n// two copies are equal so the mid-body floor (RIBBON_HEAD_FLOOR_PX) can never drift off it.\n#define RIBBON_TAIL_FRAC 0.4\n#define RIBBON_UNDERGLOW_SCALE 2.2\n#define RIBBON_UNDERGLOW_ALPHA 0.16\n\nin vec2 vP;\nin vec2 vA;\nin vec2 vB;\nin float vAge;\nin float vHalf;\nin float vArg2;\nout vec4 fragColor;\n\nuniform vec4 uTrail;      // (trailWidth, peakAlpha, headGlowAlpha, trailFadeExp)\nuniform vec4 uEnv;        // (trailFloor, intensity, showEpicycles, rainbowChain)\nuniform vec4 uLoom;       // (squashGain, celGain, _pad, _pad) \u2014 FOURIER-LOOM \u00A72b/\u00A73b\nuniform int  uLayer;      // 0 trail \u00B7 1 epicycle \u00B7 2 head \u00B7 3 cel-rope \u00B7 4 cel-arm\nuniform int  uStopCount;\nuniform vec3 uPalette[MAX_FOURIER_STOPS]; // linear-sRGB stops\n\nconst float PI = 3.141592653589793;\n\n\nfloat srgbToLinearCh(float c) {\n    return c <= 0.04045 ? c / 12.92 : pow((c + 0.055) / 1.055, 2.4);\n}\nvec3 srgbToLinear(vec3 c) {\n    return vec3(srgbToLinearCh(c.r), srgbToLinearCh(c.g), srgbToLinearCh(c.b));\n}\n\nfloat linearToSrgbCh(float c) {\n    return c <= 0.0031308 ? c * 12.92 : 1.055 * pow(c, 1.0 / 2.4) - 0.055;\n}\nvec3 linearToSrgb(vec3 c) {\n    return vec3(linearToSrgbCh(c.r), linearToSrgbCh(c.g), linearToSrgbCh(c.b));\n}\n\n// value.js LINEAR_SRGB_TO_LMS (constants.ts), row-major; written here as GLSL\n// columns (= the transpose) so mat3 * vec3 evaluates the row-major M\u00B7v.\nconst mat3 LINEAR_SRGB_TO_LMS = mat3(\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 (gamut.ts lines 295-297 \u2014\n// these differ at the ~1e-9 digit from LMS_TO_OKLAB_MATRIX; use the inline ones to\n// mirror the exact value.js path), row-major \u2192 GLSL columns.\nconst mat3 LMS_TO_OKLAB = mat3(\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 (constants.ts), row-major \u2192 GLSL columns. Rows:\n// l = [1, 0.3963377774, 0.2158037573], m = [1, -0.1055613458, -0.0638541728],\n// s = [1, -0.0894841775, -1.2914855480].\nconst mat3 OKLAB_TO_LMS = mat3(\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 (constants.ts), row-major \u2192 GLSL columns.\nconst mat3 LMS_TO_LINEAR_SRGB = mat3(\n    4.0767416621, -1.2684380046, -0.0041960863,\n    -3.3077115913, 2.6097574011, -0.7034186147,\n    0.2309699292, -0.3413193965, 1.7076147010\n);\n\n// Gamma sRGB \u2192 raw OKLab (L, a, b). Mirrors value.js srgbToOKLab.\nvec3 srgbToOklab(vec3 c) {\n    vec3 lin = srgbToLinear(c);\n    vec3 lms = LINEAR_SRGB_TO_LMS * lin;\n    vec3 lmsCbrt = sign(lms) * pow(abs(lms), vec3(1.0 / 3.0));\n    return LMS_TO_OKLAB * lmsCbrt;\n}\n\n// Raw OKLab (L, a, b) \u2192 linear sRGB. Mirrors value.js oklabToLinearSRGB.\nvec3 oklabToLinearSrgb(vec3 lab) {\n    vec3 lms_ = OKLAB_TO_LMS * lab;\n    vec3 lms = lms_ * lms_ * lms_;\n    return LMS_TO_LINEAR_SRGB * lms;\n}\n\n// OKLab \u2192 OKLCh: H in RADIANS. Mirrors value.js rawOklabToOklch (which returns\n// degrees; we stay in radians and only fold to [0, 2pi)).\nvec3 oklabToOklch(vec3 lab) {\n    float C = length(lab.yz);\n    float H = atan(lab.z, lab.y);\n    if (H < 0.0) H += 2.0 * PI;\n    return vec3(lab.x, C, H);\n}\n\n// OKLCh (H radians) \u2192 OKLab. Mirrors value.js rawOklchToOklab.\nvec3 oklchToOklab(vec3 lch) {\n    return vec3(lch.x, lch.y * cos(lch.z), lch.y * sin(lch.z));\n}\n\n// Negative-safe cube root (the WGSL chunk's cbrt3 twin; the GLSL chunk inlines it).\nvec3 cbrt3(vec3 v) { return sign(v) * pow(abs(v), vec3(1.0 / 3.0)); }\n\nvec3 samplePaletteLin(float t) {\n  if (uStopCount <= 1) return uPalette[0];\n  float n = float(uStopCount);\n  float ft = clamp(t, 0.0, 1.0) * (n - 1.0);\n  int i0 = int(floor(ft));\n  int i1 = min(i0 + 1, uStopCount - 1);\n  float f = ft - float(i0);\n  vec3 labA = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * uPalette[i0]);\n  vec3 labB = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * uPalette[i1]);\n  return oklabToLinearSrgb(mix(labA, labB, f));\n}\n\nvec3 chainColorLin(float seg, bool rainbow) {\n  vec3 baseLin = uPalette[0];\n  if (!rainbow) return baseLin;\n  vec3 lab = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * baseLin);\n  vec3 lch = oklabToOklch(lab);\n  float hueShift = mix(-0.45, 1.15, clamp(seg, 0.0, 1.0));\n  vec3 lifted = vec3(0.66, max(lch.y, 0.14), lch.z + hueShift);\n  return oklabToLinearSrgb(oklchToOklab(lifted));\n}\n\nfloat segDist(vec2 p, vec2 a, vec2 b) {\n  vec2 pa = p - a;\n  vec2 ba = b - a;\n  float h = clamp(dot(pa, ba) / max(dot(ba, ba), 1e-8), 0.0, 1.0);\n  return length(pa - ba * h);\n}\n\n// The head travel frame (T, \u015D), the GLSL twin of the WGSL headFrame.\nstruct HeadFrame { vec2 T; float sHat; };\nHeadFrame headFrame(vec2 head, vec2 headBack, float halfW) {\n  vec2 d = head - headBack;\n  float s = length(d);\n  HeadFrame fr;\n  if (s <= TANGENT_EPS) { fr.T = vec2(1.0, 0.0); fr.sHat = 0.0; return fr; }\n  fr.T = d / s;\n  float refScale = max(halfW * SPEED_REF_HALFWIDTHS, 1e-6);\n  fr.sHat = clamp(s / refScale, 0.0, 1.0);\n  return fr;\n}\n\n// The volume-preserving anisotropic head distance (the WGSL headAniso twin).\nfloat headAniso(vec2 p, vec2 head, HeadFrame fr, float k) {\n  float g = 1.0 + k * fr.sHat;\n  vec2 n = vec2(-fr.T.y, fr.T.x);\n  vec2 rel = p - head;\n  float along = dot(rel, fr.T) / g;\n  float across = dot(rel, n) * g;\n  return length(vec2(along, across));\n}\n\nvoid main() {\n  vec2 p = vP;\n  float aa = max(fwidth(p.x) + fwidth(p.y), 1e-5) * 0.75;\n  float peak = uTrail.y * uEnv.y;\n  float headGlow = uTrail.z * uEnv.y;\n  float fadeExp = uTrail.w;\n  float trailFloor = uEnv.x;\n  bool rainbow = uEnv.w > 0.5;\n  float squashGain = uLoom.x;\n  float celGain = uLoom.y;\n  float halfW = vHalf;\n\n  if (uLayer == 0) {\n    // \u2500\u2500 TRAIL \u2014 the tapered luminous ribbon over its own soft under-glow \u2500\u2500\n    float age = vAge;\n    float d = segDist(p, vA, vB);\n    // Head\u2192tail taper: the ribbon half-width scales with age (thick head, thin tail).\n    float ribbonHalf = halfW * (RIBBON_TAIL_FRAC + (1.0 - RIBBON_TAIL_FRAC) * age);\n    vec3 lin = samplePaletteLin(1.0 - age * 0.4);\n    vec3 rgb = clamp(linearToSrgb(lin), vec3(0.0), vec3(1.0));\n    // Soft under-glow: a wider, low-alpha copy under the crisp ribbon (one color event).\n    float glowHalf = ribbonHalf * RIBBON_UNDERGLOW_SCALE;\n    float glowCover = 1.0 - smoothstep(glowHalf, glowHalf + aa * 3.0, d);\n    float ga = peak * RIBBON_UNDERGLOW_ALPHA * pow(age, fadeExp) * glowCover;\n    // The crisp tapered ribbon core.\n    float cover = 1.0 - smoothstep(ribbonHalf, ribbonHalf + aa, d);\n    float ca = max(peak * pow(age, fadeExp), peak * trailFloor) * cover;\n    // core OVER glow OVER transparent (both premultiplied on the SAME rgb \u2192 out = rgb\u00B7outA).\n    float outA = ca + ga * (1.0 - ca);\n    fragColor = vec4(rgb * outA, outA);\n  } else if (uLayer == 1) {\n    // \u2500\u2500 EPICYCLE \u2014 orbit RING + ARM + joint DOT union (MAX-blended, no join seam) \u2500\u2500\n    float seg = vArg2;\n    vec3 lin = chainColorLin(seg, rainbow);\n    vec3 rgb = clamp(linearToSrgb(lin), vec3(0.0), vec3(1.0));\n    float radius = length(vB - vA);\n    float dRing = abs(length(p - vA) - radius);\n    float ringW = max(halfW * 0.45, aa);\n    float ringMask = (1.0 - smoothstep(ringW, ringW + aa, dRing)) * 0.5;\n    float dArm = segDist(p, vA, vB);\n    float armMask = 1.0 - smoothstep(halfW * 0.55, halfW * 0.55 + aa, dArm);\n    float dotR = max(halfW * 0.7, aa * 2.0);\n    float dDot = length(p - vA);\n    float dotMask = 1.0 - smoothstep(dotR, dotR + aa, dDot);\n    float m = clamp(max(max(ringMask, armMask), dotMask), 0.0, 1.0) * peak * 0.7;\n    fragColor = vec4(rgb * m, m);\n  } else if (uLayer == 2) {\n    // \u2500\u2500 HEAD \u2014 squash-and-stretch (\u00A72b): halo + saturated core + white specular \u2500\u2500\n    vec2 head = vA;\n    vec2 headBack = vB;\n    HeadFrame fr = headFrame(head, headBack, halfW);\n    float dHead = headAniso(p, head, fr, squashGain);\n    float coreR = halfW * 1.5;\n    float haloR = coreR * 3.0;\n    vec3 headRgb = clamp(linearToSrgb(samplePaletteLin(0.0)), vec3(0.0), vec3(1.0));\n    float halo = (1.0 - smoothstep(0.0, haloR, dHead)) * headGlow * 0.35;\n    vec4 accum = vec4(headRgb * halo, halo);\n    float core = (1.0 - smoothstep(coreR, coreR + aa, dHead)) * headGlow;\n    accum = vec4(headRgb * core, core) + accum * (1.0 - core);\n    float spec = (1.0 - smoothstep(coreR * 0.4, coreR * 0.4 + aa, dHead)) * headGlow * 0.9;\n    accum = vec4(vec3(1.0) * spec, spec) + accum * (1.0 - spec);\n    fragColor = accum;\n  } else {\n    // \u2500\u2500 CEL \u2014 the technicolor ink shadow (rope uLayer==3, arm uLayer==4) \u2500\u2500\n    float celA = clamp(celGain, 0.0, 1.0);\n    float d = segDist(p, vA, vB);\n    float cover = 1.0 - smoothstep(halfW, halfW + aa, d);\n    float m = cover * celA * peak * vArg2; // vArg2 = celStrength (1.0 rope / 0.7 arm)\n    fragColor = vec4(0.0, 0.0, 0.0, m);\n  }\n}\n";

package/dist/components/fourier-field/shaders/fourier-field.render.wgsl.d.ts

@@ -1 +1 @@
-export declare const FOURIER_FIELD_RENDER_WGSL = "\n// The instanced-ribbon LAYER selector (a pipeline-overridable constant \u2014 5 pipelines share the\n// ONE module, each specializing this): 0 trail \u00B7 1 epicycle \u00B7 2 head \u00B7 3 cel-rope \u00B7 4 cel-arm.\noverride LAYER: i32 = 0;\n\nconst PI: f32 = 3.141592653589793;\n// BD.W-FOURIER-LOOM \u00A72b \u2014 the degenerate-tangent guard (must equal FOURIER_TANGENT_EPS in\n// constants.ts + the GL CPU bead path so a cusp resolves IDENTICALLY across both engines).\nconst TANGENT_EPS: f32 = 1e-4;\nconst SPEED_REF_HALFWIDTHS: f32 = 6.0;\n// BG.W-FOURIER-BEAUTY B1 \u2014 the THICK luminous RIBBON. RIBBON_TAIL_FRAC is MIRRORED verbatim\n// from constants.ts (the WGSL twin cannot import a TS const); proof:viz FB1 cross-checks the\n// two copies are equal so the mid-body floor (RIBBON_HEAD_FLOOR_PX) can never drift off it.\nconst RIBBON_TAIL_FRAC: f32 = 0.4;\nconst RIBBON_UNDERGLOW_SCALE: f32 = 2.2;\nconst RIBBON_UNDERGLOW_ALPHA: f32 = 0.16;\n\n// \u2500\u2500 Render uniforms (the typed-struct source-of-truth \u2014 see uniformBridgeWGPU.ts) \u2500\u2500\nstruct RenderUniforms {\n  // r0: (centerX, centerY, scale, aspect)  \u2014 model\u2192clip fit transform\n  r0: vec4<f32>,\n  // r1: (trailWidth, peakAlpha, headGlowAlpha, trailFadeExp)\n  r1: vec4<f32>,\n  // r2: (trailFloor, intensity, showEpicycles, rainbowChain)\n  r2: vec4<f32>,\n  // r3: (squashGain, celGain, edgeMargin, _pad) \u2014 FOURIER-LOOM \u00A72b/\u00A73b + the ribbon bbox slop\n  r3: vec4<f32>,\n  // ints: (sampleCount, armCount, stopCount, _pad)\n  ints: vec4<i32>,\n  // palette stops: linear-sRGB rgb + _pad\n  palette: array<vec4<f32>, 4>,\n};\n\n@group(0) @binding(0) var<uniform> u: RenderUniforms;\n// curveSamples[i] = (x, y, age, _pad) in MODEL space \u2014 the render VERTEX-PULLS these.\n@group(0) @binding(1) var<storage, read> curveSamples: array<vec4<f32>>;\n// chainTips[k] = (x, y, _pad, _pad) in MODEL space.\n@group(0) @binding(2) var<storage, read> chainTips: array<vec4<f32>>;\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 samplePaletteLin(t: f32) -> vec3<f32> {\n  let stopCount = u.ints.z;\n  if (stopCount <= 1) { return u.palette[0].rgb; }\n  let n = f32(stopCount);\n  let ft = clamp(t, 0.0, 1.0) * (n - 1.0);\n  let i0 = i32(floor(ft));\n  let i1 = min(i0 + 1, stopCount - 1);\n  let f = ft - f32(i0);\n  let labA = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * u.palette[i0].rgb);\n  let labB = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * u.palette[i1].rgb);\n  return oklabToLinearSrgb(mix(labA, labB, f));\n}\n\nfn chainColorLin(seg: f32, rainbow: bool) -> vec3<f32> {\n  let baseLin = u.palette[0].rgb;\n  if (!rainbow) { return baseLin; }\n  let lab = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * baseLin);\n  let lch = oklabToOklch(lab);\n  let hueShift = mix(-0.45, 1.15, clamp(seg, 0.0, 1.0));\n  let h = lch.z + hueShift;\n  let lifted = vec3<f32>(0.66, max(lch.y, 0.14), h);\n  return oklabToLinearSrgb(oklchToOklab(lifted));\n}\n\nfn segDist(p: vec2<f32>, a: vec2<f32>, b: vec2<f32>) -> f32 {\n  let pa = p - a;\n  let ba = b - a;\n  let h = clamp(dot(pa, ba) / max(dot(ba, ba), 1e-8), 0.0, 1.0);\n  return length(pa - ba * h);\n}\n\n// BD.W-FOURIER-LOOM \u00A72b \u2014 the head travel frame + the volume-preserving anisotropic distance.\nstruct HeadFrame { T: vec2<f32>, sHat: f32, };\nfn headFrame(head: vec2<f32>, headBack: vec2<f32>, halfW: f32) -> HeadFrame {\n  let d = head - headBack;\n  let s = length(d);\n  var out: HeadFrame;\n  if (s <= TANGENT_EPS) {\n    out.T = vec2<f32>(1.0, 0.0);\n    out.sHat = 0.0;\n    return out;\n  }\n  out.T = d / s;\n  let refScale = max(halfW * SPEED_REF_HALFWIDTHS, 1e-6);\n  out.sHat = clamp(s / refScale, 0.0, 1.0);\n  return out;\n}\n\nfn headAniso(p: vec2<f32>, head: vec2<f32>, fr: HeadFrame, k: f32) -> f32 {\n  let g = 1.0 + k * fr.sHat;\n  let n = vec2<f32>(-fr.T.y, fr.T.x);\n  let rel = p - head;\n  let along = dot(rel, fr.T) / g;\n  let across = dot(rel, n) * g;\n  return length(vec2<f32>(along, across));\n}\n\n// The cel ink lags behind the travel \u2014 the SAME \u2212T\u00B7halfW\u00B71.4 offset both engines apply (the\n// head frame is read straight off the compute-filled curveSamples[0]/[1], parity by construction).\nfn celOffset(halfW: f32) -> vec2<f32> {\n  let fr = headFrame(curveSamples[0].xy, curveSamples[1].xy, halfW);\n  return -fr.T * halfW * 1.4;\n}\n\n// The unit quad as two triangles (6 verts) in [0,1]\u00B2 \u2014 the instanced vertex expands it.\nfn quadCorner(vi: u32) -> vec2<f32> {\n  var c = array<vec2<f32>, 6>(\n    vec2<f32>(0.0, 0.0), vec2<f32>(1.0, 0.0), vec2<f32>(0.0, 1.0),\n    vec2<f32>(0.0, 1.0), vec2<f32>(1.0, 0.0), vec2<f32>(1.0, 1.0),\n  );\n  return c[vi];\n}\n\nstruct VSOut {\n  @builtin(position) pos: vec4<f32>,\n  @location(0) p: vec2<f32>,      // model-space fragment coordinate\n  @location(1) a: vec2<f32>,\n  @location(2) b: vec2<f32>,\n  @location(3) segData: vec3<f32>,   // (age, strokeHalf, arg2)\n};\n\n@vertex\nfn vs_main(@builtin(vertex_index) vi: u32, @builtin(instance_index) inst: u32) -> VSOut {\n  let corner = quadCorner(vi);\n  let center = u.r0.xy;\n  let scale = max(u.r0.z, 1e-6);\n  let aspect = max(u.r0.w, 1e-4);\n  let halfW = u.r1.x * 0.5;\n  let margin = u.r3.z;\n\n  var a: vec2<f32> = vec2<f32>(0.0);\n  var b: vec2<f32> = vec2<f32>(0.0);\n  var strokeHalf: f32 = halfW;\n  var age: f32 = 0.0;\n  var arg2: f32 = 0.0;\n  var isCapsule: bool = true;\n  var ext: f32 = halfW;\n\n  if (LAYER == 0) {\n    // TRAIL \u2014 the curve capsule; the covered extent is the head-width under-glow.\n    a = curveSamples[inst].xy;\n    b = curveSamples[inst + 1u].xy;\n    age = max(curveSamples[inst].z, curveSamples[inst + 1u].z);\n    ext = halfW * RIBBON_UNDERGLOW_SCALE;\n    isCapsule = true;\n  } else if (LAYER == 1) {\n    // EPICYCLE \u2014 the chain AABB around a (radius = |b\u2212a|).\n    a = chainTips[inst].xy;\n    b = chainTips[inst + 1u].xy;\n    arg2 = f32(inst) / max(f32(u.ints.y - 1), 1.0);\n    ext = length(b - a) + halfW * 0.7;\n    isCapsule = false;\n  } else if (LAYER == 2) {\n    // HEAD \u2014 the comet head at curveSamples[0], AABB by the halo radius.\n    a = curveSamples[0].xy;\n    b = curveSamples[1].xy;\n    ext = halfW * 4.5;\n    isCapsule = false;\n  } else if (LAYER == 3) {\n    // CEL-ROPE \u2014 the curve capsule, offset opposite travel; full-width ink.\n    let off = celOffset(halfW);\n    a = curveSamples[inst].xy + off;\n    b = curveSamples[inst + 1u].xy + off;\n    arg2 = 1.0;\n    ext = halfW;\n    isCapsule = true;\n  } else {\n    // CEL-ARM (LAYER == 4) \u2014 the chain capsule, offset; the narrower arm ink (0.55\u00B7halfW).\n    let off = celOffset(halfW);\n    a = chainTips[inst].xy + off;\n    b = chainTips[inst + 1u].xy + off;\n    strokeHalf = halfW * 0.55;\n    arg2 = 0.7;\n    ext = halfW * 0.55;\n    isCapsule = true;\n  }\n  ext = ext + margin;\n\n  var pos: vec2<f32>;\n  if (isCapsule) {\n    let d = b - a;\n    let len = length(d);\n    var dir = vec2<f32>(1.0, 0.0);\n    if (len > 1e-6) { dir = d / len; }\n    let perp = vec2<f32>(-dir.y, dir.x);\n    let along = mix(a - dir * ext, b + dir * ext, corner.x);\n    pos = along + perp * (corner.y * 2.0 - 1.0) * ext;\n  } else {\n    pos = a + (corner * 2.0 - vec2<f32>(1.0)) * ext;\n  }\n\n  let clipX = (pos.x - center.x) * scale / aspect;\n  let clipY = (pos.y - center.y) * scale;\n  var out: VSOut;\n  out.pos = vec4<f32>(clipX, clipY, 0.0, 1.0);\n  out.p = pos;\n  out.a = a;\n  out.b = b;\n  out.segData = vec3<f32>(age, strokeHalf, arg2);\n  return out;\n}\n\n@fragment\nfn fs_main(in: VSOut) -> @location(0) vec4<f32> {\n  let p = in.p;\n  let aa = max(fwidth(p.x) + fwidth(p.y), 1e-5) * 0.75;\n  let peak = u.r1.y * u.r2.y;\n  let headGlow = u.r1.z * u.r2.y;\n  let fadeExp = u.r1.w;\n  let trailFloor = u.r2.x;\n  let rainbow = u.r2.w > 0.5;\n  let squashGain = u.r3.x;\n  let celGain = u.r3.y;\n  let halfW = in.segData.y;\n  let age = in.segData.x;\n  let arg2 = in.segData.z;\n  let a = in.a;\n  let b = in.b;\n\n  if (LAYER == 0) {\n    // \u2500\u2500 TRAIL \u2014 the tapered luminous ribbon over its own soft under-glow \u2500\u2500\n    let d = segDist(p, a, b);\n    let ribbonHalf = halfW * (RIBBON_TAIL_FRAC + (1.0 - RIBBON_TAIL_FRAC) * age);\n    let lin = samplePaletteLin(1.0 - age * 0.4);\n    let rgb = clamp(linearToSrgb(lin), vec3<f32>(0.0), vec3<f32>(1.0));\n    let glowHalf = ribbonHalf * RIBBON_UNDERGLOW_SCALE;\n    let glowCover = 1.0 - smoothstep(glowHalf, glowHalf + aa * 3.0, d);\n    let ga = peak * RIBBON_UNDERGLOW_ALPHA * pow(age, fadeExp) * glowCover;\n    let cover = 1.0 - smoothstep(ribbonHalf, ribbonHalf + aa, d);\n    let ca = max(peak * pow(age, fadeExp), peak * trailFloor) * cover;\n    let outA = ca + ga * (1.0 - ca);\n    return vec4<f32>(rgb * outA, outA);\n  } else if (LAYER == 1) {\n    // \u2500\u2500 EPICYCLE \u2014 orbit RING + ARM + joint DOT union (MAX-blended, no join seam) \u2500\u2500\n    let lin = chainColorLin(arg2, rainbow);\n    let rgb = clamp(linearToSrgb(lin), vec3<f32>(0.0), vec3<f32>(1.0));\n    let radius = length(b - a);\n    let dRing = abs(length(p - a) - radius);\n    let ringW = max(halfW * 0.45, aa);\n    let ringMask = (1.0 - smoothstep(ringW, ringW + aa, dRing)) * 0.5;\n    let dArm = segDist(p, a, b);\n    let armMask = 1.0 - smoothstep(halfW * 0.55, halfW * 0.55 + aa, dArm);\n    let dotR = max(halfW * 0.7, aa * 2.0);\n    let dDot = length(p - a);\n    let dotMask = 1.0 - smoothstep(dotR, dotR + aa, dDot);\n    let m = clamp(max(max(ringMask, armMask), dotMask), 0.0, 1.0) * peak * 0.7;\n    return vec4<f32>(rgb * m, m);\n  } else if (LAYER == 2) {\n    // \u2500\u2500 HEAD \u2014 squash-and-stretch (\u00A72b): halo + saturated core + white specular \u2500\u2500\n    let head = a;\n    let headBack = b;\n    let fr = headFrame(head, headBack, halfW);\n    let dHead = headAniso(p, head, fr, squashGain);\n    let coreR = halfW * 1.5;\n    let haloR = coreR * 3.0;\n    let headRgb = clamp(linearToSrgb(samplePaletteLin(0.0)), vec3<f32>(0.0), vec3<f32>(1.0));\n    let halo = (1.0 - smoothstep(0.0, haloR, dHead)) * headGlow * 0.35;\n    var accum = vec4<f32>(headRgb * halo, halo);\n    let core = (1.0 - smoothstep(coreR, coreR + aa, dHead)) * headGlow;\n    accum = vec4<f32>(headRgb * core, core) + accum * (1.0 - core);\n    let spec = (1.0 - smoothstep(coreR * 0.4, coreR * 0.4 + aa, dHead)) * headGlow * 0.9;\n    accum = vec4<f32>(vec3<f32>(1.0) * spec, spec) + accum * (1.0 - spec);\n    return accum;\n  } else {\n    // \u2500\u2500 CEL \u2014 the technicolor ink shadow (rope LAYER==3 / arm LAYER==4) \u2500\u2500\n    let celA = clamp(celGain, 0.0, 1.0);\n    let d = segDist(p, a, b);\n    let cover = 1.0 - smoothstep(halfW, halfW + aa, d);\n    let m = cover * celA * peak * arg2; // arg2 = celStrength (1.0 rope / 0.7 arm)\n    return vec4<f32>(0.0, 0.0, 0.0, m);\n  }\n}\n";
+export declare const FOURIER_FIELD_RENDER_WGSL = "\n// The instanced-ribbon LAYER selector (a pipeline-overridable constant \u2014 5 pipelines share the\n// ONE module, each specializing this): 0 trail \u00B7 1 epicycle \u00B7 2 head \u00B7 3 cel-rope \u00B7 4 cel-arm.\noverride LAYER: i32 = 0;\n\nconst PI: f32 = 3.141592653589793;\n// The degenerate-tangent guard must equal FOURIER_TANGENT_EPS in\n// constants.ts and the GL CPU bead path so a cusp resolves identically across both engines.\nconst TANGENT_EPS: f32 = 1e-4;\nconst SPEED_REF_HALFWIDTHS: f32 = 6.0;\n// The thick luminous ribbon mirrors RIBBON_TAIL_FRAC verbatim\n// from constants.ts because the WGSL twin cannot import a TS const; parity coverage verifies the\n// two copies are equal so the mid-body floor (RIBBON_HEAD_FLOOR_PX) can never drift off it.\nconst RIBBON_TAIL_FRAC: f32 = 0.4;\nconst RIBBON_UNDERGLOW_SCALE: f32 = 2.2;\nconst RIBBON_UNDERGLOW_ALPHA: f32 = 0.16;\n\n// \u2500\u2500 Render uniforms (the typed-struct source-of-truth \u2014 see uniformBridgeWGPU.ts) \u2500\u2500\nstruct RenderUniforms {\n  // r0: (centerX, centerY, scale, aspect)  \u2014 model\u2192clip fit transform\n  r0: vec4<f32>,\n  // r1: (trailWidth, peakAlpha, headGlowAlpha, trailFadeExp)\n  r1: vec4<f32>,\n  // r2: (trailFloor, intensity, showEpicycles, rainbowChain)\n  r2: vec4<f32>,\n  // r3: (squashGain, celGain, edgeMargin, _pad) \u2014 FOURIER-LOOM \u00A72b/\u00A73b + the ribbon bbox slop\n  r3: vec4<f32>,\n  // ints: (sampleCount, armCount, stopCount, _pad)\n  ints: vec4<i32>,\n  // palette stops: linear-sRGB rgb + _pad\n  palette: array<vec4<f32>, 4>,\n};\n\n@group(0) @binding(0) var<uniform> u: RenderUniforms;\n// curveSamples[i] = (x, y, age, _pad) in MODEL space \u2014 the render VERTEX-PULLS these.\n@group(0) @binding(1) var<storage, read> curveSamples: array<vec4<f32>>;\n// chainTips[k] = (x, y, _pad, _pad) in MODEL space.\n@group(0) @binding(2) var<storage, read> chainTips: array<vec4<f32>>;\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 samplePaletteLin(t: f32) -> vec3<f32> {\n  let stopCount = u.ints.z;\n  if (stopCount <= 1) { return u.palette[0].rgb; }\n  let n = f32(stopCount);\n  let ft = clamp(t, 0.0, 1.0) * (n - 1.0);\n  let i0 = i32(floor(ft));\n  let i1 = min(i0 + 1, stopCount - 1);\n  let f = ft - f32(i0);\n  let labA = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * u.palette[i0].rgb);\n  let labB = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * u.palette[i1].rgb);\n  return oklabToLinearSrgb(mix(labA, labB, f));\n}\n\nfn chainColorLin(seg: f32, rainbow: bool) -> vec3<f32> {\n  let baseLin = u.palette[0].rgb;\n  if (!rainbow) { return baseLin; }\n  let lab = LMS_TO_OKLAB * cbrt3(LINEAR_SRGB_TO_LMS * baseLin);\n  let lch = oklabToOklch(lab);\n  let hueShift = mix(-0.45, 1.15, clamp(seg, 0.0, 1.0));\n  let h = lch.z + hueShift;\n  let lifted = vec3<f32>(0.66, max(lch.y, 0.14), h);\n  return oklabToLinearSrgb(oklchToOklab(lifted));\n}\n\nfn segDist(p: vec2<f32>, a: vec2<f32>, b: vec2<f32>) -> f32 {\n  let pa = p - a;\n  let ba = b - a;\n  let h = clamp(dot(pa, ba) / max(dot(ba, ba), 1e-8), 0.0, 1.0);\n  return length(pa - ba * h);\n}\n\n// The head travel frame + the volume-preserving anisotropic distance.\nstruct HeadFrame { T: vec2<f32>, sHat: f32, };\nfn headFrame(head: vec2<f32>, headBack: vec2<f32>, halfW: f32) -> HeadFrame {\n  let d = head - headBack;\n  let s = length(d);\n  var out: HeadFrame;\n  if (s <= TANGENT_EPS) {\n    out.T = vec2<f32>(1.0, 0.0);\n    out.sHat = 0.0;\n    return out;\n  }\n  out.T = d / s;\n  let refScale = max(halfW * SPEED_REF_HALFWIDTHS, 1e-6);\n  out.sHat = clamp(s / refScale, 0.0, 1.0);\n  return out;\n}\n\nfn headAniso(p: vec2<f32>, head: vec2<f32>, fr: HeadFrame, k: f32) -> f32 {\n  let g = 1.0 + k * fr.sHat;\n  let n = vec2<f32>(-fr.T.y, fr.T.x);\n  let rel = p - head;\n  let along = dot(rel, fr.T) / g;\n  let across = dot(rel, n) * g;\n  return length(vec2<f32>(along, across));\n}\n\n// The cel ink lags behind the travel \u2014 the SAME \u2212T\u00B7halfW\u00B71.4 offset both engines apply (the\n// head frame is read straight off the compute-filled curveSamples[0]/[1], parity by construction).\nfn celOffset(halfW: f32) -> vec2<f32> {\n  let fr = headFrame(curveSamples[0].xy, curveSamples[1].xy, halfW);\n  return -fr.T * halfW * 1.4;\n}\n\n// The unit quad as two triangles (6 verts) in [0,1]\u00B2 \u2014 the instanced vertex expands it.\nfn quadCorner(vi: u32) -> vec2<f32> {\n  var c = array<vec2<f32>, 6>(\n    vec2<f32>(0.0, 0.0), vec2<f32>(1.0, 0.0), vec2<f32>(0.0, 1.0),\n    vec2<f32>(0.0, 1.0), vec2<f32>(1.0, 0.0), vec2<f32>(1.0, 1.0),\n  );\n  return c[vi];\n}\n\nstruct VSOut {\n  @builtin(position) pos: vec4<f32>,\n  @location(0) p: vec2<f32>,      // model-space fragment coordinate\n  @location(1) a: vec2<f32>,\n  @location(2) b: vec2<f32>,\n  @location(3) segData: vec3<f32>,   // (age, strokeHalf, arg2)\n};\n\n@vertex\nfn vs_main(@builtin(vertex_index) vi: u32, @builtin(instance_index) inst: u32) -> VSOut {\n  let corner = quadCorner(vi);\n  let center = u.r0.xy;\n  let scale = max(u.r0.z, 1e-6);\n  let aspect = max(u.r0.w, 1e-4);\n  let halfW = u.r1.x * 0.5;\n  let margin = u.r3.z;\n\n  var a: vec2<f32> = vec2<f32>(0.0);\n  var b: vec2<f32> = vec2<f32>(0.0);\n  var strokeHalf: f32 = halfW;\n  var age: f32 = 0.0;\n  var arg2: f32 = 0.0;\n  var isCapsule: bool = true;\n  var ext: f32 = halfW;\n\n  if (LAYER == 0) {\n    // TRAIL \u2014 the curve capsule; the covered extent is the head-width under-glow.\n    a = curveSamples[inst].xy;\n    b = curveSamples[inst + 1u].xy;\n    age = max(curveSamples[inst].z, curveSamples[inst + 1u].z);\n    ext = halfW * RIBBON_UNDERGLOW_SCALE;\n    isCapsule = true;\n  } else if (LAYER == 1) {\n    // EPICYCLE \u2014 the chain AABB around a (radius = |b\u2212a|).\n    a = chainTips[inst].xy;\n    b = chainTips[inst + 1u].xy;\n    arg2 = f32(inst) / max(f32(u.ints.y - 1), 1.0);\n    ext = length(b - a) + halfW * 0.7;\n    isCapsule = false;\n  } else if (LAYER == 2) {\n    // HEAD \u2014 the comet head at curveSamples[0], AABB by the halo radius.\n    a = curveSamples[0].xy;\n    b = curveSamples[1].xy;\n    ext = halfW * 4.5;\n    isCapsule = false;\n  } else if (LAYER == 3) {\n    // CEL-ROPE \u2014 the curve capsule, offset opposite travel; full-width ink.\n    let off = celOffset(halfW);\n    a = curveSamples[inst].xy + off;\n    b = curveSamples[inst + 1u].xy + off;\n    arg2 = 1.0;\n    ext = halfW;\n    isCapsule = true;\n  } else {\n    // CEL-ARM (LAYER == 4) \u2014 the chain capsule, offset; the narrower arm ink (0.55\u00B7halfW).\n    let off = celOffset(halfW);\n    a = chainTips[inst].xy + off;\n    b = chainTips[inst + 1u].xy + off;\n    strokeHalf = halfW * 0.55;\n    arg2 = 0.7;\n    ext = halfW * 0.55;\n    isCapsule = true;\n  }\n  ext = ext + margin;\n\n  var pos: vec2<f32>;\n  if (isCapsule) {\n    let d = b - a;\n    let len = length(d);\n    var dir = vec2<f32>(1.0, 0.0);\n    if (len > 1e-6) { dir = d / len; }\n    let perp = vec2<f32>(-dir.y, dir.x);\n    let along = mix(a - dir * ext, b + dir * ext, corner.x);\n    pos = along + perp * (corner.y * 2.0 - 1.0) * ext;\n  } else {\n    pos = a + (corner * 2.0 - vec2<f32>(1.0)) * ext;\n  }\n\n  let clipX = (pos.x - center.x) * scale / aspect;\n  let clipY = (pos.y - center.y) * scale;\n  var out: VSOut;\n  out.pos = vec4<f32>(clipX, clipY, 0.0, 1.0);\n  out.p = pos;\n  out.a = a;\n  out.b = b;\n  out.segData = vec3<f32>(age, strokeHalf, arg2);\n  return out;\n}\n\n@fragment\nfn fs_main(in: VSOut) -> @location(0) vec4<f32> {\n  let p = in.p;\n  let aa = max(fwidth(p.x) + fwidth(p.y), 1e-5) * 0.75;\n  let peak = u.r1.y * u.r2.y;\n  let headGlow = u.r1.z * u.r2.y;\n  let fadeExp = u.r1.w;\n  let trailFloor = u.r2.x;\n  let rainbow = u.r2.w > 0.5;\n  let squashGain = u.r3.x;\n  let celGain = u.r3.y;\n  let halfW = in.segData.y;\n  let age = in.segData.x;\n  let arg2 = in.segData.z;\n  let a = in.a;\n  let b = in.b;\n\n  if (LAYER == 0) {\n    // \u2500\u2500 TRAIL \u2014 the tapered luminous ribbon over its own soft under-glow \u2500\u2500\n    let d = segDist(p, a, b);\n    let ribbonHalf = halfW * (RIBBON_TAIL_FRAC + (1.0 - RIBBON_TAIL_FRAC) * age);\n    let lin = samplePaletteLin(1.0 - age * 0.4);\n    let rgb = clamp(linearToSrgb(lin), vec3<f32>(0.0), vec3<f32>(1.0));\n    let glowHalf = ribbonHalf * RIBBON_UNDERGLOW_SCALE;\n    let glowCover = 1.0 - smoothstep(glowHalf, glowHalf + aa * 3.0, d);\n    let ga = peak * RIBBON_UNDERGLOW_ALPHA * pow(age, fadeExp) * glowCover;\n    let cover = 1.0 - smoothstep(ribbonHalf, ribbonHalf + aa, d);\n    let ca = max(peak * pow(age, fadeExp), peak * trailFloor) * cover;\n    let outA = ca + ga * (1.0 - ca);\n    return vec4<f32>(rgb * outA, outA);\n  } else if (LAYER == 1) {\n    // \u2500\u2500 EPICYCLE \u2014 orbit RING + ARM + joint DOT union (MAX-blended, no join seam) \u2500\u2500\n    let lin = chainColorLin(arg2, rainbow);\n    let rgb = clamp(linearToSrgb(lin), vec3<f32>(0.0), vec3<f32>(1.0));\n    let radius = length(b - a);\n    let dRing = abs(length(p - a) - radius);\n    let ringW = max(halfW * 0.45, aa);\n    let ringMask = (1.0 - smoothstep(ringW, ringW + aa, dRing)) * 0.5;\n    let dArm = segDist(p, a, b);\n    let armMask = 1.0 - smoothstep(halfW * 0.55, halfW * 0.55 + aa, dArm);\n    let dotR = max(halfW * 0.7, aa * 2.0);\n    let dDot = length(p - a);\n    let dotMask = 1.0 - smoothstep(dotR, dotR + aa, dDot);\n    let m = clamp(max(max(ringMask, armMask), dotMask), 0.0, 1.0) * peak * 0.7;\n    return vec4<f32>(rgb * m, m);\n  } else if (LAYER == 2) {\n    // \u2500\u2500 HEAD \u2014 squash-and-stretch (\u00A72b): halo + saturated core + white specular \u2500\u2500\n    let head = a;\n    let headBack = b;\n    let fr = headFrame(head, headBack, halfW);\n    let dHead = headAniso(p, head, fr, squashGain);\n    let coreR = halfW * 1.5;\n    let haloR = coreR * 3.0;\n    let headRgb = clamp(linearToSrgb(samplePaletteLin(0.0)), vec3<f32>(0.0), vec3<f32>(1.0));\n    let halo = (1.0 - smoothstep(0.0, haloR, dHead)) * headGlow * 0.35;\n    var accum = vec4<f32>(headRgb * halo, halo);\n    let core = (1.0 - smoothstep(coreR, coreR + aa, dHead)) * headGlow;\n    accum = vec4<f32>(headRgb * core, core) + accum * (1.0 - core);\n    let spec = (1.0 - smoothstep(coreR * 0.4, coreR * 0.4 + aa, dHead)) * headGlow * 0.9;\n    accum = vec4<f32>(vec3<f32>(1.0) * spec, spec) + accum * (1.0 - spec);\n    return accum;\n  } else {\n    // \u2500\u2500 CEL \u2014 the technicolor ink shadow (rope LAYER==3, arm LAYER==4) \u2500\u2500\n    let celA = clamp(celGain, 0.0, 1.0);\n    let d = segDist(p, a, b);\n    let cover = 1.0 - smoothstep(halfW, halfW + aa, d);\n    let m = cover * celA * peak * arg2; // arg2 = celStrength (1.0 rope / 0.7 arm)\n    return vec4<f32>(0.0, 0.0, 0.0, m);\n  }\n}\n";

package/dist/components/handmark/HandMark.vue.d.ts

@@ -11,11 +11,11 @@ declare const __VLS_base: import("vue").DefineComponent<HandMarkProps, {
     seed: number;
     shape: import("./types").HandShape;
     animation: import("./types").HandAnimation;
-    appear: "mount" | "visible" | "manual";
     jagged: boolean;
     brush: import("./brush").BrushName | Partial<import("./brush").Brush>;
     drawMs: number;
     drawDelayMs: number;
+    appear: "mount" | "visible" | "manual";
     boilFps: number;
     boilFrames: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/components/handmark/brush.d.ts

@@ -84,7 +84,7 @@ export interface InkPath {
     stroke?: string;
     opacity: number;
     blend: BlendMode;
-    /** geometry finish — bound to the SVG `stroke-linecap` on the path (C-1(d)). */
+    /** geometry finish — bound to the SVG `stroke-linecap` on the path (d). */
     cap?: "round" | "square" | "butt";
 }
 /**

package/dist/components/handmark/composables/useHandMark.d.ts

@@ -4,7 +4,7 @@
  * Sits between the props and the SFC template so a future React/web-component skin
  * reuses L1–L4. It orchestrates: resolve brush → shapeGeom → ink → animation. It
  * owns NO DOM (the SFC anchors/measures/mounts the filter); it owns the reactive
- * pipeline + the draw-on / boil state machine.
+ * pipeline + the draw-on, boil state machine.
  *
  * Two draw-on mechanisms, picked by a FIELD (never an instrument `if`):
  *   - clean ink (no grain): `stroke-dashoffset` on `pathLength="1"` — the slides
@@ -47,7 +47,7 @@ export interface UseHandMarkInput {
     jagged: boolean;
     /** NATURAL underline morphology (C-2) — procedural off the house-seeded engine. */
     natural: boolean;
-    /** NATURAL-underline excursion knob (BG.W-HANDMARK-PERFECT (c)); `null` ⇒ derive from brush wobble. */
+    /** NATURAL-underline excursion knob ( (c)); `null` ⇒ derive from brush wobble. */
     amplitude: number | null;
     box: MarkBox | null;
     path: string | null;
@@ -60,8 +60,8 @@ export interface UseHandMarkInput {
      */
     baselineFrac: number | null;
     /**
-     * The aspect-correct marking-space HEIGHT (BG.W-HANDMARK-PERFECT (a)) — `VB_W /
-     * boxAspect` from the SFC-measured `.hm` box px-aspect, so `preserveAspectRatio="none"`
+     * The aspect-correct marking-space height: `VB_W * boxAspect`, using the
+     * SFC-measured `.hm` box aspect so `preserveAspectRatio="none"`
      * scales the text-mode wobble SHAPE uniformly (the humps stop crushing flat on a short
      * word). Defaults to `VB_H`; used ONLY for the measured text-mode marks (the positioned/
      * box path keeps `VB_H` byte-for-byte).

package/dist/components/handmark/constants.d.ts

@@ -1,7 +1,7 @@
 /**
  * constants.ts — the marking-space geometry constants (the colocation home).
  * ─────────────────────────────────────────────────────────────────────────────
- * The hand-mark family's named geometry constants live here (the AY.W-COLOCATE
+ * The hand-mark family's named geometry constants live here (the
  * convention's `constants.ts` home). geometry.ts + the SFC re-read them by name.
  */
 /** Marking-space width (the 0..100 × 0..40 viewBox; `preserveAspectRatio="none"`). */
@@ -17,7 +17,7 @@ export declare const VB_H = 40;
  */
 export declare const UNDERLINE_GAP = 0.06;
 /**
- * The highlighter LOW-SEAT band (BA.W-HANDMARK C-1(a)). A real highlighter rides
+ * The highlighter LOW-SEAT band ( C-1(a)). A real highlighter rides
  * the low two-thirds of the line — the ink sits on the baseline and rises to
  * ~x-height — NOT the box vertical center the fork shipped. The band centerline
  * seats at `baselineFrac − HIGHLIGHT_RISE` (raised off the baseline by ~half a
@@ -31,20 +31,20 @@ export declare const HIGHLIGHT_FALLBACK_FRAC = 0.66;
  * The boil voice — φ-incommensurate fractal value-noise (the masthead morphology).
  * ─────────────────────────────────────────────────────────────────────────────
  * The boil centerline is a 1-D fractal value-noise displacement off the HOUSE
- * `mulberry32`, NOT a seeded sinusoid. A sinusoid (the prior body) self-correlates
+ * `mulberry32`, NOT a seeded sinusoid. A sinusoid self-correlates
  * into a near-period — it reads as a spell-check squiggle and a clean sine fails any
  * honest non-periodicity discriminator (a sine's extrema are near-uniformly spaced).
  * The value-noise sums octaves at φ-stepped frequencies (mutually irrational → the
  * sum NEVER closes into a period); each octave's amplitude decays by 1/φ. The result
  * is a hump-to-hump-IRREGULAR hand line whose inter-extremum spacing-CV is the honest
  * teeth (measured: ~0.41 at the paint's segment count, ~0.71 resampled at RES=64,
- * over 400 seeds — vs the prior sinusoid's ~0.14; a clean separation either side of a
+ * over 400 seeds — vs a sinusoid's ~0.14; a clean separation either side of a
  * 0.30 floor). The amplitude is SCALE-RELATIVE (a fraction of the rendered span), so
  * a long word and a short word wobble in proportion. FILTER-FREE — the wander lives
  * in the control points + the hull width, never a feTurbulence.
  *
- * Constants pinned against a 400-seed spacing-CV spike (NOT the seed-overfit autocorr
- * peak the prior gate keyed — autocorr cannot separate smooth low-frequency value-
+ * Constants pinned against a 400-seed spacing-CV spike (NOT a seed-overfit autocorr
+ * peak — autocorr cannot separate smooth low-frequency value-
  * noise from a sinusoid at any resolution).
  */
 /** φ — the per-octave frequency step (mutually irrational → never periodic). */
@@ -58,10 +58,10 @@ export declare const NOISE_AMP_FRAC = 0.05;
 /** endpoint-only cosine taper width (the ends settle to baseline; the BODY stays irregular). */
 export declare const NOISE_EDGE = 0.12;
 /**
- * The AMPLITUDE-KNOB reference wobble (BG.W-HANDMARK-PERFECT (c)). The natural-underline
- * excursion is `span × NOISE_AMP_FRAC × f(wobble)` where `f(wobble) = wobble / NOISE_WOBBLE_REF`
- * — repurposing the existing Brush `wobble` scalar to drive the centerline amplitude,
- * decoupling excursion from stroke `weight` (the atlas's published `amplitude` ask, no 13th
+ * The AMPLITUDE-KNOB reference wobble ( (c)). The natural-underline
+ * excursion is `span × NOISE_AMP_FRAC × f(wobble)` where `f(wobble) = wobble, NOISE_WOBBLE_REF`
+ * repurposing the existing Brush `wobble` scalar to drive the centerline amplitude,
+ * decoupling excursion from stroke `weight` (the published `amplitude` contract, no 13th
  * scalar). Pinned to the shipped `boil` brush's wobble (1.4) so `f(1.4) = 1` ⇒ the default
  * boil render is BYTE-IDENTICAL; a consumer lifts excursion by raising `wobble` (or the
  * explicit `amplitude` prop, which wins). A lower-wobble brush wobbles proportionally less.