@forgeax/engine-render 0.0.0-dev.8d955ade1c79

package/dist/record/render-context.d.ts

@@ -0,0 +1,252 @@
+import type { AssetRegistry, DynamicTextureStore } from '@forgeax/engine-assets-runtime';
+import type { World } from '@forgeax/engine-ecs';
+import type { VertexLayoutProjection } from '@forgeax/engine-geometry';
+import type { Profiler } from '@forgeax/engine-profiler';
+import type { BindGroup, BindGroupLayout, Buffer, ComputePipeline, PipelineLayout, Result, RhiCanvasContext, RhiDevice, RhiError, RenderPipeline as RhiRenderPipeline, Sampler, Texture, TextureFormat, TextureView } from '@forgeax/engine-rhi';
+import type { MaterialRuntimeArtifact } from '@forgeax/engine-shader';
+import type { MaterialRenderState, ParamSchemaEntry, PassKind, PrimitiveTopology, VertexAttributeMap } from '@forgeax/engine-types';
+import type { MaterialRenderProjection } from '../assembly/material/assembly';
+import type { DeviceScope } from '../device/device-scope';
+import type { MeshGpuHandles } from '../device/gpu-residency';
+import type { EngineMetrics } from '../engine-metrics';
+import type { RenderFeatureHost } from '../features/host';
+import type { SkylightFallback } from '../ibl/skylight-bind-group';
+import type { HealthListenerRegistry, RhiErrorListenerRegistry } from '../lifecycle';
+import type { StandardProfile } from '../pipeline/standard-profile';
+import type { PipelineBuilderShaderModuleFactory } from '../pipeline-builder';
+import type { PointsLinesInspection } from '../points-lines/inspection';
+import type { PointsLinesRecordPlan } from '../points-lines/record';
+export interface PointsLinesRecordSubmission {
+    readonly plan: PointsLinesRecordPlan;
+    readonly vertexBuffer: Buffer;
+    readonly indexBuffer: Buffer;
+    readonly layoutProjection: VertexLayoutProjection;
+}
+import type { RenderDebugOverlay, RenderPipelineContext, RenderRecordPhase } from '../render-contract';
+import type { DispatchEntry, MaterialSnapshot, SkyboxSnapshot, SkylightSnapshot } from '../render-system-extract';
+import type { SkinPaletteAllocator } from '../systems/skin-palette-allocator';
+import type { BindGroupCounts, DispatchCounts, MaterialBgAssemblyCacheEntry, RenderFrameState, ValidatedRenderable } from './frame-snapshot';
+import type { FoldDispatchPlan } from './mesh-ssbo';
+export interface RenderSystemRuntime {
+    readonly device: RhiDevice;
+    readonly deviceScope: DeviceScope;
+    readonly errorRegistry: RhiErrorListenerRegistry;
+    readonly debugOverlay?: RenderDebugOverlay | undefined;
+    readonly healthRegistry: HealthListenerRegistry;
+    readonly getMaterialProjection?: (materialGuid: string) => MaterialRenderProjection | undefined;
+    readonly getMaterialArtifact?: (specializationKey: string) => MaterialRuntimeArtifact | undefined;
+    readonly getMaterialShaderPipeline?: (materialShaderId: string, isHdr: boolean, renderState?: MaterialRenderState, topology?: PrimitiveTopology, indexFormat?: 'uint16' | 'uint32', variantSet?: string, passKind?: PassKind, meshAttributes?: VertexAttributeMap, sampleCount?: number, colorFormatOverride?: GPUTextureFormat, shaderUvSetCount?: number, depthFormatOverride?: GPUTextureFormat | null, vertexLayout?: string, vertexLayoutProjection?: VertexLayoutProjection) => RhiRenderPipeline | null;
+    readonly getMaterialShaderBindingContract?: (materialShaderId: string) => 'group-0' | 'group-0-resource' | 'view-only' | 'view-and-scene-depth' | 'render-material';
+    readonly getParamSchema?: (materialShaderId: string) => readonly ParamSchemaEntry[] | undefined;
+    readonly getMaterialBindGroupLayout?: (materialShaderId: string) => BindGroupLayout | undefined;
+    readonly metrics: EngineMetrics;
+    readonly lookupPostProcess?: (id: string) => import('../fullscreen-post-process-pass').PostProcessShaderEntry | undefined;
+    readonly getPostProcessParamsBuffer?: (id: string) => Buffer | undefined;
+    readonly getPostProcessPipeline?: (id: string, bgl: BindGroupLayout, colorFormat: GPUTextureFormat) => RhiRenderPipeline | null;
+    readonly dynamicTextureStore?: DynamicTextureStore | undefined;
+}
+/** Renderer-owned bridge from retained Points/Lines facts into main geometry. */
+export interface PointsLinesRecordOwner {
+    prepare(entry: ValidatedRenderable, clustered: boolean): PointsLinesRecordSubmission | undefined;
+    beginFrame(): void;
+    resetForDeviceLoss(): void;
+    inspections(): readonly PointsLinesInspection[];
+}
+export interface PerPassResources {
+    depthTexture: Texture | null;
+    depthTextureView: TextureView | null;
+    depthTextureWidth: number;
+    depthTextureHeight: number;
+    configured: boolean;
+    hdrColorTexture: Texture | null;
+    hdrColorView: TextureView | null;
+    hdrDepthTexture: Texture | null;
+    hdrDepthView: TextureView | null;
+    hdrTextureWidth: number;
+    hdrTextureHeight: number;
+    hdrDepthSampleCount: number;
+    readonly fxaaPipeline: RhiRenderPipeline | null;
+    readonly fxaaBindGroupLayout: BindGroupLayout | null;
+    readonly fxaaSampler: Sampler | null;
+    msaaColorTexture: Texture | null;
+    msaaColorView: TextureView | null;
+    msaaSpriteColorTexture: Texture | null;
+    msaaSpriteColorView: TextureView | null;
+    msaaDepthTexture: Texture | null;
+    msaaDepthView: TextureView | null;
+    msaaTextureWidth: number;
+    msaaTextureHeight: number;
+    hdrColorMsaaTexture: Texture | null;
+    hdrColorMsaaView: TextureView | null;
+    readonly skyboxPipeline: RhiRenderPipeline | null;
+    readonly skyboxPipelineMsaa: RhiRenderPipeline | null;
+    readonly skyboxBindGroupLayout: BindGroupLayout | null;
+    readonly skyboxSampler: Sampler | null;
+    readonly skyboxRotationBuffer: Buffer | null;
+    readonly bloomBrightPipeline: RhiRenderPipeline | null;
+    readonly bloomBlurHPipeline: RhiRenderPipeline | null;
+    readonly bloomBlurVPipeline: RhiRenderPipeline | null;
+    readonly bloomCompositePipeline: RhiRenderPipeline | null;
+    readonly bloomBrightBindGroupLayout: BindGroupLayout | null;
+    readonly bloomBlurBindGroupLayout: BindGroupLayout | null;
+    readonly bloomCompositeBindGroupLayout: BindGroupLayout | null;
+    readonly bloomSampler: Sampler | null;
+    readonly bloomBrightParamsBuffer: Buffer | null;
+    readonly bloomBlurHParamsBuffer: Buffer | null;
+    readonly bloomBlurVParamsBuffer: Buffer | null;
+    readonly bloomCompositeParamsBuffer: Buffer | null;
+    bloomBrightTexture: Texture | null;
+    bloomBrightView: TextureView | null;
+    bloomBrightWidth: number;
+    bloomBrightHeight: number;
+    bloomBlurHTexture: Texture | null;
+    bloomBlurHView: TextureView | null;
+    bloomBlurHWidth: number;
+    bloomBlurHHeight: number;
+    bloomBlurVTexture: Texture | null;
+    bloomBlurVView: TextureView | null;
+    bloomBlurVWidth: number;
+    bloomBlurVHeight: number;
+    ssaoCalcPipeline: RhiRenderPipeline | null;
+    ssaoBlurPipeline: RhiRenderPipeline | null;
+    ssaoBgl: BindGroupLayout | null;
+    ssaoFilteringSampler: Sampler | null;
+    ssaoDepthSampler: Sampler | null;
+    ssaoFallbackRawView: TextureView | null;
+    shadowTexture: Texture | null;
+    shadowMapSize: number;
+    shadowCascadeCount: number;
+    shadowSampler: Sampler | null;
+    shadowLightSpaceMatrix: Float32Array | null;
+    shadowCsmLightViewProj: Float32Array | null;
+    shadowCsmSelection: {
+        readonly viewMatrix: Float32Array;
+        readonly splitPlanes: Float32Array;
+    } | null;
+}
+export interface PipelineState {
+    readonly meshes: ReadonlyMap<number, MeshGpuHandles>;
+    readonly format: TextureFormat;
+    readonly colorAttachmentFormat: TextureFormat;
+    readonly viewBindGroupLayout: BindGroupLayout;
+    readonly materialBindGroupLayout: BindGroupLayout;
+    readonly meshBindGroupLayout: BindGroupLayout;
+    readonly viewUniformBuffer: Buffer;
+    readonly pointsLinesViewBuffer?: Buffer;
+    readonly shadowCasterCascadeBuffer: Buffer;
+    readonly materialUniformBuffer: {
+        readonly buffer: Buffer;
+        readonly sizeInBytes: number;
+    };
+    readonly meshStorageBuffer: {
+        readonly buffer: Buffer;
+        readonly sizeInBytes: number;
+    };
+    readonly pointLightsBuffer: Buffer;
+    readonly spotLightsBuffer: Buffer;
+    readonly instancesBindGroupLayout: BindGroupLayout;
+    readonly identityInstanceBuffer: Buffer;
+    readonly defaultSampler: Sampler;
+    readonly nearestSampler: Sampler;
+    readonly fallbackTextureView: TextureView;
+    readonly unlitPipeline: RhiRenderPipeline | null;
+    readonly standardPipeline: RhiRenderPipeline | null;
+    readonly unlitPipelineMsaa: RhiRenderPipeline | null;
+    readonly unlitPipelineHdrMsaa: RhiRenderPipeline | null;
+    readonly pbrPipelineLayout: PipelineLayout | null;
+    readonly hdrpPbrPipelineLayout: PipelineLayout | null;
+    readonly hdrpClusterMembershipPipeline: ComputePipeline | null;
+    readonly hdrpClusterMembershipBindGroupLayout: BindGroupLayout | null;
+    readonly pbrSkinPipelineLayout: PipelineLayout | null;
+    readonly pbrSkinMeshBindGroupLayout: BindGroupLayout | null;
+    readonly skinPaletteAllocator: SkinPaletteAllocator | null;
+    readonly defaultWhiteTextureView: TextureView;
+    readonly defaultNormalTextureView: TextureView;
+    readonly unlitPipelineHdr: RhiRenderPipeline | null;
+    readonly shadowFallbackTextureView: TextureView;
+    readonly shadowAtlasFallbackTextureView: TextureView;
+    readonly shadowParamsBuffer: Buffer;
+    readonly skylightFallback: SkylightFallback | null;
+    readonly perPassResources: PerPassResources;
+}
+export interface RenderSystemInternals extends RenderSystemRuntime {
+    readonly canvas: HTMLCanvasElement | OffscreenCanvas;
+    readonly standardProfile?: StandardProfile | undefined;
+    readonly standardPipeline: RenderFrameState['activePipeline'];
+    readonly featureHost?: RenderFeatureHost | undefined;
+    readonly shaderModuleFactory?: PipelineBuilderShaderModuleFactory;
+    readonly profiler?: Profiler | undefined;
+    readonly context: RhiCanvasContext | null;
+    readonly getPipelineState: () => PipelineState | null;
+    readonly assets: AssetRegistry;
+    readonly gpuStore: import('../device/gpu-residency').GpuResidencyCache;
+    readonly growMeshSsbo?: ((neededSlots: number) => {
+        readonly ok: true;
+    } | {
+        readonly ok: false;
+        readonly code: 'mesh-ssbo-ceiling-reached' | 'mesh-ssbo-capacity-exceeded';
+        readonly degradedToSlotCount: number;
+    }) | undefined;
+    readonly meshSsboState?: {
+        readonly slotCount: number;
+    } | undefined;
+    readonly buildPostProcessPipeline?: ((entry: import('../fullscreen-post-process-pass').PostProcessShaderEntry, bgl: BindGroupLayout, colorFormat: GPUTextureFormat, label: string) => RhiRenderPipeline | null) | undefined;
+}
+export interface _StandardForwardSceneView {
+    readonly assets: AssetRegistry;
+    readonly store: import('../device/gpu-residency').GpuResidencyCache;
+    readonly pipelineState: PipelineState;
+    readonly runtime: RenderSystemRuntime;
+    readonly validated: readonly ValidatedRenderable[];
+    readonly validatedOrdered: readonly ValidatedRenderable[];
+    readonly viewBindGroup: BindGroup | null;
+    readonly meshBindGroup: BindGroup | null;
+    readonly frameState: RenderFrameState;
+    readonly dispatchCounts: DispatchCounts;
+    readonly bindGroupCounts: BindGroupCounts;
+    readonly skylight: SkylightSnapshot | undefined;
+    readonly skylightCount: number;
+    readonly skybox: SkyboxSnapshot | undefined;
+    readonly profilePhase?: <T>(phase: RenderRecordPhase, action: () => T) => T;
+    readonly directionalShadowCacheReuse: boolean;
+    readonly world: World;
+    readonly gpuDrivenEntityKeys: ReadonlySet<number>;
+    readonly tonemapActive: boolean;
+    readonly geometryColorView: TextureView | null;
+    readonly geometryDepthView: TextureView | null;
+    readonly geometryDepthKey: string | null;
+    readonly skyboxActive: boolean;
+    readonly splitLdrSprite: boolean;
+    readonly ldrSpritePassView: TextureView | null;
+    readonly transparentColorFormat?: GPUTextureFormat;
+    readonly dispatch: readonly DispatchEntry[];
+    readonly hdrpClusterBindGroup: BindGroup | null;
+    readonly hdrpClusterMembershipBindGroup: BindGroup | null;
+    readonly foldDispatchPlan: FoldDispatchPlan | null;
+    readonly materialSlotIndices: readonly (readonly number[])[];
+    readonly materialSlots: readonly MaterialSnapshot[];
+    readonly materialSlotOwners: readonly number[];
+    readonly materialSlotCount: number;
+    readonly pointsLines: PointsLinesRecordOwner | undefined;
+    readonly materialBgAssemblyCache: Map<string, MaterialBgAssemblyCacheEntry>;
+    materialUboPayloadCache?: {
+        readonly materialSlots: readonly MaterialSnapshot[];
+        readonly materialSlotCount: number;
+        readonly payload: Uint8Array;
+    };
+    hdrpSsaoBlurredView?: TextureView;
+}
+export type _InternalRenderPipelineContext = RenderPipelineContext & _StandardForwardSceneView;
+export type RecordProfileRunner = <T>(phase: RenderRecordPhase, action: () => T) => T;
+export declare const STANDARD_PBR_UBO_SIZE = 304;
+export declare const MATERIAL_PER_ENTITY_STRIDE = 512;
+export type SwapChainFormatPair = {
+    readonly storage: GPUTextureFormat;
+    readonly view: GPUTextureFormat;
+    readonly fallbackReason?: 'preferred-canvas-format-missing';
+};
+export type SurfaceBackendKind = 'webgpu' | 'wgpu-native' | 'wgpu-webgl2' | 'null';
+export declare function resolveSurfaceFormatPair(backendKind: SurfaceBackendKind, storage: GPUTextureFormat, view: GPUTextureFormat): SwapChainFormatPair;
+export declare function configureSurface(context: RhiCanvasContext, device: RhiDevice, format: TextureFormat, colorAttachmentFormat: TextureFormat): Result<void, RhiError>;
+export declare function selectSwapChainFormat(storageBufferCapable: boolean): SwapChainFormatPair;
+//# sourceMappingURL=render-context.d.ts.map

package/dist/record/render-context.d.ts.map

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

package/dist/record/shadow-pass.d.ts

@@ -0,0 +1,52 @@
+import { type Buffer, type RhiQueue, type RhiRenderPassEncoder } from '@forgeax/engine-rhi';
+import type { PassSelector } from '@forgeax/engine-types';
+import type { DispatchEntry, ExtractedLights } from '../render-system-extract';
+import type { _InternalRenderPipelineContext } from './render-context';
+export declare const SHADOW_CASTER_SLOT_STRIDE = 256;
+export declare const SHADOW_CASTER_BUFFER_SIZE: number;
+export declare function directionalShadowCasterOffset(cascadeIndex: number): number;
+export declare function spotShadowCasterOffset(tile: number): number;
+export declare function writeShadowCasterUniforms(queue: RhiQueue, buffer: Buffer, lights: ExtractedLights): void;
+export declare function encodeDirectionalShadowPass(c: _InternalRenderPipelineContext, pass: RhiRenderPassEncoder, cascadeIndex: number, viewport: {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+}): void;
+export declare function encodePointShadowPass(c: _InternalRenderPipelineContext, pass: RhiRenderPassEncoder, snapshotIndex: number, face: number): void;
+export declare function encodeSpotShadowPass(c: _InternalRenderPipelineContext, pass: RhiRenderPassEncoder, snapshotIndex: number): void;
+/**
+ * feat-20260609 M2: filter dispatch entries by a {@link PassSelector}.
+ *
+ * Each dispatch entry carries `tags` (a free key-value map) sourced from the
+ * material's per-pass tags.  The selector is matched entry-by-entry via
+ * {@link matchPass}; entries whose tags satisfy the selector are returned.
+ * An empty selector returns the input array unchanged (match-all semantics).
+ *
+ * @param dispatch Per-frame dispatch entries (from the extract stage).
+ * @param selector Pipeline-specific pass selector (e.g. `{ LightMode: ['Forward'] }`).
+ * @returns Dispatch entries whose tags match the selector.
+ */
+export declare function filterDispatchBySelector(dispatch: readonly DispatchEntry[], selector: PassSelector): readonly DispatchEntry[];
+/**
+ * feat-20260609 M2: build a set of renderable indices whose dispatch entries
+ * match the given selector.  Used by the record pass closures to skip entities
+ * that do not belong to the current pass.
+ *
+ * Returns null when the dispatch array is empty (no dispatch-based filtering
+ * to apply — draw all entities).  Returns an empty set when dispatch is
+ * non-empty but no entries matched (draw nothing).  Returns a populated set
+ * when at least one dispatch entry matched.
+ */
+export declare function buildMatchedRenderableIndices(dispatch: readonly DispatchEntry[], selector: PassSelector): Set<number> | null;
+/**
+ * Build the material handles whose dispatch entries match a graph pass.
+ *
+ * A renderable can own more than one material pass, so renderable-level
+ * filtering is insufficient for geometry recording: a Deferred graph pass
+ * must not draw the same renderable's Forward-only material.  Keep the
+ * renderable key in the result so mixed-material meshes retain their
+ * per-submesh routing.
+ */
+export declare function buildMatchedMaterialHandlesByRenderable(dispatch: readonly DispatchEntry[], selector: PassSelector): ReadonlyMap<number, ReadonlySet<number>> | null;
+//# sourceMappingURL=shadow-pass.d.ts.map

package/dist/record/shadow-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-pass.d.ts","sourceRoot":"","sources":["../../src/record/shadow-pass.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,MAAM,EAGX,KAAK,QAAQ,EACb,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAU1D,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAU/E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AAIvE,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,yBAAyB,QAAgC,CAAC;AAEvE,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,eAAe,GACtB,IAAI,CAkBN;AAuID,wBAAgB,2BAA2B,CACzC,CAAC,EAAE,8BAA8B,EACjC,IAAI,EAAE,oBAAoB,EAC1B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3F,IAAI,CAwBN;AAED,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,8BAA8B,EACjC,IAAI,EAAE,oBAAoB,EAC1B,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,GACX,IAAI,CAuBN;AAED,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,8BAA8B,EACjC,IAAI,EAAE,oBAAoB,EAC1B,aAAa,EAAE,MAAM,GACpB,IAAI,CA8CN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,QAAQ,EAAE,YAAY,GACrB,SAAS,aAAa,EAAE,CAG1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,QAAQ,EAAE,YAAY,GACrB,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAmBpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,QAAQ,EAAE,YAAY,GACrB,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAajD"}

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-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;AAI7E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AAGvE;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,8BAA8B,EACjC,SAAS,CAAC,EAAE,oBAAoB,GAC/B,IAAI,CAiIN;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,35 @@
+import { type CompiledRenderGraph } from '@forgeax/engine-render-graph';
+import type { RhiCommandEncoder } from '@forgeax/engine-rhi';
+import { type RenderError } from '../errors/render';
+import { type RenderFeaturePlannedFrame } from '../features/plan';
+import type { PreparedGpuDrivenFrame } from '../gpu-driven/production-raster';
+import type { CameraSnapshot } from '../render-contract';
+import type { RenderPipelineFrame } from '../render-pipeline';
+import type { ExtractedLights } from '../render-system-extract';
+import type { RenderFrameState } from './frame-snapshot';
+import type { PipelineState, RenderSystemInternals } from './render-context';
+export interface RenderFeatureGraphRuntimeState {
+    plans: readonly RenderFeaturePlannedFrame[];
+    fullscreenEffects: ReadonlyMap<string, import('../fullscreen-post-process-pass').PostProcessShaderEntry>;
+}
+/** A frame-local graph candidate that is committed only after compilation. */
+export interface RenderFeatureGraphCandidate {
+    readonly plans: readonly RenderFeaturePlannedFrame[];
+    readonly fullscreenEffects: ReadonlyMap<string, import('../fullscreen-post-process-pass').PostProcessShaderEntry>;
+    /**
+     * Physical prepared resources are imported into the compiled graph. A new
+     * prepared batch therefore needs a new graph even when the declarative plan
+     * signature is unchanged; otherwise queue retirement can destroy the buffer
+     * still referenced by the memoized graph.
+     */
+    readonly preparedResourceKey?: string;
+    /** Release candidate-owned prepared resources when graph promotion fails. */
+    readonly onRejected?: () => void;
+}
+export declare function getRenderFeatureGraphState(internals: RenderSystemInternals): RenderFeatureGraphRuntimeState;
+export declare function resetRenderFeatureGraphState(internals: RenderSystemInternals): void;
+export declare function reportRenderFeatureGraphError(internals: RenderSystemInternals, error: RenderError): void;
+export declare function renderFeatureGraphPlanSignature(plans: readonly RenderFeaturePlannedFrame[]): string;
+export declare function ensureCompiledFrameGraph(internals: RenderSystemInternals, frameState: RenderFrameState, pipelineState: PipelineState, camera: CameraSnapshot, lights: ExtractedLights, width: number, height: number, shadowMapSize: number | undefined, gpuDriven?: PreparedGpuDrivenFrame, featureGraphCandidate?: RenderFeatureGraphCandidate): CompiledRenderGraph<RenderPipelineFrame> | null;
+export declare function executeCompiledFrameGraph(internals: RenderSystemInternals, frameState: RenderFrameState, frame: RenderPipelineFrame, encoder: RhiCommandEncoder, runPass?: import('@forgeax/engine-render-graph').RenderGraphPassRunner): 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,EAIV,iBAAiB,EAGlB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,KAAK,WAAW,EAAiC,MAAM,kBAAkB,CAAC;AAKnF,OAAO,EAAE,KAAK,yBAAyB,EAA8B,MAAM,kBAAkB,CAAC;AAO9F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAEV,mBAAmB,EAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG7E,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5C,iBAAiB,EAAE,WAAW,CAC5B,MAAM,EACN,OAAO,iCAAiC,EAAE,sBAAsB,CACjE,CAAC;CACH;AAED,8EAA8E;AAC9E,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACrD,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CACrC,MAAM,EACN,OAAO,iCAAiC,EAAE,sBAAsB,CACjE,CAAC;IACF;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CAClC;AAID,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,qBAAqB,GAC/B,8BAA8B,CAShC;AAED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,qBAAqB,GAAG,IAAI,CAInF;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,qBAAqB,EAChC,KAAK,EAAE,WAAW,GACjB,IAAI,CAUN;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,SAAS,yBAAyB,EAAE,GAC1C,MAAM,CAIR;AA0OD,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,qBAAqB,CAAC,EAAE,2BAA2B,GAClD,mBAAmB,CAAC,mBAAmB,CAAC,GAAG,IAAI,CA+EjD;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,GACrE,OAAO,CAoBT"}

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

@@ -0,0 +1,45 @@
+import type { Buffer, RhiQueue } from '@forgeax/engine-rhi';
+import type { PointsLinesStyle } from '../points-lines/snapshot';
+import type { CameraSnapshot } from '../render-contract';
+import type { DirectionalLightSnapshot, ExtractedLights, SpotLightSnapshot } from '../render-system-extract';
+export declare const VIEW_UNIFORM_BYTES = 960;
+export declare const POINTS_LINES_VIEW_BYTES = 160;
+export declare const POINTS_LINES_VIEW_SLOT_STRIDE = 256;
+export declare const POINTS_LINES_VIEW_SLOT_COUNT = 1024;
+export declare const POINTS_LINES_VIEW_BUFFER_SIZE: number;
+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;
+export declare function writePointsLinesViewUbo(queue: RhiQueue, buffer: Buffer, camera: CameraSnapshot, width: number, height: number, model?: ArrayLike<number>, style?: PointsLinesStyle, byteOffset?: number): void;
+/**
+ * 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[]): 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,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EACV,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAIlC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,6BAA6B,MAAM,CAAC;AACjD,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,6BAA6B,QACoB,CAAC;AAC/D,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,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EACzB,KAAK,CAAC,EAAE,gBAAgB,EACxB,UAAU,SAAI,GACb,IAAI,CA8BN;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,GAChD,IAAI,CA6GN"}