@aura3d/rendering 1.0.6

package/dist/RenderGraph.js

@@ -0,0 +1,159 @@
+import {} from "./RenderPass.js";
+export class RenderGraph {
+    passes = new Map();
+    addPass(pass) {
+        if (this.passes.has(pass.name)) {
+            throw new Error(`Render pass already exists: ${pass.name}`);
+        }
+        this.passes.set(pass.name, pass);
+    }
+    clear() {
+        this.passes.clear();
+    }
+    compile() {
+        return this.compilePlan().passes;
+    }
+    compilePlan() {
+        for (const pass of this.passes.values()) {
+            validatePassResources(pass);
+        }
+        const producers = new Map();
+        for (const pass of this.passes.values()) {
+            for (const write of pass.writes) {
+                const existing = producers.get(write);
+                if (existing) {
+                    throw new Error(`Frame resource ${write} is written by both ${existing} and ${pass.name}`);
+                }
+                producers.set(write, pass.name);
+            }
+        }
+        const dependencies = new Map();
+        for (const pass of this.passes.values()) {
+            const passDependencies = new Set();
+            for (const read of pass.reads) {
+                const producer = producers.get(read);
+                if (!producer) {
+                    throw new Error(`Render pass ${pass.name} reads ${read}, but no pass writes it`);
+                }
+                if (producer !== pass.name) {
+                    passDependencies.add(producer);
+                }
+            }
+            dependencies.set(pass.name, passDependencies);
+        }
+        const sorted = topologicalSort(this.passes, dependencies);
+        return {
+            passes: sorted,
+            resources: createResourceLifetimes(sorted, producers)
+        };
+    }
+    execute(context) {
+        for (const pass of this.compile()) {
+            pass.execute(context);
+        }
+    }
+    async executeAsync(context) {
+        for (const pass of this.compile()) {
+            if (pass.executeAsync) {
+                await pass.executeAsync(context);
+            }
+            else {
+                pass.execute(context);
+            }
+        }
+    }
+}
+function validatePassResources(pass) {
+    const reads = validateResourceList(pass.name, "reads", pass.reads);
+    const writes = validateResourceList(pass.name, "writes", pass.writes);
+    const allowedInPlace = new Set(pass.allowReadWriteHazards ?? []);
+    for (const resource of reads) {
+        if (writes.has(resource) && !allowedInPlace.has(resource)) {
+            throw new Error(`Render pass ${pass.name} reads and writes ${resource} without declaring an in-place hazard allowance`);
+        }
+    }
+    for (const resource of allowedInPlace) {
+        if (!resource.trim()) {
+            throw new Error(`Render pass ${pass.name} allows an empty in-place hazard resource`);
+        }
+    }
+}
+function validateResourceList(passName, kind, resources) {
+    const seen = new Set();
+    for (const resource of resources) {
+        if (!resource.trim()) {
+            throw new Error(`Render pass ${passName} ${kind} an empty frame resource`);
+        }
+        if (seen.has(resource)) {
+            throw new Error(`Render pass ${passName} declares duplicate ${kind} resource: ${resource}`);
+        }
+        seen.add(resource);
+    }
+    return seen;
+}
+function topologicalSort(passes, dependencies) {
+    const sorted = [];
+    const temporary = new Set();
+    const permanent = new Set();
+    const visit = (name) => {
+        if (permanent.has(name)) {
+            return;
+        }
+        if (temporary.has(name)) {
+            throw new Error(`Render graph cycle detected at ${name}`);
+        }
+        temporary.add(name);
+        for (const dependency of dependencies.get(name) ?? []) {
+            visit(dependency);
+        }
+        temporary.delete(name);
+        permanent.add(name);
+        const pass = passes.get(name);
+        if (!pass) {
+            throw new Error(`Unknown render graph pass: ${name}`);
+        }
+        sorted.push(pass);
+    };
+    for (const name of passes.keys()) {
+        visit(name);
+    }
+    return sorted;
+}
+function createResourceLifetimes(passes, producers) {
+    const passIndex = new Map();
+    for (let index = 0; index < passes.length; index += 1) {
+        passIndex.set(passes[index].name, index);
+    }
+    const readersByResource = new Map();
+    for (const pass of passes) {
+        for (const read of pass.reads) {
+            const readers = readersByResource.get(read) ?? [];
+            readers.push(pass.name);
+            readersByResource.set(read, readers);
+        }
+    }
+    return [...producers.entries()]
+        .map(([resource, writer]) => {
+        const readers = readersByResource.get(resource) ?? [];
+        const writerIndex = passIndex.get(writer);
+        if (writerIndex === undefined) {
+            throw new Error(`Frame resource ${resource} is written by unknown pass ${writer}`);
+        }
+        const readerIndices = readers.map((reader) => {
+            const index = passIndex.get(reader);
+            if (index === undefined) {
+                throw new Error(`Frame resource ${resource} is read by unknown pass ${reader}`);
+            }
+            return index;
+        });
+        return {
+            name: resource,
+            writer,
+            readers,
+            firstPassIndex: writerIndex,
+            lastPassIndex: Math.max(writerIndex, ...readerIndices)
+        };
+    })
+        .sort((a, b) => a.firstPassIndex - b.firstPassIndex || a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=RenderGraph.js.map

package/dist/RenderGraph.js.map

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

package/dist/RenderPass.d.ts

@@ -0,0 +1,23 @@
+import { type RenderDevice } from "./RenderDevice";
+export interface RenderPassContext {
+    readonly device: RenderDevice;
+    readonly width: number;
+    readonly height: number;
+}
+export interface RenderPass {
+    readonly name: string;
+    readonly reads: readonly string[];
+    readonly writes: readonly string[];
+    readonly allowReadWriteHazards?: readonly string[];
+    execute(context: RenderPassContext): void;
+    executeAsync?(context: RenderPassContext): Promise<void>;
+}
+export declare abstract class BaseRenderPass implements RenderPass {
+    readonly name: string;
+    readonly reads: readonly string[];
+    readonly writes: readonly string[];
+    readonly allowReadWriteHazards: readonly string[];
+    constructor(name: string, reads?: readonly string[], writes?: readonly string[], allowReadWriteHazards?: readonly string[]);
+    abstract execute(context: RenderPassContext): void;
+}
+//# sourceMappingURL=RenderPass.d.ts.map

package/dist/RenderPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderPass.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/RenderPass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnD,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC1C,YAAY,CAAC,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED,8BAAsB,cAAe,YAAW,UAAU;aAEtC,IAAI,EAAE,MAAM;aACZ,KAAK,EAAE,SAAS,MAAM,EAAE;aACxB,MAAM,EAAE,SAAS,MAAM,EAAE;aACzB,qBAAqB,EAAE,SAAS,MAAM,EAAE;gBAHxC,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,SAAS,MAAM,EAAO,EAC7B,MAAM,GAAE,SAAS,MAAM,EAAO,EAC9B,qBAAqB,GAAE,SAAS,MAAM,EAAO;IAG/D,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;CACnD"}

package/dist/RenderPass.js

@@ -0,0 +1,14 @@
+import {} from "./RenderDevice.js";
+export class BaseRenderPass {
+    name;
+    reads;
+    writes;
+    allowReadWriteHazards;
+    constructor(name, reads = [], writes = [], allowReadWriteHazards = []) {
+        this.name = name;
+        this.reads = reads;
+        this.writes = writes;
+        this.allowReadWriteHazards = allowReadWriteHazards;
+    }
+}
+//# sourceMappingURL=RenderPass.js.map

package/dist/RenderPass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderPass.js","sourceRoot":"","sources":["../../../../packages/rendering/src/RenderPass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,MAAM,gBAAgB,CAAC;AAiBnD,MAAM,OAAgB,cAAc;IAEhB;IACA;IACA;IACA;IAJlB,YACkB,IAAY,EACZ,QAA2B,EAAE,EAC7B,SAA4B,EAAE,EAC9B,wBAA2C,EAAE;QAH7C,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAwB;QAC7B,WAAM,GAAN,MAAM,CAAwB;QAC9B,0BAAqB,GAArB,qBAAqB,CAAwB;IAC5D,CAAC;CAGL"}

package/dist/RenderPipeline.d.ts

@@ -0,0 +1,39 @@
+import { type RenderState } from "./Material";
+import { type DrawCommand, type IndexType, type PrimitiveTopology, type RenderBuffer, type RenderShaderProgram } from "./RenderDevice";
+import { type VertexFormat } from "./VertexFormat";
+export interface RenderPipelineDescriptor {
+    readonly label?: string;
+    readonly shader: RenderShaderProgram;
+    readonly vertexFormat: VertexFormat;
+    readonly topology?: PrimitiveTopology;
+    readonly renderState?: Partial<RenderState>;
+    readonly requiredAttributes?: readonly string[];
+}
+export interface PipelineDrawDescriptor {
+    readonly label?: string;
+    readonly vertexBuffer: RenderBuffer;
+    readonly vertexCount: number;
+    readonly firstVertex?: number;
+    readonly instanceCount?: number;
+    readonly instanceAttributes?: DrawCommand["instanceAttributes"];
+    readonly indexBuffer?: RenderBuffer;
+    readonly indexType?: IndexType;
+    readonly indexCount?: number;
+    readonly firstIndex?: number;
+    readonly uniforms?: DrawCommand["uniforms"];
+}
+export declare class RenderPipeline {
+    readonly label: string;
+    readonly shader: RenderShaderProgram;
+    readonly vertexFormat: VertexFormat;
+    readonly topology: PrimitiveTopology;
+    readonly renderState: RenderState;
+    disposed: boolean;
+    private readonly requiredAttributes;
+    constructor(descriptor: RenderPipelineDescriptor);
+    createDrawCommand(descriptor: PipelineDrawDescriptor): DrawCommand;
+    dispose(): void;
+    private validateVertexFormat;
+    private hasVertexAttribute;
+}
+//# sourceMappingURL=RenderPipeline.d.ts.map

package/dist/RenderPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderPipeline.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/RenderPipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAA6C,MAAM,YAAY,CAAC;AACzF,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;CAC7C;AAED,qBAAa,cAAc;IACzB,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,EAAE,mBAAmB,CAAC;IAC5C,SAAgB,YAAY,EAAE,YAAY,CAAC;IAC3C,SAAgB,QAAQ,EAAE,iBAAiB,CAAC;IAC5C,SAAgB,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,UAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAoB;gBAE3C,UAAU,EAAE,wBAAwB;IAahD,iBAAiB,CAAC,UAAU,EAAE,sBAAsB,GAAG,WAAW;IA+BlE,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,kBAAkB;CAG3B"}

package/dist/RenderPipeline.js

@@ -0,0 +1,67 @@
+import { DEFAULT_RENDER_STATE, validateRenderState } from "./Material.js";
+import {} from "./RenderDevice.js";
+import {} from "./VertexFormat.js";
+export class RenderPipeline {
+    label;
+    shader;
+    vertexFormat;
+    topology;
+    renderState;
+    disposed = false;
+    requiredAttributes;
+    constructor(descriptor) {
+        if (descriptor.shader.disposed) {
+            throw new Error("RenderPipeline shader must not be disposed.");
+        }
+        this.label = descriptor.label ?? descriptor.shader.label;
+        this.shader = descriptor.shader;
+        this.vertexFormat = descriptor.vertexFormat;
+        this.topology = descriptor.topology ?? "triangles";
+        this.renderState = validateRenderState({ ...DEFAULT_RENDER_STATE, ...(descriptor.renderState ?? {}) });
+        this.requiredAttributes = descriptor.requiredAttributes ?? [...descriptor.shader.reflection.attributes.keys()];
+        this.validateVertexFormat();
+    }
+    createDrawCommand(descriptor) {
+        if (this.disposed) {
+            throw new Error("Cannot draw with a disposed RenderPipeline.");
+        }
+        if (this.shader.disposed) {
+            throw new Error("Cannot draw with a disposed RenderPipeline shader.");
+        }
+        const command = {
+            label: descriptor.label ?? this.label,
+            topology: this.topology,
+            renderState: this.renderState,
+            vertexBuffer: descriptor.vertexBuffer,
+            vertexFormat: this.vertexFormat,
+            vertexCount: descriptor.vertexCount,
+            ...(descriptor.firstVertex !== undefined ? { firstVertex: descriptor.firstVertex } : {}),
+            ...(descriptor.instanceCount !== undefined ? { instanceCount: descriptor.instanceCount } : {}),
+            ...(descriptor.instanceAttributes !== undefined ? { instanceAttributes: descriptor.instanceAttributes } : {}),
+            shader: this.shader,
+            uniforms: descriptor.uniforms
+        };
+        if (descriptor.indexBuffer !== undefined) {
+            Object.assign(command, {
+                indexBuffer: descriptor.indexBuffer,
+                indexType: descriptor.indexType,
+                indexCount: descriptor.indexCount,
+                ...(descriptor.firstIndex !== undefined ? { firstIndex: descriptor.firstIndex } : {})
+            });
+        }
+        return command;
+    }
+    dispose() {
+        this.disposed = true;
+    }
+    validateVertexFormat() {
+        const missing = this.requiredAttributes.filter((attribute) => !this.hasVertexAttribute(attribute));
+        if (missing.length > 0) {
+            throw new Error(`RenderPipeline vertex format is missing required attributes: ${missing.join(", ")}`);
+        }
+    }
+    hasVertexAttribute(attribute) {
+        return this.vertexFormat.attributes.some((candidate) => candidate.semantic === attribute || candidate.shaderName === attribute);
+    }
+}
+//# sourceMappingURL=RenderPipeline.js.map

package/dist/RenderPipeline.js.map

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

package/dist/RenderQueue.d.ts

@@ -0,0 +1,3 @@
+export { sortRenderQueueItems, sortRenderItems } from "./performance/RenderItemSorting";
+export type { RenderQueueBucket, RenderQueuePlan, RenderQueueSortDiagnostics, RenderQueueSortItem, RenderQueueSortOptions, SortableRenderItem } from "./performance/RenderItemSorting";
+//# sourceMappingURL=RenderQueue.d.ts.map

package/dist/RenderQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderQueue.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/RenderQueue.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,eAAe,EAChB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,iCAAiC,CAAC"}

package/dist/RenderQueue.js

@@ -0,0 +1,2 @@
+export { sortRenderQueueItems, sortRenderItems } from "./performance/RenderItemSorting.js";
+//# sourceMappingURL=RenderQueue.js.map

package/dist/RenderQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderQueue.js","sourceRoot":"","sources":["../../../../packages/rendering/src/RenderQueue.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,eAAe,EAChB,MAAM,iCAAiC,CAAC"}

package/dist/RenderState.d.ts

@@ -0,0 +1,3 @@
+export { DEFAULT_RENDER_STATE, validateRenderState } from "./Material";
+export type { ColorWriteMask, CullMode, DepthCompare, PolygonOffsetState, RenderState, ScissorRect, StencilCompare, StencilOperation, StencilState } from "./Material";
+//# sourceMappingURL=RenderState.d.ts.map

package/dist/RenderState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderState.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/RenderState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACvE,YAAY,EACV,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,YAAY,EACb,MAAM,YAAY,CAAC"}

package/dist/RenderState.js

@@ -0,0 +1,2 @@
+export { DEFAULT_RENDER_STATE, validateRenderState } from "./Material.js";
+//# sourceMappingURL=RenderState.js.map

package/dist/RenderState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderState.js","sourceRoot":"","sources":["../../../../packages/rendering/src/RenderState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/Renderer.d.ts

@@ -0,0 +1,265 @@
+import { Bounds3 as SceneBounds3, Light, Scene, type SceneNode } from "@aura3d/scene";
+import type { Ray } from "@aura3d/math";
+import { type RenderBackendOptions } from "./RenderBackend";
+import { type RenderDevice, type RenderDeviceDiagnostics, type RenderTarget } from "./RenderDevice";
+import { type EnvironmentBackgroundOptions } from "./EnvironmentBackgroundPass";
+import { type EnvironmentLightingOptions, type ForwardEnvironmentFogOptions, type ForwardShadowMapOptions, type RenderItem, type RenderMaterial } from "./ForwardPass";
+import { type CollectedLight } from "./LightCollector";
+import { Geometry } from "./Geometry";
+import { type MorphTargetDelta } from "./MorphTarget";
+import { type RendererPostprocessPlanOptions, type RendererPostprocessTargetFormat } from "./RendererPostprocessPlan";
+import { type ShaderLibrary } from "./ShaderLibrary";
+import { type ShadowFilterKernel, type ShadowMapOptions } from "./ShadowMap";
+import { type PerspectiveCameraFrameOptions } from "./CameraFraming";
+import { type RendererFeature, type RendererFeatureReport } from "./RendererFeatureGates";
+import { type StaticBatchOptions } from "./SceneOptimization";
+export interface RendererOptions extends RenderBackendOptions {
+    readonly width?: number;
+    readonly height?: number;
+    readonly clearColor?: readonly [number, number, number, number];
+    readonly shaderLibrary?: ShaderLibrary;
+    readonly requiredFeatures?: readonly RendererFeature[];
+}
+export interface ResizeToDisplayOptions {
+    readonly cssWidth?: number;
+    readonly cssHeight?: number;
+    readonly devicePixelRatio?: number;
+}
+export interface ResizeToDisplayResult {
+    readonly resized: boolean;
+    readonly cssWidth: number;
+    readonly cssHeight: number;
+    readonly devicePixelRatio: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface RendererAnimationLoop {
+    readonly running: boolean;
+    stop(): void;
+}
+export interface RendererFrameCapture {
+    readonly width: number;
+    readonly height: number;
+    readonly pixels: Uint8Array;
+    readonly diagnostics: RenderDeviceDiagnostics;
+    readonly capturedAt?: string;
+    readonly renderSize?: RendererFrameCaptureRenderSize;
+    readonly pixelHash?: string;
+    readonly pixelDigest?: RendererFrameCapturePixelDigest;
+    readonly pixelStats?: RendererFrameCapturePixelStats;
+    readonly diagnosticsSummary?: RendererFrameCaptureDiagnosticsSummary;
+    readonly metadata?: RendererFrameCaptureMetadata;
+}
+export interface RendererFrameCaptureWithMetadata extends RendererFrameCapture {
+    readonly capturedAt: string;
+    readonly renderSize: RendererFrameCaptureRenderSize;
+    readonly pixelHash: string;
+    readonly pixelDigest: RendererFrameCapturePixelDigest;
+    readonly pixelStats: RendererFrameCapturePixelStats;
+    readonly diagnosticsSummary: RendererFrameCaptureDiagnosticsSummary;
+    readonly metadata: RendererFrameCaptureMetadata;
+}
+export interface RendererFrameCaptureRenderSize {
+    readonly width: number;
+    readonly height: number;
+    readonly pixelCount: number;
+    readonly byteLength: number;
+    readonly aspectRatio: number;
+}
+export interface RendererFrameCapturePixelDigest {
+    readonly algorithm: "sha256";
+    readonly encoding: "hex";
+    readonly source: "rgba8";
+    readonly value: string;
+    readonly byteLength: number;
+}
+export interface RendererFrameCapturePixelStats {
+    readonly totalPixels: number;
+    readonly opaquePixels: number;
+    readonly opaqueRatio: number;
+    readonly transparentPixels: number;
+    readonly transparentRatio: number;
+    readonly nonBlankPixels: number;
+    readonly nonBlankRatio: number;
+    readonly underexposedPixels: number;
+    readonly underexposedRatio: number;
+    readonly overexposedPixels: number;
+    readonly overexposedRatio: number;
+    readonly clippedChannelPixels: number;
+    readonly clippedChannelRatio: number;
+    readonly averageLuminance: number;
+    readonly minLuminance: number;
+    readonly maxLuminance: number;
+    readonly averageAlpha: number;
+    readonly averageRgb: readonly [number, number, number];
+    readonly thresholds: {
+        readonly nonBlankLuminance: number;
+        readonly underexposedLuminance: number;
+        readonly overexposedLuminance: number;
+        readonly clippedChannel: number;
+    };
+}
+export interface RendererFrameCaptureDiagnosticsSummary {
+    readonly backend: RenderDevice["kind"];
+    readonly renderer: string;
+    readonly vendor: string;
+    readonly capabilities: readonly string[];
+    readonly limitations: readonly string[];
+    readonly drawCalls: number;
+    readonly resources: {
+        readonly buffers: number;
+        readonly shaders: number;
+        readonly renderTargets?: number;
+        readonly textures?: number;
+    };
+    readonly memoryBytes?: {
+        readonly buffers?: number;
+        readonly textures?: number;
+        readonly approximateGpu?: number;
+    };
+    readonly scene?: {
+        readonly submittedObjects?: number;
+        readonly visibleObjects?: number;
+        readonly culledObjects?: number;
+        readonly frustumTestedObjects?: number;
+    };
+    readonly postprocess?: {
+        readonly passes?: number;
+        readonly passNames?: readonly string[];
+        readonly targetFormat?: "rgba8" | "rgba16f" | "rgba32f";
+        readonly renderTargets?: number;
+        readonly textures?: number;
+        readonly targetWidth?: number;
+        readonly targetHeight?: number;
+    };
+    readonly contextLost: boolean;
+    readonly lastError: string | null;
+}
+export interface RendererFrameCaptureMetadata {
+    readonly capturedAt: string;
+    readonly renderSize: RendererFrameCaptureRenderSize;
+    readonly pixelHash: string;
+    readonly pixelDigest: RendererFrameCapturePixelDigest;
+    readonly pixelStats: RendererFrameCapturePixelStats;
+    readonly diagnosticsSummary: RendererFrameCaptureDiagnosticsSummary;
+}
+export interface RenderSource {
+    collectRenderItems?(): Iterable<RenderItem>;
+    readonly renderItems?: Iterable<RenderItem>;
+    readonly scene?: Scene;
+    readonly renderTarget?: RenderTarget;
+    readonly cameraPolicy?: RendererCameraPolicy;
+    readonly cameraFrameBounds?: SceneBounds3 | {
+        readonly min: readonly [number, number, number];
+        readonly max: readonly [number, number, number];
+    };
+    readonly cameraFrameOptions?: PerspectiveCameraFrameOptions;
+    readonly collectedLights?: Iterable<CollectedLight>;
+    readonly environmentBackground?: EnvironmentBackgroundOptions | false;
+    readonly environmentLighting?: EnvironmentLightingOptions | false;
+    readonly environmentFog?: ForwardEnvironmentFogOptions | false;
+    readonly shadowMap?: ForwardShadowMapOptions;
+    readonly shadow?: RendererShadowOptions | boolean;
+    readonly postprocess?: RendererPostProcessOptions | boolean;
+    readonly cameraPosition?: readonly [number, number, number];
+    readonly geometryLibrary?: RenderResourceLookup<Geometry>;
+    readonly materialLibrary?: RenderResourceLookup<RenderMaterial>;
+    readonly morphTargetLibrary?: RenderResourceLookup<readonly MorphTargetDelta[]>;
+    readonly frustumCulling?: boolean;
+    readonly staticBatching?: boolean | StaticBatchOptions;
+}
+export interface RendererInput {
+    readonly source: RenderSource | Iterable<RenderItem> | Scene;
+    readonly camera?: CameraLike;
+}
+export type RendererCameraPolicy = "identity" | "auto-frame" | "require";
+export declare const DEFAULT_RENDERER_AUTO_FRAME_OPTIONS: PerspectiveCameraFrameOptions;
+export declare const DEFAULT_RENDERER_ENVIRONMENT_LIGHTING: EnvironmentLightingOptions;
+export declare const DEFAULT_RENDERER_DIRECT_LIGHTING: {
+    readonly key: {
+        readonly color: readonly [1, 0.92, 0.78];
+        readonly intensity: 2.25;
+        readonly direction: readonly [0.42, -0.58, -0.7];
+    };
+    readonly fill: {
+        readonly color: readonly [0.48, 0.62, 0.9];
+        readonly intensity: 0.55;
+        readonly direction: readonly [-0.35, -0.22, -0.91];
+    };
+};
+export interface RendererShadowOptions extends ShadowMapOptions {
+    readonly enabled?: boolean;
+    readonly light?: Light;
+    readonly lightMatrix?: Float32Array | readonly number[];
+    readonly strength?: number;
+    readonly slopeBias?: number;
+    readonly texelSize?: readonly [number, number];
+    readonly filterKernel?: ShadowFilterKernel;
+}
+export interface RendererPostProcessOptions extends RendererPostprocessPlanOptions {
+    readonly targetFormat?: RendererPostprocessTargetFormat;
+}
+export type RenderResourceLookup<T> = ReadonlyMap<string, T> | Readonly<Record<string, T>>;
+export interface CameraLike {
+    readonly projectionMatrix?: Float32Array | readonly number[];
+    readonly viewMatrix?: Float32Array | readonly number[];
+    readonly viewProjectionMatrix?: Float32Array | readonly number[];
+    resize?(width: number, height: number): void;
+    updateCameraMatrices?(): void;
+}
+export interface ScenePickHit {
+    readonly node: SceneNode;
+    readonly geometry: Geometry;
+    readonly distance: number;
+    readonly bounds: SceneBounds3;
+    readonly hitPoint?: readonly [number, number, number];
+    readonly pointIndex?: number;
+    readonly instanceIndex?: number;
+}
+export interface ScenePickOptions {
+    readonly pointRadius?: number;
+    readonly lineRadius?: number;
+}
+export declare class Renderer {
+    readonly device: RenderDevice;
+    private readonly graph;
+    private readonly shaderLibrary;
+    private readonly canvas?;
+    private width;
+    private height;
+    private clearColor;
+    private disposed;
+    private animationLoop;
+    private readonly fusedLdrPostprocessScratch;
+    private constructor();
+    static create(options?: RendererOptions): Promise<Renderer>;
+    getFeatureReport(): RendererFeatureReport;
+    resize(width: number, height: number): void;
+    resizeToDisplay(options?: ResizeToDisplayOptions): ResizeToDisplayResult;
+    startAnimationLoop(callback: (timeMs: number, renderer: Renderer) => void): RendererAnimationLoop;
+    render(input: RendererInput): RenderDeviceDiagnostics;
+    render(source: RenderSource | Iterable<RenderItem> | Scene, camera?: CameraLike): RenderDeviceDiagnostics;
+    renderAsync(input: RendererInput): Promise<RenderDeviceDiagnostics>;
+    renderAsync(source: RenderSource | Iterable<RenderItem> | Scene, camera?: CameraLike): Promise<RenderDeviceDiagnostics>;
+    renderScene(scene: RenderSource | Scene, camera?: CameraLike): RenderDeviceDiagnostics;
+    renderItems(items: Iterable<RenderItem>, camera?: CameraLike, options?: Omit<RenderSource, "renderItems">): RenderDeviceDiagnostics;
+    captureFrame(source?: RenderSource | Iterable<RenderItem> | Scene, camera?: CameraLike): RendererFrameCaptureWithMetadata;
+    getDiagnostics(): RenderDeviceDiagnostics;
+    dispose(): void;
+    private assertAlive;
+    private resizeCanvas;
+    private executePostprocess;
+    private executeFusedLdrPostprocess;
+    private executePostprocessAsync;
+    private executeFusedLdrPostprocessAsync;
+    private executePixelPostprocessPass;
+    private executePixelPostprocessPassAsync;
+    private readRenderTargetPixelsAsync;
+    private readRenderTargetFloatPixelsAsync;
+    private readRendererOwnedDepthTexture;
+    private executeRendererShadowMap;
+    private executeRendererPointShadowMap;
+}
+export declare function pickSceneRenderables(source: Pick<RenderSource, "geometryLibrary" | "morphTargetLibrary" | "scene">, ray: Ray, options?: ScenePickOptions): ScenePickHit | undefined;
+export declare function pickSceneRenderableHits(source: Pick<RenderSource, "geometryLibrary" | "morphTargetLibrary" | "scene">, ray: Ray, options?: ScenePickOptions): readonly ScenePickHit[];
+//# sourceMappingURL=Renderer.d.ts.map