@aura3d/rendering 3.0.1 → 4.0.2

package/dist/renderer/coreOutputPostRoute.d.ts

@@ -0,0 +1,40 @@
+/**
+ * C-05 / T0-07 routing for a legacy post chain under `A3D_QR_CORE_OUTPUT`.
+ *
+ * The v2 output path encodes exactly once, in OutputPass (§8.4). A configured
+ * legacy postprocess chain (bloom, SSAO, grading, ...) still tone-maps and
+ * encodes itself until lane 03 migrates it into post-hdr contributors
+ * (Q-03-2/Q-03-3). Running both would double-encode.
+ *
+ * The earlier policy dropped the chain, which silently removed authored effects.
+ * On L4, scene 18-game-scene lost its bloom and the soft sky glow on the
+ * foreground (LPIPS 0.026 with `-core_output` vs 0.068 with `core`; flags-bisect
+ * 38188725947). The frame now keeps the legacy chain and bypasses OutputPass
+ * for that frame instead: encode stays single and nothing authored is lost.
+ * The bypass is still reported through the C-31 `output.postSkipped` record,
+ * so the unmigrated residue stays visible. Frames without a legacy chain take
+ * the v2 output path unchanged.
+ */
+import type { QrFlags } from "../contracts/core.js";
+export interface CoreOutputPostSkipped {
+    readonly code: string;
+    readonly message: string;
+    readonly effects: readonly string[];
+}
+export interface CoreOutputPostRoute {
+    /** Whether this frame takes the v2 HDR target + OutputPass path. */
+    readonly qrOutput: boolean;
+    /** C-31 `output.postSkipped`: the unmigrated legacy chain this frame routed around OutputPass (`null` when none). */
+    readonly skipped: CoreOutputPostSkipped | null;
+}
+export declare const CORE_OUTPUT_LEGACY_POST_MESSAGE = "legacy postprocess chain kept under A3D_QR_CORE_OUTPUT; OutputPass bypassed for this frame (the chain encodes itself) until PostGraph v2 routes it";
+/** Effect keys a legacy postprocess options object enables (booleans or option objects). */
+export declare function legacyPostEffects(postprocess: object): readonly string[];
+export declare function resolveCoreOutputPostRoute(coreOutputOn: boolean, postprocess: object | undefined): CoreOutputPostRoute;
+/**
+ * The frame's flags with `A3D_QR_CORE_OUTPUT` explicitly off, so frame
+ * contributors (lane 07 vfx, transmission capture) pick the legacy `color`
+ * resource the legacy-routed graph actually writes.
+ */
+export declare function withCoreOutputOff(flags: QrFlags): QrFlags;
+//# sourceMappingURL=coreOutputPostRoute.d.ts.map

package/dist/renderer/coreOutputPostRoute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coreOutputPostRoute.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/renderer/coreOutputPostRoute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,qHAAqH;IACrH,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAChD;AAED,eAAO,MAAM,+BAA+B,uJAC0G,CAAC;AAEvJ,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAIxE;AAED,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,mBAAmB,CAOtH;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKzD"}

package/dist/renderer/coreOutputPostRoute.js

@@ -0,0 +1,46 @@
+/**
+ * C-05 / T0-07 routing for a legacy post chain under `A3D_QR_CORE_OUTPUT`.
+ *
+ * The v2 output path encodes exactly once, in OutputPass (§8.4). A configured
+ * legacy postprocess chain (bloom, SSAO, grading, ...) still tone-maps and
+ * encodes itself until lane 03 migrates it into post-hdr contributors
+ * (Q-03-2/Q-03-3). Running both would double-encode.
+ *
+ * The earlier policy dropped the chain, which silently removed authored effects.
+ * On L4, scene 18-game-scene lost its bloom and the soft sky glow on the
+ * foreground (LPIPS 0.026 with `-core_output` vs 0.068 with `core`; flags-bisect
+ * 38188725947). The frame now keeps the legacy chain and bypasses OutputPass
+ * for that frame instead: encode stays single and nothing authored is lost.
+ * The bypass is still reported through the C-31 `output.postSkipped` record,
+ * so the unmigrated residue stays visible. Frames without a legacy chain take
+ * the v2 output path unchanged.
+ */
+export const CORE_OUTPUT_LEGACY_POST_MESSAGE = "legacy postprocess chain kept under A3D_QR_CORE_OUTPUT; OutputPass bypassed for this frame (the chain encodes itself) until PostGraph v2 routes it";
+/** Effect keys a legacy postprocess options object enables (booleans or option objects). */
+export function legacyPostEffects(postprocess) {
+    return Object.entries(postprocess)
+        .filter(([key, value]) => key !== "targetFormat" && key !== "temporal" && (value === true || (typeof value === "object" && value !== null)))
+        .map(([key]) => key);
+}
+export function resolveCoreOutputPostRoute(coreOutputOn, postprocess) {
+    if (!coreOutputOn)
+        return { qrOutput: false, skipped: null };
+    if (postprocess === undefined)
+        return { qrOutput: true, skipped: null };
+    return {
+        qrOutput: false,
+        skipped: { code: "post-v2-unmigrated", message: CORE_OUTPUT_LEGACY_POST_MESSAGE, effects: legacyPostEffects(postprocess) }
+    };
+}
+/**
+ * The frame's flags with `A3D_QR_CORE_OUTPUT` explicitly off, so frame
+ * contributors (lane 07 vfx, transmission capture) pick the legacy `color`
+ * resource the legacy-routed graph actually writes.
+ */
+export function withCoreOutputOff(flags) {
+    return {
+        values: { ...flags.values, A3D_QR_CORE_OUTPUT: false },
+        on: (name) => (name === "A3D_QR_CORE_OUTPUT" ? false : flags.on(name))
+    };
+}
+//# sourceMappingURL=coreOutputPostRoute.js.map

package/dist/renderer/coreOutputPostRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coreOutputPostRoute.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/renderer/coreOutputPostRoute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAiBH,MAAM,CAAC,MAAM,+BAA+B,GAC1C,oJAAoJ,CAAC;AAEvJ,4FAA4F;AAC5F,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO,MAAM,CAAC,OAAO,CAAC,WAAsC,CAAC;SAC1D,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,cAAc,IAAI,GAAG,KAAK,UAAU,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC;SAC3I,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,YAAqB,EAAE,WAA+B;IAC/F,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7D,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACxE,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,+BAA+B,EAAE,OAAO,EAAE,iBAAiB,CAAC,WAAW,CAAC,EAAE;KAC3H,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO;QACL,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE;QACtD,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;KACvE,CAAC;AACJ,CAAC"}

package/dist/renderer/postSkipped.d.ts

@@ -0,0 +1,12 @@
+export declare function recordPostSkipped(reason: string): void;
+export declare function postSkippedReasons(): readonly string[];
+export declare function beginPostStageTrace(): void;
+export declare function recordPostStage(stage: string): void;
+export declare function postStagesRan(): readonly string[];
+export declare function markTaaHistoryWritten(): void;
+export declare function consumeTaaHistoryWritten(): boolean;
+/** Test hook — clears the §6.9 skip registry. */
+export declare function resetPostSkipped(): void;
+/** `import.meta.env.PROD` / `process.env.NODE_ENV === "production"`. */
+export declare function postProductionBuild(): boolean;
+//# sourceMappingURL=postSkipped.d.ts.map

package/dist/renderer/postSkipped.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postSkipped.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/renderer/postSkipped.ts"],"names":[],"mappings":"AAQA,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED,wBAAgB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAEtD;AASD,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED,wBAAgB,aAAa,IAAI,SAAS,MAAM,EAAE,CAEjD;AAQD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,wBAAgB,wBAAwB,IAAI,OAAO,CAIlD;AAED,iDAAiD;AACjD,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,IAAI,OAAO,CAK7C"}

package/dist/renderer/postSkipped.js

@@ -0,0 +1,54 @@
+/* §6.9 skip registry — shared by `renderer/PostprocessExecution` (CPU-pass
+ * record-and-skip), `webgl2/LegacyPost` (v2-route degradations) and
+ * `post/v2Stages` (HDR-stage degradations). Dependency-free, so the v2
+ * drivers can record without importing the renderer barrel (import-cycle
+ * safe); kept out of `post/` so PostprocessExecution has no static `post/`
+ * import (§9 bundle gate, prd03-post-bundle-split). `postSections` folds these into `diagnostics().post.skipped`. */
+const postSkippedReasonsSet = new Set();
+export function recordPostSkipped(reason) {
+    postSkippedReasonsSet.add(reason);
+}
+export function postSkippedReasons() {
+    return [...postSkippedReasonsSet];
+}
+/**
+ * C-31 stage trace: the v2 HDR stages that executed on the most recent frame
+ * (e.g. `S5:taa-history`, `S5:taa-seed`). Replaced per frame by
+ * `beginPostStageTrace`; read through `diagnostics().post.stagesRan`.
+ */
+let postStagesRanList = [];
+export function beginPostStageTrace() {
+    postStagesRanList = [];
+}
+export function recordPostStage(stage) {
+    postStagesRanList.push(stage);
+}
+export function postStagesRan() {
+    return [...postStagesRanList];
+}
+/**
+ * PRD-03 §8.6: set by S5 when it resolved into the TAA history target this
+ * frame; the Renderer consumes it before promoting the history ping-pong.
+ */
+let taaHistoryWritten = false;
+export function markTaaHistoryWritten() {
+    taaHistoryWritten = true;
+}
+export function consumeTaaHistoryWritten() {
+    const written = taaHistoryWritten;
+    taaHistoryWritten = false;
+    return written;
+}
+/** Test hook — clears the §6.9 skip registry. */
+export function resetPostSkipped() {
+    postSkippedReasonsSet.clear();
+}
+/** `import.meta.env.PROD` / `process.env.NODE_ENV === "production"`. */
+export function postProductionBuild() {
+    const meta = import.meta;
+    if (meta.env?.PROD)
+        return true;
+    return globalThis
+        .process?.env?.NODE_ENV === "production";
+}
+//# sourceMappingURL=postSkipped.js.map

package/dist/renderer/postSkipped.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postSkipped.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/renderer/postSkipped.ts"],"names":[],"mappings":"AAAA;;;;;qHAKqH;AACrH,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAU,CAAC;AAEhD,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,GAAG,qBAAqB,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,IAAI,iBAAiB,GAAa,EAAE,CAAC;AAErC,MAAM,UAAU,mBAAmB;IACjC,iBAAiB,GAAG,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,GAAG,iBAAiB,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,IAAI,iBAAiB,GAAG,KAAK,CAAC;AAE9B,MAAM,UAAU,qBAAqB;IACnC,iBAAiB,GAAG,IAAI,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,MAAM,OAAO,GAAG,iBAAiB,CAAC;IAClC,iBAAiB,GAAG,KAAK,CAAC;IAC1B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,gBAAgB;IAC9B,qBAAqB,CAAC,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,mBAAmB;IACjC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAiE,CAAC;IACtF,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAQ,UAAuF;SAC5F,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,YAAY,CAAC;AAC7C,CAAC"}

package/dist/renderer/qrSubFlags.d.ts

@@ -0,0 +1,45 @@
+import type { QrFlags } from "../contracts/core.js";
+import type { RenderDevice } from "../RenderDevice.js";
+import { type ProgramCacheLike, type ProgramDegradationLike } from "../contracts/program.js";
+import { type FrameUniformsLike } from "../contracts/frameUniforms.js";
+import { OutputPass } from "../output/OutputPass.js";
+/**
+ * E3 conjunction (Live Fix stages 1/2a/2b): the physical-lighting data path
+ * is live only when the compiler lane AND the lighting lane are both on.
+ * `A3D_QR_LIGHTING` is default-on while `A3D_QR_COMPILER` is dev, so every
+ * shipped scene is conjunction-off today and must stay byte-identical.
+ */
+export declare function qrE3CompilerLightingOn(flags: QrFlags): boolean;
+/** Generated-program path (C-02) vs. frozen legacy shaderKey path. */
+export declare function qrCoreGeneratorOn(flags: QrFlags): boolean;
+/**
+ * PRD-04 lobe route: the r185 lobes (sheen, iridescence, anisotropy, specular,
+ * dispersion, …) exist only as generated-program chunks — the legacy
+ * pbr-direct shader has no code for them. Gating every generated draw on
+ * `A3D_QR_CORE` meant `materials` alone selected lobes no program ever
+ * consumed (byte-identical frames). With `A3D_QR_MATERIALS` on, lobe-bearing
+ * materials route through the generator unless the generator is explicitly
+ * excluded (`-core_generator`); lobe-free materials stay legacy.
+ */
+export declare function qrMaterialsLobeProgramsOn(flags: QrFlags): boolean;
+/** Any draw may use a generated program this frame (UBO, warmup, cache frame bounds). */
+export declare function qrGeneratedProgramsOn(flags: QrFlags): boolean;
+/** HDR offscreen target + OutputPass present+encode path (C-23). */
+export declare function qrCoreOutputOn(flags: QrFlags): boolean;
+/**
+ * T0-05 (a): C-36 sink for this device's generated-program degradations
+ * (`extension-lobe-pending`, `program-compile-failed`). Late-bound: the cache
+ * forwards to whatever sink is installed when the degradation happens, so the
+ * engine mount (C-38 `onDegradation`, lane 15) can install it after the
+ * renderer has already created the cache. Pass `undefined` to clear.
+ */
+export declare function setRendererProgramDegradationSink(device: RenderDevice, sink: ((degradation: ProgramDegradationLike) => void) | undefined): void;
+export declare function rendererProgramCache(device: RenderDevice, flags: QrFlags): ProgramCacheLike;
+/**
+ * PRD-01 Phase 6 (C-31): read-only access for diagnostics — never creates the
+ * singleton, so callers that lack the app's QrFlags can't pollute the map.
+ */
+export declare function rendererProgramCachePeek(device: RenderDevice): ProgramCacheLike | undefined;
+export declare function rendererAuraFrame(device: RenderDevice, flags: QrFlags): FrameUniformsLike;
+export declare function rendererOutputPass(device: RenderDevice): OutputPass;
+//# sourceMappingURL=qrSubFlags.d.ts.map

package/dist/renderer/qrSubFlags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qrSubFlags.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/renderer/qrSubFlags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAoB,KAAK,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC5G,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAalD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9D;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEjE;AAED,yFAAyF;AACzF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtD;AAuBD;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,sBAAsB,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAG/I;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAyB3F;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,GAAG,SAAS,CAE3F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAOzF;AAMD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAOnE"}

package/dist/renderer/qrSubFlags.js

@@ -0,0 +1,130 @@
+import { programCacheSlot } from "../contracts/program.js";
+import { frameUniformsSlot } from "../contracts/frameUniforms.js";
+import { OutputPass } from "../output/OutputPass.js";
+/**
+ * PRD-01 §15 sub-flag resolution: `A3D_QR_CORE_GENERATOR` and
+ * `A3D_QR_CORE_OUTPUT` default ON under `A3D_QR_CORE=v2` and can be excluded
+ * per-capture (`?a3d-qr=core,-core_generator`) for attribution. Explicit
+ * values always win.
+ */
+function subFlagOn(flags, sub, lane) {
+    const explicit = flags.values[sub];
+    return explicit !== undefined ? flags.on(sub) : flags.on(lane);
+}
+/**
+ * E3 conjunction (Live Fix stages 1/2a/2b): the physical-lighting data path
+ * is live only when the compiler lane AND the lighting lane are both on.
+ * `A3D_QR_LIGHTING` is default-on while `A3D_QR_COMPILER` is dev, so every
+ * shipped scene is conjunction-off today and must stay byte-identical.
+ */
+export function qrE3CompilerLightingOn(flags) {
+    return flags.on("A3D_QR_COMPILER") && flags.on("A3D_QR_LIGHTING");
+}
+/** Generated-program path (C-02) vs. frozen legacy shaderKey path. */
+export function qrCoreGeneratorOn(flags) {
+    return subFlagOn(flags, "A3D_QR_CORE_GENERATOR", "A3D_QR_CORE");
+}
+/**
+ * PRD-04 lobe route: the r185 lobes (sheen, iridescence, anisotropy, specular,
+ * dispersion, …) exist only as generated-program chunks — the legacy
+ * pbr-direct shader has no code for them. Gating every generated draw on
+ * `A3D_QR_CORE` meant `materials` alone selected lobes no program ever
+ * consumed (byte-identical frames). With `A3D_QR_MATERIALS` on, lobe-bearing
+ * materials route through the generator unless the generator is explicitly
+ * excluded (`-core_generator`); lobe-free materials stay legacy.
+ */
+export function qrMaterialsLobeProgramsOn(flags) {
+    return flags.values.A3D_QR_CORE_GENERATOR === undefined && flags.on("A3D_QR_MATERIALS");
+}
+/** Any draw may use a generated program this frame (UBO, warmup, cache frame bounds). */
+export function qrGeneratedProgramsOn(flags) {
+    return qrCoreGeneratorOn(flags) || qrMaterialsLobeProgramsOn(flags);
+}
+/** HDR offscreen target + OutputPass present+encode path (C-23). */
+export function qrCoreOutputOn(flags) {
+    return subFlagOn(flags, "A3D_QR_CORE_OUTPUT", "A3D_QR_CORE");
+}
+/**
+ * Select the shared generator's providers for the materials-only route.
+ * This view is used only by C-02/C-08 provider lookup: the cache receives
+ * the original flags, so no core feature, output pass or other lane is enabled.
+ */
+function generatedProviderFlags(flags) {
+    if (!qrMaterialsLobeProgramsOn(flags) || flags.on("A3D_QR_CORE"))
+        return flags;
+    return {
+        values: flags.values,
+        on: (name) => name === "A3D_QR_CORE" || flags.on(name)
+    };
+}
+// ── Device-scoped singletons (C-02/C-08) ─────────────────────────────────
+// The generated-program cache and the AuraFrame UBO belong to the device, not a
+// pass instance: the Renderer warms it and ForwardPass acquires from it.
+const caches = new WeakMap();
+const auraFrames = new WeakMap();
+const degradationSinks = new WeakMap();
+/**
+ * T0-05 (a): C-36 sink for this device's generated-program degradations
+ * (`extension-lobe-pending`, `program-compile-failed`). Late-bound: the cache
+ * forwards to whatever sink is installed when the degradation happens, so the
+ * engine mount (C-38 `onDegradation`, lane 15) can install it after the
+ * renderer has already created the cache. Pass `undefined` to clear.
+ */
+export function setRendererProgramDegradationSink(device, sink) {
+    if (sink)
+        degradationSinks.set(device, sink);
+    else
+        degradationSinks.delete(device);
+}
+export function rendererProgramCache(device, flags) {
+    let cache = caches.get(device);
+    if (!cache) {
+        // T0-05 (a): without `flags` the real generator resolves no ShaderFeature
+        // contributors and no C-03 lobes, so no registered chunk ever reaches a
+        // generated program.
+        // #1140: if the lane-01 barrel was tree-shaken out of the bundle, the slot
+        // silently hands back the PR-0a stub (legacy pbr-direct for every lit
+        // record: no maps, no instancing → flat frames). Report it loudly.
+        if (!programCacheSlot.provided && qrGeneratedProgramsOn(flags)) {
+            const degradation = {
+                code: "program-generator-missing",
+                message: "A3D_QR_CORE generator is on but the C-02 real program cache was never provided (lanes/prd01 not loaded — tree-shaken?); using the stub legacy-PBR cache",
+                ownerPrd: 1
+            };
+            console.error(`[prd01] ${degradation.message}`);
+            degradationSinks.get(device)?.(degradation);
+        }
+        cache = programCacheSlot.get(generatedProviderFlags(flags))(device, {
+            flags,
+            onDegradation: (degradation) => degradationSinks.get(device)?.(degradation)
+        });
+        caches.set(device, cache);
+    }
+    return cache;
+}
+/**
+ * PRD-01 Phase 6 (C-31): read-only access for diagnostics — never creates the
+ * singleton, so callers that lack the app's QrFlags can't pollute the map.
+ */
+export function rendererProgramCachePeek(device) {
+    return caches.get(device);
+}
+export function rendererAuraFrame(device, flags) {
+    let fu = auraFrames.get(device);
+    if (!fu) {
+        fu = frameUniformsSlot.get(generatedProviderFlags(flags))(device);
+        auraFrames.set(device, fu);
+    }
+    return fu;
+}
+// ── C-05: the OutputPass belongs to the device — one shader-variant cache ──
+const outputPasses = new WeakMap();
+export function rendererOutputPass(device) {
+    let pass = outputPasses.get(device);
+    if (!pass) {
+        pass = new OutputPass(device);
+        outputPasses.set(device, pass);
+    }
+    return pass;
+}
+//# sourceMappingURL=qrSubFlags.js.map

package/dist/renderer/qrSubFlags.js.map

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

package/dist/resources/InstanceBuffer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * C-07 (PRD-01 §7.1) — real `InstanceBuffer` for `instanceBufferSlot.provide`.
+ * Persistent per-node buffer (never per-frame `createBuffer`): CPU-side arrays
+ * and device buffers grow by doubling up to the constructor `capacity`; writes
+ * past capacity throw `INSTANCE_CAPACITY_EXCEEDED`. `version` bumps on every
+ * write so consumers upload only on change (`bufferSubData` covers just the
+ * written range, not the whole backing store).
+ */
+import { type RenderBuffer, type RenderDevice } from "../RenderDevice.js";
+import type { InstanceBufferLike } from "../contracts/geometry.js";
+export declare class InstanceBuffer implements InstanceBufferLike {
+    private readonly device;
+    private readonly capacity;
+    private matrices;
+    private colors;
+    private matrixBuffer;
+    private colorBuffer;
+    private allocated;
+    count: number;
+    version: number;
+    constructor(device: RenderDevice, capacity: number, options?: {
+        colors?: boolean;
+    });
+    private ensureAllocated;
+    private growColors;
+    setMatrices(m: Float32Array, count?: number): void;
+    setColors(c: Float32Array): void;
+    bind(): {
+        readonly matrixBuffer: RenderBuffer;
+        readonly colorBuffer?: RenderBuffer;
+    };
+    dispose(): void;
+}
+//# sourceMappingURL=InstanceBuffer.d.ts.map

package/dist/resources/InstanceBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstanceBuffer.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/resources/InstanceBuffer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAKhE,qBAAa,cAAe,YAAW,kBAAkB;IAUrD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAV3B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,SAAS,CAAS;IACnB,KAAK,SAAK;IACV,OAAO,SAAK;gBAGA,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,MAAM,EACjC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE;IAchC,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,UAAU;IAUlB,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAUlD,SAAS,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI;IAWhC,IAAI,IAAI;QAAE,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAA;KAAE;IAMpF,OAAO,IAAI,IAAI;CAIhB"}

package/dist/resources/InstanceBuffer.js

@@ -0,0 +1,96 @@
+/**
+ * C-07 (PRD-01 §7.1) — real `InstanceBuffer` for `instanceBufferSlot.provide`.
+ * Persistent per-node buffer (never per-frame `createBuffer`): CPU-side arrays
+ * and device buffers grow by doubling up to the constructor `capacity`; writes
+ * past capacity throw `INSTANCE_CAPACITY_EXCEEDED`. `version` bumps on every
+ * write so consumers upload only on change (`bufferSubData` covers just the
+ * written range, not the whole backing store).
+ */
+import {} from "../RenderDevice.js";
+const MIN_CAPACITY = 16;
+const pow2Ceil = (value) => 2 ** Math.ceil(Math.log2(Math.max(1, value)));
+export class InstanceBuffer {
+    device;
+    capacity;
+    matrices;
+    colors = null;
+    matrixBuffer;
+    colorBuffer = null;
+    allocated;
+    count = 0;
+    version = 0;
+    constructor(device, capacity, options) {
+        this.device = device;
+        this.capacity = capacity;
+        if (!Number.isInteger(capacity) || capacity < 1) {
+            throw new Error(`InstanceBuffer capacity must be a positive integer, got ${capacity}`);
+        }
+        this.allocated = Math.min(capacity, MIN_CAPACITY);
+        this.matrices = new Float32Array(this.allocated * 16);
+        this.matrixBuffer = device.createBuffer("vertex", this.matrices.byteLength);
+        if (options?.colors) {
+            this.colors = new Float32Array(this.allocated * 4);
+            this.colorBuffer = device.createBuffer("vertex", this.colors.byteLength);
+        }
+    }
+    ensureAllocated(instances, withColors) {
+        if (instances <= this.allocated)
+            return;
+        const next = Math.min(this.capacity, pow2Ceil(instances));
+        const matrices = new Float32Array(next * 16);
+        matrices.set(this.matrices.subarray(0, this.count * 16));
+        this.matrices = matrices;
+        const oldMatrix = this.matrixBuffer;
+        this.matrixBuffer = this.device.createBuffer("vertex", matrices.byteLength);
+        // Dispose of the old buffer first so device-side VAOs referencing it are
+        // evicted (PRD §7.1) before a same-content buffer takes its place.
+        oldMatrix.dispose();
+        if (withColors && this.colors && this.colorBuffer && this.colors.length < next * 4) {
+            this.growColors(next);
+        }
+        this.allocated = next;
+    }
+    growColors(instances) {
+        if (!this.colors || !this.colorBuffer)
+            return;
+        const colors = new Float32Array(instances * 4);
+        colors.set(this.colors.subarray(0, this.count * 4));
+        this.colors = colors;
+        const oldColors = this.colorBuffer;
+        this.colorBuffer = this.device.createBuffer("vertex", colors.byteLength);
+        oldColors.dispose();
+    }
+    setMatrices(m, count) {
+        const n = count ?? Math.floor(m.length / 16);
+        if (n > this.capacity)
+            throw new Error(`INSTANCE_CAPACITY_EXCEEDED:${n}>${this.capacity}`);
+        this.ensureAllocated(n, false);
+        this.matrices.set(m.subarray(0, n * 16));
+        this.device.updateBuffer(this.matrixBuffer, 0, this.matrices.subarray(0, n * 16));
+        this.count = n;
+        this.version += 1;
+    }
+    setColors(c) {
+        if (!this.colors || !this.colorBuffer)
+            throw new Error("INSTANCE_COLORS_NOT_ENABLED");
+        const n = Math.floor(c.length / 4);
+        if (n > this.capacity)
+            throw new Error(`INSTANCE_CAPACITY_EXCEEDED:${n}>${this.capacity}`);
+        this.ensureAllocated(n, true);
+        if (this.colors.length < n * 4)
+            this.growColors(n);
+        this.colors.set(c.subarray(0, n * 4));
+        this.device.updateBuffer(this.colorBuffer, 0, this.colors.subarray(0, n * 4));
+        this.version += 1;
+    }
+    bind() {
+        return this.colorBuffer
+            ? { matrixBuffer: this.matrixBuffer, colorBuffer: this.colorBuffer }
+            : { matrixBuffer: this.matrixBuffer };
+    }
+    dispose() {
+        this.matrixBuffer.dispose();
+        this.colorBuffer?.dispose();
+    }
+}
+//# sourceMappingURL=InstanceBuffer.js.map

package/dist/resources/InstanceBuffer.js.map

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

package/dist/resources/MorphTargetTexture.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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 type { Geometry } from "../Geometry.js";
+import type { MorphTargetDelta } from "../MorphTarget.js";
+import { Texture } from "../Texture.js";
+export declare const MORPH_TARGET_COUNT_BUCKETS: readonly [4, 8, 16, 32];
+export type MorphTargetCountBucket = (typeof MORPH_TARGET_COUNT_BUCKETS)[number];
+export declare const MORPH_LAYER_POSITION = 0;
+export declare const MORPH_LAYER_NORMAL = 1;
+export declare const MORPH_LAYER_TANGENT = 2;
+export declare const MORPH_MAX_TEXTURE_LAYERS = 3;
+export interface MorphTextureLimits {
+    readonly maxTextureSize: number;
+    readonly maxArrayLayers: number;
+}
+export type MorphTargetTextureResult = {
+    readonly texture: Texture;
+    readonly targetCount: number;
+    readonly hasNormals: boolean;
+    readonly hasTangents: boolean;
+    /** Texels per vertex (1 = positions, 2 = +normals, 3 = +tangents) — shader `u_morphStride`. */
+    readonly stride: number;
+    readonly bucket: MorphTargetCountBucket;
+    /** Bucketed targets actually packed (index order preserved, truncation applied). */
+    readonly targets: readonly MorphTargetDelta[];
+} | {
+    readonly fallback: "cpu";
+    readonly reason: string;
+};
+/** Smallest bucket that can hold `count` targets; `null` when it exceeds 32. */
+export declare function morphTargetBucket(count: number): MorphTargetCountBucket | null;
+/**
+ * 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 declare function buildMorphTargetTexture(geometry: Geometry, targets: readonly MorphTargetDelta[], limits: MorphTextureLimits, format?: "rgba16f" | "rgba32f"): MorphTargetTextureResult;
+/** IEEE-754 binary32 → binary16 for every element (round-half-up; subnormals flush to zero). */
+export declare function float32ArrayToFloat16(input: Float32Array): Uint16Array;
+//# sourceMappingURL=MorphTargetTexture.d.ts.map

package/dist/resources/MorphTargetTexture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MorphTargetTexture.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/resources/MorphTargetTexture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAsB,MAAM,YAAY,CAAC;AAEzD,eAAO,MAAM,0BAA0B,yBAA0B,CAAC;AAClE,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,wBAAwB,GAChC;IACE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC/C,GACD;IAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAK9E;AAID;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,GAAE,SAAS,GAAG,SAAqB,GACxC,wBAAwB,CAqE1B;AASD,gGAAgG;AAChG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,CAmBtE"}