@forgeax/engine-render 0.1.2

package/dist/record/skybox-post-pass.d.ts

@@ -0,0 +1,33 @@
+import type { ResolveContext } from '@forgeax/engine-render-graph';
+import type { RhiRenderPassEncoder } from '@forgeax/engine-rhi';
+import type { _InternalRenderPipelineContext } from '../render-pipeline-context';
+/**
+ * feat-20260531-skybox-env-background M2 / w8: skybox pass recording stub.
+ * Renders a fullscreen triangle that samples a cubemap using the camera's
+ * inverseViewProj from the View UBO and writes the result to the hdrColor
+ * render target. The pass runs after shadow and before main (D-1 topology).
+ *
+ * This stub early-returns when skyboxActive is false -- the actual execute
+ * body is implemented in M3 / w16 (recordSkyboxPass execute). The render-
+ * graph still declares the pass so the compile() step validates the
+ * dependency edges (shadow -> skybox -> main) even before the execute
+ * body is filled in.
+ */
+export declare function recordSkyboxPass(c: _InternalRenderPipelineContext, graphPass?: RhiRenderPassEncoder): void;
+export declare function encodeSkyboxPass(c: _InternalRenderPipelineContext, pass: RhiRenderPassEncoder): void;
+/**
+ * feat-20260529-rendergraph-pass-abstraction M4 / w13c: FXAA post-process
+ * fullscreen pass, extracted verbatim from recordFrame. copyTextureToTexture
+ * (swap-chain -> intermediate) then a fullscreen FXAA fragment pass writes
+ * the anti-aliased result back into the swap-chain view, all on the SHARED
+ * frame encoder (c.encoder). The pre-pass copy stays inside this closure
+ * (graph first version models copy as a pass-internal op, not a separate
+ * graph node). Gated on camera.antialias==='fxaa'. Driven by the 'fxaa'
+ * graph pass.
+ */
+export declare function recordBloomBrightPass(_c: _InternalRenderPipelineContext, resolve?: ResolveContext, graphPass?: RhiRenderPassEncoder): void;
+export declare function recordBloomBlurHPass(_c: _InternalRenderPipelineContext, resolve?: ResolveContext, graphPass?: RhiRenderPassEncoder): void;
+export declare function recordBloomBlurVPass(_c: _InternalRenderPipelineContext, resolve?: ResolveContext, graphPass?: RhiRenderPassEncoder): void;
+export declare function recordBloomCompositePass(_c: _InternalRenderPipelineContext, resolve?: ResolveContext, graphPass?: RhiRenderPassEncoder): void;
+export declare function recordFxaaPass(c: _InternalRenderPipelineContext, resolve: ResolveContext, graphPass?: RhiRenderPassEncoder): void;
+//# sourceMappingURL=skybox-post-pass.d.ts.map

package/dist/record/skybox-post-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skybox-post-pass.d.ts","sourceRoot":"","sources":["../../src/record/skybox-post-pass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAe,MAAM,qBAAqB,CAAC;AAE7E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAGjF;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,8BAA8B,EACjC,SAAS,CAAC,EAAE,oBAAoB,GAC/B,IAAI,CAoIN;AAED,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,8BAA8B,EACjC,IAAI,EAAE,oBAAoB,GACzB,IAAI,CAEN;AAED;;;;;;;;;GASG;AASH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,8BAA8B,EAClC,OAAO,CAAC,EAAE,cAAc,EACxB,SAAS,CAAC,EAAE,oBAAoB,GAC/B,IAAI,CAsEN;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,8BAA8B,EAClC,OAAO,CAAC,EAAE,cAAc,EACxB,SAAS,CAAC,EAAE,oBAAoB,GAC/B,IAAI,CA+EN;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,8BAA8B,EAClC,OAAO,CAAC,EAAE,cAAc,EACxB,SAAS,CAAC,EAAE,oBAAoB,GAC/B,IAAI,CA+EN;AAED,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,8BAA8B,EAClC,OAAO,CAAC,EAAE,cAAc,EACxB,SAAS,CAAC,EAAE,oBAAoB,GAC/B,IAAI,CAgFN;AAED,wBAAgB,cAAc,CAC5B,CAAC,EAAE,8BAA8B,EACjC,OAAO,EAAE,cAAc,EACvB,SAAS,CAAC,EAAE,oBAAoB,GAC/B,IAAI,CA6EN"}

package/dist/record/typed-frame-graph.d.ts

@@ -0,0 +1,13 @@
+import { type CompiledRenderGraph } from '@forgeax/engine-render-graph';
+import type { RhiCommandEncoder } from '@forgeax/engine-rhi';
+import { type EnvironmentTransactionAttempt } from '../environment/graph';
+import type { PreparedGpuDrivenFrame } from '../gpu-driven/production-raster';
+import type { RenderPipelineFrame } from '../render-pipeline';
+import type { PipelineState, RenderSystemInternals } from '../render-system';
+import type { CameraSnapshot, ExtractedLights } from '../render-system-extract';
+import type { TemporalFrameAttempt, TemporalFrameTransaction } from '../temporal-frame-transaction';
+import type { RenderFrameState } from './frame-snapshot';
+export declare function ensureCompiledFrameGraph(internals: RenderSystemInternals, frameState: RenderFrameState, pipelineState: PipelineState, camera: CameraSnapshot, lights: ExtractedLights, width: number, height: number, shadowMapSize: number | undefined, gpuDriven?: PreparedGpuDrivenFrame, temporalTransaction?: TemporalFrameTransaction): CompiledRenderGraph<RenderPipelineFrame> | null;
+export declare function retireCompiledFrameGraph(frameState: RenderFrameState, historyStore?: TemporalFrameTransaction['historyStore']): void;
+export declare function executeCompiledFrameGraph(internals: RenderSystemInternals, frameState: RenderFrameState, frame: RenderPipelineFrame, encoder: RhiCommandEncoder, runPass?: import('@forgeax/engine-render-graph').RenderGraphPassRunner, temporalFrame?: TemporalFrameAttempt, environmentAttempt?: EnvironmentTransactionAttempt): boolean;
+//# sourceMappingURL=typed-frame-graph.d.ts.map

package/dist/record/typed-frame-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-frame-graph.d.ts","sourceRoot":"","sources":["../../src/record/typed-frame-graph.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EAGzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAKV,iBAAiB,EAGlB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,KAAK,6BAA6B,EAEnC,MAAM,sBAAsB,CAAC;AAO9B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EAEV,mBAAmB,EAEpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhF,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGpG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA6LzD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,qBAAqB,EAChC,UAAU,EAAE,gBAAgB,EAC5B,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,SAAS,CAAC,EAAE,sBAAsB,EAClC,mBAAmB,CAAC,EAAE,wBAAwB,GAC7C,mBAAmB,CAAC,mBAAmB,CAAC,GAAG,IAAI,CA2KjD;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,gBAAgB,EAC5B,YAAY,CAAC,EAAE,wBAAwB,CAAC,cAAc,CAAC,GACtD,IAAI,CAMN;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,qBAAqB,EAChC,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,OAAO,8BAA8B,EAAE,qBAAqB,EACtE,aAAa,CAAC,EAAE,oBAAoB,EACpC,kBAAkB,CAAC,EAAE,6BAA6B,GACjD,OAAO,CAiET"}

package/dist/record/view-ubo.d.ts

@@ -0,0 +1,39 @@
+import type { Buffer, RhiQueue } from '@forgeax/engine-rhi';
+import type { CameraSnapshot, DirectionalLightSnapshot, ExtractedLights, FogSnapshot, SpotLightSnapshot } from '../render-system-extract';
+import type { TemporalView } from '../temporal-view';
+export declare const VIEW_UNIFORM_BYTES = 960;
+export declare const VIEW_UNIFORM_SLOT_STRIDE = 1024;
+export declare const POINT_SHADOW_VIEW_SLOT_COUNT = 24;
+export declare const VIEW_UNIFORM_BUFFER_SIZE: number;
+export declare function pointShadowViewOffset(layer: number, face: number): number;
+/**
+ * feat-20260704 M3/w18: assemble + upload the per-frame View UBO payload.
+ *
+ * feat-20260518 M3 / w14 (AC-07 / AC-09): builds the full view UBO payload.
+ * Single queue.writeBuffer covers the whole payload (one round-trip per frame,
+ * charter P5 consistent abstraction). Outgoing-direction convention
+ * (DirectionalLight @semantics outgoing): the host uploads light.direction
+ * verbatim; the shader negates it internally via
+ * `let l = normalize(-view.lightDir)` to get the L vector for BRDF (single
+ * SSOT, no double-negation).
+ *
+ * feat-20260520-directional-light-shadow-mapping M1b / w7 + feat-20260613-csm
+ * M4 / w16+w25: viewPayload is 240 floats. Layout matches common.wgsl View
+ * struct byte-for-byte:
+ *   [ 0..15] worldViewProj, [16..18] lightDir, [20..22] lightColor,
+ *   [24..26] cameraPos, [28..43] lightViewProj0 (was lightSpaceMatrix),
+ *   [44..59] inverseViewProj, [60..75] lightViewProj1,
+ *   [76..91] lightViewProj2, [92..107] lightViewProj3,
+ *   [108]/[112]/[116]/[120] splitPlanes (vec4 stride),
+ *   [124] cascadeCount, [125] cascadeBlend,
+ *   [126] depthBias, [127] normalBias, [128] pcfKernelSize (feat-20260621
+ *   M3 / m3-t2-t3), [129..131] align pad,
+ *   [132..195] spotLightViewProj array<mat4x4<f32>, 4> (feat-20260625 w25:
+ *   folded from standalone binding 9 to fix WebGL2 fragment uniform-buffer
+ *   overflow; lane N = spot with shadowAtlasTile === N, 16 f32 / lane,
+ *   16 B-aligned at byte 528 = float 132).
+ *
+ * @internal
+ */
+export declare function writeViewUbo(queue: RhiQueue, viewUniformBuffer: Buffer, camera: CameraSnapshot, light: DirectionalLightSnapshot, lights: ExtractedLights, spotShadowSnapshots: readonly SpotLightSnapshot[], temporalView?: TemporalView, fog?: FogSnapshot): void;
+//# sourceMappingURL=view-ubo.d.ts.map

package/dist/record/view-ubo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-ubo.d.ts","sourceRoot":"","sources":["../../src/record/view-ubo.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,WAAW,EACX,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIrD,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,wBAAwB,QAC0B,CAAC;AAEhE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,EACf,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,wBAAwB,EAC/B,MAAM,EAAE,eAAe,EACvB,mBAAmB,EAAE,SAAS,iBAAiB,EAAE,EACjD,YAAY,CAAC,EAAE,YAAY,EAC3B,GAAG,CAAC,EAAE,WAAW,GAChB,IAAI,CAwIN"}

package/dist/render-data.d.ts

@@ -0,0 +1,143 @@
+import { type VertexLayoutProjection } from '@forgeax/engine-geometry';
+import { type Result } from '@forgeax/engine-rhi';
+import { type AssetError, type MeshAsset, type Submesh, type TextureAsset } from '@forgeax/engine-types';
+/** Descriptor for a mesh's GPU vertex + index buffers (projected from POD). */
+export interface MeshRenderData {
+    readonly vertexByteLength: number;
+    /** Geometry-owned immutable layout facts used by all GPU consumers. */
+    readonly layoutProjection: VertexLayoutProjection;
+    /** Index byte length padded up to a 4-byte multiple (writeBuffer alignment). */
+    readonly indexByteLength: number;
+    readonly indexCount: number;
+    readonly indexFormat: 'uint16' | 'uint32';
+    readonly vertexUsage: number;
+    readonly indexUsage: number;
+    /**
+     * Submeshes from the source MeshAsset, projected verbatim to the GPU store
+     * so the record stage can iterate per-submesh draw calls (feat-20260608 M4 / w16).
+     * Mirrors MeshAsset.submeshes (readonly Submesh[]) 1:1.
+     */
+    readonly submeshes: readonly Submesh[];
+}
+/** Descriptor for a 2D texture's GPU resource (projected from POD). */
+export interface TextureRenderData {
+    /** Logical width retained for existing projection consumers. */
+    readonly width: number;
+    /** Logical height retained for existing projection consumers. */
+    readonly height: number;
+    /** Authored content extent; TextureAsset remains the logical asset SSOT. */
+    readonly logicalExtent: TextureExtent;
+    /** GPU allocation extent, derived from format + logicalExtent. */
+    readonly physicalExtent: TextureExtent;
+    /** Maps logical UVs away from block padding. */
+    readonly uvScale: readonly [number, number];
+    readonly format: GPUTextureFormat;
+    readonly mipLevelCount: number;
+    readonly usage: number;
+    /**
+     * Row pitch for the BASE mip (level 0) the store passes to `writeTexture`.
+     * Uncompressed: `width * 4` (RGBA8). Block-compressed: the block-padded
+     * `ceil(width / blockW) * bytesPerBlock` (feat-20260707 M5 / w35, AC-08).
+     * The per-mip layout for a multi-level compressed upload comes from
+     * {@link deriveMipUploadLayout}.
+     */
+    readonly bytesPerRow: number;
+    /** True iff `format` is a block-compressed format (drives the store's upload arm). */
+    readonly compressed: boolean;
+}
+export interface TextureExtent {
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * The sole logical-content to physical-storage projection for a texture.
+ * Block sizes come from codec's format table; no physical dimensions are
+ * authored or serialized with TextureAsset.
+ */
+export declare function deriveTextureExtent(format: GPUTextureFormat, width: number, height: number): {
+    readonly logicalExtent: TextureExtent;
+    readonly physicalExtent: TextureExtent;
+    readonly uvScale: readonly [number, number];
+};
+/** One mip level's GPU-upload layout (feat-20260707 M5 / w35, AC-08). */
+export interface MipUploadLevel {
+    /** Mip level index (0 = base / largest). */
+    readonly level: number;
+    /** Logical pixel width of this level (`baseWidth >> level`, min 1). */
+    readonly width: number;
+    /** Logical pixel height of this level (`baseHeight >> level`, min 1). */
+    readonly height: number;
+    /** Block-aligned storage dimensions for this logical mip. */
+    readonly physicalWidth: number;
+    readonly physicalHeight: number;
+    /** Logical `writeTexture` copy width; full-subresource copies may end mid-block. */
+    readonly copyWidth: number;
+    /** Logical `writeTexture` copy height; full-subresource copies may end mid-block. */
+    readonly copyHeight: number;
+    /** Bytes per compressed row: `ceil(width / blockW) * bytesPerBlock`. */
+    readonly bytesPerRow: number;
+    /** Block rows: `ceil(height / blockH)` (the writeTexture `rowsPerImage`). */
+    readonly rowsPerImage: number;
+    /** Byte offset of this level in the mip-major payload (sum of prior levels). */
+    readonly byteOffset: number;
+    /** Byte length of this level (`bytesPerRow * rowsPerImage`). */
+    readonly byteLength: number;
+}
+/**
+ * Derive the per-mip GPU-upload layout for a block-compressed texture
+ * (feat-20260707 M5 / w35, AC-08). Each level pads the pixel width up to a full
+ * block (`ceil(width / blockW) * bytesPerBlock`) and counts block rows
+ * (`ceil(height / blockH)`); `byteOffset` accumulates the prior levels' byte
+ * lengths (mip-major layout). The GPU samples only the valid texel region, so a
+ * non-4-multiple size or a 1x1 / 2x2 mip tail pads up to a block without image
+ * corruption (t5). Block math is sourced from the codec block table (SSOT --
+ * Derive, Don't Duplicate); TextureAsset carries no block fields (F-6).
+ *
+ * `format` must be a block-compressed format; callers branch on the projection's
+ * `compressed` flag first (the uncompressed path uses the linear `width * 4`
+ * pitch). Level dimensions floor-halve per mip, clamped to a 1-pixel minimum.
+ */
+export declare function deriveMipUploadLayout(format: GPUTextureFormat, baseWidth: number, baseHeight: number, mipLevelCount: number): readonly MipUploadLevel[];
+/** Descriptor for a cubemap built from an equirect source (projected from POD). */
+export interface CubeRenderData {
+    /** Square cube face edge length (== source equirect height). */
+    readonly cubeFaceSize: number;
+    /** Filterable output format the IBL pipeline BGL expects. */
+    readonly outputFormat: 'rgba16float';
+    /** True when the source is rgba32float and the store must pack to rgba16float. */
+    readonly needsHalfConversion: boolean;
+    readonly cubeUsage: number;
+}
+/**
+ * Project a `MeshAsset` POD into its GPU vertex / index buffer descriptor.
+ * Pure: computes byte lengths, the 4-byte-aligned index size, index format,
+ * and the buffer usage flags the store's `createBuffer` calls need.
+ */
+export declare function deriveRenderDataMesh(mesh: MeshAsset): Result<MeshRenderData, AssetError>;
+/**
+ * Project a `TextureAsset` POD into its GPU texture descriptor. Pure: derives
+ * the mip-level count (when `mipmap`), the row pitch, and the usage flags, and
+ * fails fast if the POD's `format` and `colorSpace` are internally
+ * inconsistent (a `-srgb` format requires an `srgb` colorSpace and vice versa).
+ */
+export declare function deriveRenderDataTexture(tex: TextureAsset): Result<TextureRenderData, AssetError>;
+/**
+ * Project an equirectangular HDR `TextureAsset` source into its cubemap
+ * descriptor. Pure: validates the source is a linear HDR format, computes the
+ * square cube face size (== source height), narrows the output to the filterable
+ * `rgba16float` the IBL pipeline expects, and flags whether the store must pack
+ * an rgba32float source down to rgba16float. The store keeps the resource build
+ * (createTexture / cube + face views / IBL precompute) and the rgba32f->rgba16f
+ * byte conversion.
+ *
+ * feat-20260707 M5 fix: the accepted-format whitelist is `rgba16float |
+ * rgba32float` only -- a block-compressed HDR format (`bc6h-rgb-ufloat`) is NOT
+ * accepted here. An equirect cube source drives equirect-to-cube / irradiance /
+ * prefilter RENDER passes, and a BC6H texture is sample-only, never a color-
+ * renderable render target ("BC6HRGBUfloat is not color renderable"). The
+ * equirect is therefore always delivered uncompressed rgba16float; this
+ * fail-fast whitelist is the projection-layer guard that rejects a non-
+ * renderable cube source rather than letting it blow up at GPU createTexture.
+ */
+export declare function deriveRenderDataCubemap(source: TextureAsset): Result<CubeRenderData, AssetError>;
+//# sourceMappingURL=render-data.d.ts.map

package/dist/render-data.d.ts.map

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

package/dist/render-dispatch-membership.d.ts

@@ -0,0 +1,47 @@
+import { type DirectionalCsmCasterCandidate } from './extract/directional-csm';
+import type { DispatchEntry, RenderableSnapshot } from './render-system-extract';
+/**
+ * Immutable candidate-domain membership derived from one dispatch snapshot.
+ *
+ * The dispatch array is the identity of the snapshot. Consumers may retain
+ * this owner across camera-only culls, but must publish a new owner whenever
+ * the candidate dispatch array changes. Keeping the Set here prevents the
+ * extract and persistent-scene paths from each rebuilding or rescanning the
+ * same dispatch domain.
+ */
+export interface RenderDispatchMembership {
+    readonly dispatch: readonly DispatchEntry[];
+    readonly shadowCasterCandidateIndices: ReadonlySet<number>;
+}
+/**
+ * Immutable owner for the complete pre-main-cull candidate domain.
+ *
+ * The candidate array and its dispatch are a pair: the former gives the
+ * stable renderable index and the latter gives pass ownership. Keeping the
+ * identity index beside the dispatch membership means persistent CSM
+ * broadphase joins do not rebuild a string map for every camera/cascade
+ * refresh, and every consumer uses the same candidate-domain identity.
+ */
+export interface RenderCandidateDomain {
+    readonly renderables: readonly RenderableSnapshot[];
+    readonly dispatch: readonly DispatchEntry[];
+    readonly membership: RenderDispatchMembership;
+    readonly indexByIdentity: ReadonlyMap<string, number>;
+}
+export declare function buildRenderDispatchMembership(dispatch: readonly DispatchEntry[]): RenderDispatchMembership;
+/** Reuse an extracted owner only when it still belongs to this dispatch. */
+export declare function reuseRenderDispatchMembership(dispatch: readonly DispatchEntry[], existing: RenderDispatchMembership | undefined): RenderDispatchMembership;
+export declare function buildRenderCandidateDomain(renderables: readonly RenderableSnapshot[], dispatch: readonly DispatchEntry[], indexByIdentity?: ReadonlyMap<string, number>): RenderCandidateDomain;
+/** Build the candidate identity join once for a new immutable candidate array. */
+export declare function buildRenderCandidateIdentityIndex(renderables: readonly RenderableSnapshot[]): ReadonlyMap<string, number>;
+export declare function reuseRenderCandidateDomain(renderables: readonly RenderableSnapshot[], dispatch: readonly DispatchEntry[], existing: RenderCandidateDomain | undefined): RenderCandidateDomain;
+/**
+ * Lazily derive the CSM caster view once for a candidate-domain owner.
+ *
+ * CSM fitting is camera-dependent, but the candidate-to-caster projection is
+ * not. Keeping this derived array beside the dispatch membership prevents
+ * persistent camera refreshes from rebuilding transformed caster bounds for
+ * every cascade while preserving the candidate-domain identity contract.
+ */
+export declare function renderCandidateCsmCandidates(domain: RenderCandidateDomain): readonly DirectionalCsmCasterCandidate[];
+//# sourceMappingURL=render-dispatch-membership.d.ts.map

package/dist/render-dispatch-membership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-dispatch-membership.d.ts","sourceRoot":"","sources":["../src/render-dispatch-membership.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAMjF;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,4BAA4B,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5D;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvD;AAYD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,SAAS,aAAa,EAAE,GACjC,wBAAwB,CAgB1B;AAED,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,QAAQ,EAAE,wBAAwB,GAAG,SAAS,GAC7C,wBAAwB,CAE1B;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,SAAS,kBAAkB,EAAE,EAC1C,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5C,qBAAqB,CAkBvB;AAED,kFAAkF;AAClF,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAO7B;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,SAAS,kBAAkB,EAAE,EAC1C,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,QAAQ,EAAE,qBAAqB,GAAG,SAAS,GAC1C,qBAAqB,CAIvB;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,qBAAqB,GAC5B,SAAS,6BAA6B,EAAE,CAmB1C"}