@aura3d/rendering 1.0.6

package/dist/materials/MaterialExtensions.js

@@ -0,0 +1,20 @@
+export const EXTERNAL_PARITY_MATERIAL_EXTENSION_SUPPORT = [
+    { extension: "clearcoat", support: "bounded", diagnostic: "Clearcoat factor and roughness are modeled; layered multiple scattering remains bounded." },
+    { extension: "sheen", support: "bounded", diagnostic: "Sheen color/roughness intent is modeled for fabric review; exact renderer parity requires visual comparison." },
+    { extension: "specular", support: "bounded", diagnostic: "Specular factor/color are modeled for material diagnostics and matrix proof." },
+    { extension: "transmission", support: "bounded", diagnostic: "Transmission is approximated by the bounded transmission pass; refraction parity is not claimed." },
+    { extension: "volume", support: "bounded", diagnostic: "Volume thickness/attenuation are tracked for diagnostics; full volumetric caustics are not claimed." },
+    { extension: "ior", support: "bounded", diagnostic: "IOR is tracked and used by bounded Fresnel/transmission response." },
+    { extension: "anisotropy", support: "bounded", diagnostic: "Anisotropy intent is tracked for brushed material review; tangent-space parity requires visual evidence." },
+    { extension: "iridescence", support: "bounded", diagnostic: "Iridescence factors are tracked for diagnostics; spectral accuracy is not claimed." },
+    { extension: "emissive-strength", support: "supported", diagnostic: "Emissive strength is supported through HDR/tone-mapped material proof." },
+    { extension: "texture-transform", support: "supported", diagnostic: "Texture transforms are tracked and validated for material slots." },
+    { extension: "multi-uv", support: "bounded", diagnostic: "Multiple UV intent is tracked; fallback diagnostics are required when a shader path cannot bind the requested UV set." }
+];
+export function getExternalParityMaterialExtensionState(extension) {
+    return EXTERNAL_PARITY_MATERIAL_EXTENSION_SUPPORT.find((entry) => entry.extension === extension);
+}
+export function createExternalParityMaterialExtensionDiagnostics(requested) {
+    return requested.map(getExternalParityMaterialExtensionState);
+}
+//# sourceMappingURL=MaterialExtensions.js.map

package/dist/materials/MaterialExtensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaterialExtensions.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/materials/MaterialExtensions.ts"],"names":[],"mappings":"AAmBA,MAAM,CAAC,MAAM,0CAA0C,GAAoD;IACzG,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,0FAA0F,EAAE;IACtJ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,8GAA8G,EAAE;IACtK,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,8EAA8E,EAAE;IACzI,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,kGAAkG,EAAE;IACjK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,qGAAqG,EAAE;IAC9J,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,mEAAmE,EAAE;IACzH,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,0GAA0G,EAAE;IACvK,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,oFAAoF,EAAE;IAClJ,EAAE,SAAS,EAAE,mBAAmB,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,wEAAwE,EAAE;IAC9I,EAAE,SAAS,EAAE,mBAAmB,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,kEAAkE,EAAE;IACxI,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,uHAAuH,EAAE;CACnL,CAAC;AAEF,MAAM,UAAU,uCAAuC,CAAC,SAA0C;IAChG,OAAO,0CAA0C,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAE,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,gDAAgD,CAC9D,SAAqD;IAErD,OAAO,SAAS,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;AAChE,CAAC"}

package/dist/materials/PhysicalMaterial.d.ts

@@ -0,0 +1,36 @@
+import { type ExternalParityMaterialExtension, type ExternalParityMaterialExtensionState } from "./MaterialExtensions";
+export type ExternalParityMaterialKind = "chrome" | "brushed-metal" | "gold" | "painted-metal" | "matte-plastic" | "glossy-plastic" | "rubber" | "glass-transmission" | "clearcoat-car-paint" | "fabric-sheen" | "emissive" | "textured-ceramic-stone";
+export interface ExternalParityPhysicalMaterialDescriptor {
+    readonly id: ExternalParityMaterialKind;
+    readonly label: string;
+    readonly baseColor: readonly [number, number, number, number];
+    readonly metallic: number;
+    readonly roughness: number;
+    readonly emissive?: readonly [number, number, number];
+    readonly emissiveStrength?: number;
+    readonly normalScale?: number;
+    readonly occlusionStrength?: number;
+    readonly alphaMode?: "opaque" | "mask" | "blend";
+    readonly alphaCutoff?: number;
+    readonly doubleSided?: boolean;
+    readonly extensions: readonly ExternalParityMaterialExtension[];
+    readonly visualGoal: string;
+}
+export interface ExternalParityPhysicalMaterialAnalysis {
+    readonly descriptor: ExternalParityPhysicalMaterialDescriptor;
+    readonly extensionDiagnostics: readonly ExternalParityMaterialExtensionState[];
+    readonly reflectanceClass: "mirror-metal" | "rough-metal" | "dielectric" | "transparent" | "emissive";
+    readonly requiresIbl: boolean;
+    readonly requiresTransmissionPass: boolean;
+    readonly requiresAlphaSorting: boolean;
+    readonly warnings: readonly string[];
+}
+export declare class ExternalParityPhysicalMaterial {
+    readonly descriptor: ExternalParityPhysicalMaterialDescriptor;
+    constructor(descriptor: ExternalParityPhysicalMaterialDescriptor);
+    analyze(): ExternalParityPhysicalMaterialAnalysis;
+}
+export declare const EXTERNAL_PARITY_PHYSICAL_MATERIAL_MATRIX: readonly ExternalParityPhysicalMaterialDescriptor[];
+export declare function createExternalParityPhysicalMaterial(kind: ExternalParityMaterialKind): ExternalParityPhysicalMaterial;
+export declare function analyzeExternalParityMaterialMatrix(): readonly ExternalParityPhysicalMaterialAnalysis[];
+//# sourceMappingURL=PhysicalMaterial.d.ts.map

package/dist/materials/PhysicalMaterial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhysicalMaterial.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/materials/PhysicalMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,oCAAoC,EAC1C,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,0BAA0B,GAClC,QAAQ,GACR,eAAe,GACf,MAAM,GACN,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,QAAQ,GACR,oBAAoB,GACpB,qBAAqB,GACrB,cAAc,GACd,UAAU,GACV,wBAAwB,CAAC;AAE7B,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,EAAE,EAAE,0BAA0B,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,SAAS,+BAA+B,EAAE,CAAC;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,UAAU,EAAE,wCAAwC,CAAC;IAC9D,QAAQ,CAAC,oBAAoB,EAAE,SAAS,oCAAoC,EAAE,CAAC;IAC/E,QAAQ,CAAC,gBAAgB,EAAE,cAAc,GAAG,aAAa,GAAG,YAAY,GAAG,aAAa,GAAG,UAAU,CAAC;IACtG,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,qBAAa,8BAA8B;IACzC,SAAgB,UAAU,EAAE,wCAAwC,CAAC;gBAEzD,UAAU,EAAE,wCAAwC;IAKhE,OAAO,IAAI,sCAAsC;CAoBlD;AAED,eAAO,MAAM,wCAAwC,EAAE,SAAS,wCAAwC,EAavG,CAAC;AAEF,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,0BAA0B,GAAG,8BAA8B,CAIrH;AAED,wBAAgB,mCAAmC,IAAI,SAAS,sCAAsC,EAAE,CAEvG"}

package/dist/materials/PhysicalMaterial.js

@@ -0,0 +1,79 @@
+import { createExternalParityMaterialExtensionDiagnostics } from "./MaterialExtensions.js";
+export class ExternalParityPhysicalMaterial {
+    descriptor;
+    constructor(descriptor) {
+        validateDescriptor(descriptor);
+        this.descriptor = descriptor;
+    }
+    analyze() {
+        const extensionDiagnostics = createExternalParityMaterialExtensionDiagnostics(this.descriptor.extensions);
+        const reflectanceClass = classifyMaterial(this.descriptor);
+        const requiresTransmissionPass = this.descriptor.extensions.includes("transmission") || this.descriptor.id === "glass-transmission";
+        const requiresAlphaSorting = this.descriptor.alphaMode === "blend" || requiresTransmissionPass;
+        const warnings = [
+            ...extensionDiagnostics.filter((entry) => entry.support !== "supported").map((entry) => `${entry.extension}: ${entry.diagnostic}`),
+            ...(this.descriptor.metallic > 0.8 && this.descriptor.roughness < 0.2 ? [] : []),
+            ...(requiresTransmissionPass ? ["Transmission is bounded and must be compared against Three.js before release claims."] : [])
+        ];
+        return {
+            descriptor: this.descriptor,
+            extensionDiagnostics,
+            reflectanceClass,
+            requiresIbl: this.descriptor.metallic > 0 || this.descriptor.extensions.length > 0,
+            requiresTransmissionPass,
+            requiresAlphaSorting,
+            warnings
+        };
+    }
+}
+export const EXTERNAL_PARITY_PHYSICAL_MATERIAL_MATRIX = [
+    material("chrome", "Chrome", [0.92, 0.94, 0.95, 1], 1, 0.04, [], "Mirror-like metal must reflect environment directionally."),
+    material("brushed-metal", "Brushed Metal", [0.78, 0.76, 0.72, 1], 1, 0.32, ["anisotropy"], "Brushed metal must show rough directional response."),
+    material("gold", "Gold", [1, 0.72, 0.28, 1], 1, 0.18, [], "Gold must read as tinted metal, not yellow plastic."),
+    material("painted-metal", "Painted Metal", [0.8, 0.04, 0.03, 1], 0.65, 0.22, ["clearcoat"], "Painted metal must show base color plus coated highlight."),
+    material("matte-plastic", "Matte Plastic", [0.08, 0.1, 0.12, 1], 0, 0.82, [], "Matte plastic must have broad diffuse response."),
+    material("glossy-plastic", "Glossy Plastic", [0.02, 0.28, 0.9, 1], 0, 0.16, ["specular"], "Glossy plastic must show tight dielectric highlights."),
+    material("rubber", "Rubber", [0.01, 0.012, 0.014, 1], 0, 0.92, [], "Rubber must stay dark and rough without metal response."),
+    material("glass-transmission", "Glass / Transmission", [0.82, 0.96, 1, 0.34], 0, 0.02, ["transmission", "volume", "ior"], "Glass must be transparent/transmissive with honest limitations."),
+    material("clearcoat-car-paint", "Clearcoat Car Paint", [0.1, 0.02, 0.018, 1], 0.35, 0.18, ["clearcoat", "specular"], "Car paint must show layered highlight response."),
+    material("fabric-sheen", "Fabric / Sheen", [0.55, 0.28, 0.9, 1], 0, 0.72, ["sheen"], "Fabric must show soft grazing-angle sheen."),
+    material("emissive", "Emissive", [0.04, 0.04, 0.04, 1], 0, 0.45, ["emissive-strength"], "Emissive material must pass through HDR tone mapping and bloom evidence.", [1, 0.45, 0.12], 4),
+    material("textured-ceramic-stone", "Textured Ceramic / Stone", [0.62, 0.58, 0.52, 1], 0, 0.58, ["texture-transform", "multi-uv"], "Stone/ceramic must show texture, normal, and roughness detail.")
+];
+export function createExternalParityPhysicalMaterial(kind) {
+    const descriptor = EXTERNAL_PARITY_PHYSICAL_MATERIAL_MATRIX.find((entry) => entry.id === kind);
+    if (!descriptor)
+        throw new Error(`Unknown ExternalParity material kind: ${kind}`);
+    return new ExternalParityPhysicalMaterial(descriptor);
+}
+export function analyzeExternalParityMaterialMatrix() {
+    return EXTERNAL_PARITY_PHYSICAL_MATERIAL_MATRIX.map((descriptor) => new ExternalParityPhysicalMaterial(descriptor).analyze());
+}
+function material(id, label, baseColor, metallic, roughness, extensions, visualGoal, emissive, emissiveStrength) {
+    return { id, label, baseColor, metallic, roughness, extensions, visualGoal, ...(emissive ? { emissive } : {}), ...(emissiveStrength ? { emissiveStrength } : {}), ...(id === "glass-transmission" ? { alphaMode: "blend", doubleSided: true } : {}) };
+}
+function validateDescriptor(descriptor) {
+    if (!descriptor.id || !descriptor.label)
+        throw new Error("ExternalParity physical material requires id and label.");
+    if (descriptor.baseColor.length !== 4 || descriptor.baseColor.some((value) => !Number.isFinite(value) || value < 0 || value > 1)) {
+        throw new Error(`ExternalParity physical material ${descriptor.id} has invalid baseColor.`);
+    }
+    if (!Number.isFinite(descriptor.metallic) || descriptor.metallic < 0 || descriptor.metallic > 1)
+        throw new Error(`ExternalParity physical material ${descriptor.id} has invalid metallic.`);
+    if (!Number.isFinite(descriptor.roughness) || descriptor.roughness < 0 || descriptor.roughness > 1)
+        throw new Error(`ExternalParity physical material ${descriptor.id} has invalid roughness.`);
+}
+function classifyMaterial(descriptor) {
+    if ((descriptor.emissiveStrength ?? 0) > 0)
+        return "emissive";
+    if (descriptor.extensions.includes("transmission"))
+        return "transparent";
+    if (descriptor.metallic > 0.8 && descriptor.roughness < 0.18)
+        return "mirror-metal";
+    if (descriptor.extensions.includes("clearcoat") && descriptor.metallic >= 0.3)
+        return "rough-metal";
+    if (descriptor.metallic > 0.5)
+        return "rough-metal";
+    return "dielectric";
+}
+//# sourceMappingURL=PhysicalMaterial.js.map

package/dist/materials/PhysicalMaterial.js.map

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

package/dist/materials/TransmissionPass.d.ts

@@ -0,0 +1,16 @@
+export interface ExternalParityTransmissionSample {
+    readonly baseColor: readonly [number, number, number];
+    readonly thickness: number;
+    readonly attenuationColor: readonly [number, number, number];
+    readonly attenuationDistance: number;
+    readonly ior: number;
+    readonly intensity: number;
+}
+export interface ExternalParityTransmissionResult {
+    readonly transmittedColor: readonly [number, number, number];
+    readonly displayColor: readonly [number, number, number];
+    readonly bounded: true;
+    readonly diagnostic: string;
+}
+export declare function evaluateExternalParityTransmission(sample: ExternalParityTransmissionSample): ExternalParityTransmissionResult;
+//# sourceMappingURL=TransmissionPass.d.ts.map

package/dist/materials/TransmissionPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransmissionPass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/materials/TransmissionPass.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7D,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7D,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,gCAAgC,GAAG,gCAAgC,CAqB7H"}

package/dist/materials/TransmissionPass.js

@@ -0,0 +1,30 @@
+import { createExternalParityToneMappingPolicy, toneMapExternalParityHdrPixels } from "../ToneMapping.js";
+export function evaluateExternalParityTransmission(sample) {
+    validateSample(sample);
+    const attenuation = Math.exp(-sample.thickness / Math.max(0.0001, sample.attenuationDistance));
+    const fresnelScale = Math.max(0, Math.min(1, (sample.ior - 1) / (sample.ior + 1)));
+    const transmitted = [
+        sample.baseColor[0] * sample.attenuationColor[0] * attenuation * sample.intensity * (1 - fresnelScale),
+        sample.baseColor[1] * sample.attenuationColor[1] * attenuation * sample.intensity * (1 - fresnelScale),
+        sample.baseColor[2] * sample.attenuationColor[2] * attenuation * sample.intensity * (1 - fresnelScale)
+    ];
+    const toneMapped = toneMapExternalParityHdrPixels(new Float32Array([transmitted[0], transmitted[1], transmitted[2], 1]), 1, 1, createExternalParityToneMappingPolicy("material-review", { operator: "reinhard", exposure: 1, gamma: 1, outputColorSpace: "srgb" }));
+    return {
+        transmittedColor: transmitted.map(round),
+        displayColor: [toneMapped.pixels[0], toneMapped.pixels[1], toneMapped.pixels[2]],
+        bounded: true,
+        diagnostic: "Bounded transmission approximation for material review; full refraction/caustics parity is not claimed."
+    };
+}
+function validateSample(sample) {
+    if (sample.baseColor.length !== 3 || sample.attenuationColor.length !== 3)
+        throw new Error("Transmission colors must be RGB tuples.");
+    for (const value of [...sample.baseColor, ...sample.attenuationColor, sample.thickness, sample.attenuationDistance, sample.ior, sample.intensity]) {
+        if (!Number.isFinite(value) || value < 0)
+            throw new Error("Transmission sample values must be finite and non-negative.");
+    }
+}
+function round(value) {
+    return Number(value.toFixed(6));
+}
+//# sourceMappingURL=TransmissionPass.js.map

package/dist/materials/TransmissionPass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransmissionPass.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/materials/TransmissionPass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAkBvG,MAAM,UAAU,kCAAkC,CAAC,MAAwC;IACzF,cAAc,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC/F,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,WAAW,GAA6B;QAC5C,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC;QACtG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC;QACtG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC;KACvG,CAAC;IACF,MAAM,UAAU,GAAG,8BAA8B,CAC/C,IAAI,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EACrE,CAAC,EACD,CAAC,EACD,qCAAqC,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CACpI,CAAC;IACF,OAAO;QACL,gBAAgB,EAAE,WAAW,CAAC,GAAG,CAAC,KAAK,CAA6B;QACpE,YAAY,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAE,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAE,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;QACnF,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,yGAAyG;KACtH,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,MAAwC;IAC9D,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACtI,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAClJ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IAC3H,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/dist/performance/BVH.d.ts

@@ -0,0 +1,3 @@
+export { buildStaticBoundsBvh, queryStaticBoundsBvh, raycastStaticBoundsBvh, updateStaticBoundsBvh } from "../SceneOptimization";
+export type { StaticBoundsBvh, StaticBoundsBvhBuildDiagnostics, StaticBoundsBvhNode, StaticBoundsBvhQueryOptions, StaticBoundsBvhQueryResult, StaticBoundsBvhRaycastHit, StaticBoundsBvhRaycastResult, StaticBoundsBvhTraversalDiagnostics, StaticSpatialBounds, StaticSpatialItem } from "../SceneOptimization";
+//# sourceMappingURL=BVH.d.ts.map

package/dist/performance/BVH.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BVH.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/BVH.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,+BAA+B,EAC/B,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,4BAA4B,EAC5B,mCAAmC,EACnC,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC"}

package/dist/performance/BVH.js

@@ -0,0 +1,2 @@
+export { buildStaticBoundsBvh, queryStaticBoundsBvh, raycastStaticBoundsBvh, updateStaticBoundsBvh } from "../SceneOptimization.js";
+//# sourceMappingURL=BVH.js.map

package/dist/performance/BVH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BVH.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/BVH.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC"}

package/dist/performance/Batcher.d.ts

@@ -0,0 +1,3 @@
+export { batchStaticRenderItems } from "../SceneOptimization";
+export type { StaticBatchInput, StaticBatchOptions, StaticBatchResult } from "../SceneOptimization";
+//# sourceMappingURL=Batcher.d.ts.map

package/dist/performance/Batcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Batcher.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/Batcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/performance/Batcher.js

@@ -0,0 +1,2 @@
+export { batchStaticRenderItems } from "../SceneOptimization.js";
+//# sourceMappingURL=Batcher.js.map

package/dist/performance/Batcher.js.map

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

package/dist/performance/FrustumCuller.d.ts

@@ -0,0 +1,3 @@
+import type { StaticBoundsIntersector, StaticSpatialItem } from "../SceneOptimization";
+export declare function cullStaticItems<T>(items: readonly StaticSpatialItem<T>[], frustum: StaticBoundsIntersector): readonly StaticSpatialItem<T>[];
+//# sourceMappingURL=FrustumCuller.d.ts.map

package/dist/performance/FrustumCuller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrustumCuller.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/FrustumCuller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEvF,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,uBAAuB,GAAG,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAK5I"}

package/dist/performance/FrustumCuller.js

@@ -0,0 +1,5 @@
+import { Box3, Vector3 } from "@aura3d/math";
+export function cullStaticItems(items, frustum) {
+    return items.filter((item) => frustum.intersectsBox(new Box3(new Vector3(item.bounds.min[0], item.bounds.min[1], item.bounds.min[2]), new Vector3(item.bounds.max[0], item.bounds.max[1], item.bounds.max[2]))));
+}
+//# sourceMappingURL=FrustumCuller.js.map

package/dist/performance/FrustumCuller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrustumCuller.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/FrustumCuller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG7C,MAAM,UAAU,eAAe,CAAI,KAAsC,EAAE,OAAgC;IACzG,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,IAAI,CAC1D,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EACvE,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CACxE,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/performance/LOD.d.ts

@@ -0,0 +1,8 @@
+export interface PerformanceLodLevel {
+    readonly id: string;
+    readonly maxDistance: number;
+    readonly triangleBudget: number;
+}
+export declare function selectPerformanceLodLevel(levels: readonly PerformanceLodLevel[], distance: number): PerformanceLodLevel;
+export declare function createDefaultPerformanceLodLevels(baseTriangles: number): readonly PerformanceLodLevel[];
+//# sourceMappingURL=LOD.d.ts.map

package/dist/performance/LOD.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LOD.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/LOD.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAIvH;AAED,wBAAgB,iCAAiC,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,mBAAmB,EAAE,CAOvG"}

package/dist/performance/LOD.js

@@ -0,0 +1,15 @@
+export function selectPerformanceLodLevel(levels, distance) {
+    if (levels.length === 0)
+        throw new Error("selectPerformanceLodLevel requires at least one LOD level.");
+    const sorted = [...levels].sort((a, b) => a.maxDistance - b.maxDistance);
+    return sorted.find((level) => distance <= level.maxDistance) ?? sorted[sorted.length - 1];
+}
+export function createDefaultPerformanceLodLevels(baseTriangles) {
+    const triangles = Math.max(1, Math.floor(baseTriangles));
+    return [
+        { id: "lod0", maxDistance: 8, triangleBudget: triangles },
+        { id: "lod1", maxDistance: 20, triangleBudget: Math.max(1, Math.floor(triangles * 0.45)) },
+        { id: "lod2", maxDistance: Number.POSITIVE_INFINITY, triangleBudget: Math.max(1, Math.floor(triangles * 0.16)) }
+    ];
+}
+//# sourceMappingURL=LOD.js.map

package/dist/performance/LOD.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LOD.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/LOD.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,yBAAyB,CAAC,MAAsC,EAAE,QAAgB;IAChG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IACvG,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,aAAqB;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;IACzD,OAAO;QACL,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE;QACzD,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,EAAE;QAC1F,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,iBAAiB,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,EAAE;KACjH,CAAC;AACJ,CAAC"}

package/dist/performance/Octree.d.ts

@@ -0,0 +1,7 @@
+import type { StaticSpatialBounds, StaticSpatialItem } from "../SceneOptimization";
+export interface OctreeNode<T = unknown> {
+    readonly bounds: StaticSpatialBounds;
+    readonly items: readonly StaticSpatialItem<T>[];
+}
+export declare function createFlatOctree<T>(bounds: StaticSpatialBounds, items: readonly StaticSpatialItem<T>[]): OctreeNode<T>;
+//# sourceMappingURL=Octree.d.ts.map

package/dist/performance/Octree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Octree.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/Octree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEnF,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;CACjD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,KAAK,EAAE,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAEtH"}

package/dist/performance/Octree.js

@@ -0,0 +1,4 @@
+export function createFlatOctree(bounds, items) {
+    return { bounds, items };
+}
+//# sourceMappingURL=Octree.js.map

package/dist/performance/Octree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Octree.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/Octree.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,gBAAgB,CAAI,MAA2B,EAAE,KAAsC;IACrG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/performance/RenderItemSorting.d.ts

@@ -0,0 +1,43 @@
+export type RenderQueueBucket = "opaque" | "mask" | "transparent";
+export interface RenderQueueSortItem<T = unknown> {
+    readonly item: T;
+    readonly bucket: RenderQueueBucket;
+    readonly depth: number;
+    readonly pipelineKey?: string;
+    readonly batchKey?: string;
+    readonly instanceCount?: number;
+    readonly renderOrder?: number;
+}
+export interface RenderQueueSortOptions {
+    readonly transparentBackToFront?: boolean;
+    readonly opaqueFrontToBack?: boolean;
+    readonly groupOpaqueByPipeline?: boolean;
+}
+export interface RenderQueuePlan<T = unknown> {
+    readonly items: readonly T[];
+    readonly diagnostics: RenderQueueSortDiagnostics;
+}
+export interface RenderQueueSortDiagnostics {
+    readonly total: number;
+    readonly objectCount: number;
+    readonly estimatedDrawCalls: number;
+    readonly totalInstances: number;
+    readonly batchableGroups: number;
+    readonly largestBatch: number;
+    readonly materialSwitches: number;
+    readonly opaqueCount: number;
+    readonly maskedCount: number;
+    readonly transparentCount: number;
+    readonly pipelineTransitions: number;
+    readonly opaqueFrontToBack: boolean;
+    readonly transparentBackToFront: boolean;
+}
+export declare function sortRenderQueueItems<T>(items: readonly RenderQueueSortItem<T>[], options?: RenderQueueSortOptions): RenderQueuePlan<T>;
+export interface SortableRenderItem {
+    readonly id: string;
+    readonly materialBucket: RenderQueueBucket;
+    readonly pipelineKey: string;
+    readonly depth: number;
+}
+export declare function sortRenderItems(items: readonly SortableRenderItem[]): SortableRenderItem[];
+//# sourceMappingURL=RenderItemSorting.d.ts.map

package/dist/performance/RenderItemSorting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderItemSorting.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/RenderItemSorting.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,GAAG,aAAa,CAAC;AAElE,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC;CAClD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;CAC1C;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,KAAK,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,EAAE,EACxC,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAAC,CAAC,CAAC,CA8CpB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAO1F"}

package/dist/performance/RenderItemSorting.js

@@ -0,0 +1,111 @@
+export function sortRenderQueueItems(items, options = {}) {
+    const opaqueFrontToBack = options.opaqueFrontToBack ?? true;
+    const transparentBackToFront = options.transparentBackToFront ?? true;
+    const groupOpaqueByPipeline = options.groupOpaqueByPipeline ?? false;
+    const decorated = items.map((entry, index) => {
+        validateRenderQueueItem(entry, index);
+        return { ...entry, index };
+    });
+    decorated.sort((left, right) => {
+        const orderDelta = (left.renderOrder ?? 0) - (right.renderOrder ?? 0);
+        if (orderDelta !== 0)
+            return orderDelta;
+        const bucketDelta = bucketRank(left.bucket) - bucketRank(right.bucket);
+        if (bucketDelta !== 0)
+            return bucketDelta;
+        if (left.bucket === "transparent" || right.bucket === "transparent") {
+            if (transparentBackToFront) {
+                const depthDelta = right.depth - left.depth;
+                if (Math.abs(depthDelta) > 1e-6)
+                    return depthDelta;
+            }
+            return left.index - right.index;
+        }
+        if (groupOpaqueByPipeline) {
+            const pipelineDelta = pipelineKey(left).localeCompare(pipelineKey(right));
+            if (pipelineDelta !== 0)
+                return pipelineDelta;
+        }
+        if (opaqueFrontToBack) {
+            const depthDelta = left.depth - right.depth;
+            if (Math.abs(depthDelta) > 1e-6)
+                return depthDelta;
+        }
+        if (!groupOpaqueByPipeline) {
+            const pipelineDelta = pipelineKey(left).localeCompare(pipelineKey(right));
+            if (pipelineDelta !== 0 && Math.abs(left.depth - right.depth) <= 1e-6)
+                return pipelineDelta;
+        }
+        return left.index - right.index;
+    });
+    return {
+        items: decorated.map((entry) => entry.item),
+        diagnostics: buildDiagnostics(decorated, opaqueFrontToBack, transparentBackToFront)
+    };
+}
+export function sortRenderItems(items) {
+    return [...sortRenderQueueItems(items.map((item) => ({
+            item,
+            bucket: item.materialBucket,
+            pipelineKey: item.pipelineKey,
+            depth: item.depth
+        })), { groupOpaqueByPipeline: true }).items];
+}
+function bucketRank(bucket) {
+    if (bucket === "opaque")
+        return 0;
+    if (bucket === "mask")
+        return 1;
+    return 2;
+}
+function validateRenderQueueItem(item, index) {
+    if (!Number.isFinite(item.depth)) {
+        throw new RangeError(`Render queue item ${index} depth must be finite.`);
+    }
+    if (item.renderOrder !== undefined && !Number.isFinite(item.renderOrder)) {
+        throw new RangeError(`Render queue item ${index} renderOrder must be finite.`);
+    }
+    if (item.instanceCount !== undefined && (!Number.isInteger(item.instanceCount) || item.instanceCount <= 0)) {
+        throw new RangeError(`Render queue item ${index} instanceCount must be a positive integer.`);
+    }
+}
+function pipelineKey(item) {
+    return item.pipelineKey ?? "";
+}
+function buildDiagnostics(items, opaqueFrontToBack, transparentBackToFront) {
+    let pipelineTransitions = 0;
+    let previousPipeline;
+    const batchGroups = new Map();
+    let totalInstances = 0;
+    for (const item of items) {
+        const key = pipelineKey(item);
+        if (previousPipeline !== undefined && previousPipeline !== key)
+            pipelineTransitions += 1;
+        previousPipeline = key;
+        const instances = item.instanceCount ?? 1;
+        totalInstances += instances;
+        const batchKey = item.batchKey ?? key;
+        if (batchKey) {
+            batchGroups.set(batchKey, (batchGroups.get(batchKey) ?? 0) + 1);
+        }
+    }
+    const batchSizes = [...batchGroups.values()];
+    const batchableGroups = batchSizes.filter((size) => size > 1).length;
+    const largestBatch = batchSizes.length > 0 ? Math.max(...batchSizes) : 0;
+    return {
+        total: items.length,
+        objectCount: items.length,
+        estimatedDrawCalls: items.length,
+        totalInstances,
+        batchableGroups,
+        largestBatch,
+        materialSwitches: pipelineTransitions,
+        opaqueCount: items.filter((item) => item.bucket === "opaque").length,
+        maskedCount: items.filter((item) => item.bucket === "mask").length,
+        transparentCount: items.filter((item) => item.bucket === "transparent").length,
+        pipelineTransitions,
+        opaqueFrontToBack,
+        transparentBackToFront
+    };
+}
+//# sourceMappingURL=RenderItemSorting.js.map

package/dist/performance/RenderItemSorting.js.map

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

package/dist/performance/RendererStats.d.ts

@@ -0,0 +1,23 @@
+export interface RendererStatsInput {
+    readonly objectCount: number;
+    readonly visibleObjectCount: number;
+    readonly drawCalls: number;
+    readonly triangles?: number;
+    readonly cpuFrameMs?: number;
+    readonly gpuFrameMs?: number;
+    readonly textureMemoryBytes?: number;
+    readonly warnings?: readonly string[];
+}
+export interface RendererStats {
+    readonly objectCount: number;
+    readonly visibleObjectCount: number;
+    readonly culledObjectCount: number;
+    readonly drawCalls: number;
+    readonly triangles: number;
+    readonly cpuFrameMs: number;
+    readonly gpuFrameMs?: number;
+    readonly textureMemoryBytes: number;
+    readonly warnings: readonly string[];
+}
+export declare function createRendererStats(input: RendererStatsInput): RendererStats;
+//# sourceMappingURL=RendererStats.d.ts.map

package/dist/performance/RendererStats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RendererStats.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/RendererStats.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAmB5E"}

package/dist/performance/RendererStats.js

@@ -0,0 +1,23 @@
+export function createRendererStats(input) {
+    const objectCount = Math.max(0, Math.floor(input.objectCount));
+    const visibleObjectCount = Math.max(0, Math.min(objectCount, Math.floor(input.visibleObjectCount)));
+    const drawCalls = Math.max(0, Math.floor(input.drawCalls));
+    const textureMemoryBytes = Math.max(0, Math.floor(input.textureMemoryBytes ?? 0));
+    const warnings = [...(input.warnings ?? [])];
+    if (drawCalls > 500)
+        warnings.push("draw-call-count-high");
+    if (textureMemoryBytes > 512 * 1024 * 1024)
+        warnings.push("texture-memory-budget-high");
+    return {
+        objectCount,
+        visibleObjectCount,
+        culledObjectCount: objectCount - visibleObjectCount,
+        drawCalls,
+        triangles: Math.max(0, Math.floor(input.triangles ?? 0)),
+        cpuFrameMs: Math.max(0, input.cpuFrameMs ?? 0),
+        ...(input.gpuFrameMs === undefined ? {} : { gpuFrameMs: Math.max(0, input.gpuFrameMs) }),
+        textureMemoryBytes,
+        warnings
+    };
+}
+//# sourceMappingURL=RendererStats.js.map

package/dist/performance/RendererStats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RendererStats.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/RendererStats.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/D,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACpG,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3D,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,IAAI,SAAS,GAAG,GAAG;QAAE,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC3D,IAAI,kBAAkB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI;QAAE,QAAQ,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACxF,OAAO;QACL,WAAW;QACX,kBAAkB;QAClB,iBAAiB,EAAE,WAAW,GAAG,kBAAkB;QACnD,SAAS;QACT,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;QACxD,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;QAC9C,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACxF,kBAAkB;QAClB,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/performance/ResourceBudget.d.ts

@@ -0,0 +1,19 @@
+export interface ResourceBudget {
+    readonly textureBudgetBytes: number;
+    readonly geometryBudgetBytes: number;
+    readonly drawCallBudget: number;
+}
+export interface ResourceBudgetUsage {
+    readonly textureBytes: number;
+    readonly geometryBytes: number;
+    readonly drawCalls: number;
+}
+export interface ResourceBudgetReport {
+    readonly withinBudget: boolean;
+    readonly texturePercent: number;
+    readonly geometryPercent: number;
+    readonly drawCallPercent: number;
+    readonly warnings: readonly string[];
+}
+export declare function evaluateResourceBudget(budget: ResourceBudget, usage: ResourceBudgetUsage): ResourceBudgetReport;
+//# sourceMappingURL=ResourceBudget.d.ts.map

package/dist/performance/ResourceBudget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceBudget.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/ResourceBudget.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,mBAAmB,GACzB,oBAAoB,CAgBtB"}