@aura3d/engine 1.0.0

package/dist/debug/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/debug/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/debug/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/debug/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/debug/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/debug/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/debug/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/debug/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/debug/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/debug/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/debug/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/debug/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/debug/DrawCallTracker.js

@@ -0,0 +1,28 @@
+import {} from "../rendering/index.js";
+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/debug/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/debug/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/debug/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/debug/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/debug/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/debug/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/debug/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/debug/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/debug/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/debug/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/debug/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/debug/MaterialDiagnostics.js

@@ -0,0 +1,43 @@
+import { MaterialBinding, MaterialBindingError } from "../rendering/index.js";
+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

package/dist/debug/MaterialDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaterialDiagnostics.js","sourceRoot":"","sources":["../../../../packages/debug/src/MaterialDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,oBAAoB,EAIrB,MAAM,mBAAmB,CAAC;AAU3B,MAAM,OAAO,mBAAmB;IAC9B,OAAO,CAAC,QAAqC,EAAE,MAA2B;QACxE,MAAM,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;QACtC,MAAM,YAAY,GAAG,cAAc,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC7F,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC9C,OAAO;gBACL,YAAY;gBACZ,WAAW,EAAE,MAAM,CAAC,KAAK;gBACzB,KAAK,EAAE,IAAI;gBACX,WAAW,EAAE,EAAE;gBACf,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;aACtC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;gBAC1C,OAAO;oBACL,YAAY;oBACZ,WAAW,EAAE,MAAM,CAAC,KAAK;oBACzB,KAAK,EAAE,KAAK;oBACZ,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,QAAQ,EAAE,EAAE;iBACb,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,WAAW,CAAC,MAAgC;QAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,IAAI,uBAAuB,CAAC,+CAA+C,EAAE,MAAM,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAG9B;IAFlB,YACE,OAAe,EACC,MAAgC;QAEhD,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,WAAM,GAAN,MAAM,CAA0B;QAGhD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}

package/dist/debug/PhysicsDebugAdapter.d.ts

@@ -0,0 +1,29 @@
+import { type DebugLine, type PhysicsWorld } from "@aura3d/physics";
+export type PhysicsDebugSnapshot = {
+    readonly bodyCount: number;
+    readonly colliderCount: number;
+    readonly contactCount: number;
+    readonly lines: readonly DebugLine[];
+};
+export type PhysicsStackEvidence = {
+    readonly bodyCount: number;
+    readonly dynamicBodyCount: number;
+    readonly contactCount: number;
+    readonly lineCount: number;
+    readonly minY: number;
+    readonly maxY: number;
+    readonly settledCount: number;
+    readonly bodyPositions: readonly {
+        readonly id: number;
+        readonly type: string;
+        readonly position: readonly [number, number, number];
+    }[];
+    readonly stableHash: string;
+};
+export declare class PhysicsDebugAdapter {
+    private readonly draw;
+    buildLines(world: Pick<PhysicsWorld, "colliders" | "getBody">): readonly DebugLine[];
+    snapshot(world: Pick<PhysicsWorld, "colliders" | "bodies" | "getBody" | "snapshot">): PhysicsDebugSnapshot;
+    stackEvidence(world: Pick<PhysicsWorld, "colliders" | "bodies" | "getBody" | "snapshot">, velocityEpsilon?: number): PhysicsStackEvidence;
+}
+//# sourceMappingURL=PhysicsDebugAdapter.d.ts.map

package/dist/debug/PhysicsDebugAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhysicsDebugAdapter.d.ts","sourceRoot":"","sources":["../../../../packages/debug/src/PhysicsDebugAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEtF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS;QAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;KACtD,EAAE,CAAC;IACJ,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAE/C,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,SAAS,SAAS,EAAE;IAIpF,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC,GAAG,oBAAoB;IAS1G,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC,EAAE,eAAe,SAAO,GAAG,oBAAoB;CA0BxI"}

package/dist/debug/PhysicsDebugAdapter.js

@@ -0,0 +1,57 @@
+import { PhysicsDebugDraw } from "../physics/index.js";
+export class PhysicsDebugAdapter {
+    draw = new PhysicsDebugDraw();
+    buildLines(world) {
+        return this.draw.buildLines(world);
+    }
+    snapshot(world) {
+        return {
+            bodyCount: world.bodies().length,
+            colliderCount: world.colliders().length,
+            contactCount: world.snapshot().contacts.length,
+            lines: this.buildLines(world)
+        };
+    }
+    stackEvidence(world, velocityEpsilon = 0.05) {
+        const snapshot = world.snapshot();
+        const lines = this.buildLines(world);
+        const bodyPositions = snapshot.bodies.map((body) => ({
+            id: body.id,
+            type: body.type,
+            position: roundVec3(body.position)
+        }));
+        const dynamicBodies = snapshot.bodies.filter((body) => body.type === "dynamic");
+        const settledCount = dynamicBodies.filter((body) => Math.hypot(body.velocity[0], body.velocity[1], body.velocity[2]) <= velocityEpsilon).length;
+        const ys = snapshot.bodies.map((body) => body.position[1]);
+        const evidenceWithoutHash = {
+            bodyCount: snapshot.stats.bodies,
+            dynamicBodyCount: dynamicBodies.length,
+            contactCount: snapshot.contacts.length,
+            lineCount: lines.length,
+            minY: roundNumber(ys.length > 0 ? Math.min(...ys) : 0),
+            maxY: roundNumber(ys.length > 0 ? Math.max(...ys) : 0),
+            settledCount,
+            bodyPositions
+        };
+        return {
+            ...evidenceWithoutHash,
+            stableHash: stableHash(evidenceWithoutHash)
+        };
+    }
+}
+function roundNumber(value, places = 6) {
+    return Number(value.toFixed(places));
+}
+function roundVec3(value) {
+    return [roundNumber(value[0]), roundNumber(value[1]), roundNumber(value[2])];
+}
+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=PhysicsDebugAdapter.js.map

package/dist/debug/PhysicsDebugAdapter.js.map

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

package/dist/debug/Profiler.d.ts

@@ -0,0 +1,24 @@
+export interface ProfilerMarker {
+    readonly name: string;
+    readonly startMs: number;
+    readonly endMs: number;
+    readonly durationMs: number;
+    readonly depth: number;
+}
+export interface ProfilerSnapshot {
+    readonly markerCount: number;
+    readonly totalDurationMs: number;
+    readonly markers: readonly ProfilerMarker[];
+}
+export declare class Profiler {
+    private readonly now;
+    private readonly active;
+    private readonly markers;
+    constructor(now?: () => number);
+    begin(name: string): void;
+    end(name?: string): ProfilerMarker;
+    measure<T>(name: string, fn: () => T): T;
+    snapshot(): ProfilerSnapshot;
+    reset(): void;
+}
+//# sourceMappingURL=Profiler.d.ts.map

package/dist/debug/Profiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Profiler.d.ts","sourceRoot":"","sources":["../../../../packages/debug/src/Profiler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;CAC7C;AAQD,qBAAa,QAAQ;IAIP,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;gBAEnB,GAAG,GAAE,MAAM,MAAgC;IAExE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQzB,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc;IAoBlC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IASxC,QAAQ,IAAI,gBAAgB;IAS5B,KAAK,IAAI,IAAI;CAId"}