vireuikit 0.4.0 → 0.5.0

package/NOTICE

@@ -4,8 +4,5 @@ Copyright 2026 Danil Kotlaev
 This product includes software developed as part of the vireSpace platform
 (https://github.com/pruffit/vire).
 
-Built on VireGlass (https://github.com/pruffit/vireglass). The Oklab color-mixing math
-implements the model published by Björn Ottosson (https://bottosson.github.io/posts/oklab/).
-The MacCormack advection scheme implements the method described in Selle, Fedkiw, Kim, Liu and
-Rossignac, "An Unconditionally Stable MacCormack Method" (2007). No third-party code or assets
-are included in or distributed with this software; these are citations, not redistribution.
+Built on VireGlass (https://github.com/pruffit/vireglass). No third-party code or assets are
+included in or distributed with this software.

package/README.md

@@ -1,9 +1,8 @@
 # VireUIKit
 
 A UI kit built on top of [VireGlass](https://github.com/pruffit/vireglass)'s physically-derived
-glass material: atom state and press/hover/selection behavior for controls, a capsule-to-target
-growth morph, and a live GPU backdrop — a lit cloud-chamber: dark mist, static lights, and
-condensation tracks — that plugs into VireGlass's WebGL2 renderer as a backdrop pass.
+glass material: atom state and press/hover/selection behavior for controls, and a
+capsule-to-target growth morph.
 
 **Status: 0.x.** The API can still change between minor versions.
 
@@ -13,8 +12,8 @@ condensation tracks — that plugs into VireGlass's WebGL2 renderer as a backdro
 npm install vireuikit vireglass
 ```
 
-`vireglass` is a peer dependency — this package draws on its material model and its WebGL2 render
-pipeline rather than shipping its own.
+`vireglass` is a peer dependency — this package draws on its material model rather than
+shipping its own.
 
 ## Atom state and morph
 
@@ -44,85 +43,6 @@ const frame = growthFrame(sourceShape, targetShape, anchorPoint, growthPhase(sta
 // frame.body: the shape to draw as glass this frame.
 ```
 
-## GPU backdrop: a lit chamber, not colored smoke
-
-`createMediumBackdrop()` returns a `VireGlassBackdropPass` factory: a self-contained fluid
-simulation (curl-noise vapor, condensing droplets, decaying condensation tracks) that composites
-straight into the texture VireGlass's lens samples — no offscreen canvas, no readback.
-
-The chamber itself is dark; what's visible is light scattered by vapor, droplets and tracks, not
-the gas's own color. `lights` (`VireUIKitMediumParams`, up to `MEDIUM_MAX_LIGHTS`) are static
-sources — position, direction, cone half-angle, falloff, color, intensity. The defaults are an edge
-strip along the chamber floor and two spotlights placed above the frame, aimed down across it. A
-spotlight has no drawn edge: its beam is a soft lobe with static shafts fanning out from the lamp,
-dimmed by the gas between the lamp and each point (a grid-resolution shadow pass,
-`shadowExtinction`), so beams show where there is vapor to scatter them. `lightRigForCover`/
-`lightRigForCharacter` tint the spotlights toward a cover's hue like colored gels and leave the
-strip near neutral. Vapor species (`channelColors`) fold into a near-neutral ambient base;
-`channelScatter` is how strongly each species scatters light.
-
-Tracks come in three kinds (`MEDIUM_TRACK_PRESETS`): `alpha` (short, thick, thickening toward its
-end — the playing source sprays a burst of them from the cover's position, a few on the beat and
-the rest over the next 1.6 s), `electron` (thin, wiggly) and `muon` (long, straight,
-thin). The calm state schedules a lone electron or muon every 8–20 s from no source at all. Each track is drawn twice: as a soft residue stamped into the simulation grid, and
-as a crisp droplet chain in content pixels (`trackLayerAmount`, `MEDIUM_TRACK_LAYER_LOOK`) that
-appears at full length, then broadens, sags and fades over one to two seconds. Tracks are lit by
-the same lights, plus `trackLightFloor` so one is never fully dark.
-
-```ts
-import { createMediumBackdrop } from 'vireuikit/web';
-import { createVireGlassRenderer } from 'vireglass/web';
-
-const medium = createMediumBackdrop();
-const renderer = createVireGlassRenderer(canvas);
-renderer.resize(canvas.width, canvas.height);
-
-let last = performance.now();
-function frame(now: number) {
-  const dt = (now - last) / 1000;
-  last = now;
-  renderer.render({
-    density: window.devicePixelRatio,
-    debug: 'normal',
-    pieces,
-    backdrop: medium.pass({ gridWidth: 128, gridHeight: 72, dt }),
-  });
-  requestAnimationFrame(frame);
-}
-```
-
-Turbulence and light-track emission in response to playback come from `createMediumDynamics()`,
-which is platform-neutral: feed `step()` a playback state, BPM and a deterministic position, and
-pass the `emissions` it returns on as `MediumFrame.emissions`.
-
-The backdrop reads as a chamber seen from the side, not a flat field, without a second simulation:
-the composite samples the same vapor/condensate grid twice, once at identity and once at a larger
-scale and a fixed offset (`MEDIUM_DEFAULTS.depthFarScale`/`depthFarOffsetFrac`, the offset as a
-fraction of the grid so it stays clear of the wrap at any grid size) — the far read is both slower
-on screen and finer-grained, since the field's own motion maps to screen motion as `v / scale`. An
-8-tap rotated ring blur on that far read (`depthFarBlurRadius`) supplies aerial perspective's
-softness and lower contrast in the same pass, weighted down (`depthFarWeight`) so it never competes
-with the near plane; the ring (not an axis-aligned box) keeps that blur from turning a residual
-seam or resize artifact into parallel straight lines. Gravity is two separate properties: a small
-downward drift on vapor's own velocity (`gravityVaporDrift`, a motion cue only — a uniform drift on
-this periodic grid cannot itself accumulate density) and a compositing-only density boost near the
-bottom of the frame (`gravityBottomBoost`/`gravityBottomBoostStart`, a steady-state property that
-cannot affect the conserved water total) that actually produces the "denser at the bottom" reading.
-Condensate settling adds a second, always-on share of the ambient curl field's own sideways push
-(`condensateSettleWiggle`) so a droplet falling at a constant speed doesn't trace a dead-straight
-vertical line when turbulence is otherwise low. Each emitted track also carries a `depth` (0 far …
-1 near) that scales its own width and intensity, so a far track reads thinner, dimmer and finer,
-while the nearest tracks read a little LARGER than the base preset, not merely full-size — a
-Gaussian stamp's edge softness scales with its own width, so the same knob gives depth of field too.
-
-The curl-noise potential itself is periodic over the simulation grid in space, the same way it
-already was in time: each octave's spatial frequency is adjusted, per grid size, to the nearest
-value that makes a full grid width (or height) an exact integer number of lattice cells
-(`computeMediumSpatialPeriods`) — so velocity never jumps at the domain's own wrap, and the far
-plane's tile boundary reads as an ordinary point in the field rather than a seam. The near plane's
-vapor and condensate reads use cubic B-spline reconstruction (4 bilinear taps) instead of plain
-bilinear, so the simulation grid's own cells don't read as squares at typical (coarse) grid sizes.
-
 ## License
 
 Apache-2.0. See [LICENSE](./LICENSE) and [NOTICE](./NOTICE).