@aura3d/engine 3.0.0 → 4.0.0

package/dist/rendering/resources/MorphTargetTexture.js

@@ -0,0 +1,135 @@
+/**
+ * C-18 (PRD-06): `buildMorphTargetTexture` — packs morph-target deltas into a
+ * `sampler2DArray` texture, the GPU path that lifts the uniform-array cap
+ * (E-17/E-19). Layout follows §8.2: texel index `j = vertexId * stride + attr`
+ * flattens into `(x = j % width, y = j / width)` and `z = target` (one array
+ * layer per morph target), where `attr` is 0 = position delta, 1 = normal
+ * delta, 2 = tangent delta and `stride` the layer count. Target counts are
+ * bucketed into {4, 8, 16, 32}; beyond 32 the set is truncated with a
+ * `MORPH_TARGETS_TRUNCATED` warning (C-18 invariants).
+ *
+ * The result is a `Texture` with `dimension: "2d-array"`: on `update()`
+ * revision bumps `webgl2/TextureUpload.ts` re-uploads per layer via
+ * `texSubImage3D` instead of reallocating (T0.10a).
+ */
+import { Texture } from "../Texture.js";
+export const MORPH_TARGET_COUNT_BUCKETS = [4, 8, 16, 32];
+export const MORPH_LAYER_POSITION = 0;
+export const MORPH_LAYER_NORMAL = 1;
+export const MORPH_LAYER_TANGENT = 2;
+export const MORPH_MAX_TEXTURE_LAYERS = 3;
+/** Smallest bucket that can hold `count` targets; `null` when it exceeds 32. */
+export function morphTargetBucket(count) {
+    for (const bucket of MORPH_TARGET_COUNT_BUCKETS) {
+        if (count <= bucket)
+            return bucket;
+    }
+    return null;
+}
+let truncationsWarned = 0;
+/**
+ * Build the morph-delta array texture for a geometry/target set. Contract-doc
+ * signature (`geometry, targets, limits, format`); the PR-0a
+ * `contracts/deform.ts` stub keeps `PRD06_PENDING` until owner 01 re-points it
+ * (qr-request Q-01-CCR-06-6).
+ */
+export function buildMorphTargetTexture(geometry, targets, limits, format = "rgba16f") {
+    const vertexCount = geometry.vertexBuffer.vertexCount;
+    if (vertexCount <= 0) {
+        return { fallback: "cpu", reason: "geometry has no vertices" };
+    }
+    if (vertexCount > limits.maxTextureSize) {
+        return { fallback: "cpu", reason: `vertexCount ${vertexCount} exceeds maxTextureSize ${limits.maxTextureSize}` };
+    }
+    let packedTargets = targets;
+    if (targets.length > 32) {
+        packedTargets = targets.slice(0, 32);
+        if (truncationsWarned < 8 && typeof console !== "undefined") {
+            truncationsWarned += 1;
+            console.warn(`MORPH_TARGETS_TRUNCATED:${targets.length}->32`);
+        }
+    }
+    const bucket = morphTargetBucket(packedTargets.length);
+    if (!bucket) {
+        return { fallback: "cpu", reason: `targetCount ${packedTargets.length} exceeds the {4,8,16,32} bucket ceiling` };
+    }
+    if (bucket > limits.maxArrayLayers) {
+        return { fallback: "cpu", reason: `target bucket ${bucket} exceeds maxArrayLayers ${limits.maxArrayLayers}` };
+    }
+    const hasNormals = packedTargets.some((target) => (target.normals?.length ?? 0) > 0);
+    const hasTangents = packedTargets.some((target) => (target.tangents?.length ?? 0) > 0);
+    const stride = 1 + (hasNormals ? 1 : 0) + (hasTangents ? 1 : 0);
+    // §8.2: texel j = vertexId*stride+attr flattened over (width, height); z = target.
+    const texelsPerLayer = vertexCount * stride;
+    const width = Math.min(limits.maxTextureSize, texelsPerLayer);
+    const height = Math.ceil(texelsPerLayer / width);
+    if (height > limits.maxTextureSize) {
+        return { fallback: "cpu", reason: `morph texel height ${height} exceeds maxTextureSize ${limits.maxTextureSize}` };
+    }
+    const data = new Float32Array(width * height * 4 * bucket);
+    const layerStride = width * height * 4;
+    for (let t = 0; t < packedTargets.length; t += 1) {
+        const target = packedTargets[t];
+        const layerOffset = t * layerStride;
+        for (let v = 0; v < vertexCount; v += 1) {
+            writeDelta(data, layerOffset + (v * stride + MORPH_LAYER_POSITION) * 4, target.positions?.[v]);
+            if (hasNormals) {
+                writeDelta(data, layerOffset + (v * stride + MORPH_LAYER_NORMAL) * 4, target.normals?.[v]);
+            }
+            if (hasTangents) {
+                writeDelta(data, layerOffset + (v * stride + MORPH_LAYER_TANGENT) * 4, target.tangents?.[v]);
+            }
+        }
+    }
+    const texture = new Texture({
+        width,
+        height,
+        layers: bucket,
+        dimension: "2d-array",
+        format: format,
+        colorSpace: "linear",
+        label: `aura3d-morph-targets-${vertexCount}x${bucket}x${stride}`,
+        // rgba16f uploads take Uint16Array half-floats (Texture.ts validation);
+        // rgba32f takes the Float32Array as packed.
+        data: format === "rgba16f" ? float32ArrayToFloat16(data) : data
+    });
+    return {
+        texture,
+        targetCount: packedTargets.length,
+        hasNormals,
+        hasTangents,
+        stride,
+        bucket,
+        targets: packedTargets
+    };
+}
+function writeDelta(out, offset, delta) {
+    out[offset] = delta?.[0] ?? 0;
+    out[offset + 1] = delta?.[1] ?? 0;
+    out[offset + 2] = delta?.[2] ?? 0;
+    out[offset + 3] = delta?.[3] ?? 0;
+}
+/** IEEE-754 binary32 → binary16 for every element (round-half-up; subnormals flush to zero). */
+export function float32ArrayToFloat16(input) {
+    const out = new Uint16Array(input.length);
+    const f32 = new Float32Array(1);
+    const u32 = new Uint32Array(f32.buffer);
+    for (let i = 0; i < input.length; i += 1) {
+        f32[0] = input[i];
+        const x = u32[0];
+        const sign = (x >>> 16) & 0x8000;
+        const exponent = ((x >>> 23) & 0xff) - 112;
+        if (exponent <= 0) {
+            out[i] = sign; // underflow to signed zero (morph deltas are small; subnormals unnecessary)
+        }
+        else if (exponent >= 31) {
+            out[i] = sign | 0x7bff; // saturate to max half
+        }
+        else {
+            const mantissa = (x & 0x7fffff) + 0x1000; // round-half-up on the dropped bits
+            out[i] = sign | (exponent << 10) | (mantissa >> 13);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=MorphTargetTexture.js.map

package/dist/rendering/resources/MorphTargetTexture.js.map

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

package/dist/rendering/resources/RenderTargetPool.d.ts

@@ -0,0 +1,47 @@
+/**
+ * PRD 11 Phase 2 (§6.8) — real C-28 `renderTargetPoolSlot` provider.
+ *
+ * Postprocess chains used to call `device.createRenderTarget` per pass per
+ * frame (`renderer/PostprocessExecution.ts`, four sites). This pool reuses
+ * idle targets keyed by `(width, height, format, samples, depth)` so the C-28
+ * `renderTargetsCreated` counter stays at zero after warm-up. Lane 03 swaps
+ * the post-execution `createRenderTarget` calls for `acquire`/`release` and
+ * calls `trim` once per frame (request Q-03-1, behind `A3D_QR_TIERS`).
+ */
+import type { RenderDevice, RenderTarget } from "../RenderDevice.js";
+import type { TextureFormat } from "../Texture.js";
+import type { RenderTargetPoolLike } from "../contracts/device.js";
+export type RenderTargetPoolDesc = {
+    readonly width: number;
+    readonly height: number;
+    readonly format: TextureFormat;
+    readonly samples: 1 | 4;
+    readonly depth: boolean;
+};
+export declare class RenderTargetPool implements RenderTargetPoolLike {
+    private readonly device;
+    private readonly idle;
+    private readonly owned;
+    /** `trim` generation counter — bumped once per `trim` call (one frame). */
+    private generation;
+    private createdCount;
+    constructor(device: RenderDevice);
+    acquire(desc: RenderTargetPoolDesc): RenderTarget;
+    release(target: RenderTarget): void;
+    /** Dispose targets idle for longer than `maxIdleFrames` `trim` generations. */
+    trim(maxIdleFrames: number): void;
+    /**
+     * PRD 11 Phase 5 (§6.9): after a context loss every pooled target's GL
+     * framebuffer is dead. Drop them all; `acquire` re-creates on next frame.
+     * Registered with the C-29 `ResourceRegistry` as kind `a3d-prd11-rt-pool`.
+     */
+    rebuildForRestore(): void;
+    /** Diagnostics for tests and the `renderer.batching`/`frame` counters. */
+    poolStats(): {
+        readonly idle: number;
+        readonly inUse: number;
+        readonly created: number;
+    };
+    private descFor;
+}
+//# sourceMappingURL=RenderTargetPool.d.ts.map

package/dist/rendering/resources/RenderTargetPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderTargetPool.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/resources/RenderTargetPool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAA0B,MAAM,iBAAiB,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;AAyBF,qBAAa,gBAAiB,YAAW,oBAAoB;IAO/C,OAAO,CAAC,QAAQ,CAAC,MAAM;IANnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,2EAA2E;IAC3E,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,YAAY,CAAK;gBAEI,MAAM,EAAE,YAAY;IAEjD,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,YAAY;IAYjD,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAanC,+EAA+E;IAC/E,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAcjC;;;;OAIG;IACH,iBAAiB,IAAI,IAAI;IAYzB,0EAA0E;IAC1E,SAAS,IAAI;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAMxF,OAAO,CAAC,OAAO;CAShB"}

package/dist/rendering/resources/RenderTargetPool.js

@@ -0,0 +1,113 @@
+/**
+ * PRD 11 Phase 2 (§6.8) — real C-28 `renderTargetPoolSlot` provider.
+ *
+ * Postprocess chains used to call `device.createRenderTarget` per pass per
+ * frame (`renderer/PostprocessExecution.ts`, four sites). This pool reuses
+ * idle targets keyed by `(width, height, format, samples, depth)` so the C-28
+ * `renderTargetsCreated` counter stays at zero after warm-up. Lane 03 swaps
+ * the post-execution `createRenderTarget` calls for `acquire`/`release` and
+ * calls `trim` once per frame (request Q-03-1, behind `A3D_QR_TIERS`).
+ */
+function poolKey(desc) {
+    return `${desc.width}x${desc.height}:${desc.format}:s${desc.samples}:d${desc.depth ? 1 : 0}`;
+}
+function toRenderTargetDescriptor(desc) {
+    return {
+        width: desc.width,
+        height: desc.height,
+        label: "render-target-pool",
+        // The pool contract narrows format to colour formats the post chain uses.
+        format: desc.format,
+        sampleCount: desc.samples === 4 ? 4 : undefined,
+        // `true` maps to a sampleable depth texture so guarded depth passes stay GPU-side.
+        depth: desc.depth ? "texture" : false
+    };
+}
+export class RenderTargetPool {
+    device;
+    idle = new Map();
+    owned = new Set();
+    /** `trim` generation counter — bumped once per `trim` call (one frame). */
+    generation = 0;
+    createdCount = 0;
+    constructor(device) {
+        this.device = device;
+    }
+    acquire(desc) {
+        const key = poolKey(desc);
+        const bucket = this.idle.get(key);
+        const entry = bucket?.pop();
+        if (bucket && bucket.length === 0)
+            this.idle.delete(key);
+        if (entry)
+            return entry.target;
+        const target = this.device.createRenderTarget(toRenderTargetDescriptor(desc));
+        this.owned.add(target);
+        this.createdCount += 1;
+        return target;
+    }
+    release(target) {
+        // Only pool targets this pool created; foreign targets are ignored, never
+        // disposed — callers may hand us targets they do not own.
+        if (!this.owned.has(target))
+            return;
+        const desc = this.descFor(target);
+        let bucket = this.idle.get(poolKey(desc));
+        if (!bucket) {
+            bucket = [];
+            this.idle.set(poolKey(desc), bucket);
+        }
+        bucket.push({ target, idleSince: this.generation });
+    }
+    /** Dispose targets idle for longer than `maxIdleFrames` `trim` generations. */
+    trim(maxIdleFrames) {
+        this.generation += 1;
+        for (const [key, bucket] of this.idle) {
+            const kept = bucket.filter((entry) => {
+                if (this.generation - entry.idleSince <= maxIdleFrames)
+                    return true;
+                entry.target.dispose();
+                this.owned.delete(entry.target);
+                return false;
+            });
+            if (kept.length === 0)
+                this.idle.delete(key);
+            else if (kept.length !== bucket.length)
+                this.idle.set(key, kept);
+        }
+    }
+    /**
+     * PRD 11 Phase 5 (§6.9): after a context loss every pooled target's GL
+     * framebuffer is dead. Drop them all; `acquire` re-creates on next frame.
+     * Registered with the C-29 `ResourceRegistry` as kind `a3d-prd11-rt-pool`.
+     */
+    rebuildForRestore() {
+        for (const target of this.owned) {
+            try {
+                target.dispose();
+            }
+            catch {
+                // Disposal failure on a dead context is non-fatal.
+            }
+        }
+        this.owned.clear();
+        this.idle.clear();
+    }
+    /** Diagnostics for tests and the `renderer.batching`/`frame` counters. */
+    poolStats() {
+        let idle = 0;
+        for (const bucket of this.idle.values())
+            idle += bucket.length;
+        return { idle, inUse: this.owned.size - idle, created: this.createdCount };
+    }
+    descFor(target) {
+        return {
+            width: target.width,
+            height: target.height,
+            format: target.colorTexture.format,
+            samples: (target.sampleCount === 4 ? 4 : 1),
+            depth: Boolean(target.depthTexture)
+        };
+    }
+}
+//# sourceMappingURL=RenderTargetPool.js.map

package/dist/rendering/resources/RenderTargetPool.js.map

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

package/dist/rendering/resources/ResourceRegistry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * PRD 11 Phase 5 — real C-29 `ResourceRegistry` (`resourceRegistrySlot`
+ * provider). Records registered GPU resources' creation descriptors plus
+ * optional CPU-side source handles (§6.9):
+ *
+ * - `rebuild(device)` re-creates every registered resource eagerly. Entries
+ *   whose CPU source was released under the memory policy are refetched
+ *   first (`refetch`) and counted in `refetched`.
+ * - `setRetentionPolicy(retain)` implements the §6.9 item-3 rule the
+ *   `RetentionPolicy` helper resolves per tier: when `retain` is false,
+ *   entries that did not opt into `retainForRestore` release their decoded
+ *   sources (`releaseSource`) and must `refetch` on the next rebuild.
+ *
+ * The contract descriptor (`{kind, rebuild}`) remains valid input; the extra
+ * fields are additive and optional.
+ */
+import type { RenderDevice } from "../RenderDevice.js";
+import type { ResourceRegistryLike } from "../contracts/rendererFactory.js";
+export interface ResourceDescriptor {
+    readonly kind: string;
+    /** Re-create the GPU resource from the recorded descriptor/CPU source. */
+    readonly rebuild: () => Promise<void> | void;
+    /** Re-fetch a released CPU source before rebuild (network/decoded data). */
+    readonly refetch?: () => Promise<void> | void;
+    /** Drop the CPU-side source (post-upload memory policy). */
+    readonly releaseSource?: () => void;
+    /** True keeps the CPU source even under the release policy (High/Ultra). */
+    readonly retainForRestore?: boolean;
+}
+export declare class ResourceRegistry implements ResourceRegistryLike {
+    private readonly entries;
+    private retain;
+    register<T extends object>(handle: T, descriptor: ResourceDescriptor | {
+        readonly kind: string;
+        readonly rebuild: () => Promise<void> | void;
+    }): T;
+    unregister(handle: object): void;
+    /** §6.9 memory policy. `false` releases every non-retained CPU source now. */
+    setRetentionPolicy(retain: boolean): void;
+    get size(): number;
+    rebuild(_device: RenderDevice): Promise<{
+        readonly rebuilt: number;
+        readonly refetched: number;
+        readonly failed: readonly string[];
+    }>;
+}
+export declare function sharedResourceRegistry(): ResourceRegistry;
+//# sourceMappingURL=ResourceRegistry.d.ts.map

package/dist/rendering/resources/ResourceRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceRegistry.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/resources/ResourceRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7C,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9C,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAQD,qBAAa,gBAAiB,YAAW,oBAAoB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,MAAM,CAAQ;IAEtB,QAAQ,CAAC,CAAC,SAAS,MAAM,EACvB,MAAM,EAAE,CAAC,EACT,UAAU,EAAE,kBAAkB,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;KAAE,GACvG,CAAC;IAeJ,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIhC,8EAA8E;IAC9E,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAiBzC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;CAoB5I;AAUD,wBAAgB,sBAAsB,IAAI,gBAAgB,CAGzD"}

package/dist/rendering/resources/ResourceRegistry.js

@@ -0,0 +1,95 @@
+/**
+ * PRD 11 Phase 5 — real C-29 `ResourceRegistry` (`resourceRegistrySlot`
+ * provider). Records registered GPU resources' creation descriptors plus
+ * optional CPU-side source handles (§6.9):
+ *
+ * - `rebuild(device)` re-creates every registered resource eagerly. Entries
+ *   whose CPU source was released under the memory policy are refetched
+ *   first (`refetch`) and counted in `refetched`.
+ * - `setRetentionPolicy(retain)` implements the §6.9 item-3 rule the
+ *   `RetentionPolicy` helper resolves per tier: when `retain` is false,
+ *   entries that did not opt into `retainForRestore` release their decoded
+ *   sources (`releaseSource`) and must `refetch` on the next rebuild.
+ *
+ * The contract descriptor (`{kind, rebuild}`) remains valid input; the extra
+ * fields are additive and optional.
+ */
+export class ResourceRegistry {
+    entries = new Map();
+    retain = true;
+    register(handle, descriptor) {
+        const full = descriptor;
+        const entry = { descriptor: full, sourceReleased: false };
+        this.entries.set(handle, entry);
+        if (!this.retain && !full.retainForRestore && full.releaseSource) {
+            try {
+                full.releaseSource();
+                entry.sourceReleased = true;
+            }
+            catch {
+                // Release failures are non-fatal: the source simply stays retained.
+            }
+        }
+        return handle;
+    }
+    unregister(handle) {
+        this.entries.delete(handle);
+    }
+    /** §6.9 memory policy. `false` releases every non-retained CPU source now. */
+    setRetentionPolicy(retain) {
+        if (this.retain === retain)
+            return;
+        this.retain = retain;
+        if (retain)
+            return;
+        for (const entry of this.entries.values()) {
+            const { descriptor } = entry;
+            if (!descriptor.retainForRestore && descriptor.releaseSource && !entry.sourceReleased) {
+                try {
+                    descriptor.releaseSource();
+                    entry.sourceReleased = true;
+                }
+                catch {
+                    // Non-fatal: the entry stays usable, just heavier.
+                }
+            }
+        }
+    }
+    get size() {
+        return this.entries.size;
+    }
+    async rebuild(_device) {
+        let rebuilt = 0;
+        let refetched = 0;
+        const failed = [];
+        for (const entry of this.entries.values()) {
+            const { descriptor } = entry;
+            try {
+                if (entry.sourceReleased && descriptor.refetch) {
+                    await descriptor.refetch();
+                    entry.sourceReleased = false;
+                    refetched += 1;
+                }
+                await descriptor.rebuild();
+                rebuilt += 1;
+            }
+            catch {
+                failed.push(descriptor.kind);
+            }
+        }
+        return { rebuilt, refetched, failed };
+    }
+}
+/**
+ * Lane-11 shared registry instance. `lanes/prd11.ts` provides it through
+ * `resourceRegistrySlot`, and lane-owned resources (render-target pool,
+ * DrawDataTexture, BatchedGeometryPool arenas) self-register against it so
+ * `installDeviceRestoreRebuild` recreates them on context restore.
+ */
+let shared = null;
+export function sharedResourceRegistry() {
+    if (!shared)
+        shared = new ResourceRegistry();
+    return shared;
+}
+//# sourceMappingURL=ResourceRegistry.js.map

package/dist/rendering/resources/ResourceRegistry.js.map

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

package/dist/rendering/resources/UniformBlock.d.ts

@@ -0,0 +1,90 @@
+/**
+ * C-08 (PRD-01 §8.2, Phase 3) — std140 packer + `AuraFrame` UBO.
+ *
+ * `layoutStd140` computes the std140 offsets of a block field list; `UniformBlock`
+ * owns a `BufferUsage:"uniform"` buffer, a Float32Array staging view and
+ * `bindBufferBase` wiring through `RenderDevice.bindUniformBuffer`. `FrameUniforms`
+ * is the real `FrameUniformsLike`: `AuraFrame` at binding 0 in the frozen C-08
+ * order, uploaded once per `update()` via `bufferSubData`.
+ *
+ * The block's GLSL declaration is emitted from the same field list, so generated
+ * sources can never drift from the packed layout.
+ */
+import type { RenderDevice, RenderBuffer } from "../RenderDevice.js";
+import { type FrameUniformsLike } from "../contracts/frameUniforms.js";
+import type { FrameCamera } from "../contracts/frameGraph.js";
+export type Std140Field = readonly [name: string, type: string];
+interface Std140FieldLayout {
+    readonly name: string;
+    readonly type: string;
+    readonly offset: number;
+    /** Element stride in floats; matrices are packed column-major at 16-byte column stride. */
+    readonly floats: number;
+}
+export interface Std140Layout {
+    readonly byteSize: number;
+    readonly fields: readonly Std140FieldLayout[];
+    readonly offsets: ReadonlyMap<string, number>;
+}
+/** Compute the std140 layout of `fields` (block size is 16-aligned). */
+export declare function layoutStd140(fields: readonly Std140Field[]): Std140Layout;
+/**
+ * Emit `layout(std140) uniform <name> { <type> <field>; ... };` for a block.
+ * T0-02: declarations carry no baked `binding=` — the device assigns the named
+ * block → binding-point mapping with `gl.uniformBlockBinding` post-link.
+ */
+export declare function uniformBlockGlsl(name: string, fields: readonly Std140Field[]): string;
+/**
+ * A std140 uniform block: one `BufferUsage:"uniform"` buffer plus a Float32Array
+ * staging image. `set*` writes into staging; `upload()` pushes it with a single
+ * `bufferSubData` (PRD-01: uploaded once per view).
+ */
+export declare class UniformBlock {
+    private readonly device;
+    readonly name: string;
+    readonly layout: Std140Layout;
+    readonly buffer: RenderBuffer;
+    readonly binding: number;
+    /** CPU staging image of the whole block (float units). */
+    readonly data: Float32Array;
+    constructor(device: RenderDevice, name: string, fields: readonly Std140Field[], options?: {
+        readonly binding?: number;
+    });
+    private offsetOf;
+    /** Write a scalar/vector/matrix field (column-major for matrices). */
+    set(name: string, value: ArrayLike<number>): void;
+    /** Push the staging image to the GPU once (bufferSubData over the whole block). */
+    upload(): void;
+    /** `bindBufferBase(UNIFORM_BUFFER, binding, buffer)`. */
+    bind(): void;
+    dispose(): void;
+}
+/** AuraFrame binding point (C-08 frozen). */
+export declare const AURA_FRAME_BINDING = 0;
+/** AuraLights binding point; layout owned by PRD 02 inside the C-08 name. */
+export declare const AURA_LIGHTS_BINDING = 1;
+/**
+ * C-08 real `FrameUniformsLike`: the `AuraFrame` block at binding 0. `update()`
+ * packs the frozen field order and uploads once; `viewport` must be refreshed by
+ * the caller per view so `u_resolutionFarTime.xy` reports render pixels.
+ */
+export declare class FrameUniforms implements FrameUniformsLike {
+    readonly block: UniformBlock;
+    /** Render-target pixels for `u_resolutionFarTime.xy`; caller sets per view. */
+    viewport: {
+        width: number;
+        height: number;
+    };
+    constructor(device: RenderDevice, options?: {
+        readonly binding?: number;
+    });
+    get buffer(): RenderBuffer | null;
+    get byteSize(): number;
+    /** GLSL declaration for generated programs (`layout(std140)`; bound at link). */
+    glsl(): string;
+    update(camera: FrameCamera, timeSeconds: number, exposure: number, flags: number): void;
+    bind(): void;
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=UniformBlock.d.ts.map

package/dist/rendering/resources/UniformBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniformBlock.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/resources/UniformBlock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAEhE,UAAU,iBAAiB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C;AA4BD,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,YAAY,CAezE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAGrF;AAED;;;;GAIG;AACH,qBAAa,YAAY;IAQrB,OAAO,CAAC,QAAQ,CAAC,MAAM;aACP,IAAI,EAAE,MAAM;IAR9B,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,0DAA0D;IAC1D,SAAgB,IAAI,EAAE,YAAY,CAAC;gBAGhB,MAAM,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,EAC5B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,OAAO,GAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IAQ7C,OAAO,CAAC,QAAQ;IAWhB,sEAAsE;IACtE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI;IAkBjD,mFAAmF;IACnF,MAAM,IAAI,IAAI;IAId,yDAAyD;IACzD,IAAI,IAAI,IAAI;IAIZ,OAAO,IAAI,IAAI;CAGhB;AAED,6CAA6C;AAC7C,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;;;GAIG;AACH,qBAAa,aAAc,YAAW,iBAAiB;IACrD,SAAgB,KAAK,EAAE,YAAY,CAAC;IACpC,+EAA+E;IACxE,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAA2B;gBAEjE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IAM7E,IAAI,MAAM,IAAI,YAAY,GAAG,IAAI,CAEhC;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,iFAAiF;IACjF,IAAI,IAAI,MAAM;IAId,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAYvF,IAAI,IAAI,IAAI;IAIZ,OAAO,IAAI,IAAI;CAGhB"}