@aura3d/engine 3.0.0 → 4.0.0

package/dist/rendering/renderer/CullingBatching.js

@@ -0,0 +1,362 @@
+// PR 0b-2 carve-out (CONTRACTS.md §3.3) — verbatim move from Renderer.ts; 0 changed logic lines.
+// File: packages/rendering/src/renderer/CullingBatching.ts — owner lane 11.
+import { Geometry } from "../Geometry.js";
+import { createStaticMeshConsolidationCache } from "../MeshConsolidation.js";
+import { batchStaticRenderItems } from "../SceneOptimization.js";
+import { toMat4 } from "./RenderShared.js";
+import { skinnedItemLocalBounds } from "./SkinnedBounds.js";
+import { planBatches } from "../batching/StaticMergePlanner.js";
+import { MaterialInstance } from "../MaterialInstance.js";
+import { rendererQrFlags } from "./FrameGraph.js";
+import { Frustum } from "../../math/index.js";
+import { cull, packFrustumPlanes } from "../performance/FrustumCuller.js";
+import { Bounds3 as SceneBounds3, Camera, identityMat4, multiplyMat4, toMathMat4 } from "../../scene/index.js";
+export function explicitCullingFrustum(source, cameraViewProjection, camera) {
+    // Explicit render-item sources were historically never culled, so culling
+    // stays opt-in: only an explicit `frustumCulling: true` turns it on.
+    if (source.frustumCulling !== true)
+        return undefined;
+    if (camera)
+        return camera.frustum;
+    if (!cameraViewProjection)
+        return undefined;
+    return Frustum.fromMatrix(toMathMat4(cameraViewProjection));
+}
+export function cullExplicitRenderItems(items, frustum, diagnostics, 
+/** 02-S5: receives culled items with `castShadow !== false`. */
+culledShadowCasters) {
+    if (!frustum) {
+        diagnostics.submittedObjects += items.length;
+        diagnostics.visibleObjects += items.length;
+        return items;
+    }
+    const visible = [];
+    // 11-S5: one plane pack per call and a reused 6-float box, instead of a Box3
+    // plus six Vector3s per item inside Frustum.intersectsBox. Same
+    // positive-vertex test, same empty-box rule, so results are identical.
+    const planes = packFrustumPlanes(frustum.planes);
+    const box = new Float64Array(6);
+    const verdict = new Uint8Array(1);
+    for (const item of items) {
+        diagnostics.submittedObjects += 1;
+        if (!isFrustumCullableRenderItem(item)) {
+            diagnostics.visibleObjects += 1;
+            visible.push(item);
+            continue;
+        }
+        diagnostics.frustumTestedObjects += 1;
+        const bounds = explicitRenderItemWorldBounds(item);
+        box[0] = bounds.min[0];
+        box[1] = bounds.min[1];
+        box[2] = bounds.min[2];
+        box[3] = bounds.max[0];
+        box[4] = bounds.max[1];
+        box[5] = bounds.max[2];
+        if (cull(box, 1, planes, verdict) === 0) {
+            diagnostics.culledObjects += 1;
+            if (culledShadowCasters && item.castShadow !== false)
+                culledShadowCasters.push(item);
+            continue;
+        }
+        diagnostics.visibleObjects += 1;
+        visible.push(item);
+    }
+    return visible;
+}
+function isFrustumCullableRenderItem(item) {
+    if (item.drawRange !== undefined)
+        return false;
+    if (item.morphTargets !== undefined || item.morphWeights !== undefined)
+        return false;
+    return true;
+}
+/**
+ * 02-S5: of the frustum-culled casters, keep those whose sun shadow can land
+ * in view. Each caster box is swept along the light's travel until its top
+ * reaches the lowest receiver (the ground footprint of its shadow); a sweep
+ * that intersects the view frustum keeps the caster. Casters whose shadow
+ * stays off-screen are dropped, so a large city does not inflate the cascade
+ * fit with buildings behind the camera.
+ */
+export function culledCastersReachingView(culled, receivers, frustum, travel) {
+    if (culled.length === 0 || !frustum || !travel)
+        return [];
+    const length = Math.hypot(travel[0], travel[1], travel[2]);
+    if (!Number.isFinite(length) || length === 0 || travel[1] / length > -1e-3)
+        return [];
+    const dir = [travel[0] / length, travel[1] / length, travel[2] / length];
+    let floorY = Infinity;
+    for (const item of receivers)
+        floorY = Math.min(floorY, explicitRenderItemWorldBounds(item).min[1]);
+    const planes = packFrustumPlanes(frustum.planes);
+    const box = new Float64Array(6);
+    const verdict = new Uint8Array(1);
+    const kept = [];
+    for (const item of culled) {
+        const b = explicitRenderItemWorldBounds(item);
+        const reachY = Number.isFinite(floorY) ? Math.min(floorY, b.min[1]) : b.min[1];
+        const t = Math.max(0, (b.max[1] - reachY) / -dir[1]);
+        for (let axis = 0; axis < 3; axis += 1) {
+            const shift = dir[axis] * t;
+            box[axis] = Math.min(b.min[axis], b.min[axis] + shift);
+            box[axis + 3] = Math.max(b.max[axis], b.max[axis] + shift);
+        }
+        if (cull(box, 1, planes, verdict) > 0)
+            kept.push(item);
+    }
+    return kept;
+}
+function explicitRenderItemWorldBounds(item) {
+    const modelMatrix = toMat4(item.modelMatrix ?? identityMat4(), "modelMatrix", item.label);
+    if (item.skinning) {
+        const local = skinnedItemLocalBounds(item.geometry, item.skinning);
+        return boundsFromLocal(local, modelMatrix, item.instanceTransforms);
+    }
+    return boundsFromLocal(item.geometry.bounds, modelMatrix, item.instanceTransforms);
+}
+function boundsFromLocal(envelope, modelMatrix, instanceTransforms) {
+    const local = new SceneBounds3([envelope.min[0], envelope.min[1], envelope.min[2]], [envelope.max[0], envelope.max[1], envelope.max[2]]);
+    if (!instanceTransforms || instanceTransforms.length < 16) {
+        return local.transform(modelMatrix);
+    }
+    let bounds = new SceneBounds3();
+    for (let offset = 0; offset + 16 <= instanceTransforms.length; offset += 16) {
+        const instanceMatrix = toMat4(instanceTransforms.slice(offset, offset + 16), "instanceTransforms");
+        bounds = bounds.union(local.transform(multiplyMat4(modelMatrix, instanceMatrix)));
+    }
+    return bounds;
+}
+export function applyRendererOwnedStaticMeshConsolidation(source, items) {
+    if (!source.staticMeshConsolidation)
+        return items;
+    const mergeable = [];
+    const passthrough = [];
+    for (const item of items) {
+        // The same eligibility rule as batching: anything skinned, morphed, instanced, or draw-ranged is
+        // not static geometry and must not have a transform baked into it.
+        if (isStaticBatchCandidate(item)) {
+            mergeable.push({
+                geometry: item.geometry,
+                material: item.material,
+                modelMatrix: item.modelMatrix ?? identityMat4(),
+                ...(item.label ? { label: item.label } : {})
+            });
+        }
+        else {
+            passthrough.push(item);
+        }
+    }
+    if (mergeable.length === 0)
+        return items;
+    const options = source.staticMeshConsolidation === true ? {} : source.staticMeshConsolidation;
+    // Cached per render source: merging walks every vertex, so repeating it each frame costs far more
+    // than the draw calls it saves.
+    let cache = staticMeshConsolidationCaches.get(source);
+    if (!cache) {
+        cache = createStaticMeshConsolidationCache();
+        staticMeshConsolidationCaches.set(source, cache);
+    }
+    const consolidated = cache.consolidate(mergeable, {
+        labelPrefix: "renderer-consolidated-mesh",
+        ...options
+    });
+    return [...passthrough, ...consolidated.renderItems];
+}
+export function applyRendererOwnedStaticBatching(source, items) {
+    if (!source.staticBatching)
+        return items;
+    const batchable = [];
+    const batchableItems = [];
+    const passthrough = [];
+    for (const item of items) {
+        if (isStaticBatchCandidate(item)) {
+            batchable.push({
+                geometry: item.geometry,
+                material: item.material,
+                modelMatrix: item.modelMatrix ?? identityMat4(),
+                batchKey: staticBatchKey(item),
+                label: item.label,
+                castShadow: item.castShadow
+            });
+            batchableItems.push(item);
+        }
+        else {
+            passthrough.push(item);
+        }
+    }
+    if (batchable.length === 0)
+        return items;
+    // PRD 11 Phase 3: with A3D_QR_TIERS_BATCHING on, content-keyed BatchPlan
+    // replaces the identity `staticBatchKey` regroup; off => legacy path, byte
+    // identical to PR 0b-2. Cached per render source by structural version.
+    if (rendererQrFlags().on("A3D_QR_TIERS_BATCHING")) {
+        let cache = staticBatchPlanCaches.get(source);
+        if (!cache) {
+            cache = new BatchPlanCache();
+            staticBatchPlanCaches.set(source, cache);
+        }
+        const planned = cache.apply(batchableItems, optionsForSource(source));
+        return [...passthrough, ...planned];
+    }
+    const options = source.staticBatching === true ? {} : source.staticBatching;
+    const batched = batchStaticRenderItems(batchable, {
+        labelPrefix: "renderer-static-batch",
+        ...options
+    });
+    return [...passthrough, ...batched.renderItems];
+}
+function isStaticBatchCandidate(item) {
+    return item.material !== undefined &&
+        item.drawRange === undefined &&
+        item.skinning === undefined &&
+        item.morphTargets === undefined &&
+        item.morphWeights === undefined &&
+        item.instanceTransforms === undefined &&
+        item.instanceColors === undefined &&
+        item.instanceAttributes === undefined;
+}
+function staticBatchKey(item) {
+    return `${resourceId(staticBatchGeometryIds, item.geometry)}:${resourceId(staticBatchMaterialIds, item.material)}:shadow-${item.castShadow !== false ? "on" : "off"}`;
+}
+function resourceId(ids, resource) {
+    const existing = ids.get(resource);
+    if (existing !== undefined)
+        return existing;
+    const next = nextStaticBatchResourceId++;
+    ids.set(resource, next);
+    return next;
+}
+const staticBatchGeometryIds = new WeakMap();
+const staticBatchMaterialIds = new WeakMap();
+let nextStaticBatchResourceId = 1;
+/**
+ * Merges shared-material static geometry, then hands the result to batching.
+ *
+ * Consolidation runs first because it reduces distinct geometries; whatever it leaves unmerged (single
+ * items, oversized meshes, non-indexed topology) can still be instanced by batching afterwards.
+ */
+const staticMeshConsolidationCaches = new WeakMap();
+// ---------------------------------------------------------------------------
+// PRD 11 Phase 3 (§6.6, §16.0) — BatchPlan caching + item synthesis.
+// The plan rebuilds only when the item SET changes (identity + material
+// revision); member matrices/colours refresh in place every call, mirroring
+// the C-07 `InstanceBufferLike.setMatrices` update path.
+// ---------------------------------------------------------------------------
+const IDENTITY_MODEL = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+const EMPTY_BATCH_REPORT = {
+    inputItems: 0, outputDraws: 0, instancedBatches: 0, multiDrawBatches: 0,
+    reasonsNotBatched: {}, planBuildMs: 0, planVersion: 0
+};
+let latestBatchPlanReport = EMPTY_BATCH_REPORT;
+/** Latest plan report across all plan caches; `null`-safe for the diagnostics collector. */
+export function prd11LatestBatchPlanReport() {
+    return latestBatchPlanReport;
+}
+function structuralSignature(items) {
+    // Cheap identity signature: item/geometry/material refs + material revision.
+    // Object identity via a stable registry (WeakMap → id) keeps this off the
+    // string fast-path without serializing vertex data.
+    const parts = [`${items.length}`];
+    for (const item of items) {
+        const material = item.material;
+        const base = material instanceof MaterialInstance ? material.baseMaterial : material;
+        parts.push(`${resourceId(staticBatchGeometryIds, item.geometry)}:${material ? resourceId(staticBatchMaterialIds, material) : "nomat"}:${base?.getRevision() ?? 0}`, item.castShadow !== false ? "1" : "0", item.label ?? "");
+    }
+    return parts.join("|");
+}
+/** Rewrites per-member matrices/colours in place for an unchanged set. */
+export function refreshInstancedBatch(batch) {
+    const transforms = batch.instanceTransforms;
+    const colors = batch.instanceColors;
+    batch.members.forEach((item, index) => {
+        const model = item.modelMatrix ?? IDENTITY_MODEL;
+        for (let i = 0; i < 16; i += 1)
+            transforms[index * 16 + i] = model[i] ?? (i % 5 === 0 ? 1 : 0);
+        const colorValue = item.material?.getParameters().get("u_baseColor");
+        if (colorValue && typeof colorValue !== "number") {
+            const arr = colorValue;
+            for (let i = 0; i < 4; i += 1)
+                colors[index * 4 + i] = arr[i] ?? 1;
+        }
+    });
+}
+/** InstancedBatch → the RenderItems the legacy forward path submits. */
+export function synthesizeInstancedItems(batches) {
+    const items = [];
+    for (const batch of batches) {
+        for (const chunk of batch.chunks) {
+            items.push({
+                geometry: batch.geometry,
+                material: batch.material,
+                instanceTransforms: chunk.instanceTransforms,
+                instanceColors: chunk.instanceColors,
+                castShadow: batch.castShadow,
+                label: `a3d-prd11-batch:${batch.members[0].label ?? "items"}x${chunk.members.length}`
+            });
+        }
+    }
+    return items;
+}
+/**
+ * Per-source plan cache. `apply()` returns the transformed item list ready
+ * for draw submission; `lastReport` feeds `renderer.batching`.
+ */
+export class BatchPlanCache {
+    signature = "";
+    synthesized = [];
+    plan = null;
+    version = 0;
+    lastReport = EMPTY_BATCH_REPORT;
+    apply(items, options = {}) {
+        const signature = structuralSignature(items);
+        if (signature === this.signature && this.plan) {
+            for (const batch of this.plan.instancedBatches)
+                refreshInstancedBatch(batch);
+            latestBatchPlanReport = this.lastReport;
+            return this.synthesized;
+        }
+        const startedAt = typeof performance !== "undefined" ? performance.now() : Date.now();
+        const plan = planBatches(items, options);
+        const buildMs = (typeof performance !== "undefined" ? performance.now() : Date.now()) - startedAt;
+        this.version += 1;
+        this.plan = plan;
+        this.signature = signature;
+        this.synthesized = [...synthesizeInstancedItems(plan.instancedBatches), ...plan.passthrough];
+        this.lastReport = {
+            inputItems: items.length,
+            outputDraws: plan.stats.instancedDraws + plan.stats.passthroughItems + plan.stats.multiDrawMembers,
+            instancedBatches: plan.instancedBatches.length,
+            multiDrawBatches: plan.multiDrawGroups.length,
+            reasonsNotBatched: plan.reasonsNotBatched,
+            planBuildMs: buildMs,
+            planVersion: this.version
+        };
+        latestBatchPlanReport = this.lastReport;
+        return this.synthesized;
+    }
+    /** Plan rebuilt this call — used by lane tests. */
+    get planVersion() {
+        return this.version;
+    }
+    get lastPlan() {
+        return this.plan;
+    }
+}
+const staticBatchPlanCaches = new WeakMap();
+/** Plan-cache accessor for the `prd11.batching` frame contributor (non-source item lists). */
+export function batchPlanCacheFor(key) {
+    let cache = staticBatchPlanCaches.get(key);
+    if (!cache) {
+        cache = new BatchPlanCache();
+        staticBatchPlanCaches.set(key, cache);
+    }
+    return cache;
+}
+function optionsForSource(source) {
+    // `maxInstancesPerBatch` carries through; C-02 stays stubbed so
+    // `multiDrawAvailable` is always false (members count `multi-draw-generator-pending`).
+    const raw = source.staticBatching;
+    const options = raw === true || raw === false || raw === undefined ? {} : raw;
+    return { multiDrawAvailable: false, maxInstancesPerDraw: options.maxInstancesPerBatch };
+}
+//# sourceMappingURL=CullingBatching.js.map

package/dist/rendering/renderer/CullingBatching.js.map

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

package/dist/rendering/renderer/DeviceLifecycle.d.ts

@@ -0,0 +1,29 @@
+import type { RenderDevice } from "../RenderDevice.js";
+import type { ProgramFeatures } from "../contracts/program.js";
+import type { QrFlags } from "../contracts/core.js";
+import type { ResourceRegistryLike } from "../contracts/rendererFactory.js";
+export declare function subscribeRendererDeviceLost(device: RenderDevice, listener: () => void): () => void;
+export declare function subscribeRendererDeviceRestored(device: RenderDevice, listener: () => void): () => void;
+export declare function rendererDeviceIsLost(device: RenderDevice): boolean;
+export interface DeviceRestoreRebuildOptions {
+    /** C-29 registry whose `rebuild(device)` runs before restored listeners. */
+    readonly registry: ResourceRegistryLike;
+    /** Flags for `programCacheSlot.get` — real cache only under C-02's flag. */
+    readonly flags: QrFlags;
+    /** Active program feature keys for the C-02 warm-up after rebuild. */
+    readonly activeProgramFeatures?: () => readonly ProgramFeatures[] | Promise<readonly ProgramFeatures[]>;
+}
+/**
+ * PRD 11 Phase 5 (§6.9): install the restore-time rebuild on a WebGL2
+ * device's `WebGL2ContextLifecycle`. The hook runs, in order:
+ *   1. `invalidateGpuObjects?.()` — Q-01-1 seam; absent until lane 01 lands it.
+ *   2. `registry.rebuild(device)` — eager recreation of registered resources.
+ *   3. `programCache.precompile(activeProgramFeatures)` — C-02 warm-up.
+ * `deviceRestoredListeners` (and therefore `app.onDeviceRestored`) fire only
+ * after this resolves — `WebGL2ContextLifecycle` defers the notification.
+ *
+ * Returns an unsubscribe; no-ops and returns a stub on non-WebGL2 devices or
+ * when the lifecycle host seam is unavailable.
+ */
+export declare function installDeviceRestoreRebuild(device: RenderDevice, options: DeviceRestoreRebuildOptions): () => void;
+//# sourceMappingURL=DeviceLifecycle.d.ts.map

package/dist/rendering/renderer/DeviceLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceLifecycle.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/renderer/DeviceLifecycle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AASzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAElG;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAEtG;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAMlE;AAED,MAAM,WAAW,2BAA2B;IAC1C,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;CACzG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,2BAA2B,GAAG,MAAM,IAAI,CAelH"}

package/dist/rendering/renderer/DeviceLifecycle.js

@@ -0,0 +1,48 @@
+// C-29 seam (PR 0b) — renderer-side device lifecycle delegates.
+// File: packages/rendering/src/renderer/DeviceLifecycle.ts — owner lane 11.
+import { programCacheSlot } from "../contracts/program.js";
+import { webgl2DeviceHost } from "../webgl2/Counters.js";
+export function subscribeRendererDeviceLost(device, listener) {
+    return device.onDeviceLost?.(listener) ?? (() => { });
+}
+export function subscribeRendererDeviceRestored(device, listener) {
+    return device.onDeviceRestored?.(listener) ?? (() => { });
+}
+export function rendererDeviceIsLost(device) {
+    const lifecycle = device;
+    // #271: `WebGPUDevice` has no `isDeviceLost()`; it sets `contextLost` when
+    // `GPUDevice.lost` resolves (the same moment its onDeviceLost listeners fire).
+    if (typeof lifecycle.isDeviceLost === "function")
+        return lifecycle.isDeviceLost();
+    return lifecycle.contextLost === true;
+}
+/**
+ * PRD 11 Phase 5 (§6.9): install the restore-time rebuild on a WebGL2
+ * device's `WebGL2ContextLifecycle`. The hook runs, in order:
+ *   1. `invalidateGpuObjects?.()` — Q-01-1 seam; absent until lane 01 lands it.
+ *   2. `registry.rebuild(device)` — eager recreation of registered resources.
+ *   3. `programCache.precompile(activeProgramFeatures)` — C-02 warm-up.
+ * `deviceRestoredListeners` (and therefore `app.onDeviceRestored`) fire only
+ * after this resolves — `WebGL2ContextLifecycle` defers the notification.
+ *
+ * Returns an unsubscribe; no-ops and returns a stub on non-WebGL2 devices or
+ * when the lifecycle host seam is unavailable.
+ */
+export function installDeviceRestoreRebuild(device, options) {
+    const host = webgl2DeviceHost(device);
+    const lifecycle = host?.lifecycle;
+    if (!lifecycle)
+        return () => { };
+    return lifecycle.onRestoredHook(async () => {
+        const invalidator = host.invalidateGpuObjects;
+        if (invalidator) {
+            invalidator.call(host);
+        }
+        await options.registry.rebuild(device);
+        const features = await options.activeProgramFeatures?.();
+        if (features && features.length > 0) {
+            await programCacheSlot.get(options.flags)(device).precompile(features);
+        }
+    });
+}
+//# sourceMappingURL=DeviceLifecycle.js.map

package/dist/rendering/renderer/DeviceLifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceLifecycle.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/renderer/DeviceLifecycle.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,4EAA4E;AAI5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAQtD,MAAM,UAAU,2BAA2B,CAAC,MAAoB,EAAE,QAAoB;IACpF,OAAQ,MAA0B,CAAC,YAAY,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,MAAoB,EAAE,QAAoB;IACxF,OAAQ,MAA0B,CAAC,gBAAgB,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,MAAM,SAAS,GAAG,MAA8D,CAAC;IACjF,2EAA2E;IAC3E,+EAA+E;IAC/E,IAAI,OAAO,SAAS,CAAC,YAAY,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC,YAAY,EAAE,CAAC;IAClF,OAAO,SAAS,CAAC,WAAW,KAAK,IAAI,CAAC;AACxC,CAAC;AAWD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAoB,EAAE,OAAoC;IACpG,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,CAAC;IAClC,IAAI,CAAC,SAAS;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAChC,OAAO,SAAS,CAAC,cAAc,CAAC,KAAK,IAAI,EAAE;QACzC,MAAM,WAAW,GAAI,IAA8C,CAAC,oBAAoB,CAAC;QACzF,IAAI,WAAW,EAAE,CAAC;YAChB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC;QACzD,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/rendering/renderer/FrameGraph.d.ts

@@ -0,0 +1,96 @@
+import { Scene, type Mat4 } from "../../scene/index.js";
+import type { RenderDevice, RenderTarget } from "../RenderDevice.js";
+import type { RenderGraph } from "../RenderGraph.js";
+import type { RenderItem } from "../ForwardPass.js";
+import type { RenderSource } from "../contracts/renderSource.js";
+import type { QrFlags } from "../contracts/core.js";
+import { type AuraQualityTierSettings } from "../contracts/quality.js";
+import { type AuraFramePhase, type FrameCamera, type FrameContributorContext, type TransparentQueueItem } from "../contracts/frameGraph.js";
+/** Engine-side wiring: set once flags resolve (createAuraApp / createGameApp). */
+export declare function setRendererQrFlags(flags: QrFlags, device?: RenderDevice): void;
+export declare function rendererQrFlags(device?: RenderDevice): QrFlags;
+/**
+ * T0-28: run `fn` with the ambient default bound to `device`'s scoped flags so
+ * device-less `rendererQrFlags()` readers inside a synchronous frame see this
+ * renderer's flags. No scoped entry → `fn` runs unchanged. Restores after.
+ */
+export declare function withRendererQrFlags<T>(device: RenderDevice, fn: () => T): T;
+/** Minimal resolved-camera shape produced by Renderer.resolveCamera. */
+export interface ResolvedCameraInput {
+    readonly viewProjectionMatrix: Mat4;
+    readonly viewMatrix?: Mat4;
+    readonly camera?: unknown;
+    readonly cameraPosition?: readonly [number, number, number];
+}
+/** Best-effort FrameCamera for the PR 0b stub; PRD 01 publishes real history later. */
+export declare function toFrameCamera(resolvedCamera: ResolvedCameraInput | undefined, cameraViewProjection: Mat4 | undefined, cameraPosition: readonly [number, number, number] | undefined): FrameCamera | null;
+export interface RendererFrameHooksInput {
+    readonly device: RenderDevice;
+    readonly width: number;
+    readonly height: number;
+    readonly source: RenderSource | Scene | Iterable<RenderItem>;
+    readonly camera: FrameCamera | null;
+    readonly frameIndex?: number;
+    readonly tier?: AuraQualityTierSettings;
+    /** Per-frame flags override (C-05 legacy-post route); defaults to the device's resolved flags. */
+    readonly flags?: QrFlags;
+}
+/** C-01 blackboard key for the forward color target (R-01-1). */
+export declare const PRD01_FORWARD_TARGET = "prd01.forwardTarget";
+/** C-13 (Q-03-1): lane 03 publishes grade × auto-exposure here; OutputPass multiplies it in. */
+export declare const PRD03_EXPOSURE = "prd03.exposure";
+/** C-01 (§8.4 step 1): resolved scene-depth copy target published for after-opaque consumers. */
+export declare const AURA_SCENE_DEPTH_COPY = "aura.scene.depth.copy";
+export declare class RendererFrameHooks {
+    private readonly input;
+    private readonly flags;
+    private readonly blackboard;
+    private readonly frameIndex;
+    private readonly timeSeconds;
+    private readonly renderSource;
+    constructor(input: RendererFrameHooksInput);
+    private forwardTarget;
+    /**
+     * R-01-1: the Renderer hands the forward color target in after
+     * `ensureForwardColorTarget`; `ctx.sceneDepth` then exposes the real depth
+     * texture and the blackboard publishes it at `"prd01.forwardTarget"`.
+     */
+    setForwardTarget(target: RenderTarget | null): void;
+    private sceneDepthCopy;
+    /** Lane 01 publishes the scene-depth copy target before the after-opaque phase. */
+    setSceneDepthCopy(target: RenderTarget | null): void;
+    /** Read a blackboard value published by a contributor (or lane 01 itself). */
+    blackboardValue<T>(key: string): T | undefined;
+    /**
+     * §6.2.7: publish the frame's forward output encoding as
+     * `"prd01.outputColorSpace"` — "linear" when the frame renders into an HDR
+     * target that a later pass encodes (postprocess chain or OutputPass), else
+     * the legacy in-shader "srgb" encode. Lane passes (particles, beams,
+     * ribbons) read it through `resolveOutputColorSpace`; nothing published it,
+     * so they sRGB/filmic-encoded into the linear HDR target and were encoded a
+     * second time downstream (washed-out, near-white particles).
+     */
+    setOutputColorSpace(space: "linear" | "srgb"): void;
+    private context;
+    /** "collect" phase — contributor item-list transforms, applied in order. */
+    collect(items: readonly RenderItem[]): readonly RenderItem[];
+    /** Graph-attached phases — contributor passes appended to the render graph. */
+    addPasses(graph: RenderGraph, phase: AuraFramePhase, items: readonly RenderItem[]): void;
+    /**
+     * "transparent" phase queue: contributor `TransparentQueueItem`s plus the
+     * context they draw with, so the Renderer can interleave them with forward
+     * transparents by `sortDepth` (§8.4 step 1) instead of drawing them in a
+     * block after the pass. Empty when no contributor emits queue items.
+     */
+    transparentQueues(items: readonly RenderItem[]): {
+        readonly ctx: FrameContributorContext;
+        readonly queues: readonly TransparentQueueItem[];
+    };
+    /** Contributor `passes("transparent")` only — queue items are handled by transparentQueues(). */
+    addTransparentContributorPasses(graph: RenderGraph, items: readonly RenderItem[]): void;
+    /** Direct phases executed outside the graph (post-hdr, after-output). */
+    runPhase(phase: AuraFramePhase, items: readonly RenderItem[], enabled?: boolean): void;
+    runPhaseAsync(phase: AuraFramePhase, items: readonly RenderItem[], enabled?: boolean): Promise<void>;
+}
+export declare function createRendererFrameHooks(input: RendererFrameHooksInput): RendererFrameHooks;
+//# sourceMappingURL=FrameGraph.d.ts.map

package/dist/rendering/renderer/FrameGraph.d.ts.map

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