@aura3d/engine 3.0.0 → 4.0.0

package/dist/rendering/quality/RenderScaleController.js

@@ -0,0 +1,57 @@
+/**
+ * PRD 11 Phase 4 — `RenderScaleController`, the default `RenderScaleSource`
+ * (§6.5). One scale in 0.1 steps: down after 30 consecutive frames over
+ * `targetFrameMs · 1.1`, up after 120 consecutive frames under
+ * `targetFrameMs · 0.8`. GPU ms wins when present.
+ */
+export function createRenderScaleController(options) {
+    const target = options.targetFrameMs;
+    const minScale = options.minScale;
+    const maxScale = options.maxScale ?? 1;
+    const step = options.step ?? 0.1;
+    const downAfter = options.downAfter ?? 30;
+    const upAfter = options.upAfter ?? 120;
+    let scale = Math.min(maxScale, Math.max(minScale, options.initialScale ?? 1));
+    let over = 0;
+    let under = 0;
+    return {
+        get scale() { return scale; },
+        get minScale() { return minScale; },
+        get maxScale() { return maxScale; },
+        get overFrames() { return over; },
+        get underFrames() { return under; },
+        sample(frameMs, gpuMs) {
+            const ms = gpuMs ?? frameMs;
+            if (ms > target * 1.1) {
+                over += 1;
+                under = 0;
+            }
+            else if (ms < target * 0.8) {
+                under += 1;
+                over = 0;
+            }
+            else {
+                over = 0;
+                under = 0;
+            }
+            if (over >= downAfter && scale > minScale + 1e-9) {
+                scale = Math.max(minScale, Number((scale - step).toFixed(4)));
+                over = 0;
+            }
+            else if (under >= upAfter && scale < maxScale - 1e-9) {
+                scale = Math.min(maxScale, Number((scale + step).toFixed(4)));
+                under = 0;
+            }
+            return scale;
+        }
+    };
+}
+/**
+ * §6.5 effective floor: `max(tier.minRenderScale, allowSubCssResolution ? 0
+ * : 1 / devicePixelRatio_effective)`.
+ */
+export function effectiveRenderScaleFloor(tierMinRenderScale, devicePixelRatio, allowSubCssResolution) {
+    const cssFloor = allowSubCssResolution || devicePixelRatio <= 0 ? 0 : 1 / devicePixelRatio;
+    return Math.max(tierMinRenderScale, cssFloor);
+}
+//# sourceMappingURL=RenderScaleController.js.map

package/dist/rendering/quality/RenderScaleController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderScaleController.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/quality/RenderScaleController.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0BH,MAAM,UAAU,2BAA2B,CAAC,OAAqC;IAC/E,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC;IACjC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC;IACvC,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO;QACL,IAAI,KAAK,KAAK,OAAO,KAAK,CAAC,CAAC,CAAC;QAC7B,IAAI,QAAQ,KAAK,OAAO,QAAQ,CAAC,CAAC,CAAC;QACnC,IAAI,QAAQ,KAAK,OAAO,QAAQ,CAAC,CAAC,CAAC;QACnC,IAAI,UAAU,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC;QACjC,IAAI,WAAW,KAAK,OAAO,KAAK,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,OAAe,EAAE,KAAqB;YAC3C,MAAM,EAAE,GAAG,KAAK,IAAI,OAAO,CAAC;YAC5B,IAAI,EAAE,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;gBACtB,IAAI,IAAI,CAAC,CAAC;gBACV,KAAK,GAAG,CAAC,CAAC;YACZ,CAAC;iBAAM,IAAI,EAAE,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;gBAC7B,KAAK,IAAI,CAAC,CAAC;gBACX,IAAI,GAAG,CAAC,CAAC;YACX,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,CAAC,CAAC;gBACT,KAAK,GAAG,CAAC,CAAC;YACZ,CAAC;YACD,IAAI,IAAI,IAAI,SAAS,IAAI,KAAK,GAAG,QAAQ,GAAG,IAAI,EAAE,CAAC;gBACjD,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9D,IAAI,GAAG,CAAC,CAAC;YACX,CAAC;iBAAM,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,GAAG,QAAQ,GAAG,IAAI,EAAE,CAAC;gBACvD,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9D,KAAK,GAAG,CAAC,CAAC;YACZ,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,kBAA0B,EAC1B,gBAAwB,EACxB,qBAA8B;IAE9B,MAAM,QAAQ,GAAG,qBAAqB,IAAI,gBAAgB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC;IAC3F,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC"}

package/dist/rendering/quality/RetentionPolicy.d.ts

@@ -0,0 +1,11 @@
+/**
+ * PRD 11 Phase 5 — §6.9 item-3 memory policy.
+ *
+ * Medium and below release decoded image data after upload and re-fetch on
+ * restore (slower restore, less memory); High and Ultra retain. Texture
+ * owners pass the tier's decision into `ResourceDescriptor.retainForRestore`
+ * when registering with the C-29 `ResourceRegistry` (fact F-11-03).
+ */
+import type { AuraQualityTier } from "../contracts/quality.js";
+export declare function retainDecodedSourcesForRestore(tier: AuraQualityTier): boolean;
+//# sourceMappingURL=RetentionPolicy.d.ts.map

package/dist/rendering/quality/RetentionPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetentionPolicy.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/quality/RetentionPolicy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAE7E"}

package/dist/rendering/quality/RetentionPolicy.js

@@ -0,0 +1,12 @@
+/**
+ * PRD 11 Phase 5 — §6.9 item-3 memory policy.
+ *
+ * Medium and below release decoded image data after upload and re-fetch on
+ * restore (slower restore, less memory); High and Ultra retain. Texture
+ * owners pass the tier's decision into `ResourceDescriptor.retainForRestore`
+ * when registering with the C-29 `ResourceRegistry` (fact F-11-03).
+ */
+export function retainDecodedSourcesForRestore(tier) {
+    return tier === "high" || tier === "ultra";
+}
+//# sourceMappingURL=RetentionPolicy.js.map

package/dist/rendering/quality/RetentionPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetentionPolicy.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/quality/RetentionPolicy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,UAAU,8BAA8B,CAAC,IAAqB;IAClE,OAAO,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,OAAO,CAAC;AAC7C,CAAC"}

package/dist/rendering/quality/TierResolver.d.ts

@@ -0,0 +1,52 @@
+/**
+ * PRD 11 Phase 4 — `TierResolver` (§6.4).
+ *
+ * `detect(probe)` runs steps 1-3 once (hard floors → class table → signal
+ * adjustment) and returns `{ tier, confidence, reasons, maxPixelRatio }`.
+ * Step 4 (30 calibration frames) is `calibrateTierDecision`; step 5
+ * persistence is `readCachedTierDecision` / `writeCachedTierDecision`, keyed
+ * per §6.4 on `(unmaskedRenderer || "masked", engineVersion, screen, dpr)`.
+ */
+import type { DeviceProbe } from "../contracts/device.js";
+import type { AuraTierDecision, AuraQualityTier } from "../contracts/quality.js";
+export type TierConfidence = "high" | "low";
+export interface TierClassification {
+    readonly tier: AuraQualityTier;
+    readonly confidence: TierConfidence;
+    readonly reasons: readonly string[];
+    /** Effective DPR cap after the §6.4 step-3 4 MP backing-area clamp. */
+    readonly maxPixelRatio: number;
+    readonly matchedClass: string | null;
+}
+export declare class TierResolver {
+    /**
+     * §6.4 detection on a C-28 `DeviceProbe`. Pure — no DOM, no timing.
+     */
+    detect(probe: DeviceProbe): TierClassification;
+}
+export interface CalibrationInput {
+    /** p50 rAF interval over the first ~30 frames. */
+    readonly p50IntervalMs: number;
+    /** p50 GPU ms when a timer query exists, else null. */
+    readonly p50GpuMs: number | null;
+}
+export interface CalibrationResult {
+    readonly tier: AuraQualityTier;
+    readonly calibrated: boolean;
+    readonly reason: string;
+}
+/**
+ * Calibration over the first rendered frames (§6.4 step 4). Lowering uses
+ * either signal; raising requires GPU samples (rAF is vsync-capped) and only
+ * applies when confidence was low.
+ */
+export declare function calibrateTierDecision(classification: TierClassification, input: CalibrationInput, targetFrameMs: number): CalibrationResult;
+export declare const QUALITY_CACHE_KEY = "aura3d.quality.v1";
+export interface TierDecisionCacheStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+export declare function qualityDecisionCacheKey(probe: DeviceProbe, engineVersion: string): string;
+export declare function readCachedTierDecision(storage: TierDecisionCacheStorage | null, key: string): AuraTierDecision | null;
+export declare function writeCachedTierDecision(storage: TierDecisionCacheStorage | null, key: string, decision: AuraTierDecision): void;
+//# sourceMappingURL=TierResolver.d.ts.map

package/dist/rendering/quality/TierResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TierResolver.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/quality/TierResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAU9E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAaD,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,kBAAkB;CAkE/C;AASD,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,kBAAkB,EAClC,KAAK,EAAE,gBAAgB,EACvB,aAAa,EAAE,MAAM,GACpB,iBAAiB,CAenB;AAKD,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAIzF;AASD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,wBAAwB,GAAG,IAAI,EACxC,GAAG,EAAE,MAAM,GACV,gBAAgB,GAAG,IAAI,CAazB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAAG,IAAI,EACxC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CAUN"}

package/dist/rendering/quality/TierResolver.js

@@ -0,0 +1,155 @@
+/**
+ * PRD 11 Phase 4 — `TierResolver` (§6.4).
+ *
+ * `detect(probe)` runs steps 1-3 once (hard floors → class table → signal
+ * adjustment) and returns `{ tier, confidence, reasons, maxPixelRatio }`.
+ * Step 4 (30 calibration frames) is `calibrateTierDecision`; step 5
+ * persistence is `readCachedTierDecision` / `writeCachedTierDecision`, keyed
+ * per §6.4 on `(unmaskedRenderer || "masked", engineVersion, screen, dpr)`.
+ */
+import { QUALITY_TIERS, nextLowerTier } from "../contracts/quality.js";
+import { DEVICE_CLASS_TABLE_VERSION, MASKED_APPLE_RENDERER, SOFTWARE_RENDERER_PATTERN, classifyRendererString } from "./DeviceClasses.js";
+import { nextHigherTier } from "./QualityTier.js";
+const MP_LIMIT = 4_000_000;
+/** Largest DPR ≤ tier.maxPixelRatio keeping width·height·dpr² ≤ 4 MP (≥ 1). */
+function dprForArea(width, height, tier) {
+    const cap = QUALITY_TIERS[tier].maxPixelRatio;
+    const area = width * height;
+    if (area <= 0)
+        return cap;
+    const dpr = Math.min(cap, Math.sqrt(MP_LIMIT / area));
+    return Math.max(1, dpr);
+}
+export class TierResolver {
+    /**
+     * §6.4 detection on a C-28 `DeviceProbe`. Pure — no DOM, no timing.
+     */
+    detect(probe) {
+        const reasons = [];
+        const renderer = probe.unmaskedRenderer ?? probe.rendererString ?? "";
+        const mobile = probe.mobile === true;
+        // Step 1 — hard floors.
+        if (!probe.floatColorBuffer && !probe.halfFloatColorBuffer) {
+            reasons.push("no-float-color-buffer");
+            return { tier: "low", confidence: "high", reasons, maxPixelRatio: 1, matchedClass: "hard-floor" };
+        }
+        if (probe.maxTextureSize < 4096) {
+            reasons.push(`maxTextureSize:${probe.maxTextureSize}`);
+            return { tier: "low", confidence: "high", reasons, maxPixelRatio: 1, matchedClass: "hard-floor" };
+        }
+        if (SOFTWARE_RENDERER_PATTERN.test(renderer)) {
+            reasons.push(`software-renderer:${renderer}`);
+            return { tier: "low", confidence: "high", reasons, maxPixelRatio: 1, matchedClass: "software" };
+        }
+        // Step 2 — class table. Masked strings resolve to Medium / confidence low.
+        let tier = "medium";
+        let confidence = "low";
+        let matchedClass = null;
+        if (renderer === MASKED_APPLE_RENDERER) {
+            reasons.push("masked-renderer:apple-gpu");
+            matchedClass = "masked-apple";
+        }
+        else {
+            const classified = classifyRendererString(renderer);
+            if (classified.matched !== null) {
+                tier = classified.tier;
+                confidence = "high";
+                matchedClass = classified.matched;
+                reasons.push(`class:${classified.matched}`);
+            }
+            else {
+                reasons.push("unclassified-renderer");
+            }
+        }
+        // Step 3 — signal adjustment (mobile only): weak CPU/RAM lowers one tier.
+        if (mobile) {
+            const cores = probe.hardwareConcurrency;
+            const memory = probe.deviceMemoryGB;
+            if ((cores !== null && cores <= 4) || (memory !== null && memory <= 4)) {
+                const lowered = nextLowerTier(tier);
+                if (lowered) {
+                    reasons.push(`signal:${cores !== null && cores <= 4 ? "cores" : "memory"}`);
+                    tier = lowered;
+                }
+            }
+        }
+        // Backing-area clamp: > 4 MP at the tier cap on Low/Medium lowers DPR,
+        // not the tier (§6.4 step 3).
+        const width = probe.screen[0] || 0;
+        const height = probe.screen[1] || 0;
+        let maxPixelRatio = QUALITY_TIERS[tier].maxPixelRatio;
+        if (tierIndexOf(tier) <= tierIndexOf("medium") && width * height * maxPixelRatio * maxPixelRatio > MP_LIMIT) {
+            const clamped = dprForArea(width, height, tier);
+            if (clamped < maxPixelRatio) {
+                reasons.push(`dpr-area-clamp:${clamped.toFixed(2)}`);
+                maxPixelRatio = clamped;
+            }
+        }
+        return { tier, confidence, reasons, maxPixelRatio, matchedClass };
+    }
+}
+function tierIndexOf(tier) {
+    return tier === "low" ? 0 : tier === "medium" ? 1 : tier === "high" ? 2 : 3;
+}
+/**
+ * Calibration over the first rendered frames (§6.4 step 4). Lowering uses
+ * either signal; raising requires GPU samples (rAF is vsync-capped) and only
+ * applies when confidence was low.
+ */
+export function calibrateTierDecision(classification, input, targetFrameMs) {
+    const p50 = input.p50GpuMs ?? input.p50IntervalMs;
+    if (p50 > targetFrameMs * 1.25) {
+        const lowered = nextLowerTier(classification.tier);
+        if (lowered) {
+            return { tier: lowered, calibrated: true, reason: `calibration-down:p50>${(targetFrameMs * 1.25).toFixed(1)}` };
+        }
+    }
+    if (input.p50GpuMs !== null && input.p50GpuMs < targetFrameMs * 0.5 && classification.confidence === "low") {
+        const raised = nextHigherTier(classification.tier);
+        if (raised) {
+            return { tier: raised, calibrated: true, reason: `calibration-up:p50<${(targetFrameMs * 0.5).toFixed(1)}` };
+        }
+    }
+    return { tier: classification.tier, calibrated: false, reason: "calibration-none" };
+}
+// ---------------------------------------------------------------------------
+// §6.4 step 5 — persistence.
+export const QUALITY_CACHE_KEY = "aura3d.quality.v1";
+export function qualityDecisionCacheKey(probe, engineVersion) {
+    const renderer = probe.unmaskedRenderer ?? "masked";
+    const [w, h] = probe.screen;
+    return `${renderer}|${engineVersion}|${w}x${h}x${probe.devicePixelRatio}`;
+}
+export function readCachedTierDecision(storage, key) {
+    if (!storage)
+        return null;
+    try {
+        const raw = storage.getItem(QUALITY_CACHE_KEY);
+        if (!raw)
+            return null;
+        const parsed = JSON.parse(raw);
+        const hit = parsed[key];
+        if (!hit || hit.v !== 1 || hit.table !== DEVICE_CLASS_TABLE_VERSION)
+            return null;
+        if (hit.tier !== "low" && hit.tier !== "medium" && hit.tier !== "high" && hit.tier !== "ultra")
+            return null;
+        return { tier: hit.tier, source: "cache", reason: hit.reason };
+    }
+    catch {
+        return null;
+    }
+}
+export function writeCachedTierDecision(storage, key, decision) {
+    if (!storage)
+        return;
+    try {
+        const raw = storage.getItem(QUALITY_CACHE_KEY);
+        const parsed = raw ? JSON.parse(raw) : {};
+        parsed[key] = { v: 1, table: DEVICE_CLASS_TABLE_VERSION, tier: decision.tier, reason: decision.reason };
+        storage.setItem(QUALITY_CACHE_KEY, JSON.stringify(parsed));
+    }
+    catch {
+        // Quota / serialisation failures are non-fatal: the next boot re-detects.
+    }
+}
+//# sourceMappingURL=TierResolver.js.map

package/dist/rendering/quality/TierResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TierResolver.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/quality/TierResolver.ts"],"names":[],"mappings":"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"}

package/dist/rendering/quality/liveTier.d.ts

@@ -0,0 +1,23 @@
+/**
+ * PRD 11 pixel wiring (A3D_QR_TIERS): the per-app live C-27 tier the renderer
+ * consumes each frame — forward programs, frame contributors, the shadow
+ * bridge and the pixel-ratio cap. The engine `quality` extension binds its
+ * controller to the app's resolved QrFlags object (the same object
+ * `Renderer.create({ qrFlags })` binds to the device), so two apps on one page
+ * never read each other's tier. Dependency-free so the renderer's static
+ * import graph does not pull in the controller.
+ *
+ * Returns `undefined` with `A3D_QR_TIERS` off or no controller bound, so every
+ * `?? QUALITY_TIERS.high` fallback keeps flag-off rendering byte-identical.
+ */
+import type { AuraQualityTier, AuraQualityTierSettings } from "../contracts/quality.js";
+export interface LiveQualityTierSource {
+    readonly tier: AuraQualityTier;
+    readonly settings: AuraQualityTierSettings;
+}
+/** Binds `source` to `flags`; the returned disposer unbinds it (if still bound). */
+export declare function bindLiveQualityTier(flags: object, source: LiveQualityTierSource): () => void;
+export declare function prd11LiveQualityTier(flags: {
+    on(name: string): boolean;
+} | undefined | null): LiveQualityTierSource | undefined;
+//# sourceMappingURL=liveTier.d.ts.map

package/dist/rendering/quality/liveTier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveTier.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/quality/liveTier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAErF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;CAC5C;AAID,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAK5F;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE;IAAE,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG,SAAS,GAAG,IAAI,GACtD,qBAAqB,GAAG,SAAS,CAInC"}

package/dist/rendering/quality/liveTier.js

@@ -0,0 +1,16 @@
+const sourcesByFlags = new WeakMap();
+/** Binds `source` to `flags`; the returned disposer unbinds it (if still bound). */
+export function bindLiveQualityTier(flags, source) {
+    sourcesByFlags.set(flags, source);
+    return () => {
+        if (sourcesByFlags.get(flags) === source)
+            sourcesByFlags.delete(flags);
+    };
+}
+export function prd11LiveQualityTier(flags) {
+    if (!flags || !flags.on("A3D_QR_TIERS"))
+        return undefined;
+    const source = sourcesByFlags.get(flags);
+    return source ? { tier: source.tier, settings: source.settings } : undefined;
+}
+//# sourceMappingURL=liveTier.js.map

package/dist/rendering/quality/liveTier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveTier.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/quality/liveTier.ts"],"names":[],"mappings":"AAmBA,MAAM,cAAc,GAAG,IAAI,OAAO,EAAiC,CAAC;AAEpE,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,MAA6B;IAC9E,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAClC,OAAO,GAAG,EAAE;QACV,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,MAAM;YAAE,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzE,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAuD;IAEvD,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,cAAc,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/E,CAAC"}

package/dist/rendering/reference/BloomPass.d.ts

@@ -0,0 +1,10 @@
+import { type CinematicRendererEvidenceFlag } from "../cinematic/CinematicEvidence.js";
+export interface CinematicBloomPass {
+    readonly name: "bloom";
+    readonly threshold: number;
+    readonly intensity: number;
+    readonly radius: number;
+    readonly rendererOwnedEvidence: CinematicRendererEvidenceFlag;
+}
+export declare function createCinematicBloomPass(options?: Partial<Omit<CinematicBloomPass, "name" | "rendererOwnedEvidence">>): CinematicBloomPass;
+//# sourceMappingURL=BloomPass.d.ts.map

package/dist/rendering/reference/BloomPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BloomPass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/reference/BloomPass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAErH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,qBAAqB,EAAE,6BAA6B,CAAC;CAC/D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,uBAAuB,CAAC,CAAM,GAAG,kBAAkB,CAe9I"}

package/dist/rendering/reference/BloomPass.js

@@ -0,0 +1,18 @@
+import { createRendererOwnedEvidenceFlag } from "../cinematic/CinematicEvidence.js";
+export function createCinematicBloomPass(options = {}) {
+    return {
+        name: "bloom",
+        threshold: options.threshold ?? 0.72,
+        intensity: options.intensity ?? 0.28,
+        radius: options.radius ?? 1.35,
+        rendererOwnedEvidence: createRendererOwnedEvidenceFlag({
+            id: "postprocess:bloom",
+            feature: "postprocess",
+            label: "Bloom/glow pass",
+            source: "renderer-postprocess",
+            sceneContent: false,
+            diagnostics: ["Bloom is a renderer postprocess pass over emissive scene content."]
+        })
+    };
+}
+//# sourceMappingURL=BloomPass.js.map

package/dist/rendering/reference/BloomPass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BloomPass.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/reference/BloomPass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAsC,MAAM,gCAAgC,CAAC;AAUrH,MAAM,UAAU,wBAAwB,CAAC,UAA+E,EAAE;IACxH,OAAO;QACL,IAAI,EAAE,OAAO;QACb,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,qBAAqB,EAAE,+BAA+B,CAAC;YACrD,EAAE,EAAE,mBAAmB;YACvB,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,iBAAiB;YACxB,MAAM,EAAE,sBAAsB;YAC9B,YAAY,EAAE,KAAK;YACnB,WAAW,EAAE,CAAC,mEAAmE,CAAC;SACnF,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/rendering/reference/DepthHazePass.d.ts

@@ -0,0 +1,12 @@
+import { type CinematicRendererEvidenceFlag } from "../cinematic/CinematicEvidence.js";
+export interface CinematicDepthHazePass {
+    readonly name: "depth-haze";
+    readonly color: readonly [number, number, number];
+    readonly density: number;
+    readonly startMeters: number;
+    readonly endMeters: number;
+    readonly requiresDepth: boolean;
+    readonly rendererOwnedEvidence: CinematicRendererEvidenceFlag;
+}
+export declare function createCinematicDepthHazePass(options?: Partial<Omit<CinematicDepthHazePass, "name" | "rendererOwnedEvidence">>): CinematicDepthHazePass;
+//# sourceMappingURL=DepthHazePass.d.ts.map

package/dist/rendering/reference/DepthHazePass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DepthHazePass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/reference/DepthHazePass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAErH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,qBAAqB,EAAE,6BAA6B,CAAC;CAC/D;AAED,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,uBAAuB,CAAC,CAAM,GAAG,sBAAsB,CAiB1J"}

package/dist/rendering/reference/DepthHazePass.js

@@ -0,0 +1,20 @@
+import { createRendererOwnedEvidenceFlag } from "../cinematic/CinematicEvidence.js";
+export function createCinematicDepthHazePass(options = {}) {
+    return {
+        name: "depth-haze",
+        color: options.color ?? [0.22, 0.34, 0.52],
+        density: options.density ?? 0.22,
+        startMeters: options.startMeters ?? 2.5,
+        endMeters: options.endMeters ?? 18,
+        requiresDepth: options.requiresDepth ?? true,
+        rendererOwnedEvidence: createRendererOwnedEvidenceFlag({
+            id: "postprocess:depth-haze",
+            feature: "postprocess",
+            label: "Depth haze pass",
+            source: "renderer-postprocess",
+            sceneContent: false,
+            diagnostics: ["Depth haze is renderer-owned atmospheric composition; DOM fog panels do not satisfy this evidence."]
+        })
+    };
+}
+//# sourceMappingURL=DepthHazePass.js.map

package/dist/rendering/reference/DepthHazePass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DepthHazePass.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/reference/DepthHazePass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAsC,MAAM,gCAAgC,CAAC;AAYrH,MAAM,UAAU,4BAA4B,CAAC,UAAmF,EAAE;IAChI,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAC1C,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,GAAG;QACvC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;QAClC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;QAC5C,qBAAqB,EAAE,+BAA+B,CAAC;YACrD,EAAE,EAAE,wBAAwB;YAC5B,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,iBAAiB;YACxB,MAAM,EAAE,sBAAsB;YAC9B,YAAY,EAAE,KAAK;YACnB,WAAW,EAAE,CAAC,oGAAoG,CAAC;SACpH,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/rendering/reference/EffectComposer.d.ts

@@ -0,0 +1,110 @@
+import { type BloomOptions, type ChromaticAberrationOptions, type ColorGradeOptions, type DepthOfFieldOptions, type FXAAOptions, type FilmGrainOptions, type MotionBlurOptions, type OutlineOptions, type SSAOOptions, type SSROptions, type TAAOptions, type ToneMappingOptions, type ToneMappingPresetName } from "./PostProcessPass.js";
+import { type RenderDevice, type RenderTarget } from "../RenderDevice.js";
+import { type TextureFormat } from "../Texture.js";
+export type PostProcessComposerPass = {
+    readonly name: "bloom";
+    readonly options?: BloomOptions;
+} | {
+    readonly name: "tone-mapping";
+    readonly options?: ToneMappingOptions;
+} | {
+    readonly name: "tone-mapping-preset";
+    readonly preset: ToneMappingPresetName;
+    readonly options?: {
+        readonly previousExposure?: number;
+        readonly deltaTimeSeconds?: number;
+    } & ToneMappingOptions;
+} | {
+    readonly name: "color-grade";
+    readonly options?: ColorGradeOptions;
+} | {
+    readonly name: "chromatic-aberration";
+    readonly options?: ChromaticAberrationOptions;
+} | {
+    readonly name: "film-grain";
+    readonly options?: FilmGrainOptions;
+} | {
+    readonly name: "depth-of-field";
+    readonly options: DepthOfFieldOptions;
+} | {
+    readonly name: "motion-blur";
+    readonly options: MotionBlurOptions;
+} | {
+    readonly name: "ssao";
+    readonly options: SSAOOptions;
+} | {
+    readonly name: "ssr";
+    readonly options: SSROptions;
+} | {
+    readonly name: "taa";
+    readonly options: TAAOptions;
+} | {
+    readonly name: "outline";
+    readonly options?: OutlineOptions;
+} | {
+    readonly name: "fxaa";
+    readonly options?: FXAAOptions;
+};
+export interface PostProcessComposerOptions {
+    readonly device: RenderDevice;
+    readonly width: number;
+    readonly height: number;
+    readonly format?: Extract<TextureFormat, "rgba8">;
+    readonly label?: string;
+}
+export interface PostProcessComposerRenderOptions {
+    readonly source: RenderTarget;
+    readonly target?: RenderTarget;
+    readonly passes?: readonly PostProcessComposerPass[];
+}
+export interface PostProcessComposerDiagnostics {
+    readonly width: number;
+    readonly height: number;
+    readonly passCount: number;
+    readonly pingPongTargets: number;
+    readonly textureCount: number;
+    readonly lastPasses: readonly string[];
+    readonly presentedToBackbuffer: boolean;
+    readonly outputTargetLabel: string | null;
+}
+export interface PostProcessUnsupportedEffect {
+    readonly name: string;
+    readonly reason: string;
+    readonly requiredCapability?: string;
+}
+export interface PostProcessCapabilityReport {
+    readonly backend: string;
+    readonly supportedEffects: readonly string[];
+    readonly unsupportedEffects: readonly PostProcessUnsupportedEffect[];
+    readonly supportsRenderTargets: boolean;
+    readonly supportsPresentation: boolean;
+    readonly supportsPixelReadback: boolean;
+    readonly supportsFloatReadback: boolean;
+    readonly supportsHdrTargets: boolean;
+    readonly supportsRendererOwnedDepthEffects: boolean;
+}
+export declare class PostProcessComposer {
+    private readonly device;
+    private readonly label;
+    private width;
+    private height;
+    private passes;
+    private pingPongTargets;
+    private disposed;
+    private lastDiagnostics;
+    constructor(options: PostProcessComposerOptions);
+    addPass(pass: PostProcessComposerPass): this;
+    setPasses(passes: readonly PostProcessComposerPass[]): this;
+    clearPasses(): this;
+    resize(width: number, height: number): void;
+    render(options: PostProcessComposerRenderOptions): PostProcessComposerDiagnostics;
+    getDiagnostics(): PostProcessComposerDiagnostics;
+    dispose(): void;
+    private createPingPongTargets;
+    private validateSource;
+    private validateTarget;
+    private createDiagnostics;
+    private assertAlive;
+}
+export declare function createPostProcessCapabilityReport(device: RenderDevice): PostProcessCapabilityReport;
+//# sourceMappingURL=EffectComposer.d.ts.map

package/dist/rendering/reference/EffectComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffectComposer.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/reference/EffectComposer.ts"],"names":[],"mappings":"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"}