@forgeax/engine-render 0.1.7 → 0.1.19

package/dist/transmission/inspection.d.ts

@@ -0,0 +1,57 @@
+import type { TransmissionBackdropExtent, TransmissionBackdropTopology, TransmissionCandidateAdmissionInspection, TransmissionCapabilityVerdict, TransmissionLifecycleState, TransmissionRecoveryState } from './backdrop';
+import type { TransmissionDemand } from './projection';
+export type { TransmissionBackdropExtent, TransmissionCandidateAdmissionInspection, TransmissionLifecycleState, TransmissionRecoveryState, } from './backdrop';
+export interface TransmissionInspection {
+    readonly activeCount: number;
+    readonly needsRoughMips: boolean;
+    readonly extent: TransmissionBackdropExtent;
+    readonly format: string;
+    /** Total resident mip levels, including level zero. */
+    readonly mipCount: number;
+    readonly bytes: number;
+    readonly copyCount: number;
+    readonly transmissionDrawCount: number;
+    readonly fallbackCount: number;
+    readonly generation: number;
+    readonly singleLayer: true;
+    readonly lifecycle: TransmissionLifecycleState;
+    readonly lastKnownGood: boolean;
+    readonly recovery: TransmissionRecoveryState;
+    readonly capability: TransmissionCapabilityVerdict;
+}
+export interface TransmissionInspectionInput {
+    readonly demand: TransmissionDemand;
+    readonly topology: Pick<TransmissionBackdropTopology, 'active' | 'copyCount' | 'mipCount'>;
+    readonly extent: TransmissionBackdropExtent;
+    readonly generation: number;
+    readonly lastKnownGood: boolean;
+    readonly recovery: TransmissionRecoveryState;
+    readonly lifecycle?: TransmissionLifecycleState;
+    /** Whether a committed physical backdrop is resident on the active device. */
+    readonly resourcePresent?: boolean;
+    readonly format?: string;
+    /** Override only when the resource receipt reports the actual total. */
+    readonly mipCount?: number;
+    /** Override only when the resource receipt reports the actual allocation. */
+    readonly bytes?: number;
+    readonly transmissionDrawCount?: number;
+    readonly fallbackCount?: number;
+    readonly capability?: TransmissionCapabilityVerdict;
+}
+export interface TransmissionInspectionFromAdmissionInput {
+    readonly admission: TransmissionCandidateAdmissionInspection;
+    readonly topology: TransmissionInspectionInput['topology'];
+    readonly extent: TransmissionBackdropExtent;
+    readonly transmissionDrawCount?: number;
+    readonly fallbackCount?: number;
+}
+export declare function estimateTransmissionBackdropBytes(extent: TransmissionBackdropExtent, mipCount: number, format?: string): number;
+/**
+ * Project the last completed backdrop facts into a detached, stable POD.
+ * Demand and copy/mip topology are read from their existing owners; this
+ * function never accepts a texture, view, encoder, queue, or graph handle.
+ */
+export declare function inspectTransmission(input: TransmissionInspectionInput): TransmissionInspection;
+export declare function inspectTransmissionFromAdmission(input: TransmissionInspectionFromAdmissionInput): TransmissionInspection;
+export declare function transmissionInspectionToJson(inspection: TransmissionInspection): string;
+//# sourceMappingURL=inspection.d.ts.map

package/dist/transmission/inspection.d.ts.map

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

package/dist/transmission/oracle.d.ts

@@ -0,0 +1,42 @@
+/** Pure CPU expectations for transmission math; this module has no GPU ownership. */
+export type Color3 = readonly [number, number, number];
+export type Uv2 = readonly [number, number];
+export declare const DEFAULT_IOR = 1.5;
+export declare const DEFAULT_GUARD_BAND = 0.02;
+export interface TransmissionEnergy {
+    readonly reflection: number;
+    readonly transmission: number;
+    readonly diffuse: number;
+    readonly metallicResidual: number;
+}
+export interface BackdropResolution {
+    readonly source: 'refracted' | 'environment' | 'unrefracted';
+    readonly color: Color3;
+}
+export interface BackdropInputs {
+    readonly uv: Uv2;
+    readonly refracted?: Color3;
+    readonly environment?: Color3;
+    readonly unrefracted: Color3;
+    readonly guardBand?: number;
+}
+/** Returns dielectric F0 for air to a material with the supplied IOR. */
+export declare function fresnelF0(ior: number): number;
+/**
+ * Returns unpolarized dielectric reflectance. `eta` is incident IOR divided
+ * by transmitted IOR, so values above one can produce total internal
+ * reflection. This is a CPU oracle only; it does not sample a GPU resource.
+ */
+export declare function fresnelReflectance(cosTheta: number, eta: number): number;
+export declare function splitTransmissionEnergy(input: {
+    readonly transmission: number;
+    readonly metallic: number;
+    readonly cosTheta: number;
+    readonly ior: number;
+}): TransmissionEnergy;
+export declare function beerLambertAttenuation(color: Color3, thickness: number, distance?: number): Color3;
+export declare function roughnessToLod(roughness: number, maxLod: number): number;
+export declare function isWithinGuardBand(uv: Uv2, guardBand?: number): boolean;
+export declare function resolveRefractionBackdrop(input: BackdropInputs): BackdropResolution;
+export declare function isFiniteColor(color: Color3): boolean;
+//# sourceMappingURL=oracle.d.ts.map

package/dist/transmission/oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../src/transmission/oracle.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,MAAM,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5C,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC;IACjB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAYD,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAexE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,GAAG,kBAAkB,CAarB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAiBR;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,SAAqB,GAAG,OAAO,CAIlF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,cAAc,GAAG,kBAAkB,CAenF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/transmission/projection.d.ts

@@ -0,0 +1,37 @@
+/** The two CPU facts that are allowed to influence transmission topology. */
+export interface TransmissionDemand {
+    readonly activeCount: number;
+    readonly needsRoughMips: boolean;
+}
+/** Detached material facts supplied by the persistent render-scene owner. */
+export interface TransmissionDemandCandidate {
+    readonly attached: boolean;
+    readonly ready: boolean;
+    readonly transmission: number;
+    readonly roughness: number;
+}
+export type TransmissionDemandOperation = {
+    readonly kind: 'upsert';
+    readonly key: string;
+    readonly candidate: TransmissionDemandCandidate;
+} | {
+    readonly kind: 'remove';
+    readonly key: string;
+};
+/**
+ * Incremental CPU projection for transmission topology.
+ *
+ * The projection stores no material, visibility, camera, or GPU object. Each
+ * operation updates the two counters directly; an empty operation list is a
+ * no-scan steady-state frame.
+ */
+export declare class PersistentTransmissionDemandProjection {
+    private readonly records;
+    private activeCount;
+    private roughCount;
+    apply(operations: readonly TransmissionDemandOperation[]): TransmissionDemand;
+    inspect(): TransmissionDemand;
+    private addCounts;
+    private removeCounts;
+}
+//# sourceMappingURL=projection.d.ts.map

package/dist/transmission/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/transmission/projection.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,6EAA6E;AAC7E,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,2BAA2B,GACnC;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;CACjD,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAmBtD;;;;;;GAMG;AACH,qBAAa,sCAAsC;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,UAAU,CAAK;IAEvB,KAAK,CAAC,UAAU,EAAE,SAAS,2BAA2B,EAAE,GAAG,kBAAkB;IAe7E,OAAO,IAAI,kBAAkB;IAO7B,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,YAAY;CAIrB"}

package/dist/typed-render-graph-primitives.d.ts

@@ -1,4 +1,4 @@
-import type { GraphAccess, RenderGraphBuilder, RenderGraphError } from '@forgeax/engine-render-graph';
+import type { GraphAccess, GraphTextureView, RenderGraphBuilder, RenderGraphError } from '@forgeax/engine-render-graph';
 import { type PassKind, type PassSelector, type Result } from '@forgeax/engine-types';
 import type { RenderPipelineFrame, RenderPipelineGpuDrivenProjection } from './render-pipeline';
 import { type RenderPipelineTarget } from './render-pipeline';
@@ -19,6 +19,8 @@ export interface TypedScenePassOptions {
     readonly clearColor?: readonly [number, number, number, number] | undefined;
     readonly colorLoadOp?: GPULoadOp | undefined;
     readonly depthLoadOp?: GPULoadOp | undefined;
+    readonly recordMode?: 'opaque' | 'transmission' | 'transparent' | undefined;
+    readonly transmissionBackdrop?: GraphTextureView | undefined;
     readonly extraAccesses?: readonly GraphAccess[] | undefined;
     readonly gpuDriven?: RenderPipelineGpuDrivenProjection | undefined;
 }
@@ -31,6 +33,13 @@ export interface TypedBloomTargets {
     readonly blurH: RenderPipelineTarget;
     readonly blurV: RenderPipelineTarget;
 }
+/** The semantic Bloom pass owner; graph inspection consumes these same identities. */
+export declare const TYPED_BLOOM_PASS_NAMES: {
+    readonly bright: "bloom-bright";
+    readonly blurH: "bloom-blur-h";
+    readonly blurV: "bloom-blur-v";
+    readonly composite: "bloom-composite";
+};
 export declare function addTypedBloomPasses(graph: RenderGraphBuilder<RenderPipelineFrame>, targets: TypedBloomTargets): Result<void, RenderGraphError>;
 export interface TypedSsaoTargets {
     readonly normal: RenderPipelineTarget;
@@ -47,11 +56,25 @@ export interface TypedFullscreenPassOptions {
     readonly outputOnly?: boolean | undefined;
     readonly rawSwapchainOutput?: boolean | undefined;
     readonly depth?: RenderPipelineTarget | undefined;
+    readonly additionalReads?: readonly {
+        readonly key: string;
+        readonly target: RenderPipelineTarget;
+    }[];
 }
+export interface TypedTemporalResolveTargets {
+    readonly scene: RenderPipelineTarget;
+    readonly currentTemporal: RenderPipelineTarget;
+    readonly depth: RenderPipelineTarget;
+    readonly historyColor: RenderPipelineTarget;
+    readonly historyTemporal: RenderPipelineTarget;
+    readonly writeColor: RenderPipelineTarget;
+    readonly writeTemporal: RenderPipelineTarget;
+}
+export declare function addTypedTemporalResolvePass(graph: RenderGraphBuilder<RenderPipelineFrame>, targets: TypedTemporalResolveTargets): Result<void, RenderGraphError>;
 export declare function addTypedFullscreenPass(graph: RenderGraphBuilder<RenderPipelineFrame>, options: TypedFullscreenPassOptions): Result<void, RenderGraphError>;
 export declare function addTypedCompositePostEffects(graph: RenderGraphBuilder<RenderPipelineFrame>, effects: readonly string[], input: RenderPipelineTarget, output: RenderPipelineTarget, depth: RenderPipelineTarget, size: {
     readonly width: number;
     readonly height: number;
 }): Result<void, RenderGraphError>;
-export declare function addTypedTonemapPass(graph: RenderGraphBuilder<RenderPipelineFrame>, input: RenderPipelineTarget, output: RenderPipelineTarget, outputOnly?: boolean): Result<void, RenderGraphError>;
+export declare function addTypedOutputTransformPass(graph: RenderGraphBuilder<RenderPipelineFrame>, input: RenderPipelineTarget, output: RenderPipelineTarget, outputOnly?: boolean): Result<void, RenderGraphError>;
 //# sourceMappingURL=typed-render-graph-primitives.d.ts.map

package/dist/typed-render-graph-primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed-render-graph-primitives.d.ts","sourceRoot":"","sources":["../src/typed-render-graph-primitives.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"typed-render-graph-primitives.d.ts","sourceRoot":"","sources":["../src/typed-render-graph-primitives.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-render",
-  "version": "0.1.7",
+  "version": "0.1.19",
   "description": "Canonical ECS render schemas and renderer boundary.",
   "private": false,
   "type": "module",
@@ -20,6 +20,10 @@
       "types": "./dist/internal.d.ts",
       "import": "./dist/internal.mjs"
     },
+    "./internal/temporal": {
+      "types": "./dist/temporal/index.d.ts",
+      "import": "./dist/temporal/index.mjs"
+    },
     "./package.json": "./package.json",
     "./internal/construct-renderer": {
       "types": "./dist/construct-renderer.d.ts",
@@ -33,26 +37,27 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-assets-runtime": "0.1.7",
-    "@forgeax/engine-audio-webaudio": "0.1.7",
-    "@forgeax/engine-codec": "0.1.7",
-    "@forgeax/engine-ecs": "0.1.7",
-    "@forgeax/engine-geometry": "0.1.7",
-    "@forgeax/engine-graphics-extras": "0.1.7",
-    "@forgeax/engine-math": "0.1.7",
-    "@forgeax/engine-pack": "0.1.7",
-    "@forgeax/engine-plugin": "0.1.7",
-    "@forgeax/engine-profiler": "0.1.7",
-    "@forgeax/engine-render-graph": "0.1.7",
-    "@forgeax/engine-rhi": "0.1.7",
-    "@forgeax/engine-scene": "0.1.7",
-    "@forgeax/engine-shader": "0.1.7",
-    "@forgeax/engine-skinning": "0.1.7",
-    "@forgeax/engine-types": "0.1.7"
+    "@forgeax/engine-assets-runtime": "0.1.19",
+    "@forgeax/engine-audio-webaudio": "0.1.19",
+    "@forgeax/engine-codec": "0.1.19",
+    "@forgeax/engine-ecs": "0.1.19",
+    "@forgeax/engine-geometry": "0.1.19",
+    "@forgeax/engine-graphics-extras": "0.1.19",
+    "@forgeax/engine-math": "0.1.19",
+    "@forgeax/engine-pack": "0.1.19",
+    "@forgeax/engine-plugin": "0.1.19",
+    "@forgeax/engine-profiler": "0.1.19",
+    "@forgeax/engine-render-graph": "0.1.19",
+    "@forgeax/engine-rhi": "0.1.19",
+    "@forgeax/engine-scene": "0.1.19",
+    "@forgeax/engine-shader": "0.1.19",
+    "@forgeax/engine-skinning": "0.1.19",
+    "@forgeax/engine-types": "0.1.19"
   },
   "devDependencies": {
-    "@forgeax/engine-rhi-null": "0.1.7",
-    "@forgeax/engine-rhi-webgpu": "0.1.7"
+    "@forgeax/engine-rhi-null": "0.1.19",
+    "@forgeax/engine-rhi-webgpu": "0.1.19",
+    "@forgeax/engine-vite-plugin-shader": "0.1.19"
   },
   "forgeax": {
     "metrics": {

package/src/__tests__/ai-user-cold-start.integration.test.ts

@@ -0,0 +1,59 @@
+import { describe, expect, it, vi } from 'vitest';
+import type {
+  FrameReceipt,
+  RenderError,
+  Renderer,
+  RenderFrameInput,
+  RenderInspection,
+} from '../index';
+import { FogCardinalityError } from '../index';
+
+type PublicRenderer = Pick<Renderer, 'draw' | 'inspect'>;
+
+function drawWithStructuredRetry(
+  renderer: PublicRenderer,
+  request: RenderFrameInput,
+): FrameReceipt {
+  const first = renderer.draw(request);
+  if (first.ok) return first.value;
+
+  const error: RenderError = first.error;
+  renderer.inspect();
+  if (error.code === 'environment-source-conflict') {
+    expect(error.detail.owners.length).toBeGreaterThan(1);
+  } else if (error.code === 'fog-cardinality') {
+    expect(error.detail.count).toBeGreaterThan(1);
+  } else {
+    expect(error.hint).toBeTruthy();
+  }
+  const retry = renderer.draw(request);
+  if (!retry.ok) throw new Error(retry.error.hint);
+  return retry.value;
+}
+
+describe('public render cold-start recovery route', () => {
+  it('uses one public draw request, inspect, structured detail, and same-request retry', () => {
+    const request = {} as RenderFrameInput;
+    const receipt = {
+      frameId: 3,
+      deviceGeneration: 1,
+      completed: Promise.resolve({ ok: true, value: undefined }),
+    } as FrameReceipt;
+    const failure: {
+      readonly ok: false;
+      readonly error: Extract<RenderError, { readonly code: 'fog-cardinality' }>;
+    } = {
+      ok: false as const,
+      error: new FogCardinalityError(2),
+    };
+    const renderer = {
+      draw: vi.fn().mockReturnValueOnce(failure).mockReturnValueOnce({ ok: true, value: receipt }),
+      inspect: vi.fn(() => ({ state: 'alive' }) as unknown as RenderInspection),
+    } as unknown as PublicRenderer;
+
+    expect(drawWithStructuredRetry(renderer, request)).toBe(receipt);
+    expect(renderer.draw).toHaveBeenNthCalledWith(1, request);
+    expect(renderer.draw).toHaveBeenNthCalledWith(2, request);
+    expect(renderer.inspect).toHaveBeenCalledOnce();
+  });
+});

package/src/__tests__/ai-user-public-surface.test-d.ts

@@ -0,0 +1,45 @@
+import {
+  ANTIALIAS_TAA,
+  Atmosphere,
+  Camera,
+  type EnvironmentFrame,
+  Fog,
+  type FramePlan,
+  type FrameReceipt,
+  type RenderError,
+  type Renderer,
+  type TemporalView,
+} from '@forgeax/engine-render';
+import { expectTypeOf } from 'vitest';
+
+void ANTIALIAS_TAA;
+void Atmosphere;
+void Camera;
+void Fog;
+
+declare const renderer: Renderer;
+declare const receipt: FrameReceipt;
+declare const environment: EnvironmentFrame;
+declare const temporal: TemporalView;
+declare const plan: FramePlan;
+void renderer;
+void receipt;
+void environment;
+void temporal;
+void plan;
+
+expectTypeOf<FrameReceipt['frameId']>().toEqualTypeOf<number>();
+expectTypeOf<EnvironmentFrame['source']['kind']>().toEqualTypeOf<'none' | 'image' | 'atmosphere'>();
+expectTypeOf<TemporalView['historyVersion']>().toEqualTypeOf<number>();
+expectTypeOf<
+  Extract<RenderError, { code: 'environment-source-conflict' }>['detail']
+>().toEqualTypeOf<{
+  readonly owners: readonly {
+    readonly kind: 'image' | 'atmosphere';
+    readonly entityKey: number;
+    readonly sourceKey: string;
+  }[];
+}>();
+expectTypeOf<Extract<RenderError, { code: 'fog-cardinality' }>['detail']>().toEqualTypeOf<{
+  readonly count: number;
+}>();

package/src/__tests__/bloom-exact-zero.unit.test.ts

@@ -0,0 +1,202 @@
+import { readFileSync } from 'node:fs';
+import { RenderGraphBuilder } from '@forgeax/engine-render-graph';
+import type { RhiDevice } from '@forgeax/engine-rhi';
+import { rhi } from '@forgeax/engine-rhi-null';
+import { ok } from '@forgeax/engine-types';
+import { beforeAll, describe, expect, it } from 'vitest';
+import { standardPipeline } from '../pipeline/standard-pipeline';
+import { inspectStandardBloomGraph, STANDARD_BLOOM_TARGET_SPEC } from '../pipeline/standard-post';
+import { DEFAULT_STANDARD_PROFILE, STANDARD_PIPELINE_ID } from '../pipeline/standard-profile';
+import type { RenderPipelineFrame, RenderPipelineTopology } from '../render-pipeline';
+
+let device: RhiDevice;
+
+beforeAll(async () => {
+  const adapter = await rhi.requestAdapter();
+  if (!adapter.ok) throw adapter.error;
+  const result = await adapter.value.requestDevice();
+  if (!result.ok) throw result.error;
+  device = result.value;
+});
+
+function topology(lighting: 'direct' | 'clustered', bloom: 'off' | 'on'): RenderPipelineTopology {
+  return {
+    pipelineId: STANDARD_PIPELINE_ID,
+    standardProfile: { ...DEFAULT_STANDARD_PROFILE, lighting },
+    config: lighting === 'clustered' ? { ssao: { enabled: false } } : undefined,
+    surface: {
+      width: 640,
+      height: 360,
+      storageFormat: 'bgra8unorm',
+      viewFormat: 'bgra8unorm-srgb',
+    },
+    camera: { tonemap: 'aces-filmic', antialias: 'fxaa', bloom },
+    shadow: {
+      mapSize: 64,
+      cascadeCount: 1,
+      pointCount: 0,
+      pointFaceSize: 64,
+      spotCount: 0,
+    },
+    lane: {
+      compute: lighting === 'clustered',
+      storageBuffer: lighting === 'clustered',
+      multisample: false,
+      maxColorAttachments: 8,
+    },
+    featureTopologySignature: 'none',
+    gpuDrivenTopologySignature: '',
+  };
+}
+
+function inspect(lighting: 'direct' | 'clustered', bloom: 'off' | 'on') {
+  const graph = new RenderGraphBuilder<RenderPipelineFrame>();
+  const built = standardPipeline.build(
+    {
+      graph,
+      projectGpuDriven: () => ok(undefined),
+      contributeFeatures: () => ok(undefined),
+    },
+    topology(lighting, bloom),
+  );
+  if (!built.ok) throw built.error;
+  const compiled = graph.compile({ device, surfaceSize: { width: 640, height: 360 } });
+  if (!compiled.ok) throw compiled.error;
+  return compiled.value.inspect();
+}
+
+describe('Standard Bloom exact-zero topology', () => {
+  it.each([
+    'direct',
+    'clustered',
+  ] as const)('%s Bloom off declares no Bloom targets or passes', (lighting) => {
+    const info = inspect(lighting, 'off');
+    const bloomPasses = info.passes.filter((pass) => pass.name.startsWith('bloom-'));
+    const bloomResources = info.resources.filter((resource) => resource.label.startsWith('bloom-'));
+    expect(bloomPasses).toHaveLength(0);
+    expect(bloomResources).toHaveLength(0);
+    expect(inspectStandardBloomGraph(info)).toEqual({
+      status: 'empty',
+      targetCount: 0,
+      targetBytes: 0,
+      passCount: 0,
+    });
+    expect({
+      targetCount: bloomResources.length,
+      passCount: bloomPasses.length,
+      encodeCount: bloomPasses.length,
+      bindGroupCount: bloomPasses.length,
+      uploadCount: bloomPasses.length,
+      residentBytes: bloomResources.length,
+    }).toEqual({
+      targetCount: 0,
+      passCount: 0,
+      encodeCount: 0,
+      bindGroupCount: 0,
+      uploadCount: 0,
+      residentBytes: 0,
+    });
+  });
+
+  it('keeps Bloom declaration behind the camera gate in both lane owners', () => {
+    const forwardSource = readFileSync(
+      new URL('../pipeline/standard-forward-lane.ts', import.meta.url),
+      'utf8',
+    );
+    const clusteredSource = readFileSync(
+      new URL('../pipeline/standard-pipeline.ts', import.meta.url),
+      'utf8',
+    );
+    const postSource = readFileSync(
+      new URL('../pipeline/standard-post.ts', import.meta.url),
+      'utf8',
+    );
+    expect(forwardSource).toContain('addStandardPost');
+    expect(clusteredSource).toContain('addStandardPost');
+    const gate = postSource.indexOf("topology.camera.bloom === 'on'");
+    const declaration = postSource.indexOf('STANDARD_BLOOM_TARGET_SPEC.composited');
+    expect(gate).toBeGreaterThanOrEqual(0);
+    expect(declaration).toBeGreaterThan(gate);
+  });
+
+  it('keeps one shared Bloom chain when enabled', () => {
+    for (const lighting of ['direct', 'clustered'] as const) {
+      const info = inspect(lighting, 'on');
+      expect(inspectStandardBloomGraph(info)).toEqual({
+        status: 'valid',
+        targetCount: 4,
+        targetBytes: (640 * 360 + 3 * 320 * 180) * 8,
+        passCount: 4,
+      });
+      expect(info.resources.find((resource) => resource.label === 'bloom-bright')).toMatchObject({
+        descriptor: {
+          kind: 'texture',
+          format: 'rgba16float',
+          size: STANDARD_BLOOM_TARGET_SPEC.bright.size,
+          width: 320,
+          height: 180,
+          depthOrArrayLayers: 1,
+          mipLevelCount: 1,
+          sampleCount: 1,
+        },
+      });
+      expect(
+        info.passes.map((pass) => pass.name).filter((name) => name.startsWith('bloom-')),
+      ).toEqual(['bloom-bright', 'bloom-blur-h', 'bloom-blur-v', 'bloom-composite']);
+    }
+  });
+
+  it('fails closed when a canonical Bloom descriptor drifts', () => {
+    const info = inspect('direct', 'on');
+    const drifted = {
+      ...info,
+      resources: info.resources.map((resource) =>
+        resource.label === STANDARD_BLOOM_TARGET_SPEC.bright.label
+          ? {
+              ...resource,
+              descriptor:
+                resource.descriptor.kind === 'texture'
+                  ? { ...resource.descriptor, format: 'rgba8unorm' as const }
+                  : resource.descriptor,
+            }
+          : resource,
+      ),
+    };
+    expect(inspectStandardBloomGraph(drifted)).toEqual({
+      status: 'invalid',
+      targetCount: 0,
+      targetBytes: 0,
+      passCount: 0,
+    });
+  });
+
+  it('rejects a graph with a missing canonical Bloom target', () => {
+    const info = inspect('direct', 'on');
+    const drifted = {
+      ...info,
+      resources: info.resources.filter(
+        (resource) => resource.label !== STANDARD_BLOOM_TARGET_SPEC.bright.label,
+      ),
+    };
+    expect(inspectStandardBloomGraph(drifted)).toEqual({
+      status: 'invalid',
+      targetCount: 0,
+      targetBytes: 0,
+      passCount: 0,
+    });
+  });
+
+  it('rejects a graph with a missing canonical Bloom pass', () => {
+    const info = inspect('direct', 'on');
+    const drifted = {
+      ...info,
+      passes: info.passes.filter((pass) => pass.name !== 'bloom-blur-h'),
+    };
+    expect(inspectStandardBloomGraph(drifted)).toEqual({
+      status: 'invalid',
+      targetCount: 0,
+      targetBytes: 0,
+      passCount: 0,
+    });
+  });
+});