@aura3d/rendering 3.0.1 → 4.0.2

package/dist/batching/shaders/instanceEmissive.glsl.js

@@ -0,0 +1,63 @@
+/**
+ * PRD 11 Phase 3 — `a3d_prd11_instance_emissive` chunks + `prd11.instanceEmissive`
+ * feature (§6.6): per-instance emissive colour rides a third instanced
+ * attribute (`a_instanceEmissive`) so members of one batch may carry
+ * different emissive signatures without splitting the draw.
+ *
+ * The legacy path cannot express this (no `u_instanceEmissive` plumbing in
+ * `aura3d/instanced-pbr`), so the feature only activates on the generated
+ * C-02 program path — exactly the constraint the planner encodes by counting
+ * `emissive-varies` members out of merged batches.
+ */
+import { registerShaderChunk, registerShaderFeature } from "../../contracts/program.js";
+import { registerWgslTwin } from "../../program/chunks/manifest.js";
+import { PRD11_INSTANCE_EMISSIVE_VTX_WGSL, PRD11_INSTANCE_EMISSIVE_FRAG_WGSL } from "../../program/chunks/instanceEmissive.wgsl.js";
+export const PRD11_INSTANCE_EMISSIVE_VTX_CHUNK = "a3d_prd11_instance_emissive_vtx";
+export const PRD11_INSTANCE_EMISSIVE_FRAG_CHUNK = "a3d_prd11_instance_emissive_frag";
+export const PRD11_INSTANCE_EMISSIVE_FEATURE = "prd11.instanceEmissive";
+const VTX_GLSL = /* glsl */ `
+#ifdef A3D_PRD11_INSTANCE_EMISSIVE
+in vec3 a_instanceEmissive;
+out vec3 v_a3dInstanceEmissive;
+#endif
+`;
+const FRAG_GLSL = /* glsl */ `
+#ifdef A3D_PRD11_INSTANCE_EMISSIVE
+in vec3 v_a3dInstanceEmissive;
+#endif
+`;
+let registered = false;
+export function registerPrd11InstanceEmissiveShader() {
+    if (registered)
+        return;
+    registered = true;
+    registerShaderChunk({
+        name: PRD11_INSTANCE_EMISSIVE_VTX_CHUNK,
+        owner: "prd11",
+        glsl: VTX_GLSL,
+        wgsl: PRD11_INSTANCE_EMISSIVE_VTX_WGSL,
+        stage: "vertex"
+    });
+    registerWgslTwin({ chunkName: PRD11_INSTANCE_EMISSIVE_VTX_CHUNK, owner: "prd11", wgsl: PRD11_INSTANCE_EMISSIVE_VTX_WGSL });
+    registerShaderChunk({
+        name: PRD11_INSTANCE_EMISSIVE_FRAG_CHUNK,
+        owner: "prd11",
+        glsl: FRAG_GLSL,
+        wgsl: PRD11_INSTANCE_EMISSIVE_FRAG_WGSL,
+        stage: "fragment"
+    });
+    registerWgslTwin({ chunkName: PRD11_INSTANCE_EMISSIVE_FRAG_CHUNK, owner: "prd11", wgsl: PRD11_INSTANCE_EMISSIVE_FRAG_WGSL });
+    registerShaderFeature({
+        id: PRD11_INSTANCE_EMISSIVE_FEATURE,
+        owner: "prd11",
+        flag: "A3D_QR_TIERS_BATCHING",
+        select: (input) => emissiveLength(input.item) > 0 ? true : undefined,
+        defines: () => ({ A3D_PRD11_INSTANCE_EMISSIVE: true }),
+        chunks: [PRD11_INSTANCE_EMISSIVE_VTX_CHUNK, PRD11_INSTANCE_EMISSIVE_FRAG_CHUNK],
+        hooks: ["vertex:pars", "fragment:pars"]
+    });
+}
+function emissiveLength(item) {
+    return item.instanceEmissive?.length ?? 0;
+}
+//# sourceMappingURL=instanceEmissive.glsl.js.map

package/dist/batching/shaders/instanceEmissive.glsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instanceEmissive.glsl.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/batching/shaders/instanceEmissive.glsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErF,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,gCAAgC,EAAE,iCAAiC,EAAE,MAAM,4CAA4C,CAAC;AAEjI,MAAM,CAAC,MAAM,iCAAiC,GAAG,iCAAiC,CAAC;AACnF,MAAM,CAAC,MAAM,kCAAkC,GAAG,kCAAkC,CAAC;AACrF,MAAM,CAAC,MAAM,+BAA+B,GAAG,wBAAwB,CAAC;AAExE,MAAM,QAAQ,GAAG,UAAU,CAAC;;;;;CAK3B,CAAC;AAEF,MAAM,SAAS,GAAG,UAAU,CAAC;;;;CAI5B,CAAC;AAEF,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,MAAM,UAAU,mCAAmC;IACjD,IAAI,UAAU;QAAE,OAAO;IACvB,UAAU,GAAG,IAAI,CAAC;IAClB,mBAAmB,CAAC;QAClB,IAAI,EAAE,iCAAiC;QACvC,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,gCAAgC;QACtC,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;IACH,gBAAgB,CAAC,EAAE,SAAS,EAAE,iCAAiC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,gCAAgC,EAAE,CAAC,CAAC;IAC3H,mBAAmB,CAAC;QAClB,IAAI,EAAE,kCAAkC;QACxC,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,iCAAiC;QACvC,KAAK,EAAE,UAAU;KAClB,CAAC,CAAC;IACH,gBAAgB,CAAC,EAAE,SAAS,EAAE,kCAAkC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC,CAAC;IAC7H,qBAAqB,CAAC;QACpB,EAAE,EAAE,+BAA+B;QACnC,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,uBAAuB;QAC7B,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACpE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,2BAA2B,EAAE,IAAI,EAAE,CAAC;QACtD,MAAM,EAAE,CAAC,iCAAiC,EAAE,kCAAkC,CAAC;QAC/E,KAAK,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC;KACxC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,IAAgB;IACtC,OAAO,IAAI,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/cinematic/BloomPass.d.ts

@@ -1,10 +1,6 @@
-import { type CinematicRendererEvidenceFlag } from "./CinematicEvidence.js";
-export interface CinematicBloomPass {
-    readonly name: "bloom";
-    readonly threshold: number;
-    readonly intensity: number;
-    readonly radius: number;
-    readonly rendererOwnedEvidence: CinematicRendererEvidenceFlag;
-}
-export declare function createCinematicBloomPass(options?: Partial<Omit<CinematicBloomPass, "name" | "rendererOwnedEvidence">>): CinematicBloomPass;
+/**
+ * @deprecated Moved to `../reference` (PRD-03 Phase 3); this shim keeps the
+ * old path compiling. Dropping the re-export is Q-15-4.
+ */
+export * from "../reference/BloomPass.js";
 //# sourceMappingURL=BloomPass.d.ts.map

package/dist/cinematic/BloomPass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BloomPass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/BloomPass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAE1G,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,qBAAqB,EAAE,6BAA6B,CAAC;CAC/D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,uBAAuB,CAAC,CAAM,GAAG,kBAAkB,CAe9I"}
+{"version":3,"file":"BloomPass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/BloomPass.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,wBAAwB,CAAC"}

package/dist/cinematic/BloomPass.js

@@ -1,18 +1,6 @@
-import { createRendererOwnedEvidenceFlag } from "./CinematicEvidence.js";
-export function createCinematicBloomPass(options = {}) {
-    return {
-        name: "bloom",
-        threshold: options.threshold ?? 0.72,
-        intensity: options.intensity ?? 0.28,
-        radius: options.radius ?? 1.35,
-        rendererOwnedEvidence: createRendererOwnedEvidenceFlag({
-            id: "postprocess:bloom",
-            feature: "postprocess",
-            label: "Bloom/glow pass",
-            source: "renderer-postprocess",
-            sceneContent: false,
-            diagnostics: ["Bloom is a renderer postprocess pass over emissive scene content."]
-        })
-    };
-}
+/**
+ * @deprecated Moved to `../reference` (PRD-03 Phase 3); this shim keeps the
+ * old path compiling. Dropping the re-export is Q-15-4.
+ */
+export * from "../reference/BloomPass.js";
 //# sourceMappingURL=BloomPass.js.map

package/dist/cinematic/BloomPass.js.map

@@ -1 +1 @@
-{"version":3,"file":"BloomPass.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/BloomPass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAsC,MAAM,qBAAqB,CAAC;AAU1G,MAAM,UAAU,wBAAwB,CAAC,UAA+E,EAAE;IACxH,OAAO;QACL,IAAI,EAAE,OAAO;QACb,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,qBAAqB,EAAE,+BAA+B,CAAC;YACrD,EAAE,EAAE,mBAAmB;YACvB,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,iBAAiB;YACxB,MAAM,EAAE,sBAAsB;YAC9B,YAAY,EAAE,KAAK;YACnB,WAAW,EAAE,CAAC,mEAAmE,CAAC;SACnF,CAAC;KACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"BloomPass.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/BloomPass.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,wBAAwB,CAAC"}

package/dist/cinematic/DepthHazePass.d.ts

@@ -1,12 +1,6 @@
-import { type CinematicRendererEvidenceFlag } from "./CinematicEvidence.js";
-export interface CinematicDepthHazePass {
-    readonly name: "depth-haze";
-    readonly color: readonly [number, number, number];
-    readonly density: number;
-    readonly startMeters: number;
-    readonly endMeters: number;
-    readonly requiresDepth: boolean;
-    readonly rendererOwnedEvidence: CinematicRendererEvidenceFlag;
-}
-export declare function createCinematicDepthHazePass(options?: Partial<Omit<CinematicDepthHazePass, "name" | "rendererOwnedEvidence">>): CinematicDepthHazePass;
+/**
+ * @deprecated Moved to `../reference` (PRD-03 Phase 3); this shim keeps the
+ * old path compiling. Dropping the re-export is Q-15-4.
+ */
+export * from "../reference/DepthHazePass.js";
 //# sourceMappingURL=DepthHazePass.d.ts.map

package/dist/cinematic/DepthHazePass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DepthHazePass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/DepthHazePass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAE1G,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,qBAAqB,EAAE,6BAA6B,CAAC;CAC/D;AAED,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,uBAAuB,CAAC,CAAM,GAAG,sBAAsB,CAiB1J"}
+{"version":3,"file":"DepthHazePass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/DepthHazePass.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,4BAA4B,CAAC"}

package/dist/cinematic/DepthHazePass.js

@@ -1,20 +1,6 @@
-import { createRendererOwnedEvidenceFlag } from "./CinematicEvidence.js";
-export function createCinematicDepthHazePass(options = {}) {
-    return {
-        name: "depth-haze",
-        color: options.color ?? [0.22, 0.34, 0.52],
-        density: options.density ?? 0.22,
-        startMeters: options.startMeters ?? 2.5,
-        endMeters: options.endMeters ?? 18,
-        requiresDepth: options.requiresDepth ?? true,
-        rendererOwnedEvidence: createRendererOwnedEvidenceFlag({
-            id: "postprocess:depth-haze",
-            feature: "postprocess",
-            label: "Depth haze pass",
-            source: "renderer-postprocess",
-            sceneContent: false,
-            diagnostics: ["Depth haze is renderer-owned atmospheric composition; DOM fog panels do not satisfy this evidence."]
-        })
-    };
-}
+/**
+ * @deprecated Moved to `../reference` (PRD-03 Phase 3); this shim keeps the
+ * old path compiling. Dropping the re-export is Q-15-4.
+ */
+export * from "../reference/DepthHazePass.js";
 //# sourceMappingURL=DepthHazePass.js.map

package/dist/cinematic/DepthHazePass.js.map

@@ -1 +1 @@
-{"version":3,"file":"DepthHazePass.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/DepthHazePass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAsC,MAAM,qBAAqB,CAAC;AAY1G,MAAM,UAAU,4BAA4B,CAAC,UAAmF,EAAE;IAChI,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAC1C,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,GAAG;QACvC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;QAClC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;QAC5C,qBAAqB,EAAE,+BAA+B,CAAC;YACrD,EAAE,EAAE,wBAAwB;YAC5B,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,iBAAiB;YACxB,MAAM,EAAE,sBAAsB;YAC9B,YAAY,EAAE,KAAK;YACnB,WAAW,EAAE,CAAC,oGAAoG,CAAC;SACpH,CAAC;KACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"DepthHazePass.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/DepthHazePass.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,4BAA4B,CAAC"}

package/dist/cinematic/FilmGrainPass.d.ts

@@ -1,9 +1,6 @@
-import { type CinematicRendererEvidenceFlag } from "./CinematicEvidence.js";
-export interface CinematicFilmGrainPass {
-    readonly name: "film-grain";
-    readonly intensity: number;
-    readonly animated: boolean;
-    readonly rendererOwnedEvidence: CinematicRendererEvidenceFlag;
-}
-export declare function createCinematicFilmGrainPass(options?: Partial<Omit<CinematicFilmGrainPass, "name" | "rendererOwnedEvidence">>): CinematicFilmGrainPass;
+/**
+ * @deprecated Moved to `../reference` (PRD-03 Phase 3); this shim keeps the
+ * old path compiling. Dropping the re-export is Q-15-4.
+ */
+export * from "../reference/FilmGrainPass.js";
 //# sourceMappingURL=FilmGrainPass.d.ts.map

package/dist/cinematic/FilmGrainPass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilmGrainPass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/FilmGrainPass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAE1G,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,qBAAqB,EAAE,6BAA6B,CAAC;CAC/D;AAED,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,uBAAuB,CAAC,CAAM,GAAG,sBAAsB,CAc1J"}
+{"version":3,"file":"FilmGrainPass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/FilmGrainPass.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,4BAA4B,CAAC"}

package/dist/cinematic/FilmGrainPass.js

@@ -1,17 +1,6 @@
-import { createRendererOwnedEvidenceFlag } from "./CinematicEvidence.js";
-export function createCinematicFilmGrainPass(options = {}) {
-    return {
-        name: "film-grain",
-        intensity: options.intensity ?? 0.025,
-        animated: options.animated ?? true,
-        rendererOwnedEvidence: createRendererOwnedEvidenceFlag({
-            id: "postprocess:film-grain",
-            feature: "postprocess",
-            label: "Film grain pass",
-            source: "renderer-postprocess",
-            sceneContent: false,
-            diagnostics: ["Film grain is bounded by default so screenshot gates are not satisfied by noise alone."]
-        })
-    };
-}
+/**
+ * @deprecated Moved to `../reference` (PRD-03 Phase 3); this shim keeps the
+ * old path compiling. Dropping the re-export is Q-15-4.
+ */
+export * from "../reference/FilmGrainPass.js";
 //# sourceMappingURL=FilmGrainPass.js.map

package/dist/cinematic/FilmGrainPass.js.map

@@ -1 +1 @@
-{"version":3,"file":"FilmGrainPass.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/FilmGrainPass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAsC,MAAM,qBAAqB,CAAC;AAS1G,MAAM,UAAU,4BAA4B,CAAC,UAAmF,EAAE;IAChI,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;QACrC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;QAClC,qBAAqB,EAAE,+BAA+B,CAAC;YACrD,EAAE,EAAE,wBAAwB;YAC5B,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,iBAAiB;YACxB,MAAM,EAAE,sBAAsB;YAC9B,YAAY,EAAE,KAAK;YACnB,WAAW,EAAE,CAAC,wFAAwF,CAAC;SACxG,CAAC;KACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"FilmGrainPass.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/FilmGrainPass.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,4BAA4B,CAAC"}

package/dist/cinematic/VignettePass.d.ts

@@ -1,10 +1,6 @@
-import { type CinematicRendererEvidenceFlag } from "./CinematicEvidence.js";
-export interface CinematicVignettePass {
-    readonly name: "vignette";
-    readonly intensity: number;
-    readonly radius: number;
-    readonly softness: number;
-    readonly rendererOwnedEvidence: CinematicRendererEvidenceFlag;
-}
-export declare function createCinematicVignettePass(options?: Partial<Omit<CinematicVignettePass, "name" | "rendererOwnedEvidence">>): CinematicVignettePass;
+/**
+ * @deprecated Moved to `../reference` (PRD-03 Phase 3); this shim keeps the
+ * old path compiling. Dropping the re-export is Q-15-4.
+ */
+export * from "../reference/VignettePass.js";
 //# sourceMappingURL=VignettePass.d.ts.map

package/dist/cinematic/VignettePass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VignettePass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/VignettePass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAE1G,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,qBAAqB,EAAE,6BAA6B,CAAC;CAC/D;AAED,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,uBAAuB,CAAC,CAAM,GAAG,qBAAqB,CAcvJ"}
+{"version":3,"file":"VignettePass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/VignettePass.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,2BAA2B,CAAC"}

package/dist/cinematic/VignettePass.js

@@ -1,17 +1,6 @@
-import { createRendererOwnedEvidenceFlag } from "./CinematicEvidence.js";
-export function createCinematicVignettePass(options = {}) {
-    return {
-        name: "vignette",
-        intensity: options.intensity ?? 0.18,
-        radius: options.radius ?? 0.78,
-        softness: options.softness ?? 0.48,
-        rendererOwnedEvidence: createRendererOwnedEvidenceFlag({
-            id: "postprocess:vignette",
-            feature: "postprocess",
-            label: "Vignette pass",
-            source: "renderer-postprocess",
-            sceneContent: false
-        })
-    };
-}
+/**
+ * @deprecated Moved to `../reference` (PRD-03 Phase 3); this shim keeps the
+ * old path compiling. Dropping the re-export is Q-15-4.
+ */
+export * from "../reference/VignettePass.js";
 //# sourceMappingURL=VignettePass.js.map

package/dist/cinematic/VignettePass.js.map

@@ -1 +1 @@
-{"version":3,"file":"VignettePass.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/VignettePass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAsC,MAAM,qBAAqB,CAAC;AAU1G,MAAM,UAAU,2BAA2B,CAAC,UAAkF,EAAE;IAC9H,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;QAClC,qBAAqB,EAAE,+BAA+B,CAAC;YACrD,EAAE,EAAE,sBAAsB;YAC1B,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,sBAAsB;YAC9B,YAAY,EAAE,KAAK;SACpB,CAAC;KACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"VignettePass.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/VignettePass.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,2BAA2B,CAAC"}

package/dist/cinematic/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./CinematicEvidence.js";
-export * from "./CinematicMaterialPresets.js";
+export { createCinematicMaterialPreset, createCinematicPBRMaterial, listCinematicMaterialPresets, resolveCinematicMaterialPresetId } from "../MaterialPresets.js";
+export type { CinematicMaterialPreset, CinematicMaterialPresetId } from "../MaterialPresets.js";
 export * from "./CinematicLightingRig.js";
 export * from "./CinematicPostProcess.js";
 export * from "./BloomPass.js";

package/dist/cinematic/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AAClK,YAAY,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAChG,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC"}

package/dist/cinematic/index.js

@@ -1,5 +1,5 @@
 export * from "./CinematicEvidence.js";
-export * from "./CinematicMaterialPresets.js";
+export { createCinematicMaterialPreset, createCinematicPBRMaterial, listCinematicMaterialPresets, resolveCinematicMaterialPresetId } from "../MaterialPresets.js";
 export * from "./CinematicLightingRig.js";
 export * from "./CinematicPostProcess.js";
 export * from "./BloomPass.js";

package/dist/cinematic/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/cinematic/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AAElK,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC"}

package/dist/contracts/atmosphere.d.ts

@@ -0,0 +1,30 @@
+/**
+ * C-21 — fog/wetness chunk registry and sky background source (rendering side,
+ * CONTRACTS.md). Provider: PRD 07. Flag: A3D_QR_VFX.
+ *
+ * The spec's AuraSkySpec is an engine-level type (packages/engine/contracts/
+ * atmosphere.ts); rendering cannot import upward, so it is carried as an opaque
+ * spec record here. The engine-side stub lowers it to sky.dayNight.
+ */
+import type { RenderTarget } from "../RenderDevice.js";
+import type { RenderDevice } from "../RenderDevice.js";
+import { type ContractSlot } from "./core.js";
+/** Engine AuraSkySpec, carried opaquely on the rendering side. */
+export type AuraSkySpecLike = Readonly<Record<string, unknown>>;
+/** Chunk "a3d_prd07_fog": vec3 a3dApplyFog(vec3 color, vec3 worldPos); float a3dFogAmount(vec3 worldPos); float a3dHeightFogTau(vec3 a, vec3 b, float density). Hook "fragment:fog". */
+export declare const FOG_CHUNK: "a3d_prd07_fog";
+/** Chunk "a3d_prd07_wetness" behind #define A3D_WETNESS; uniforms u_wetness, u_puddleThreshold, u_rainRipples, u_snowCover. Hook "fragment:material". */
+export declare const WETNESS_CHUNK: "a3d_prd07_wetness";
+export interface SkyBackgroundPassLike {
+    setSpec(spec: AuraSkySpecLike, time: number): void;
+    renderToCubeFace(face: 0 | 1 | 2 | 3 | 4 | 5, target: RenderTarget, viewProjection: Float32Array): void;
+    horizonRadiance(azimuthSamples: 8): Float32Array;
+}
+export declare const skyBackgroundSlot: ContractSlot<(device: RenderDevice) => SkyBackgroundPassLike>;
+type SkyListener = (spec: AuraSkySpecLike) => void;
+/** Sky change event for re-capture (C-07-OUT-4): emitted when the sun moves > 0.5 degrees. */
+export declare function onSkyChanged(listener: SkyListener): () => void;
+/** Fired by the VFX lane whenever the sky spec's lighting contribution changes. */
+export declare function emitSkyChanged(spec: AuraSkySpecLike): void;
+export {};
+//# sourceMappingURL=atmosphere.d.ts.map

package/dist/contracts/atmosphere.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atmosphere.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/atmosphere.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE/D,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEhE,wLAAwL;AACxL,eAAO,MAAM,SAAS,EAAE,eAAiC,CAAC;AAC1D,yJAAyJ;AACzJ,eAAO,MAAM,aAAa,EAAE,mBAAyC,CAAC;AACtE,MAAM,WAAW,qBAAqB;IAAG,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,eAAe,CAAC,cAAc,EAAE,CAAC,GAAG,YAAY,CAAC;CAAE;AAmBzP,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,qBAAqB,CACV,CAAC;AAEnF,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;AAGnD,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,IAAI,CAG9D;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAE1D"}

package/dist/contracts/atmosphere.js

@@ -0,0 +1,42 @@
+/**
+ * C-21 — fog/wetness chunk registry and sky background source (rendering side,
+ * CONTRACTS.md). Provider: PRD 07. Flag: A3D_QR_VFX.
+ *
+ * The spec's AuraSkySpec is an engine-level type (packages/engine/contracts/
+ * atmosphere.ts); rendering cannot import upward, so it is carried as an opaque
+ * spec record here. The engine-side stub lowers it to sky.dayNight.
+ */
+import { defineContractSlot } from "./core.js";
+/** Chunk "a3d_prd07_fog": vec3 a3dApplyFog(vec3 color, vec3 worldPos); float a3dFogAmount(vec3 worldPos); float a3dHeightFogTau(vec3 a, vec3 b, float density). Hook "fragment:fog". */
+export const FOG_CHUNK = "a3d_prd07_fog";
+/** Chunk "a3d_prd07_wetness" behind #define A3D_WETNESS; uniforms u_wetness, u_puddleThreshold, u_rainRipples, u_snowCover. Hook "fragment:material". */
+export const WETNESS_CHUNK = "a3d_prd07_wetness";
+/**
+ * PR 0a: `renderToCubeFace` clears to the horizon colour (the gradient pass
+ * today's EnvironmentBackgroundPass already draws). Horizon radiance is zero —
+ * sky→IBL capture is PRD 07's real work.
+ */
+class StubSkyBackground {
+    spec = null;
+    time = 0;
+    setSpec(spec, time) { this.spec = spec; this.time = time; }
+    renderToCubeFace(_face, _target, _viewProjection) {
+        // PR 0b wires the existing gradient pass; the stub records the call.
+    }
+    horizonRadiance(_azimuthSamples) {
+        return new Float32Array(3);
+    }
+}
+export const skyBackgroundSlot = defineContractSlot("C-21", "prd07", "A3D_QR_VFX", () => new StubSkyBackground());
+const skyListeners = new Set();
+/** Sky change event for re-capture (C-07-OUT-4): emitted when the sun moves > 0.5 degrees. */
+export function onSkyChanged(listener) {
+    skyListeners.add(listener);
+    return () => { skyListeners.delete(listener); };
+}
+/** Fired by the VFX lane whenever the sky spec's lighting contribution changes. */
+export function emitSkyChanged(spec) {
+    for (const listener of skyListeners)
+        listener(spec);
+}
+//# sourceMappingURL=atmosphere.js.map

package/dist/contracts/atmosphere.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atmosphere.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/atmosphere.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,kBAAkB,EAAqB,MAAM,QAAQ,CAAC;AAK/D,wLAAwL;AACxL,MAAM,CAAC,MAAM,SAAS,GAAoB,eAAe,CAAC;AAC1D,yJAAyJ;AACzJ,MAAM,CAAC,MAAM,aAAa,GAAwB,mBAAmB,CAAC;AAGtE;;;;GAIG;AACH,MAAM,iBAAiB;IACb,IAAI,GAA2B,IAAI,CAAC;IACpC,IAAI,GAAG,CAAC,CAAC;IACjB,OAAO,CAAC,IAAqB,EAAE,IAAY,IAAU,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1F,gBAAgB,CAAC,KAA4B,EAAE,OAAqB,EAAE,eAA6B;QACjG,qEAAqE;IACvE,CAAC;IACD,eAAe,CAAC,eAAkB;QAChC,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,iBAAiB,GAC5B,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;AAGnF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAe,CAAC;AAE5C,8FAA8F;AAC9F,MAAM,UAAU,YAAY,CAAC,QAAqB;IAChD,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,GAAG,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAAC,IAAqB;IAClD,KAAK,MAAM,QAAQ,IAAI,YAAY;QAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC"}

package/dist/contracts/blend.d.ts

@@ -0,0 +1,28 @@
+/**
+ * C-04 — BlendMode, RenderCommandState, DepthCompare (CONTRACTS.md). Provider: PRD 01.
+ * RenderCommandState (RenderDevice.ts:135) gains optional fields in PR 0a.
+ */
+import type { RenderCommandState } from "../RenderDevice.js";
+export type BlendFactor = "zero" | "one" | "src-color" | "one-minus-src-color" | "src-alpha" | "one-minus-src-alpha" | "dst-color" | "one-minus-dst-color" | "dst-alpha" | "one-minus-dst-alpha";
+export type BlendEquation = "add" | "subtract" | "reverse-subtract" | "min" | "max";
+export interface BlendComponent {
+    readonly equation: BlendEquation;
+    readonly src: BlendFactor;
+    readonly dst: BlendFactor;
+}
+export type BlendMode = "opaque" | "alpha" | "premultiplied" | "additive" | "multiply" | {
+    readonly kind: "custom";
+    readonly color: BlendComponent;
+    readonly alpha: BlendComponent;
+};
+export type DepthCompare = "never" | "less" | "equal" | "less-equal" | "greater" | "not-equal" | "greater-equal" | "always";
+export type AuraBlendMode = "opaque" | "alpha" | "premultiplied" | "additive" | "multiply";
+/**
+ * Maps the legacy `blend: true` to `alpha` and `false` to `opaque`;
+ * `blendMode` wins over `blend` when present. Named modes resolve to their
+ * §6.8 component pair; "opaque" short-circuits.
+ */
+export declare function resolveBlendMode(state: RenderCommandState): Exclude<BlendMode, string> | "opaque";
+/** Stable across WebGL2 and WebGPU: same state tuple => same key. Scissor excluded (dynamic state). */
+export declare function renderStateKey(state: RenderCommandState): number;
+//# sourceMappingURL=blend.d.ts.map

package/dist/contracts/blend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blend.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/blend.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,qBAAqB,GAAG,WAAW,GAAG,qBAAqB,GAAG,WAAW,GAAG,qBAAqB,GAAG,WAAW,GAAG,qBAAqB,CAAC;AACjM,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,UAAU,GAAG,kBAAkB,GAAG,KAAK,GAAG,KAAK,CAAC;AACpF,MAAM,WAAW,cAAc;IAAG,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;CAAE;AAC3H,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,eAAe,GAAG,UAAU,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AACrL,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,eAAe,GAAG,QAAQ,CAAC;AAC5H,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,eAAe,GAAG,UAAU,GAAG,UAAU,CAAC;AAW3F;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,QAAQ,CASjG;AAkBD,uGAAuG;AACvG,wBAAgB,cAAc,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CA6BhE"}

package/dist/contracts/blend.js

@@ -0,0 +1,73 @@
+/**
+ * C-04 — BlendMode, RenderCommandState, DepthCompare (CONTRACTS.md). Provider: PRD 01.
+ * RenderCommandState (RenderDevice.ts:135) gains optional fields in PR 0a.
+ */
+const NAMED_BLEND_COMPONENTS = {
+    alpha: { color: { equation: "add", src: "src-alpha", dst: "one-minus-src-alpha" }, alpha: { equation: "add", src: "one", dst: "one-minus-src-alpha" } },
+    premultiplied: { color: { equation: "add", src: "one", dst: "one-minus-src-alpha" }, alpha: { equation: "add", src: "one", dst: "one-minus-src-alpha" } },
+    // additive/multiply accumulate alpha so they mark C-05 output coverage
+    // (an additive quad over the untouched clear is tone-mapped, as in three).
+    additive: { color: { equation: "add", src: "src-alpha", dst: "one" }, alpha: { equation: "add", src: "one", dst: "one" } },
+    multiply: { color: { equation: "add", src: "dst-color", dst: "one-minus-src-alpha" }, alpha: { equation: "add", src: "one", dst: "one" } }
+};
+/**
+ * Maps the legacy `blend: true` to `alpha` and `false` to `opaque`;
+ * `blendMode` wins over `blend` when present. Named modes resolve to their
+ * §6.8 component pair; "opaque" short-circuits.
+ */
+export function resolveBlendMode(state) {
+    const mode = state.blendMode ?? (state.blend ? "alpha" : "opaque");
+    if (mode === "opaque")
+        return "opaque";
+    if (typeof mode === "string") {
+        const components = NAMED_BLEND_COMPONENTS[mode];
+        return { kind: "custom", color: components.color, alpha: components.alpha };
+    }
+    const custom = mode;
+    return { kind: "custom", color: custom.color, alpha: custom.alpha };
+}
+const BLEND_EQUATION_CODES = {
+    "add": 0, "subtract": 1, "reverse-subtract": 2, "min": 3, "max": 4
+};
+const BLEND_FACTOR_CODES = {
+    "zero": 0, "one": 1, "src-color": 2, "one-minus-src-color": 3, "src-alpha": 4,
+    "one-minus-src-alpha": 5, "dst-color": 6, "one-minus-dst-color": 7, "dst-alpha": 8,
+    "one-minus-dst-alpha": 9
+};
+// eq(0-4) * 100 + src(0-9) * 10 + dst(0-9) -> [0, 499] per component; the pair
+// packs losslessly into 18 bits (500*500 < 2^18), so distinct custom states
+// always produce distinct keys.
+function blendComponentIndex(component) {
+    return BLEND_EQUATION_CODES[component.equation] * 100 + BLEND_FACTOR_CODES[component.src] * 10 + BLEND_FACTOR_CODES[component.dst];
+}
+/** Stable across WebGL2 and WebGPU: same state tuple => same key. Scissor excluded (dynamic state). */
+export function renderStateKey(state) {
+    const mode = state.blendMode ?? (state.blend ? "alpha" : "opaque");
+    const modeCode = mode === "opaque" ? 0 :
+        mode === "alpha" ? 1 :
+            mode === "premultiplied" ? 2 :
+                mode === "additive" ? 3 :
+                    mode === "multiply" ? 4 : 5;
+    const compare = state.depthCompareV2 ?? state.depthCompare;
+    const compareCode = [
+        "never", "less", "equal", "less-equal", "greater", "not-equal", "greater-equal", "always"
+    ].indexOf(compare);
+    const cullCode = state.cullMode === "back" ? 1 : state.cullMode === "front" ? 2 : 0;
+    let components = 0;
+    if (mode !== "opaque") {
+        const pair = typeof mode === "string"
+            ? NAMED_BLEND_COMPONENTS[mode]
+            : { color: mode.color, alpha: mode.alpha };
+        components = blendComponentIndex(pair.color) * 500 + blendComponentIndex(pair.alpha);
+    }
+    let key = 0;
+    key |= modeCode & 0x7;
+    key |= (compareCode & 0xf) << 3;
+    key |= (state.depthTest ? 1 : 0) << 7;
+    key |= (state.depthWrite ? 1 : 0) << 8;
+    key |= cullCode << 9;
+    key |= (state.alphaToCoverage ? 1 : 0) << 11;
+    key |= (components & 0x3ffff) << 12;
+    return key >>> 0;
+}
+//# sourceMappingURL=blend.js.map

package/dist/contracts/blend.js.map

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

package/dist/contracts/core.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Aura3D Quality Rebuild — shared contract mechanics (CONTRACTS.md §1.1).
+ *
+ * `@aura3d/rendering` is the lowest package shared by renderer, assets and
+ * engine. Every cross-PRD dependency is a numbered contract with a frozen
+ * TypeScript surface, a stub shipped in PR 0, and a conformance test. The real
+ * implementation replaces the stub behind a flag; consumers never change code
+ * at swap time.
+ */
+export type PrdId = "prd01" | "prd02" | "prd03" | "prd04" | "prd05" | "prd06" | "prd07" | "prd08" | "prd09" | "prd10" | "prd11" | "prd12" | "prd13" | "prd14" | "prd15";
+export type ContractId = `C-${string}`;
+/** Full flag names; see CONTRACTS.md §5. */
+export type QrFlagName = "A3D_QR_CORE" | "A3D_QR_LIGHTING" | "A3D_QR_POST" | "A3D_QR_MATERIALS" | "A3D_QR_ASSETS" | "A3D_QR_ANIMATION" | "A3D_QR_VFX" | "A3D_QR_CAMERA" | "A3D_QR_GAME" | "A3D_QR_WORLD" | "A3D_QR_TIERS" | "A3D_QR_WEBGPU" | "A3D_QR_LOOKS" | "A3D_QR_COMPILER" | "A3D_QR_STRICT" | `A3D_QR_${string}_${string}`;
+export type QrFlagValue = boolean | string;
+export interface QrFlags {
+    readonly values: Readonly<Partial<Record<QrFlagName, QrFlagValue>>>;
+    on(name: QrFlagName): boolean;
+}
+export interface ContractSlot<T> {
+    readonly id: ContractId;
+    readonly owner: PrdId;
+    readonly flag: QrFlagName;
+    readonly stub: T;
+    /** True once the provider lane has called provide(). */
+    readonly provided: boolean;
+    /** Called exactly once, from the provider's lane barrel. A second call throws `CONTRACT_ALREADY_PROVIDED:<id>`. */
+    provide(real: T): void;
+    /** Real impl iff provided && flags.on(flag); otherwise stub. Call at mount/resolve time, never per draw. */
+    get(flags: QrFlags): T;
+}
+export declare function defineContractSlot<T>(id: ContractId, owner: PrdId, flag: QrFlagName, stub: T): ContractSlot<T>;
+/** Registry primitive used by every hook registry in §3 (ordered, owner-tagged, duplicate-id safe). */
+export interface RegistryEntry {
+    readonly id: string;
+    readonly owner: PrdId;
+    readonly flag: QrFlagName;
+    readonly order?: number;
+}
+export interface Registry<E extends RegistryEntry> {
+    /** duplicate id throws REGISTRY_DUPLICATE:<id> */
+    register(entry: E): () => void;
+    /** entries whose flag is on, sorted by (order ?? 0, id) */
+    active(flags: QrFlags): readonly E[];
+    all(): readonly E[];
+}
+export declare function createRegistry<E extends RegistryEntry>(name: string): Registry<E>;
+//# sourceMappingURL=core.d.ts.map

package/dist/contracts/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,KAAK,GACb,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAC7E,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAExE,MAAM,MAAM,UAAU,GAAG,KAAK,MAAM,EAAE,CAAC;AAEvC,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAClB,aAAa,GAAG,iBAAiB,GAAG,aAAa,GAAG,kBAAkB,GAAG,eAAe,GACxF,kBAAkB,GAAG,YAAY,GAAG,eAAe,GAAG,aAAa,GAAG,cAAc,GACpF,cAAc,GAAG,eAAe,GAAG,cAAc,GAAG,iBAAiB,GAAG,eAAe,GACvF,UAAU,MAAM,IAAI,MAAM,EAAE,CAAC;AAEjC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACpE,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,mHAAmH;IACnH,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACvB,4GAA4G;IAC5G,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;CACxB;AA8BD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAE9G;AAED,uGAAuG;AACvG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,aAAa;IAC/C,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC;IAC/B,2DAA2D;IAC3D,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC;IACrC,GAAG,IAAI,SAAS,CAAC,EAAE,CAAC;CACrB;AA6BD,wBAAgB,cAAc,CAAC,CAAC,SAAS,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAEjF"}