@aura3d/rendering 1.0.6

package/dist/CascadedShadowMaps.js

@@ -0,0 +1,315 @@
+import { DirectionalLight, Light } from "@aura3d/scene";
+import {} from "./Geometry.js";
+import {} from "./ForwardPass.js";
+import {} from "./RenderDevice.js";
+import {} from "./RenderPass.js";
+import { ShadowMap } from "./ShadowMap.js";
+import { ShadowPass } from "./ShadowPass.js";
+import {} from "./ShaderLibrary.js";
+export class CascadedShadowMaps {
+    cascades;
+    constructor(options) {
+        const size = options.size ?? 1024;
+        const bias = options.bias ?? 0.001;
+        const label = options.label ?? "csm";
+        this.cascades = CascadedShadowMaps.computeSplits(options).map((split) => ({
+            index: split.index,
+            split,
+            shadowMap: new ShadowMap({
+                size,
+                bias,
+                filter: options.filter,
+                pcfRadius: options.pcfRadius,
+                pcfSamples: options.pcfSamples,
+                label: `${label}-cascade-${split.index}`
+            })
+        }));
+    }
+    static computeSplits(options) {
+        const { cascadeCount, near, far, lambda = 0.5 } = options;
+        if (!Number.isInteger(cascadeCount) || cascadeCount <= 0) {
+            throw new Error("Cascade count must be a positive integer");
+        }
+        if (near <= 0 || far <= near) {
+            throw new Error("Cascade near/far range is invalid");
+        }
+        if (lambda < 0 || lambda > 1) {
+            throw new Error("Cascade lambda must be between 0 and 1");
+        }
+        const splits = [];
+        let previous = near;
+        for (let index = 1; index <= cascadeCount; index += 1) {
+            const ratio = index / cascadeCount;
+            const logarithmic = near * (far / near) ** ratio;
+            const uniform = near + (far - near) * ratio;
+            const cascadeFar = index === cascadeCount ? far : lambda * logarithmic + (1 - lambda) * uniform;
+            splits.push({
+                index: index - 1,
+                near: previous,
+                far: cascadeFar
+            });
+            previous = cascadeFar;
+        }
+        return splits;
+    }
+    get cascadeCount() {
+        return this.cascades.length;
+    }
+    getCascades() {
+        return this.cascades;
+    }
+    computeStableCameraFits(options) {
+        return this.cascades.map((cascade) => computeShadowCameraFit(cascade, options));
+    }
+    resize(size) {
+        const first = this.cascades[0];
+        if (!first) {
+            throw new Error("Cannot resize cascaded shadow maps without cascades");
+        }
+        const resized = Object.create(CascadedShadowMaps.prototype);
+        Object.assign(resized, {
+            cascades: this.cascades.map((cascade) => ({
+                index: cascade.index,
+                split: cascade.split,
+                shadowMap: cascade.shadowMap.resize(size)
+            }))
+        });
+        return resized;
+    }
+    dispose() {
+        for (const cascade of this.cascades) {
+            cascade.shadowMap.dispose();
+        }
+    }
+}
+function computeShadowCameraFit(cascade, options) {
+    const padding = options.padding ?? 0.25;
+    if (!Number.isFinite(padding) || padding < 0) {
+        throw new Error("Shadow camera fit padding must be finite and non-negative");
+    }
+    const basis = lightBasis(options.lightDirection);
+    const frustumCornersWorld = cameraFrustumCorners(options.camera, cascade.split);
+    const casterBoundsWorld = mergeItemBounds(options.casters);
+    const receiverBoundsWorld = mergeItemBounds(options.receivers ?? []);
+    const combinedBoundsWorld = expandBounds(mergeBounds([boundsFromPoints(frustumCornersWorld), casterBoundsWorld, receiverBoundsWorld]), padding);
+    const lightSpacePoints = corners(combinedBoundsWorld).map((point) => projectToLightSpace(point, basis));
+    const lightSpaceBounds = boundsFromPoints(lightSpacePoints);
+    const centerLightSpace = [
+        (lightSpaceBounds.min[0] + lightSpaceBounds.max[0]) / 2,
+        (lightSpaceBounds.min[1] + lightSpaceBounds.max[1]) / 2,
+        (lightSpaceBounds.min[2] + lightSpaceBounds.max[2]) / 2
+    ];
+    const width = Math.max(1e-6, lightSpaceBounds.max[0] - lightSpaceBounds.min[0]);
+    const height = Math.max(1e-6, lightSpaceBounds.max[1] - lightSpaceBounds.min[1]);
+    const extent = Math.max(width, height);
+    const texelSize = extent / cascade.shadowMap.size;
+    const snappedCenterLightSpace = options.stabilize === false ? centerLightSpace : [
+        snap(centerLightSpace[0], texelSize),
+        snap(centerLightSpace[1], texelSize),
+        centerLightSpace[2]
+    ];
+    const halfExtent = extent / 2;
+    const depthPadding = Math.max(padding, extent * 0.05);
+    return {
+        cascadeIndex: cascade.index,
+        split: cascade.split,
+        mapSize: cascade.shadowMap.size,
+        texelSize,
+        lightDirection: normalize(options.lightDirection),
+        basis,
+        frustumCornersWorld,
+        casterBoundsWorld,
+        receiverBoundsWorld,
+        combinedBoundsWorld,
+        lightSpaceBounds,
+        centerLightSpace,
+        snappedCenterLightSpace,
+        stableOffsetLightSpace: [
+            snappedCenterLightSpace[0] - centerLightSpace[0],
+            snappedCenterLightSpace[1] - centerLightSpace[1],
+            snappedCenterLightSpace[2] - centerLightSpace[2]
+        ],
+        orthographic: {
+            left: snappedCenterLightSpace[0] - halfExtent,
+            right: snappedCenterLightSpace[0] + halfExtent,
+            bottom: snappedCenterLightSpace[1] - halfExtent,
+            top: snappedCenterLightSpace[1] + halfExtent,
+            near: lightSpaceBounds.min[2] - depthPadding,
+            far: lightSpaceBounds.max[2] + depthPadding
+        },
+        casterCount: options.casters.length,
+        receiverCount: options.receivers?.length ?? 0
+    };
+}
+function cameraFrustumCorners(camera, split) {
+    if (!Number.isFinite(camera.fovYRadians) || camera.fovYRadians <= 0 || camera.fovYRadians >= Math.PI) {
+        throw new Error("Shadow camera fit requires a finite perspective fov in radians");
+    }
+    if (!Number.isFinite(camera.aspect) || camera.aspect <= 0) {
+        throw new Error("Shadow camera fit requires a finite positive aspect ratio");
+    }
+    const forward = normalize(sub(camera.target, camera.position));
+    const right = normalize(cross(forward, camera.up ?? [0, 1, 0]));
+    const up = normalize(cross(right, forward));
+    return [split.near, split.far].flatMap((distance) => {
+        const halfHeight = Math.tan(camera.fovYRadians / 2) * distance;
+        const halfWidth = halfHeight * camera.aspect;
+        const center = add(camera.position, scale(forward, distance));
+        return [
+            add(add(center, scale(right, -halfWidth)), scale(up, -halfHeight)),
+            add(add(center, scale(right, halfWidth)), scale(up, -halfHeight)),
+            add(add(center, scale(right, halfWidth)), scale(up, halfHeight)),
+            add(add(center, scale(right, -halfWidth)), scale(up, halfHeight))
+        ];
+    });
+}
+function mergeItemBounds(items) {
+    const bounds = items.map(worldBoundsForItem);
+    return bounds.length > 0 ? mergeBounds(bounds) : null;
+}
+function worldBoundsForItem(item) {
+    return boundsFromPoints(corners(item.geometry.bounds).map((point) => transformPoint(point, item.modelMatrix)));
+}
+function transformPoint(point, matrix) {
+    if (!matrix) {
+        return point;
+    }
+    if (matrix.length < 16) {
+        throw new Error("RenderItem modelMatrix must contain 16 numbers for shadow camera fitting");
+    }
+    return [
+        matrix[0] * point[0] + matrix[4] * point[1] + matrix[8] * point[2] + matrix[12],
+        matrix[1] * point[0] + matrix[5] * point[1] + matrix[9] * point[2] + matrix[13],
+        matrix[2] * point[0] + matrix[6] * point[1] + matrix[10] * point[2] + matrix[14]
+    ];
+}
+function lightBasis(lightDirection) {
+    const forward = normalize(scale(normalize(lightDirection), -1));
+    const fallbackUp = Math.abs(forward[1]) > 0.94 ? [0, 0, 1] : [0, 1, 0];
+    const right = normalize(cross(fallbackUp, forward));
+    const up = normalize(cross(forward, right));
+    return { right, up, forward };
+}
+function projectToLightSpace(point, basis) {
+    return [dot(point, basis.right), dot(point, basis.up), dot(point, basis.forward)];
+}
+function mergeBounds(bounds) {
+    const filtered = bounds.filter((value) => value !== null);
+    if (filtered.length === 0) {
+        throw new Error("Cannot merge empty shadow fitting bounds");
+    }
+    const min = [Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY];
+    const max = [Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY];
+    for (const bound of filtered) {
+        for (let axis = 0; axis < 3; axis += 1) {
+            min[axis] = Math.min(min[axis], bound.min[axis]);
+            max[axis] = Math.max(max[axis], bound.max[axis]);
+        }
+    }
+    return { min, max };
+}
+function expandBounds(bounds, padding) {
+    return {
+        min: [bounds.min[0] - padding, bounds.min[1] - padding, bounds.min[2] - padding],
+        max: [bounds.max[0] + padding, bounds.max[1] + padding, bounds.max[2] + padding]
+    };
+}
+function boundsFromPoints(points) {
+    if (points.length === 0) {
+        throw new Error("Cannot compute shadow bounds from no points");
+    }
+    const min = [Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY];
+    const max = [Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY];
+    for (const point of points) {
+        for (let axis = 0; axis < 3; axis += 1) {
+            min[axis] = Math.min(min[axis], point[axis]);
+            max[axis] = Math.max(max[axis], point[axis]);
+        }
+    }
+    return { min, max };
+}
+function corners(bounds) {
+    const { min, max } = bounds;
+    return [
+        [min[0], min[1], min[2]],
+        [max[0], min[1], min[2]],
+        [max[0], max[1], min[2]],
+        [min[0], max[1], min[2]],
+        [min[0], min[1], max[2]],
+        [max[0], min[1], max[2]],
+        [max[0], max[1], max[2]],
+        [min[0], max[1], max[2]]
+    ];
+}
+function snap(value, increment) {
+    if (!Number.isFinite(increment) || increment <= 0) {
+        return value;
+    }
+    return Math.round(value / increment) * increment;
+}
+function add(a, b) {
+    return [a[0] + b[0], a[1] + b[1], a[2] + b[2]];
+}
+function sub(a, b) {
+    return [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+}
+function scale(value, amount) {
+    return [value[0] * amount, value[1] * amount, value[2] * amount];
+}
+function dot(a, b) {
+    return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+}
+function cross(a, b) {
+    return [
+        a[1] * b[2] - a[2] * b[1],
+        a[2] * b[0] - a[0] * b[2],
+        a[0] * b[1] - a[1] * b[0]
+    ];
+}
+function normalize(value) {
+    const length = Math.hypot(value[0], value[1], value[2]);
+    if (!Number.isFinite(length) || length <= 1e-8) {
+        throw new Error("Shadow camera fitting vector cannot be zero");
+    }
+    return [value[0] / length, value[1] / length, value[2] / length];
+}
+export class CascadedShadowPass {
+    options;
+    lastResult = null;
+    constructor(options) {
+        this.options = options;
+    }
+    execute(context) {
+        const cascadeResults = this.options.cascades.getCascades().map((cascade) => {
+            const shadowPass = new ShadowPass({
+                light: this.options.light,
+                casters: this.options.casters,
+                shadowMap: cascade.shadowMap,
+                ...(this.options.shaderLibrary ? { shaderLibrary: this.options.shaderLibrary } : {})
+            });
+            const result = shadowPass.execute(context);
+            return {
+                index: cascade.index,
+                split: cascade.split,
+                rendered: result.rendered,
+                reason: result.reason,
+                casterCount: result.casterCount,
+                skippedTransparentCasters: result.skippedTransparentCasters,
+                diagnostics: result.diagnostics,
+                shadowMap: cascade.shadowMap
+            };
+        });
+        this.lastResult = {
+            rendered: cascadeResults.length > 0 && cascadeResults.every((cascade) => cascade.rendered),
+            cascades: cascadeResults
+        };
+        return this.lastResult;
+    }
+    getLastResult() {
+        return this.lastResult;
+    }
+}
+export function supportsCascadedShadowLight(light) {
+    return light instanceof DirectionalLight && light.visible && light.castsShadow;
+}
+//# sourceMappingURL=CascadedShadowMaps.js.map

package/dist/CascadedShadowMaps.js.map

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

package/dist/ColorManagement.d.ts

@@ -0,0 +1,33 @@
+export type A3DColorSpace = "linear" | "srgb";
+export type A3DTextureSemantic = "base-color" | "emissive" | "normal" | "metallic-roughness" | "roughness" | "metallic" | "occlusion" | "height" | "transmission" | "specular" | "sheen" | "anisotropy" | "iridescence" | "environment";
+export interface A3DColorManagementPolicy {
+    readonly lightingColorSpace: "linear";
+    readonly outputColorSpace: A3DColorSpace;
+    readonly texturePolicy: Readonly<Record<A3DTextureSemantic, A3DColorSpace>>;
+    readonly allowLdrFallback: boolean;
+    readonly fallbackBehavior: string;
+}
+export interface A3DColorConversionSample {
+    readonly input: number;
+    readonly linear: number;
+    readonly srgb: number;
+    readonly roundTripError: number;
+}
+export interface A3DTextureColorSpaceValidation {
+    readonly semantic: A3DTextureSemantic;
+    readonly expected: A3DColorSpace;
+    readonly actual: A3DColorSpace;
+    readonly pass: boolean;
+    readonly warning?: string;
+}
+export declare const EXTERNAL_PARITY_TEXTURE_COLOR_POLICY: Readonly<Record<A3DTextureSemantic, A3DColorSpace>>;
+export declare function createExternalParityColorManagementPolicy(options?: {
+    readonly outputColorSpace?: A3DColorSpace;
+    readonly allowLdrFallback?: boolean;
+}): A3DColorManagementPolicy;
+export declare function srgbToLinearChannel(value: number): number;
+export declare function linearToSrgbChannel(value: number): number;
+export declare function convertColorSpace(color: readonly [number, number, number, number], from: A3DColorSpace, to: A3DColorSpace): [number, number, number, number];
+export declare function validateTextureColorSpace(semantic: A3DTextureSemantic, actual: A3DColorSpace, policy?: A3DColorManagementPolicy): A3DTextureColorSpaceValidation;
+export declare function createColorConversionSamples(samples?: readonly number[]): readonly A3DColorConversionSample[];
+//# sourceMappingURL=ColorManagement.d.ts.map

package/dist/ColorManagement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorManagement.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/ColorManagement.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC9C,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,oBAAoB,GACpB,WAAW,GACX,UAAU,GACV,WAAW,GACX,QAAQ,GACR,cAAc,GACd,UAAU,GACV,OAAO,GACP,YAAY,GACZ,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC,CAAC;IAC5E,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,oCAAoC,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAepG,CAAC;AAEF,wBAAgB,yCAAyC,CAAC,OAAO,GAAE;IACjE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAChC,GAAG,wBAAwB,CAQhC;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAChD,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,aAAa,GAChB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAIlC;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,aAAa,EACrB,MAAM,GAAE,wBAAsE,GAC7E,8BAA8B,CAUhC;AAED,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,SAAS,MAAM,EAAiC,GAAG,SAAS,wBAAwB,EAAE,CAW3I"}

package/dist/ColorManagement.js

@@ -0,0 +1,71 @@
+export const EXTERNAL_PARITY_TEXTURE_COLOR_POLICY = {
+    "base-color": "srgb",
+    emissive: "srgb",
+    normal: "linear",
+    "metallic-roughness": "linear",
+    roughness: "linear",
+    metallic: "linear",
+    occlusion: "linear",
+    height: "linear",
+    transmission: "linear",
+    specular: "linear",
+    sheen: "srgb",
+    anisotropy: "linear",
+    iridescence: "linear",
+    environment: "linear"
+};
+export function createExternalParityColorManagementPolicy(options = {}) {
+    return {
+        lightingColorSpace: "linear",
+        outputColorSpace: options.outputColorSpace ?? "srgb",
+        texturePolicy: EXTERNAL_PARITY_TEXTURE_COLOR_POLICY,
+        allowLdrFallback: options.allowLdrFallback ?? true,
+        fallbackBehavior: "HDR render targets are preferred. LDR fallback must keep linear lighting and tone-map to the configured output color space."
+    };
+}
+export function srgbToLinearChannel(value) {
+    const channel = clamp01(value);
+    return channel <= 0.04045 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4;
+}
+export function linearToSrgbChannel(value) {
+    const channel = clamp01(value);
+    return channel <= 0.0031308 ? channel * 12.92 : 1.055 * channel ** (1 / 2.4) - 0.055;
+}
+export function convertColorSpace(color, from, to) {
+    if (from === to)
+        return [clamp01(color[0]), clamp01(color[1]), clamp01(color[2]), clamp01(color[3])];
+    const convert = from === "srgb" && to === "linear" ? srgbToLinearChannel : linearToSrgbChannel;
+    return [convert(color[0]), convert(color[1]), convert(color[2]), clamp01(color[3])];
+}
+export function validateTextureColorSpace(semantic, actual, policy = createExternalParityColorManagementPolicy()) {
+    const expected = policy.texturePolicy[semantic];
+    const pass = expected === actual;
+    return {
+        semantic,
+        expected,
+        actual,
+        pass,
+        ...(pass ? {} : { warning: `${semantic} texture must be tagged ${expected}; received ${actual}.` })
+    };
+}
+export function createColorConversionSamples(samples = [0, 0.0031308, 0.18, 0.5, 1]) {
+    return samples.map((input) => {
+        const linear = srgbToLinearChannel(input);
+        const srgb = linearToSrgbChannel(linear);
+        return {
+            input,
+            linear: round(linear),
+            srgb: round(srgb),
+            roundTripError: round(Math.abs(clamp01(input) - srgb))
+        };
+    });
+}
+function clamp01(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.min(1, Math.max(0, value));
+}
+function round(value) {
+    return Number(value.toFixed(6));
+}
+//# sourceMappingURL=ColorManagement.js.map

package/dist/ColorManagement.js.map

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

package/dist/CullingFixtures.d.ts

@@ -0,0 +1,70 @@
+export interface CullingFixtureOptions {
+    readonly seed?: number;
+    readonly objectCount?: number;
+    readonly cameraX?: number;
+    readonly depthResolution?: readonly [number, number];
+}
+export interface CullingFixtureObject {
+    readonly id: string;
+    readonly center: readonly [number, number, number];
+    readonly halfExtents: readonly [number, number, number];
+    readonly projectedAreaPixels: number;
+}
+export interface CullingBvhTelemetry {
+    readonly nodeCount: number;
+    readonly leafCount: number;
+    readonly objectCount: number;
+    readonly maxDepth: number;
+    readonly averageLeafObjects: number;
+    readonly sahSplitCount: number;
+    readonly boundsTests: number;
+    readonly objectTests: number;
+    readonly rangeQueryHits: number;
+    readonly raycastHitId: string | null;
+    readonly raycastDistance: number;
+}
+export interface CullingFrustumTelemetry {
+    readonly testedObjects: number;
+    readonly visibleObjects: number;
+    readonly culledObjects: number;
+    readonly visibleRatio: number;
+}
+export interface CullingHiZTelemetry {
+    readonly depthResolution: readonly [number, number];
+    readonly mipLevels: number;
+    readonly depthPyramidTexels: number;
+    readonly maxDepthSamples: number;
+    readonly conservativeTests: number;
+    readonly visibleObjects: number;
+    readonly occludedObjects: number;
+    readonly unknownResults: number;
+    readonly frameCoherentReused: number;
+    readonly depthThreshold: number;
+    readonly estimatedBuildMs: number;
+    readonly estimatedTestMs: number;
+}
+export interface CullingFeatureEvidence {
+    readonly bvhHierarchy: boolean;
+    readonly frustumTraversal: boolean;
+    readonly hizPyramid: boolean;
+    readonly conservativeOcclusion: boolean;
+    readonly frameCoherency: boolean;
+}
+export interface CullingFixture {
+    readonly id: "external-parity-old-branch-bvh-hiz-culling-fixture";
+    readonly source: "origin-master-bvh-hiz-occlusion-adapted";
+    readonly sourceFiles: readonly string[];
+    readonly seed: number;
+    readonly cameraX: number;
+    readonly objectCount: number;
+    readonly objects: readonly CullingFixtureObject[];
+    readonly bvh: CullingBvhTelemetry;
+    readonly frustum: CullingFrustumTelemetry;
+    readonly hiz: CullingHiZTelemetry;
+    readonly featureEvidence: CullingFeatureEvidence;
+    readonly hash: string;
+    readonly claimBoundary: string;
+    readonly blockedClaims: readonly string[];
+}
+export declare function sampleCullingFixture(options?: CullingFixtureOptions): CullingFixture;
+//# sourceMappingURL=CullingFixtures.d.ts.map

package/dist/CullingFixtures.d.ts.map

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