@vitreajs/vitrea 0.16.0 → 0.18.0

package/dist/index.d.ts

@@ -486,7 +486,25 @@ type AnalysisQuality = "exact" | "hint" | "none";
 type GroupHealth = "ok" | "demoted";
 declare const DEMOTION_REASONS: readonly ["no-webgpu", "no-backdrop-filter", "tainted-source", "incompatible-texture", "no-texture-supplied", "device-lost", "probe-failed", "governor"];
 type DemotionReason = (typeof DEMOTION_REASONS)[number];
+/** W28's actual per-surface response input. Dimensions disclose a downscaled source;
+ * level zero is the finest imported image, not necessarily the original raster. */
+interface SurfaceBackdropToneAbscissa$1 {
+    readonly surfaceId: string;
+    readonly kind: "source" | "silhouette" | "hint";
+    readonly encodedLuminance: number;
+    readonly luminance: number;
+    readonly linearLuminance: number;
+    readonly color: readonly [number, number, number];
+    readonly sampleCount: number;
+    readonly level: number;
+    readonly sourceWidth: number;
+    readonly sourceHeight: number;
+    readonly sampledWidth: number;
+    readonly sampledHeight: number;
+}
 interface GlassGroupState {
+    /** Latest actual reduction for the drawn surfaces, absent before it is observed. */
+    readonly backdropToneAbscissae?: readonly SurfaceBackdropToneAbscissa$1[];
     /** What the app declared — never mutated by the runtime. */
     readonly configuredSource: ConfiguredSource;
     /** What is actually drawing. */
@@ -2127,6 +2145,11 @@ interface MaterialOuterShadow {
  * Units: CSS px for distance, linear light for colour, viewport coordinates with
  * y pointing down for direction.
  */
+type BackdropToneKnotRow = readonly [number, number, number] | readonly [number, number, number, number];
+interface MaterialOcclusionLiftByPolicy {
+    readonly reduceTransparency: number;
+    readonly increaseContrast: number;
+}
 interface MaterialProfile {
     /** Per-variant optics. `clear` is persistently more transparent than `regular`. */
     readonly optics: Readonly<Record<MaterialVariant, MaterialOptics>>;
@@ -2881,6 +2904,8 @@ interface MaterialProfile {
      * both directions by `packages/calibration/test/tier-coherence.test.ts`.
      */
     readonly increasedOcclusionLift: number;
+    /** Optional policy-specific levels. Absent keeps the shared lift exactly. */
+    readonly increasedOcclusionLiftByPolicy?: MaterialOcclusionLiftByPolicy;
     readonly strongBorderRim: MaterialRim;
     readonly reducedTintAdaptation: number;
     /**
@@ -3161,9 +3186,13 @@ interface MaterialProfile {
      * extreme-dark region stays with the collapse constants that were fitted
      * on it.
      */
-    readonly backdropToneAnchorX: readonly [number, number, number];
-    readonly backdropToneResponseThin: readonly [number, number, number];
-    readonly backdropToneResponseThick: readonly [number, number, number];
+    /** W28: absent/source preserves the source solve; silhouette reduces raw pixels per surface. */
+    readonly backdropToneAbscissa?: "source" | {
+        readonly kind: "silhouette";
+    };
+    readonly backdropToneAnchorX: BackdropToneKnotRow;
+    readonly backdropToneResponseThin: BackdropToneKnotRow;
+    readonly backdropToneResponseThick: BackdropToneKnotRow;
     /**
      * How much authority the response law has in THIS profile, 0…1 (W9).
      *
@@ -3270,6 +3299,7 @@ interface MaterialProfilePatch {
     readonly lensOvalizationSpanMax?: number;
     readonly reducedTransparencyFrost?: number;
     readonly increasedOcclusionLift?: number;
+    readonly increasedOcclusionLiftByPolicy?: Readonly<Partial<MaterialOcclusionLiftByPolicy>>;
     readonly strongBorderRim?: Readonly<Partial<MaterialRim>>;
     readonly reducedTintAdaptation?: number;
     readonly tintShadeDark?: number;
@@ -3286,9 +3316,10 @@ interface MaterialProfilePatch {
     readonly rimCollapsed?: number;
     readonly rimCollapsedTinted?: number;
     readonly rimTintChroma?: number;
-    readonly backdropToneAnchorX?: readonly [number, number, number];
-    readonly backdropToneResponseThin?: readonly [number, number, number];
-    readonly backdropToneResponseThick?: readonly [number, number, number];
+    readonly backdropToneAbscissa?: MaterialProfile["backdropToneAbscissa"];
+    readonly backdropToneAnchorX?: BackdropToneKnotRow;
+    readonly backdropToneResponseThin?: BackdropToneKnotRow;
+    readonly backdropToneResponseThick?: BackdropToneKnotRow;
     readonly backdropToneResponseStrength?: number;
     readonly outerShadow?: Readonly<Partial<MaterialOuterShadow>>;
     readonly lightDirection?: readonly [number, number];
@@ -3693,6 +3724,8 @@ interface GroupRenderInput {
      * back to a level nobody measured.
      */
     readonly backdropTone?: Rgb;
+    /** Author hints retain precedence over the silhouette reduction. */
+    readonly backdropToneHint?: boolean;
     /**
      * The backdrop's ENCODED-space tone level (W9, claims §5.31–§5.34): the mean
      * taken in sRGB-encoded space, decoded once — the input the reference's tone
@@ -4245,6 +4278,22 @@ interface PyramidStore {
     destroy(): void;
 }
 
+/** Structural twin of core's readout: the renderer cannot import its parent package. */
+interface SurfaceBackdropToneAbscissa {
+    readonly surfaceId: string;
+    readonly kind: "source" | "silhouette" | "hint";
+    readonly encodedLuminance: number;
+    readonly luminance: number;
+    readonly linearLuminance: number;
+    readonly color: readonly [number, number, number];
+    readonly sampleCount: number;
+    readonly level: number;
+    readonly sourceWidth: number;
+    readonly sourceHeight: number;
+    readonly sampledWidth: number;
+    readonly sampledHeight: number;
+}
+
 /**
  * The renderer: device, resources, and the frame.
  *
@@ -4426,6 +4475,8 @@ interface GlassRenderer {
     frameParticipant(): FrameParticipantView;
     /** Resolve any completed analysis readbacks into the adaptation drivers. */
     collectAdaptation(): Promise<number>;
+    /** Actual GPU reduction, resolved asynchronously after the submitted draw. */
+    backdropToneAbscissae(groupId: string): readonly SurfaceBackdropToneAbscissa[];
     destroy(): void;
 }
 
@@ -4497,4 +4548,4 @@ declare const VITREA_CONTRACTS: {
 declare const RENDERER_TIERS: readonly ["webgpu", "css"];
 type RendererTier = (typeof RENDERER_TIERS)[number];
 
-export { ACCESSIBILITY_BEHAVIOR_TABLE, ACCESSIBILITY_FLAGS, ACCESSIBILITY_PRECEDENCE, type AccessibilityConsequences, type AccessibilityFlag, type AccessibilityOverride, type AccessibilityOverrides, type ActiveRenderer, type AnalysisQuality, type BackdropEstimatorProvider, type BackdropHint, type BackdropHintRequest, type BackdropProvider, type BackdropRebuildRequest, type BackdropResolutionPolicy, type BackdropSourceDescriptor, type BackdropSourceRecord, type BackdropTone, type CapabilityInputs, type ConcentricParent, type ConfiguredSource, type CopyProviderOptions, type CornerProfile, type CornerRadii, type CornerReference, DEFAULT_BACKDROP_RESOLUTION, DEFAULT_CLEAR_DIMMING, DEFAULT_GROUP_SAMPLING, DEMOTION_REASONS, DEMOTION_RECOVERY, DIAGNOSTIC_CODES, type DemotionReason, type DescriptorPatch, type Diagnostic, type DiagnosticCode, type DiagnosticSeverity, type DiagnosticSink, type DiagnosticsChannel, type DiagnosticsChannelOptions, type DimmingPolicy, type DomBackdropSource, FOREGROUND_MODES, FRAME_PHASES, type ForegroundAdaptation, type ForegroundMode, type ForegroundResolutionOptions, type FrameContext, type FrameInfo, type FrameParticipant, type FramePhase, type FrameReport, type FrameScheduler, type FrameSchedulerOptions, GLASS_PLANES, GOVERNOR_PRESSURES, type GlassGroupDescriptor, type GlassGroupRecord, type GlassGroupState, type GlassNodeDescriptor, type GlassNodeRecord, type GlassPlane, type GlassRenderer, type GlassScene, GlassSceneError, type GlassSceneErrorCode, type GlassSceneOptions, type GlassTint, type GovernorPressure, type GroupHealth, type GroupSamplingGeometry, type GroupStateChange, HINT_AVAILABILITIES, type HintAvailability, type InteractionState, MATERIAL_VARIANTS$1 as MATERIAL_VARIANTS, type MaterialProfile$1 as MaterialProfile, type MaterialRequest, type MaterialVariant$1 as MaterialVariant, type MotionChannel, type MotionDriverKind, NOMINAL_ACCESSIBILITY_POLICY, OVERRIDABLE_ACCESSIBILITY_FLAGS, type OverridableAccessibilityFlag, type PlaneOverlap, type PlatformProbe, type ProxyOverlap, RENDERER_TIERS, type RecoveryContract, type RecoveryTrigger, type Rect$1 as Rect, type RefractionQuality, type RendererTier, type ResolvedAccessibilityPolicy, type ResolvedBackdropHint, type ResolvedForegroundAdaptation, type ResolvedGroup, type ResolvedMaterial, type ResolvedMaterialPolicy, type ResolvedMotionPolicy, type ResolvedNode, SAMPLED_ASYNC_DEFAULTS, SAMPLED_ASYNC_RATE_LIMITS, type SamplingBackend, type SceneResolution, type ShapeChannels, type ShapeFamily, type SourceProbe, type StateChange, type SystemAccessibilityPreferences, type TextureBackdropSource, type TintColor, type TintMixingCheck, VITREA_CONTRACTS, type VariantMixingCheck, type Vec2, type VideoProviderOptions, WEBGPU_AVAILABILITIES, type WebGPUAvailability$1 as WebGPUAvailability, type WebGPURendererModule, type ZSlot, checkTintMixing, checkVariantMixing, classifyStateChange, clipRect, compareZSlot, createDiagnosticsChannel, createFrameScheduler, createGlassScene, defaultForegroundAdaptation, glassTint, inflateRect, isHealthy, loadWebGPURenderer, loadWebGPURendererModule, rectsOverlap, resolveAccessibilityPolicy, resolveBackdropHint, resolveForegroundAdaptation, resolveGlassGroupState, resolveMaterial, unionRect };
+export { ACCESSIBILITY_BEHAVIOR_TABLE, ACCESSIBILITY_FLAGS, ACCESSIBILITY_PRECEDENCE, type AccessibilityConsequences, type AccessibilityFlag, type AccessibilityOverride, type AccessibilityOverrides, type ActiveRenderer, type AnalysisQuality, type BackdropEstimatorProvider, type BackdropHint, type BackdropHintRequest, type BackdropProvider, type BackdropRebuildRequest, type BackdropResolutionPolicy, type BackdropSourceDescriptor, type BackdropSourceRecord, type BackdropTone, type CapabilityInputs, type ConcentricParent, type ConfiguredSource, type CopyProviderOptions, type CornerProfile, type CornerRadii, type CornerReference, DEFAULT_BACKDROP_RESOLUTION, DEFAULT_CLEAR_DIMMING, DEFAULT_GROUP_SAMPLING, DEMOTION_REASONS, DEMOTION_RECOVERY, DIAGNOSTIC_CODES, type DemotionReason, type DescriptorPatch, type Diagnostic, type DiagnosticCode, type DiagnosticSeverity, type DiagnosticSink, type DiagnosticsChannel, type DiagnosticsChannelOptions, type DimmingPolicy, type DomBackdropSource, FOREGROUND_MODES, FRAME_PHASES, type ForegroundAdaptation, type ForegroundMode, type ForegroundResolutionOptions, type FrameContext, type FrameInfo, type FrameParticipant, type FramePhase, type FrameReport, type FrameScheduler, type FrameSchedulerOptions, GLASS_PLANES, GOVERNOR_PRESSURES, type GlassGroupDescriptor, type GlassGroupRecord, type GlassGroupState, type GlassNodeDescriptor, type GlassNodeRecord, type GlassPlane, type GlassRenderer, type GlassScene, GlassSceneError, type GlassSceneErrorCode, type GlassSceneOptions, type GlassTint, type GovernorPressure, type GroupHealth, type GroupSamplingGeometry, type GroupStateChange, HINT_AVAILABILITIES, type HintAvailability, type InteractionState, MATERIAL_VARIANTS$1 as MATERIAL_VARIANTS, type MaterialProfile$1 as MaterialProfile, type MaterialRequest, type MaterialVariant$1 as MaterialVariant, type MotionChannel, type MotionDriverKind, NOMINAL_ACCESSIBILITY_POLICY, OVERRIDABLE_ACCESSIBILITY_FLAGS, type OverridableAccessibilityFlag, type PlaneOverlap, type PlatformProbe, type ProxyOverlap, RENDERER_TIERS, type RecoveryContract, type RecoveryTrigger, type Rect$1 as Rect, type RefractionQuality, type RendererTier, type ResolvedAccessibilityPolicy, type ResolvedBackdropHint, type ResolvedForegroundAdaptation, type ResolvedGroup, type ResolvedMaterial, type ResolvedMaterialPolicy, type ResolvedMotionPolicy, type ResolvedNode, SAMPLED_ASYNC_DEFAULTS, SAMPLED_ASYNC_RATE_LIMITS, type SamplingBackend, type SceneResolution, type ShapeChannels, type ShapeFamily, type SourceProbe, type StateChange, type SurfaceBackdropToneAbscissa$1 as SurfaceBackdropToneAbscissa, type SystemAccessibilityPreferences, type TextureBackdropSource, type TintColor, type TintMixingCheck, VITREA_CONTRACTS, type VariantMixingCheck, type Vec2, type VideoProviderOptions, WEBGPU_AVAILABILITIES, type WebGPUAvailability$1 as WebGPUAvailability, type WebGPURendererModule, type ZSlot, checkTintMixing, checkVariantMixing, classifyStateChange, clipRect, compareZSlot, createDiagnosticsChannel, createFrameScheduler, createGlassScene, defaultForegroundAdaptation, glassTint, inflateRect, isHealthy, loadWebGPURenderer, loadWebGPURendererModule, rectsOverlap, resolveAccessibilityPolicy, resolveBackdropHint, resolveForegroundAdaptation, resolveGlassGroupState, resolveMaterial, unionRect };

package/dist/index.js

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