vireuikit 0.1.0 → 0.3.0

package/dist/dynamics-BqBoj03x.d.cts

@@ -1,160 +0,0 @@
-type VireUIKitMediumChannel = readonly [number, number, number];
-type VireUIKitMediumParams = {
-    /** 1/s — how fast the TRACK density decays per second. Water (vapor+condensate) does not decay:
-     *  it is a conserved volume, only moving between phases and being transported. */
-    decay: number;
-    /** Spatial frequency of the curl-noise potential, 1/px of the simulation grid. */
-    curlFreq: number;
-    /** Drift speed of the noise domain over time, 1/s. */
-    curlSpeed: number;
-    /** Velocity field scale, grid-px/s — how far the smoke can be carried in a second. */
-    advectSpeed: number;
-    /** Turbulence gate, 0…1 (playback drives it: playing is alive, paused cools down). The
-     *  per-frame value is computed by `createMediumDynamics` (`dynamics.ts`) — it arrives here
-     *  already resolved. */
-    turbulence: number;
-    /** 1/s — the fraction of vapor EXCESS above `condensationFloor` that turns into condensate every
-     *  second from background seeding: weak, everywhere, all the time — the chamber is never
-     *  perfectly clean. */
-    condensationRate: number;
-    /** Vapor density (in seed-density units, a spot's peak ≈1) below which condensation does not
-     *  happen at all — only the excess above it condenses. Without a floor, the condensate would
-     *  exactly retrace the vapor spot's shape (the same outline, or softer from growth blur), and
-     *  the two phases would have nowhere to visually diverge: vapor is already soft, so the floor
-     *  concentrates condensate in dense turbulence cores, leaving the sparse vapor around it
-     *  uncondensed. Keep it NOTICEABLY below the settled mean vapor level (turbulence stirs spots
-     *  into a nearly flat background of ~0.3 over a few minutes — a known limit of the numerical
-     *  advection): a floor above that mean eventually stops finding any excess at all, and
-     *  condensation dies out for good. */
-    condensationFloor: number;
-    /** 1/s — the fraction of condensate evaporating back into vapor. Larger than the condensation
-     *  rate: at equilibrium most of the water stays vapor, which is the "supersaturated" one. */
-    evaporationRate: number;
-    /** grid-px/s — condensate drift downward, on top of the shared velocity field: gravity touches
-     *  droplets and leaves vapor alone. */
-    condensateSettleSpeed: number;
-    /** 1/s — the rate at which a droplet blends with its grid neighbors. There is no separate age
-     *  counter: the blend repeats every frame, and whatever has survived more frames ends up more
-     *  blended with its neighbors on its own — that IS "growth". Keep it NOTICEABLY below
-     *  `evaporationRate`: over a droplet's average lifetime (1/evaporationRate) only a small
-     *  fraction should get to blend — otherwise the blur outruns evaporation and the whole grid
-     *  levels into flat fog before a droplet gets a chance to return to vapor (visible by eye: the
-     *  contrast between "a patch of droplets" and the vapor background disappears within seconds). */
-    condensateSpreadRate: number;
-    /** 0…1 — how much of the local vapor hue shows through in the condensate. Droplets carry no
-     *  color of their own (droplets scatter light rather than tint it) — this is only a faint hint
-     *  of the surroundings. */
-    condensateTint: number;
-    /** Condensate's visibility multiplier in the Oklab mix relative to vapor at equal density —
-     *  droplets hold a small share of the water's mass, but they are mostly what's visible (as in a
-     *  real cloud: vapor is transparent, droplets create the visibility). */
-    condensateGain: number;
-    /** Near-white sRGB tone of droplets with no hue seeding (`condensateTint=0`) — droplets scatter
-     *  light rather than color it. */
-    condensateColor: VireUIKitMediumChannel;
-    /** Each vapor species' hue, sRGB 0…1. Derived as a family around one tone (`speciesFamily`),
-     *  not picked as three separate colors — see `species.ts`. */
-    channelColors: readonly [VireUIKitMediumChannel, VireUIKitMediumChannel, VireUIKitMediumChannel];
-    /** The platform's neutral tone — what the medium is, alone, with no source playing. */
-    baseColor: VireUIKitMediumChannel;
-    /** Background weight in the Oklab mix: keeps the platform tone visible even where the smoke is dense. */
-    baseWeight: number;
-};
-declare const MEDIUM_DEFAULTS: VireUIKitMediumParams;
-/** The material probe can't see texture finer than this: there is no gain in a denser simulation
- *  grid than the probe's own floor. */
-declare const MEDIUM_PROBE_FLOOR_PX = 22;
-/** Device-px per simulation grid cell by default — noticeably coarser than the probe floor;
- *  sharpening the detail visible right next to the glass is a later increment (emission and
- *  palette). */
-declare const MEDIUM_DEFAULT_CELL_PX = 26;
-/**
- * The geometry of one track stamp (`emit-shader.ts`), in FRACTIONS of `min(gridW, gridH)` rather
- * than pixels — so a preset doesn't depend on the simulation grid's resolution. Two presets:
- * alpha is a thick, short, straight track; beta is a thin, long, ragged one. The third, natural,
- * is dim and short, for the occasional background track at rest (not tied to cover art).
- */
-type VireUIKitMediumTrackPreset = {
-    lengthFrac: number;
-    headWidthFrac: number;
-    tailWidthFrac: number;
-    /** Amplitude of the path's sideways noise, as a fraction of `min(gridW, gridH)`; 0 = a straight thread. */
-    raggedFrac: number;
-    raggedFreq: number;
-    /** How far the tail has settled downward, as a fraction of `min(gridW, gridH)`. */
-    settleFrac: number;
-    /** How much dimmer the tail is than the head, 0…1. */
-    tailDim: number;
-    intensity: number;
-};
-declare const MEDIUM_TRACK_PRESETS: Readonly<Record<'alpha' | 'beta' | 'natural', VireUIKitMediumTrackPreset>>;
-/** Turbulence at rest/paused/with no active track — the "slow drift" baseline shared by all three
- *  neutral states (they differ from each other in other ways, not in this number). */
-declare const MEDIUM_DRIFT_TURBULENCE = 0.045;
-/** Turbulence range during playback: the low end is a quiet stretch of the track, the high end is
- *  peak amplitude. */
-declare const MEDIUM_PLAYING_TURBULENCE_RANGE: readonly [number, number];
-/** Turbulence smoothing time constant, seconds: both ramping up on play and cooling down on pause
- *  go through this filter — smooth, never a jump. */
-declare const MEDIUM_TURBULENCE_TAU = 2.5;
-/** Emission cadence — once every this many beats, not on every beat: at 120–180 BPM that is
- *  0.5–0.75 Hz, an order of magnitude below the WCAG 2.3.1 photosensitivity ceiling (3 Hz). */
-declare const MEDIUM_EMISSION_BEATS = 4;
-/** Fraction of the beats that actually get an emission — breaks up the exact periodicity (a
- *  metronome-perfect pulse reads as mechanical) without moving the average rate. */
-declare const MEDIUM_EMISSION_PROBABILITY = 0.55;
-/** Emergency floor between two emissions, seconds — a safeguard for the same WCAG 2.3.1
- *  requirement, independent of `MEDIUM_EMISSION_BEATS`/BPM: even a mistake in the other constants
- *  can't flash faster than this. */
-declare const MEDIUM_MIN_EMISSION_INTERVAL = 1.2;
-/** Average interval between solitary "background emission" tracks at rest, seconds, plus a random
- *  `MEDIUM_NATURAL_JITTER` on top — rare, with no discernible rhythm. */
-declare const MEDIUM_NATURAL_INTERVAL = 25;
-declare const MEDIUM_NATURAL_JITTER = 35;
-/** The sensitive layer — fractions of height, top to bottom. Above it there isn't enough
- *  supersaturation for a track to appear at all, so background emission is only ever visible here. */
-declare const MEDIUM_SENSITIVE_TOP = 0.55;
-declare const MEDIUM_SENSITIVE_BOTTOM = 0.95;
-
-type VireUIKitMediumPlaybackState = 'idle' | 'playing' | 'paused' | 'stopped';
-type VireUIKitMediumTrackPresetName = keyof typeof MEDIUM_TRACK_PRESETS;
-/** The fully resolved geometry of one track stamp — the platform layer (`web/medium.ts`)
- *  translates fractions into simulation-grid pixels and binds the uniforms, deciding nothing else:
- *  which preset, where, and how bright is entirely this model's call. */
-type VireUIKitMediumEmission = VireUIKitMediumTrackPreset & {
-    /** 0…1, a fraction of the grid on both axes — the source point (cover art while playing;
-     *  wherever it happens to land at rest). */
-    source: readonly [number, number];
-    /** Radians, direction from the source to the head. */
-    angle: number;
-    seed: number;
-    channel: readonly [number, number, number];
-};
-type VireUIKitMediumDynamicsInput = {
-    state: VireUIKitMediumPlaybackState;
-    /** Beats per minute of the active track; unread in states with no track. */
-    bpm: number;
-    /** 0…1 — a continuous volume envelope (e.g. from precomputed waveform peaks), NOT the beat itself. */
-    amplitude: number;
-    /** Seconds, a deterministic playback position (not wall-clock time) — the emission cadence has
-     *  to be derived from it rather than accumulating its own phase. */
-    positionSeconds: number;
-    /** 0…1 — the area of the active track's cover art that emission comes from while playing. */
-    sourcePoint: readonly [number, number];
-    dt: number;
-};
-type VireUIKitMediumDynamicsFrame = {
-    turbulence: number;
-    emissions: readonly VireUIKitMediumEmission[];
-};
-type VireUIKitMediumDynamics = {
-    step(input: VireUIKitMediumDynamicsInput): VireUIKitMediumDynamicsFrame;
-};
-/**
- * Stateful "playback dynamics" model: turbulence and emission scheduling per frame. Platform
- * neutral — the caller supplies the clock and the playback position (in a bench, that would be
- * its own render loop); it never reads `performance.now()` or the DOM itself.
- */
-declare function createMediumDynamics(): VireUIKitMediumDynamics;
-
-export { MEDIUM_DEFAULTS as M, type VireUIKitMediumChannel as V, MEDIUM_DEFAULT_CELL_PX as a, MEDIUM_DRIFT_TURBULENCE as b, MEDIUM_EMISSION_BEATS as c, MEDIUM_EMISSION_PROBABILITY as d, MEDIUM_MIN_EMISSION_INTERVAL as e, MEDIUM_NATURAL_INTERVAL as f, MEDIUM_NATURAL_JITTER as g, MEDIUM_PLAYING_TURBULENCE_RANGE as h, MEDIUM_PROBE_FLOOR_PX as i, MEDIUM_SENSITIVE_BOTTOM as j, MEDIUM_SENSITIVE_TOP as k, MEDIUM_TRACK_PRESETS as l, MEDIUM_TURBULENCE_TAU as m, type VireUIKitMediumDynamics as n, type VireUIKitMediumDynamicsFrame as o, type VireUIKitMediumDynamicsInput as p, type VireUIKitMediumEmission as q, type VireUIKitMediumParams as r, type VireUIKitMediumPlaybackState as s, type VireUIKitMediumTrackPreset as t, type VireUIKitMediumTrackPresetName as u, createMediumDynamics as v };

package/dist/dynamics-BqBoj03x.d.ts

@@ -1,160 +0,0 @@
-type VireUIKitMediumChannel = readonly [number, number, number];
-type VireUIKitMediumParams = {
-    /** 1/s — how fast the TRACK density decays per second. Water (vapor+condensate) does not decay:
-     *  it is a conserved volume, only moving between phases and being transported. */
-    decay: number;
-    /** Spatial frequency of the curl-noise potential, 1/px of the simulation grid. */
-    curlFreq: number;
-    /** Drift speed of the noise domain over time, 1/s. */
-    curlSpeed: number;
-    /** Velocity field scale, grid-px/s — how far the smoke can be carried in a second. */
-    advectSpeed: number;
-    /** Turbulence gate, 0…1 (playback drives it: playing is alive, paused cools down). The
-     *  per-frame value is computed by `createMediumDynamics` (`dynamics.ts`) — it arrives here
-     *  already resolved. */
-    turbulence: number;
-    /** 1/s — the fraction of vapor EXCESS above `condensationFloor` that turns into condensate every
-     *  second from background seeding: weak, everywhere, all the time — the chamber is never
-     *  perfectly clean. */
-    condensationRate: number;
-    /** Vapor density (in seed-density units, a spot's peak ≈1) below which condensation does not
-     *  happen at all — only the excess above it condenses. Without a floor, the condensate would
-     *  exactly retrace the vapor spot's shape (the same outline, or softer from growth blur), and
-     *  the two phases would have nowhere to visually diverge: vapor is already soft, so the floor
-     *  concentrates condensate in dense turbulence cores, leaving the sparse vapor around it
-     *  uncondensed. Keep it NOTICEABLY below the settled mean vapor level (turbulence stirs spots
-     *  into a nearly flat background of ~0.3 over a few minutes — a known limit of the numerical
-     *  advection): a floor above that mean eventually stops finding any excess at all, and
-     *  condensation dies out for good. */
-    condensationFloor: number;
-    /** 1/s — the fraction of condensate evaporating back into vapor. Larger than the condensation
-     *  rate: at equilibrium most of the water stays vapor, which is the "supersaturated" one. */
-    evaporationRate: number;
-    /** grid-px/s — condensate drift downward, on top of the shared velocity field: gravity touches
-     *  droplets and leaves vapor alone. */
-    condensateSettleSpeed: number;
-    /** 1/s — the rate at which a droplet blends with its grid neighbors. There is no separate age
-     *  counter: the blend repeats every frame, and whatever has survived more frames ends up more
-     *  blended with its neighbors on its own — that IS "growth". Keep it NOTICEABLY below
-     *  `evaporationRate`: over a droplet's average lifetime (1/evaporationRate) only a small
-     *  fraction should get to blend — otherwise the blur outruns evaporation and the whole grid
-     *  levels into flat fog before a droplet gets a chance to return to vapor (visible by eye: the
-     *  contrast between "a patch of droplets" and the vapor background disappears within seconds). */
-    condensateSpreadRate: number;
-    /** 0…1 — how much of the local vapor hue shows through in the condensate. Droplets carry no
-     *  color of their own (droplets scatter light rather than tint it) — this is only a faint hint
-     *  of the surroundings. */
-    condensateTint: number;
-    /** Condensate's visibility multiplier in the Oklab mix relative to vapor at equal density —
-     *  droplets hold a small share of the water's mass, but they are mostly what's visible (as in a
-     *  real cloud: vapor is transparent, droplets create the visibility). */
-    condensateGain: number;
-    /** Near-white sRGB tone of droplets with no hue seeding (`condensateTint=0`) — droplets scatter
-     *  light rather than color it. */
-    condensateColor: VireUIKitMediumChannel;
-    /** Each vapor species' hue, sRGB 0…1. Derived as a family around one tone (`speciesFamily`),
-     *  not picked as three separate colors — see `species.ts`. */
-    channelColors: readonly [VireUIKitMediumChannel, VireUIKitMediumChannel, VireUIKitMediumChannel];
-    /** The platform's neutral tone — what the medium is, alone, with no source playing. */
-    baseColor: VireUIKitMediumChannel;
-    /** Background weight in the Oklab mix: keeps the platform tone visible even where the smoke is dense. */
-    baseWeight: number;
-};
-declare const MEDIUM_DEFAULTS: VireUIKitMediumParams;
-/** The material probe can't see texture finer than this: there is no gain in a denser simulation
- *  grid than the probe's own floor. */
-declare const MEDIUM_PROBE_FLOOR_PX = 22;
-/** Device-px per simulation grid cell by default — noticeably coarser than the probe floor;
- *  sharpening the detail visible right next to the glass is a later increment (emission and
- *  palette). */
-declare const MEDIUM_DEFAULT_CELL_PX = 26;
-/**
- * The geometry of one track stamp (`emit-shader.ts`), in FRACTIONS of `min(gridW, gridH)` rather
- * than pixels — so a preset doesn't depend on the simulation grid's resolution. Two presets:
- * alpha is a thick, short, straight track; beta is a thin, long, ragged one. The third, natural,
- * is dim and short, for the occasional background track at rest (not tied to cover art).
- */
-type VireUIKitMediumTrackPreset = {
-    lengthFrac: number;
-    headWidthFrac: number;
-    tailWidthFrac: number;
-    /** Amplitude of the path's sideways noise, as a fraction of `min(gridW, gridH)`; 0 = a straight thread. */
-    raggedFrac: number;
-    raggedFreq: number;
-    /** How far the tail has settled downward, as a fraction of `min(gridW, gridH)`. */
-    settleFrac: number;
-    /** How much dimmer the tail is than the head, 0…1. */
-    tailDim: number;
-    intensity: number;
-};
-declare const MEDIUM_TRACK_PRESETS: Readonly<Record<'alpha' | 'beta' | 'natural', VireUIKitMediumTrackPreset>>;
-/** Turbulence at rest/paused/with no active track — the "slow drift" baseline shared by all three
- *  neutral states (they differ from each other in other ways, not in this number). */
-declare const MEDIUM_DRIFT_TURBULENCE = 0.045;
-/** Turbulence range during playback: the low end is a quiet stretch of the track, the high end is
- *  peak amplitude. */
-declare const MEDIUM_PLAYING_TURBULENCE_RANGE: readonly [number, number];
-/** Turbulence smoothing time constant, seconds: both ramping up on play and cooling down on pause
- *  go through this filter — smooth, never a jump. */
-declare const MEDIUM_TURBULENCE_TAU = 2.5;
-/** Emission cadence — once every this many beats, not on every beat: at 120–180 BPM that is
- *  0.5–0.75 Hz, an order of magnitude below the WCAG 2.3.1 photosensitivity ceiling (3 Hz). */
-declare const MEDIUM_EMISSION_BEATS = 4;
-/** Fraction of the beats that actually get an emission — breaks up the exact periodicity (a
- *  metronome-perfect pulse reads as mechanical) without moving the average rate. */
-declare const MEDIUM_EMISSION_PROBABILITY = 0.55;
-/** Emergency floor between two emissions, seconds — a safeguard for the same WCAG 2.3.1
- *  requirement, independent of `MEDIUM_EMISSION_BEATS`/BPM: even a mistake in the other constants
- *  can't flash faster than this. */
-declare const MEDIUM_MIN_EMISSION_INTERVAL = 1.2;
-/** Average interval between solitary "background emission" tracks at rest, seconds, plus a random
- *  `MEDIUM_NATURAL_JITTER` on top — rare, with no discernible rhythm. */
-declare const MEDIUM_NATURAL_INTERVAL = 25;
-declare const MEDIUM_NATURAL_JITTER = 35;
-/** The sensitive layer — fractions of height, top to bottom. Above it there isn't enough
- *  supersaturation for a track to appear at all, so background emission is only ever visible here. */
-declare const MEDIUM_SENSITIVE_TOP = 0.55;
-declare const MEDIUM_SENSITIVE_BOTTOM = 0.95;
-
-type VireUIKitMediumPlaybackState = 'idle' | 'playing' | 'paused' | 'stopped';
-type VireUIKitMediumTrackPresetName = keyof typeof MEDIUM_TRACK_PRESETS;
-/** The fully resolved geometry of one track stamp — the platform layer (`web/medium.ts`)
- *  translates fractions into simulation-grid pixels and binds the uniforms, deciding nothing else:
- *  which preset, where, and how bright is entirely this model's call. */
-type VireUIKitMediumEmission = VireUIKitMediumTrackPreset & {
-    /** 0…1, a fraction of the grid on both axes — the source point (cover art while playing;
-     *  wherever it happens to land at rest). */
-    source: readonly [number, number];
-    /** Radians, direction from the source to the head. */
-    angle: number;
-    seed: number;
-    channel: readonly [number, number, number];
-};
-type VireUIKitMediumDynamicsInput = {
-    state: VireUIKitMediumPlaybackState;
-    /** Beats per minute of the active track; unread in states with no track. */
-    bpm: number;
-    /** 0…1 — a continuous volume envelope (e.g. from precomputed waveform peaks), NOT the beat itself. */
-    amplitude: number;
-    /** Seconds, a deterministic playback position (not wall-clock time) — the emission cadence has
-     *  to be derived from it rather than accumulating its own phase. */
-    positionSeconds: number;
-    /** 0…1 — the area of the active track's cover art that emission comes from while playing. */
-    sourcePoint: readonly [number, number];
-    dt: number;
-};
-type VireUIKitMediumDynamicsFrame = {
-    turbulence: number;
-    emissions: readonly VireUIKitMediumEmission[];
-};
-type VireUIKitMediumDynamics = {
-    step(input: VireUIKitMediumDynamicsInput): VireUIKitMediumDynamicsFrame;
-};
-/**
- * Stateful "playback dynamics" model: turbulence and emission scheduling per frame. Platform
- * neutral — the caller supplies the clock and the playback position (in a bench, that would be
- * its own render loop); it never reads `performance.now()` or the DOM itself.
- */
-declare function createMediumDynamics(): VireUIKitMediumDynamics;
-
-export { MEDIUM_DEFAULTS as M, type VireUIKitMediumChannel as V, MEDIUM_DEFAULT_CELL_PX as a, MEDIUM_DRIFT_TURBULENCE as b, MEDIUM_EMISSION_BEATS as c, MEDIUM_EMISSION_PROBABILITY as d, MEDIUM_MIN_EMISSION_INTERVAL as e, MEDIUM_NATURAL_INTERVAL as f, MEDIUM_NATURAL_JITTER as g, MEDIUM_PLAYING_TURBULENCE_RANGE as h, MEDIUM_PROBE_FLOOR_PX as i, MEDIUM_SENSITIVE_BOTTOM as j, MEDIUM_SENSITIVE_TOP as k, MEDIUM_TRACK_PRESETS as l, MEDIUM_TURBULENCE_TAU as m, type VireUIKitMediumDynamics as n, type VireUIKitMediumDynamicsFrame as o, type VireUIKitMediumDynamicsInput as p, type VireUIKitMediumEmission as q, type VireUIKitMediumParams as r, type VireUIKitMediumPlaybackState as s, type VireUIKitMediumTrackPreset as t, type VireUIKitMediumTrackPresetName as u, createMediumDynamics as v };