@aura3d/debug 1.0.6

package/README.md

@@ -0,0 +1,17 @@
+# @aura3d/debug
+
+`@aura3d/debug` owns diagnostics helpers for rendering, materials, shaders, physics, animation, ECS, profiling, resource leaks, overlays, line rendering, and report export.
+
+## Public API
+
+- `DrawCallTracker`, `RenderStateInspector`: draw-call recording and render-state leak detection.
+- `ShaderDiagnostics`, `MaterialDiagnostics`: shader-source and material-binding validation with structured errors.
+- `PhysicsDebugAdapter`, `AnimationInspector`, `ECSInspector`: snapshot and evidence adapters for runtime subsystems.
+- `Profiler`, `GPUProfiler`, `ChromeTraceExporter`: CPU marker snapshots, GPU timer abstractions, and deterministic Chrome trace export for bounded local profiling evidence.
+- `ResourceTracker`: leak detection for tracked runtime resources.
+- `DebugOverlay`, `DebugLineCanvasRenderer`: browser-visible overlay rows and debug line drawing.
+- `ReportExporter`: deterministic debug report serialization.
+
+## Verification
+
+Debug runtime behavior, render diagnostics, shader/material validation, physics/animation evidence, Chrome trace export, overlay rendering, and browser debug pixels are covered by `tests/unit/debug/debug-runtime.test.ts`, `tests/unit/debug/rendering-diagnostics.test.ts`, `tests/unit/workstream4.physics-animation.test.ts`, and `tests/browser/debug-browser.spec.ts`. Export and import consistency is covered by `pnpm verify:exports` and `pnpm verify:imports`.

package/dist/AnimationInspector.d.ts

@@ -0,0 +1,25 @@
+import type { AnimationMixer, AnimationMixerSnapshot, Skeleton } from "@aura3d/animation";
+export type SkeletonDebugSnapshot = {
+    readonly boneCount: number;
+    readonly boneNames: readonly string[];
+    readonly paletteMatrixCount: number;
+};
+export type AnimationDebugSnapshot = {
+    readonly mixer: AnimationMixerSnapshot;
+    readonly skeleton?: SkeletonDebugSnapshot;
+};
+export type AnimationVisualEvidence = {
+    readonly actionCount: number;
+    readonly playingActionCount: number;
+    readonly sampledTargetCount: number;
+    readonly sampledTargets: readonly string[];
+    readonly skeletonBoneCount: number;
+    readonly paletteMatrixCount: number;
+    readonly paletteHash?: string;
+    readonly stableHash: string;
+};
+export declare class AnimationInspector {
+    snapshot(mixer: Pick<AnimationMixer, "snapshot">, skeleton?: Skeleton): AnimationDebugSnapshot;
+    visualEvidence(mixer: Pick<AnimationMixer, "snapshot">, skeleton?: Skeleton): AnimationVisualEvidence;
+}
+//# sourceMappingURL=AnimationInspector.d.ts.map

package/dist/AnimationInspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationInspector.d.ts","sourceRoot":"","sources":["../../../../packages/debug/src/AnimationInspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE1F,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,sBAAsB;IAiB9F,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,uBAAuB;CAkBtG"}

package/dist/AnimationInspector.js

@@ -0,0 +1,46 @@
+export class AnimationInspector {
+    snapshot(mixer, skeleton) {
+        const snapshot = {
+            mixer: mixer.snapshot()
+        };
+        if (skeleton) {
+            return {
+                ...snapshot,
+                skeleton: {
+                    boneCount: skeleton.bones.length,
+                    boneNames: skeleton.bones.map((bone) => bone.name),
+                    paletteMatrixCount: skeleton.matrixPalette().length
+                }
+            };
+        }
+        return snapshot;
+    }
+    visualEvidence(mixer, skeleton) {
+        const snapshot = mixer.snapshot();
+        const sampledTargets = Object.keys(snapshot.values).sort();
+        const palette = skeleton?.matrixPalette();
+        const evidenceWithoutHash = {
+            actionCount: snapshot.actionCount,
+            playingActionCount: snapshot.actions.filter((action) => action.playing).length,
+            sampledTargetCount: sampledTargets.length,
+            sampledTargets,
+            skeletonBoneCount: skeleton?.bones.length ?? 0,
+            paletteMatrixCount: palette?.length ?? 0,
+            ...(palette ? { paletteHash: stableHash(palette.map((matrix) => matrix.map((value) => Number(value.toFixed(6))))) } : {})
+        };
+        return {
+            ...evidenceWithoutHash,
+            stableHash: stableHash(evidenceWithoutHash)
+        };
+    }
+}
+function stableHash(value) {
+    const input = JSON.stringify(value);
+    let hash = 2166136261;
+    for (let index = 0; index < input.length; index += 1) {
+        hash ^= input.charCodeAt(index);
+        hash = Math.imul(hash, 16777619);
+    }
+    return (hash >>> 0).toString(16).padStart(8, "0");
+}
+//# sourceMappingURL=AnimationInspector.js.map

package/dist/AnimationInspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationInspector.js","sourceRoot":"","sources":["../../../../packages/debug/src/AnimationInspector.ts"],"names":[],"mappings":"AAwBA,MAAM,OAAO,kBAAkB;IAC7B,QAAQ,CAAC,KAAuC,EAAE,QAAmB;QACnE,MAAM,QAAQ,GAA2B;YACvC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE;SACxB,CAAC;QACF,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;gBACL,GAAG,QAAQ;gBACX,QAAQ,EAAE;oBACV,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;oBAChC,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;oBAClD,kBAAkB,EAAE,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM;iBAClD;aACF,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,cAAc,CAAC,KAAuC,EAAE,QAAmB;QACzE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,QAAQ,EAAE,aAAa,EAAE,CAAC;QAC1C,MAAM,mBAAmB,GAAG;YAC1B,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,kBAAkB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM;YAC9E,kBAAkB,EAAE,cAAc,CAAC,MAAM;YACzC,cAAc;YACd,iBAAiB,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC;YAC9C,kBAAkB,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;YACxC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1H,CAAC;QACF,OAAO;YACL,GAAG,mBAAmB;YACtB,UAAU,EAAE,UAAU,CAAC,mBAAmB,CAAC;SAC5C,CAAC;IACJ,CAAC;CACF;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACpD,CAAC"}

package/dist/ChromeTraceExporter.d.ts

@@ -0,0 +1,35 @@
+import type { ProfilerSnapshot } from "./Profiler.js";
+import type { GPUProfilerSnapshot } from "./GPUProfiler.js";
+export interface ChromeTraceEvent {
+    readonly name: string;
+    readonly cat: string;
+    readonly ph: "M" | "X" | "C" | "i";
+    readonly ts: number;
+    readonly pid: number;
+    readonly tid: number;
+    readonly dur?: number;
+    readonly args?: Record<string, number | string | boolean | null>;
+}
+export interface ChromeTrace {
+    readonly traceEvents: readonly ChromeTraceEvent[];
+    readonly displayTimeUnit: "ms";
+    readonly metadata: {
+        readonly source: "aura3d-debug-chrome-trace-exporter";
+        readonly profileName: string;
+        readonly cpuMarkerCount: number;
+        readonly gpuSampleCount: number;
+        readonly claimBoundary: string;
+    };
+}
+export interface ChromeTraceExportOptions {
+    readonly profileName?: string;
+    readonly processId?: number;
+    readonly cpuThreadId?: number;
+    readonly gpuThreadId?: number;
+    readonly includeCounters?: boolean;
+}
+export declare class ChromeTraceExporter {
+    static create(cpu: ProfilerSnapshot, gpu?: GPUProfilerSnapshot, options?: ChromeTraceExportOptions): ChromeTrace;
+    static toJson(trace: ChromeTrace): string;
+}
+//# sourceMappingURL=ChromeTraceExporter.d.ts.map

package/dist/ChromeTraceExporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChromeTraceExporter.d.ts","sourceRoot":"","sources":["../../../../packages/debug/src/ChromeTraceExporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,KAAK,EAAa,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,MAAM,EAAE,oCAAoC,CAAC;QACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;KAChC,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,gBAAgB,EACrB,GAAG,CAAC,EAAE,mBAAmB,EACzB,OAAO,GAAE,wBAA6B,GACrC,WAAW;IA8Dd,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;CAG1C"}

package/dist/ChromeTraceExporter.js

@@ -0,0 +1,110 @@
+export class ChromeTraceExporter {
+    static create(cpu, gpu, options = {}) {
+        const profileName = options.profileName?.trim() || "Aura3D profile";
+        const processId = positiveInteger(options.processId, 1);
+        const cpuThreadId = positiveInteger(options.cpuThreadId, 1);
+        const gpuThreadId = positiveInteger(options.gpuThreadId, 2);
+        const events = [
+            metadataEvent("process_name", processId, cpuThreadId, { name: "Aura3D" }),
+            metadataEvent("thread_name", processId, cpuThreadId, { name: "CPU" }),
+            metadataEvent("thread_name", processId, gpuThreadId, { name: "GPU" })
+        ];
+        for (const marker of cpu.markers) {
+            events.push(cpuMarkerEvent(marker, processId, cpuThreadId));
+        }
+        if (gpu) {
+            for (const sample of gpu.samples) {
+                events.push(gpuSampleEvent(sample, processId, gpuThreadId));
+            }
+            if (gpu.supported === false) {
+                events.push({
+                    name: "gpu_timing_unavailable",
+                    cat: "gpu",
+                    ph: "i",
+                    ts: 0,
+                    pid: processId,
+                    tid: gpuThreadId,
+                    args: { reason: gpu.unavailableReason ?? "GPU timing unavailable" }
+                });
+            }
+        }
+        if (options.includeCounters !== false) {
+            events.push({
+                name: "profile_counters",
+                cat: "counters",
+                ph: "C",
+                ts: 0,
+                pid: processId,
+                tid: cpuThreadId,
+                args: {
+                    cpuMarkerCount: cpu.markerCount,
+                    cpuTotalDurationMs: fixed(cpu.totalDurationMs),
+                    gpuSampleCount: gpu?.sampleCount ?? 0,
+                    gpuSupported: gpu?.supported ?? false
+                }
+            });
+        }
+        return {
+            traceEvents: events,
+            displayTimeUnit: "ms",
+            metadata: {
+                source: "aura3d-debug-chrome-trace-exporter",
+                profileName,
+                cpuMarkerCount: cpu.markerCount,
+                gpuSampleCount: gpu?.sampleCount ?? 0,
+                claimBoundary: "Chrome trace export is bounded local profiling evidence; it is not Unity/Unreal profiler parity."
+            }
+        };
+    }
+    static toJson(trace) {
+        return `${JSON.stringify(trace, null, 2)}\n`;
+    }
+}
+function metadataEvent(name, pid, tid, args) {
+    return {
+        name,
+        cat: "__metadata",
+        ph: "M",
+        ts: 0,
+        pid,
+        tid,
+        args
+    };
+}
+function cpuMarkerEvent(marker, pid, tid) {
+    return {
+        name: marker.name,
+        cat: "cpu",
+        ph: "X",
+        ts: millisecondsToMicroseconds(marker.startMs),
+        dur: millisecondsToMicroseconds(marker.durationMs),
+        pid,
+        tid,
+        args: {
+            depth: marker.depth,
+            endMs: fixed(marker.endMs)
+        }
+    };
+}
+function gpuSampleEvent(sample, pid, tid) {
+    return {
+        name: sample.label,
+        cat: "gpu",
+        ph: "X",
+        ts: 0,
+        dur: millisecondsToMicroseconds(sample.durationMs),
+        pid,
+        tid,
+        args: { durationMs: fixed(sample.durationMs) }
+    };
+}
+function millisecondsToMicroseconds(value) {
+    return Math.max(0, Math.round(value * 1_000));
+}
+function positiveInteger(value, fallback) {
+    return Number.isInteger(value) && Number(value) > 0 ? Number(value) : fallback;
+}
+function fixed(value) {
+    return Number(value.toFixed(4));
+}
+//# sourceMappingURL=ChromeTraceExporter.js.map

package/dist/ChromeTraceExporter.js.map

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

package/dist/DebugLineCanvasRenderer.d.ts

@@ -0,0 +1,24 @@
+export interface DebugRenderLine {
+    readonly from: readonly [number, number, number];
+    readonly to: readonly [number, number, number];
+    readonly color: readonly [number, number, number, number];
+}
+export interface DebugLineCanvasRendererOptions {
+    readonly scale?: number;
+    readonly origin?: readonly [number, number];
+    readonly axis?: "xy" | "xz";
+    readonly lineWidth?: number;
+}
+export interface DebugLineCanvasRenderResult {
+    readonly lineCount: number;
+    readonly bounds: {
+        readonly minX: number;
+        readonly minY: number;
+        readonly maxX: number;
+        readonly maxY: number;
+    };
+}
+export declare class DebugLineCanvasRenderer {
+    render(context: CanvasRenderingContext2D, lines: readonly DebugRenderLine[], options?: DebugLineCanvasRendererOptions): DebugLineCanvasRenderResult;
+}
+//# sourceMappingURL=DebugLineCanvasRenderer.d.ts.map

package/dist/DebugLineCanvasRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugLineCanvasRenderer.d.ts","sourceRoot":"","sources":["../../../../packages/debug/src/DebugLineCanvasRenderer.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,qBAAa,uBAAuB;IAClC,MAAM,CACJ,OAAO,EAAE,wBAAwB,EACjC,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,OAAO,GAAE,8BAAmC,GAC3C,2BAA2B;CAuC/B"}

package/dist/DebugLineCanvasRenderer.js

@@ -0,0 +1,58 @@
+export class DebugLineCanvasRenderer {
+    render(context, lines, options = {}) {
+        const scale = options.scale ?? 1;
+        if (!Number.isFinite(scale) || scale <= 0) {
+            throw new RangeError("Debug line canvas scale must be a finite positive number.");
+        }
+        const origin = options.origin ?? [0, 0];
+        const axis = options.axis ?? "xy";
+        const lineWidth = options.lineWidth ?? 1;
+        if (!Number.isFinite(lineWidth) || lineWidth <= 0) {
+            throw new RangeError("Debug line canvas width must be a finite positive number.");
+        }
+        const bounds = {
+            minX: Number.POSITIVE_INFINITY,
+            minY: Number.POSITIVE_INFINITY,
+            maxX: Number.NEGATIVE_INFINITY,
+            maxY: Number.NEGATIVE_INFINITY
+        };
+        context.save();
+        context.lineWidth = lineWidth;
+        for (const line of lines) {
+            const from = project(line.from, axis, scale, origin);
+            const to = project(line.to, axis, scale, origin);
+            include(bounds, from);
+            include(bounds, to);
+            context.strokeStyle = rgba(line.color);
+            context.beginPath();
+            context.moveTo(from[0], from[1]);
+            context.lineTo(to[0], to[1]);
+            context.stroke();
+        }
+        context.restore();
+        if (lines.length === 0) {
+            return { lineCount: 0, bounds: { minX: 0, minY: 0, maxX: 0, maxY: 0 } };
+        }
+        return { lineCount: lines.length, bounds };
+    }
+}
+function project(point, axis, scale, origin) {
+    const y = axis === "xy" ? point[1] : point[2];
+    return [origin[0] + point[0] * scale, origin[1] - y * scale];
+}
+function include(bounds, point) {
+    bounds.minX = Math.min(bounds.minX, point[0]);
+    bounds.minY = Math.min(bounds.minY, point[1]);
+    bounds.maxX = Math.max(bounds.maxX, point[0]);
+    bounds.maxY = Math.max(bounds.maxY, point[1]);
+}
+function rgba(color) {
+    const r = Math.round(clamp01(color[0]) * 255);
+    const g = Math.round(clamp01(color[1]) * 255);
+    const b = Math.round(clamp01(color[2]) * 255);
+    return `rgba(${r}, ${g}, ${b}, ${clamp01(color[3])})`;
+}
+function clamp01(value) {
+    return Math.min(1, Math.max(0, Number.isFinite(value) ? value : 0));
+}
+//# sourceMappingURL=DebugLineCanvasRenderer.js.map

package/dist/DebugLineCanvasRenderer.js.map

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

package/dist/DebugOverlay.d.ts

@@ -0,0 +1,18 @@
+export interface DebugOverlaySection {
+    readonly title: string;
+    readonly rows: readonly DebugOverlayRow[];
+}
+export interface DebugOverlayRow {
+    readonly label: string;
+    readonly value: string | number | boolean | null;
+}
+export interface DebugOverlaySnapshot {
+    readonly sections: readonly DebugOverlaySection[];
+}
+export declare class DebugOverlay {
+    private readonly sections;
+    setSection(title: string, rows: readonly DebugOverlayRow[]): void;
+    removeSection(title: string): void;
+    snapshot(): DebugOverlaySnapshot;
+}
+//# sourceMappingURL=DebugOverlay.d.ts.map

package/dist/DebugOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugOverlay.d.ts","sourceRoot":"","sources":["../../../../packages/debug/src/DebugOverlay.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACnD;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IAEjE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI;IAQjE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlC,QAAQ,IAAI,oBAAoB;CAKjC"}

package/dist/DebugOverlay.js

@@ -0,0 +1,19 @@
+export class DebugOverlay {
+    sections = new Map();
+    setSection(title, rows) {
+        const trimmed = title.trim();
+        if (trimmed.length === 0) {
+            throw new Error("Debug overlay section title is required");
+        }
+        this.sections.set(trimmed, rows.map((row) => ({ ...row })));
+    }
+    removeSection(title) {
+        this.sections.delete(title);
+    }
+    snapshot() {
+        return {
+            sections: [...this.sections.entries()].map(([title, rows]) => ({ title, rows: [...rows] }))
+        };
+    }
+}
+//# sourceMappingURL=DebugOverlay.js.map

package/dist/DebugOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugOverlay.js","sourceRoot":"","sources":["../../../../packages/debug/src/DebugOverlay.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,YAAY;IACN,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEjE,UAAU,CAAC,KAAa,EAAE,IAAgC;QACxD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,aAAa,CAAC,KAAa;QACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,QAAQ;QACN,OAAO;YACL,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;SAC5F,CAAC;IACJ,CAAC;CACF"}

package/dist/DrawCallTracker.d.ts

@@ -0,0 +1,22 @@
+import { type DrawCommand, type RenderDeviceDiagnostics } from "@aura3d/rendering";
+export interface DrawCallRecord {
+    readonly label: string;
+    readonly topology: string;
+    readonly indexed: boolean;
+    readonly count: number;
+    readonly shader: string | null;
+}
+export interface DrawCallSnapshot {
+    readonly frame: number;
+    readonly total: number;
+    readonly records: readonly DrawCallRecord[];
+    readonly zeroDrawCallFailure: boolean;
+}
+export declare class DrawCallTracker {
+    private frame;
+    private readonly records;
+    beginFrame(): void;
+    record(command: DrawCommand): void;
+    capture(deviceDiagnostics?: RenderDeviceDiagnostics): DrawCallSnapshot;
+}
+//# sourceMappingURL=DrawCallTracker.d.ts.map

package/dist/DrawCallTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrawCallTracker.d.ts","sourceRoot":"","sources":["../../../../packages/debug/src/DrawCallTracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACvC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAEhD,UAAU,IAAI,IAAI;IAKlB,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAUlC,OAAO,CAAC,iBAAiB,CAAC,EAAE,uBAAuB,GAAG,gBAAgB;CASvE"}

package/dist/DrawCallTracker.js

@@ -0,0 +1,28 @@
+import {} from "@aura3d/rendering";
+export class DrawCallTracker {
+    frame = 0;
+    records = [];
+    beginFrame() {
+        this.frame += 1;
+        this.records.length = 0;
+    }
+    record(command) {
+        this.records.push({
+            label: command.label ?? "draw",
+            topology: command.topology,
+            indexed: command.indexBuffer !== undefined,
+            count: command.indexCount ?? command.vertexCount,
+            shader: command.shader?.label ?? null
+        });
+    }
+    capture(deviceDiagnostics) {
+        const total = deviceDiagnostics?.drawCalls ?? this.records.length;
+        return {
+            frame: this.frame,
+            total,
+            records: [...this.records],
+            zeroDrawCallFailure: total === 0
+        };
+    }
+}
+//# sourceMappingURL=DrawCallTracker.js.map

package/dist/DrawCallTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrawCallTracker.js","sourceRoot":"","sources":["../../../../packages/debug/src/DrawCallTracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,MAAM,mBAAmB,CAAC;AAiBnF,MAAM,OAAO,eAAe;IAClB,KAAK,GAAG,CAAC,CAAC;IACD,OAAO,GAAqB,EAAE,CAAC;IAEhD,UAAU;QACR,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,OAAoB;QACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAChB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,WAAW,KAAK,SAAS;YAC1C,KAAK,EAAE,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,WAAW;YAChD,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,IAAI;SACtC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,iBAA2C;QACjD,MAAM,KAAK,GAAG,iBAAiB,EAAE,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAClE,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK;YACL,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YAC1B,mBAAmB,EAAE,KAAK,KAAK,CAAC;SACjC,CAAC;IACJ,CAAC;CACF"}

package/dist/ECSInspector.d.ts

@@ -0,0 +1,16 @@
+export interface ECSWorldLike {
+    entities?(): readonly unknown[];
+    query?(...args: unknown[]): Iterable<unknown>;
+    readonly entityCount?: number;
+    profiler?: {
+        snapshot(): unknown;
+    };
+}
+export interface ECSInspectorSnapshot {
+    readonly entityCount: number;
+    readonly profiler?: unknown;
+}
+export declare class ECSInspector {
+    snapshot(world: ECSWorldLike): ECSInspectorSnapshot;
+}
+//# sourceMappingURL=ECSInspector.d.ts.map

package/dist/ECSInspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ECSInspector.d.ts","sourceRoot":"","sources":["../../../../packages/debug/src/ECSInspector.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,SAAS,OAAO,EAAE,CAAC;IAChC,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE;QAAE,QAAQ,IAAI,OAAO,CAAA;KAAE,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,oBAAoB;CASpD"}

package/dist/ECSInspector.js

@@ -0,0 +1,12 @@
+export class ECSInspector {
+    snapshot(world) {
+        const entityCount = typeof world.entityCount === "number"
+            ? world.entityCount
+            : world.entities?.().length ?? 0;
+        return {
+            entityCount,
+            ...(world.profiler ? { profiler: world.profiler.snapshot() } : {})
+        };
+    }
+}
+//# sourceMappingURL=ECSInspector.js.map

package/dist/ECSInspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ECSInspector.js","sourceRoot":"","sources":["../../../../packages/debug/src/ECSInspector.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,YAAY;IACvB,QAAQ,CAAC,KAAmB;QAC1B,MAAM,WAAW,GAAG,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;YACvD,CAAC,CAAC,KAAK,CAAC,WAAW;YACnB,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,CAAC;QACnC,OAAO;YACL,WAAW;YACX,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC;CACF"}

package/dist/GPUProfiler.d.ts

@@ -0,0 +1,22 @@
+export interface GPUProfilerSnapshot {
+    readonly supported: boolean;
+    readonly sampleCount: number;
+    readonly samples: readonly GPUSample[];
+    readonly unavailableReason?: string;
+}
+export interface GPUSample {
+    readonly label: string;
+    readonly durationMs: number;
+}
+export interface GPUProfilerTimer {
+    end(durationMs?: number): GPUSample;
+}
+export declare class GPUProfiler {
+    private readonly supported;
+    private readonly unavailableReason;
+    private readonly samples;
+    constructor(supported?: boolean, unavailableReason?: string);
+    begin(label: string): GPUProfilerTimer;
+    snapshot(): GPUProfilerSnapshot;
+}
+//# sourceMappingURL=GPUProfiler.d.ts.map

package/dist/GPUProfiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GPUProfiler.d.ts","sourceRoot":"","sources":["../../../../packages/debug/src/GPUProfiler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAJpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;gBAGxB,SAAS,UAAQ,EACjB,iBAAiB,SAAqC;IAGzE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAetC,QAAQ,IAAI,mBAAmB;CAQhC"}

package/dist/GPUProfiler.js

@@ -0,0 +1,32 @@
+export class GPUProfiler {
+    supported;
+    unavailableReason;
+    samples = [];
+    constructor(supported = false, unavailableReason = "GPU timing extension unavailable") {
+        this.supported = supported;
+        this.unavailableReason = unavailableReason;
+    }
+    begin(label) {
+        const trimmed = label.trim();
+        if (trimmed.length === 0) {
+            throw new Error("GPU profiler sample label is required");
+        }
+        const start = performance.now();
+        return {
+            end: (durationMs = performance.now() - start) => {
+                const sample = { label: trimmed, durationMs };
+                this.samples.push(sample);
+                return sample;
+            }
+        };
+    }
+    snapshot() {
+        return {
+            supported: this.supported,
+            sampleCount: this.samples.length,
+            samples: [...this.samples],
+            ...(this.supported ? {} : { unavailableReason: this.unavailableReason })
+        };
+    }
+}
+//# sourceMappingURL=GPUProfiler.js.map

package/dist/GPUProfiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GPUProfiler.js","sourceRoot":"","sources":["../../../../packages/debug/src/GPUProfiler.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,WAAW;IAIH;IACA;IAJF,OAAO,GAAgB,EAAE,CAAC;IAE3C,YACmB,YAAY,KAAK,EACjB,oBAAoB,kCAAkC;QADtD,cAAS,GAAT,SAAS,CAAQ;QACjB,sBAAiB,GAAjB,iBAAiB,CAAqC;IACtE,CAAC;IAEJ,KAAK,CAAC,KAAa;QACjB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAChC,OAAO;YACL,GAAG,EAAE,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE;gBAC9C,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;gBAC9C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC1B,OAAO,MAAM,CAAC;YAChB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,QAAQ;QACN,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YAChC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC;SACzE,CAAC;IACJ,CAAC;CACF"}

package/dist/MaterialDiagnostics.d.ts

@@ -0,0 +1,17 @@
+import { type Material, type MaterialInstance, type RenderShaderProgram } from "@aura3d/rendering";
+export interface MaterialDiagnosticReport {
+    readonly materialName: string;
+    readonly shaderLabel: string;
+    readonly valid: boolean;
+    readonly diagnostics: readonly string[];
+    readonly uniforms: readonly string[];
+}
+export declare class MaterialDiagnostics {
+    inspect(material: Material | MaterialInstance, shader: RenderShaderProgram): MaterialDiagnosticReport;
+    assertValid(report: MaterialDiagnosticReport): void;
+}
+export declare class MaterialDiagnosticError extends Error {
+    readonly report: MaterialDiagnosticReport;
+    constructor(message: string, report: MaterialDiagnosticReport);
+}
+//# sourceMappingURL=MaterialDiagnostics.d.ts.map

package/dist/MaterialDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaterialDiagnostics.d.ts","sourceRoot":"","sources":["../../../../packages/debug/src/MaterialDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,EAAE,MAAM,EAAE,mBAAmB,GAAG,wBAAwB;IA0BrG,WAAW,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI;CAKpD;AAED,qBAAa,uBAAwB,SAAQ,KAAK;aAG9B,MAAM,EAAE,wBAAwB;gBADhD,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,wBAAwB;CAKnD"}

package/dist/MaterialDiagnostics.js

@@ -0,0 +1,43 @@
+import { MaterialBinding, MaterialBindingError } from "@aura3d/rendering";
+export class MaterialDiagnostics {
+    inspect(material, shader) {
+        const binding = new MaterialBinding();
+        const materialName = "baseMaterial" in material ? material.baseMaterial.name : material.name;
+        try {
+            const result = binding.bind(material, shader);
+            return {
+                materialName,
+                shaderLabel: shader.label,
+                valid: true,
+                diagnostics: [],
+                uniforms: [...result.uniforms.keys()]
+            };
+        }
+        catch (error) {
+            if (error instanceof MaterialBindingError) {
+                return {
+                    materialName,
+                    shaderLabel: shader.label,
+                    valid: false,
+                    diagnostics: error.diagnostics,
+                    uniforms: []
+                };
+            }
+            throw error;
+        }
+    }
+    assertValid(report) {
+        if (!report.valid) {
+            throw new MaterialDiagnosticError("Material diagnostics reported invalid binding", report);
+        }
+    }
+}
+export class MaterialDiagnosticError extends Error {
+    report;
+    constructor(message, report) {
+        super(message);
+        this.report = report;
+        this.name = "MaterialDiagnosticError";
+    }
+}
+//# sourceMappingURL=MaterialDiagnostics.js.map