vireuikit 0.3.0 → 0.4.0

package/dist/web/index.d.cts

@@ -1,4 +1,4 @@
-import { t as VireUIKitMediumParams, s as VireUIKitMediumEmission } from '../dynamics-7Bq3LLds.cjs';
+import { G as VireUIKitMediumParams, F as VireUIKitMediumEmission, a as VireUIKitMediumLight } from '../dynamics-DqGk_f1n.cjs';
 import { VireGlassBackdropPass } from 'vireglass/web';
 
 type MediumRuntime = {
@@ -17,6 +17,13 @@ type MediumRuntime = {
      * and their own decay extinguishes them; there is no lifetime timer here.
      */
     emit(emissions: readonly VireUIKitMediumEmission[]): void;
+    /**
+     * Ages, drifts and caps the crisp screen-space track layer's own live-track list (see
+     * `track-layer.ts`) and folds `emissions` into it as fresh tracks — independent of `emit()`
+     * above: that one stamps the SOFT grid residue, this one feeds the SHARP geometry `composite`
+     * draws over it. Called once per frame, same as `emit`.
+     */
+    stepTrackLayer(dt: number, emissions: readonly VireUIKitMediumEmission[]): void;
     /**
      * Composites the current density (vapor + condensate + tracks) into a buffer already bound by
      * the caller (the renderer's `contentFbo`) — this is exactly how the medium acts as the second
@@ -48,6 +55,14 @@ type MediumRuntime = {
         rows: number;
         data: number[];
     } | null;
+    /** The raw TRACK grid, at simulation-grid resolution, `data` as one density value per cell (a
+     *  track carries no color — see `readCondensateGrid`). Used by the "sharp at birth, soft later"
+     *  gate to measure a stamped track's cross-section directly. */
+    readTrackGrid(): {
+        cols: number;
+        rows: number;
+        data: number[];
+    } | null;
     destroy(): void;
 };
 declare function createMediumRuntime(gl: WebGL2RenderingContext, vertexSource: string): MediumRuntime;
@@ -84,8 +99,54 @@ type MediumBackdrop = {
         rows: number;
         data: number[];
     } | null;
+    readTrackGrid(): {
+        cols: number;
+        rows: number;
+        data: number[];
+    } | null;
     destroy(): void;
 };
 declare function createMediumBackdrop(): MediumBackdrop;
 
-export { type MediumBackdrop, type MediumFrame, type MediumRuntime, createMediumBackdrop, createMediumRuntime };
+/** One track alive in the crisp layer: the original emission (never mutated) plus its age and
+ *  drift. */
+type VireUIKitLiveTrack = {
+    emission: VireUIKitMediumEmission;
+    /** Seconds since the track appeared. Negative while a burst ray is still waiting for its turn. */
+    age: number;
+    /** Accumulated rigid drift, as a fraction of `min(contentWidth, contentHeight)`. */
+    driftX: number;
+    driftY: number;
+};
+/** `(1 - age/life) ** gamma`, reaching exactly 0 at `age >= life`, so dropping a track never pops. */
+declare function trackLayerFade(age: number, life: number): number;
+/** Diffusion: droplets spread sideways as `sqrt(age)`, the way an ink line blurs. */
+declare function trackLayerSigmaMul(age: number, broaden: number): number;
+type VireUIKitTrackLayer = {
+    /**
+     * Ages and drifts every live track by `dt`, drops anything past its own life, appends
+     * `emissions` as fresh tracks and caps the list at `MEDIUM_TRACK_LAYER_MAX_TRACKS` (oldest out).
+     * Alpha rays arriving in one call are one burst: the first few appear at once, the rest are born
+     * over `MEDIUM_TRACK_LAYER_BURST_SPREAD` seconds.
+     */
+    step(dt: number, emissions: readonly VireUIKitMediumEmission[]): readonly VireUIKitLiveTrack[];
+};
+declare function createTrackLayer(): VireUIKitTrackLayer;
+
+/** Fraction-space live tracks → per-instance floats in content px, y down like the emission
+ *  fractions and the backdrop target (drift is y-up, hence its sign flip). Skips tracks not yet born,
+ *  fully faded, or everything when `amount <= 0` (the canary `check:medium` uses). Exported for
+ *  testing without a GPU. */
+declare function buildTrackLayerInstances(tracks: readonly VireUIKitLiveTrack[], contentWidth: number, contentHeight: number, amount: number): {
+    data: Float32Array;
+    count: number;
+};
+type TrackLayerProgram = {
+    /** Draws the instances additively into the currently bound framebuffer. Leaves blending enabled;
+     *  the renderer restores its own state after the backdrop pass. */
+    draw(contentWidth: number, contentHeight: number, data: Float32Array, count: number, trackLightFloor: number, lights: readonly (VireUIKitMediumLight | undefined)[], shadow: WebGLTexture): void;
+    destroy(): void;
+};
+declare function createTrackLayerProgram(gl: WebGL2RenderingContext): TrackLayerProgram;
+
+export { type MediumBackdrop, type MediumFrame, type MediumRuntime, type TrackLayerProgram, type VireUIKitLiveTrack, type VireUIKitTrackLayer, buildTrackLayerInstances, createMediumBackdrop, createMediumRuntime, createTrackLayer, createTrackLayerProgram, trackLayerFade, trackLayerSigmaMul };

package/dist/web/index.d.ts

@@ -1,4 +1,4 @@
-import { t as VireUIKitMediumParams, s as VireUIKitMediumEmission } from '../dynamics-7Bq3LLds.js';
+import { G as VireUIKitMediumParams, F as VireUIKitMediumEmission, a as VireUIKitMediumLight } from '../dynamics-DqGk_f1n.js';
 import { VireGlassBackdropPass } from 'vireglass/web';
 
 type MediumRuntime = {
@@ -17,6 +17,13 @@ type MediumRuntime = {
      * and their own decay extinguishes them; there is no lifetime timer here.
      */
     emit(emissions: readonly VireUIKitMediumEmission[]): void;
+    /**
+     * Ages, drifts and caps the crisp screen-space track layer's own live-track list (see
+     * `track-layer.ts`) and folds `emissions` into it as fresh tracks — independent of `emit()`
+     * above: that one stamps the SOFT grid residue, this one feeds the SHARP geometry `composite`
+     * draws over it. Called once per frame, same as `emit`.
+     */
+    stepTrackLayer(dt: number, emissions: readonly VireUIKitMediumEmission[]): void;
     /**
      * Composites the current density (vapor + condensate + tracks) into a buffer already bound by
      * the caller (the renderer's `contentFbo`) — this is exactly how the medium acts as the second
@@ -48,6 +55,14 @@ type MediumRuntime = {
         rows: number;
         data: number[];
     } | null;
+    /** The raw TRACK grid, at simulation-grid resolution, `data` as one density value per cell (a
+     *  track carries no color — see `readCondensateGrid`). Used by the "sharp at birth, soft later"
+     *  gate to measure a stamped track's cross-section directly. */
+    readTrackGrid(): {
+        cols: number;
+        rows: number;
+        data: number[];
+    } | null;
     destroy(): void;
 };
 declare function createMediumRuntime(gl: WebGL2RenderingContext, vertexSource: string): MediumRuntime;
@@ -84,8 +99,54 @@ type MediumBackdrop = {
         rows: number;
         data: number[];
     } | null;
+    readTrackGrid(): {
+        cols: number;
+        rows: number;
+        data: number[];
+    } | null;
     destroy(): void;
 };
 declare function createMediumBackdrop(): MediumBackdrop;
 
-export { type MediumBackdrop, type MediumFrame, type MediumRuntime, createMediumBackdrop, createMediumRuntime };
+/** One track alive in the crisp layer: the original emission (never mutated) plus its age and
+ *  drift. */
+type VireUIKitLiveTrack = {
+    emission: VireUIKitMediumEmission;
+    /** Seconds since the track appeared. Negative while a burst ray is still waiting for its turn. */
+    age: number;
+    /** Accumulated rigid drift, as a fraction of `min(contentWidth, contentHeight)`. */
+    driftX: number;
+    driftY: number;
+};
+/** `(1 - age/life) ** gamma`, reaching exactly 0 at `age >= life`, so dropping a track never pops. */
+declare function trackLayerFade(age: number, life: number): number;
+/** Diffusion: droplets spread sideways as `sqrt(age)`, the way an ink line blurs. */
+declare function trackLayerSigmaMul(age: number, broaden: number): number;
+type VireUIKitTrackLayer = {
+    /**
+     * Ages and drifts every live track by `dt`, drops anything past its own life, appends
+     * `emissions` as fresh tracks and caps the list at `MEDIUM_TRACK_LAYER_MAX_TRACKS` (oldest out).
+     * Alpha rays arriving in one call are one burst: the first few appear at once, the rest are born
+     * over `MEDIUM_TRACK_LAYER_BURST_SPREAD` seconds.
+     */
+    step(dt: number, emissions: readonly VireUIKitMediumEmission[]): readonly VireUIKitLiveTrack[];
+};
+declare function createTrackLayer(): VireUIKitTrackLayer;
+
+/** Fraction-space live tracks → per-instance floats in content px, y down like the emission
+ *  fractions and the backdrop target (drift is y-up, hence its sign flip). Skips tracks not yet born,
+ *  fully faded, or everything when `amount <= 0` (the canary `check:medium` uses). Exported for
+ *  testing without a GPU. */
+declare function buildTrackLayerInstances(tracks: readonly VireUIKitLiveTrack[], contentWidth: number, contentHeight: number, amount: number): {
+    data: Float32Array;
+    count: number;
+};
+type TrackLayerProgram = {
+    /** Draws the instances additively into the currently bound framebuffer. Leaves blending enabled;
+     *  the renderer restores its own state after the backdrop pass. */
+    draw(contentWidth: number, contentHeight: number, data: Float32Array, count: number, trackLightFloor: number, lights: readonly (VireUIKitMediumLight | undefined)[], shadow: WebGLTexture): void;
+    destroy(): void;
+};
+declare function createTrackLayerProgram(gl: WebGL2RenderingContext): TrackLayerProgram;
+
+export { type MediumBackdrop, type MediumFrame, type MediumRuntime, type TrackLayerProgram, type VireUIKitLiveTrack, type VireUIKitTrackLayer, buildTrackLayerInstances, createMediumBackdrop, createMediumRuntime, createTrackLayer, createTrackLayerProgram, trackLayerFade, trackLayerSigmaMul };