@kitn.ai/ui 0.28.0 → 0.29.0

package/src/components/audio-visualizer/audio-visualizer.voice-fixture.ts

@@ -1,257 +0,0 @@
-/**
- * A real recorded voice, baked into a short seamless loop for the
- * `speaking` tiles in the stories -- the genuine article, not a generator.
- *
- * Real voice, recorded by the project owner: "This is a test, testing one
- * two three, hello world." Captured mono at 44.1kHz, then extracted through
- * the component's ALIGNED analysis chain -- the same values upstream
- * LiveKit's components run: AnalyserNode fftSize 2048 / smoothing 0.8,
- * window bins 100-200 (the components' own loPass/hiPass; see DEFAULTS in
- * primitives/use-audio-analysis.ts), `reduceToBands`' linear-proportional
- * split as it exists in THIS tree, ~32ms cadence. Third bake of this
- * fixture: the first was 5 linear bands over a wide raw-mic window
- * (bins 4-120), the second 3 geometric bands over the same wide window;
- * both predate the pipeline realignment that reverted window and split to
- * upstream's.
- *
- * GAIN: the raw take is boosted 8x (+18dB) through a GainNode before the
- * analysers -- an honest approximation of capture-side AGC, which every
- * real input to the aligned window gets (LiveKit captures local mics with
- * autoGainControl on; the mic stories request the same) but this recording,
- * made raw, never had. Un-gained, quiet natural-volume speech sits at or
- * under the -100dB floor across bins 100-200 and the loop's time-averaged
- * band profile comes out flat-to-inverted (edges louder than centre);
- * measured at +18dB the bake hits the live-AGC targets: speech-active
- * volume through the aligned byte path (minDecibels -100 / maxDecibels
- * -80) averages 0.73, no speech frame reads all-zero bands, and the
- * time-averaged mirrored md profile is centre-strictly-max --
- * [0.41, 0.42, 0.44, 0.42, 0.41]. The trade, recorded honestly: +18dB also
- * lifts part of the room tone over the floor, so rest frames idle near
- * [0.2, 0.04, 0] instead of the exact zeros an un-gained bake would show
- * -- which is also what a real AGC mic does between words.
- *
- * 3 bands per frame is HALF width on purpose: `Math.ceil(count / 2)`, the
- * exact band count the component itself requests at `md` before mirroring
- * (see `bandCount()` in index.tsx). The `bands` prop is a raw passthrough
- * by contract, so the stories mirror these half bands out to the full
- * element count themselves through `mirrorBandsCenterOut` /
- * `mirrorBandsAroundRing` -- the same primitives the live-audio path runs.
- * See `useVoiceBands` in the stories file.
- *
- * Trimmed to the same 196-frame window (~6.4s) as the previous bake:
- * about half a second of rest before the first word, just under a second
- * after the last, and BOTH natural pauses in the middle -- one short gap
- * around "test," / "testing", the longer one after "three," before
- * "hello" -- since those are what prove the visualizer falls back to rest
- * and recovers. Loops by wrapping frame 195 back to frame 0. Re-verified
- * at the aligned values: the endpoints differ by 0.034 pre-quantization
- * ([0.22,0.05,0] vs [0.2,0.03,0] after it), which sits between the median
- * (0.025) and p90 (0.053) of ADJACENT quiet frames' natural motion at this
- * gain -- the wrap step is indistinguishable from ordinary idle flicker.
- * (The previous bake's endpoints quantized identical, but only because its
- * un-gained rest frames were all zeros -- trivial, not preserved here.)
- *
- * Quantized to 2 decimals. Playback treats the cadence as a flat
- * `VOICE_FRAME_MS`; the capture's real ticks land at 32-33ms (setTimeout
- * jitter), a ~2% difference nobody can see. Body is ~3.8KB.
- */
-export const VOICE_FRAME_MS = 32;
-
-export const VOICE_BANDS: readonly (readonly number[])[] = [
-  [0.22,0.05,0],
-  [0.21,0.04,0],
-  [0.2,0.04,0],
-  [0.22,0.03,0],
-  [0.23,0.03,0],
-  [0.22,0.02,0],
-  [0.21,0.02,0],
-  [0.22,0.02,0],
-  [0.22,0.11,0.01],
-  [0.22,0.14,0.02],
-  [0.23,0.13,0.01],
-  [0.45,0.45,0.57],
-  [0.52,0.52,0.61],
-  [0.62,0.61,0.64],
-  [0.64,0.62,0.65],
-  [0.64,0.63,0.65],
-  [0.63,0.63,0.66],
-  [0.62,0.62,0.65],
-  [0.61,0.61,0.65],
-  [0.61,0.61,0.65],
-  [0.65,0.63,0.67],
-  [0.67,0.63,0.67],
-  [0.66,0.62,0.66],
-  [0.65,0.61,0.65],
-  [0.64,0.59,0.64],
-  [0.63,0.58,0.62],
-  [0.62,0.59,0.61],
-  [0.61,0.61,0.6],
-  [0.62,0.62,0.59],
-  [0.61,0.62,0.59],
-  [0.59,0.61,0.57],
-  [0.59,0.61,0.59],
-  [0.59,0.62,0.64],
-  [0.59,0.62,0.66],
-  [0.61,0.62,0.66],
-  [0.61,0.61,0.65],
-  [0.61,0.6,0.64],
-  [0.6,0.59,0.63],
-  [0.59,0.57,0.62],
-  [0.58,0.56,0.6],
-  [0.61,0.59,0.6],
-  [0.62,0.59,0.6],
-  [0.61,0.58,0.58],
-  [0.59,0.57,0.57],
-  [0.58,0.56,0.55],
-  [0.6,0.57,0.56],
-  [0.62,0.58,0.56],
-  [0.63,0.58,0.57],
-  [0.64,0.58,0.56],
-  [0.64,0.58,0.55],
-  [0.63,0.57,0.54],
-  [0.63,0.56,0.54],
-  [0.62,0.54,0.52],
-  [0.61,0.53,0.51],
-  [0.59,0.51,0.49],
-  [0.58,0.49,0.47],
-  [0.56,0.47,0.45],
-  [0.54,0.46,0.43],
-  [0.53,0.48,0.42],
-  [0.52,0.47,0.4],
-  [0.5,0.45,0.37],
-  [0.48,0.43,0.35],
-  [0.46,0.41,0.32],
-  [0.45,0.39,0.3],
-  [0.43,0.37,0.26],
-  [0.41,0.35,0.23],
-  [0.4,0.34,0.22],
-  [0.38,0.33,0.18],
-  [0.37,0.31,0.16],
-  [0.38,0.32,0.21],
-  [0.37,0.31,0.19],
-  [0.36,0.28,0.16],
-  [0.46,0.41,0.37],
-  [0.5,0.49,0.52],
-  [0.51,0.53,0.58],
-  [0.51,0.54,0.6],
-  [0.51,0.55,0.62],
-  [0.52,0.56,0.63],
-  [0.51,0.56,0.63],
-  [0.51,0.56,0.63],
-  [0.5,0.56,0.64],
-  [0.51,0.56,0.64],
-  [0.53,0.59,0.64],
-  [0.55,0.6,0.64],
-  [0.55,0.6,0.63],
-  [0.53,0.58,0.61],
-  [0.54,0.59,0.62],
-  [0.56,0.59,0.65],
-  [0.61,0.63,0.68],
-  [0.63,0.64,0.69],
-  [0.63,0.65,0.68],
-  [0.63,0.64,0.67],
-  [0.62,0.63,0.66],
-  [0.61,0.61,0.65],
-  [0.6,0.61,0.65],
-  [0.59,0.6,0.65],
-  [0.58,0.59,0.66],
-  [0.56,0.58,0.65],
-  [0.55,0.57,0.64],
-  [0.54,0.58,0.65],
-  [0.54,0.57,0.65],
-  [0.53,0.56,0.64],
-  [0.52,0.54,0.62],
-  [0.5,0.52,0.61],
-  [0.48,0.51,0.59],
-  [0.47,0.49,0.58],
-  [0.46,0.47,0.56],
-  [0.44,0.46,0.55],
-  [0.42,0.44,0.53],
-  [0.4,0.41,0.51],
-  [0.39,0.39,0.49],
-  [0.37,0.37,0.47],
-  [0.36,0.35,0.45],
-  [0.34,0.34,0.43],
-  [0.36,0.37,0.42],
-  [0.35,0.37,0.4],
-  [0.33,0.35,0.38],
-  [0.32,0.33,0.36],
-  [0.3,0.3,0.33],
-  [0.29,0.28,0.31],
-  [0.27,0.26,0.28],
-  [0.26,0.24,0.26],
-  [0.25,0.21,0.22],
-  [0.24,0.19,0.19],
-  [0.25,0.23,0.21],
-  [0.35,0.38,0.36],
-  [0.39,0.5,0.46],
-  [0.39,0.52,0.48],
-  [0.4,0.53,0.49],
-  [0.47,0.6,0.55],
-  [0.52,0.62,0.58],
-  [0.55,0.63,0.58],
-  [0.56,0.63,0.58],
-  [0.54,0.62,0.57],
-  [0.53,0.6,0.55],
-  [0.52,0.59,0.54],
-  [0.5,0.57,0.52],
-  [0.49,0.56,0.5],
-  [0.47,0.55,0.49],
-  [0.46,0.53,0.47],
-  [0.44,0.52,0.45],
-  [0.43,0.51,0.46],
-  [0.51,0.54,0.54],
-  [0.54,0.55,0.55],
-  [0.53,0.56,0.54],
-  [0.52,0.57,0.54],
-  [0.51,0.57,0.53],
-  [0.53,0.59,0.56],
-  [0.52,0.58,0.56],
-  [0.51,0.57,0.55],
-  [0.49,0.55,0.54],
-  [0.48,0.54,0.52],
-  [0.46,0.52,0.51],
-  [0.44,0.5,0.49],
-  [0.43,0.49,0.47],
-  [0.41,0.47,0.45],
-  [0.39,0.46,0.43],
-  [0.37,0.44,0.41],
-  [0.36,0.42,0.39],
-  [0.34,0.4,0.36],
-  [0.32,0.37,0.34],
-  [0.31,0.35,0.32],
-  [0.3,0.33,0.29],
-  [0.28,0.31,0.26],
-  [0.27,0.29,0.23],
-  [0.27,0.27,0.22],
-  [0.26,0.25,0.18],
-  [0.25,0.23,0.15],
-  [0.24,0.2,0.13],
-  [0.23,0.18,0.09],
-  [0.23,0.16,0.07],
-  [0.23,0.14,0.04],
-  [0.22,0.11,0.03],
-  [0.22,0.09,0.02],
-  [0.2,0.07,0.01],
-  [0.2,0.04,0.01],
-  [0.18,0.03,0.01],
-  [0.18,0.02,0.01],
-  [0.19,0.02,0],
-  [0.19,0.01,0],
-  [0.19,0.01,0],
-  [0.17,0.01,0],
-  [0.19,0.01,0],
-  [0.18,0.07,0],
-  [0.21,0.06,0],
-  [0.21,0.06,0],
-  [0.22,0.05,0],
-  [0.2,0.03,0],
-  [0.2,0.02,0],
-  [0.19,0.01,0],
-  [0.19,0.01,0],
-  [0.2,0.01,0],
-  [0.2,0,0],
-  [0.19,0,0],
-  [0.18,0,0],
-  [0.2,0.03,0],
-];

package/src/components/audio-visualizer/aurora.glsl.ts

@@ -1,330 +0,0 @@
-/**
- * Aurora ("veil") fragment shader.
- *
- * ORIGINAL WORK for @kitn.ai/ui. Written for Task 14 of
- * docs/superpowers/plans/2026-08-07-audio-visualizers.md, from two inputs
- * only:
- *   1. .superpowers/sdd/2026-08-07-audio-visualizers/reference/aura-prototype/
- *      lk-aura-factsheet.md -- a two-team clean-room functional spec (facts
- *      and mathematics; no code and no expression, and no identifiers
- *      beyond the public prop names and the uniform inventory, both
- *      disclosed in that document's own preamble) covering LiveKit's
- *      public "aura" visualizer look. What was checked, and how, is in
- *      `docs/provenance/aurora-clean-room.md` section 4.
- *   2. The adopted prototype's own `aura-proto.html` (mode 3, "veil"), which
- *      was itself implemented from that fact sheet by an author who never
- *      saw LiveKit's source.
- *
- * This file is NOT derived from, and was not written with reference to,
- * LiveKit's `agent-audio-visualizer-aura.tsx` or the aura GLSL inlined in
- * it. That component is Polyform Non-Resale 1.0.0, (c) UNCRN LLC -- a
- * license incompatible with publishing this package -- and was never
- * opened. The fact sheet's numbers and formulas (independently re-derived
- * and checked by hand below, not copied) are what stand in for it.
- *
- * Its sibling `use-agent-audio-visualizer-aura.ts`, the DRIVING hook, is a
- * separate matter: that file is Apache-2.0 (repo license, no Polyform
- * header) and carries only the per-state behaviour, not the shader. It
- * contributes nothing to this file; the state targets it describes live in
- * `variant-aurora.tsx`.
- *
- * The construction: 36 phase-offset copies of one ring, each pushed through
- * the same 4-octave directional-sine warp cascade, fused into soft veils by
- * an analytic neighbour-distance blur -- see `auroraWarp` and the strand
- * loop in `mainImage`.
- *
- * One deliberate deviation from the fact sheet: section 1 states the
- * shipped output is "hotter than premultiplied" (written RGB may exceed
- * written alpha), and section 4 confirms the light-mode branch never
- * multiplies RGB by alpha or brightness at all. That is exactly the pattern
- * that produces dark fringes on translucent edges once composited with a
- * `premultipliedAlpha: true` canvas context over a light page background --
- * see the doc on `ShaderCanvas`'s `fragment` prop. This port keeps every
- * other number and formula but replaces the final write with true
- * premultiplied output, `fragColor = vec4(rgb * alpha, alpha)`.
- *
- * PARITY RE-TUNE (campaign task #6). A pixel-level behavioral audit
- * (examples/internal/livekit-parity scripts/aurora-audit.mjs) measured the
- * rendered output against the reference and this file was re-tuned to the
- * MEASURED targets -- numbers from screenshots and Rob's reference
- * recording, never from restricted source. Four departures from the
- * original fact-sheet pipeline, all clean-room rendering choices:
- *   1. Wind direction + solid-body rotation: the octave phase runs on
- *      NEGATIVE tau (the audit measured our lobes drifting counter-
- *      clockwise where the reference turns clockwise, ~+13..+20 deg/s when
- *      speaking), plus a per-state `uRotation` trim of the coordinate
- *      frame so each state's measured rotation lands on its reference
- *      value (see `auroraTargets` in variant-aurora.tsx).
- *   2. Dark tonemap is chroma-preserving with a steeper knee (11x/(1+11x)
- *      on the max channel, rescaled) plus an HSV shape-up: hue +0.013
- *      turns, saturation scaled by (1.02 + 0.35 * value) capped at 0.98.
- *      Rendered targets: hue ~197.5deg, saturation ~0.95 rising with
- *      brightness, never white (the audit measured the original
- *      per-channel 4x/(1+4x) map desaturating to ~0.72 and dragging hue
- *      toward green).
- *   3. Brightness is applied through strongly compressive curves
- *      ((b/1.5)^0.07 on colour, 0.97*(b/1.5)^0.09 on alpha, with a
- *      smoothstep alpha knee): the thinking/connecting pulse DRIVES
- *      0.5..2.5 but must RENDER inside roughly 0.5..0.65 mean brightness
- *      (the reference holds 0.53..0.65 where the linear map swung
- *      0.16..0.83 and blinked the ring out entirely at pulse minima).
- *   4. Edge falloff tightened (exp(2.3*spacing), was exp(2*spacing)) and
- *      made asymmetric: the OUTER side of the ring renders at 0.66x the
- *      inner width -- the reference's outer edge is consistently sharper
- *      than its inner one at every volume.
- *
- * Uniforms are declared by ShaderCanvas. Do not declare them here.
- *
- * Uniform contract (see the module doc in the Task 14 report for the full
- * per-state table):
- *   uColor       vec3  -- accent RGB, 0..1.
- *   uIntensity   float -- brightness/gain, fact sheet section 5's
- *                         "brightness" column directly (roughly 0.5..2.5,
- *                         NOT the 0..1 convention other variants use).
- *   uSpeed       float -- octave phase rate in rad/s, fact sheet section
- *                         5's `S / 20` directly (roughly 0.5..3.5).
- *   uComplexity  float -- warp spatial-frequency parameter, fact sheet
- *                         section 5's `freqParam` directly (roughly
- *                         0.4..1.25, default 0.5); mapped internally to
- *                         F = 2 + 13 * uComplexity.
- *   uAmplitude   float -- warp displacement amplitude, fact sheet section
- *                         5's `amplitude` column directly (roughly
- *                         0.5..1.2, default 1.0).
- *   uScale       float -- ring radius, fraction of half-canvas, fact sheet
- *                         section 5's `scale` column directly (0.2..0.3).
- *                         The caller is responsible for folding in the
- *                         instant voice-driven growth
- *                         (`0.2 + 0.2 * volume`, speaking state only,
- *                         fact sheet section 5) before setting this --
- *                         the shader does not read a separate volume
- *                         uniform to avoid double-applying it.
- *   uTheme       float -- < 0.5 selects the dark colour pipeline, >= 0.5
- *                         the light one (fact sheet section 4). This is a
- *                         genuine branch in the math, not just a
- *                         compositing background -- set it from the kit's
- *                         active theme, not a fixed constant.
- *   uRotation    float -- solid-body rotation rate of the whole figure,
- *                         rad/s, positive = CLOCKWISE on screen. A
- *                         parity-calibrated per-state trim on top of the
- *                         wind's own drift (see the module doc above and
- *                         `auroraTargets`); the caller pins it to 0 under
- *                         reduced motion, like uSpeed.
- */
-export default `
-const float PI = 3.14159265359;
-// Strand phase span: 0.5 + pi (fact sheet section 2's "sigma", the
-// midpoint of the interval [1, 2*pi] with the interpolation knob fixed
-// at 0.5).
-const float STRAND_SIGMA = 0.5 + PI;
-const int STRAND_COUNT = 36;
-
-// 4-octave directional-sine warp cascade. M0 and the per-octave rotation B
-// (cos 0.6, sin 0.8, an exact ~53.13 degree rotation) are fact sheet
-// section 2's stated matrices; M1/M2/M3 = B composed with the previous
-// octave's matrix, and each v_k is the first row of M_k. Hand-derived and
-// checked against the fact sheet's own listed v_0..v_3 below, not copied
-// from any source.
-const mat2 WARP_M0 = mat2(0.6, 0.25, -0.25, 0.9);
-const mat2 WARP_M1 = mat2(0.16, 0.63, -0.87, 0.34);
-const mat2 WARP_M2 = mat2(-0.408, 0.506, -0.794, -0.492);
-const mat2 WARP_M3 = mat2(-0.6496, -0.0228, -0.0828, -0.9304);
-const vec2 WARP_V0 = vec2(0.600, -0.250);
-const vec2 WARP_V1 = vec2(0.160, -0.870);
-const vec2 WARP_V2 = vec2(-0.408, -0.794);
-const vec2 WARP_V3 = vec2(-0.650, -0.083);
-
-// Displaces p through all 4 octaves. Octave k's phase carries k*tau, so
-// octave 0 is static in time and octave 3 moves fastest -- fine
-// corrugation slides across coarse folds, which reads as flowing wind
-// (fact sheet section 2, "Mechanism of the fold / wind").
-vec2 auroraWarp(vec2 p, float phi, float tau, float freq, float amp) {
-  vec2 x = p;
-  float f = freq;
-  float a = amp;
-
-  vec2 q = WARP_M0 * x;
-  vec2 w = sin(f * q + vec2(phi));
-  x += (a / f) * WARP_V0 * w;
-  f *= 1.4;
-  a *= 1.0 + 0.1 * (max(w.x, w.y) - 1.0);
-
-  q = WARP_M1 * x;
-  w = sin(f * q + vec2(tau + phi));
-  x += (a / f) * WARP_V1 * w;
-  f *= 1.4;
-  a *= 1.0 + 0.1 * (max(w.x, w.y) - 1.0);
-
-  q = WARP_M2 * x;
-  w = sin(f * q + vec2(2.0 * tau + phi));
-  x += (a / f) * WARP_V2 * w;
-  f *= 1.4;
-  a *= 1.0 + 0.1 * (max(w.x, w.y) - 1.0);
-
-  q = WARP_M3 * x;
-  w = sin(f * q + vec2(3.0 * tau + phi));
-  x += (a / f) * WARP_V3 * w;
-
-  return x;
-}
-
-vec3 auroraRgb2Hsv(vec3 c) {
-  vec4 K = vec4(0.0, -1.0 / 3.0, 2.0 / 3.0, -1.0);
-  vec4 p = mix(vec4(c.bg, K.wz), vec4(c.gb, K.xy), step(c.b, c.g));
-  vec4 q = mix(vec4(p.xyw, c.r), vec4(c.r, p.yzx), step(p.x, c.r));
-  float d = q.x - min(q.w, q.y);
-  return vec3(abs(q.z + (q.w - q.y) / (6.0 * d + 1.0e-10)), d / (q.x + 1.0e-10), q.x);
-}
-
-vec3 auroraHsv2Rgb(vec3 c) {
-  vec4 K = vec4(1.0, 2.0 / 3.0, 1.0 / 3.0, 3.0);
-  vec3 p = abs(fract(c.xxx + K.xyz) * 6.0 - K.www);
-  return c.z * mix(K.xxx, clamp(p - K.xxx, 0.0, 1.0), c.y);
-}
-
-void mainImage(out vec4 fragColor, in vec2 fragCoord) {
-  // Fact sheet section 2: u in [0,1]^2, centered point p = u - 0.5, no
-  // aspect correction -- the element is forced square by CSS, so this is
-  // only correct on a square canvas (true for every audio-visualizer size).
-  vec2 uv = fragCoord / iResolution.xy;
-  vec2 p = uv - 0.5;
-
-  // Solid-body rotation of the sampling frame (module doc, departure 1).
-  // gl_FragCoord's y-up frame is mirrored against the screen's y-down one,
-  // so the sign here is what makes positive uRotation read CLOCKWISE on
-  // screen -- verified empirically against the audit's estimator (which
-  // measures +10 for uRotation = +10 deg/s with the wind frozen).
-  float rotA = -uRotation * iTime;
-  float rc = cos(rotA);
-  float rs = sin(rotA);
-  p = mat2(rc, -rs, rs, rc) * p;
-
-  // Negative tau: time-reversing the octave phases flips the wind's
-  // emergent angular drift from counter-clockwise (measured on the original)
-  // to the reference's clockwise, without touching any static property --
-  // lobes, radii, spectra are distribution-identical (module doc,
-  // departure 1).
-  float tau = -iTime * uSpeed;
-  float freq = max(2.0 + 13.0 * uComplexity, 1.0);
-  float amp = uAmplitude;
-  float ringRadius = uScale;
-
-  vec3 hsv = auroraRgb2Hsv(uColor);
-  // Chain-seed strand, phase -1/36 NOT scaled by STRAND_SIGMA (fact sheet
-  // section 2), so inter-strand spacing is defined for strand 1 too.
-  vec2 prevStrand = auroraWarp(p, -1.0 / float(STRAND_COUNT), tau, freq, amp);
-
-  vec3 accum = vec3(0.0);
-  for (int j = 1; j <= STRAND_COUNT; j++) {
-    float frac = float(j) / float(STRAND_COUNT);
-    float phi = frac * STRAND_SIGMA;
-    vec2 strand = auroraWarp(p, phi, tau, freq, amp);
-
-    // Signed distance to the (warped) ring, per strand: negative inside,
-    // positive outside -- the sign feeds the asymmetric edge width below.
-    float sd = length(strand) - ringRadius;
-    float dist = abs(sd);
-    // Inter-strand spacing through the chain: an analytic blur exactly
-    // proportional to how far this strand's warp has drifted from its
-    // neighbour's. Fanned regions (large spacing) fuse into soft veils;
-    // bunched regions (small spacing) stay crisp -- this is what turns 36
-    // discrete rings into an aurora (fact sheet section 2). The 2.3 growth
-    // rate (fact sheet's own is 2.0) and the 0.66x outer-side factor are
-    // the parity edge calibration: the reference holds a 10-90% rise of
-    // ~6-10px(2x) with the OUTER edge always the sharper of the two
-    // (module doc, departure 4).
-    float spacing = length(strand - prevStrand);
-    float edgeWidth = 0.01 + max(exp(2.3 * spacing) - 1.0, 0.001);
-    edgeWidth *= mix(1.0, 0.66, step(0.0, sd));
-    float coverage = 1.0 - smoothstep(0.0, 1.0, dist / edgeWidth);
-
-    // Fixed hue drift across the strand fan, matching the fact sheet's
-    // documented colorShift default (0.05 turns at weight 0.3, i.e. 0.015
-    // turns end to end); earliest strand shifts most.
-    vec3 strandColor = auroraHsv2Rgb(vec3(fract(hsv.x + (1.0 - frac) * 0.015), hsv.y, hsv.z));
-    accum += coverage * strandColor;
-    prevStrand = strand;
-  }
-
-  // Mean soft coverage across all 36 strands (fact sheet section 2's image
-  // accumulator I). The inverse-distance glow accumulator G is omitted: the
-  // fact sheet states its gain ships as 0, so it contributes nothing.
-  vec3 image = accum / float(STRAND_COUNT);
-
-  // Deterministic per-pixel dither, +/- 1/510, identical on all channels
-  // (fact sheet section 3). Kept as a plain vec3 offset, not pre-mixed into
-  // the image accumulator, so each branch can add it at the point the fact
-  // sheet actually specifies (see the dark branch below).
-  float n = fract(sin(dot(fragCoord, vec2(12.9898, 78.233))) * 43758.5453);
-  vec3 dither = vec3((n - 0.5) / 255.0);
-
-  float brightness = uIntensity;
-  vec3 rgb;
-  float alpha;
-
-  if (uTheme < 0.5) {
-    // Dark pipeline, parity-calibrated (module doc, departures 2 + 3).
-    // RGB1 = 1.2 * I, THEN add dither (fact sheet order: pre-gain first so
-    // the dither's written amplitude stays +/- 1/510), then floor at 0 --
-    // a negative dither on a near-black pixel would otherwise be blown up
-    // by the chroma-preserving rescale's division right below.
-    vec3 x1 = max(1.2 * image + dither, 0.0);
-
-    // Chroma-preserving tonemap: knee the MAX channel (11x/(1+11x) -- a
-    // steeper knee than the fact sheet's per-channel 4x/(1+4x)) and rescale
-    // the vector, so ribbon cores land on a stable brightness level largely
-    // independent of how thin the veils have fanned (the audit measured the
-    // per-channel map crushing spread-out states to ~half the reference's
-    // rendered brightness) while hue and saturation pass through untouched
-    // for the HSV shape-up to own.
-    float mxc = max(x1.r, max(x1.g, x1.b));
-    float tmMax = 11.0 * mxc / (1.0 + 11.0 * mxc);
-    vec3 tm = x1 * (tmMax / max(mxc, 1.0e-5));
-
-    // Rendered-colour calibration: hue +0.013 turns (audit target
-    // ~197.5deg for the default accent), saturation proportional to the
-    // caller's own (a desaturated accent stays desaturated) but rising
-    // with the pixel's value and capped at 0.98 -- Rob's reference:
-    // saturation RISES with brightness, and nothing is ever white.
-    vec3 hv = auroraRgb2Hsv(tm);
-    hv.x = fract(hv.x + 0.013);
-    hv.y = min(hv.y * (1.02 + 0.35 * hv.z), 0.98);
-    tm = auroraHsv2Rgb(hv);
-
-    // Brightness compression (departure 3): uIntensity DRIVES 0.5..2.5 at
-    // the thinking/connecting pulse but must RENDER inside roughly
-    // 0.5..0.65 mean brightness, never dropping the ring below visibility.
-    // Two compressive powers (colour flatter than alpha) plus a smoothstep
-    // alpha knee that lifts ribbon cores to full opacity while cutting the
-    // dim tails -- which is also what keeps the centre transparent and the
-    // edges crisp. max(brightness, 0.05) only guards pow() against a
-    // (contractually impossible) zero or negative uniform.
-    float bVal = pow(max(brightness, 0.05) / 1.5, 0.07);
-    float bAlpha = 0.97 * pow(max(brightness, 0.05) / 1.5, 0.09);
-    float luma = dot(tm, vec3(0.299, 0.587, 0.114));
-    // Clamped to [0,1] before the premultiply below, mirroring the light
-    // branch, so rgb * alpha <= alpha stays enforced for every input.
-    rgb = clamp(tm * bVal, 0.0, 1.0);
-    alpha = clamp(smoothstep(0.0, 0.50, luma) * bAlpha, 0.0, 1.0);
-  } else {
-    // Light pipeline (fact sheet section 4): RGB1 = I, then add dither;
-    // brightness curve on vector length, hue direction kept, saturation
-    // extrapolated 3x about gray.
-    vec3 x1 = image + dither;
-    float mag = length(x1);
-    vec3 dir = x1 / max(mag, 1.0e-5);
-    float mag2 = 2.0 * mag / (1.0 + 2.0 * mag);
-    vec3 x2 = dir * mag2;
-    float gray = dot(x2, vec3(0.2, 0.5, 0.1));
-    rgb = clamp(vec3(gray) + 3.0 * (x2 - vec3(gray)), 0.0, 1.0);
-    alpha = clamp(mag2 * clamp(brightness, 1.0, 2.0), 0.0, 1.0);
-  }
-
-  // PREMULTIPLIED output. Both branches above clamp their natural rgb to
-  // [0,1] before this line, which is what makes rgb * alpha <= alpha
-  // (componentwise) a property the code enforces unconditionally, not one
-  // that happens to hold for the inputs this was tested against. See the
-  // module doc above for why this departs from the fact sheet's own
-  // (deliberately non-premultiplied) pipeline.
-  fragColor = vec4(rgb * alpha, alpha);
-}
-`;