@vitreajs/vitrea 0.20.0 → 0.22.0

package/dist/index.d.ts

@@ -3266,6 +3266,60 @@ interface MaterialProfile {
      * it at every ratio and this anchor is the identity on the landed material.
      */
     readonly collapseTransmission2x: number;
+    /**
+     * **How much of the blurred backdrop's CHROMATICITY the body restores** (W31;
+     * claims §5.161 §5, fitted in §5.164) — a fraction in [0, 1], inert at 0.
+     *
+     * The body is a neutral plate composited over the blurred backdrop, so what a
+     * photograph's hues survive the composite at is `1 − sizedAlpha` — 0.513 on the
+     * macOS 27 light document and 0.095 on the dark one, against a reference that
+     * reads 0.90–0.97 of its own backdrop's chroma on the same cells. Apple's body
+     * at the same LEVEL keeps the hue, which is what a darkening acting on the
+     * backdrop's luma while leaving its chromaticity alone does and what a plate
+     * does not. No constant the material had could close that (W29 Decision Log
+     * 6 (c)): it is a mechanism, and this is the one leaf that adds it.
+     *
+     * Applied immediately after `colour = mix(backdrop, adapted, presentAlpha)`
+     * and before the tint composition, so an author's tint still displaces the
+     * result. The colour is mixed toward `backdrop · (Y / Y_backdrop)` — the
+     * backdrop's chromaticity carried to the colour's OWN linear luma — by this
+     * fraction, so **luma is preserved by construction rather than by
+     * correction**: both endpoints of the mix have linear luma exactly `Y`,
+     * `dot(rgb, (0.2126, 0.7152, 0.0722))` is a linear functional, and the mix has
+     * luma `Y` in exact arithmetic. (OKLab `L` is NOT linear luma, which is why the
+     * formulation is in linear RGB: holding `L` while moving toward a saturated
+     * chromaticity moves `Y` by −22 % at sRGB blue and +10 % at green.) Gamut is
+     * taken by scaling chroma toward the neutral at fixed luma, never by clipping
+     * per channel.
+     *
+     * **No `toneAdapt` gate**, and the reason is measured rather than assumed
+     * (claims §5.161 §11, finding N1). A retention toward the backdrop's
+     * chromaticity is the identity wherever the backdrop is achromatic, and the
+     * only region `backdropToneAdaptation` can fire in on the macOS 27 documents
+     * is `x < backdropToneHigh` = 1e-4 of linear light — achromatic to within the
+     * capture's own quantisation. A future document that re-opens
+     * `backdropToneHigh` must re-examine that, and must read it at a span at or
+     * below `sizeSpanMin` where `backdropToneSizeBias` is not there to help.
+     *
+     * Conditioned by SCHEME (two values across the light and dark documents) and
+     * by POSE: each receded document carries its own, read on the inactive cells,
+     * because the recede's untinted body has no chroma law at all otherwise —
+     * W27c's collapse acts on the tint SEED inside `if (tintK > 0.0)`. The
+     * accessibility documents inherit the light value.
+     *
+     * **Ships at 0, a multiplied zero**: the mix's second term is `0 · (target −
+     * colour)` and `colour` leaves the composite exactly as
+     * `mix(backdrop, adapted, presentAlpha)` produced it, which is why the 34
+     * renderer goldens are byte-identical across the commit that added it and why
+     * `MATERIAL_IDENTITY_TABLE` can drop it from the fingerprint.
+     *
+     * One place it cannot act, declared rather than discovered: on the unsampled
+     * layer path (`flags.x <= 0.5` and not `domMaterial`) the shader overwrites
+     * `colour` with `adapted` and writes a layer for the browser to composite, so
+     * there is no backdrop in hand and no chromaticity to restore toward. The
+     * retention is silently the identity there.
+     */
+    readonly bodyChromaRetention: number;
     /**
      * **The rim that survives the collapse (W23)** — the one mark the collapsed
      * appearance keeps.
@@ -3516,6 +3570,7 @@ interface MaterialProfilePatch {
     readonly backdropToneSizeBias?: number;
     readonly collapseTransmission?: number;
     readonly collapseTransmission2x?: number;
+    readonly bodyChromaRetention?: number;
     readonly rimCollapsed?: number;
     readonly rimCollapsedTinted?: number;
     readonly rimTintChroma?: number;

package/dist/index.js

@@ -1092,7 +1092,7 @@ function isHealthy(state) {
 
 // src/renderer-seam.ts
 async function loadWebGPURendererModule() {
-  return import('./dist-RJXMCDIH.js');
+  return import('./dist-N437MSRG.js');
 }
 async function loadWebGPURenderer() {
   const { createWebGPURenderer } = await loadWebGPURendererModule();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitreajs/vitrea",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "description": "Framework-agnostic Liquid Glass material runtime: scene model, capability resolution, material policy, accessibility policy.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/SSFSKIM/designer",