@mkbabb/glass-ui 6.0.0 → 8.0.0

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

@@ -1,4 +1,4 @@
-import type { ConstellationPalette, ConstellationWellConfig } from "./constellationField";
+import type { ConstellationPalette, ConstellationWellConfig } from "./constellationField.js";
 /**
  * The reference layout width (px) the field's node geometry is authored against. A
  * live canvas's `k = width / BASE_WIDTH` scales every base-width length (the well
@@ -10,7 +10,7 @@ export declare const BASE_WIDTH = 1280;
  * color/alpha tokens are absent (SSR / no-token mount). The fallbacks mirror the §5c
  * light-arm token defaults so a no-token mount still reads recessive-but-legible.
  *
- * `accent`/`edgeFloor`/`edgeAccentAlpha` (AZ.W-CON-GEN G3) are the ACCENT-edge skin
+ * `accent`/`edgeFloor`/`edgeAccentAlpha` are the accent-edge skin
  * weights the optional `drawEdges(…, accentIndex)` pass reads — the flagged-node EDGE
  * tint. `accent` mirrors the `--constellation-accent` neutral library default;
  * `edgeFloor: 0` is the byte-identity (no floor by default — a consumer lifts it so a
@@ -26,7 +26,7 @@ export declare const DEFAULT_PALETTE: ConstellationPalette;
 export declare const WARP_RESPONSE = 0.55;
 export declare const WARP_ZETA = 1;
 /**
- * Gravity-well tuning DEFAULTS (AY.W-CON2). The `--constellation-well-*` tokens
+ * Gravity-well tuning defaults. The `--constellation-well-*` tokens
  * override these on mount via `field.well.cfg`; these stay the fallback. SET by the
  * §6 egg-live π readback (the field-perturbs-then-cools capture is the binding
  * truth) — a moderate gain over a generous reach, a brisk ramp, a tight no-slingshot
@@ -34,7 +34,7 @@ export declare const WARP_ZETA = 1;
  */
 export declare const DEFAULT_WELL_CONFIG: ConstellationWellConfig;
 /**
- * Auto-DRIFT cadence DEFAULTS (AY.W-CON1 source; tokenised in AY.W-CON2). The
+ * Auto-drift cadence defaults. The
  * `--constellation-wander-idle`/`-wander-jitter` tokens override these on mount; a
  * prop `{ minIdle, jitter }` still wins over the token. The 8s/8s default rhythm
  * re-targets the focal mark every 8–16s (the slides cadence).
@@ -42,7 +42,7 @@ export declare const DEFAULT_WELL_CONFIG: ConstellationWellConfig;
 export declare const DEFAULT_WANDER_IDLE = 8000;
 export declare const DEFAULT_WANDER_JITTER = 8000;
 /**
- * Autonomous PINNED-ANCHOR drift cadence DEFAULTS (AZ.W-CON-GEN G5). DISTINCT from
+ * Autonomous pinned-anchor drift cadence defaults. Distinct from
  * `wander` (which re-targets the WARP spring among random nodes): this gently eases
  * the PINNED node (`field.pinnedIndex`) around its seeded ANCHOR on a jittered
  * cadence — the flagged point breathes its neighborhood without leaving it. The
@@ -55,7 +55,7 @@ export declare const DEFAULT_PINNED_DRIFT_FRAC = 0.14;
 export declare const DEFAULT_PINNED_DRIFT_DUR = 2600;
 export declare const DEFAULT_PINNED_DRIFT_IDLE = 6000;
 export declare const DEFAULT_PINNED_DRIFT_JITTER = 8000;
-/** R5-8 — the shipped visual-size floor: `kVisOf` === `k` for every canvas
+/** The visual-size floor: `kVisOf` === `k` for every canvas
  *  ≥ ~0.72·BASE_WIDTH ≈ 922px (incl. the 1280 export frame — byte-identical
  *  there by construction); below it the marks stop crushing sub-pixel. */
 export declare const DEFAULT_K_FLOOR = 0.72;
@@ -72,9 +72,9 @@ export declare const E_MAX: number;
  * The pointer-parallax depth default (§6). Each node carries a seeded depth `z ∈ [0,1]`;
  * the pointer offsets node screen positions by `parallax · z · (pointer − center)` — a
  * cheap pointer-parallax giving the flat lattice apparent depth (the Awwwards "living
- * network" register). DEFAULT-OFF (`0` — the flat lattice). The prior default-on `0.08`
- * slid the WHOLE lattice ~58px on a center→corner pointer sweep (every node tracked the
- * cursor, read as a bug, not depth — `proof` D1-constellation live measure). Depth is now
+ * network" register). DEFAULT-OFF (`0` — the flat lattice). A default-on `0.08`
+ * slides the WHOLE lattice ~58px on a center→corner pointer sweep (every node tracks the
+ * cursor, reads as a bug, not depth). Depth is
  * OPT-IN: a consumer that wants the living-network parallax passes `parallax` (e.g. a
  * sub-perceptual `0.02`); the bare lattice never tracks the cursor.
  */

package/dist/components/constellation/constellationField.d.ts

@@ -1,10 +1,9 @@
-export { BASE_WIDTH } from "./constants";
-export type * from "./constellationTypes";
-import type { ConstellationNode, ConstellationField, ConstellationPointer } from "./constellationTypes";
+export type * from "./constellationTypes.js";
+import type { ConstellationNode, ConstellationField, ConstellationPointer } from "./constellationTypes.js";
 /**
  * Seed `count` drifting nodes inside `w × h`. `rng` is a `() => number` in
  * `[0, 1)` (the glass-ui `mulberry32`/`Math.random`); a seeded `rng` lays out a
- * reproducible field. Every node drifts; a focal node IS pinnable (AX.W17) — the
+ * reproducible field. Every node drifts; a focal node is pinnable — the
  * `field.focalIndex` designation + the engine-owned `warp` spring chase a node,
  * but the underlying node still drifts (warp re-points an EXISTING node, never
  * adds one, so node count is conserved).
@@ -12,7 +11,7 @@ import type { ConstellationNode, ConstellationField, ConstellationPointer } from
 export declare function seedField(rng: () => number, count: number, w: number, h: number, speed: number): ConstellationNode[];
 /**
  * Re-fit the existing lattice to a NEW canvas size, proportionally, ON the
- * size-change frame (AY.W-CON1). Without it a field seeded at a transitional
+ * size-change frame. Without it a field seeded at a transitional
  * size (the canvas measures mid responsive-scale — the deck slide-enter case)
  * keeps its small-canvas positions and DRIFTS out to fill the larger box at
  * `speed` px/frame — the visible "takes a while to expand out" lag the slides
@@ -29,18 +28,18 @@ export declare function refitField(field: ConstellationField, prevW: number, pre
  * their speed (the slow geometric drift is preserved). `k` is the scale factor.
  *
  * `dt` (seconds since the previous frame) advances the focal-node warp spring
- * via `warpStep` INSIDE this single per-frame call (AX.W17) — NO second rAF,
+ * via `warpStep` inside this single per-frame call — no second rAF,
  * NO `useSpring`. The warp rides the substrate's ONE parked rAF; a `dt` of `0`
  * (omitted / first frame) leaves the spring untouched.
  *
  * `now` (ms; default `0` — every existing caller stays green) + `rng` (default
- * `Math.random`) drive the optional auto-DRIFT cadence (AY.W-CON1): AFTER the
+ * `Math.random`) drive the optional auto-drift cadence: after the
  * warp step, if `field.wander` is set and `now > 0`, the cadence re-points
  * `setWarpTarget` to a random node when it elapses AND the spring has settled
  * (a click-warp in flight pre-empts the cadence — `warpSettled` reports false).
  */
 export declare function stepField(field: ConstellationField, k: number, speed: number, pointer: ConstellationPointer | null, dt?: number, now?: number, rng?: () => number, pointerVel?: ConstellationPointer | null): void;
-import type { ConstellationEdge } from "./constellationTypes";
+import type { ConstellationEdge } from "./constellationTypes.js";
 /**
  * Scan the proximity graph and return its edge SET (the `1 − d²/reach²` distance-falloff
  * weight per pair within `reach = link·k`). `accentIndex ≥ 0` marks the edges incident on
@@ -51,8 +50,7 @@ import type { ConstellationEdge } from "./constellationTypes";
  */
 export declare function buildEdges(field: ConstellationField, link: number, accentIndex?: number, eMax?: number): ConstellationEdge[];
 /**
- * Append the POINTER-WEB tether edges to an existing edge set (the `drawPointerWeb` math
- * relocated): the cursor is a "virtual node" whose incident edges (to every node within
+ * Append the POINTER-WEB tether edges to an existing edge set (the `drawPointerWeb` math): the cursor is a "virtual node" whose incident edges (to every node within
  * `reach`) carry `focus = 1` (the render strokes them at the focus alpha). No-op when the
  * pointer is inactive (`x < 0`). The `eMax` budget is shared with the ambient set.
  */

package/dist/components/constellation/constellationInteraction.d.ts

@@ -1,15 +1,12 @@
-import type { ConstellationField, ConstellationPinnedDrift, ConstellationWarpConfig, ConstellationWellConfig } from "./constellationField";
-import { DEFAULT_WANDER_IDLE, DEFAULT_WANDER_JITTER, DEFAULT_WELL_CONFIG, WARP_RESPONSE, WARP_ZETA, DEFAULT_PINNED_DRIFT_FRAC, DEFAULT_PINNED_DRIFT_DUR, DEFAULT_PINNED_DRIFT_IDLE, DEFAULT_PINNED_DRIFT_JITTER } from "./constants";
-export { DEFAULT_WANDER_IDLE, DEFAULT_WANDER_JITTER, DEFAULT_WELL_CONFIG, WARP_RESPONSE, WARP_ZETA };
-export { DEFAULT_PINNED_DRIFT_FRAC, DEFAULT_PINNED_DRIFT_DUR, DEFAULT_PINNED_DRIFT_IDLE, DEFAULT_PINNED_DRIFT_JITTER, };
+import type { ConstellationField, ConstellationPinnedDrift, ConstellationWarpConfig, ConstellationWellConfig } from "./constellationField.js";
 /**
  * Read the NUMERIC interaction-tuning tokens (the warp spring + the gravity-well
- * gains) off a canvas's resolved custom properties — ONCE on mount (AY.W-CON2),
+ * gains) off a canvas's resolved custom properties once on mount,
  * via `parseFloat`, NOT per-frame `getComputedStyle` (the hot loop stays clean).
  * Returns `{ warp, well }` configs the field carries; every member falls back to
  * the shipped default when the token is absent (an SSR / no-token mount reads the
  * byte-identical spring). The tokens are PLAIN numbers (`0.55`, `12000`), immune
- * to the W30 `light-dark()`-into-Canvas2D leak (they never reach a `fillStyle`).
+ * to the `light-dark()`-into-Canvas2D leak (they never reach a `fillStyle`).
  */
 export declare function readInteractionConfig(canvas: HTMLCanvasElement): {
     warp: ConstellationWarpConfig;
@@ -19,7 +16,6 @@ export declare function readInteractionConfig(canvas: HTMLCanvasElement): {
         jitter: number;
     };
 };
-export { stepWell } from "./constellationWell";
 /**
  * The nearest DRIFTING node to `(px, py)` in canvas-local px — a linear O(count)
  * min-d² scan (count 64 default — negligible; matches the O(count²) edge pass).
@@ -39,7 +35,7 @@ export declare function nearestNode(field: ConstellationField, px: number, py: n
  *
  *   x += v·dt ;  v += (−2ζω·v − ω²·(x − target))·dt
  *
- * Reads `(response, ζ)` from `field.warpCfg` (the tokenised override — AY.W-CON2),
+ * Reads `(response, ζ)` from `field.warpCfg` (the tokenised override),
  * falling back to the shipped `WARP_RESPONSE`/`WARP_ZETA` defaults. `ω = 2π/response`
  * is the keyframes.js `(response, dampingFraction)` convention (the SHARED house
  * model — `ω₀` is the angular frequency, `response` its ANGULAR PERIOD, NOT a
@@ -70,7 +66,7 @@ export declare function setWarpTarget(field: ConstellationField, idx: number): v
  */
 export declare function warpTo(field: ConstellationField, px: number, py: number): number;
 /**
- * Is the warp spring ARRIVED on its target (AY.W-CON1)? True when there is no
+ * Is the warp spring arrived on its target? True when there is no
  * active target (`targetIdx < 0`) OR the focal's gap to its LIVE target node is
  * within {@link WARP_SETTLE_BAND}. A click-warp in flight (hundreds of px out)
  * reports NOT arrived, so a user click always PRE-EMPTS the auto-drift cadence
@@ -81,7 +77,7 @@ export declare function warpTo(field: ConstellationField, px: number, py: number
  */
 export declare function warpSettled(field: ConstellationField): boolean;
 /**
- * Pick a random eligible node index for the auto-drift re-target (AY.W-CON1) —
+ * Pick a random eligible node index for the auto-drift retarget —
  * any node EXCEPT the current `focalIndex` (so the focal actually MOVES). `rng`
  * is the seeded `() => number` in `[0, 1)`. A degenerate field (≤1 node, or only
  * the current focal) returns the current focal, which `setWarpTarget` no-ops
@@ -89,7 +85,7 @@ export declare function warpSettled(field: ConstellationField): boolean;
  */
 export declare function pickWanderTarget(field: ConstellationField, rng: () => number): number;
 /**
- * Build the cold `ConstellationPinnedDrift` state (AZ.W-CON-GEN G5) the field carries
+ * Build the cold `ConstellationPinnedDrift` state the field carries
  * when `pinnedDrift` is on. The anchor is seeded LATER (on the first sized frame, off
  * the pinned node's layout position) — here it is `(0,0)` until `stepPinnedDrift`
  * stamps it on the first armed leg. The token-read re-points the un-overridden
@@ -102,13 +98,13 @@ export declare function makePinnedDrift(override?: {
     jitter?: number;
 }): ConstellationPinnedDrift;
 /**
- * Advance the autonomous PINNED-ANCHOR drift one frame (AZ.W-CON-GEN G5). DISTINCT
+ * Advance the autonomous pinned-anchor drift one frame. Distinct
  * from `wander` (warp re-target): this gently eases the PINNED node around its seeded
  * ANCHOR within `wanderFrac` of the canvas, on a jittered cadence, via a closed-form
  * easeInOutQuad over `now` (no integrator, no second rAF — it rides `stepField`'s ONE
  * per-frame call). No-ops (skipped) when there is no `field.pinnedDrift`, no pinned
  * node, or `now <= 0` (the default unit callers stay green) — so an absent
- * `pinnedDrift` is byte-identical to HEAD.
+ * `pinnedDrift` leaves the plain field untouched.
  *
  * The anchor is captured ON the first armed frame off the pinned node's CURRENT
  * position (its seeded rest), so a consumer that re-anchors the pin (a resize re-fit)

package/dist/components/constellation/constellationRender.d.ts

@@ -1,8 +1,6 @@
-import type { ConstellationEdge, ConstellationField, ConstellationPalette, ConstellationPointer, ConstellationRipple } from "./constellationTypes";
-import { DEFAULT_PALETTE } from "./constants";
+import type { ConstellationEdge, ConstellationField, ConstellationPalette, ConstellationPointer, ConstellationRipple } from "./constellationTypes.js";
 /** Visual sizes floor independently from field geometry. */
 export declare function kVisOf(field: ConstellationField): number;
-export { DEFAULT_PALETTE };
 /** Resolve the neutral palette and legibility weights from the canvas tokens. */
 export declare function readPalette(canvas: HTMLCanvasElement): ConstellationPalette;
 /** Paint the edge rows produced by the field's single `buildEdges` scan. */

package/dist/components/constellation/constellationTypes.d.ts

@@ -6,7 +6,7 @@ export interface ConstellationNode {
     r: number;
     dim: boolean;
     /**
-     * BC.W-VIZ-CONSTELLATION — the seeded parallax DEPTH (`z ∈ [0,1]`, §6). The pointer
+     * the seeded parallax DEPTH (`z ∈ [0,1]`, §6). The pointer
      * offsets the node's SCREEN position by `parallax · z · (pointer − center)` so the flat
      * lattice reads as having depth (the Awwwards "living network" register). Seeded in
      * `seedField`; perturbs the painted node position only (never field geometry). A
@@ -15,7 +15,7 @@ export interface ConstellationNode {
     z?: number;
 }
 /**
- * BC.W-VIZ-CONSTELLATION — ONE edge of the proximity graph, the row the CPU all-pairs scan
+ * ONE edge of the proximity graph, the row the CPU all-pairs scan
  * (`buildEdges`) writes each frame for the Canvas2D line pass. `a`/`b` are the
  * two endpoint positions in canvas-local CSS px; `alpha` is the distance-falloff weight
  * (`1 − d²/reach²`, the `drawEdges` math) the segment-quad fragment multiplies; `accent`
@@ -48,7 +48,7 @@ export interface ConstellationPointer {
 }
 /**
  * The neutral palette + legibility weights resolved off the canvas custom
- * properties (the FULL `--constellation-*` set — AX.W17). `node`/`nodeDim`/
+ * properties through the full `--constellation-*` set. `node`/`nodeDim`/
  * `line` are the colors; `edgeAlpha`/`edgeFocusAlpha`/`alpha` are the per-mode
  * legibility multipliers (replacing the `0.17`/`0.24` magic literals).
  */
@@ -56,28 +56,28 @@ export interface ConstellationPalette {
     node: string;
     nodeDim: string;
     line: string;
-    /** The hairline-edge alpha multiplier (was the `0.17` literal). */
+    /** The hairline-edge alpha multiplier. */
     edgeAlpha: number;
     /** The focus-proximity edge multiplier (consumer skins may read it). */
     edgeFocusAlpha: number;
     /** The field-yields-to-type translucency knob (the global field dimmer). */
     alpha: number;
     /**
-     * The ACCENT-edge skin tint (AZ.W-CON-GEN G3) — the flagged-node EDGE color the
+     * The accent-edge skin tint: the flagged-node edge color the
      * optional `drawEdges(…, accentIndex)` pass strokes for edges incident on the
      * accented node. Reads `--constellation-accent` (the consumer-preset boundary —
      * the library ships a neutral default; a consumer aliases it to its brand hue).
      */
     accent: string;
     /**
-     * The neutral-edge alpha FLOOR (AZ.W-CON-GEN G3) — added to a distance-faded
+     * The neutral-edge alpha floor, added to a distance-faded
      * neutral hairline's alpha so it clears the perceptual/sampling floor across its
      * full length on a bright ground (the "web doesn't read in light mode" fix).
      * Default `0` is byte-identical (no floor). Reads `--constellation-edge-floor`.
      */
     edgeFloor: number;
     /**
-     * The ACCENT-incident edge alpha multiplier (AZ.W-CON-GEN G3) — the per-mode
+     * The accent-incident edge alpha multiplier: the per-mode
      * weight for an edge touching the accented node. Reads
      * `--constellation-edge-accent-alpha`; the accented edges read a touch louder
      * than the neutral lattice (the flagged-node tether).
@@ -85,7 +85,7 @@ export interface ConstellationPalette {
     edgeAccentAlpha: number;
 }
 /**
- * The per-axis critically-damped warp spring on the focal node (AX.W17). The
+ * The per-axis critically damped warp spring on the focal node. The
  * focal mark's position is `(x, y)`; `vx`/`vy` its velocity; `targetIdx` the
  * LIVE node index it chases (re-read each frame so it tracks a DRIFTING target,
  * not a frozen click-time snapshot). `-1` = no active warp (the focal mark
@@ -100,8 +100,7 @@ export interface ConstellationWarp {
     targetIdx: number;
 }
 /**
- * The auto-DRIFT target-source (AY.W-CON1 — the 2nd half of the AX.W17 "drift +
- * warp are ONE mechanic" thesis). The warp re-points its focal node to a
+ * The auto-drift target source. The warp re-points its focal node to a
  * periodically-chosen RANDOM node on a jittered cadence: the SAME warp spring,
  * a different target-PICKER (a click for warp, this cadence for drift). No new
  * rAF, no second mechanic — `stepField` steps this cadence inline, re-pointing
@@ -120,14 +119,14 @@ export interface ConstellationWander {
     jitter: number;
 }
 /**
- * The autonomous PINNED-ANCHOR drift state (AZ.W-CON-GEN G5) — the gentle wander of
+ * The autonomous pinned-anchor drift state: the gentle wander of
  * the PINNED node (`field.pinnedIndex`) around its seeded ANCHOR. DISTINCT from
  * `wander` (which re-targets the WARP spring among random nodes): this eases ONE
  * designated node a small fraction around its rest position on a jittered cadence,
  * so a flagged point breathes its neighborhood without leaving the dead-space it was
  * anchored in. Stepped inside `stepField` (no second rAF) via a closed-form
  * easeInOutQuad over `now` — no integrator. Absent (`undefined`) → `stepField` skips
- * the block (byte-identical to HEAD).
+ * the block (the field is unchanged).
  */
 export interface ConstellationPinnedDrift {
     /** The anchor (the pinned node's rest position) the drift eases around (px). */
@@ -152,7 +151,7 @@ export interface ConstellationPinnedDrift {
     jitter: number;
 }
 /**
- * The warp-spring tuning the integrator reads (AY.W-CON2). Tokenised numeric (the
+ * The warp-spring tuning the integrator reads. Tokenised numeric (the
  * `--constellation-warp-*` cohort) so a consumer retunes the warp WITHOUT editing
  * src — read ONCE on mount via `parseFloat`, threaded onto the field.
  *
@@ -161,7 +160,7 @@ export interface ConstellationPinnedDrift {
  * settle-duration — at ζ=1 the 2%-settle lands at `t₂ ≈ 5.83/ω₀ ≈ 0.93·response`
  * (the `(1 + ω₀t)e^(−ω₀t)` critically-damped envelope). Documented here + in the
  * `--constellation-warp-response` token comment so the token semantics are honest
- * at ANY ζ (the AY.W-CON2 ω-reconcile; the engine keeps the keyframes.js convention,
+ * at ANY ζ (the ω-reconcile; the engine keeps the keyframes.js convention,
  * mints NO second ω formula).
  */
 export interface ConstellationWarpConfig {
@@ -171,7 +170,7 @@ export interface ConstellationWarpConfig {
     zeta: number;
 }
 /**
- * The gravity-well tuning (AY.W-CON2). The held-pointer pull is an inverse-square
+ * The gravity-well tuning. The held-pointer pull is an inverse-square
  * force composed into `stepField` (no new rAF). Tokenised numeric (the
  * `--constellation-well-*` cohort) so a consumer retunes the well WITHOUT editing
  * src. All distances are base-width px (`k`-scaled at step time).
@@ -185,7 +184,7 @@ export interface ConstellationWellConfig {
      * the ARM ramp rate (1/s) — `strength` eases toward `target = 1` at this rate
      * while HELD (the gentle bloom the token tunes). The RELEASE is NOT this rate:
      * it is the fixed brisk {@link WELL_RELEASE_RAMP} (the field-cools invariant —
-     * not consumer-tunable, F8.2). A consumer slowing this token slows the ARM
+     * not consumer-tunable). A consumer slowing this token slows the arm
      * bloom only; the release stays brisk so the cool gate holds.
      */
     ramp: number;
@@ -197,7 +196,7 @@ export interface ConstellationWellConfig {
     holdMs: number;
 }
 /**
- * The gravity-well live STATE (AY.W-CON2). `(x, y)` is the held pointer in
+ * The gravity-well live STATE. `(x, y)` is the held pointer in
  * canvas-local px (`-1` = inactive); `strength` is the eased pull 0→1 (ramps to
  * `target` at `cfg.ramp`/s); `target` is the strength the ramp eases toward (1
  * while held, 0 on release). A transient force — the field renormalises back to
@@ -216,10 +215,10 @@ export interface ConstellationWell {
 }
 /**
  * The field state the component exposes to its `drawOverlay` consumer so a
- * skin can pin itself to a real field node. `k` is the `width / BASE_WIDTH`
+ * skin can pin itself to a real field node. `k` is the `width, BASE_WIDTH`
  * scale, `dpr` the device-pixel ratio applied by the substrate.
  *
- * The focal node (AX.W17) is a FIRST-CLASS library concept: `focalIndex` names
+ * The focal node is a first-class library concept: `focalIndex` names
  * which node is focal (consumer-owned via `warpTo`), and the engine OWNS its
  * position via the `warp` spring stepped inside `stepField`. A `drawOverlay`
  * paints the focal mark at `field.warp.{x,y}` (the spring-eased position) —
@@ -234,7 +233,7 @@ export interface ConstellationField {
     h: number;
     k: number;
     dpr: number;
-    /** R5-8 — SIZES draw at `kVisOf(field)`; TRUE `k` keeps positions/reach. */
+    /** Visual sizes use `kVisOf(field)`; `k` keeps positions and reach. */
     kFloor?: number;
     /**
      * The designated focal node's INDEX, or `-1` when none is pinned. Re-points
@@ -242,52 +241,52 @@ export interface ConstellationField {
      * node). A `drawOverlay` reads `field.warp.{x,y}` for the spring-eased mark.
      */
     focalIndex: number;
-    /** The per-axis warp spring the engine steps inside `stepField` (AX.W17). */
+    /** The per-axis warp spring stepped by `stepField`. */
     warp: ConstellationWarp;
     /**
-     * The warp-spring tuning `warpStep` reads (AY.W-CON2). Optional — absent
-     * falls back to the shipped `{ response: 0.55, zeta: 1.0 }` defaults (the
-     * byte-identical HEAD spring). A tokenised override (read on mount) reaches
+     * The warp-spring tuning `warpStep` reads. Optional — absent
+     * falls back to the shipped `{ response: 0.55, zeta: 1.0 }` defaults.
+     * A tokenised override (read on mount) reaches
      * the integrator through this member.
      */
     warpCfg?: ConstellationWarpConfig;
     /**
-     * The optional auto-DRIFT cadence (AY.W-CON1). When set, `stepField`
+     * The optional auto-DRIFT cadence. When set, `stepField`
      * periodically re-points the warp to a random node (the wander source on the
-     * SAME spring). Absent (`undefined`) leaves the field BYTE-IDENTICAL to the
-     * pre-wander HEAD — `stepField` skips the cadence block entirely.
+     * SAME spring). Absent (`undefined`) leaves the field in its plain,
+     * un-wandering state — `stepField` skips the cadence block entirely.
      */
     wander?: ConstellationWander;
     /**
-     * The optional gravity-well (AY.W-CON2). When set, `stepField` composes a
+     * The optional gravity-well. When set, `stepField` composes a
      * held-pointer inverse-square pull force (no new rAF) — `well.target → 1`
      * while held, `→ 0` on release, the field renormalising back to `speed` once
-     * the well cools. Absent (`undefined`) leaves the field BYTE-IDENTICAL to the
-     * pre-well HEAD — `stepField` skips the force pass entirely.
+     * the well cools. Absent (`undefined`) leaves the field in its plain,
+     * un-well state — `stepField` skips the force pass entirely.
      */
     well?: ConstellationWell;
     /**
-     * The PINNED node designation (AZ.W-CON-GEN G1) — the index of a node `stepField`
+     * The pinned-node designation: the index of a node `stepField`
      * does NOT drift/bounce/steer/pull, so it HOLDS its seeded position (the flagged
      * flagged node the consumer pins). `-1` (the default) = no pin → every node drifts
-     * (byte-identical to HEAD). A designation, NOT a new node — node count is
+     * (unchanged at default). A designation, NOT a new node — node count is
      * conserved. The optional `pinnedDrift` gently wanders it around its anchor; the
      * optional `drawEdges(…, accentIndex)` tints its incident edges.
      */
     pinnedIndex: number;
     /**
-     * The optional autonomous PINNED-ANCHOR drift (AZ.W-CON-GEN G5). When set AND a
+     * Optional autonomous pinned-anchor drift. When set and a
      * node is pinned, `stepField` gently eases the pinned node around its anchor on a
      * jittered cadence (a closed-form easeInOutQuad — no second rAF). Absent
      * (`undefined`) → the pinned node holds dead-still at its anchor (byte-identical).
      */
     pinnedDrift?: ConstellationPinnedDrift;
     /**
-     * Warp AUTO-RELEASE (AZ.W-CON-GEN G6). When `true`, `stepField` clears the warp's
+     * Warp auto-release. When `true`, `stepField` clears the warp's
      * `targetIdx` (→ -1) once the spring has SETTLED on its target — the focal node
      * releases the spring and rides its node's RAW drift (the identity-ride), freeing
      * the spring for the next warp. Default `false`/undefined keeps the held-target
-     * behaviour (the warp chases its node forever — byte-identical to HEAD).
+     * behaviour (the warp chases its node forever — unchanged at default).
      */
     warpAutoRelease?: boolean;
 }
@@ -301,24 +300,13 @@ export interface ConstellationProps {
     count?: number;
     /** Link distance in px (the falloff reach). Default 132. */
     link?: number;
-    /** Drift speed. Default 0.16. */
-    speed?: number;
     /**
-     * BC.W-VIZ-CONSTELLATION (§6) — the pointer-PARALLAX depth. Each node carries a seeded
-     * depth `z ∈ [0,1]`; the pointer offsets node screen positions by `parallax · z ·
-     * (pointer − center)` so the flat lattice reads as having depth (the Awwwards "living
-     * network" register). Additive default-on at a SUB-PERCEPTUAL 0.08 (a hair of depth, not
-     * a behavior break); 0 = the flat lattice. It perturbs only the painted node position,
-     * never field geometry. Frozen under reduced-motion / `freeze`.
-     */
-    parallax?: number;
-    /**
-     * AY.W-COHERE E3 — the per-instance outer-envelope RECESSION knob (the aurora
-     * `opacityCeiling` / fourier `intensity` sibling — ONE recession vocabulary
+     * Per-instance outer-envelope recession (the Aurora
+     * `opacityCeiling`, fourier `intensity` sibling — ONE recession vocabulary
      * across the four live substrates). Scales the painted edge/node/web/ripple
      * alpha OVER the mode-tuned `--constellation-alpha` base so the lattice can
-     * RECEDE behind content (0.4–0.6 in a hero). Default `1` is byte-identical to
-     * HEAD.
+     * RECEDE behind content (0.4–0.6 in a hero). Default `1` is the
+     * fully-opaque lattice.
      */
     opacityCeiling?: number;
     /** Seed for a reproducible field (number or hashed string); omit for `Math.random`. */
@@ -326,7 +314,7 @@ export interface ConstellationProps {
     /** Decorative steer-toward-cursor + tap ripples. Default true; auto-off under reduced-motion. */
     pointerReactive?: boolean;
     /**
-     * Click-to-warp (AX.W17): a click warps the focal node to the nearest
+     * Click-to-warp: a click warps the focal node to the nearest
      * drifting node + springs it there. INDEPENDENT of `pointerReactive` (warp
      * works on a non-ripple lattice). Default false; auto-off under
      * reduced-motion. Enabling it gives the host a named keyboard/pointer button
@@ -334,11 +322,11 @@ export interface ConstellationProps {
      */
     warpOnClick?: boolean;
     /**
-     * Auto-DRIFT (AY.W-CON1): a periodic auto-pick re-points the focal node to a
+     * Auto-DRIFT: a periodic auto-pick re-points the focal node to a
      * random node on a jittered cadence — the wander source on the SAME warp
      * spring (no second mechanic). `true` uses the default cadence (8–16s, the
      * slides rhythm); `{ minIdle, jitter }` tunes it. Default OFF (absent →
-     * byte-identical to HEAD). PRM-gated by the WARP precedent (the cadence never
+     * the field is unchanged). PRM-gated by the WARP precedent (the cadence never
      * advances under reduced-motion — the focal stays at its seed).
      */
     wander?: boolean | {
@@ -346,12 +334,12 @@ export interface ConstellationProps {
         jitter?: number;
     };
     /**
-     * Pointer-held GRAVITY-WELL (AY.W-CON2): hold the pointer and the lattice is
+     * Pointer-held GRAVITY-WELL: hold the pointer and the lattice is
      * pulled toward it (an inverse-square force on the same engine, no new rAF);
      * release and the field cools back to `speed`. INDEPENDENT of `warpOnClick`
      * and `pointerReactive` (a consumer can hold-to-pull on a non-ripple,
      * non-warp lattice). `true` uses the tokenised defaults; an object tunes the
-     * gains. Default OFF (absent → byte-identical to HEAD). PRM-gated by the WARP
+     * gains. Default OFF (absent → the field is unchanged). PRM-gated by the WARP
      * precedent (the held-timer is not registered under reduced-motion). Enabling it
      * gives the host a named keyboard/pointer button contract; keyboard press/release
      * drives the same well target as pointer hold/release.
@@ -365,19 +353,19 @@ export interface ConstellationProps {
         soften?: number;
     };
     /**
-     * PINNED node designation (AZ.W-CON-GEN G1): a node held by every step pass (it
-     * does not drift / bounce / steer / feel the well). `false`/absent → no pin;
+     * Pinned-node designation: a node held by every step pass (it
+     * does not drift, bounce, steer, feel the well). `false`/absent → no pin;
      * `true` → node 0; a number → that index. The flagged-node pin the consumer holds.
      */
     pinned?: boolean | number;
     /**
-     * ACCENT-edge skin (AZ.W-CON-GEN G2): edges incident on the pinned (else focal)
+     * Accent-edge skin: edges incident on the pinned (else focal)
      * node stroke the `--constellation-accent` tint — the flagged-node tether. Default
      * OFF (the neutral single-color pass).
      */
     accentEdges?: boolean;
     /**
-     * Autonomous PINNED-ANCHOR drift (AZ.W-CON-GEN G5): the pinned node gently wanders
+     * Autonomous pinned-anchor drift: the pinned node gently wanders
      * its seeded anchor on a jittered cadence (DISTINCT from `wander`, which re-targets
      * the warp). Default OFF (the pin holds dead-still). PRM-gated.
      */
@@ -388,14 +376,14 @@ export interface ConstellationProps {
         jitter?: number;
     };
     /**
-     * Warp AUTO-RELEASE (AZ.W-CON-GEN G6): a settled warp clears its target so the
+     * Warp auto-release: a settled warp clears its target so the
      * focal rides its node's raw drift (the identity-ride). Default OFF (the warp holds
      * its target forever). Read the settled signal via the `warpSettled()` expose.
      */
     warpAutoRelease?: boolean;
     /**
-     * Deterministic-capture freeze (AY.W-CON3): when `true`, lays out ONE
-     * reproducible STATIC frame (no `stepField`, no ripple / warp / wander / well
+     * Deterministic-capture freeze: when `true`, lays out ONE
+     * reproducible STATIC frame (no `stepField`, no ripple, warp, wander, well
      * advance) and hands `drawOverlay` a FROZEN `now` so a phase-driven skin
      * resolves to a fixed value. Omit to AUTO-DERIVE from `location.search`
      * matching `export | print | freeze` (the deploy-pipeline contract); an
@@ -405,7 +393,7 @@ export interface ConstellationProps {
      */
     freeze?: boolean;
     /**
-     * The interactive-BACKGROUND feed (BI.W-CONSTELLATION-DEDUPE). A full-bleed
+     * The interactive-BACKGROUND feed. A full-bleed
      * `pointer-events:none` background constellation cannot listen for its own
      * pointer, so it reads the route chassis's ONE window pointer broadcaster
      * (`useRoutePointer`, provided by the route chassis) and feeds a SUBTLE pointer

package/dist/components/constellation/constellationWell.d.ts

@@ -1,13 +1,13 @@
-import type { ConstellationField } from "./constellationField";
+import type { ConstellationField } from "./constellationField.js";
 /**
- * Advance the gravity-well one `dt` (AY.W-CON2). A transient held-pointer force
+ * Advance the gravity-well one `dt`. A transient held-pointer force
  * composed inside `stepField` (NO new rAF): ease `well.strength` toward
  * `well.target` (1 held / 0 released) at `cfg.ramp`/s; while active, add an
  * inverse-square pull toward the held point onto each node within `cfg.reach`
  * (the `max(d, soften)` no-singularity floor + the `cfg.maxSpeed` no-slingshot
  * clamp); ALWAYS ease every node's |v| back toward `speed` (the field-cools
  * invariant — so a released well re-settles). No-ops (entirely skipped) when
- * `field.well` is undefined → the default render is byte-identical to HEAD.
+ * `field.well` is undefined → the default render is the plain field.
  *
  * `dt` is clamped to {@link WELL_DT_CLAMP} (the same park-resume guard the warp
  * uses) so a tab-throttle gap cannot slingshot the field in one giant step.

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

@@ -1,6 +1,8 @@
-export { default as Constellation } from "./Constellation.vue";
-export { seedField, stepField, refitField, buildEdges, appendPointerWeb, parallaxNodePos, BASE_WIDTH, } from "./constellationField";
-export { DEFAULT_K_FLOOR, DEFAULT_PARALLAX, MAX_NODES, MAX_DEGREE, E_MAX, } from "./constants";
-export { stepWell, nearestNode, readInteractionConfig, warpStep, warpTo, setWarpTarget, warpSettled, pickWanderTarget, stepPinnedDrift, makePinnedDrift, DEFAULT_WELL_CONFIG, DEFAULT_WANDER_IDLE, DEFAULT_WANDER_JITTER, DEFAULT_PINNED_DRIFT_FRAC, DEFAULT_PINNED_DRIFT_DUR, DEFAULT_PINNED_DRIFT_IDLE, DEFAULT_PINNED_DRIFT_JITTER, WARP_RESPONSE, WARP_ZETA, fireBurst, BURST_FIRE_THRESHOLD, } from "./constellationInteraction";
-export { kVisOf, readPalette, DEFAULT_PALETTE, } from "./constellationRender";
-export type { ConstellationNode, ConstellationEdge, ConstellationRipple, ConstellationPointer, ConstellationPalette, ConstellationField, ConstellationWarp, ConstellationWarpConfig, ConstellationWander, ConstellationWell, ConstellationWellConfig, ConstellationPinnedDrift, ConstellationProps, } from "./constellationTypes";
+export { default as Constellation } from "./Constellation.vue.js";
+export { seedField, stepField, refitField, buildEdges, appendPointerWeb, parallaxNodePos, } from "./constellationField.js";
+export { DEFAULT_K_FLOOR, DEFAULT_PARALLAX, BASE_WIDTH, MAX_NODES, MAX_DEGREE, E_MAX, DEFAULT_WELL_CONFIG, DEFAULT_WANDER_IDLE, DEFAULT_WANDER_JITTER, WARP_RESPONSE, WARP_ZETA, DEFAULT_PINNED_DRIFT_FRAC, DEFAULT_PINNED_DRIFT_DUR, DEFAULT_PINNED_DRIFT_IDLE, DEFAULT_PINNED_DRIFT_JITTER, } from "./constants.js";
+export { stepWell } from "./constellationWell.js";
+export { nearestNode, readInteractionConfig, warpStep, warpTo, setWarpTarget, warpSettled, pickWanderTarget, stepPinnedDrift, makePinnedDrift, fireBurst, BURST_FIRE_THRESHOLD, } from "./constellationInteraction.js";
+export { kVisOf, readPalette } from "./constellationRender.js";
+export { DEFAULT_PALETTE } from "./constants.js";
+export type { ConstellationNode, ConstellationEdge, ConstellationRipple, ConstellationPointer, ConstellationPalette, ConstellationField, ConstellationWarp, ConstellationWarpConfig, ConstellationWander, ConstellationWell, ConstellationWellConfig, ConstellationPinnedDrift, ConstellationProps, } from "./constellationTypes.js";

package/dist/components/dark-mode-toggle/DarkModeToggle.vue.d.ts

@@ -0,0 +1,12 @@
+export type DarkModeToggleSize = "sm" | "md" | "lg" | "control" | "dock";
+export interface DarkModeToggleProps {
+    size?: DarkModeToggleSize;
+    /** Suppress incidental page transitions during the theme flip. */
+    disableTransitions?: boolean;
+}
+declare const __VLS_export: import("vue").DefineComponent<DarkModeToggleProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<DarkModeToggleProps> & Readonly<{}>, {
+    size: DarkModeToggleSize;
+    disableTransitions: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/dark-mode-toggle/dark-mode-toggle.css

@@ -0,0 +1 @@
+@layer components{.dark-mode-toggle-button{--dark-mode-toggle-size: 2.25rem;--dark-mode-toggle-padding: 0.375rem;appearance: none;display: inline-grid;place-items: center;flex: none;width: var(--dark-mode-toggle-size);height: var(--dark-mode-toggle-size);padding: var(--dark-mode-toggle-padding);border: 0;border-radius: var(--radius-pill);color: var(--foreground);background: transparent;opacity: 0.8;cursor: pointer;transition: opacity var(--duration-fast) var(--ease-standard),background-color var(--duration-fast) var(--ease-standard),box-shadow var(--duration-fast) var(--ease-standard);}.dark-mode-toggle-button:hover{background: var(--surface-tint-10);opacity: 1;}.dark-mode-toggle-button:focus-visible{outline: none;box-shadow: var(--focus-ring-shadow,var(--dock-ring));opacity: 1;}.dark-mode-toggle-button > svg{display: block;width: 100%;height: 100%;fill: currentColor;}.dark-mode-toggle-button[data-size="sm"]{--dark-mode-toggle-size: 1.75rem;--dark-mode-toggle-padding: 0.25rem;}.dark-mode-toggle-button[data-size="lg"]{--dark-mode-toggle-size: 2.75rem;--dark-mode-toggle-padding: 0.5rem;}.dark-mode-toggle-button[data-size="control"]{--dark-mode-toggle-size: var(--control-size,2.25rem);--dark-mode-toggle-padding: var(--control-icon-padding,0.375rem);}.dark-mode-toggle-button[data-size="dock"],.glass-dock .dark-mode-toggle-button:not([data-size="sm"]):not([data-size="lg"]):not( [data-size="control"] ){--dark-mode-toggle-size: var(--dock-control-size,var(--size-icon-btn));--dark-mode-toggle-padding: calc( ( var(--dock-control-size,var(--size-icon-btn)) - var(--dock-control-glyph-size,var(--dock-icon-glyph,1.25rem)) ) / 2 );}.toggle-sun,.toggle-circle{transform-origin: center;transition-property: transform;transition-duration: var(--spring-dock-duration);transition-timing-function: var(--spring-dock);}:where(.dark) .dark-mode-toggle-button .toggle-sun{transform: rotate(0.5turn);}:where(.dark) .dark-mode-toggle-button .toggle-circle{transform: translateX(-15%);}}@media (prefers-reduced-motion: reduce){.dark-mode-toggle-button,.dark-mode-toggle-button .toggle-sun,.dark-mode-toggle-button .toggle-circle{transition: none;}}

package/dist/components/dark-mode-toggle/index.d.ts

@@ -0,0 +1,2 @@
+export { default as DarkModeToggle } from "./DarkModeToggle.vue.js";
+export type { DarkModeToggleProps, DarkModeToggleSize } from "./DarkModeToggle.vue.js";