vireglass 2.3.0 → 3.0.0

package/dist/dom.d.cts

@@ -1,8 +1,8 @@
 import { B as BackdropSample } from './adaptation-BSbbdExK.cjs';
-import { V as VireGlassGeometry } from './geometry-RhKd7CM5.cjs';
-import { V as VireGlassOptics, a as VireGlassMaterial } from './material-CnUmdKg1.cjs';
-import { T as TouchWarp, M as MorphShape, V as VireGlassAccessibility, S as ScrollEdgeStyle, G as GroupPlane } from './group-model-DwtixGhG.cjs';
-import { V as VireGlassAccent } from './adapters-DugC6Qri.cjs';
+import { V as VireGlassGeometry } from './geometry-ip9WSlZv.cjs';
+import { V as VireGlassOptics, a as VireGlassMaterial } from './material-D9m1EN47.cjs';
+import { T as TouchWarp, M as MorphShape, V as VireGlassAccessibility, S as ScrollEdgeStyle, G as GroupPlane } from './group-model-DX2_W9J_.cjs';
+import { V as VireGlassAccent } from './adapters--bXcGvhW.cjs';
 
 /** Any `backdrop-filter` at all (e.g. `blur()`) — the fallback path's own requirement. */
 declare function supportsBackdropFilter(): boolean;
@@ -32,7 +32,9 @@ declare function parseColor(value: string): RgbColor | null;
  * formula here would mean the ink-polarity decision quietly drifts between renderers on the same
  * page. `samples` are 0..255 per channel, matching what `parseColor` returns.
  */
-declare function statsFromSamples(samples: readonly RgbColor[]): BackdropSample;
+declare function statsFromSamples(samples: readonly (Omit<RgbColor, 'a'> & {
+    a?: number;
+})[]): BackdropSample;
 /**
  * Composites a stack of backgrounds front to back, the way the compositor does.
  *
@@ -100,13 +102,26 @@ declare function lightConicAngle(light: readonly [number, number]): number;
  *  the light. Both arcs come out of this one expression — that is why they are opposed. */
 declare function rimLobe(deltaDeg: number, specular: number): number;
 type RimAmbient = readonly [number, number, number];
+/** Lightness of an ambient colour, the weights the lens uses. */
+declare function ambientLuma(ambient: RimAmbient): number;
+/** How strongly the line is drawn over a surround of this lightness (§2, §6). */
+declare function rimStrength(luma: number): number;
 /**
- * The gradient for the hairline. Colour comes from the environment — "over a yellow flower the rim
- * is yellow, over sky it is blue" (§2) — lifted toward white where the key light lands. Away from
- * both arcs only the dark edge remains.
+ * The line's opacity where the rim's normal sits `deltaDeg` from the light: a floor all the way
+ * round and the key-light lobe on top of it, all of it scaled by the medium's reflectance up to
+ * the reference material's.
+ */
+declare function rimLineAlpha(deltaDeg: number, optics: VireGlassOptics, luma: number): number;
+/**
+ * The gradient for the hairline: a light line round the whole contour, brighter toward the key
+ * light, drawn over the dark edge. Its colour comes from the environment — "over a yellow flower
+ * the rim is yellow, over sky it is blue" (§2) — lifted toward white, and its strength follows how
+ * light the environment is.
  *
  * The opposing arc carries an iridescent fringe (§2), so `iridescence` pulls its channels apart
  * rather than lifting them together.
+ *
+ * Two layers, the line first: `--vireglass-rim` is a background list and paints as one.
  */
 declare function rimGradientCss(optics: VireGlassOptics, ambient: RimAmbient, light: readonly [number, number], appear?: number): string;
 declare const RIM_WIDTH_PX: 1;
@@ -151,6 +166,9 @@ type GlassBody = {
     density: number;
     /** Lightness the body tints toward. */
     tintLuma: number;
+    /** The part of the density the ink's legibility asked for, and the pole it asked toward. */
+    need: number;
+    pole: number;
 };
 /**
  * `ink` is POLARITY, 1 light and 0 dark, matching the shader's uniform. The requirements are
@@ -160,23 +178,37 @@ type GlassBody = {
 declare function resolveBody(optics: VireGlassOptics, sample: BodyBackdrop, ink: number): GlassBody;
 /**
  * PRESENCE (§3): over a uniform backdrop there is nothing to refract and the glass honestly
- * disappears — right for a piece of background, wrong for a control. It is a MINIMUM, not an
- * addition, so a body that already stands apart is left alone.
+ * disappears — right for a piece of background, wrong for a control. It is a MINIMUM on the
+ * density, toward light whatever the ink, and it does not read the backdrop: the lift it gives is
+ * `presence` times the room left under the light pole, so it fades out as the room does and has no
+ * step anywhere on the scale.
+ */
+declare function withPresence(body: GlassBody, optics: VireGlassOptics, _sample?: BodyBackdrop): GlassBody;
+type BodyLayer = {
+    /** Straight (not premultiplied) colour, 0…1 per channel. */
+    r: number;
+    g: number;
+    b: number;
+    alpha: number;
+};
+/**
+ * The body as ONE translucent layer over the backdrop, which is the form the DOM can draw it in.
+ *
+ * The lens does not paint a body, it transforms what it refracts, in a chain that stays affine in
+ * the backdrop: a mix toward the tint at `density`, the matte lift, the medium's pull toward its
+ * own lightness, the ambient spill and the concentration of light (§3, `MEDIUM`). Composing it
+ * gives `out = A * backdrop + B` per channel, and a layer of colour `B / (1 - A)` at opacity
+ * `1 - A` over the backdrop is that, except where the colour clamps to 0..1: over a saturated dark
+ * backdrop (dark blue) a channel is off by up to 0.024.
  *
- * The direction is the body's own. The previous version decided "lighter over dark, darker over
- * light" from the backdrop alone, and then, when the body disagreed, clamped `tintLuma` to the
- * backdrop's mean — the one value that separates from nothing. Light ink over a dark backdrop puts
- * the body at 0.07 against a backdrop of 0.12: already separating, downward, and the clamp pulled
- * it back onto the backdrop. Measured on the default material at presence 0.08: exactly 0.0000 at
- * backdrops of 0.12, 0.20 and 0.35.
+ * This is what lifts the body over a dark backdrop. The tint alone, under light ink, is darker
+ * than the dark it sits on; the medium's pull, the matte lift and the concentration are what make
+ * it read lighter, as in the reference (M 2:29, A 2:17).
  *
- * What the demand is DIVIDED by is deliberately the distance to the tint's pole rather than to the
- * body's own tint. Dividing by the latter is arithmetically tighter and asks for far more density
- * wherever the two are close — enough to drive it to the ceiling over a dark backdrop and stop the
- * glass being a window at all, which check:optics says plainly. Presence is a floor on visibility,
- * not a licence to go opaque.
+ * `appear` multiplies the layers exactly where the lens's `u_appear` does, so `optics` is the
+ * element's optics BEFORE `applyAppear`: scaling both would count it twice.
  */
-declare function withPresence(body: GlassBody, optics: VireGlassOptics, sample: BodyBackdrop): GlassBody;
+declare function bodyLayer(optics: VireGlassOptics, sample: BodyBackdrop, ink: number, ambient: readonly [number, number, number], appear?: number): BodyLayer;
 
 declare function systemAccessibility(): VireGlassAccessibility;
 /** Fires whenever any of the three changes. The material has to follow a setting turned on while
@@ -320,9 +352,19 @@ type AttachGlassOptions = {
     } | null) => void;
     /** Pointer response (§5). On by default. */
     interactive?: boolean;
-    /** Overrides the probe entirely — images and video are invisible to it, and the host app
-     *  already knows its own cover-art accent. */
+    /**
+     * Overrides the probe entirely. The probe reads declared backgrounds, so images, video and
+     * canvases are invisible to it; a host that knows its backdrop (a cover's accent, a gradient)
+     * states it here, and changes it later with `setSample`. `statsFromSamples` builds one from
+     * a handful of colours.
+     */
     sample?: BackdropSample;
+    /**
+     * Whether `attachGlass` paints the body as the element's `background-color`. On by default;
+     * turn it off if the host owns that property — `--vireglass-body-color` is always emitted
+     * either way and carries the same colour.
+     */
+    body?: boolean;
 };
 /**
  * Shapes this element flows into (docs/reference.md §5): merging with a neighbour, or splitting
@@ -363,8 +405,13 @@ type GlassHandle = {
         strength: number;
     } | null): void;
     setMorph(morph: GlassMorph | null): void;
+    /**
+     * Replaces the backdrop the glass adapts to, without re-attaching, and repaints. The same
+     * object as `sample` in the options; `null` goes back to probing declared backgrounds.
+     */
+    setSample(sample: BackdropSample | null): void;
     destroy(): void;
 };
 declare function attachGlass(el: HTMLElement, opts?: AttachGlassOptions): GlassHandle;
 
-export { type AttachGlassOptions, type BodyBackdrop, type DisplacementMap, type DisplacementState, type EdgePaint, type GlassBody, type GlassGroupHandle, type GlassGroupOptions, type GlassHandle, type GlassMorph, type GroupEntry, type ProbeOptions, RIM_WIDTH_PX, type RgbColor, type RimAmbient, type ScrollEdgeHandle, type ScrollEdgeOptions, type SpectralMap, attachGlass, attachScrollEdge, boxShadowCss, buildDisplacementMap, buildSpectralMap, cached, clearMapCache, compositeLayers, contrastRimCss, createGlassGroup, hasSpectralEdge, lightConicAngle, mapCacheSize, paintFor, parseColor, probeBackdrop, renderDisplacementPixels, renderSpectralPixels, resetSupportCache, resolveBody, rimGradientCss, rimLobe, shadowAlphaFrom, statsFromSamples, supportsBackdropFilter, supportsSvgBackdropFilter, systemAccessibility, watchAccessibility, withPresence };
+export { type AttachGlassOptions, type BodyBackdrop, type BodyLayer, type DisplacementMap, type DisplacementState, type EdgePaint, type GlassBody, type GlassGroupHandle, type GlassGroupOptions, type GlassHandle, type GlassMorph, type GroupEntry, type ProbeOptions, RIM_WIDTH_PX, type RgbColor, type RimAmbient, type ScrollEdgeHandle, type ScrollEdgeOptions, type SpectralMap, ambientLuma, attachGlass, attachScrollEdge, bodyLayer, boxShadowCss, buildDisplacementMap, buildSpectralMap, cached, clearMapCache, compositeLayers, contrastRimCss, createGlassGroup, hasSpectralEdge, lightConicAngle, mapCacheSize, paintFor, parseColor, probeBackdrop, renderDisplacementPixels, renderSpectralPixels, resetSupportCache, resolveBody, rimGradientCss, rimLineAlpha, rimLobe, rimStrength, shadowAlphaFrom, statsFromSamples, supportsBackdropFilter, supportsSvgBackdropFilter, systemAccessibility, watchAccessibility, withPresence };

package/dist/dom.d.ts

@@ -1,8 +1,8 @@
 import { B as BackdropSample } from './adaptation-BSbbdExK.js';
-import { V as VireGlassGeometry } from './geometry-GvXtt-_S.js';
-import { V as VireGlassOptics, a as VireGlassMaterial } from './material-CnUmdKg1.js';
-import { T as TouchWarp, M as MorphShape, V as VireGlassAccessibility, S as ScrollEdgeStyle, G as GroupPlane } from './group-model-z4N27qsC.js';
-import { V as VireGlassAccent } from './adapters-BfeAopGO.js';
+import { V as VireGlassGeometry } from './geometry-pabkYV7w.js';
+import { V as VireGlassOptics, a as VireGlassMaterial } from './material-D9m1EN47.js';
+import { T as TouchWarp, M as MorphShape, V as VireGlassAccessibility, S as ScrollEdgeStyle, G as GroupPlane } from './group-model-CQiI5cCe.js';
+import { V as VireGlassAccent } from './adapters-BlMhc6pI.js';
 
 /** Any `backdrop-filter` at all (e.g. `blur()`) — the fallback path's own requirement. */
 declare function supportsBackdropFilter(): boolean;
@@ -32,7 +32,9 @@ declare function parseColor(value: string): RgbColor | null;
  * formula here would mean the ink-polarity decision quietly drifts between renderers on the same
  * page. `samples` are 0..255 per channel, matching what `parseColor` returns.
  */
-declare function statsFromSamples(samples: readonly RgbColor[]): BackdropSample;
+declare function statsFromSamples(samples: readonly (Omit<RgbColor, 'a'> & {
+    a?: number;
+})[]): BackdropSample;
 /**
  * Composites a stack of backgrounds front to back, the way the compositor does.
  *
@@ -100,13 +102,26 @@ declare function lightConicAngle(light: readonly [number, number]): number;
  *  the light. Both arcs come out of this one expression — that is why they are opposed. */
 declare function rimLobe(deltaDeg: number, specular: number): number;
 type RimAmbient = readonly [number, number, number];
+/** Lightness of an ambient colour, the weights the lens uses. */
+declare function ambientLuma(ambient: RimAmbient): number;
+/** How strongly the line is drawn over a surround of this lightness (§2, §6). */
+declare function rimStrength(luma: number): number;
 /**
- * The gradient for the hairline. Colour comes from the environment — "over a yellow flower the rim
- * is yellow, over sky it is blue" (§2) — lifted toward white where the key light lands. Away from
- * both arcs only the dark edge remains.
+ * The line's opacity where the rim's normal sits `deltaDeg` from the light: a floor all the way
+ * round and the key-light lobe on top of it, all of it scaled by the medium's reflectance up to
+ * the reference material's.
+ */
+declare function rimLineAlpha(deltaDeg: number, optics: VireGlassOptics, luma: number): number;
+/**
+ * The gradient for the hairline: a light line round the whole contour, brighter toward the key
+ * light, drawn over the dark edge. Its colour comes from the environment — "over a yellow flower
+ * the rim is yellow, over sky it is blue" (§2) — lifted toward white, and its strength follows how
+ * light the environment is.
  *
  * The opposing arc carries an iridescent fringe (§2), so `iridescence` pulls its channels apart
  * rather than lifting them together.
+ *
+ * Two layers, the line first: `--vireglass-rim` is a background list and paints as one.
  */
 declare function rimGradientCss(optics: VireGlassOptics, ambient: RimAmbient, light: readonly [number, number], appear?: number): string;
 declare const RIM_WIDTH_PX: 1;
@@ -151,6 +166,9 @@ type GlassBody = {
     density: number;
     /** Lightness the body tints toward. */
     tintLuma: number;
+    /** The part of the density the ink's legibility asked for, and the pole it asked toward. */
+    need: number;
+    pole: number;
 };
 /**
  * `ink` is POLARITY, 1 light and 0 dark, matching the shader's uniform. The requirements are
@@ -160,23 +178,37 @@ type GlassBody = {
 declare function resolveBody(optics: VireGlassOptics, sample: BodyBackdrop, ink: number): GlassBody;
 /**
  * PRESENCE (§3): over a uniform backdrop there is nothing to refract and the glass honestly
- * disappears — right for a piece of background, wrong for a control. It is a MINIMUM, not an
- * addition, so a body that already stands apart is left alone.
+ * disappears — right for a piece of background, wrong for a control. It is a MINIMUM on the
+ * density, toward light whatever the ink, and it does not read the backdrop: the lift it gives is
+ * `presence` times the room left under the light pole, so it fades out as the room does and has no
+ * step anywhere on the scale.
+ */
+declare function withPresence(body: GlassBody, optics: VireGlassOptics, _sample?: BodyBackdrop): GlassBody;
+type BodyLayer = {
+    /** Straight (not premultiplied) colour, 0…1 per channel. */
+    r: number;
+    g: number;
+    b: number;
+    alpha: number;
+};
+/**
+ * The body as ONE translucent layer over the backdrop, which is the form the DOM can draw it in.
+ *
+ * The lens does not paint a body, it transforms what it refracts, in a chain that stays affine in
+ * the backdrop: a mix toward the tint at `density`, the matte lift, the medium's pull toward its
+ * own lightness, the ambient spill and the concentration of light (§3, `MEDIUM`). Composing it
+ * gives `out = A * backdrop + B` per channel, and a layer of colour `B / (1 - A)` at opacity
+ * `1 - A` over the backdrop is that, except where the colour clamps to 0..1: over a saturated dark
+ * backdrop (dark blue) a channel is off by up to 0.024.
  *
- * The direction is the body's own. The previous version decided "lighter over dark, darker over
- * light" from the backdrop alone, and then, when the body disagreed, clamped `tintLuma` to the
- * backdrop's mean — the one value that separates from nothing. Light ink over a dark backdrop puts
- * the body at 0.07 against a backdrop of 0.12: already separating, downward, and the clamp pulled
- * it back onto the backdrop. Measured on the default material at presence 0.08: exactly 0.0000 at
- * backdrops of 0.12, 0.20 and 0.35.
+ * This is what lifts the body over a dark backdrop. The tint alone, under light ink, is darker
+ * than the dark it sits on; the medium's pull, the matte lift and the concentration are what make
+ * it read lighter, as in the reference (M 2:29, A 2:17).
  *
- * What the demand is DIVIDED by is deliberately the distance to the tint's pole rather than to the
- * body's own tint. Dividing by the latter is arithmetically tighter and asks for far more density
- * wherever the two are close — enough to drive it to the ceiling over a dark backdrop and stop the
- * glass being a window at all, which check:optics says plainly. Presence is a floor on visibility,
- * not a licence to go opaque.
+ * `appear` multiplies the layers exactly where the lens's `u_appear` does, so `optics` is the
+ * element's optics BEFORE `applyAppear`: scaling both would count it twice.
  */
-declare function withPresence(body: GlassBody, optics: VireGlassOptics, sample: BodyBackdrop): GlassBody;
+declare function bodyLayer(optics: VireGlassOptics, sample: BodyBackdrop, ink: number, ambient: readonly [number, number, number], appear?: number): BodyLayer;
 
 declare function systemAccessibility(): VireGlassAccessibility;
 /** Fires whenever any of the three changes. The material has to follow a setting turned on while
@@ -320,9 +352,19 @@ type AttachGlassOptions = {
     } | null) => void;
     /** Pointer response (§5). On by default. */
     interactive?: boolean;
-    /** Overrides the probe entirely — images and video are invisible to it, and the host app
-     *  already knows its own cover-art accent. */
+    /**
+     * Overrides the probe entirely. The probe reads declared backgrounds, so images, video and
+     * canvases are invisible to it; a host that knows its backdrop (a cover's accent, a gradient)
+     * states it here, and changes it later with `setSample`. `statsFromSamples` builds one from
+     * a handful of colours.
+     */
     sample?: BackdropSample;
+    /**
+     * Whether `attachGlass` paints the body as the element's `background-color`. On by default;
+     * turn it off if the host owns that property — `--vireglass-body-color` is always emitted
+     * either way and carries the same colour.
+     */
+    body?: boolean;
 };
 /**
  * Shapes this element flows into (docs/reference.md §5): merging with a neighbour, or splitting
@@ -363,8 +405,13 @@ type GlassHandle = {
         strength: number;
     } | null): void;
     setMorph(morph: GlassMorph | null): void;
+    /**
+     * Replaces the backdrop the glass adapts to, without re-attaching, and repaints. The same
+     * object as `sample` in the options; `null` goes back to probing declared backgrounds.
+     */
+    setSample(sample: BackdropSample | null): void;
     destroy(): void;
 };
 declare function attachGlass(el: HTMLElement, opts?: AttachGlassOptions): GlassHandle;
 
-export { type AttachGlassOptions, type BodyBackdrop, type DisplacementMap, type DisplacementState, type EdgePaint, type GlassBody, type GlassGroupHandle, type GlassGroupOptions, type GlassHandle, type GlassMorph, type GroupEntry, type ProbeOptions, RIM_WIDTH_PX, type RgbColor, type RimAmbient, type ScrollEdgeHandle, type ScrollEdgeOptions, type SpectralMap, attachGlass, attachScrollEdge, boxShadowCss, buildDisplacementMap, buildSpectralMap, cached, clearMapCache, compositeLayers, contrastRimCss, createGlassGroup, hasSpectralEdge, lightConicAngle, mapCacheSize, paintFor, parseColor, probeBackdrop, renderDisplacementPixels, renderSpectralPixels, resetSupportCache, resolveBody, rimGradientCss, rimLobe, shadowAlphaFrom, statsFromSamples, supportsBackdropFilter, supportsSvgBackdropFilter, systemAccessibility, watchAccessibility, withPresence };
+export { type AttachGlassOptions, type BodyBackdrop, type BodyLayer, type DisplacementMap, type DisplacementState, type EdgePaint, type GlassBody, type GlassGroupHandle, type GlassGroupOptions, type GlassHandle, type GlassMorph, type GroupEntry, type ProbeOptions, RIM_WIDTH_PX, type RgbColor, type RimAmbient, type ScrollEdgeHandle, type ScrollEdgeOptions, type SpectralMap, ambientLuma, attachGlass, attachScrollEdge, bodyLayer, boxShadowCss, buildDisplacementMap, buildSpectralMap, cached, clearMapCache, compositeLayers, contrastRimCss, createGlassGroup, hasSpectralEdge, lightConicAngle, mapCacheSize, paintFor, parseColor, probeBackdrop, renderDisplacementPixels, renderSpectralPixels, resetSupportCache, resolveBody, rimGradientCss, rimLineAlpha, rimLobe, rimStrength, shadowAlphaFrom, statsFromSamples, supportsBackdropFilter, supportsSvgBackdropFilter, systemAccessibility, watchAccessibility, withPresence };

package/dist/dom.js

@@ -1,8 +1,8 @@
-import { shadowTint, NO_ACCESSIBILITY, createGroupState, createDeform, elasticAllowed, contrastRimLuma, concentricRadius, scrollEdgeStrength, scrollEdgeStyle, applyGlassScale, GLASS_SCALE_DEFAULT, applyAccessibility, applyAppear, accentTone, accentAmount, raiseIntoGlass } from './chunk-CTTZNZFV.js';
+import { shadowTint, NO_ACCESSIBILITY, createGroupState, createDeform, elasticAllowed, contrastRimLuma, concentricRadius, scrollEdgeStrength, scrollEdgeStyle, applyAppear, accentTone, accentAmount, applyGlassScale, GLASS_SCALE_DEFAULT, applyAccessibility, raiseIntoGlass } from './chunk-VLDD655U.js';
 import { ambientFrom, shouldInkBeLight, INK_LIGHT, INK_DARK } from './chunk-JNRZNMJJ.js';
-import { touchWarp, sceneDistance, sceneGradient, sdfRoundedRect, VIREGLASS_MATERIAL, REST_LIGHT, resolveOptics, refractionStrength } from './chunk-H5QTBF67.js';
-import { shadowOpacity, bevelDp, thicknessDp, rimDp, shadowOpacityFrom, shadowReachDp, halfMinDp, MAX_STRETCH, roundedRectGeometry } from './chunk-SLRPHDV7.js';
-import { LENS, BODY, RIM, TOUCH, SHADOW, SHADOW_GAP, SCROLL_EDGE, BEVEL, SPECTRAL, DISPERSION } from './chunk-MMPK6DCK.js';
+import { touchWarp, sceneDistance, sceneGradient, sdfRoundedRect, VIREGLASS_MATERIAL, REST_LIGHT, resolveOptics, refractionStrength } from './chunk-YAN2OK4H.js';
+import { shadowOpacity, bevelDp, thicknessDp, rimDp, shadowOpacityFrom, shadowReachDp, halfMinDp, MAX_STRETCH, roundedRectGeometry } from './chunk-Z4FKYY47.js';
+import { LENS, BODY, RIM, TOUCH, SHADOW, SHADOW_GAP, MEDIUM, SCROLL_EDGE, BEVEL, SPECTRAL, DISPERSION } from './chunk-CPSIY2DZ.js';
 
 // src/dom/displacement.ts
 var SCALE_GAIN = 0.75;
@@ -392,8 +392,10 @@ var {
   tintLight: TINT_LIGHT,
   groundSpan: GROUND_SPAN,
   busyEdge: BUSY_EDGE,
-  darkSideFrom: DARK_SIDE_FROM,
-  darkSideTo: DARK_SIDE_TO,
+  inkBusyFrom: INK_BUSY_FROM,
+  inkBusyTo: INK_BUSY_TO,
+  inkPoleTo: INK_POLE_TO,
+  presenceDemand: PRESENCE_DEMAND,
   maxDemand: MAX_DEMAND
 } = BODY;
 var clamp = (v, lo, hi) => v < lo ? lo : v > hi ? hi : v;
@@ -402,6 +404,10 @@ function smoothstep2(edge0, edge1, x) {
   const t = clamp((x - edge0) / (edge1 - edge0), 0, 1);
   return t * t * (3 - 2 * t);
 }
+function tintFor(density, need, pole) {
+  const asked = Math.max(clamp(need / Math.max(density, 1e-4), 0, 1), smoothstep2(PRESENCE_DEMAND, INK_POLE_TO, density));
+  return mix(TINT_LIGHT, pole, asked);
+}
 function resolveBody(optics, sample, ink) {
   const strict = clamp(optics.legibility * 2, 0, 1);
   const capLight = mix(BODY_CAP_LOOSE, BODY_CAP_TIGHT, strict);
@@ -410,33 +416,45 @@ function resolveBody(optics, sample, ink) {
   const demand = clamp(optics.legibility * 4, 0, 1);
   const mean = clamp(sample.luma, 0, 1);
   const busy = Math.max(sample.busy, 0);
-  const darkSide = smoothstep2(DARK_SIDE_FROM, DARK_SIDE_TO, mean);
-  const away = mix(TINT_LIGHT, TINT_DARK, darkSide);
-  const tintLuma = mix(away, mix(TINT_LIGHT, TINT_DARK, pol), demand);
+  const pole = mix(TINT_LIGHT, TINT_DARK, pol);
   const edge = busy * BUSY_EDGE;
   const inkHi = Math.min(mean + edge, 1);
   const inkLo = Math.max(mean - edge, 0);
   const needForLight = inkHi > capLight ? clamp((inkHi - capLight) / Math.max(inkHi - TINT_DARK, 1e-4), 0, MAX_DEMAND) : 0;
   const needForDark = inkLo < floorDark ? clamp((floorDark - inkLo) / Math.max(TINT_LIGHT - inkLo, 1e-4), 0, MAX_DEMAND) : 0;
-  const needForInk = mix(needForDark, needForLight, pol) * demand;
+  const structured = smoothstep2(INK_BUSY_FROM, INK_BUSY_TO, busy);
+  const needForInk = mix(needForDark, needForLight, pol) * demand * structured;
   const ground = busy * optics.legibility * GROUND_SPAN;
-  return { density: Math.max(Math.max(optics.bodyDensity, ground), needForInk), tintLuma };
+  const density = Math.max(Math.max(optics.bodyDensity, ground), needForInk);
+  return { density, tintLuma: tintFor(density, needForInk, pole), need: needForInk, pole };
 }
-function withPresence(body, optics, sample) {
+function withPresence(body, optics, _sample) {
   if (optics.presence <= 0) return body;
-  const mean = clamp(sample.luma, 0, 1);
-  const above = Math.abs(body.tintLuma - mean) > 1e-4 ? body.tintLuma > mean : mean < 0.5;
-  const pole = above ? TINT_LIGHT : TINT_DARK;
-  const separation = Math.min(optics.presence, Math.abs(pole - mean));
-  const reached = Math.abs(body.tintLuma - mean) * body.density;
-  if (reached >= separation) return body;
-  const needed = separation / Math.max(Math.abs(pole - mean), 1e-4);
-  return {
-    density: Math.max(body.density, Math.min(needed, BODY.presenceDemand)),
-    // Left where the tint law put it, unless it landed exactly on the backdrop — which is the
-    // case that used to be created here rather than avoided.
-    tintLuma: Math.abs(body.tintLuma - mean) > 1e-4 ? body.tintLuma : pole
+  const density = Math.max(body.density, Math.min(optics.presence / TINT_LIGHT, PRESENCE_DEMAND));
+  return { ...body, density, tintLuma: tintFor(density, body.need, body.pole) };
+}
+function hueOf(c) {
+  const l = 0.2126 * c[0] + 0.7152 * c[1] + 0.0722 * c[2];
+  if (l < 0.02) return [1, 1, 1];
+  return [clamp(c[0] / l, 0, 2), clamp(c[1] / l, 0, 2), clamp(c[2] / l, 0, 2)];
+}
+function bodyLayer(optics, sample, ink, ambient, appear = 1) {
+  const a = clamp(appear, 0, 1);
+  const body = withPresence(resolveBody(optics, sample, ink), optics);
+  const hue = hueOf(ambient);
+  const pickup = clamp(optics.colorPickup, 0, 1);
+  const density = clamp(body.density * a, 0, 1);
+  const matte = optics.legibility * MEDIUM.matteLift * a;
+  const pull = MEDIUM.pull * a;
+  const spill = optics.edgeLight * MEDIUM.ambientSpill * a;
+  const lift = MEDIUM.concentrate * a;
+  const alpha = 1 - (1 - lift) * (1 - pull) * (1 - density);
+  const channel = (i) => {
+    const tintHue = mix(1, hue[i], pickup);
+    const added = (1 - pull) * (density * tintHue * body.tintLuma + matte * tintHue) + pull * hue[i] * MEDIUM.luma + ambient[i] * spill;
+    return alpha > 1e-6 ? clamp(((1 - lift) * added + lift) / alpha, 0, 1) : 0;
   };
+  return { r: channel(0), g: channel(1), b: channel(2), alpha };
 }
 
 // src/dom/preferences.ts
@@ -480,7 +498,14 @@ function watchAccessibility(onChange) {
 }
 
 // src/dom/rim.ts
-var { lobeExponent: LOBE_EXPONENT, opposingArc: OPPOSING_ARC, darkEdge: DARK_EDGE } = RIM;
+var {
+  lobeExponent: LOBE_EXPONENT,
+  opposingArc: OPPOSING_ARC,
+  darkEdge: DARK_EDGE,
+  contour: CONTOUR,
+  whiteShare: WHITE_SHARE,
+  reflectanceRef: REFLECTANCE_REF
+} = RIM;
 var STOPS = 48;
 function lightConicAngle(light) {
   const [lx, ly] = light;
@@ -495,25 +520,41 @@ function rimLobe(deltaDeg, specular) {
 }
 var clamp012 = (v) => v < 0 ? 0 : v > 1 ? 1 : v;
 var to2552 = (v) => Math.round(clamp012(v) * 255);
+var mixTo = (a, b, t) => a + (b - a) * t;
+function smoothstep3(edge0, edge1, x) {
+  const t = clamp012((x - edge0) / (edge1 - edge0));
+  return t * t * (3 - 2 * t);
+}
+function ambientLuma(ambient) {
+  return 0.2126 * ambient[0] + 0.7152 * ambient[1] + 0.0722 * ambient[2];
+}
+function rimStrength(luma2) {
+  return mixTo(RIM.strengthDark, RIM.strengthLight, smoothstep3(RIM.ambientFrom, RIM.ambientTo, luma2));
+}
+function rimLineAlpha(deltaDeg, optics, luma2) {
+  const reflect = Math.min(optics.fresnel / REFLECTANCE_REF, 1);
+  const damping = optics.fresnel > 0 ? optics.specular / optics.fresnel : 0;
+  const lobe = rimLobe(deltaDeg, damping);
+  return clamp012(rimStrength(luma2) * reflect * (CONTOUR + (1 - CONTOUR) * lobe));
+}
 function rimGradientCss(optics, ambient, light, appear = 1) {
   const present = clamp012(appear);
   const start = lightConicAngle(light);
   const [ar, ag, ab] = ambient;
-  const stops = [];
+  const luma2 = ambientLuma(ambient);
+  const line = [];
   for (let i = 0; i <= STOPS; i += 1) {
     const angle = i / STOPS * 360;
-    const key = rimLobe(angle, optics.specular);
     const facing = Math.cos(angle * Math.PI / 180);
     const fringe = facing < 0 ? optics.iridescence * OPPOSING_ARC : 0;
-    const lift = clamp012(key * optics.fresnel);
-    const r = ar + (1 - ar) * clamp012(lift + fringe);
-    const g = ag + (1 - ag) * lift;
-    const b = ab + (1 - ab) * clamp012(lift - fringe);
-    const alpha = clamp012(DARK_EDGE + lift * (1 - DARK_EDGE)) * present;
-    const colour = lift > 1e-3 ? `rgba(${to2552(r)},${to2552(g)},${to2552(b)},${alpha.toFixed(3)})` : `rgba(0,0,0,${alpha.toFixed(3)})`;
-    stops.push(`${colour} ${angle.toFixed(1)}deg`);
+    const r = ar + (1 - ar) * clamp012(WHITE_SHARE + fringe);
+    const g = ag + (1 - ag) * WHITE_SHARE;
+    const b = ab + (1 - ab) * clamp012(WHITE_SHARE - fringe);
+    const alpha = rimLineAlpha(angle, optics, luma2) * present;
+    line.push(`rgba(${to2552(r)},${to2552(g)},${to2552(b)},${alpha.toFixed(3)}) ${angle.toFixed(1)}deg`);
   }
-  return `conic-gradient(from ${start.toFixed(1)}deg, ${stops.join(", ")})`;
+  const dark = `rgba(0,0,0,${(DARK_EDGE * present).toFixed(3)})`;
+  return `conic-gradient(from ${start.toFixed(1)}deg, ${line.join(", ")}), conic-gradient(${dark} 0deg, ${dark} 360deg)`;
 }
 var RIM_WIDTH_PX = RIM.widthPx;
 function contrastRimCss(bodyLuma, rimLuma) {
@@ -535,6 +576,15 @@ function warnIfNested(el) {
   );
 }
 
+// src/dom/style-hold.ts
+function holdProperty(style, name) {
+  const saved = style.getPropertyValue(name);
+  return () => {
+    if (saved) style.setProperty(name, saved);
+    else style.removeProperty(name);
+  };
+}
+
 // src/dom/scroll-edge.ts
 function paintFor(style, side) {
   const direction = side === "top" ? "to top" : "to bottom";
@@ -806,16 +856,16 @@ var to2553 = (v) => Math.round(Math.min(Math.max(v, 0), 1) * 255);
 function rgbCss(r, g, b) {
   return `rgb(${to2553(r)} ${to2553(g)} ${to2553(b)})`;
 }
-function bodyCss(optics, sample, ink, accent) {
-  const body = withPresence(resolveBody(optics, sample, ink), optics, sample);
+function bodyCss(optics, sample, ink, accent, appear) {
   if (accent) {
-    const [r2, g2, b2] = accentTone(accent.color, sample.luma);
+    const settled = applyAppear(optics, appear);
+    const body = withPresence(resolveBody(settled, sample, ink), settled);
+    const [r, g, b] = accentTone(accent.color, sample.luma);
     const amount = Math.max(accentAmount(accent), body.density);
-    return `rgba(${to2553(r2)}, ${to2553(g2)}, ${to2553(b2)}, ${amount.toFixed(3)})`;
+    return `rgba(${to2553(r)}, ${to2553(g)}, ${to2553(b)}, ${amount.toFixed(3)})`;
   }
-  const [r, g, b] = ambientFrom(sample);
-  const hue = (c) => body.tintLuma + (c - body.tintLuma) * optics.colorPickup;
-  return `rgba(${to2553(hue(r))}, ${to2553(hue(g))}, ${to2553(hue(b))}, ${body.density.toFixed(3)})`;
+  const layer = bodyLayer(optics, sample, ink, ambientFrom(sample), appear);
+  return `rgba(${to2553(layer.r)}, ${to2553(layer.g)}, ${to2553(layer.b)}, ${layer.alpha.toFixed(3)})`;
 }
 function attachGlass(el, opts = {}) {
   if (typeof document === "undefined") {
@@ -832,6 +882,7 @@ function attachGlass(el, opts = {}) {
   const onlyWhenTouched = opts.variant === "interactive";
   let appear = onlyWhenTouched ? 0 : opts.appear ?? 1;
   let accent = opts.accent;
+  let supplied = opts.sample;
   let a11y = systemAccessibility();
   const stopWatchingA11y = watchAccessibility((next) => {
     a11y = next;
@@ -843,13 +894,16 @@ function attachGlass(el, opts = {}) {
   const host = hostFor(el);
   ensureRimStyles(host);
   el.setAttribute(GLASS_ATTR, "");
+  const restoreBackground = holdProperty(el.style, "background-color");
   const positionWasStatic = getComputedStyle(el).position === "static";
   if (positionWasStatic) el.style.setProperty("position", "relative");
-  function optics(patch) {
+  function settledOptics(patch) {
     const base = resolveOptics(patch ?? opts.material);
     const scaled = applyGlassScale(base, opts.scale ?? GLASS_SCALE_DEFAULT);
-    const settled = applyAccessibility(scaled, opts.accessibility ?? a11y);
-    return applyAppear(settled, appear);
+    return applyAccessibility(scaled, opts.accessibility ?? a11y);
+  }
+  function optics(patch) {
+    return applyAppear(settledOptics(patch), appear);
   }
   function morphState() {
     if (!morph) return {};
@@ -864,7 +918,10 @@ function attachGlass(el, opts = {}) {
     if (destroyed) return;
     const geometry = opts.geometry ?? measureGeometry(el);
     const opticsNow = optics();
-    const sample = opts.sample ?? probeBackdrop(el);
+    const sample = supplied ?? probeBackdrop(el);
+    const light = shouldInkBeLight(sample, wasLight);
+    wasLight = light;
+    const body = opts.body === false ? null : bodyCss(settledOptics(), sample, light ? 1 : 0, accent, appear);
     if (svgSupported) {
       const key = `a${appear.toFixed(3)}|m${morphKey()}|${geometry.width}x${geometry.height}r${geometry.cornerRadius}@${devicePixelRatio()}:${opticsNow.refraction}:${opticsNow.refractionScale}:${opticsNow.bevelDp}:${opticsNow.blur}`;
       if (key !== mapKey || !filterEl) {
@@ -882,10 +939,8 @@ function attachGlass(el, opts = {}) {
     } else {
       el.style.setProperty("backdrop-filter", fallbackFilterCss(opticsNow));
       el.style.setProperty("-webkit-backdrop-filter", fallbackFilterCss(opticsNow));
-      el.style.backgroundColor = bodyCss(opticsNow, sample, wasLight ? 1 : 0, accent);
     }
-    const light = shouldInkBeLight(sample, wasLight);
-    wasLight = light;
+    if (body) el.style.backgroundColor = body;
     const [tr, tg, tb] = ambientFrom(sample);
     el.style.setProperty("--vireglass-ink", light ? "1" : "0");
     el.style.setProperty("--vireglass-tint", `${tr} ${tg} ${tb}`);
@@ -893,8 +948,11 @@ function attachGlass(el, opts = {}) {
     const inkLevel = Math.round((light ? INK_LIGHT : INK_DARK) * 255);
     el.style.setProperty("--vireglass-ink-color", `rgb(${inkLevel} ${inkLevel} ${inkLevel})`);
     el.style.setProperty("--vireglass-tint-color", rgbCss(tr, tg, tb));
-    el.style.setProperty("--vireglass-body-color", bodyCss(opticsNow, sample, light ? 1 : 0, accent));
-    const pole = withPresence(resolveBody(opticsNow, sample, light ? 1 : 0), opticsNow, sample).tintLuma;
+    el.style.setProperty(
+      "--vireglass-body-color",
+      body ?? bodyCss(settledOptics(), sample, light ? 1 : 0, accent, appear)
+    );
+    const pole = withPresence(resolveBody(opticsNow, sample, light ? 1 : 0), opticsNow).tintLuma;
     el.style.setProperty(
       "--vireglass-rim",
       (opts.accessibility ?? a11y).increaseContrast ? contrastRimCss(pole, contrastRimLuma(pole)) : rimGradientCss(opticsNow, [tr, tg, tb], opts.light ?? REST_LIGHT, appear)
@@ -955,7 +1013,7 @@ function attachGlass(el, opts = {}) {
       el.style.setProperty("--vireglass-glow-opacity", "0");
       return;
     }
-    const [gr, gg, gb] = ambientFrom(opts.sample ?? probeBackdrop(el));
+    const [gr, gg, gb] = ambientFrom(supplied ?? probeBackdrop(el));
     const cx = (x + geometry.width / 2) / geometry.width * 100;
     const cy = (y + geometry.height / 2) / geometry.height * 100;
     const reach = halfMinDp(geometry) * TOUCH_RADIUS_FRACTION;
@@ -1045,7 +1103,7 @@ function attachGlass(el, opts = {}) {
     mapKey = "";
     el.style.removeProperty("backdrop-filter");
     el.style.removeProperty("-webkit-backdrop-filter");
-    el.style.removeProperty("background-color");
+    if (opts.body !== false) restoreBackground();
     el.style.removeProperty("--vireglass-ink");
     el.style.removeProperty("--vireglass-tint");
     el.style.removeProperty("--vireglass-body-density");
@@ -1093,12 +1151,16 @@ function attachGlass(el, opts = {}) {
       mapKey = "";
       apply();
     },
+    setSample(next) {
+      supplied = next ?? void 0;
+      apply();
+    },
     destroy
   };
   attached.set(el, handle);
   return handle;
 }
 
-export { RIM_WIDTH_PX, attachGlass, attachScrollEdge, boxShadowCss, buildDisplacementMap, buildSpectralMap, cached, clearMapCache, compositeLayers, contrastRimCss, createGlassGroup, hasSpectralEdge, lightConicAngle, mapCacheSize, paintFor, parseColor, probeBackdrop, renderDisplacementPixels, renderSpectralPixels, resetSupportCache, resolveBody, rimGradientCss, rimLobe, shadowAlphaFrom, statsFromSamples, supportsBackdropFilter, supportsSvgBackdropFilter, systemAccessibility, watchAccessibility, withPresence };
+export { RIM_WIDTH_PX, ambientLuma, attachGlass, attachScrollEdge, bodyLayer, boxShadowCss, buildDisplacementMap, buildSpectralMap, cached, clearMapCache, compositeLayers, contrastRimCss, createGlassGroup, hasSpectralEdge, lightConicAngle, mapCacheSize, paintFor, parseColor, probeBackdrop, renderDisplacementPixels, renderSpectralPixels, resetSupportCache, resolveBody, rimGradientCss, rimLineAlpha, rimLobe, rimStrength, shadowAlphaFrom, statsFromSamples, supportsBackdropFilter, supportsSvgBackdropFilter, systemAccessibility, watchAccessibility, withPresence };
 //# sourceMappingURL=dom.js.map
 //# sourceMappingURL=dom.js.map