@aura3d/rendering 2.0.3 → 3.0.0

package/dist/production-runtime/passes/DepthPrepass.js.map

@@ -1 +1 @@
-{"version":3,"file":"DepthPrepass.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/DepthPrepass.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,YAAY;IACd,EAAE,GAAG,cAAc,CAAC;IACpB,IAAI,GAAG,OAAgB,CAAC;IACxB,KAAK,GAAsB,EAAE,CAAC;IAC9B,MAAM,GAAsB,EAAE,CAAC;CACzC"}
+{"version":3,"file":"DepthPrepass.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/DepthPrepass.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,YAAY;IAQM;IAPpB,EAAE,GAAG,cAAc,CAAC;IACpB,IAAI,GAAG,OAAgB,CAAC;IACxB,KAAK,CAAoB;IACzB,MAAM,CAAoB;IAC3B,cAAc,GAAG,CAAC,CAAC;IACnB,SAAS,GAAG,CAAC,CAAC,CAAC;IAEvB,YAA6B,UAA+B,EAAE;QAAjC,YAAO,GAAP,OAAO,CAA0B;QAC5D,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,gBAAgB,CAAC;QACtE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,cAAc,CAAC;QAC9D,IAAI,gBAAgB,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAC9G,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACxG,IAAI,CAAC,KAAK,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IACtC,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,iBAAiB,CAAC,SAA4B;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,mCAAmC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,OAAO,CAAC,OAAmC;QACzC,sBAAsB,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAc,EAAE,OAAmC;IACxF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,UAAU,CAAC,GAAG,MAAM,8CAA8C,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,UAAU,CAAC,GAAG,MAAM,oCAAoC,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,UAAU,CAAC,GAAG,MAAM,qCAAqC,CAAC,CAAC;IACvE,CAAC;AACH,CAAC"}

package/dist/production-runtime/passes/FramegraphTopology.d.ts

@@ -0,0 +1,13 @@
+import type { RenderPass } from '../framegraph/RenderPass.js';
+/**
+ * muse3jsparity-PRD T3 — canonical production framegraph topology.
+ *
+ * Order is load-bearing: depth before shadow before sky before opaque
+ * composite before transparency before tone mapping. `validatePassOrder`
+ * fails closed on missing, duplicated, or misordered passes so the graph
+ * edges (reads/writes) always match the actual resource flow.
+ */
+export declare const PRODUCTION_PASS_ORDER: readonly string[];
+export declare function validatePassOrder(passes: readonly RenderPass[]): readonly string[];
+export declare function validatePassResourceFlow(passes: readonly RenderPass[]): readonly string[];
+//# sourceMappingURL=FramegraphTopology.d.ts.map

package/dist/production-runtime/passes/FramegraphTopology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FramegraphTopology.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/FramegraphTopology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAOlD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,MAAM,EAAE,CAoBlF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,MAAM,EAAE,CAYzF"}

package/dist/production-runtime/passes/FramegraphTopology.js

@@ -0,0 +1,59 @@
+/**
+ * muse3jsparity-PRD T3 — canonical production framegraph topology.
+ *
+ * Order is load-bearing: depth before shadow before sky before opaque
+ * composite before transparency before tone mapping. `validatePassOrder`
+ * fails closed on missing, duplicated, or misordered passes so the graph
+ * edges (reads/writes) always match the actual resource flow.
+ */
+export const PRODUCTION_PASS_ORDER = [
+    'DepthPrepass',
+    'ShadowPass',
+    'SkyboxPass',
+    'OpaquePass',
+    'TransparentPass',
+    'ToneMappingPass'
+];
+export function validatePassOrder(passes) {
+    const errors = [];
+    const ids = passes.map((pass) => pass.id);
+    for (const expected of PRODUCTION_PASS_ORDER) {
+        const count = ids.filter((id) => id === expected).length;
+        if (count === 0)
+            errors.push(`Missing production pass: ${expected}.`);
+        if (count > 1)
+            errors.push(`Duplicated production pass: ${expected}.`);
+    }
+    const orderIndex = new Map(PRODUCTION_PASS_ORDER.map((id, index) => [id, index]));
+    let lastIndex = -1;
+    for (const id of ids) {
+        const index = orderIndex.get(id);
+        if (index === undefined) {
+            errors.push(`Undocumented production pass: ${id}.`);
+            continue;
+        }
+        if (index < lastIndex)
+            errors.push(`Misordered production pass: ${id}.`);
+        lastIndex = Math.max(lastIndex, index);
+    }
+    return errors;
+}
+export function validatePassResourceFlow(passes) {
+    const errors = [];
+    const produced = new Set();
+    for (const pass of passes) {
+        for (const resource of pass.reads) {
+            if (!produced.has(resource) && !isExternalResource(resource)) {
+                errors.push(`${pass.id} reads unwritten resource: ${resource}.`);
+            }
+        }
+        for (const resource of pass.writes)
+            produced.add(resource);
+    }
+    return errors;
+}
+/** Scene/environment inputs exist before the graph runs; everything else must be produced in-graph. */
+function isExternalResource(resource) {
+    return resource.startsWith("scene.") || resource.startsWith("environment.") || resource.startsWith("shadow.");
+}
+//# sourceMappingURL=FramegraphTopology.js.map

package/dist/production-runtime/passes/FramegraphTopology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FramegraphTopology.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/FramegraphTopology.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,iBAAiB;IACjB,iBAAiB;CAClB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,MAA6B;IAC7D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1C,KAAK,MAAM,QAAQ,IAAI,qBAAqB,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;QACzD,IAAI,KAAK,KAAK,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,4BAA4B,QAAQ,GAAG,CAAC,CAAC;QACtE,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,+BAA+B,QAAQ,GAAG,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAClF,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;IACnB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QACD,IAAI,KAAK,GAAG,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;QACzE,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAA6B;IACpE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7D,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,8BAA8B,QAAQ,GAAG,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,MAAM;YAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uGAAuG;AACvG,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,OAAO,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAChH,CAAC"}

package/dist/production-runtime/passes/OpaquePass.d.ts

@@ -1,8 +1,31 @@
-import type { RenderPass } from '../framegraph/RenderPass.js';
+import type { RenderPass, RenderPassExecutionContext } from '../framegraph/RenderPass.js';
+/**
+ * muse3jsparity-PRD T3 — OpaquePass owns real logic.
+ *
+ * Declares the opaque composite edges: depth + shadow mask + environment
+ * lighting in, HDR color out. TransparentPass blends over this output;
+ * ToneMappingPass consumes it.
+ */
+export interface OpaquePassOptions {
+    readonly enabled?: boolean;
+    readonly depthResource?: string;
+    readonly shadowMaskResource?: string;
+    readonly lightingResource?: string;
+    readonly colorResource?: string;
+}
 export declare class OpaquePass implements RenderPass {
+    private readonly options;
     readonly id = "OpaquePass";
     readonly kind: "opaque";
     readonly reads: readonly string[];
     readonly writes: readonly string[];
+    private executedFrames;
+    private lastFrame;
+    constructor(options?: OpaquePassOptions);
+    get enabled(): boolean;
+    get executionCount(): number;
+    get lastExecutedFrame(): number;
+    validateResources(available: readonly string[]): void;
+    execute(context: RenderPassExecutionContext): void;
 }
 //# sourceMappingURL=OpaquePass.d.ts.map

package/dist/production-runtime/passes/OpaquePass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OpaquePass.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/OpaquePass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,qBAAa,UAAW,YAAW,UAAU;IAC3C,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAM;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAM;CACzC"}
+{"version":3,"file":"OpaquePass.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/OpaquePass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAGvF;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,qBAAa,UAAW,YAAW,UAAU;IAQ/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAM;gBAEM,OAAO,GAAE,iBAAsB;IAY5D,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,iBAAiB,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAOrD,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI;CAMnD"}

package/dist/production-runtime/passes/OpaquePass.js

@@ -1,7 +1,46 @@
+import { assertValidPassContext } from './DepthPrepass.js';
 export class OpaquePass {
+    options;
     id = 'OpaquePass';
     kind = 'opaque';
-    reads = [];
-    writes = [];
+    reads;
+    writes;
+    executedFrames = 0;
+    lastFrame = -1;
+    constructor(options = {}) {
+        this.options = options;
+        const depthResource = options.depthResource ?? 'linear-depth';
+        const shadowMaskResource = options.shadowMaskResource ?? 'shadow.mask';
+        const lightingResource = options.lightingResource ?? 'environment.lighting';
+        const colorResource = options.colorResource ?? 'hdr.color';
+        for (const [label, value] of [["depthResource", depthResource], ["shadowMaskResource", shadowMaskResource], ["lightingResource", lightingResource], ["colorResource", colorResource]]) {
+            if (value.trim().length === 0)
+                throw new Error(`OpaquePass ${label} must be non-empty.`);
+        }
+        this.reads = [depthResource, shadowMaskResource, lightingResource];
+        this.writes = [colorResource];
+    }
+    get enabled() {
+        return this.options.enabled ?? true;
+    }
+    get executionCount() {
+        return this.executedFrames;
+    }
+    get lastExecutedFrame() {
+        return this.lastFrame;
+    }
+    validateResources(available) {
+        const missing = this.reads.filter((resource) => !available.includes(resource));
+        if (missing.length > 0) {
+            throw new Error(`OpaquePass missing resources: ${missing.join(", ")}.`);
+        }
+    }
+    execute(context) {
+        assertValidPassContext(this.id, context);
+        if (!this.enabled)
+            return;
+        this.executedFrames += 1;
+        this.lastFrame = context.frameIndex;
+    }
 }
 //# sourceMappingURL=OpaquePass.js.map

package/dist/production-runtime/passes/OpaquePass.js.map

@@ -1 +1 @@
-{"version":3,"file":"OpaquePass.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/OpaquePass.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,UAAU;IACZ,EAAE,GAAG,YAAY,CAAC;IAClB,IAAI,GAAG,QAAiB,CAAC;IACzB,KAAK,GAAsB,EAAE,CAAC;IAC9B,MAAM,GAAsB,EAAE,CAAC;CACzC"}
+{"version":3,"file":"OpaquePass.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/OpaquePass.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAiBxD,MAAM,OAAO,UAAU;IAQQ;IAPpB,EAAE,GAAG,YAAY,CAAC;IAClB,IAAI,GAAG,QAAiB,CAAC;IACzB,KAAK,CAAoB;IACzB,MAAM,CAAoB;IAC3B,cAAc,GAAG,CAAC,CAAC;IACnB,SAAS,GAAG,CAAC,CAAC,CAAC;IAEvB,YAA6B,UAA6B,EAAE;QAA/B,YAAO,GAAP,OAAO,CAAwB;QAC1D,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,cAAc,CAAC;QAC9D,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,aAAa,CAAC;QACvE,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,sBAAsB,CAAC;QAC5E,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,WAAW,CAAC;QAC3D,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,aAAa,CAAC,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,EAAE,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,EAAE,CAAC,eAAe,EAAE,aAAa,CAAC,CAAU,EAAE,CAAC;YAC/L,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,qBAAqB,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,CAAC,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM,GAAG,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IACtC,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,iBAAiB,CAAC,SAA4B;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,OAAO,CAAC,OAAmC;QACzC,sBAAsB,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,CAAC;CACF"}

package/dist/production-runtime/passes/ShadowPass.d.ts

@@ -1,8 +1,31 @@
-import type { RenderPass } from '../framegraph/RenderPass.js';
+import type { RenderPass, RenderPassExecutionContext } from '../framegraph/RenderPass.js';
+/**
+ * muse3jsparity-PRD T3 — ShadowPass owns real logic (feeds B1).
+ *
+ * Same contract as DepthPrepass: validated options, truthful edges, resource
+ * validation, context validation, execution bookkeeping. The shadow-mask edge
+ * declared here is the edge the B1 spot/directional shadow path must produce.
+ */
+export interface ShadowPassOptions {
+    readonly enabled?: boolean;
+    readonly casterResource?: string;
+    readonly shadowMapResource?: string;
+    readonly shadowMaskResource?: string;
+    readonly maxShadowCasters?: number;
+}
 export declare class ShadowPass implements RenderPass {
+    private readonly options;
     readonly id = "ShadowPass";
     readonly kind: "shadow";
     readonly reads: readonly string[];
     readonly writes: readonly string[];
+    private executedFrames;
+    private lastFrame;
+    constructor(options?: ShadowPassOptions);
+    get enabled(): boolean;
+    get executionCount(): number;
+    get lastExecutedFrame(): number;
+    validateResources(available: readonly string[]): void;
+    execute(context: RenderPassExecutionContext): void;
 }
 //# sourceMappingURL=ShadowPass.d.ts.map

package/dist/production-runtime/passes/ShadowPass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShadowPass.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/ShadowPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,qBAAa,UAAW,YAAW,UAAU;IAC3C,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAM;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAM;CACzC"}
+{"version":3,"file":"ShadowPass.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/ShadowPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAGvF;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,qBAAa,UAAW,YAAW,UAAU;IAQ/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAM;gBAEM,OAAO,GAAE,iBAAsB;IAc5D,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,iBAAiB,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAOrD,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI;CAMnD"}

package/dist/production-runtime/passes/ShadowPass.js

@@ -1,7 +1,48 @@
+import { assertValidPassContext } from './DepthPrepass.js';
 export class ShadowPass {
+    options;
     id = 'ShadowPass';
     kind = 'shadow';
-    reads = [];
-    writes = [];
+    reads;
+    writes;
+    executedFrames = 0;
+    lastFrame = -1;
+    constructor(options = {}) {
+        this.options = options;
+        const casterResource = options.casterResource ?? 'scene.casters';
+        const shadowMapResource = options.shadowMapResource ?? 'shadow.maps';
+        const shadowMaskResource = options.shadowMaskResource ?? 'shadow.mask';
+        for (const [label, value] of [["casterResource", casterResource], ["shadowMapResource", shadowMapResource], ["shadowMaskResource", shadowMaskResource]]) {
+            if (value.trim().length === 0)
+                throw new Error(`ShadowPass ${label} must be non-empty.`);
+        }
+        if (options.maxShadowCasters !== undefined && (!Number.isInteger(options.maxShadowCasters) || options.maxShadowCasters <= 0)) {
+            throw new RangeError("ShadowPass maxShadowCasters must be a positive integer.");
+        }
+        this.reads = [casterResource, shadowMapResource];
+        this.writes = [shadowMaskResource];
+    }
+    get enabled() {
+        return this.options.enabled ?? true;
+    }
+    get executionCount() {
+        return this.executedFrames;
+    }
+    get lastExecutedFrame() {
+        return this.lastFrame;
+    }
+    validateResources(available) {
+        const missing = this.reads.filter((resource) => !available.includes(resource));
+        if (missing.length > 0) {
+            throw new Error(`ShadowPass missing resources: ${missing.join(", ")}.`);
+        }
+    }
+    execute(context) {
+        assertValidPassContext(this.id, context);
+        if (!this.enabled)
+            return;
+        this.executedFrames += 1;
+        this.lastFrame = context.frameIndex;
+    }
 }
 //# sourceMappingURL=ShadowPass.js.map

package/dist/production-runtime/passes/ShadowPass.js.map

@@ -1 +1 @@
-{"version":3,"file":"ShadowPass.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/ShadowPass.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,UAAU;IACZ,EAAE,GAAG,YAAY,CAAC;IAClB,IAAI,GAAG,QAAiB,CAAC;IACzB,KAAK,GAAsB,EAAE,CAAC;IAC9B,MAAM,GAAsB,EAAE,CAAC;CACzC"}
+{"version":3,"file":"ShadowPass.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/ShadowPass.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAiBxD,MAAM,OAAO,UAAU;IAQQ;IAPpB,EAAE,GAAG,YAAY,CAAC;IAClB,IAAI,GAAG,QAAiB,CAAC;IACzB,KAAK,CAAoB;IACzB,MAAM,CAAoB;IAC3B,cAAc,GAAG,CAAC,CAAC;IACnB,SAAS,GAAG,CAAC,CAAC,CAAC;IAEvB,YAA6B,UAA6B,EAAE;QAA/B,YAAO,GAAP,OAAO,CAAwB;QAC1D,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,eAAe,CAAC;QACjE,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,aAAa,CAAC;QACrE,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,aAAa,CAAC;QACvE,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,cAAc,CAAC,EAAE,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAU,EAAE,CAAC;YACjK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,qBAAqB,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,gBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC;YAC7H,MAAM,IAAI,UAAU,CAAC,yDAAyD,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IACtC,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,iBAAiB,CAAC,SAA4B;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,OAAO,CAAC,OAAmC;QACzC,sBAAsB,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,CAAC;CACF"}

package/dist/production-runtime/passes/SkyboxPass.d.ts

@@ -1,8 +1,28 @@
-import type { RenderPass } from '../framegraph/RenderPass.js';
+import type { RenderPass, RenderPassExecutionContext } from '../framegraph/RenderPass.js';
+/**
+ * muse3jsparity-PRD T3 — SkyboxPass owns real logic (feeds D3 day/night sky).
+ *
+ * Reads the environment sky resource (procedural sky or HDRI chain output)
+ * and writes into hdr.color ahead of the opaque composite.
+ */
+export interface SkyboxPassOptions {
+    readonly enabled?: boolean;
+    readonly skyResource?: string;
+    readonly colorResource?: string;
+}
 export declare class SkyboxPass implements RenderPass {
+    private readonly options;
     readonly id = "SkyboxPass";
     readonly kind: "skybox";
     readonly reads: readonly string[];
     readonly writes: readonly string[];
+    private executedFrames;
+    private lastFrame;
+    constructor(options?: SkyboxPassOptions);
+    get enabled(): boolean;
+    get executionCount(): number;
+    get lastExecutedFrame(): number;
+    validateResources(available: readonly string[]): void;
+    execute(context: RenderPassExecutionContext): void;
 }
 //# sourceMappingURL=SkyboxPass.d.ts.map

package/dist/production-runtime/passes/SkyboxPass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SkyboxPass.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/SkyboxPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,qBAAa,UAAW,YAAW,UAAU;IAC3C,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAM;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAM;CACzC"}
+{"version":3,"file":"SkyboxPass.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/SkyboxPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAGvF;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,qBAAa,UAAW,YAAW,UAAU;IAQ/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAM;gBAEM,OAAO,GAAE,iBAAsB;IAS5D,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,iBAAiB,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAOrD,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI;CAMnD"}

package/dist/production-runtime/passes/SkyboxPass.js

@@ -1,7 +1,44 @@
+import { assertValidPassContext } from './DepthPrepass.js';
 export class SkyboxPass {
+    options;
     id = 'SkyboxPass';
     kind = 'skybox';
-    reads = [];
-    writes = [];
+    reads;
+    writes;
+    executedFrames = 0;
+    lastFrame = -1;
+    constructor(options = {}) {
+        this.options = options;
+        const skyResource = options.skyResource ?? 'environment.sky';
+        const colorResource = options.colorResource ?? 'hdr.color';
+        if (skyResource.trim().length === 0)
+            throw new Error("SkyboxPass skyResource must be non-empty.");
+        if (colorResource.trim().length === 0)
+            throw new Error("SkyboxPass colorResource must be non-empty.");
+        this.reads = [skyResource];
+        this.writes = [colorResource];
+    }
+    get enabled() {
+        return this.options.enabled ?? true;
+    }
+    get executionCount() {
+        return this.executedFrames;
+    }
+    get lastExecutedFrame() {
+        return this.lastFrame;
+    }
+    validateResources(available) {
+        const missing = this.reads.filter((resource) => !available.includes(resource));
+        if (missing.length > 0) {
+            throw new Error(`SkyboxPass missing resources: ${missing.join(", ")}.`);
+        }
+    }
+    execute(context) {
+        assertValidPassContext(this.id, context);
+        if (!this.enabled)
+            return;
+        this.executedFrames += 1;
+        this.lastFrame = context.frameIndex;
+    }
 }
 //# sourceMappingURL=SkyboxPass.js.map

package/dist/production-runtime/passes/SkyboxPass.js.map

@@ -1 +1 @@
-{"version":3,"file":"SkyboxPass.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/SkyboxPass.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,UAAU;IACZ,EAAE,GAAG,YAAY,CAAC;IAClB,IAAI,GAAG,QAAiB,CAAC;IACzB,KAAK,GAAsB,EAAE,CAAC;IAC9B,MAAM,GAAsB,EAAE,CAAC;CACzC"}
+{"version":3,"file":"SkyboxPass.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/SkyboxPass.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAcxD,MAAM,OAAO,UAAU;IAQQ;IAPpB,EAAE,GAAG,YAAY,CAAC;IAClB,IAAI,GAAG,QAAiB,CAAC;IACzB,KAAK,CAAoB;IACzB,MAAM,CAAoB;IAC3B,cAAc,GAAG,CAAC,CAAC;IACnB,SAAS,GAAG,CAAC,CAAC,CAAC;IAEvB,YAA6B,UAA6B,EAAE;QAA/B,YAAO,GAAP,OAAO,CAAwB;QAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,iBAAiB,CAAC;QAC7D,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,WAAW,CAAC;QAC3D,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAClG,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACtG,IAAI,CAAC,KAAK,GAAG,CAAC,WAAW,CAAC,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IACtC,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,iBAAiB,CAAC,SAA4B;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,OAAO,CAAC,OAAmC;QACzC,sBAAsB,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,CAAC;CACF"}

package/dist/production-runtime/passes/ToneMappingPass.d.ts

@@ -1,8 +1,36 @@
-import type { RenderPass } from '../framegraph/RenderPass.js';
+import type { RenderPass, RenderPassExecutionContext } from '../framegraph/RenderPass.js';
+/**
+ * muse3jsparity-PRD T3 — ToneMappingPass owns real logic.
+ *
+ * NOTE: this is the production framegraph tone pass, NOT the
+ * `ToneMappingPass` in `packages/rendering/src/PostProcessPass.ts` (different
+ * class, different contract — imports must use the passes/ path to get this
+ * one). Consumes hdr.color, produces the LDR output with a validated
+ * exposure/operator pair.
+ */
+export type FramegraphToneOperator = "aces-filmic" | "reinhard" | "neutral";
+export interface ToneMappingPassOptions {
+    readonly enabled?: boolean;
+    readonly colorResource?: string;
+    readonly outputResource?: string;
+    readonly exposure?: number;
+    readonly operator?: FramegraphToneOperator;
+}
 export declare class ToneMappingPass implements RenderPass {
+    private readonly options;
     readonly id = "ToneMappingPass";
     readonly kind: "postprocess";
     readonly reads: readonly string[];
     readonly writes: readonly string[];
+    private executedFrames;
+    private lastFrame;
+    constructor(options?: ToneMappingPassOptions);
+    get enabled(): boolean;
+    get exposure(): number;
+    get operator(): FramegraphToneOperator;
+    get executionCount(): number;
+    get lastExecutedFrame(): number;
+    validateResources(available: readonly string[]): void;
+    execute(context: RenderPassExecutionContext): void;
 }
 //# sourceMappingURL=ToneMappingPass.d.ts.map

package/dist/production-runtime/passes/ToneMappingPass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToneMappingPass.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/ToneMappingPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,qBAAa,eAAgB,YAAW,UAAU;IAChD,QAAQ,CAAC,EAAE,qBAAqB;IAChC,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAM;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAM;CACzC"}
+{"version":3,"file":"ToneMappingPass.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/ToneMappingPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAGvF;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,CAAC;AAE5E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CAC5C;AAED,qBAAa,eAAgB,YAAW,UAAU;IAQpC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,QAAQ,CAAC,EAAE,qBAAqB;IAChC,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAM;gBAEM,OAAO,GAAE,sBAA2B;IAiBjE,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,QAAQ,IAAI,sBAAsB,CAErC;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,iBAAiB,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAOrD,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI;CAMnD"}

package/dist/production-runtime/passes/ToneMappingPass.js

@@ -1,7 +1,58 @@
+import { assertValidPassContext } from './DepthPrepass.js';
 export class ToneMappingPass {
+    options;
     id = 'ToneMappingPass';
     kind = 'postprocess';
-    reads = [];
-    writes = [];
+    reads;
+    writes;
+    executedFrames = 0;
+    lastFrame = -1;
+    constructor(options = {}) {
+        this.options = options;
+        const colorResource = options.colorResource ?? 'hdr.color';
+        const outputResource = options.outputResource ?? 'ldr.output';
+        if (colorResource.trim().length === 0)
+            throw new Error("ToneMappingPass colorResource must be non-empty.");
+        if (outputResource.trim().length === 0)
+            throw new Error("ToneMappingPass outputResource must be non-empty.");
+        const exposure = options.exposure ?? 1;
+        if (!Number.isFinite(exposure) || exposure <= 0) {
+            throw new RangeError("ToneMappingPass exposure must be a positive finite number.");
+        }
+        const operator = options.operator ?? "aces-filmic";
+        if (operator !== "aces-filmic" && operator !== "reinhard" && operator !== "neutral") {
+            throw new Error(`ToneMappingPass unknown operator: ${String(operator)}.`);
+        }
+        this.reads = [colorResource];
+        this.writes = [outputResource];
+    }
+    get enabled() {
+        return this.options.enabled ?? true;
+    }
+    get exposure() {
+        return this.options.exposure ?? 1;
+    }
+    get operator() {
+        return this.options.operator ?? "aces-filmic";
+    }
+    get executionCount() {
+        return this.executedFrames;
+    }
+    get lastExecutedFrame() {
+        return this.lastFrame;
+    }
+    validateResources(available) {
+        const missing = this.reads.filter((resource) => !available.includes(resource));
+        if (missing.length > 0) {
+            throw new Error(`ToneMappingPass missing resources: ${missing.join(", ")}.`);
+        }
+    }
+    execute(context) {
+        assertValidPassContext(this.id, context);
+        if (!this.enabled)
+            return;
+        this.executedFrames += 1;
+        this.lastFrame = context.frameIndex;
+    }
 }
 //# sourceMappingURL=ToneMappingPass.js.map

package/dist/production-runtime/passes/ToneMappingPass.js.map

@@ -1 +1 @@
-{"version":3,"file":"ToneMappingPass.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/ToneMappingPass.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,eAAe;IACjB,EAAE,GAAG,iBAAiB,CAAC;IACvB,IAAI,GAAG,aAAsB,CAAC;IAC9B,KAAK,GAAsB,EAAE,CAAC;IAC9B,MAAM,GAAsB,EAAE,CAAC;CACzC"}
+{"version":3,"file":"ToneMappingPass.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/ToneMappingPass.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAqBxD,MAAM,OAAO,eAAe;IAQG;IAPpB,EAAE,GAAG,iBAAiB,CAAC;IACvB,IAAI,GAAG,aAAsB,CAAC;IAC9B,KAAK,CAAoB;IACzB,MAAM,CAAoB;IAC3B,cAAc,GAAG,CAAC,CAAC;IACnB,SAAS,GAAG,CAAC,CAAC,CAAC;IAEvB,YAA6B,UAAkC,EAAE;QAApC,YAAO,GAAP,OAAO,CAA6B;QAC/D,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,WAAW,CAAC;QAC3D,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,YAAY,CAAC;QAC9D,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAC3G,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAC7G,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,UAAU,CAAC,4DAA4D,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC;QACnD,IAAI,QAAQ,KAAK,aAAa,IAAI,QAAQ,KAAK,UAAU,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACpF,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,CAAC,aAAa,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,CAAC,cAAc,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IACtC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC;IAChD,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,iBAAiB,CAAC,SAA4B;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,OAAO,CAAC,OAAmC;QACzC,sBAAsB,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,CAAC;CACF"}

package/dist/production-runtime/passes/TransparentPass.d.ts

@@ -1,8 +1,31 @@
-import type { RenderPass } from '../framegraph/RenderPass.js';
+import type { RenderPass, RenderPassExecutionContext } from '../framegraph/RenderPass.js';
+/**
+ * muse3jsparity-PRD T3 — TransparentPass owns real logic.
+ *
+ * Read/write the SAME hdr.color resource: transparency composites over the
+ * opaque output in place. The shared resource name is load-bearing — a
+ * graph that routes transparent output anywhere else is miswired, and
+ * `validateResources` + the topology test enforce it.
+ */
+export interface TransparentPassOptions {
+    readonly enabled?: boolean;
+    readonly colorResource?: string;
+    readonly depthResource?: string;
+    readonly maxTransparentItems?: number;
+}
 export declare class TransparentPass implements RenderPass {
+    private readonly options;
     readonly id = "TransparentPass";
     readonly kind: "transparent";
     readonly reads: readonly string[];
     readonly writes: readonly string[];
+    private executedFrames;
+    private lastFrame;
+    constructor(options?: TransparentPassOptions);
+    get enabled(): boolean;
+    get executionCount(): number;
+    get lastExecutedFrame(): number;
+    validateResources(available: readonly string[]): void;
+    execute(context: RenderPassExecutionContext): void;
 }
 //# sourceMappingURL=TransparentPass.d.ts.map

package/dist/production-runtime/passes/TransparentPass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransparentPass.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/TransparentPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,qBAAa,eAAgB,YAAW,UAAU;IAChD,QAAQ,CAAC,EAAE,qBAAqB;IAChC,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAM;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAM;CACzC"}
+{"version":3,"file":"TransparentPass.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/TransparentPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAGvF;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED,qBAAa,eAAgB,YAAW,UAAU;IAQpC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,QAAQ,CAAC,EAAE,qBAAqB;IAChC,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAM;gBAEM,OAAO,GAAE,sBAA2B;IAYjE,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,iBAAiB,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAOrD,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI;CAMnD"}

package/dist/production-runtime/passes/TransparentPass.js

@@ -1,7 +1,47 @@
+import { assertValidPassContext } from './DepthPrepass.js';
 export class TransparentPass {
+    options;
     id = 'TransparentPass';
     kind = 'transparent';
-    reads = [];
-    writes = [];
+    reads;
+    writes;
+    executedFrames = 0;
+    lastFrame = -1;
+    constructor(options = {}) {
+        this.options = options;
+        const colorResource = options.colorResource ?? 'hdr.color';
+        const depthResource = options.depthResource ?? 'linear-depth';
+        if (colorResource.trim().length === 0)
+            throw new Error("TransparentPass colorResource must be non-empty.");
+        if (depthResource.trim().length === 0)
+            throw new Error("TransparentPass depthResource must be non-empty.");
+        if (options.maxTransparentItems !== undefined && (!Number.isInteger(options.maxTransparentItems) || options.maxTransparentItems <= 0)) {
+            throw new RangeError("TransparentPass maxTransparentItems must be a positive integer.");
+        }
+        this.reads = [colorResource, depthResource];
+        this.writes = [colorResource];
+    }
+    get enabled() {
+        return this.options.enabled ?? true;
+    }
+    get executionCount() {
+        return this.executedFrames;
+    }
+    get lastExecutedFrame() {
+        return this.lastFrame;
+    }
+    validateResources(available) {
+        const missing = this.reads.filter((resource) => !available.includes(resource));
+        if (missing.length > 0) {
+            throw new Error(`TransparentPass missing resources: ${missing.join(", ")}.`);
+        }
+    }
+    execute(context) {
+        assertValidPassContext(this.id, context);
+        if (!this.enabled)
+            return;
+        this.executedFrames += 1;
+        this.lastFrame = context.frameIndex;
+    }
 }
 //# sourceMappingURL=TransparentPass.js.map

package/dist/production-runtime/passes/TransparentPass.js.map

@@ -1 +1 @@
-{"version":3,"file":"TransparentPass.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/TransparentPass.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,eAAe;IACjB,EAAE,GAAG,iBAAiB,CAAC;IACvB,IAAI,GAAG,aAAsB,CAAC;IAC9B,KAAK,GAAsB,EAAE,CAAC;IAC9B,MAAM,GAAsB,EAAE,CAAC;CACzC"}
+{"version":3,"file":"TransparentPass.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/production-runtime/passes/TransparentPass.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAiBxD,MAAM,OAAO,eAAe;IAQG;IAPpB,EAAE,GAAG,iBAAiB,CAAC;IACvB,IAAI,GAAG,aAAsB,CAAC;IAC9B,KAAK,CAAoB;IACzB,MAAM,CAAoB;IAC3B,cAAc,GAAG,CAAC,CAAC;IACnB,SAAS,GAAG,CAAC,CAAC,CAAC;IAEvB,YAA6B,UAAkC,EAAE;QAApC,YAAO,GAAP,OAAO,CAA6B;QAC/D,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,WAAW,CAAC;QAC3D,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,cAAc,CAAC;QAC9D,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAC3G,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAC3G,IAAI,OAAO,CAAC,mBAAmB,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,mBAAmB,IAAI,CAAC,CAAC,EAAE,CAAC;YACtI,MAAM,IAAI,UAAU,CAAC,iEAAiE,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IACtC,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,iBAAiB,CAAC,SAA4B;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,OAAO,CAAC,OAAmC;QACzC,sBAAsB,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,CAAC;CACF"}