@mkbabb/glass-ui 3.11.2 → 3.13.0

package/dist/components/custom/dock/index.d.ts

@@ -7,7 +7,10 @@ export { default as DockTabButton } from "./DockTabButton.vue";
 export { default as DockSelectTrigger } from "./DockSelectTrigger.vue";
 export { default as DockDropdownTrigger } from "./DockDropdownTrigger.vue";
 export { default as DockSeparator } from "./DockSeparator.vue";
+export { default as DockRail } from "./DockRail.vue";
+export type { DockRailItem } from "./constants";
 export type { UseDockStateOptions, UseDockStateReturn, DockState } from "./composables";
 export { useLayerTransition } from "./composables";
 export type { UseLayerTransitionOptions, UseLayerTransitionReturn, } from "./composables";
 export { DOCK_CONTEXT_KEY, useDockContext, useOptionalDockContext, provideDockContext, type DockContext, type DockOrientation, type DockLayout, } from "./composables/dockContext";
+export { useDockOrientationMorph, type DockMorphOrientation, type UseDockOrientationMorphOptions, type UseDockOrientationMorphReturn, } from "./composables/useDockOrientationMorph";

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

@@ -6,20 +6,6 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     expandLabel?: string;
     /** Accessible name for the collapse (exit fullscreen) button. */
     collapseLabel?: string;
-    /**
-     * Opt into the `gl-expand` plate → fullscreen MORPH (D6.c M7). When set,
-     * the inline anchor and the teleported fullscreen surface share ONE
-     * `view-transition-name` (this prop, suffixed by an app-unique `useId()`
-     * so two ExpandableContainers on a page never collide their groups — the
-     * proof:vt-names mandate), and the open/close toggle is wrapped in
-     * `startViewTransition` so the plate's rect MORPHS to the fullscreen rect
-     * (and back) instead of jump-cutting. A passed string namespaces the pair
-     * (e.g. `"chart"`); pass an empty string for a bare `useId()` name.
-     * Omitted (default) ⇒ NO view-transition-name, the legacy instant toggle —
-     * byte-identical to the pre-M7 behaviour. PRM + unsupported engines take
-     * `startViewTransition`'s instant fallback (the open/close still runs).
-     */
-    viewTransitionName?: string;
 } & {
     /**
      * Two-way `open` model so consumers can drive fullscreen externally
@@ -27,13 +13,7 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
      * buttons continue to operate without parent wiring.
      */
     open?: boolean;
-}, {
-    anchorEl: Readonly<import("vue").ShallowRef<HTMLElement | null>>;
-    surfaceEl: Readonly<import("vue").ShallowRef<HTMLElement | null>>;
-    expand: () => void;
-    collapse: () => void;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    settle: (fullscreen: boolean) => any;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:open": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<{
     buttonPosition?: "left" | "right";
@@ -41,20 +21,6 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     expandLabel?: string;
     /** Accessible name for the collapse (exit fullscreen) button. */
     collapseLabel?: string;
-    /**
-     * Opt into the `gl-expand` plate → fullscreen MORPH (D6.c M7). When set,
-     * the inline anchor and the teleported fullscreen surface share ONE
-     * `view-transition-name` (this prop, suffixed by an app-unique `useId()`
-     * so two ExpandableContainers on a page never collide their groups — the
-     * proof:vt-names mandate), and the open/close toggle is wrapped in
-     * `startViewTransition` so the plate's rect MORPHS to the fullscreen rect
-     * (and back) instead of jump-cutting. A passed string namespaces the pair
-     * (e.g. `"chart"`); pass an empty string for a bare `useId()` name.
-     * Omitted (default) ⇒ NO view-transition-name, the legacy instant toggle —
-     * byte-identical to the pre-M7 behaviour. PRM + unsupported engines take
-     * `startViewTransition`'s instant fallback (the open/close still runs).
-     */
-    viewTransitionName?: string;
 } & {
     /**
      * Two-way `open` model so consumers can drive fullscreen externally
@@ -63,10 +29,8 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
      */
     open?: boolean;
 }> & Readonly<{
-    onSettle?: ((fullscreen: boolean) => any) | undefined;
     "onUpdate:open"?: ((value: boolean) => any) | undefined;
 }>, {
-    viewTransitionName: string;
     buttonPosition: "left" | "right";
     expandLabel: string;
     collapseLabel: string;
@@ -74,6 +38,10 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     default?: (props: {
         fullscreen: boolean;
     }) => any;
+} & {
+    default?: (props: {
+        fullscreen: boolean;
+    }) => any;
 }>;
 type __VLS_WithSlots<T, S> = T & {
     new (): {

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

@@ -1,6 +1,6 @@
 import type { ColorResolver } from "../../../composables/color";
 export { default as FourierField } from "./FourierField.vue";
-export { comp, positionsAt, makeEllipticSpectrum, type BasisComponent, type EllipticSpectrumOptions, } from "./math";
+export { comp, positionsAt, dftFromPoints, makeEllipticSpectrum, type BasisComponent, type EllipticSpectrumOptions, } from "./math";
 /** The configuration-BUNDLE axis — `hero` (epicycles on, fewer harmonics) vs
  *  `final` (epicycles off, denser). Not a recolour of one curve; one engine,
  *  two presets. */

package/dist/components/custom/fourier-field/math.d.ts

@@ -23,6 +23,23 @@ export declare function comp(index: number, re: number, im: number): BasisCompon
  * carries).
  */
 export declare function positionsAt(components: BasisComponent[], t: number, maxCircles?: number): [number, number][];
+/**
+ * The forward DFT — the inverse of {@link positionsAt}. Takes a closed sequence
+ * of `[x, y]` samples around a curve (treated as the complex signal `x + i·y`,
+ * uniformly spaced in the parameter `t ∈ [0, 1)`) and returns the
+ * {@link BasisComponent} spectrum that {@link positionsAt} reconstructs.
+ *
+ * Frequencies run symmetrically around 0 — `0, +1, -1, +2, -2, …` up to the
+ * Nyquist limit — which is the index ordering the epicycle chain wants (the big
+ * low-order phasors first). The DC term (`index 0`) is the curve's centroid; the
+ * caller can subtract it (draw the chain centered) or keep it (draw at the
+ * sampled position).
+ *
+ * General: any point set drives it (a glyph outline, a hand-traced path, a
+ * digitized signature). It is NOT a special case — it is the literal forward
+ * transform whose inverse already ships as `positionsAt`.
+ */
+export declare function dftFromPoints(points: [number, number][]): BasisComponent[];
 /** Tuning for {@link makeEllipticSpectrum}. */
 export interface EllipticSpectrumOptions {
     /**

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

@@ -0,0 +1,54 @@
+export interface VariantPreset {
+    /** Higher-order harmonics layered over the dominant counter-rotating pair. */
+    harmonics: number;
+    /** Peak magnitude of those harmonics relative to the dominant phasor. */
+    harmonicScale: number;
+    /** Draw the nested epicycle circles + arms underneath the curve. */
+    epicycles: boolean;
+    /** Comet-trail capacity (frames of head history). ~1/3 of the period so the
+     *  comet reads as a substantial arc, not a stub (the fourier-analysis bar). */
+    trailLength: number;
+    /** Hue offset (degrees) of the epicycle second hue away from the outline hue. */
+    epicycleHueShift: number;
+    /** Forward-clock period for one full curve traversal, in ms. */
+    durationMs: number;
+    /** A constant per-variant seed used under `freeze` so a capture is deterministic. */
+    frozenSeed: string;
+    /** 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. */
+    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. */
+    trailWidth: number;
+    /** Head-glow alpha — the STRONGEST layer (head-forward: > peakAlpha). */
+    headGlowAlpha: number;
+    /** Head-glow `shadowBlur` bloom radius, in px. */
+    headGlowBlur: number;
+    /** The comet HEAD DOT radius in CSS px (the reference's glowing tip — a
+     *  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. */
+    epicycleRatios: {
+        circle: number;
+        arm: number;
+    };
+    /** Epicycle circle / arm stroke weights in CSS px (the reference uses a bold
+     *  ≈2.5/2 chain, the joints carry filled dots). */
+    epicycleWidths: {
+        circle: number;
+        arm: number;
+    };
+    /** Paint the epicycle chain as a rainbow across the spectrum (the
+     *  fourier-analysis signature) vs one analogous second hue. Hero only. */
+    epicycleRainbow: boolean;
+    /** Trail persistence exponent — SOFT (1..2), never the quadratic that kills the body. */
+    trailFadeExp: number;
+    /** Min trail alpha ÷ peak — the body survives, never decays to 0. The
+     *  reference body reads near-uniform; the floor sits HIGH (≈0.35) so the
+     *  comet body has real presence on cream too (the light-mode floor fork). */
+    trailFloor: number;
+}
+export declare const PRESETS: Record<"hero" | "final", VariantPreset>;

package/dist/components/custom/goo-blob/composables/buildMetaballProgram.d.ts

@@ -0,0 +1,18 @@
+import { type MetaballUniformLocations } from "./uploadBlobUniforms";
+/** The compiled-program handles the renderer closes over + tears down. */
+export interface MetaballProgram {
+    prog: WebGLProgram;
+    vs: WebGLShader;
+    fs: WebGLShader;
+    vao: WebGLVertexArrayObject;
+    buf: WebGLBuffer;
+    locs: MetaballUniformLocations;
+}
+/**
+ * Compile the metaball shader, build the full-quad VAO, and resolve the uniform
+ * location cache on a fresh context. Leaves `BLEND` enabled with the
+ * premultiplied-alpha `(ONE, ONE_MINUS_SRC_ALPHA)` blend func (the source's
+ * setup), `prog` in use, and the VAO bound — the caller's `resize`/`drawFrame`
+ * re-bind as needed.
+ */
+export declare function buildMetaballProgram(gl: WebGL2RenderingContext): MetaballProgram;

package/dist/components/custom/goo-blob/composables/uploadBlobUniforms.d.ts

@@ -0,0 +1,41 @@
+import type { BlobConfig, MoodParams } from "../types";
+import type { BlobPointer } from "./useBlobPointer";
+import type { BlobSatelliteSystem } from "./useBlobSatellites";
+import { MAX_SATS, TRAIL_N, MAX_BLOB_STOPS, POS_SCALE, UNIFORM_NAMES } from "../constants";
+import type { UniformName } from "../constants";
+export { MAX_SATS, TRAIL_N, MAX_BLOB_STOPS, POS_SCALE, UNIFORM_NAMES };
+export type { UniformName };
+/** The cached uniform-location set the GL setup builds once per context. */
+export interface MetaballUniformLocations {
+    U: Record<UniformName, WebGLUniformLocation | null>;
+    satPosLocs: (WebGLUniformLocation | null)[];
+    satRadLocs: (WebGLUniformLocation | null)[];
+    satOpLocs: (WebGLUniformLocation | null)[];
+    trailPosLocs: (WebGLUniformLocation | null)[];
+    trailRadLocs: (WebGLUniformLocation | null)[];
+    paletteLocs: (WebGLUniformLocation | null)[];
+}
+/** The per-frame state the renderer resolves and hands to the upload leaf. */
+export interface BlobFrameState {
+    /** The mood params for this frame (`mood.params.value`). */
+    params: MoodParams;
+    /** The resolved base-color gamma-sRGB triple. */
+    rgb: [number, number, number];
+    /** The tempo-integrated motion clock (ms). */
+    simTimeMs: number;
+    /** The substrate's seconds clock for this frame (the pulse-phase axis). */
+    timeSec: number;
+    /** A CONCRETE → gamma-sRGB triple resolver (the renderer's memoised `/color` leaf). */
+    resolveColor: (css: string) => [number, number, number];
+    /** The Fresnel rim color (CONCRETE — the SFC un-wrapped any var()-token). */
+    rimColor: string;
+    /** The multi-stop palette (CONCRETE strings; EMPTY → falls back to base). */
+    paletteStops: string[];
+}
+/**
+ * Write the resolved frame state into the metaball program's uniforms and issue
+ * the draw call. Pure: it mutates GL state only (the bound program/VAO + the
+ * uniform values) and never reads the renderer's closure. The body is the
+ * byte-identical lift of the prior inline `drawFrame` uniform-upload section.
+ */
+export declare function uploadBlobUniforms(gl: WebGL2RenderingContext, prog: WebGLProgram, vao: WebGLVertexArrayObject, locs: MetaballUniformLocations, canvas: HTMLCanvasElement, config: BlobConfig, pointer: BlobPointer, satellites: BlobSatelliteSystem, frame: BlobFrameState): void;

package/dist/components/custom/goo-blob/composables/useBlobPointer.d.ts

@@ -1,6 +1,7 @@
 import { type Ref } from "vue";
-/** Compile-time trail length — mirrors `TRAIL_N` in metaball.frag.ts. */
-export declare const TRAIL_N = 15;
+import { TRAIL_N } from "../constants";
+/** Compile-time trail length — re-exported from the co-located shape budget (`../constants`). */
+export { TRAIL_N };
 /** A single trail sample — a decaying-radius metaball source the shader smin-merges. */
 export interface TrailSample {
     x: number;
@@ -13,7 +14,7 @@ export interface TrailSample {
  * FRAME-RATE-INDEPENDENT critically-damped spring fed the renderer's per-frame
  * `dtMs` (NOT a fixed-α lerp — the prior `SMOOTH_FACTOR = 0.12` was framerate
  * dependent). The spring is `@mkbabb/keyframes.js` `SpringProgress` driven through
- * its `tick(dt)` seam by the SUBSTRATE's single rAF — it does NOT call
+ * its `tickDt(dtMs)` seam by the SUBSTRATE's single rAF — it does NOT call
  * `SpringProgress.play()` (that would start a parallel rAF, the
  * single-substrate-loop violation `proof:blob-interaction-prm` forbids).
  *

package/dist/components/custom/goo-blob/composables/useMetaballRenderer.d.ts

@@ -24,14 +24,20 @@ export interface UseMetaballRendererOptions {
     satellites: BlobSatelliteSystem;
     config: BlobConfig;
 }
+/** The renderer's public control surface — pause/resume the demand loop. */
+export interface UseMetaballRendererReturn {
+    pause: () => void;
+    resume: () => void;
+}
 /**
  * The GooBlob WebGL renderer — composes the `useWebGLCanvas` substrate (AU.W6).
  *
  * This module owns ONLY the metaball-specific concerns: compiling the shader,
- * building the quad + uniform cache, and uploading the per-frame uniforms derived
- * from the mood / pointer / satellite systems and the resolved base color. The
- * generic WebGL2 lifecycle — context creation, the suspend/resume model, the
- * demand-driven rAF loop, the tab-visibility owner, the ResizeObserver, and the
+ * building the quad + uniform cache (the `buildMetaballProgram` leaf), and
+ * uploading the per-frame uniforms (the `uploadBlobUniforms` leaf) derived from the
+ * mood / pointer / satellite systems and the resolved base color. The generic
+ * WebGL2 lifecycle — context creation, the suspend/resume model, the demand-driven
+ * rAF loop, the tab-visibility owner, the ResizeObserver, and the
  * webglcontextlost/restored robustness — lives in the substrate; this renderer
  * threads its behaviour through the substrate's
  * `setup`/`frame`/`shouldContinue`/`resize`/`teardown` callbacks. It does NOT call
@@ -43,7 +49,4 @@ export interface UseMetaballRendererOptions {
  * a `var(--token)` — the SFC's `resolveTokenColor` leaf does that BEFORE handing
  * concrete strings here (inv-K-3 seam); the value.js 1×1-canvas DOM probe is gone.
  */
-export declare function useMetaballRenderer(options: UseMetaballRendererOptions): {
-    pause: () => void;
-    resume: () => void;
-};
+export declare function useMetaballRenderer(options: UseMetaballRendererOptions): UseMetaballRendererReturn;

package/dist/components/custom/goo-blob/constants.d.ts

@@ -0,0 +1,52 @@
+import type { BlobMood, MoodParams } from "./types";
+/** Compile-time satellite cap — mirrors `uSat*[N]` in metaball.frag.ts. */
+export declare const MAX_SATS = 4;
+/** Compile-time trail length — mirrors the `uTrail*[N]` arrays in metaball.frag.ts. */
+export declare const TRAIL_N = 15;
+/** Compile-time palette cap — mirrors `#define MAX_BLOB_STOPS` in metaball-uniforms.glsl.ts. */
+export declare const MAX_BLOB_STOPS = 4;
+/**
+ * Canvas is CSS-sized 1.6x its layout wrapper (see GooBlob.vue). Positions are in
+ * [-0.5, 0.5] normalized space mapped to canvas UVs. To make the layout footprint
+ * represent the "visible blob region" and have the extra 60% of canvas serve as
+ * overflow margin for satellite orbits, scale all length-like uniforms by
+ * 1/1.6 = 0.625.
+ */
+export declare const POS_SCALE: number;
+/** The full ordered scalar/vector uniform-name list the program builder caches a location per. */
+/** A point in the 2-axis circumplex affect space. */
+export interface AffectPoint {
+    /** Pleasantness, -1 (unpleasant) .. +1 (pleasant). */
+    valence: number;
+    /** Activation, 0 (calm/sleepy) .. 1 (energized/excited). */
+    arousal: number;
+}
+/** The five named moods as POINTS in the {valence, arousal} circumplex. */
+export declare const MOOD_AVA: Record<BlobMood, AffectPoint>;
+/**
+ * Derive the full MoodParams from a {valence, arousal} point. Arousal drives the
+ * motion energy (orbit speed, wobble, pulse rate/amp, noise, the iridescence/SSS
+ * sheen); valence warms the palette (hue range, chroma, brightness) and the
+ * pointer lean. ONE principled surface — the five named moods are samples of it.
+ */
+export declare function paramsFor({ valence, arousal }: AffectPoint): MoodParams;
+/** The resolved per-mood target params (samples of the `paramsFor` surface). */
+export declare const MOOD_TARGETS: Record<BlobMood, MoodParams>;
+/** The per-mood cross-fade duration (ms). */
+export declare const TRANSITION_MS: Record<BlobMood, number>;
+/** Idle timeout (ms of no pointer) after which the blob drifts to `sleepy`. */
+export declare const IDLE_SLEEP_MS = 6000;
+/** Click-impulse spring ring frequency (rad/s). */
+export declare const PULSE_OMEGA = 18;
+/** Click-impulse spring damping (< 1 = underdamped, overshoot-then-settle). */
+export declare const PULSE_ZETA = 0.35;
+/** The at-rest epsilon — velocity/position below this is "settled" (the park gate). */
+export declare const REST_EPS = 0.001;
+/** Base satellite opacity. */
+export declare const BASE_OPACITY = 0.75;
+/** Duration (ms) to blend from emerge endpoint into live orbit — eliminates snap. */
+export declare const ORBIT_BLEND_MS = 2000;
+/** Minimum spacing (ms) between satellite merge events. */
+export declare const MERGE_STAGGER_MS = 3000;
+export declare const UNIFORM_NAMES: readonly ["uResolution", "uTime", "uBaseColor", "uPointer", "uPointerActive", "uPointerAttraction", "uPointerStrength", "uBodyRadius", "uPulsePhase", "uPulseAmp", "uNoiseAmp", "uNoiseFreq", "uNoiseSpeed", "uWarpAmp", "uSmoothK", "uMerge", "uMaxReach", "uLit", "uRimColor", "uLightDir", "uSpecStrength", "uSpecShininess", "uRimPower", "uRimStrength", "uIridescence", "uIridHue", "uIridSpeed", "uSssScale", "uSssPower", "uCoreGlow", "uHueRange", "uSatShift", "uBrightnessShift", "uColorNoiseFreq", "uColorNoiseSpeed", "uStopCount", "uSatCount", "uTrailCount", "uVelocity", "uStretch"];
+export type UniformName = (typeof UNIFORM_NAMES)[number];

package/dist/components/custom/goo-blob/shaders/metaball-uniforms.glsl.d.ts

@@ -0,0 +1 @@
+export declare const METABALL_UNIFORMS_GLSL = "#version 300 es\nprecision highp float;\n\nin vec2 vUv;\nout vec4 fragColor;\n\nuniform vec2 uResolution;\nuniform float uTime;\nuniform vec3 uBaseColor;\n\n// Multi-stop palette (W11.b) \u2014 2-4 in-family OKLCh stops (uploaded GAMMA sRGB, like\n// uBaseColor). uStopCount <= 1 falls back to uBaseColor (the single-color default,\n// zero regression). MAX_BLOB_STOPS is a compile-time #define.\n#define MAX_BLOB_STOPS 4\nuniform int uStopCount;\nuniform vec3 uPalette[MAX_BLOB_STOPS];\n\n// Pointer\nuniform vec2 uPointer;\nuniform float uPointerActive;\nuniform float uPointerAttraction;\nuniform float uPointerStrength;\n\n// Main body\nuniform float uBodyRadius;\n\n// Pulsation\nuniform float uPulsePhase;\nuniform float uPulseAmp;\n\n// Surface noise\nuniform float uNoiseAmp;\nuniform float uNoiseFreq;\nuniform float uNoiseSpeed;\n\n// Gooey\nuniform float uSmoothK;\nuniform float uMerge;   // 0 = quadratic smin, 1 = circular smin (rounder menisci)\n\n// AX.W16 (arm 5) \u2014 the PRE-FBM bounding-discard radius (UV space). main() early-outs\n// to a transparent write for any fragment OUTSIDE this radius BEFORE the two 3-octave\n// FBM calls + the OKLCh round-trip. The renderer uploads it PADDED by every\n// outward-expanding term (body + eccentric orbit + sat radius + smin band + FBM edge\n// amplitude + click-pulse + a lean/squash safety pad) so it NEVER clips the wet\n// meniscus (IQ: inflate the bound to match any outward op).\nuniform float uMaxReach;\n\n// Membrane \u2014 domain-warp strength on the FBM edge displacement (0 = plain fbm).\nuniform float uWarpAmp;\n\n// Lit glass surface (W9.b) \u2014 gated behind uLit so the flat fill stays default.\nuniform float uLit;             // 0 = flat fill (default), 1 = lit droplet\nuniform vec3 uRimColor;         // Fresnel rim tint (GAMMA sRGB, via the /color leaf)\nuniform vec3 uLightDir;         // normalized light direction (x, y, z)\nuniform float uSpecStrength;    // Blinn-Phong specular weight\nuniform float uSpecShininess;   // specular exponent (16-64, tight glint)\nuniform float uRimPower;        // Fresnel/Schlick exponent (~2-3)\nuniform float uRimStrength;     // Fresnel rim weight\n\n// Iridescence + fake subsurface (W11.a) \u2014 translucent-gel read.\nuniform float uIridescence;     // warm-pearl rim sheen weight (0 = off)\nuniform float uIridHue;         // base hue (radians) the cosine palette biases toward (warm)\nuniform float uIridSpeed;       // animated-thickness scroll for the iridescent t\nuniform float uSssScale;        // fast-SSS back-light weight\nuniform float uSssPower;        // fast-SSS exponent\nuniform float uCoreGlow;        // thickness-driven inner-luminosity lift\n\n// Color perturbation (perceptually uniform \u2014 OKLCh L/C/h)\nuniform float uHueRange;        // degrees of hue swing (converted to radians)\nuniform float uSatShift;        // OKLCh chroma swing\nuniform float uBrightnessShift; // OKLCh lightness bias\nuniform float uColorNoiseFreq;\nuniform float uColorNoiseSpeed;\n\n// Satellites (max 4)\n#define MAX_SATS 4\nuniform int uSatCount;\nuniform vec2 uSatPos[MAX_SATS];\nuniform float uSatRadius[MAX_SATS];\nuniform float uSatOpacity[MAX_SATS];\n\n// Pointer trail (W10) \u2014 a decaying-radius pseudopod toward the cursor. uTrail is a\n// COMPILE-TIME-SIZED array (GLSL ES 3.00 forbids a uniform-sized array) with a\n// DYNAMIC break on uTrailCount, mirroring the satellite loop. Later samples paint\n// smaller metaballs (r *= 1 - i/N) so the trail tapers into a tail.\n#define TRAIL_N 15\nuniform int uTrailCount;\nuniform vec2 uTrailPos[TRAIL_N];\nuniform float uTrailRadius[TRAIL_N];\n\n// Velocity-driven volume-preserving squash-and-stretch (W10).\nuniform vec2 uVelocity;   // smoothed pointer velocity (motion direction + speed)\nuniform float uStretch;   // squash-stretch magnitude (0 = off)\n\nconst float PI = 3.141592653589793;\n";

package/dist/components/custom/instrument-chassis/InstrumentChassis.vue.d.ts

@@ -28,8 +28,8 @@ export type InstrumentChassisVariant = "glass" | "spine";
  * the `<ChassisDivider>` adjacent to each — emit markup only when bound.
  * I gate `<header>`, `<footer>`, and the two dividers on `$slots.strip` /
  * `$slots.control` presence, so empty-slot consumers don't have to suppress
- * the markup with `display: none` overrides. Mirrors the `v-if="$slots.status"`
- * idiom InstrumentRail established.
+ * the markup with `display: none` overrides — the `v-if="$slots.status"`
+ * slot-gating idiom.
  *
  * The chassis owns the `--phase-color` cascade via `data-phase`; phase label,
  * hero number, and phase progress fill all read it through one CSS custom

package/dist/components/custom/labeled-field/LabeledField.vue.d.ts

@@ -16,6 +16,19 @@ import { type HTMLAttributes } from "vue";
  * cursor-help). The previous mixed `text-base` / `text-lg` literals
  * harmonise on a single body-size token.
  *
+ * AZ.W-BLOB-REDRESS — `hideLabel` VISUALLY hides the field's own label (it
+ * renders `sr-only` instead of `.labeled-field-label`) while KEEPING it in the
+ * DOM, so the `for`/`id`/`aria-labelledby` control↔label association — the
+ * Slider thumb's `aria-labelledby`, the Select trigger's `for` — stays intact
+ * and the control is still accessibly named. The visible human label is then
+ * supplied by an enclosing chrome row (a `<ConfiguratorRow label>`). This is
+ * the canonical fix for the double-label leak: a `<ConfiguratorRow label="X">`
+ * wrapping a `<LabeledSlider label="x">` rendered BOTH labels (the human one +
+ * the raw config key); the inner control passes `hide-label` so ONE visible
+ * human label remains, the raw key demotes to the row's mono `name` token, and
+ * a11y is preserved. The tooltip is suppressed when hidden (the row owns the
+ * affordance). NO effect on `LabeledField` used standalone (default `false`).
+ *
  * AQ.W4 §W4.5 — `required` threads a `aria-hidden` asterisk onto the label
  * (the `required` attr on the slotted control is the semantic carrier). The
  * `error` slot renders an error-message region that the W3.1c
@@ -24,12 +37,36 @@ import { type HTMLAttributes } from "vue";
  * default slot's `errorId` slot-prop so the slotted control can bind
  * `aria-errormessage="errorId"` (the four wrappers auto-wire it; a raw
  * `<LabeledField>` slot binds it manually).
+ *
+ * # LabeledField vs ConfiguratorRow — recorded divergence (AZ.W-METRIC-UNIFY §B)
+ *
+ * Both are "label (+ meta) above/beside a slotted control", but they are NOT
+ * interchangeable — they emphasize DIFFERENT features:
+ *  - LabeledField (this) — for FORM fields. Carries the `for`/`id` label↔control
+ *    a11y wiring (`controlId`/`labelId`/`errorId`), the `tooltip`, the `required`
+ *    asterisk, and the `aria-live` `error` region.
+ *  - ConfiguratorRow — for TOKEN / PRESET controls. Carries the token-`name`
+ *    reference, the opt-in `reset` affordance (`canReset`), and the four-rung
+ *    `density` axis. No a11y for/id wiring.
+ *
+ * Reach for LabeledField for accessible form inputs; reach for ConfiguratorRow
+ * inside a `<Configurator>` for token sliders/selects. The divergence is recorded
+ * (NOT a forced merge — no ≥2-consumer shared-chassis need surfaced) in
+ * `docs/precepts/design-idioms.md §9`, alongside the `cn`/`focus-ring` keeps.
  */
 type __VLS_Props = {
     label: string;
     tooltip?: string;
     labelClass?: HTMLAttributes["class"];
     required?: boolean;
+    /**
+     * AZ.W-BLOB-REDRESS — render the field's own label `sr-only` (kept in the
+     * DOM for the control↔label a11y association) instead of visibly. Use when
+     * an enclosing chrome row already supplies the visible human label (a
+     * `<ConfiguratorRow label>`), so the inner control does not leak a second
+     * (often raw-config-key) label. Default `false` (standalone behavior).
+     */
+    hideLabel?: boolean;
 };
 declare var __VLS_7: {
     errorId: string;

package/dist/components/custom/labeled-field/LabeledSelect.vue.d.ts

@@ -8,6 +8,12 @@ type __VLS_Props = {
     labelClass?: string;
     /** AQ.W4 §W4.5 — thread the required-field asterisk onto the label. */
     required?: boolean;
+    /**
+     * AZ.W-BLOB-REDRESS — render the label `sr-only` (kept for a11y, hidden
+     * visually) when an enclosing chrome row (a `<ConfiguratorRow>`) already
+     * supplies the visible human label. Avoids the double-label leak.
+     */
+    hideLabel?: boolean;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: string) => any;

package/dist/components/custom/labeled-field/LabeledSlider.vue.d.ts

@@ -8,6 +8,12 @@ type __VLS_Props = {
     step: number;
     /** AQ.W4 §W4.5 — thread the required-field asterisk onto the label. */
     required?: boolean;
+    /**
+     * AZ.W-BLOB-REDRESS — render the label `sr-only` (kept for a11y, hidden
+     * visually) when an enclosing chrome row (a `<ConfiguratorRow>`) already
+     * supplies the visible human label. Avoids the double-label leak.
+     */
+    hideLabel?: boolean;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: number) => any;

package/dist/components/custom/labeled-field/LabeledSwitch.vue.d.ts

@@ -5,6 +5,12 @@ type __VLS_Props = {
     labelClass?: string;
     /** AQ.W4 §W4.5 — thread the required-field asterisk onto the label. */
     required?: boolean;
+    /**
+     * AZ.W-BLOB-REDRESS — render the label `sr-only` (kept for a11y, hidden
+     * visually) when an enclosing chrome row (a `<ConfiguratorRow>`) already
+     * supplies the visible human label. Avoids the double-label leak.
+     */
+    hideLabel?: boolean;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:checked": (value: boolean) => any;

package/dist/components/custom/metric-badge/MetricBadge.vue.d.ts

@@ -1,9 +1,10 @@
 import type { HTMLAttributes } from 'vue';
-type MetricBadgeSize = 'sm' | 'md' | 'lg' | 'xl';
-type MetricBadgeLabelPosition = 'inline' | 'stacked';
-type MetricBadgeVariant = 'default' | 'record';
-type __VLS_Props = {
-    amount: string | number | null | undefined;
+import { type MetricValue } from '../../../utils';
+export type MetricBadgeSize = 'sm' | 'md' | 'lg' | 'xl';
+export type MetricBadgeLabelPosition = 'inline' | 'stacked';
+export interface MetricBadgeProps {
+    /** The primary metric. A valid `0` renders `"0"`, never the placeholder. */
+    value: MetricValue;
     unit?: string;
     /** Full annotation slot, rendered as a sibling `<span>` with classnames
      *  `metric-badge__label metric-badge__label--full`. Tracked uppercase,
@@ -21,27 +22,19 @@ type __VLS_Props = {
      *  the label slot does not render even if `label`/`abbreviation` carry
      *  values. */
     labelPosition?: MetricBadgeLabelPosition;
-    /** Color applied to the amount when it's truthy. */
+    /** Color applied to the value when it's non-empty. */
     color?: string;
-    /** Substitute glyph when amount is empty. */
+    /** Substitute glyph when value is empty (null / undefined / ""). */
     placeholder?: string;
     /** Typographic scale. Defaults to `md`. The ladder reads
      *  sm 11px / md 12px / lg 14px / xl 18px; `xl` is the audacious-poster
-     *  rung (`text-mono-prose` amount, `text-prose` unit) for hero
+     *  rung (`text-mono-prose` value, `text-prose` unit) for hero
      *  placements that need to read at chassis distance. */
     size?: MetricBadgeSize;
-    /** Surface register. `default` is the canonical 5-tier glass pill;
-     *  `record` is the GILT pill (D6.b) — a 1px `--gold-rim` tooled edge +
-     *  `--gold-ink` amount + a faint ≤8% gold wash (never opaque). Gold marks
-     *  the SUPERLATIVE, exactly one per view: the all-time-high / peak figure.
-     *  The medal reads as earned, not as a fourth data color. */
-    variant?: MetricBadgeVariant;
     class?: HTMLAttributes['class'];
-};
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+}
+declare const __VLS_export: import("vue").DefineComponent<MetricBadgeProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<MetricBadgeProps> & Readonly<{}>, {
     size: MetricBadgeSize;
-    variant: MetricBadgeVariant;
-    placeholder: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/custom/metric-badge/index.d.ts

@@ -1 +1,2 @@
 export { default as MetricBadge } from "./MetricBadge.vue";
+export type { MetricBadgeProps, MetricBadgeSize, MetricBadgeLabelPosition, } from "./MetricBadge.vue";

package/dist/components/custom/metric-cell/MetricCell.vue.d.ts

@@ -1,4 +1,5 @@
 import type { Component, FunctionalComponent, HTMLAttributes } from "vue";
+import { type MetricValue } from "../../../utils";
 /**
  * Permissive icon type — Vue's `Component` type ships across multiple
  * package boundaries (vue / @vue/runtime-core duplication when consumers
@@ -54,13 +55,24 @@ export interface MetricCellProps {
     iconStrokeWidth?: number;
     /** Icon pixel size — defaults to 14 (matches `text-micro` cap height). */
     iconSize?: number;
+    /**
+     * Optional accent colour for the LEADING GLYPH ONLY (e.g. a semantic
+     * `var(--chart-download)` viz colour). Tints the icon — the one
+     * deliberate colour event for the cell — while the label, value, and unit
+     * stay neutral ink (the one-color-event proportion rule, AZ.W-SUFFUSE D3).
+     * Unset (default) keeps the glyph the neutral `--muted-foreground` of the
+     * label row.
+     */
+    iconColor?: string;
     /** Label text — reads through the `label` slot when set. */
     label?: string;
-    /** Value — primary metric. Reads through the `value` slot when set. */
-    value?: string | number | null | undefined;
+    /** Value — primary metric. Reads through the `value` slot when set. A valid
+     *  `0` renders `"0"`, never the placeholder. */
+    value?: MetricValue;
     /** Unit suffix appended after the value (e.g. "Mbps", "ms"). */
     unit?: string;
-    /** Placeholder glyph when value is empty/null. Defaults to em-dash. */
+    /** Placeholder glyph when value is empty/null. Defaults to em-dash (the
+     *  shared `coalesceMetric` default). */
     placeholder?: string;
     /**
      * Visual register.
@@ -82,7 +94,6 @@ type __VLS_Slots = {} & {
     value?: (props: typeof __VLS_10) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<MetricCellProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<MetricCellProps> & Readonly<{}>, {
-    placeholder: string;
     appearance: MetricCellAppearance;
     iconStrokeWidth: number;
     iconSize: number;

package/dist/components/custom/metric-stack/MetricRow.vue.d.ts

@@ -1,4 +1,5 @@
 import type { HTMLAttributes, Component } from "vue";
+import { type MetricValue } from "../../../utils";
 /**
  * MetricRow — a single row inside <MetricStack>.
  *
@@ -39,11 +40,13 @@ export interface MetricRowProps {
     iconSize?: number;
     /** Label text — reads through the label slot when set. */
     label?: string;
-    /** Value text (the audacious-poster hero number). */
-    value?: string | number | null | undefined;
+    /** Value text (the audacious-poster hero number). A valid `0` renders
+     *  `"0"`, never the placeholder. */
+    value?: MetricValue;
     /** Unit suffix — reads through the unit slot when set. */
     unit?: string;
-    /** Placeholder glyph when value is empty/null. Defaults to "—". */
+    /** Placeholder glyph when value is empty/null. Defaults to "—" (the shared
+     *  `coalesceMetric` default). */
     placeholder?: string;
     /**
      * Per-row phase colour. Sets `--phase-color` inline so descendant
@@ -87,7 +90,6 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_base: import("vue").DefineComponent<MetricRowProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<MetricRowProps> & Readonly<{}>, {
     active: boolean;
-    placeholder: string;
     iconStrokeWidth: number;
     iconSize: number;
     digitCount: number;

package/dist/components/custom/tabs/constants.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Fallback for `--tab-indicator-max-stretch` when the cascade leaves it unset — the
+ * default ≈+8% travel-squish cap (AX.W53). `--stretch = 1 + frac · (cap − 1)`, so a
+ * full-width jump reaches the cap and a tiny hop stays near 1. The token is the
+ * authority; this is the no-token floor.
+ */
+export declare const DEFAULT_INDICATOR_MAX_STRETCH = 1.08;
+/**
+ * ms after the stretch opens before it releases back to fit (`--stretch → 1`) — the
+ * Material "grow then shrink" close. Rides the same snappy glide clock as the travel.
+ */
+export declare const INDICATOR_RELEASE_MS = 60;