@vitreajs/vitrea 0.23.0 → 0.24.0

package/dist/{dist-NMQ322KB.js → dist-K743C2OC.js}

@@ -1025,6 +1025,9 @@ var DEFAULT_MATERIAL_PROFILE = {
   backdropToneResponseThin: [0.0126, 0.4561, 0.9713],
   backdropToneResponseThick: [0.4953, 0.5744, 0.9358],
   backdropToneResponseStrength: 1,
+  backdropToneBlackStrength: 0,
+  backdropToneBlackThin: 0,
+  backdropToneBlackThick: 0,
   /*
    * FITTED (recalibration cascade, 2026-08-31). W8's geometry SURVIVES the fit
    * unchanged — `sigmaPx` 15.55, `offsetPx` 7.95, `spreadPx` 3.10 — and only the
@@ -1198,6 +1201,15 @@ var MATERIAL_IDENTITY_TABLE = [
       law: "colour = renormaliseToLinearLuma(mix(colour, chromaticityOf(backdrop) at colour's luma, bodyChromaRetention))",
       inertLawCase: "TO BE COMMITTED BY W31 G3 \u2014 the leaf does not exist yet. G0 names the shape and its identity (W31 X2); the case that proves the composite is bit-identical at 0, and the `test:gpu` case that the on state draws differently from off, land with the leaf."
     }
+  },
+  {
+    wave: "W36",
+    gate: { backdropToneBlackStrength: 0 },
+    gated: ["backdropToneBlackThin", "backdropToneBlackThick"],
+    law: "Below x=0.003 blend response and authority toward the black endpoint by strength*(1-smoothstep(0,0.003,x)); elsewhere execute the old solve exactly.",
+    inertLawCase: 'packages/renderer-webgpu/test/w31-gate-groups.test.ts \u2014 "gate-group 4 \u2014 black strength 0 gates both black ordinates"; drawn identity in packages/renderer-webgpu/e2e/gpu/w36-black-branch.spec.ts',
+    whyGated: "The strength-0 branch never reads either ordinate, preserving the old solve.",
+    claims: "c9a \xA75.179; W36 Decision Log 5"
   }
 ];
 function materialLeafAt(resolved, path) {
@@ -1397,6 +1409,9 @@ function withMaterialOverrides(base, patch) {
     backdropToneResponseThin,
     backdropToneResponseThick,
     backdropToneResponseStrength: patch.backdropToneResponseStrength ?? base.backdropToneResponseStrength,
+    backdropToneBlackStrength: patch.backdropToneBlackStrength ?? base.backdropToneBlackStrength,
+    backdropToneBlackThin: patch.backdropToneBlackThin ?? base.backdropToneBlackThin,
+    backdropToneBlackThick: patch.backdropToneBlackThick ?? base.backdropToneBlackThick,
     outerShadow: { ...base.outerShadow, ...patch.outerShadow },
     lightDirection: patch.lightDirection ?? base.lightDirection,
     rimLitAxis: patch.rimLitAxis ?? base.rimLitAxis,
@@ -1578,11 +1593,24 @@ function backdropToneResponse(encodedInput, thickness, profile = DEFAULT_MATERIA
     s0 = slopes[seg];
     s1 = slopes[seg + 1];
   }
-  return y0 * (1 + 2 * t) * (1 - t) * (1 - t) + s0 * h * t * (1 - t) * (1 - t) + y1 * t * t * (3 - 2 * t) + s1 * h * t * t * (t - 1) + levelFar;
+  const response = y0 * (1 + 2 * t) * (1 - t) * (1 - t) + s0 * h * t * (1 - t) * (1 - t) + y1 * t * t * (3 - 2 * t) + s1 * h * t * t * (t - 1) + levelFar;
+  const black = backdropToneBlackWeight(encodedInput, profile);
+  if (black === 0)
+    return response;
+  const level = profile.backdropToneBlackThin + (profile.backdropToneBlackThick - profile.backdropToneBlackThin) * f;
+  return response + (level - response) * black;
+}
+var BACKDROP_TONE_BLACK_JOIN = 3e-3;
+function backdropToneBlackWeight(encodedInput, profile) {
+  if (profile.backdropToneBlackStrength <= 0 || encodedInput >= BACKDROP_TONE_BLACK_JOIN)
+    return 0;
+  return Math.min(1, Math.max(0, profile.backdropToneBlackStrength)) * (1 - smoothstep(0, BACKDROP_TONE_BLACK_JOIN, encodedInput));
 }
 function backdropToneSolveWeight(encodedInput, profile = DEFAULT_MATERIAL_PROFILE) {
   const anchor = profile.backdropToneAnchorX[0];
-  return smoothstep(anchor * 0.5, anchor, encodedInput);
+  const authority = smoothstep(anchor * 0.5, anchor, encodedInput);
+  const black = backdropToneBlackWeight(encodedInput, profile);
+  return black === 0 ? authority : authority + (1 - authority) * black;
 }
 function sizeThicknessUnderPolicy(spanPx, policy, profile = DEFAULT_MATERIAL_PROFILE) {
   return sizeThickness(spanPx, profile) * profile.refractionScale[accessibilityRefractionCap(policy)];
@@ -3929,6 +3957,8 @@ var WGSL_OPTICS_PASS = `struct OpticsUniforms {
   /// below is multiplied by zero and the composite is bit-identical to the one
   /// W30 left, which is why the 34 goldens do not move.
   bodyChroma : vec4f,
+  /// W36: strength, linear thin/thick black ordinates, padding. Gate 0 is identity.
+  toneBlack : vec4f,
 };
 
 @group(0) @binding(0) var<uniform> ou : OpticsUniforms;
@@ -4830,8 +4860,9 @@ fn fs_optics(in : FullscreenOut) -> @location(0) vec4f {
    *
    * Three stand-downs, each measured rather than defensive: the whole axis is
    * off where no backdrop tone was measured (same gate as the collapse); the
-   * solve's authority fades to zero below the dark anchor, where the only
-   * evidence is the impulse cell the collapse constants were fitted on; and
+   * default solve's authority fades to zero below the dark anchor, where W9
+   * had only its impulse evidence (W36's selected black branch restores that
+   * authority within its separate support); and
    * at k \u2192 1 the collapse owns the pixel outright, so the solve's
    * extrapolation is never evaluated against a vanishing (1 \u2212 k).
    */
@@ -4841,10 +4872,22 @@ fn fs_optics(in : FullscreenOut) -> @location(0) vec4f {
       sizedAlpha > 1e-3 && toneAdapt < 0.995) {
     let encodedInput = srgb_encode(toneColour.w);
     let anchor = max(ou.toneAnchor.x, 1e-4);
-    let authority =
+    var authority =
       smoothstep(anchor * 0.5, anchor, encodedInput) * clamp(ou.toneRowThin.w, 0.0, 1.0);
+    var blackWeight = 0.0;
+    // Compact support rejoins before the smallest packed impulse input. Keep
+    // the gate-0 and above-join arithmetic exact; no Hermite slope is touched.
+    if (ou.toneBlack.x > 0.0 && encodedInput < 0.003) {
+      blackWeight = clamp(ou.toneBlack.x, 0.0, 1.0) *
+        (1.0 - smoothstep(0.0, 0.003, encodedInput));
+      authority = mix(authority, clamp(ou.toneRowThin.w, 0.0, 1.0), blackWeight);
+    }
     if (authority > 0.0) {
-      let response = tone_response(encodedInput, sizeK, toneLevelFar);
+      var response = tone_response(encodedInput, sizeK, toneLevelFar);
+      if (blackWeight > 0.0) {
+        let f = sizeK * sizeK * (3.0 - 2.0 * sizeK);
+        response = mix(response, mix(ou.toneBlack.y, ou.toneBlack.z, f), blackWeight);
+      }
       // The collapse's mean pull is toward L(toneColour.rgb) \u2014 the LINEAR
       // mean, which toneAnchor.w carries \u2014 not toward the encoded level.
       let preCollapse = (response - toneAdapt * toneLinearMean) / (1.0 - toneAdapt);
@@ -5741,7 +5784,7 @@ function createPassRunner(context) {
       };
     },
     opticsPass(encoder, args) {
-      const slot = uniformSlot(`optics:${args.resourceId}`, 136);
+      const slot = uniformSlot(`optics:${args.resourceId}`, 140);
       const d = slot.data;
       d[0] = args.viewportDevice[0];
       d[1] = args.viewportDevice[1];
@@ -5876,6 +5919,10 @@ function createPassRunner(context) {
       d[133] = 0;
       d[134] = 0;
       d[135] = 0;
+      d[136] = args.backdropToneBlackStrength;
+      d[137] = args.backdropToneBlackThin;
+      d[138] = args.backdropToneBlackThick;
+      d[139] = 0;
       slot.write();
       const chain = args.backdrop?.chain ?? placeholderView;
       const body = args.backdrop?.body ?? placeholderView;
@@ -7502,6 +7549,9 @@ function createWebGPURenderer(options = {}) {
         // from `backdropToneLevel`, so the fourth slot carries the linear
         // mean — the one quantity the solve needs that the tone colour does
         // not already hold.
+        backdropToneBlackStrength: material.backdropToneBlackStrength,
+        backdropToneBlackThin: material.backdropToneBlackThin,
+        backdropToneBlackThick: material.backdropToneBlackThick,
         backdropToneAnchorX: material.backdropToneAnchorX,
         backdropToneResponseThin: material.backdropToneResponseThin,
         backdropToneResponseThick: material.backdropToneResponseThick,
@@ -7872,5 +7922,5 @@ function createWebGPURenderer(options = {}) {
 }
 
 export { ADAPTIVE_LUMINANCE_HIGH, ADAPTIVE_LUMINANCE_LOW, ADAPTIVE_TINT_DARK, ADAPTIVE_TINT_LIGHT, ANALYSIS_DISPATCH, ANALYSIS_GRID, ANALYSIS_PASS_ID, ANALYSIS_STATS_FLOATS, ANALYSIS_TARGET_EXTENT, ANALYSIS_WORKGROUP, BACKDROP_ALPHA_MODES, BACKDROP_COLOR_SPACES, BACKDROP_KINDS, BACKDROP_PASS_ID, BACKDROP_TONE_HIGH, BACKDROP_TONE_LOW, BACKDROP_TONE_MAX, BACKDROP_TONE_SIZE_BIAS, CANVAS_FORMAT, CHAIN_SIGMA_AT_LEVEL_1, CROSS_CHECK_SHAPE_FLOATS, CROSS_CHECK_WORKGROUP, DEFAULT_MATERIAL_PROFILE, FAMILY_C_CROSS_CHECK, FIELD_PASS_ID, GOVERNOR_LADDER, HIGHLIGHT_PASS_ID, IDENTITY_FIT, IDLE_CHANNELS, INCREASED_OCCLUSION_LIFT, INSTANCE_BYTES, INSTANCE_FLOATS, LENS_AMOUNT_MAX, LENS_AMOUNT_PER_SPAN, LENS_EXTENT_GAIN, LENS_HEIGHT_MAX, LENS_HEIGHT_PER_SPAN, LENS_OVALIZATION, LENS_PROFILE_EXPONENT, LENS_REFRACTION_GAIN, LENS_SIZE_GAIN_MAX, LENS_THICKNESS_REFERENCE, LUMINANCE_WEIGHTS, MATERIAL_DIGEST_RULE_VERSION, MATERIAL_IDENTITY_TABLE, MATERIAL_OPTICS, MATERIAL_VARIANTS, MAX_CHAIN_LEVELS, MIN_LEVEL_EXTENT, NOMINAL_GOVERNOR, NOMINAL_MATERIAL_POLICY, OPTICS_PASS_ID, OUTER_SHADOW, OUTER_SHADOW_THICK_SPANS, OUTER_SHADOW_THIN_L, OUTER_SHADOW_UNMEASURED_BACKDROP_LUMINANCE, OUTPUT_TEXTURE_FORMAT, PASS_LABEL, REFRACTION_LADDER, REFRACTION_SCALE, RENDERER_ERROR_CODES, RENDERER_PASS_IDS, RendererError, SIZE_OCCLUSION_GAIN, SIZE_SCATTER_FLOOR, SIZE_SCATTER_FLOOR_2X, SIZE_SCATTER_GAIN_FAR_2X, SIZE_SCATTER_GAIN_MAX, SIZE_SCATTER_GAIN_MAX_2X, SIZE_SCATTER_RAMP_REACH_1X_PX, SIZE_SCATTER_RAMP_REACH_2X_PX, SIZE_SCATTER_RAMP_START_FAR_1X, SIZE_SCATTER_RAMP_START_FAR_2X, SIZE_SCATTER_RAMP_START_THICK_1X, SIZE_SCATTER_RAMP_START_THICK_2X, SIZE_SCATTER_RAMP_START_THIN_1X, SIZE_SCATTER_RAMP_START_THIN_2X, SIZE_SCATTER_SPAN_MAX, SIZE_SCATTER_SPAN_MAX_2X, SIZE_SHADOW_GAIN_MAX, SIZE_SPAN_MAX, SIZE_SPAN_MIN, SRGB_ENCODING_EXPONENT, SUPPORTED_APP_TEXTURE_FORMATS, WGSL_ANALYSIS_PASS, WGSL_CROSS_CHECK_PASS, WGSL_DOWNSAMPLE_PASS, WGSL_FIELD_KERNELS, WGSL_FIELD_PASS, WGSL_FIELD_SAMPLE, WGSL_HIGHLIGHT_PASS, WGSL_IMPORT_PASS, WGSL_INSTANCE_STRUCT, WGSL_OPTICS_PASS, WGSL_PRELUDE, WGSL_RSUPN_GRAD, WGSL_RSUP_GRAD, WGSL_SMOOTH_UNION, WORKING_TEXTURE_FORMAT, ZERO_STATS, accessibilityRefractionCap, adaptationStrength, adaptedTintAlpha, adaptedTintColour, adaptiveTint, allShaderSource, alphaNormalisationMode, analysisModule, backdropFit, backdropToneAdaptation, backdropToneResponse, backdropToneSizeBiasUnderPolicy, backdropToneSolveWeight, backdropToneUnderPolicy, bodyBlurPlan, chainModule, clipFieldRectToCanvas, collapsedRimUnderPolicy, coverFit, createAdaptationState, createAppTextureProvider, createCopyProvider, createDeviceHost, createGovernor, createGpuContext, createGradientProvider, createPassRunner, createPipelineCache, createPyramidStore, createRebuildLedger, createStorageSlot, createTexturePool, createTimingCollector, createUniformSlot, createVideoProvider, createWebGPURenderer, crossCheckKernelModule, displayP3ToSrgbLinear, effectiveRefraction, encodeOutput, encodeOutputBytes, fieldModule, fieldPassSource, groupFieldRect, heavySecondTapSigmaAtScale, heavyTapSigmaAtScale, highlightModule, importColorMatrix, importModule, importPassSource, isUsablePlacement, lensAmountBasePx, lensDepthPx, lensDirection, lensDisplacementPx, lensExtentPx, lensHeightBasePx, lensMagnitudePx, lensOvalizationAt, lensSizeGain, lensSizeGainFromThickness, linearGradientStops, linearToSrgb, linearToSrgbChannel, materialDigestDroppedLeaves, materialDigestInput, materialLeafAt, occlusionAlphaUnderPolicy, occlusionLiftForPolicy, opticsModule, opticsUnderPolicy, outerShadowAlpha, outerShadowFalloff, outerShadowLiftRise, outerShadowOcclusionAt, outerShadowReachPx, outerShadowSigmaPx, outerShadowThickOcclusion, outerShadowThinOcclusion, outerShadowUnderPolicy, packInstances, pipelineKey, placementFit, planPyramid, poolKey, readbackDue, refractionRank, relativeLuminance, rendererError, resolveSurfaces, rimAlongSideFactor, rimAlongSideField, samePlacement, scatterDeepThickness, scatterFloorAtScale, scatterGainAt, scatterGainAtScale, scatterGainFarAtScale, scatterHeavyShareThickAtScale, scatterRampAreaMean, scatterRampReachDevicePx, scatterRampStart, scatterSharpShare, scatterSpanMaxAtScale, scatterThickness, shadowDepthPx, sizeOcclusionAlpha, sizeOcclusionAlphaAt, sizeOuterShadowOcclusion, sizeOuterShadowOcclusionAt, sizeScatterSigma, sizeScatterSigmaAt, sizeShadowDepth, sizeShadowDepthAt, sizeThickness, sizeThicknessUnderPolicy, sizeToneLevelFar, snapRectToDevicePixels, srgbToLinear, srgbToLinearChannel, statsFromBuffer, supportsTimestamps, texelsPerCssPx, tintShade, tintShadeLayer, tintToneAdaptation, tintedMaterialColour, validateAppTexture, withMaterialOverrides };
-//# sourceMappingURL=dist-NMQ322KB.js.map
-//# sourceMappingURL=dist-NMQ322KB.js.map
+//# sourceMappingURL=dist-K743C2OC.js.map
+//# sourceMappingURL=dist-K743C2OC.js.map