@forgeax/engine-render 0.1.2

package/dist/post-process-errors.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Closed union of fullscreen post-process error codes.
+ *
+ * Exactly 7 members; AI users perform exhaustive `switch (err.code)` without a default
+ * and TS guards completeness (AC-08).
+ *
+ * | code | channel | trigger |
+ * |:--|:--|:--|
+ * | `'post-process-already-registered'` | throw | a second `postProcess.register(id, entry)` under an already-registered `id` |
+ * | `'post-process-not-found'` | throw / `Result.err` | `addFullscreenPass({shader: id})` where `id` resolves to no registered post-process |
+ * | `'fullscreen-input-not-found'` | throw | `addFullscreenPass({reads: [key]})` where `key` is not a graph-declared color target, or a depth key missing TEXTURE_BINDING (D-4) |
+ * | `'ssao-radius-non-positive'` | throw | SSAO `radius <= 0` |
+ * | `'ssao-bias-negative'` | throw | SSAO `bias < 0` |
+ * | `'params-size-mismatch'` | throw | `postProcess.register({params})` with `byteSize < 16` or `defaultValue.length !== byteSize` (feat-20260621 M-A4 / D-4) |
+ * | `'params-update-size-mismatch'` | throw | per-frame data-driven write where `PostProcessParams.data` byteLength !== registered `params.byteSize` (feat-20260621 M-A4 / D-4) |
+ */
+export type PostProcessErrorCode = keyof typeof POST_PROCESS_POLICY;
+/**
+ * Detail for `'post-process-already-registered'`: the post-process id that was already taken.
+ * AI consumers read `.detail.id` by property access (charter P4), no message parsing.
+ */
+export interface PostProcessPreviouslyRegisteredDetail {
+    readonly id: string;
+}
+/**
+ * Detail for `'post-process-not-found'`: the post-process id that resolved to no
+ * registered entry. Read via `.detail.id` after the code guard.
+ */
+export interface PostProcessNotFoundDetail {
+    readonly id: string;
+}
+/**
+ * Detail for `'fullscreen-input-not-found'`: the graph resource key that the
+ * per-pass resolve context could not resolve, plus the pass name that referenced
+ * it. Both fields are read via property access after `if (err.code === 'fullscreen-input-not-found')`
+ * (charter P4); the AI user immediately knows WHICH key to declare and WHICH
+ * pass needs wiring.
+ */
+export interface FullscreenInputNotFoundDetail {
+    /** The reads[0] key that resolved to undefined (e.g. 'offscreenColor' / 'hdrColor'). */
+    readonly readsKey: string;
+    /** The pass name passed to addFullscreenPass (the 2nd argument; e.g. 'pp' / 'post'). */
+    readonly passName: string;
+}
+/**
+ * Detail for `'ssao-radius-non-positive'`: the SSAO radius parameter was zero or negative.
+ * AI consumers read `.detail.paramName` / `.detail.value` by property access (charter P4).
+ */
+export interface SsaoRadiusNonPositiveDetail {
+    readonly paramName: string;
+    readonly value: number;
+}
+/**
+ * Detail for `'ssao-bias-negative'`: the SSAO bias parameter was negative.
+ * AI consumers read `.detail.paramName` / `.detail.value` by property access.
+ */
+export interface SsaoBiasNegativeDetail {
+    readonly paramName: string;
+    readonly value: number;
+}
+/**
+ * Detail for `'params-size-mismatch'`: the register call's byteSize / defaultValue.length
+ * is invalid. Carries `byteSize` (the declared size) and `actualLength` (defaultValue.length).
+ * AI consumers read `.detail.byteSize` / `.detail.actualLength` after the code guard.
+ */
+export interface PostProcessParamsSizeMismatchDetail {
+    readonly byteSize: number;
+    readonly actualLength: number;
+}
+/**
+ * Detail for `'params-update-size-mismatch'`: the per-frame data-driven write
+ * (PostProcessParams.data) had a byteLength that did not equal the registered
+ * `params.byteSize`. Carries `byteSize` (registered) + `actualLength` (the
+ * supplied data byteLength). AI consumers read `.detail.byteSize` /
+ * `.detail.actualLength` after the code guard.
+ *
+ * NOTE (feat-20260621 M-A2): this code is wired here so dispatchFullscreenPass
+ * can fail-fast on a mismatched per-frame write; the full error-model
+ * formalization (expected/hint refinement, JSDoc member count, public
+ * PostProcessError union variant) is finished in M-A4.
+ */
+export interface PostProcessParamsUpdateSizeMismatchDetail {
+    readonly byteSize: number;
+    readonly actualLength: number;
+}
+/**
+ * Conditional resolver from `PostProcessErrorCode` to its detail payload type. Used by the
+ * constructor signature so `new PostProcessError({ code: 'X', detail })` narrows the
+ * `detail` parameter to the variant payload at compile time.
+ */
+export type PostProcessErrorDetailFor<C extends PostProcessErrorCode> = C extends 'post-process-already-registered' ? PostProcessPreviouslyRegisteredDetail : C extends 'post-process-not-found' ? PostProcessNotFoundDetail : C extends 'fullscreen-input-not-found' ? FullscreenInputNotFoundDetail : C extends 'ssao-radius-non-positive' ? SsaoRadiusNonPositiveDetail : C extends 'ssao-bias-negative' ? SsaoBiasNegativeDetail : C extends 'params-size-mismatch' ? PostProcessParamsSizeMismatchDetail : C extends 'params-update-size-mismatch' ? PostProcessParamsUpdateSizeMismatchDetail : never;
+/**
+ * Tagged union of `.detail` payloads. The variants are unique by structural fields
+ * (`{ id }` for the two id-by-string variants vs `{ readsKey, passName }` for the
+ * graph-resource-miss variant); the code discriminator narrows the intent across
+ * the two id-shaped variants.
+ */
+export type PostProcessErrorDetail = PostProcessErrorDetailFor<PostProcessErrorCode>;
+declare const POST_PROCESS_POLICY: {
+    'post-process-already-registered': {
+        expected: string;
+        hint: (detail: unknown) => string;
+    };
+    'post-process-not-found': {
+        expected: string;
+        hint: (detail: unknown) => string;
+    };
+    'fullscreen-input-not-found': {
+        expected: string;
+        hint: (detail: unknown) => string;
+    };
+    'ssao-radius-non-positive': {
+        expected: string;
+        hint: (detail: unknown) => string;
+    };
+    'ssao-bias-negative': {
+        expected: string;
+        hint: (detail: unknown) => string;
+    };
+    'params-size-mismatch': {
+        expected: string;
+        hint: (detail: unknown) => string;
+    };
+    'params-update-size-mismatch': {
+        expected: string;
+        hint: (detail: unknown) => string;
+    };
+};
+declare class PostProcessErrorClass extends Error {
+    readonly code: PostProcessErrorCode;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: PostProcessErrorDetail;
+    constructor(args: {
+        code: PostProcessErrorCode;
+        detail: PostProcessErrorDetail;
+    });
+}
+/**
+ * Variant intersection: a `PostProcessErrorClass` instance whose `code` literal narrows to
+ * `C` and whose `detail` narrows to `PostProcessErrorDetailFor<C>`, so `if (err.code === 'X')`
+ * simultaneously narrows `err.detail` (charter P3 + P4 discriminated union).
+ */
+type PostProcessErrorVariant<C extends PostProcessErrorCode> = PostProcessErrorClass & {
+    readonly code: C;
+    readonly detail: PostProcessErrorDetailFor<C>;
+};
+/**
+ * Public PostProcessError type - mapped from the authoritative code union.
+ *
+ * ```ts
+ * function recover(err: PostProcessError): string {
+ *   switch (err.code) {
+ *     case 'post-process-already-registered': return `id taken: ${err.detail.id}`;
+ *     case 'post-process-not-found':          return `bad id: ${err.detail.id}`;
+ *     case 'fullscreen-input-not-found':      return `bad reads key: ${err.detail.readsKey} on pass ${err.detail.passName}`;
+ *   }
+ * }
+ * ```
+ */
+export type PostProcessError = {
+    [C in PostProcessErrorCode]: PostProcessErrorVariant<C>;
+}[PostProcessErrorCode];
+interface PostProcessErrorConstructor {
+    new <C extends PostProcessErrorCode>(args: {
+        code: C;
+        detail: PostProcessErrorDetailFor<C>;
+    }): PostProcessErrorVariant<C>;
+    readonly prototype: PostProcessErrorClass;
+}
+/**
+ * PostProcessError constructor - `new PostProcessError({ code, detail })`.
+ *
+ * The generic `C` is inferred from the literal `code` argument, which narrows `detail` to
+ * the per-code payload (`PostProcessErrorDetailFor<C>`) and narrows the return type to the
+ * corresponding `PostProcessErrorVariant<C>` so the call site walks the discriminated union
+ * without manual cast (AppError pattern; TS class declarations cannot directly express
+ * `<C> ... PostProcessErrorVariant<C>` polymorphism, hence the typed-cast affordance).
+ */
+export declare const PostProcessError: PostProcessErrorConstructor;
+export {};
+//# sourceMappingURL=post-process-errors.d.ts.map

package/dist/post-process-errors.d.ts.map

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

package/dist/prepare/__tests__/schema-readers.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema-readers.unit.test.d.ts.map

package/dist/prepare/__tests__/schema-readers.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-readers.unit.test.d.ts","sourceRoot":"","sources":["../../../src/prepare/__tests__/schema-readers.unit.test.ts"],"names":[],"mappings":""}

package/dist/prepare/index.d.ts

@@ -0,0 +1,4 @@
+export type { PreparedFrame } from '../frame-chain';
+export { prepareFrame } from '../frame-chain';
+export { createPreparedGraphicsResolver, type PreparedGraphicsResolvedResource, type PreparedGraphicsResolver, type PreparedGraphicsResolverInput, } from './prepared-graphics-resolver';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prepare/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACL,8BAA8B,EAC9B,KAAK,gCAAgC,EACrC,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,GACnC,MAAM,8BAA8B,CAAC"}

package/dist/prepare/prepared-graphics-resolver.d.ts

@@ -0,0 +1,62 @@
+import type { BindGroup, Buffer, RenderPipeline, RhiDevice } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import { type RenderError } from '../errors/render';
+import type { RenderFeatureResolvedGpuBuffer } from '../features/prepared-gpu-work';
+import type { RenderFeatureBindingsDescriptor, RenderFeaturePreparedRef } from '../features/prepared-graphics';
+import type { PreparedGraphicsItem, PreparedGraphicsKind, PreparedGraphicsNormalizedDescriptor } from '../features/prepared-graphics-store';
+type PreparedBufferKind = Exclude<PreparedGraphicsKind, 'pipeline' | 'bindings'>;
+export type PreparedGraphicsReference = RenderFeaturePreparedRef<'pipeline'> | RenderFeaturePreparedRef<'bindings'> | RenderFeaturePreparedRef<'vertex-data'> | RenderFeaturePreparedRef<'index-data'>;
+export type PreparedGraphicsResolvedResource = {
+    readonly kind: 'pipeline';
+    readonly reference: RenderFeaturePreparedRef;
+    readonly handle: RenderPipeline;
+} | {
+    readonly kind: 'bindings';
+    readonly reference: RenderFeaturePreparedRef;
+    readonly handle: BindGroup | undefined;
+    readonly pipeline?: RenderPipeline;
+    readonly descriptor?: RenderFeatureBindingsDescriptor;
+    readonly dynamicOffsets?: readonly number[];
+} | {
+    readonly kind: PreparedBufferKind;
+    readonly reference: RenderFeaturePreparedRef;
+    readonly handle: Buffer;
+    readonly size: number;
+    readonly physicalUsage: number;
+};
+export interface PreparedGraphicsResolverInput {
+    readonly device: RhiDevice;
+    /** Owning feature identity survives lookup failures for feature-local diagnostics. */
+    readonly featureIdentity?: string;
+    readonly generation: number;
+    readonly capabilityAvailable: boolean;
+    readonly lookup: (reference: RenderFeaturePreparedRef) => PreparedGraphicsItem | undefined;
+    readonly resolvePipeline: (descriptor: PreparedGraphicsNormalizedDescriptor & {
+        readonly kind: 'pipeline';
+    }) => Result<RenderPipeline, unknown>;
+    readonly resolveBindings: (descriptor: RenderFeatureBindingsDescriptor, pipeline: RenderPipeline) => Result<undefined | BindGroup | {
+        readonly handle: BindGroup;
+        readonly dynamicOffsets?: readonly number[];
+        readonly release: () => Result<void, unknown>;
+    }, unknown>;
+    readonly resolveGpuBuffer?: (reference: import('../features/prepared-gpu-work').RenderFeatureGpuBufferRef) => RenderFeatureResolvedGpuBuffer | undefined;
+    readonly featureOrder?: number;
+}
+export interface PreparedGraphicsResolver {
+    resolve(reference: PreparedGraphicsReference): Result<PreparedGraphicsResolvedResource, RenderError>;
+    readonly leases: readonly PreparedGraphicsResourceLease[];
+    readonly resolveGpuBuffer?: PreparedGraphicsResolverInput['resolveGpuBuffer'];
+    release(): Result<void, RenderError>;
+}
+export interface PreparedGraphicsResourceLease {
+    release(): Result<void, RenderError>;
+}
+export interface PreparedGraphicsResolvedSnapshot {
+    readonly generation: number;
+    readonly leases?: readonly PreparedGraphicsResourceLease[];
+    readonly resolve: (reference: RenderFeaturePreparedRef) => PreparedGraphicsResolvedResource | undefined;
+    readonly resolveGpuBuffer?: (reference: import('../features/prepared-gpu-work').RenderFeatureGpuBufferRef) => RenderFeatureResolvedGpuBuffer | undefined;
+}
+export declare function createPreparedGraphicsResolver(input: PreparedGraphicsResolverInput): PreparedGraphicsResolver;
+export {};
+//# sourceMappingURL=prepared-graphics-resolver.d.ts.map

package/dist/prepare/prepared-graphics-resolver.d.ts.map

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

package/dist/prepare/schema-readers.d.ts

@@ -0,0 +1,11 @@
+import type { RenderExtract } from '../extract/schema-readers';
+export interface PreparedRenderSchemas {
+    readonly meshAssetHandle: unknown;
+    readonly lightDirection: unknown;
+    readonly cameraProjection: number;
+    readonly cameraNear: number;
+    readonly cameraFar: number;
+}
+/** Prepare the extracted fields for record without substituting provisional defaults. */
+export declare function prepareRenderSchemas(frame: RenderExtract): PreparedRenderSchemas;
+//# sourceMappingURL=schema-readers.d.ts.map

package/dist/prepare/schema-readers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-readers.d.ts","sourceRoot":"","sources":["../../src/prepare/schema-readers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,qBAAqB,CAQhF"}

package/dist/record/__tests__/environment-record.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=environment-record.test.d.ts.map

package/dist/record/__tests__/environment-record.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-record.test.d.ts","sourceRoot":"","sources":["../../../src/record/__tests__/environment-record.test.ts"],"names":[],"mappings":""}

package/dist/record/__tests__/frame-targets.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=frame-targets.unit.test.d.ts.map

package/dist/record/__tests__/frame-targets.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-targets.unit.test.d.ts","sourceRoot":"","sources":["../../../src/record/__tests__/frame-targets.unit.test.ts"],"names":[],"mappings":""}

package/dist/record/__tests__/material-bg-cache.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=material-bg-cache.unit.test.d.ts.map

package/dist/record/__tests__/material-bg-cache.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-bg-cache.unit.test.d.ts","sourceRoot":"","sources":["../../../src/record/__tests__/material-bg-cache.unit.test.ts"],"names":[],"mappings":""}

package/dist/record/__tests__/material-slot-plan.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=material-slot-plan.unit.test.d.ts.map

package/dist/record/__tests__/material-slot-plan.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-slot-plan.unit.test.d.ts","sourceRoot":"","sources":["../../../src/record/__tests__/material-slot-plan.unit.test.ts"],"names":[],"mappings":""}

package/dist/record/__tests__/membership-timing.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=membership-timing.unit.test.d.ts.map

package/dist/record/__tests__/membership-timing.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"membership-timing.unit.test.d.ts","sourceRoot":"","sources":["../../../src/record/__tests__/membership-timing.unit.test.ts"],"names":[],"mappings":""}

package/dist/record/__tests__/render-submission.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=render-submission.integration.test.d.ts.map

package/dist/record/__tests__/render-submission.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-submission.integration.test.d.ts","sourceRoot":"","sources":["../../../src/record/__tests__/render-submission.integration.test.ts"],"names":[],"mappings":""}

package/dist/record/__tests__/render-submission.perf.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=render-submission.perf.test.d.ts.map

package/dist/record/__tests__/render-submission.perf.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-submission.perf.test.d.ts","sourceRoot":"","sources":["../../../src/record/__tests__/render-submission.perf.test.ts"],"names":[],"mappings":""}

package/dist/record/__tests__/shadow-submit-mode.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shadow-submit-mode.unit.test.d.ts.map

package/dist/record/__tests__/shadow-submit-mode.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-submit-mode.unit.test.d.ts","sourceRoot":"","sources":["../../../src/record/__tests__/shadow-submit-mode.unit.test.ts"],"names":[],"mappings":""}

package/dist/record/__tests__/video-texture-view.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=video-texture-view.unit.test.d.ts.map

package/dist/record/__tests__/video-texture-view.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-texture-view.unit.test.d.ts","sourceRoot":"","sources":["../../../src/record/__tests__/video-texture-view.unit.test.ts"],"names":[],"mappings":""}

package/dist/record/__tests__/view-ubo-layout.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=view-ubo-layout.unit.test.d.ts.map

package/dist/record/__tests__/view-ubo-layout.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-ubo-layout.unit.test.d.ts","sourceRoot":"","sources":["../../../src/record/__tests__/view-ubo-layout.unit.test.ts"],"names":[],"mappings":""}

package/dist/record/frame-lighting.d.ts

@@ -0,0 +1,187 @@
+import { type BindGroup, type BindGroupLayout, type TextureView } from '@forgeax/engine-rhi';
+import type { PipelineState, RenderSystemInternals } from '../render-system';
+import type { CameraSnapshot, DirectionalLightSnapshot, ExtractedLights, RenderableSnapshot, SkyboxSnapshot, SkylightSnapshot } from '../render-system-extract';
+import type { RecordProfileRunner } from './frame';
+import type { BindGroupCounts, RenderFrameState } from './frame-snapshot';
+export interface EnvironmentSunConsumerInput {
+    readonly generation: number;
+    readonly signature: string;
+    readonly direction: readonly [number, number, number];
+    readonly color: readonly [number, number, number];
+    readonly illuminance: number;
+    readonly atmosphere?: {
+        readonly turbidity: number;
+        readonly rayleigh: number;
+        readonly mieCoefficient: number;
+        readonly mieDirectionalG: number;
+        readonly sunAngularRadius: number;
+    } | undefined;
+    readonly source?: {
+        readonly worldId: number;
+        readonly entity: number;
+    } | undefined;
+}
+export interface EnvironmentSunConsumerSnapshot {
+    readonly generation: number;
+    readonly signature: string;
+    readonly source: {
+        readonly worldId: number;
+        readonly entity: number;
+    } | undefined;
+    readonly consumers: readonly {
+        readonly kind: 'ibl' | 'direct' | 'csm' | 'background' | 'sun-disc';
+        readonly generation: number;
+    }[];
+    readonly ibl: {
+        readonly includesSunDisc: false;
+        readonly sunContribution: 0;
+    };
+    readonly direct: {
+        readonly direction: readonly [number, number, number];
+        readonly color: readonly [number, number, number];
+        readonly illuminance: number;
+        readonly secondarySunContribution: 0;
+    };
+    readonly csm: {
+        readonly direction: readonly [number, number, number];
+    };
+    readonly background: {
+        readonly includesSunDisc: true;
+    };
+    readonly sunDisc: {
+        readonly direction: readonly [number, number, number];
+        readonly color: readonly [number, number, number];
+        readonly illuminance: number;
+    };
+    readonly atmosphere?: EnvironmentSunConsumerInput['atmosphere'];
+    readonly materials: {
+        readonly mirrorSunCount: 1;
+        readonly metalSunCount: 1;
+    };
+}
+export declare function createEnvironmentConsumerSnapshot(input: EnvironmentSunConsumerInput): EnvironmentSunConsumerSnapshot;
+export interface EnvironmentWorldConsumerInput {
+    readonly worldId: number;
+    readonly resourceOwner: boolean;
+    readonly directionalLightCount: number;
+    readonly atmosphere?: EnvironmentSunConsumerSnapshot | undefined;
+}
+export declare function consumeEnvironmentWorlds(worlds: readonly EnvironmentWorldConsumerInput[]): {
+    readonly atmosphereSunConsumptions: number;
+    readonly ordinaryDirectionalLightCount: number;
+};
+/**
+ * feat-20260704 M3/w18: per-frame bind-group cache resolution, extracted
+ * verbatim from `recordFrame`. Walks the handle-identity WeakMap caches
+ * (feat-20260531 M2 + feat-20260622 M3) to resolve or lazily create the view
+ * (@group 0), mesh (@group 2), and — when HDRP is active — HDRP-unified cluster
+ * bind groups. Returns all three (null when `hasValidated` is false, the Case E
+ * clear-pass-only path). No new mutable state: `bindGroupCounts` accounting +
+ * cache maps are threaded through explicitly.
+ *
+ * @internal
+ */
+export declare function buildPerFrameBindGroups(internals: RenderSystemInternals, frameState: RenderFrameState, pipelineState: PipelineState, hasValidated: boolean, bindGroupCounts: BindGroupCounts, graphTargets?: {
+    readonly directionalShadow?: TextureView | undefined;
+    readonly spotShadow?: TextureView | undefined;
+}, includeView?: boolean): {
+    viewBindGroup: BindGroup | null;
+    meshBindGroup: BindGroup | null;
+    hdrpClusterBindGroup: BindGroup | null;
+    hdrpClusterMembershipBindGroup: BindGroup | null;
+};
+/**
+ * feat-20260704 M3/w18: per-frame lighting preparation, extracted verbatim from
+ * `recordFrame`. (1) URP-only multi-light warn-once (directional / point / spot
+ * over `LIGHT_ARRAY_MAX_SLOTS`; HDRP gated off — 256 SSBO lights). (2) pin the
+ * point + spot shadow snapshot lists onto frameState for the URP shadow caster
+ * pass closures + lazy-allocate the point-shadow cube_array atlas on first
+ * non-empty frame (AC-09 zero-shadow zero-alloc). (3) destructure ExtractedLights
+ * into the directional-fallback `light` (zero-intensity Case C default), point /
+ * spot arrays, and totalLightCount.
+ *
+ * @internal
+ */
+export declare function prepareFrameLighting(internals: RenderSystemInternals, frameState: RenderFrameState, lights: ExtractedLights, environmentSun?: EnvironmentSunConsumerSnapshot | undefined): {
+    light: DirectionalLightSnapshot;
+    pointLights: ExtractedLights['point'];
+    spotLights: ExtractedLights['spot'];
+    totalLightCount: number;
+};
+/**
+ * feat-20260704 M3/w18: per-frame full rewrite of the PointLight + SpotLight
+ * std430 storage buffers, extracted verbatim from `recordFrame`.
+ *
+ * feat-20260519-light-casters-point-spot-pbr M3 / w20 (D-S1 + D-S2 + D-S6):
+ * header (16 B count u32 + 12 B pad) at offset 0 + first-slice cap N=4 slots
+ * packed sequentially. The N>4 fail-fast upstream ensures the counts are <= 4
+ * when the listener registry consumed the structured error; the slice keeps
+ * the buffer write bounded even if downstream listeners ignore the RhiError
+ * (charter P9 graceful degradation: surplus entities dropped, frame records).
+ *
+ * @internal
+ */
+export declare function writePointSpotLightBuffers(internals: RenderSystemInternals, pipelineState: PipelineState, lights: ExtractedLights): void;
+/**
+ * feat-20260704 M3/w18: write the point-shadow params UBO (bound at viewBg
+ * binding 6), extracted verbatim from `recordFrame`.
+ *
+ * feat-20260612-point-light-shadows-urp-hdrp Round-2 F-1: 4 lanes x vec4<f32>;
+ * lane[shadowAtlasLayer] = (near, far, 1/(far-near), 0). Lanes for non-shadow
+ * slots stay zero (the WGSL sample path is gated by PointLight.shadowAtlasLayer
+ * >= 0). Always writes the full 64 B so stale non-zero lanes from a previous
+ * frame's allocation cannot poison the current frame.
+ *
+ * @internal
+ */
+export declare function writeShadowParamsBuffer(internals: RenderSystemInternals, frameState: RenderFrameState, pipelineState: PipelineState): void;
+/**
+ * feat-20260704 M3/w18: zero-light standard-material once-warn, extracted
+ * verbatim from `recordFrame`.
+ *
+ * feat-20260520-skylight-ibl-cubemap M4 / t27 (AC-10): fires once per
+ * RenderSystem lifetime when the 0-light three-condition conjunction holds — no
+ * Skylight, 0 direct light (totalLightCount === 0), AND at least one builtin
+ * standard/PBR material (which renders black with no light). Custom shaders
+ * own their lighting contract and cannot be classified by this generic
+ * diagnostic. Suppressed under NODE_ENV=production.
+ *
+ * @internal
+ */
+export declare function warnZeroLightStandard(frameState: RenderFrameState, renderables: readonly RenderableSnapshot[], skylight: SkylightSnapshot | undefined, totalLightCount: number): void;
+/**
+ * feat-20260704 M3/w18: HDRP per-frame CPU cluster binning + light-data /
+ * cluster-grid / light-index-list / cluster-uniform / SSAO uniform buffer
+ * uploads. Extracted verbatim from `recordFrame`. Runs only when the HDRP
+ * pipeline is active and there is at least one punctual light; otherwise it is
+ * a no-op (URP / SSAO-off paths untouched).
+ *
+ * feat-20260608-cluster-lighting M5 / w21 + M6 / w23 + r2 fix-up: fail-soft
+ * semantics preserved verbatim — index-list-overflow and light-budget-exceeded
+ * fire once per frame (via `frameState.hdrpOncePerFrameFired`) and continue
+ * rendering.
+ *
+ * @internal
+ */
+export declare function writeHdrpClusterAndSsaoBuffers(internals: RenderSystemInternals, frameState: RenderFrameState, camera: CameraSnapshot, pointLights: ExtractedLights['point'], spotLights: ExtractedLights['spot'], profilePhase?: RecordProfileRunner, useGpuMembership?: boolean, membershipBindGroupLayout?: BindGroupLayout | null): void;
+/**
+ * feat-20260704 M3/w18: resolve `tonemapActive` + `skyboxActive` for this
+ * frame, extracted verbatim from `recordFrame`.
+ *
+ * feat-20260519-tonemap-reinhard-mvp: tonemap is active when the camera carries
+ * `tonemap !== 'none'` (routes geometry into the HDR offscreen target + a
+ * fullscreen tonemap pass). feat-20260531-skybox-env-background M2 / w9: skybox
+ * is active only when a SkyboxBackground entity is present AND tonemap is active
+ * (hdrColor is only allocated on the tonemap path). M3 / w20: once-warn when
+ * tonemap is 'none' but a skybox exists (config issue, not resource-timing —
+ * no structured error). M3 / w18: skybox degrades to clear-colour for a frame
+ * while its cubemap view is not yet resident (lazy equirect projection pending
+ * / failed; the lazy trigger owns the fire-once-on-failed error).
+ *
+ * @internal
+ */
+export declare function resolveSkyboxActive(internals: RenderSystemInternals, frameState: RenderFrameState, camera: CameraSnapshot, skybox: SkyboxSnapshot | undefined): {
+    tonemapActive: boolean;
+    skyboxActive: boolean;
+};
+//# sourceMappingURL=frame-lighting.d.ts.map

package/dist/record/frame-lighting.d.ts.map

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

package/dist/record/frame-observation.d.ts

@@ -0,0 +1,38 @@
+import { type CurrentFrameObservationLease, type ResolvedColorTargetDescriptor } from '@forgeax/engine-render-graph';
+import type { Texture } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-rhi';
+import { ObservationUnavailableError } from '../errors/render.js';
+export interface FrameObservationSource {
+    readonly texture: Texture;
+    readonly descriptor: ResolvedColorTargetDescriptor;
+    readonly frameId: number;
+    readonly pipelineId: 'forgeax::urp' | 'forgeax::hdrp';
+    readonly backendId: string;
+}
+export type FrameObservationReadback = (lease: CurrentFrameObservationLease) => Promise<Result<Uint8Array, Error>>;
+export interface FrameObservationOptions {
+    readonly semantic: 'linear-hdr';
+    readonly readback: FrameObservationReadback;
+}
+export interface FrameObservationMetadata {
+    readonly format: string;
+    readonly size: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly usage: number;
+    readonly sample: number;
+    readonly frameId: number;
+    readonly lifetime: {
+        readonly frameId: number;
+        readonly state: 'active' | 'retired';
+    };
+    readonly pipelineId: 'forgeax::urp' | 'forgeax::hdrp';
+    readonly backendId: string;
+}
+export interface FrameObservation {
+    readonly bytes: Uint8Array;
+    readonly metadata: FrameObservationMetadata;
+}
+export declare function observeCurrentFrame(options: FrameObservationOptions, source: FrameObservationSource | undefined, currentFrameId: number): Promise<Result<FrameObservation, ObservationUnavailableError>>;
+//# sourceMappingURL=frame-observation.d.ts.map

package/dist/record/frame-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-observation.d.ts","sourceRoot":"","sources":["../../src/record/frame-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,4BAA4B,EAEjC,KAAK,6BAA6B,EACnC,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,2BAA2B,EAE5B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,6BAA6B,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,eAAe,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,wBAAwB,GAAG,CACrC,KAAK,EAAE,4BAA4B,KAChC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;AAExC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;CAC7C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAA;KAAE,CAAC;IACtF,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,eAAe,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;CAC7C;AAiBD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,uBAAuB,EAChC,MAAM,EAAE,sBAAsB,GAAG,SAAS,EAC1C,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,2BAA2B,CAAC,CAAC,CAyDhE"}