@aura3d/engine 1.0.0

package/dist/rendering/RendererPostprocessPlan.js

@@ -0,0 +1,155 @@
+export function createRendererPostprocessPasses(postprocess) {
+    const passes = [];
+    if (postprocess.bloom) {
+        passes.push({ name: "bloom", options: postprocess.bloom === true ? {} : postprocess.bloom });
+    }
+    if (postprocess.toneMapping !== false) {
+        passes.push({ name: "tone-mapping", options: postprocess.toneMapping ?? {} });
+    }
+    if (postprocess.colorGrade) {
+        passes.push({ name: "color-grade", options: postprocess.colorGrade === true ? {} : postprocess.colorGrade });
+    }
+    if (postprocess.chromaticAberration) {
+        passes.push({ name: "chromatic-aberration", options: postprocess.chromaticAberration === true ? {} : postprocess.chromaticAberration });
+    }
+    if (postprocess.filmGrain) {
+        passes.push({ name: "film-grain", options: postprocess.filmGrain === true ? {} : postprocess.filmGrain });
+    }
+    if (postprocess.depthOfField) {
+        passes.push({ name: "depth-of-field", options: postprocess.depthOfField });
+    }
+    if (postprocess.motionBlur) {
+        passes.push({ name: "motion-blur", options: postprocess.motionBlur });
+    }
+    if (postprocess.contactShadow) {
+        passes.push({ name: "contact-shadow", options: postprocess.contactShadow });
+    }
+    if (postprocess.ssao) {
+        passes.push({ name: "ssao", options: postprocess.ssao });
+    }
+    if (postprocess.ssr) {
+        passes.push({ name: "ssr", options: postprocess.ssr });
+    }
+    if (postprocess.taa) {
+        passes.push({ name: "taa", options: postprocess.taa });
+    }
+    if (postprocess.outline) {
+        passes.push({ name: "outline", options: postprocess.outline === true ? {} : postprocess.outline });
+    }
+    if (postprocess.fxaa) {
+        passes.push({ name: "fxaa", options: postprocess.fxaa === true ? {} : postprocess.fxaa });
+    }
+    return passes;
+}
+export function createRendererPostprocessPlanDiagnostics(postprocess, context = {}) {
+    const passes = createRendererPostprocessPasses(postprocess);
+    const sourceTargetFormat = context.sourceTargetFormat ?? context.targetFormat ?? "rgba8";
+    const targetFormat = context.targetFormat ?? sourceTargetFormat;
+    const canFuseLdr = canFuseLdrPostprocessPlan(sourceTargetFormat, passes);
+    const executionMode = passes.length === 0
+        ? "none"
+        : canFuseLdr
+            ? context.nativeLdrPostprocess
+                ? "renderer-owned-fused-ldr-native"
+                : "renderer-owned-fused-ldr-readback"
+            : "renderer-owned-pass-chain-readback";
+    const missingInputs = missingPostprocessInputs(passes, context);
+    const clarityWarnings = postprocessClarityWarnings(postprocess, passes, executionMode);
+    const passDiagnostics = passes.map((pass) => {
+        const requiresDepth = isDepthPostprocessPassName(pass.name);
+        const hasDepthInput = requiresDepth && postprocessPassHasDepth(pass.options);
+        const usesRendererOwnedDepth = requiresDepth && !hasDepthInput && context.rendererDepthAvailable === true;
+        const requiresVelocity = pass.name === "motion-blur";
+        const hasVelocityInput = requiresVelocity && postprocessPassHasVelocity(pass.options);
+        return {
+            name: pass.name,
+            rendererOwned: true,
+            publicPixelKernel: true,
+            requiresDepth,
+            hasDepthInput,
+            usesRendererOwnedDepth,
+            requiresVelocity,
+            hasVelocityInput,
+            usesReadback: executionMode !== "renderer-owned-fused-ldr-native"
+        };
+    });
+    return {
+        source: "Renderer.postprocessPlan",
+        passCount: passes.length,
+        passNames: passes.map((pass) => pass.name),
+        targetFormat,
+        sourceTargetFormat,
+        executionMode,
+        canFuseLdr,
+        requiresDepthTexture: passes.some((pass) => isDepthPostprocessPassName(pass.name) && !postprocessPassHasDepth(pass.options)),
+        missingInputs,
+        readbackPassNames: executionMode === "renderer-owned-fused-ldr-native" ? [] : passes.map((pass) => pass.name),
+        rendererOwnedPassNames: passes.map((pass) => pass.name),
+        clarityWarnings,
+        passes: passDiagnostics,
+        claimBoundary: "This plan describes the renderer-owned postprocess pass chain for the current frame. It does not prove EffectComposer parity, LUT/AOV layers, temporal accumulation, or missing depth/velocity inputs unless the report explicitly shows those inputs."
+    };
+}
+function canFuseLdrPostprocessPlan(sourceTargetFormat, passes) {
+    return passes.length > 1
+        && (sourceTargetFormat === "rgba8" || passes[0]?.name === "tone-mapping")
+        && passes.every((pass) => pass.name === "tone-mapping" || pass.name === "color-grade" || pass.name === "fxaa")
+        && passes.every((pass, index) => {
+            const previousRank = index === 0 ? -1 : ldrFusionPassRank(passes[index - 1].name);
+            return ldrFusionPassRank(pass.name) >= previousRank;
+        });
+}
+function ldrFusionPassRank(name) {
+    if (name === "tone-mapping")
+        return 0;
+    if (name === "color-grade")
+        return 1;
+    if (name === "fxaa")
+        return 2;
+    return Number.POSITIVE_INFINITY;
+}
+function isDepthPostprocessPassName(name) {
+    return name === "depth-of-field" || name === "contact-shadow" || name === "ssao" || name === "ssr";
+}
+function postprocessPassHasDepth(options) {
+    return typeof options === "object" && options !== null && "depth" in options && Boolean(options.depth);
+}
+function postprocessPassHasVelocity(options) {
+    return typeof options === "object" && options !== null && "velocity" in options && Boolean(options.velocity);
+}
+function missingPostprocessInputs(passes, context) {
+    const missing = [];
+    for (const pass of passes) {
+        if (isDepthPostprocessPassName(pass.name) && !postprocessPassHasDepth(pass.options) && context.rendererDepthAvailable !== true) {
+            missing.push(`${pass.name}:depth`);
+        }
+        if (pass.name === "motion-blur" && !postprocessPassHasVelocity(pass.options)) {
+            missing.push("motion-blur:velocity");
+        }
+    }
+    return missing;
+}
+function postprocessClarityWarnings(postprocess, passes, executionMode) {
+    const warnings = [];
+    const bloom = typeof postprocess.bloom === "object" && postprocess.bloom !== null ? postprocess.bloom : undefined;
+    if (bloom) {
+        const threshold = bloom.threshold ?? 0.75;
+        const intensity = bloom.intensity ?? 0.35;
+        const radius = bloom.radius ?? 1;
+        if (threshold < 0.48 || intensity > 0.62 || radius > 3) {
+            warnings.push(`bloom-noise-risk threshold=${round3(threshold)} intensity=${round3(intensity)} radius=${round3(radius)}`);
+        }
+    }
+    const filmGrain = typeof postprocess.filmGrain === "object" && postprocess.filmGrain !== null ? postprocess.filmGrain : undefined;
+    if (filmGrain && (filmGrain.intensity ?? 0.08) >= 0.06) {
+        warnings.push(`film-grain-noise-risk intensity=${round3(filmGrain.intensity ?? 0.08)}`);
+    }
+    if (executionMode === "renderer-owned-pass-chain-readback" && passes.length > 2) {
+        warnings.push("multi-pass-readback-cost");
+    }
+    return warnings;
+}
+function round3(value) {
+    return Math.round(value * 1000) / 1000;
+}
+//# sourceMappingURL=RendererPostprocessPlan.js.map

package/dist/rendering/RendererPostprocessPlan.js.map

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

package/dist/rendering/RendererTiming.d.ts

@@ -0,0 +1,53 @@
+export type RendererTimingSampleSource = "gpu" | "cpu-fallback";
+export interface RendererTimingSample {
+    readonly label: string;
+    readonly durationMs: number;
+    readonly cpuDurationMs: number;
+    readonly gpuDurationMs?: number;
+    readonly source: RendererTimingSampleSource;
+    readonly fallbackReason?: string;
+}
+export interface RendererTimingSnapshot {
+    readonly gpuTimingSupported: boolean;
+    readonly cpuFallbackActive: boolean;
+    readonly sampleCount: number;
+    readonly unavailableReason?: string;
+    readonly samples: readonly RendererTimingSample[];
+}
+export interface RendererGpuTimingToken {
+    readonly label: string;
+}
+export interface RendererGpuTimingBackend {
+    readonly supported: boolean;
+    readonly unavailableReason?: string;
+    begin(label: string): RendererGpuTimingToken;
+    end(token: RendererGpuTimingToken, cpuDurationMs: number): number | undefined;
+    collectAvailable?(): readonly RendererGpuTimingResult[];
+}
+export interface RendererGpuTimingResult {
+    readonly label: string;
+    readonly durationMs: number;
+}
+export interface RendererTimingCollectorOptions {
+    readonly gpuBackend?: RendererGpuTimingBackend;
+    readonly now?: () => number;
+    readonly fallbackReason?: string;
+}
+export declare class RendererTimingCollector {
+    private readonly samples;
+    private readonly gpuBackend;
+    private readonly now;
+    private readonly fallbackReason;
+    constructor(options?: RendererTimingCollectorOptions);
+    measure<T>(label: string, callback: () => T): T;
+    begin(label: string): {
+        end(): RendererTimingSample;
+    };
+    snapshot(): RendererTimingSnapshot;
+    private createSample;
+    private collectAvailableGpuResults;
+}
+export declare function createCpuFallbackGpuTimingBackend(unavailableReason?: string): RendererGpuTimingBackend;
+export declare function createImmediateGpuTimingBackend(durationMs: number): RendererGpuTimingBackend;
+export declare function createWebGL2GpuTimingBackend(gl: WebGL2RenderingContext): RendererGpuTimingBackend;
+//# sourceMappingURL=RendererTiming.d.ts.map

package/dist/rendering/RendererTiming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RendererTiming.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/RendererTiming.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,0BAA0B,GAAG,KAAK,GAAG,cAAc,CAAC;AAEhE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAAC;IAC7C,GAAG,CAAC,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9E,gBAAgB,CAAC,IAAI,SAAS,uBAAuB,EAAE,CAAC;CACzD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,wBAAwB,CAAC;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IACtD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,GAAE,8BAAmC;IAMxD,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;IAS/C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,GAAG,IAAI,oBAAoB,CAAA;KAAE;IAoBrD,QAAQ,IAAI,sBAAsB;IAYlC,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,0BAA0B;CAiBnC;AAED,wBAAgB,iCAAiC,CAC/C,iBAAiB,SAAuD,GACvE,wBAAwB,CAW1B;AAED,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,MAAM,GAAG,wBAAwB,CAa5F;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,sBAAsB,GAAG,wBAAwB,CAMjG"}

package/dist/rendering/RendererTiming.js

@@ -0,0 +1,186 @@
+export class RendererTimingCollector {
+    samples = [];
+    gpuBackend;
+    now;
+    fallbackReason;
+    constructor(options = {}) {
+        this.gpuBackend = options.gpuBackend ?? createCpuFallbackGpuTimingBackend(options.fallbackReason);
+        this.now = options.now ?? (() => performance.now());
+        this.fallbackReason = options.fallbackReason ?? this.gpuBackend.unavailableReason ?? "GPU timing unavailable; using CPU timing fallback.";
+    }
+    measure(label, callback) {
+        const timer = this.begin(label);
+        try {
+            return callback();
+        }
+        finally {
+            timer.end();
+        }
+    }
+    begin(label) {
+        const trimmed = requireTimingLabel(label);
+        const gpuToken = this.gpuBackend.begin(trimmed);
+        const started = this.now();
+        let ended = false;
+        return {
+            end: () => {
+                if (ended) {
+                    throw new Error(`Renderer timing sample already ended: ${trimmed}`);
+                }
+                ended = true;
+                const cpuDurationMs = Math.max(0, this.now() - started);
+                const gpuDurationMs = this.gpuBackend.end(gpuToken, cpuDurationMs);
+                const sample = this.createSample(trimmed, cpuDurationMs, gpuDurationMs);
+                this.samples.push(sample);
+                return sample;
+            }
+        };
+    }
+    snapshot() {
+        this.collectAvailableGpuResults();
+        const cpuFallbackActive = this.samples.some((sample) => sample.source === "cpu-fallback");
+        return {
+            gpuTimingSupported: this.gpuBackend.supported,
+            cpuFallbackActive,
+            sampleCount: this.samples.length,
+            ...(this.gpuBackend.supported && !cpuFallbackActive ? {} : { unavailableReason: this.fallbackReason }),
+            samples: [...this.samples]
+        };
+    }
+    createSample(label, cpuDurationMs, gpuDurationMs) {
+        if (this.gpuBackend.supported && gpuDurationMs !== undefined && Number.isFinite(gpuDurationMs)) {
+            return {
+                label,
+                durationMs: Number(gpuDurationMs.toFixed(3)),
+                cpuDurationMs: Number(cpuDurationMs.toFixed(3)),
+                gpuDurationMs: Number(gpuDurationMs.toFixed(3)),
+                source: "gpu"
+            };
+        }
+        return {
+            label,
+            durationMs: Number(cpuDurationMs.toFixed(3)),
+            cpuDurationMs: Number(cpuDurationMs.toFixed(3)),
+            source: "cpu-fallback",
+            fallbackReason: this.fallbackReason
+        };
+    }
+    collectAvailableGpuResults() {
+        const results = this.gpuBackend.collectAvailable?.() ?? [];
+        for (const result of results) {
+            const sampleIndex = this.samples.findIndex((sample) => sample.label === result.label && sample.source === "cpu-fallback");
+            if (sampleIndex < 0) {
+                continue;
+            }
+            const existing = this.samples[sampleIndex];
+            this.samples[sampleIndex] = {
+                label: existing.label,
+                durationMs: Number(result.durationMs.toFixed(3)),
+                cpuDurationMs: existing.cpuDurationMs,
+                gpuDurationMs: Number(result.durationMs.toFixed(3)),
+                source: "gpu"
+            };
+        }
+    }
+}
+export function createCpuFallbackGpuTimingBackend(unavailableReason = "GPU timing unavailable; using CPU timing fallback.") {
+    return {
+        supported: false,
+        unavailableReason,
+        begin(label) {
+            return { label: requireTimingLabel(label) };
+        },
+        end(_token, _cpuDurationMs) {
+            return undefined;
+        }
+    };
+}
+export function createImmediateGpuTimingBackend(durationMs) {
+    if (!Number.isFinite(durationMs) || durationMs < 0) {
+        throw new RangeError("Immediate GPU timing duration must be a finite non-negative number.");
+    }
+    return {
+        supported: true,
+        begin(label) {
+            return { label: requireTimingLabel(label) };
+        },
+        end(_token, _cpuDurationMs) {
+            return durationMs;
+        }
+    };
+}
+export function createWebGL2GpuTimingBackend(gl) {
+    const extension = gl.getExtension("EXT_disjoint_timer_query_webgl2");
+    if (!extension) {
+        return createCpuFallbackGpuTimingBackend("EXT_disjoint_timer_query_webgl2 unavailable; using CPU timing fallback.");
+    }
+    return new WebGL2GpuTimingBackend(gl, extension);
+}
+class WebGL2GpuTimingBackend {
+    gl;
+    extension;
+    supported = true;
+    unavailableReason = "GPU timer query result pending or disjoint; using CPU timing fallback for this sample.";
+    pending = [];
+    constructor(gl, extension) {
+        this.gl = gl;
+        this.extension = extension;
+    }
+    begin(label) {
+        const query = this.gl.createQuery();
+        if (query) {
+            this.gl.beginQuery(this.extension.TIME_ELAPSED_EXT, query);
+        }
+        return { label: requireTimingLabel(label), query };
+    }
+    end(token, _cpuDurationMs) {
+        const query = token.query;
+        if (!query) {
+            return undefined;
+        }
+        this.gl.endQuery(this.extension.TIME_ELAPSED_EXT);
+        this.pending.push(token);
+        return undefined;
+    }
+    collectAvailable() {
+        const results = [];
+        for (let index = this.pending.length - 1; index >= 0; index -= 1) {
+            const token = this.pending[index];
+            const result = this.readQueryIfAvailable(token);
+            if (!result.done) {
+                continue;
+            }
+            this.pending.splice(index, 1);
+            if (result.durationMs !== undefined) {
+                results.push({ label: token.label, durationMs: result.durationMs });
+            }
+        }
+        return results.reverse();
+    }
+    readQueryIfAvailable(token) {
+        const query = token.query;
+        if (!query) {
+            return { done: true };
+        }
+        const available = this.gl.getQueryParameter(query, this.gl.QUERY_RESULT_AVAILABLE);
+        const disjoint = Boolean(this.gl.getParameter(this.extension.GPU_DISJOINT_EXT));
+        if (!available) {
+            return { done: false };
+        }
+        if (disjoint) {
+            this.gl.deleteQuery(query);
+            return { done: true };
+        }
+        const elapsedNanoseconds = this.gl.getQueryParameter(query, this.gl.QUERY_RESULT);
+        this.gl.deleteQuery(query);
+        return { done: true, durationMs: elapsedNanoseconds / 1_000_000 };
+    }
+}
+function requireTimingLabel(label) {
+    const trimmed = label.trim();
+    if (!trimmed) {
+        throw new Error("Renderer timing sample label is required");
+    }
+    return trimmed;
+}
+//# sourceMappingURL=RendererTiming.js.map

package/dist/rendering/RendererTiming.js.map

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

package/dist/rendering/RendererVisualPipelineReport.d.ts

@@ -0,0 +1,224 @@
+import { type A3DColorManagementPolicy, type A3DColorSpace, type A3DTextureSemantic } from "./ColorManagement";
+import { type BloomOptions, type ChromaticAberrationOptions, type ColorGradeOptions, type ContactShadowPostProcessOptions, type DepthOfFieldOptions, type FXAAOptions, type FilmGrainOptions, type MotionBlurOptions, type OutlineOptions, type PostProcessColorSpace, type SSAOOptions, type SSROptions, type TAAOptions, type ToneMappingCalibration, type ToneMappingOperator, type ToneMappingOptions, type ToneMappingPresetName } from "./PostProcessPass";
+import { type RendererPostprocessExecutionMode, type RendererPostprocessPlanDiagnostics } from "./RendererPostprocessPlan";
+import type { RenderDevice, RenderDeviceCapability, RenderDeviceDiagnostics, RenderTargetDescriptor } from "./RenderDevice";
+export type RendererVisualPipelineStatus = "supported" | "partial" | "unsupported";
+export type RendererVisualTargetFormat = Extract<RenderTargetDescriptor["format"], "rgba8" | "rgba16f" | "rgba32f">;
+export type RendererVisualPostprocessPassName = "tone-mapping" | "color-grade" | "bloom" | "chromatic-aberration" | "film-grain" | "depth-of-field" | "motion-blur" | "contact-shadow" | "ssao" | "ssr" | "taa" | "outline" | "fxaa";
+export type RendererUnsupportedVisualCapability = "display-p3-output" | "rec2020-output" | "hdr-display-swapchain" | "automatic-png-color-profile";
+export interface RendererVisualPostprocessDescriptor {
+    readonly targetFormat?: RendererVisualTargetFormat;
+    readonly toneMapping?: ToneMappingOptions | false;
+    readonly colorGrade?: ColorGradeOptions | boolean;
+    readonly bloom?: BloomOptions | boolean;
+    readonly chromaticAberration?: ChromaticAberrationOptions | boolean;
+    readonly filmGrain?: FilmGrainOptions | boolean;
+    readonly depthOfField?: DepthOfFieldOptions | false;
+    readonly motionBlur?: MotionBlurOptions | false;
+    readonly contactShadow?: ContactShadowPostProcessOptions | false;
+    readonly ssao?: SSAOOptions | false;
+    readonly ssr?: SSROptions | false;
+    readonly taa?: TAAOptions | false;
+    readonly outline?: OutlineOptions | boolean;
+    readonly fxaa?: FXAAOptions | boolean;
+}
+export interface RendererCanvasBackingInput {
+    readonly cssWidth: number;
+    readonly cssHeight: number;
+    readonly devicePixelRatio: number;
+    readonly actualWidth?: number;
+    readonly actualHeight?: number;
+}
+export interface RendererCanvasBackingReport {
+    readonly status: RendererVisualPipelineStatus;
+    readonly cssWidth: number;
+    readonly cssHeight: number;
+    readonly devicePixelRatio: number;
+    readonly expectedWidth: number;
+    readonly expectedHeight: number;
+    readonly actualWidth?: number;
+    readonly actualHeight?: number;
+    readonly effectiveDevicePixelRatio?: number;
+    readonly backingStoreMatchesDisplay: boolean;
+    readonly warnings: readonly string[];
+}
+export interface RendererScreenshotConsistencyInput {
+    readonly width: number;
+    readonly height: number;
+    readonly byteLength: number;
+    readonly expectedWidth: number;
+    readonly expectedHeight: number;
+    readonly expectedByteLength?: number;
+    readonly colorSpace?: A3DColorSpace;
+}
+export interface RendererScreenshotConsistencyReport {
+    readonly status: RendererVisualPipelineStatus;
+    readonly width: number;
+    readonly height: number;
+    readonly byteLength: number;
+    readonly expectedWidth: number;
+    readonly expectedHeight: number;
+    readonly expectedByteLength: number;
+    readonly colorSpace: A3DColorSpace;
+    readonly pixelFormat: "rgba8";
+    readonly readbackMatchesBackingStore: boolean;
+    readonly colorProfileEmbedded: false;
+    readonly warnings: readonly string[];
+}
+export interface RendererCaptureQualityInput {
+    readonly cssWidth: number;
+    readonly cssHeight: number;
+    readonly backingWidth: number;
+    readonly backingHeight: number;
+    readonly screenshotWidth: number;
+    readonly screenshotHeight: number;
+    readonly captureCssWidth?: number;
+    readonly captureCssHeight?: number;
+    readonly devicePixelRatio?: number;
+    readonly minimumEffectiveDpr?: number;
+    readonly label?: string;
+}
+export interface RendererCaptureQualityReport {
+    readonly status: RendererVisualPipelineStatus;
+    readonly label?: string;
+    readonly cssWidth: number;
+    readonly cssHeight: number;
+    readonly backingWidth: number;
+    readonly backingHeight: number;
+    readonly screenshotWidth: number;
+    readonly screenshotHeight: number;
+    readonly captureCssWidth: number;
+    readonly captureCssHeight: number;
+    readonly devicePixelRatio?: number;
+    readonly minimumEffectiveDpr: number;
+    readonly effectiveBackingDprX: number;
+    readonly effectiveBackingDprY: number;
+    readonly effectiveCaptureDprX: number;
+    readonly effectiveCaptureDprY: number;
+    readonly captureToBackingScaleX: number;
+    readonly captureToBackingScaleY: number;
+    readonly capturesFullCanvas: boolean;
+    readonly fullCanvasPixelMatch: boolean;
+    readonly captureDownsamplesCanvas: boolean;
+    readonly captureUpscalesCanvas: boolean;
+    readonly meetsMinimumEffectiveDpr: boolean;
+    readonly warnings: readonly string[];
+}
+export interface RendererFrameCadenceInput {
+    readonly targetFrameMs?: number;
+    readonly renderMs?: number;
+    readonly loopMs?: number;
+    readonly frameIntervalMs?: number;
+    readonly readbackMs?: number;
+    readonly screenshotCaptureOverheadMs?: number;
+    readonly sampleCount?: number;
+}
+export interface RendererFrameCadenceReport {
+    readonly status: RendererVisualPipelineStatus;
+    readonly targetFrameMs: number;
+    readonly renderMs?: number;
+    readonly loopMs?: number;
+    readonly frameIntervalMs?: number;
+    readonly readbackMs?: number;
+    readonly screenshotCaptureOverheadMs?: number;
+    readonly sampleCount?: number;
+    readonly renderBudgetRatio?: number;
+    readonly loopBudgetRatio?: number;
+    readonly frameIntervalBudgetRatio?: number;
+    readonly readbackBudgetRatio?: number;
+    readonly captureOverheadFrames?: number;
+    readonly loopHeadroomMs?: number;
+    readonly stableForCapture: boolean;
+    readonly warnings: readonly string[];
+}
+export interface RendererVisualPipelineReportOptions {
+    readonly device: RenderDevice;
+    readonly width: number;
+    readonly height: number;
+    readonly postprocess?: RendererVisualPostprocessDescriptor | boolean;
+    readonly colorManagement?: A3DColorManagementPolicy;
+    readonly canvas?: RendererCanvasBackingInput;
+    readonly screenshot?: Omit<RendererScreenshotConsistencyInput, "expectedWidth" | "expectedHeight" | "colorSpace"> & {
+        readonly colorSpace?: A3DColorSpace;
+    };
+    readonly capture?: RendererCaptureQualityInput;
+    readonly frameCadence?: RendererFrameCadenceInput;
+    readonly diagnostics?: RenderDeviceDiagnostics;
+}
+export interface RendererVisualColorReport {
+    readonly lightingColorSpace: "linear";
+    readonly outputColorSpace: A3DColorSpace;
+    readonly supportedOutputColorSpaces: readonly A3DColorSpace[];
+    readonly unsupportedOutputColorSpaces: readonly ["display-p3", "rec2020"];
+    readonly texturePolicy: Readonly<Record<A3DTextureSemantic, A3DColorSpace>>;
+    readonly ldrFallbackAllowed: boolean;
+    readonly fallbackBehavior: string;
+}
+export interface RendererVisualToneMappingReport {
+    readonly status: RendererVisualPipelineStatus;
+    readonly enabled: boolean;
+    readonly operator?: ToneMappingOperator;
+    readonly exposure?: number;
+    readonly whitePoint?: number;
+    readonly gamma?: number;
+    readonly inputColorSpace?: PostProcessColorSpace;
+    readonly outputColorSpace?: PostProcessColorSpace;
+    readonly calibration?: ToneMappingCalibration;
+    readonly availablePresets: readonly ToneMappingPresetName[];
+    readonly warnings: readonly string[];
+}
+export interface RendererVisualPostprocessReport {
+    readonly status: RendererVisualPipelineStatus;
+    readonly enabled: boolean;
+    readonly passNames: readonly RendererVisualPostprocessPassName[];
+    readonly targetFormat: RendererVisualTargetFormat;
+    readonly sourceTargetFormat: RendererVisualTargetFormat;
+    readonly executionMode: RendererPostprocessExecutionMode;
+    readonly nativePresentation: boolean;
+    readonly usesReadback: boolean;
+    readonly missingInputs: readonly string[];
+    readonly readbackPassNames: readonly RendererVisualPostprocessPassName[];
+    readonly rendererOwnedPassNames: readonly RendererVisualPostprocessPassName[];
+    readonly clarityWarnings: readonly string[];
+    readonly forwardOutputColorSpace: PostProcessColorSpace;
+    readonly presentationColorSpace: A3DColorSpace;
+    readonly renderTargetWidth: number;
+    readonly renderTargetHeight: number;
+    readonly plan?: RendererPostprocessPlanDiagnostics;
+    readonly warnings: readonly string[];
+}
+export interface RendererVisualHdrTargetReport {
+    readonly status: RendererVisualPipelineStatus;
+    readonly requested: boolean;
+    readonly supportedByBackend: boolean;
+    readonly capabilityAdvertised: boolean;
+    readonly targetFormat: RendererVisualTargetFormat;
+    readonly fallbackFormat?: "rgba8";
+    readonly toneMappingRequired: boolean;
+    readonly warnings: readonly string[];
+}
+export interface RendererVisualPipelineReport {
+    readonly status: RendererVisualPipelineStatus;
+    readonly backend: RenderDevice["kind"];
+    readonly renderer: string;
+    readonly width: number;
+    readonly height: number;
+    readonly capabilities: readonly RenderDeviceCapability[];
+    readonly color: RendererVisualColorReport;
+    readonly toneMapping: RendererVisualToneMappingReport;
+    readonly hdrTarget: RendererVisualHdrTargetReport;
+    readonly postprocess: RendererVisualPostprocessReport;
+    readonly canvas?: RendererCanvasBackingReport;
+    readonly screenshot?: RendererScreenshotConsistencyReport;
+    readonly capture?: RendererCaptureQualityReport;
+    readonly frameCadence?: RendererFrameCadenceReport;
+    readonly diagnostics?: RenderDeviceDiagnostics;
+    readonly unsupportedCapabilities: Readonly<Record<RendererUnsupportedVisualCapability, string>>;
+    readonly warnings: readonly string[];
+}
+export declare function createRendererVisualPipelineReport(options: RendererVisualPipelineReportOptions): RendererVisualPipelineReport;
+export declare function evaluateRendererCanvasBacking(input: RendererCanvasBackingInput): RendererCanvasBackingReport;
+export declare function evaluateRendererScreenshotConsistency(input: RendererScreenshotConsistencyInput): RendererScreenshotConsistencyReport;
+export declare function evaluateRendererCaptureQuality(input: RendererCaptureQualityInput): RendererCaptureQualityReport;
+export declare function evaluateRendererFrameCadence(input: RendererFrameCadenceInput): RendererFrameCadenceReport;
+//# sourceMappingURL=RendererVisualPipelineReport.d.ts.map