@mkbabb/glass-ui 5.0.0 → 7.0.0

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

@@ -8,14 +8,14 @@ declare const __VLS_base: import("vue").DefineComponent<HandMarkProps, {
     play: typeof play;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<HandMarkProps> & Readonly<{}>, {
     color: string;
-    animation: import("./types").HandAnimation;
     seed: number;
     shape: import("./types").HandShape;
-    appear: "mount" | "visible" | "manual";
+    animation: import("./types").HandAnimation;
     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.

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

@@ -12,11 +12,11 @@
  *   - text mode (box == null): use the full viewBox (single-line underline/strike)
  *   - positioned mode (box = {x,y,w,h}): map an explicit rect (circle a datum)
  *
- * The circle arm rides pencil-boil 0.4.x's `ellipsePoints` (the hand-circle
+ * The circle arm rides pencil-boil's `ellipsePoints` (the hand-circle
  * overshoot ring — the sole upstream geometry delta this component required).
  *
- * THE SEED RECONCILE (BA.W-HANDMARK [S2]): the wobble centerlines are seeded from
- * the HOUSE prng leaf (`src/composables/glass/procedural/prng.ts` mulberry32 + hashString — the AV.W14
+ * THE SEED RECONCILE ( [S2]): the wobble centerlines are seeded from
+ * the HOUSE prng leaf (`src/composables/glass/procedural/prng.ts` mulberry32 + hashString — the
  * single-source). The family FEEDS pencil-boil a house-derived integer seed; glass-
  * ui code imports ZERO `mulberry32` from pencil-boil (its internal mulberry32 stays
  * inside its OWN perturb math). ONE seed leaf, the house identity.
@@ -37,24 +37,24 @@ export interface ShapeGeom {
  * The text-mode underline anchors to a MEASURED baseline: `baselineFrac` is the
  * slotted word's alphabetic baseline as a fraction of the `.hm` box height (the SFC
  * measures it via ResizeObserver + `document.fonts.ready`). The underline y is then
- * `H × (baselineFrac + UNDERLINE_GAP)` — never the old hardcoded `32` (80% of the
- * box), which struck through tight-leading headings. `null` ⇒ not yet measured: fall
- * back to the legacy `H − 8` constant so first paint (and jsdom/SSR) still renders a
+ * `H × (baselineFrac + UNDERLINE_GAP)` — not a hardcoded fraction (a fixed `32`,
+ * 80% of the box, strikes through tight-leading headings). `null` ⇒ not yet measured: fall
+ * back to a fixed `H − 8` constant so first paint (and jsdom/SSR) still renders a
  * line, replaced the instant the measure lands.
  *
  * `natural` routes the underline through the φ-incommensurate value-noise
  * `naturalUnderlinePoints` morphology instead of pencil-boil's `wobbleLinePoints`
  * (the masthead `boil` voice); the default underline keeps the pencil-boil line.
  *
- * BG.W-HANDMARK-PERFECT (a) THE ASPECT-CORRECT viewBox — `vbH` is the SFC-measured
- * marking-space HEIGHT (`VB_W / boxAspect`) for the TEXT-MODE underline/strikethrough/
+ * The aspect-correct viewBox: `vbH` is the SFC-measured
+ * marking-space HEIGHT (`VB_W, boxAspect`) for the TEXT-MODE underline/strikethrough/
  * highlight, so `preserveAspectRatio="none"` scales the wobble SHAPE uniformly (the x
  * and y scales EQUAL → the humps stop being x-stretched flat). It defaults to `VB_H`,
  * and is used ONLY for the measured text-mode y — the positioned/box/circle/bracket
  * path keeps `VB_H` byte-for-byte (it DEPENDS on the none-stretch to fill the datum
  * rect; the text-mode fix must not touch it).
  *
- * BG.W-HANDMARK-PERFECT (c) THE AMPLITUDE KNOB — `ampScale` multiplies the natural-
+ * The amplitude knob: `ampScale` multiplies the natural-
  * underline excursion (default 1 ⇒ byte-identical; the SFC derives it from the brush
  * `wobble` scalar, decoupling excursion from stroke `weight`).
  */

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

@@ -1,23 +1,20 @@
 /**
- * handmark — the ./handmark barrel (SPEC §11).
+ * HandMark public barrel.
  * ─────────────────────────────────────────────────────────────────────────────
- * `HandMark` is the generic export; `InkMark` is the prose alias the atlas/slides
- * import so call sites read as prose (one implementation, zero divergence). The
- * pure L1–L3 functions ship too — they are framework-free, directly usable in
- * slides decks, D3 charts (call `shapeGeom`/`ellipsePoints` to ink a path), even
- * canvas.
+ * `HandMark` is the sole public component name. The pure L1–L3 functions ship
+ * too — they are framework-free, directly usable in slides decks, D3 charts
+ * (call `shapeGeom`/`ellipsePoints` to ink a path), even canvas.
  *
  * The DEFAULT is `pen` (clean ink, grain:0 ⇒ no filter, zero extra dep). The
- * `@mkbabb/pencil-boil` geometry + `perfect-freehand` body are OPTIONAL PEERS;
- * only `ribbon:'hull'` (the highlighter) touches the vendored pf core (treeshaken
- * otherwise).
+ * `@mkbabb/pencil-boil` geometry is an OPTIONAL PEER. The perfect-freehand body
+ * is vendored; only `ribbon:'hull'` (the highlighter) touches that core
+ * (treeshaken otherwise).
  *
- * BA.W-HANDMARK: `GlassUnderline`/the `/underline` subpath RETIRED onto
- * `HandMark shape="underline"` (DEC-8 outcome 1; clean break, no alias). The
- * editorial draw-on underline is `<HandMark shape="underline" animation="draw-on">`;
- * the natural pencil-boil morphology is the `boil` brush.
+ * The editorial draw-on underline is
+ * `<HandMark shape="underline" animation="draw-on">`; the natural pencil-boil
+ * morphology is the `boil` brush.
  */
-export { default as HandMark, default as InkMark } from "./HandMark.vue";
+export { default as HandMark } from "./HandMark.vue";
 export { BRUSHES, resolveBrush, lerpBrush, type Brush, type BrushName, type BlendMode, type TaperSpec, type StampFn, type InkPath, } from "./brush";
 export { shapeGeom, serialize, boilLines, naturalUnderlinePoints, VB_W, VB_H, UNDERLINE_GAP, type ShapeGeom, } from "./geometry";
 export { ink, type SVGFragment } from "./ink";

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

@@ -10,14 +10,14 @@ export declare function smootherstep(t: number): number;
  *     φₖ = seeded per-octave phase (house mulberry32)
  *     vnoiseₖ = seeded lattice value-noise, smootherstep-faired
  *
- * The four atlas axes:
+ * The four brush axes:
  *   - amplitude SCALES with the rendered span (`(x2−x1) × NOISE_AMP_FRAC × ampScale`),
  *     not a viewBox-stretched constant (a long word and a short word wobble in
- *     proportion); `ampScale` is the BG.W-HANDMARK-PERFECT excursion knob (default 1
+ *     proportion); `ampScale` is the excursion knob (default 1
  *     ⇒ byte-identical; the SFC derives it from the brush `wobble` scalar, decoupling
  *     excursion from stroke `weight`);
  *   - the hump-to-hump spacing is IRREGULAR (the φ-incommensurate octave sum — the
- *     honest non-periodicity teeth, spacing-CV ~0.41 at the paint count vs the prior
+ *     honest non-periodicity teeth, spacing-CV ~0.41 at the paint count vs a
  *     sinusoid's ~0.14, over 400 seeds);
  *   - the non-uniform body gives the pf hull a pressure-taper-friendly point stream;
  *   - the seed is the HOUSE mulberry32.

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

@@ -45,7 +45,7 @@ export interface HandMarkProps {
     /** angular kinks vs smooth bezier. default false. */
     jagged?: boolean;
     /**
-     * NATURAL-underline excursion knob (BG.W-HANDMARK-PERFECT (c)). Multiplies the
+     * NATURAL-underline excursion knob ( (c)). Multiplies the
      * scale-relative wobble amplitude (`span × NOISE_AMP_FRAC × amplitude`). Default is
      * unset ⇒ the amplitude is derived from the brush `wobble` scalar (byte-identical at
      * the shipped default); an explicit value WINS (e.g. `1.4` for a bolder hand line,
@@ -53,7 +53,7 @@ export interface HandMarkProps {
      */
     amplitude?: number;
     /**
-     * NATURAL underline morphology (BA.W-HANDMARK C-2). When true (the masthead
+     * NATURAL underline morphology ( C-2). When true (the masthead
      * `boil` voice), the underline geometry goes PROCEDURAL — scale-relative
      * amplitude, an IRREGULAR seeded period count, off the house prng leaf feeding
      * pencil-boil — instead of pencil-boil's single `wobbleLinePoints` line. The

package/dist/components/header-ribbon/HeaderRibbon.vue.d.ts

@@ -1,26 +1,8 @@
 import type { HeaderRibbonProps } from "./types";
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {
-    pinned: boolean;
-    toggled: boolean;
-}, __VLS_7: {};
-type __VLS_Slots = {} & {
-    left?: (props: typeof __VLS_1) => any;
-} & {
-    items?: (props: typeof __VLS_3) => any;
-} & {
-    anchor?: (props: typeof __VLS_5) => any;
-} & {
-    items?: (props: typeof __VLS_7) => any;
+type __VLS_Slots = {
+    items?(): unknown;
 };
-declare const __VLS_base: import("vue").DefineComponent<HeaderRibbonProps, {
-    isPinned: import("vue").Ref<boolean, boolean>;
-    isExpanded: import("vue").Ref<boolean, boolean>;
-    isVisible: import("vue").ComputedRef<boolean>;
-    isToggled: import("vue").Ref<boolean, boolean>;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<HeaderRibbonProps> & Readonly<{}>, {
-    placement: import("./types").HeaderRibbonPlacement;
-    hideTimeoutMs: number;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_base: import("vue").DefineComponent<HeaderRibbonProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<HeaderRibbonProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/header-ribbon/styles.css

@@ -0,0 +1 @@
+@layer components { .header-ribbon { position: fixed; inset-block-start: 0; z-index: var(--z-header); display: flex; width: max-content; max-width: 100%; padding: 1rem; pointer-events: none; } .header-ribbon[data-placement="left"] { left: 0; } .header-ribbon[data-placement="right"] { right: 0; } .header-ribbon__band { display: flex; align-items: center; min-block-size: var(--size-icon-btn); max-inline-size: min(32rem, calc(100vw - 2rem)); padding: var(--panel-padding); border-radius: var(--radius-pill); pointer-events: auto; direction: ltr; } .header-ribbon[data-placement="right"] .header-ribbon__band { flex-direction: row-reverse; } .header-ribbon__actions { display: flex; align-items: center; gap: 0.5rem; } .header-ribbon:dir(rtl) .header-ribbon__actions { direction: rtl; } } @media (pointer: coarse) { .header-ribbon { padding: 0.75rem; } .header-ribbon__band { max-inline-size: calc(100vw - 1.5rem); } } @media (forced-colors: active) { .header-ribbon__band { border: 1px solid CanvasText; } }

package/dist/components/header-ribbon/types.d.ts

@@ -1,7 +1,10 @@
+import type { HTMLAttributes } from "vue";
 export type HeaderRibbonPlacement = "left" | "right";
 export interface HeaderRibbonProps {
     /** Side of the viewport the ribbon anchors against. Defaults to `"left"`. */
     placement?: HeaderRibbonPlacement;
-    /** Milliseconds after the pointer leaves the ribbon before items collapse. Defaults to `2000`. */
-    hideTimeoutMs?: number;
+    /** Accessible name for the persistent action toolbar. */
+    ariaLabel?: string;
+    /** Additional class names. */
+    class?: HTMLAttributes["class"];
 }

package/dist/components/index.d.ts

@@ -13,15 +13,12 @@ export * from "./data-table";
 export * from "./dialog";
 export * from "./drawer";
 export * from "./dropdown-menu";
-export * from "./focus-scope";
 export * from "./input";
 export * from "./label";
-export * from "./notification";
 export * from "./number-field";
 export * from "./popover";
 export * from "./progress";
 export * from "./radio-group";
-export * from "./section";
 export * from "./select";
 export * from "./separator";
 export * from "./skeleton";
@@ -31,6 +28,5 @@ export * from "./table";
 export * from "./tags-input";
 export * from "./textarea";
 export * from "./toast";
-export * from "./toggle";
 export * from "./toggle-group";
 export * from "./tooltip";

package/dist/components/infinite-scroll/composables/types.d.ts

@@ -14,7 +14,7 @@ export interface InfiniteScrollOptions {
 export interface InfiniteScrollReturn {
     /** Ref to bind to the sentinel element */
     sentinelRef: Ref<HTMLElement | null>;
-    /** Manually trigger a check (e.g., after DOM updates) */
+    /** Reconnect observation after a caller-owned DOM update. */
     check: () => void;
     /** Stop observing */
     stop: () => void;

package/dist/components/infinite-scroll/index.d.ts

@@ -1 +1,2 @@
 export { default as InfiniteScroll } from "./InfiniteScroll.vue";
+export * from "./composables";