@vitreajs/vitrea 0.17.0 → 0.19.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. */
@@ -553,6 +571,42 @@ interface GlassGroupState {
      * interior. Absent on a WebGPU-tier group and before the first frame resolves one.
      */
     readonly cssShadow?: "layer" | "group" | "host";
+    /**
+     * Which measured material document this group is drawing (W29 G4).
+     *
+     * The material became a selection in 0.19.0 — a page draws macOS 27's material
+     * by default and can pin macOS 26.5 — so "which material drew" stopped being a
+     * constant of the build and became a resolved fact, and the honesty core says a
+     * resolved fact belongs on the state beside `cssBody`, `cssTint` and
+     * `cssShadow`. A capture cell, a readout and the demo's capabilities panel all
+     * read it from here rather than from whatever the page meant to pass.
+     *
+     * Resolved by the platform, like the three fields above and for the same
+     * reason: the material is a property of the root, which core's per-group
+     * resolver cannot see. Absent before the first frame resolves one.
+     */
+    readonly materialDocument?: ResolvedMaterialDocument;
+}
+/**
+ * The material a group actually drew, named so it can be checked rather than
+ * assumed.
+ *
+ * `tuned` is the field that keeps the other three honest. A root may merge an
+ * app's own `materialProfile` or `cssTierMapping` over whatever the document
+ * selected, and a readout that named the document without saying so would report
+ * a digest over a material that is not on the screen.
+ */
+interface ResolvedMaterialDocument {
+    /** The document's name — the profile-key stem the material was measured under. */
+    readonly name: string;
+    /** Which macOS release it was measured on. */
+    readonly platform: string;
+    /** The endpoint drawn for this group's resolved scheme and window pose. */
+    readonly profileKey?: string;
+    /** That endpoint's digest over the material it resolves to. */
+    readonly resolvedMaterialSha256?: string;
+    /** True where the app merged a material or CSS-tier patch of its own over it. */
+    readonly tuned: boolean;
 }
 declare function isHealthy(state: GlassGroupState): boolean;
 
@@ -3168,6 +3222,10 @@ interface MaterialProfile {
      * extreme-dark region stays with the collapse constants that were fitted
      * on it.
      */
+    /** 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;
@@ -3294,6 +3352,7 @@ interface MaterialProfilePatch {
     readonly rimCollapsed?: number;
     readonly rimCollapsedTinted?: number;
     readonly rimTintChroma?: number;
+    readonly backdropToneAbscissa?: MaterialProfile["backdropToneAbscissa"];
     readonly backdropToneAnchorX?: BackdropToneKnotRow;
     readonly backdropToneResponseThin?: BackdropToneKnotRow;
     readonly backdropToneResponseThick?: BackdropToneKnotRow;
@@ -3701,6 +3760,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
@@ -4253,6 +4314,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.
  *
@@ -4434,6 +4511,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;
 }
 
@@ -4505,4 +4584,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 ResolvedMaterialDocument, 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-T7PRMUM4.js');
+  return import('./dist-VQPRX7BX.js');
 }
 async function loadWebGPURenderer() {
   const { createWebGPURenderer } = await loadWebGPURendererModule();