@aura3d/engine 3.0.0 → 4.0.0

package/dist/rendering/post/PostGraph.js

@@ -0,0 +1,234 @@
+/**
+ * PRD-03 — C-13 real: the v2 post graph.
+ *
+ * Phase 2 replaces the Phase-0 "everything withheld" planner with the real
+ * stage-descriptor table of PRD-03 §6.1: fixed order, per-stage output format
+ * and scale, `enabled(options)` predicates, and C-13 custom-pass insertion
+ * with `space` validation (a `display` pass before tonemap throws
+ * `POSTPROCESS_SPACE_INVALID:<id>`). Stages this phase does not yet execute
+ * are placed in `stages` for order truth and also reported under `skipped`
+ * with reason `post-v2-deferred:phase-N`.
+ *
+ * GPU execution lives in `webgl2/LegacyPost.ts` (`executePostGraphWebGL2`),
+ * which drives `post/v2Stages.ts` (`runV2HdrStages` / `runV2LdrTail`) and is
+ * reached from `renderer/PostprocessExecution.ts`. C-13 custom passes
+ * (`app.addPostPass` → the pass registry, plus `pipeline.customPasses`) run at
+ * all five §6.1 anchors there. `PostGraph.execute` is the no-device entry: it
+ * validates and returns the plan the executor runs (03-S18c).
+ */
+import { defineContractSlot } from "../contracts/core.js";
+import { registeredPostPasses, validatePostPassSpace as contractsValidatePostPassSpace } from "../contracts/post.js";
+/** Depth is linearized when a stage consumes scene depth or camera velocity. */
+function depthPrepEnabled(options) {
+    return Boolean(options.ao || options.ssr || options.godRays || options.dof
+        || options.motionBlur || options.antiAliasing === "taa" || options.taa);
+}
+function autoExposureRequested(options) {
+    const value = options.autoExposure;
+    return Boolean(value) && value !== false;
+}
+/**
+ * §6.1 fixed order. The MSAA resolve (S0) is a blit owned by the forward pass,
+ * not a post stage, so it is absent. `OUT` is the C-05 `OutputPass` boundary:
+ * the only stage that consumes linear HDR and produces display space.
+ */
+export const POST_STAGE_DESCRIPTORS = [
+    {
+        id: "S1-depth-prep", space: "linear-hdr", inputs: ["depth"],
+        output: { format: "r32f", scale: 1 },
+        enabled: depthPrepEnabled,
+        implemented: () => true, phase: 3
+    },
+    {
+        id: "S2-gtao", space: "linear-hdr", inputs: ["depth"],
+        output: { format: "r8", scale: 0.5 },
+        enabled: (o) => Boolean(o.ao),
+        implemented: () => true, phase: 3
+    },
+    {
+        id: "S3-ssr", space: "linear-hdr", inputs: ["color", "depth"],
+        output: { format: "rgba16f", scale: 0.5 },
+        enabled: (o) => Boolean(o.ssr), phase: 3
+    },
+    {
+        id: "S4-god-rays", space: "linear-hdr", inputs: ["color", "depth"],
+        output: { format: "rgba16f", scale: 0.5 },
+        enabled: (o) => Boolean(o.godRays),
+        implemented: () => true, phase: 3
+    },
+    {
+        id: "S5-taa", space: "linear-hdr", inputs: ["color", "velocity", "depth"],
+        output: { format: "rgba16f", scale: 1 },
+        enabled: (o) => o.antiAliasing === "taa" || Boolean(o.taa), phase: 4
+    },
+    {
+        id: "S6-dof", space: "linear-hdr", inputs: ["color", "depth"],
+        output: { format: "rgba16f", scale: 0.5 },
+        enabled: (o) => Boolean(o.dof), phase: 4
+    },
+    {
+        id: "S7-motion-blur", space: "linear-hdr", inputs: ["color", "velocity"],
+        output: { format: "rgba16f", scale: 1 },
+        enabled: (o) => Boolean(o.motionBlur), phase: 4
+    },
+    {
+        id: "S8-auto-exposure", space: "linear-hdr", inputs: ["color"],
+        output: { format: "r32f", scale: 1 }, fixedSize: [1, 1],
+        enabled: autoExposureRequested, implemented: () => true, phase: 6
+    },
+    {
+        id: "S9-bloom", space: "linear-hdr", inputs: ["color"],
+        output: { format: "rgba16f", scale: 0.5 },
+        enabled: (o) => Boolean(o.bloom), phase: 2
+    },
+    {
+        id: "S10-composite", space: "linear-hdr", inputs: ["color"],
+        output: { format: "rgba16f", scale: 1 },
+        enabled: () => true, phase: 2
+    },
+    {
+        // C-05 boundary: consumes linear HDR, produces display-referred RGBA8.
+        id: "OUT-output-pass", space: "display", inputs: ["color"],
+        output: { format: "rgba8", scale: 1 },
+        enabled: () => true, phase: 2
+    },
+    {
+        id: "S10b-display-grade", space: "display", inputs: ["color"],
+        output: { format: "rgba8", scale: 1 },
+        enabled: (o) => Boolean(o.grade || o.lut || o.vignette), phase: 2
+    },
+    {
+        id: "S11-post-aa", space: "display", inputs: ["color"],
+        output: { format: "rgba8", scale: 1 },
+        enabled: (o) => o.antiAliasing === "fxaa" || o.antiAliasing === "smaa",
+        implemented: (o) => o.antiAliasing === "fxaa" || o.antiAliasing === "smaa",
+        phase: 6
+    },
+    {
+        // Writes the default framebuffer: grain, RCAS, triangular dither.
+        id: "S12-finalize", space: "display", inputs: ["color"],
+        output: { format: "rgba8", scale: 1 },
+        enabled: () => true, phase: 2
+    }
+];
+/* ------------------------------------------------------------------ */
+/* C-13 custom-pass insertion.                                           */
+/* ------------------------------------------------------------------ */
+/** insertAt anchor → §6.1 stage the pass binds after/before. */
+export const POST_INSERT_ANCHORS = {
+    "after-depth": { after: "S1-depth-prep", space: "linear-hdr" },
+    "before-taa": { before: "S5-taa", space: "linear-hdr" },
+    "after-taa": { after: "S5-taa", space: "linear-hdr" },
+    "before-tonemap": { before: "OUT-output-pass", space: "linear-hdr" },
+    "after-tonemap": { after: "S10b-display-grade", space: "display" }
+};
+/** C-13 rule: `space` must be "linear-hdr" unless insertAt === "after-tonemap". */
+export function validatePostPassSpace(pass) {
+    contractsValidatePostPassSpace(pass);
+}
+function stageSize(descriptor, frame) {
+    if (descriptor.fixedSize)
+        return { width: descriptor.fixedSize[0], height: descriptor.fixedSize[1] };
+    return {
+        width: Math.max(1, Math.round(frame.width * descriptor.output.scale)),
+        height: Math.max(1, Math.round(frame.height * descriptor.output.scale))
+    };
+}
+/**
+ * Plans the v2 chain: every enabled §6.1 stage plus C-13 custom passes at
+ * their insertion anchors, in execution order. Entries that are enabled but
+ * not yet implemented (or a deferred custom pass) also land in `skipped`
+ * with reason `post-v2-deferred:phase-N` — never silently dropped.
+ */
+export function planPostGraph(options, frame) {
+    const entries = [];
+    for (const descriptor of POST_STAGE_DESCRIPTORS) {
+        if (!descriptor.enabled(options))
+            continue;
+        const size = stageSize(descriptor, frame);
+        const implemented = descriptor.implemented ? descriptor.implemented(options) : descriptor.phase <= 2;
+        entries.push({
+            name: descriptor.id,
+            format: descriptor.output.format,
+            width: size.width,
+            height: size.height,
+            anchor: descriptor.id,
+            after: false,
+            custom: false,
+            deferredReason: implemented ? null : `post-v2-deferred:phase-${descriptor.phase}`
+        });
+    }
+    const customPasses = [...(options.customPasses ?? []), ...registeredPostPasses()];
+    for (const pass of customPasses) {
+        validatePostPassSpace(pass);
+        const anchor = POST_INSERT_ANCHORS[pass.insertAt];
+        entries.push({
+            name: pass.id,
+            format: pass.space === "display" ? "rgba8" : "rgba16f",
+            width: frame.width,
+            height: frame.height,
+            anchor: anchor.before ?? anchor.after ?? "S10-composite",
+            after: anchor.after !== undefined,
+            custom: true,
+            deferredReason: null // C-13 execution landed in Phase 6
+        });
+    }
+    // Resolve order: table order first; customs splice around their anchor.
+    const tableIndex = new Map(POST_STAGE_DESCRIPTORS.map((d, i) => [d.id, i]));
+    entries.sort((a, b) => {
+        const ai = tableIndex.get(a.name) ?? tableIndex.get(a.anchor) + (a.after ? 0.5 : -0.5);
+        const bi = tableIndex.get(b.name) ?? tableIndex.get(b.anchor) + (b.after ? 0.5 : -0.5);
+        if (ai !== bi)
+            return ai - bi;
+        // Stable secondary: customs after their anchor keep registration order.
+        return 0;
+    });
+    const stages = entries.map((entry) => ({ name: entry.name, format: entry.format, width: entry.width, height: entry.height }));
+    const skipped = entries
+        .filter((entry) => entry.deferredReason !== null)
+        .map((entry) => ({ name: entry.name, reason: entry.deferredReason }));
+    return { stages, skipped };
+}
+/** Skip reason for registered custom passes while the legacy chain serves the frame. */
+export const POST_LEGACY_CHAIN_REASON = "legacy-chain:A3D_QR_POST-off";
+/**
+ * C-13 slot default: the legacy chain's view of the graph. With `A3D_QR_POST`
+ * off no v2 stage runs, so any registered custom pass is reported as skipped
+ * by the legacy chain (never silently dropped).
+ */
+export class LegacyPostGraph {
+    kind = "legacy";
+    plan(_options, _frame) {
+        return {
+            stages: [],
+            skipped: registeredPostPasses().map((pass) => ({ name: pass.id, reason: POST_LEGACY_CHAIN_REASON }))
+        };
+    }
+}
+/** C-13 real: plans the §6.1 chain; GPU work is dispatched by the executor. */
+export class PostGraph {
+    kind = "v2";
+    plan(options, frame) {
+        return planPostGraph(options, frame);
+    }
+    /**
+     * No-device entry (03-S18c): validates every custom pass (a display pass
+     * before tonemap throws `POSTPROCESS_SPACE_INVALID:<id>`) and returns the
+     * plan, in execution order, that `runV2HdrStages`/`runV2LdrTail` execute.
+     */
+    execute(options, frame) {
+        return planPostGraph(options, frame);
+    }
+}
+/**
+ * The C-13 slot (contract id `C-13`, flag `A3D_QR_POST`). PR 0's frozen surface
+ * declares no slot in `contracts/post.ts`, so lane 03 defines it here and
+ * provides it from `lanes/prd03.ts`; `get(flags)` returns the real PostGraph
+ * only once provided AND the flag is on — the legacy stub otherwise.
+ */
+export const postPipelineSlot = defineContractSlot("C-13", "prd03", "A3D_QR_POST", new LegacyPostGraph());
+/** Resolved graph for these flags; call at mount/compile time, never per draw. */
+export function resolvePostGraph(flags) {
+    return postPipelineSlot.get(flags);
+}
+//# sourceMappingURL=PostGraph.js.map

package/dist/rendering/post/PostGraph.js.map

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

package/dist/rendering/post/PostQualityTiers.d.ts

@@ -0,0 +1,95 @@
+/**
+ * PRD-03 Phase 5 — §6.8 post tier mapping (C-27 consumers).
+ *
+ * `resolvePostTier` derives the lane-03 post parameters for one
+ * `AuraQualityTier` from the frozen C-27 `AuraQualityTierSettings`. Rows marked
+ * "lane 03" in the §6.8 table are the tier-keyed derivatives below; rows marked
+ * "C-27" are read straight off the settings object (never literal copies).
+ *
+ * Re-resolution: the bridge calls this inside `createRootPostPipeline`, so a
+ * tier change recorded through `post.setQualityTier` → `app.quality.set` →
+ * `quality.onChange` produces a new resolution at the next compile/frame.
+ */
+import type { AuraQualityTier, AuraQualityTierSettings } from "../contracts/quality.js";
+export interface PostTierContext {
+    /**
+     * Whether the resolved AA mode is `taa` — §6.8 "temporal if taa" on High;
+     * Ultra's GTAO is temporal unconditionally.
+     */
+    readonly taaResolved?: boolean;
+    /**
+     * Whether the app authored `output.autoExposure` or the expanded preset
+     * implies auto-exposure — §6.8 "if preset" on Medium+.
+     */
+    readonly autoExposureAuthored?: boolean;
+}
+export interface PostTierResolution {
+    readonly tier: AuraQualityTier;
+    /** C-27 row: forward-target sample count + tier AA default. */
+    readonly msaaSamples: 0 | 4;
+    readonly postAntiAlias: "fxaa" | "none" | "taa";
+    /** C-27 row: DPR cap + render-scale floor. */
+    readonly maxPixelRatio: number;
+    readonly minRenderScale: number;
+    /** S2 GTAO — "off" when disabled. */
+    readonly gtao: {
+        readonly enabled: false;
+    } | {
+        readonly enabled: true;
+        readonly halfRes: boolean;
+        readonly directions: 2 | 4;
+        readonly steps: 4 | 6;
+        readonly temporal: boolean;
+    };
+    /** S3 SSR placement — level comes from C-27 `ssr`. */
+    readonly ssr: {
+        readonly enabled: false;
+    } | {
+        readonly enabled: true;
+        readonly halfRes: true;
+        readonly level: "medium" | "high";
+    };
+    /** S4 god rays — lane-03 row: off / 32 / 48 / 64 samples, half-res. */
+    readonly godRays: {
+        readonly enabled: false;
+    } | {
+        readonly enabled: true;
+        readonly samples: 32 | 48 | 64;
+        readonly halfRes: true;
+    };
+    /** S6 DoF — lane-03 row: off / half-res / full CoC + half-res 2-ring gather. */
+    readonly dof: {
+        readonly enabled: false;
+    } | {
+        readonly enabled: true;
+        readonly halfRes: boolean;
+        readonly gatherRings: 1 | 2;
+        readonly fullCoC: boolean;
+    };
+    /** S7 motion blur — lane-03 row: off / 8 / 12 taps. */
+    readonly motionBlur: {
+        readonly enabled: false;
+    } | {
+        readonly enabled: true;
+        readonly samples: 8 | 12;
+    };
+    /** C-27 row: bloom mip count 3 | 5 | 6. */
+    readonly bloomMipLevels: 3 | 5 | 6;
+    /** S8 auto-exposure — off on Low, otherwise "if preset" (§6.8). */
+    readonly autoExposure: boolean;
+    /** S10b display LUT — every tier (§6.8). */
+    readonly displayLut: boolean;
+    /** S10b/S12 cosmetics — Low keeps vignette only. */
+    readonly allowsVignette: boolean;
+    readonly allowsFilmGrain: boolean;
+    readonly allowsChromaticAberration: boolean;
+    /** S12/OutputPass dither — every tier (§6.8). */
+    readonly dither: boolean;
+}
+/**
+ * §6.8 tier × feature table. `settings` is the C-27 `AuraQualityTierSettings`
+ * for `tier` (the caller passes `QUALITY_TIERS[tier]` — rows marked C-27 are
+ * read from it, so the frozen table stays the single source of truth).
+ */
+export declare function resolvePostTier(settings: AuraQualityTierSettings, tier: AuraQualityTier, ctx?: PostTierContext): PostTierResolution;
+//# sourceMappingURL=PostQualityTiers.d.ts.map

package/dist/rendering/post/PostQualityTiers.d.ts.map

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

package/dist/rendering/post/PostQualityTiers.js

@@ -0,0 +1,62 @@
+/**
+ * PRD-03 Phase 5 — §6.8 post tier mapping (C-27 consumers).
+ *
+ * `resolvePostTier` derives the lane-03 post parameters for one
+ * `AuraQualityTier` from the frozen C-27 `AuraQualityTierSettings`. Rows marked
+ * "lane 03" in the §6.8 table are the tier-keyed derivatives below; rows marked
+ * "C-27" are read straight off the settings object (never literal copies).
+ *
+ * Re-resolution: the bridge calls this inside `createRootPostPipeline`, so a
+ * tier change recorded through `post.setQualityTier` → `app.quality.set` →
+ * `quality.onChange` produces a new resolution at the next compile/frame.
+ */
+/**
+ * §6.8 tier × feature table. `settings` is the C-27 `AuraQualityTierSettings`
+ * for `tier` (the caller passes `QUALITY_TIERS[tier]` — rows marked C-27 are
+ * read from it, so the frozen table stays the single source of truth).
+ */
+export function resolvePostTier(settings, tier, ctx = {}) {
+    const gtao = settings.ambientOcclusion === "off"
+        ? { enabled: false }
+        : tier === "medium"
+            ? { enabled: true, halfRes: true, directions: 2, steps: 4, temporal: false }
+            : tier === "high"
+                ? { enabled: true, halfRes: true, directions: 4, steps: 4, temporal: ctx.taaResolved === true }
+                : { enabled: true, halfRes: false, directions: 4, steps: 6, temporal: true };
+    const ssr = settings.ssr === "off"
+        ? { enabled: false }
+        : { enabled: true, halfRes: true, level: settings.ssr === "high" ? "high" : "medium" };
+    const godRays = tier === "low"
+        ? { enabled: false }
+        : { enabled: true, samples: tier === "medium" ? 32 : tier === "high" ? 48 : 64, halfRes: true };
+    const dof = tier === "high"
+        ? { enabled: true, halfRes: true, gatherRings: 1, fullCoC: false }
+        : tier === "ultra"
+            ? { enabled: true, halfRes: true, gatherRings: 2, fullCoC: true }
+            : { enabled: false };
+    const motionBlur = tier === "high"
+        ? { enabled: true, samples: 8 }
+        : tier === "ultra"
+            ? { enabled: true, samples: 12 }
+            : { enabled: false };
+    return {
+        tier,
+        msaaSamples: settings.msaaSamples,
+        postAntiAlias: settings.postAntiAlias,
+        maxPixelRatio: settings.maxPixelRatio,
+        minRenderScale: settings.minRenderScale,
+        gtao,
+        ssr,
+        godRays,
+        dof,
+        motionBlur,
+        bloomMipLevels: settings.bloomMipLevels,
+        autoExposure: tier !== "low" && ctx.autoExposureAuthored === true,
+        displayLut: true,
+        allowsVignette: true,
+        allowsFilmGrain: tier !== "low",
+        allowsChromaticAberration: tier !== "low",
+        dither: true
+    };
+}
+//# sourceMappingURL=PostQualityTiers.js.map

package/dist/rendering/post/PostQualityTiers.js.map

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

package/dist/rendering/post/PostResources.d.ts

@@ -0,0 +1,49 @@
+/**
+ * PRD-03 Phase 2 — v2 post-graph render-target pool.
+ *
+ * A thin cache in front of the C-28 `renderTargetPoolSlot` pool (whose PR 0a
+ * stub allocates on every acquire). Entries are keyed by
+ * `(width, height, format, samples, depth)`; `releaseAll()` returns live
+ * targets to the free list so the next frame reuses them instead of
+ * reallocating. `resize(width, height)` releases every pooled entry whose key
+ * no longer matches the new render size, so a canvas resize cannot serve a
+ * stale target back.
+ *
+ * The pool never owns GPU resources beyond the device lifetime: `dispose()`
+ * releases everything and `trim(frames)` forwards to the underlying pool so
+ * idle capacity still shrinks once C-28 is real.
+ */
+import type { RenderDevice, RenderTarget } from "../RenderDevice.js";
+import type { QrFlags } from "../contracts/core.js";
+export interface PostTargetKey {
+    readonly width: number;
+    readonly height: number;
+    readonly format: string;
+    readonly samples: 1 | 4;
+    readonly depth: boolean;
+}
+export declare class PostResources {
+    private readonly device;
+    private readonly flags;
+    private readonly free;
+    private readonly live;
+    private allocations;
+    constructor(device: RenderDevice, flags: QrFlags);
+    private pool;
+    /** Total underlying allocations — the leak-detection counter tests assert on. */
+    get allocationCount(): number;
+    acquire(key: PostTargetKey): RenderTarget;
+    /** Release one live target back to the free list (safe to call per frame). */
+    release(target: RenderTarget): void;
+    /** End-of-frame: everything acquired this frame returns to the free list. */
+    releaseAll(): void;
+    /**
+     * Releases every pooled entry whose (w,h) does not match the new render
+     * size — a resize can never hand back a stale target.
+     */
+    resize(width: number, height: number): void;
+    trim(maxIdleFrames: number): void;
+    dispose(): void;
+    private keyForTarget;
+}
+//# sourceMappingURL=PostResources.d.ts.map

package/dist/rendering/post/PostResources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostResources.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/post/PostResources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGlE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAMD,qBAAa,aAAa;IAMtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IANxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqC;IAC1D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,WAAW,CAAK;gBAGL,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO;IAGjC,OAAO,CAAC,IAAI;IAIZ,iFAAiF;IACjF,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY;IAkBzC,8EAA8E;IAC9E,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAQnC,6EAA6E;IAC7E,UAAU,IAAI,IAAI;IAMlB;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAiB3C,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAIjC,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,YAAY;CAarB"}

package/dist/rendering/post/PostResources.js

@@ -0,0 +1,119 @@
+/**
+ * PRD-03 Phase 2 — v2 post-graph render-target pool.
+ *
+ * A thin cache in front of the C-28 `renderTargetPoolSlot` pool (whose PR 0a
+ * stub allocates on every acquire). Entries are keyed by
+ * `(width, height, format, samples, depth)`; `releaseAll()` returns live
+ * targets to the free list so the next frame reuses them instead of
+ * reallocating. `resize(width, height)` releases every pooled entry whose key
+ * no longer matches the new render size, so a canvas resize cannot serve a
+ * stale target back.
+ *
+ * The pool never owns GPU resources beyond the device lifetime: `dispose()`
+ * releases everything and `trim(frames)` forwards to the underlying pool so
+ * idle capacity still shrinks once C-28 is real.
+ */
+import { renderTargetPoolSlot } from "../contracts/device.js";
+function keyOf(key) {
+    return `${key.width}x${key.height}:${key.format}:${key.samples}:${key.depth ? 1 : 0}`;
+}
+export class PostResources {
+    device;
+    flags;
+    free = new Map();
+    live = new Set();
+    allocations = 0;
+    constructor(device, flags) {
+        this.device = device;
+        this.flags = flags;
+    }
+    pool() {
+        return renderTargetPoolSlot.get(this.flags)(this.device);
+    }
+    /** Total underlying allocations — the leak-detection counter tests assert on. */
+    get allocationCount() {
+        return this.allocations;
+    }
+    acquire(key) {
+        const id = keyOf(key);
+        const cached = this.free.get(id);
+        const fromCache = Boolean(cached && cached.length > 0);
+        const target = fromCache
+            ? cached.pop()
+            : this.pool().acquire({
+                width: key.width,
+                height: key.height,
+                format: key.format,
+                samples: key.samples,
+                depth: key.depth
+            });
+        if (!fromCache)
+            this.allocations += 1;
+        this.live.add(target);
+        return target;
+    }
+    /** Release one live target back to the free list (safe to call per frame). */
+    release(target) {
+        if (!this.live.delete(target))
+            return;
+        const key = this.keyForTarget(target);
+        const list = this.free.get(key) ?? [];
+        list.push(target);
+        this.free.set(key, list);
+    }
+    /** End-of-frame: everything acquired this frame returns to the free list. */
+    releaseAll() {
+        for (const target of [...this.live]) {
+            this.release(target);
+        }
+    }
+    /**
+     * Releases every pooled entry whose (w,h) does not match the new render
+     * size — a resize can never hand back a stale target.
+     */
+    resize(width, height) {
+        for (const [key, list] of this.free) {
+            const [w, h] = key.split(":")[0].split("x").map(Number);
+            if (w !== width || h !== height) {
+                for (const target of list)
+                    this.pool().release(target);
+                this.free.delete(key);
+            }
+        }
+        for (const target of [...this.live]) {
+            const [w, h] = this.keyForTarget(target).split(":")[0].split("x").map(Number);
+            if (w !== width || h !== height) {
+                this.live.delete(target);
+                this.pool().release(target);
+            }
+        }
+    }
+    trim(maxIdleFrames) {
+        this.pool().trim(maxIdleFrames);
+    }
+    dispose() {
+        const pool = this.pool();
+        for (const list of this.free.values()) {
+            for (const target of list)
+                pool.release(target);
+        }
+        this.free.clear();
+        for (const target of this.live)
+            pool.release(target);
+        this.live.clear();
+    }
+    keyForTarget(target) {
+        const samples = (target.sampleCount ?? 1);
+        const hasDepth = target.depthTexture !== undefined
+            || target.depthTextureHandle != null
+            || target.depthHandle != null;
+        return keyOf({
+            width: target.width,
+            height: target.height,
+            format: target.colorTexture.format,
+            samples,
+            depth: hasDepth
+        });
+    }
+}
+//# sourceMappingURL=PostResources.js.map

package/dist/rendering/post/PostResources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostResources.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/post/PostResources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAW3D,SAAS,KAAK,CAAC,GAAkB;IAC/B,OAAO,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACxF,CAAC;AAED,MAAM,OAAO,aAAa;IAML;IACA;IANF,IAAI,GAAG,IAAI,GAAG,EAA0B,CAAC;IACzC,IAAI,GAAG,IAAI,GAAG,EAAgB,CAAC;IACxC,WAAW,GAAG,CAAC,CAAC;IAExB,YACmB,MAAoB,EACpB,KAAc;QADd,WAAM,GAAN,MAAM,CAAc;QACpB,UAAK,GAAL,KAAK,CAAS;IAC9B,CAAC;IAEI,IAAI;QACV,OAAO,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED,iFAAiF;IACjF,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,GAAkB;QACxB,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,SAAS;YACtB,CAAC,CAAC,MAAO,CAAC,GAAG,EAAG;YAChB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC;gBAClB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,MAAM,EAAE,GAAG,CAAC,MAAe;gBAC3B,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,KAAK,EAAE,GAAG,CAAC,KAAK;aACjB,CAAC,CAAC;QACP,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,8EAA8E;IAC9E,OAAO,CAAC,MAAoB;QAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YAAE,OAAO;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,6EAA6E;IAC7E,UAAU;QACR,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAa,EAAE,MAAc;QAClC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACzD,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;gBAChC,KAAK,MAAM,MAAM,IAAI,IAAI;oBAAE,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACvD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC/E,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;gBAChC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACzB,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,aAAqB;QACxB,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACL,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,KAAK,MAAM,MAAM,IAAI,IAAI;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAEO,YAAY,CAAC,MAAoB;QACvC,MAAM,OAAO,GAAG,CAAE,MAAmC,CAAC,WAAW,IAAI,CAAC,CAAU,CAAC;QACjF,MAAM,QAAQ,GAAI,MAAqC,CAAC,YAAY,KAAK,SAAS;eAC5E,MAA2C,CAAC,kBAAkB,IAAI,IAAI;eACtE,MAAoC,CAAC,WAAW,IAAI,IAAI,CAAC;QAC/D,OAAO,KAAK,CAAC;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM;YAClC,OAAO;YACP,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/rendering/post/PostTimer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * PRD-03 — per-stage GPU timing for the v2 post graph (C-28 `gpuMs` feed).
+ *
+ * Wraps EXT_disjoint_timer_query_webgl2. The extension is absent on some
+ * paravirtual/driver stacks, so construction probes it once and every method
+ * degrades to undefined/null rather than throwing; the caller only ever sees
+ * `gpuMs` values that were actually measured.
+ *
+ * Results are asynchronous by design: `end()` queues the query and the value
+ * appears in `collect()` once the driver reports QUERY_RESULT_AVAILABLE.
+ */
+export interface PostGpuTimerQuery {
+    readonly available: boolean;
+}
+export declare class PostTimer {
+    private readonly gl;
+    private readonly ext;
+    private readonly pending;
+    private current;
+    private currentLabel;
+    private disjointSeen;
+    constructor(gl: WebGL2RenderingContext | null | undefined);
+    /** False when the context or extension is missing — every other call no-ops. */
+    get available(): boolean;
+    /** Begin a GPU-elapsed query for `label`. No-op when unavailable. */
+    begin(label: string): void;
+    /** End the open query; results surface via collect(). */
+    end(): void;
+    /**
+     * Harvest finished queries. A GPU disjoint event (context loss, reset)
+     * discards pending results and marks the timer unavailable for the rest of
+     * the frame rather than reporting garbage nanoseconds.
+     */
+    collect(): Readonly<Record<string, number>>;
+    dispose(): void;
+}
+//# sourceMappingURL=PostTimer.d.ts.map

package/dist/rendering/post/PostTimer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostTimer.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/post/PostTimer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAYD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgC;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,YAAY,CAAS;gBAEjB,EAAE,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS;IAOzD,gFAAgF;IAChF,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,qEAAqE;IACrE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS1B,yDAAyD;IACzD,GAAG,IAAI,IAAI;IAQX;;;;OAIG;IACH,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAmB3C,OAAO,IAAI,IAAI;CAQhB"}