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

package/dist/features/prepared-graphics-store.d.ts

@@ -0,0 +1,66 @@
+import type { TextureFormat } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import { type RenderError } from '../errors/render';
+import type { PreparedKind, RenderFeatureBindingsDescriptor, RenderFeatureIndexDataDescriptor, RenderFeaturePipelineDescriptor, RenderFeaturePreparedGraphicsState, RenderFeaturePreparedRef, RenderFeatureVertexDataDescriptor } from './prepared-graphics';
+import type { RenderFeatureTargetHandle } from './targets';
+export type PreparedGraphicsKind = Exclude<PreparedKind, 'attachment'>;
+export type PreparedGraphicsRequestByKind = {
+    pipeline: RenderFeaturePipelineDescriptor;
+    bindings: RenderFeatureBindingsDescriptor;
+    'vertex-data': RenderFeatureVertexDataDescriptor;
+    'index-data': RenderFeatureIndexDataDescriptor;
+};
+type PreparedGraphicsSignature = {
+    readonly signature: string;
+};
+export type PreparedGraphicsNormalizedDescriptor = (RenderFeaturePipelineDescriptor & {
+    readonly kind: 'pipeline';
+}) | (RenderFeatureBindingsDescriptor & {
+    readonly kind: 'bindings';
+}) | {
+    readonly kind: 'vertex-data';
+    readonly layout: string;
+    readonly data?: readonly number[];
+    readonly buffer?: import('./prepared-gpu-work').RenderFeatureGpuBufferRef;
+} | {
+    readonly kind: 'index-data';
+    readonly format: 'uint16' | 'uint32';
+    readonly data?: readonly number[];
+    readonly buffer?: import('./prepared-gpu-work').RenderFeatureGpuBufferRef;
+};
+export interface PreparedGraphicsItem<Kind extends PreparedGraphicsKind = PreparedGraphicsKind> {
+    readonly featureIdentity: string;
+    readonly generation: number;
+    readonly kind: Kind;
+    readonly name: string;
+    readonly signature: string;
+    readonly reference: RenderFeaturePreparedRef<Kind>;
+    readonly descriptor?: PreparedGraphicsNormalizedDescriptor;
+    readonly uploadBytes?: readonly number[];
+}
+export interface PreparedGraphicsStoreSnapshot {
+    readonly generation: number;
+    readonly items: readonly PreparedGraphicsItem[];
+}
+export interface PreparedGraphicsTransaction {
+    readonly featureIdentity: string;
+    readonly generation: number;
+    prepare<Kind extends PreparedGraphicsKind>(kind: Kind, name: string, descriptor: PreparedGraphicsRequestByKind[Kind] | PreparedGraphicsSignature): Result<RenderFeaturePreparedRef<Kind>, RenderError>;
+    committedItems(): readonly PreparedGraphicsItem[];
+    overlayItems(): readonly PreparedGraphicsItem[];
+    owns(reference: RenderFeaturePreparedRef): boolean;
+    graphicsState(capabilityAvailable: boolean, attachments: readonly {
+        readonly resource: string | RenderFeatureTargetHandle;
+        readonly format: TextureFormat;
+    }[]): RenderFeaturePreparedGraphicsState;
+    commit(): Result<PreparedGraphicsStoreSnapshot, RenderError>;
+    abort(): void;
+}
+export interface PreparedGraphicsStore {
+    beginFrame(featureIdentity: string, generation: number): PreparedGraphicsTransaction;
+    snapshot(featureIdentity: string): PreparedGraphicsStoreSnapshot;
+    invalidate(featureIdentity: string, generation: number): void;
+}
+export declare function createPreparedGraphicsStore(): PreparedGraphicsStore;
+export {};
+//# sourceMappingURL=prepared-graphics-store.d.ts.map

package/dist/features/prepared-graphics-store.d.ts.map

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

package/dist/features/prepared-graphics.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Public prepared-graphics vocabulary for producer-owned RenderFeatures.
+ *
+ * The five prepared kinds are declarative references only: the render owner
+ * retains device, resource, graph, recording, and submission ownership.
+ */
+import type { TextureFormat } from '@forgeax/engine-rhi';
+import { type MaterialRenderState, type PrimitiveTopology, type Result } from '@forgeax/engine-types';
+import { type RenderError } from '../errors/render';
+import type { RenderFeatureGpuBufferRef } from './prepared-gpu-work';
+import type { RenderFeatureTargetHandle } from './targets';
+import type { PreparedKind } from './vocabulary';
+/** Closed prepared kinds: pipeline, bindings, vertex/index data, and attachment. */
+export type { PreparedKind } from './vocabulary';
+/** Canonical vertex layouts owned by the prepared-graphics host. */
+export declare const RENDER_FEATURE_VERTEX_LAYOUTS: Readonly<{
+    readonly positionSizeColorInstance: "position-size-color-instance";
+    readonly billboardMaterialInstance: "billboard-material-instance";
+    readonly topologySegmentInstance: "topology-segment-instance";
+    readonly meshGeometryMaterialInstance: "mesh-geometry-material-instance";
+}>;
+/**
+ * Opaque render-owned state identified by its prepared kind and device generation.
+ * A generation change invalidates old references after device recovery or
+ * pipeline replacement; features never construct or inspect backend handles.
+ * Features may pass this reference back to the render owner but do not receive a
+ * device, encoder, backend handle, or submit authority.
+ */
+export interface RenderFeaturePreparedRef<Kind extends PreparedKind = PreparedKind> {
+    readonly kind: Kind;
+    readonly generation: number;
+}
+/** Declarative request for a registered graphics pipeline. */
+export interface RenderFeaturePipelineDescriptor {
+    readonly shader: string;
+    readonly vertexLayout: string;
+    readonly colorFormats: readonly TextureFormat[];
+    readonly depthFormat?: TextureFormat;
+    /** Sample count of the target this pipeline will draw into. */
+    readonly sampleCount?: 1 | 4;
+    /** Primitive topology consumed by the prepared draw. */
+    readonly topology?: PrimitiveTopology;
+    /** Index scalar format when the topology consumes an index buffer. */
+    readonly indexFormat?: 'uint16' | 'uint32';
+    /**
+     * Declarative raster/depth/blend overrides for this pipeline. The render
+     * owner maps this portable material state onto the backend pipeline; a
+     * feature never receives a backend pipeline descriptor or device handle.
+     */
+    readonly renderState?: MaterialRenderState;
+}
+/** Declarative request for values bound through a prepared pipeline. */
+export interface RenderFeatureBindingsDescriptor {
+    readonly pipeline: RenderFeaturePreparedRef<'pipeline'>;
+    readonly values: Readonly<Record<string, unknown>> & {
+        readonly group?: number;
+        readonly sceneDepth?: RenderFeatureTargetHandle;
+        /** Binding slot for a view-plus-scene-depth group (0 keeps legacy behavior). */
+        readonly sceneDepthBinding?: number;
+    };
+}
+/** CPU-owned vertex data and its canonical layout identity. */
+export type RenderFeatureVertexDataDescriptor = {
+    readonly layout: string;
+    readonly data: ArrayBufferView | readonly number[];
+    readonly buffer?: never;
+} | {
+    readonly layout: string;
+    readonly buffer: RenderFeatureGpuBufferRef;
+    readonly data?: never;
+};
+/** CPU-owned or persistent GPU-owned index data and its scalar format. */
+export type RenderFeatureIndexDataDescriptor = {
+    readonly format: 'uint16' | 'uint32';
+    readonly data: Uint16Array | Uint32Array;
+    readonly buffer?: never;
+} | {
+    readonly format: 'uint16' | 'uint32';
+    readonly buffer: RenderFeatureGpuBufferRef;
+    readonly data?: never;
+};
+/**
+ * Feature-facing preparation facade. Call these methods during `prepare`, then
+ * pass the returned references to `addGraphicsPass` during `contribute`; the
+ * render owner retains resource, graph, recording, and submission ownership.
+ */
+export interface RenderFeatureGraphicsPrepare {
+    /** Prepare a registered graphics pipeline without exposing backend state. */
+    preparePipeline(name: string, descriptor: RenderFeaturePipelineDescriptor): Result<RenderFeaturePreparedRef<'pipeline'>, RenderError>;
+    /** Prepare bindings compatible with a prepared pipeline. */
+    prepareBindings(name: string, descriptor: RenderFeatureBindingsDescriptor): Result<RenderFeaturePreparedRef<'bindings'>, RenderError>;
+    /** Prepare vertex data using a canonical layout identity. */
+    prepareVertexData(name: string, descriptor: RenderFeatureVertexDataDescriptor): Result<RenderFeaturePreparedRef<'vertex-data'>, RenderError>;
+    /** Prepare index data for an indexed draw record. */
+    prepareIndexData(name: string, descriptor: RenderFeatureIndexDataDescriptor): Result<RenderFeaturePreparedRef<'index-data'>, RenderError>;
+}
+/** A color target declared by a graphics pass. */
+export interface RenderFeatureColorAttachment {
+    readonly resource: string | RenderFeatureTargetHandle;
+    readonly format: TextureFormat;
+    readonly loadOp: 'load' | 'clear';
+    readonly storeOp: 'store' | 'discard';
+}
+/** A depth/stencil target declared by a graphics pass. */
+export interface RenderFeatureDepthStencilAttachment {
+    readonly resource: string | RenderFeatureTargetHandle;
+    readonly format: TextureFormat;
+    readonly depthLoadOp: 'load' | 'clear';
+    readonly depthStoreOp: 'store' | 'discard';
+}
+/** The attachments a graphics pass requires from the render owner. */
+export interface RenderFeatureGraphicsPassAttachments {
+    readonly colors: readonly RenderFeatureColorAttachment[];
+    readonly depthStencil?: RenderFeatureDepthStencilAttachment;
+}
+/** One vertex slot consumed by a declarative draw record. */
+export interface RenderFeatureVertexDataBinding {
+    readonly slot: number;
+    readonly resource: RenderFeaturePreparedRef<'vertex-data'>;
+}
+/** Non-indexed draw command. */
+export interface RenderFeatureDrawCommand {
+    readonly vertexCount: number;
+    readonly instanceCount: number;
+    readonly firstVertex?: number;
+    readonly firstInstance?: number;
+}
+/** Indexed draw command. */
+export interface RenderFeatureIndexedDrawCommand {
+    readonly indexCount: number;
+    readonly instanceCount: number;
+    readonly firstIndex?: number;
+    readonly baseVertex?: number;
+    readonly firstInstance?: number;
+}
+export interface RenderFeatureIndirectDrawCommand {
+    readonly buffer: RenderFeatureGpuBufferRef;
+    readonly offset?: number;
+}
+/** Index state attached to an indexed draw record. */
+export interface RenderFeatureIndexDataBinding {
+    readonly resource: RenderFeaturePreparedRef<'index-data'>;
+    readonly format: 'uint16' | 'uint32';
+}
+/** The two supported graphics draw record shapes: vertex-only and indexed. */
+export type RenderFeatureDrawRecord = {
+    readonly kind: 'draw';
+    readonly pipeline: RenderFeaturePreparedRef<'pipeline'>;
+    readonly bindings: readonly RenderFeaturePreparedRef<'bindings'>[];
+    readonly vertexData: readonly RenderFeatureVertexDataBinding[];
+    /** Explicit fullscreen contract: the vertex shader owns vertex_index. */
+    readonly vertexLayout?: 'none';
+    readonly indexData?: RenderFeatureIndexDataBinding;
+    readonly command: RenderFeatureDrawCommand;
+} | {
+    readonly kind: 'draw-indirect';
+    readonly pipeline: RenderFeaturePreparedRef<'pipeline'>;
+    readonly bindings: readonly RenderFeaturePreparedRef<'bindings'>[];
+    readonly vertexData: readonly RenderFeatureVertexDataBinding[];
+    readonly vertexLayout?: 'none';
+    readonly indexData?: RenderFeatureIndexDataBinding;
+    readonly command: RenderFeatureIndirectDrawCommand;
+} | {
+    readonly kind: 'draw-indexed';
+    readonly pipeline: RenderFeaturePreparedRef<'pipeline'>;
+    readonly bindings: readonly RenderFeaturePreparedRef<'bindings'>[];
+    readonly vertexData: readonly RenderFeatureVertexDataBinding[];
+    readonly vertexLayout?: 'none';
+    readonly indexData: RenderFeatureIndexDataBinding | undefined;
+    readonly command: RenderFeatureIndexedDrawCommand;
+} | {
+    readonly kind: 'draw-indexed-indirect';
+    readonly pipeline: RenderFeaturePreparedRef<'pipeline'>;
+    readonly bindings: readonly RenderFeaturePreparedRef<'bindings'>[];
+    readonly vertexData: readonly RenderFeatureVertexDataBinding[];
+    readonly vertexLayout?: 'none';
+    readonly indexData: RenderFeatureIndexDataBinding | undefined;
+    readonly command: RenderFeatureIndirectDrawCommand;
+};
+/**
+ * Declaration submitted to the existing graph-owned contribution staging.
+ * This is a graphics extension of graph-only `addPass`, not a second graph.
+ */
+export interface RenderFeatureGraphicsPassDescriptor {
+    readonly attachments: RenderFeatureGraphicsPassAttachments;
+    /** Targets sampled by shaders but not attached for writing in this pass. */
+    readonly sampledTargets?: readonly RenderFeatureTargetHandle[];
+    readonly draws: readonly RenderFeatureDrawRecord[];
+}
+/**
+ * Prepared state projected by the render owner for pure descriptor validation.
+ * The generation and opaque references are host facts, not producer-owned GPU
+ * state.
+ */
+export interface RenderFeaturePreparedGraphicsState {
+    readonly capabilityAvailable: boolean;
+    readonly generation: number;
+    readonly attachments: readonly {
+        readonly resource: string | RenderFeatureTargetHandle;
+        readonly format: TextureFormat;
+    }[];
+    readonly pipeline: RenderFeaturePreparedRef | undefined;
+    /** All prepared pipelines available to the current graphics pass. */
+    readonly pipelines?: readonly RenderFeaturePreparedRef[];
+    readonly bindings: readonly RenderFeaturePreparedRef[];
+    readonly vertexData: readonly RenderFeaturePreparedRef[];
+    readonly indexData: readonly RenderFeaturePreparedRef[];
+}
+/** Successful validation result consumed by the render host projector. */
+export interface RenderFeatureValidatedGraphicsPass {
+    readonly acceptedDrawCount: number;
+}
+/** Validate a graphics declaration without touching an RHI backend. */
+export declare function validateRenderFeatureGraphicsPass(featureIdentity: string, descriptor: RenderFeatureGraphicsPassDescriptor, state: RenderFeaturePreparedGraphicsState): Result<RenderFeatureValidatedGraphicsPass, RenderError>;
+//# sourceMappingURL=prepared-graphics.d.ts.map

package/dist/features/prepared-graphics.d.ts.map

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

package/dist/features/render-graph-compute.d.ts

@@ -0,0 +1,13 @@
+import type { RenderGraphBuilder, RenderGraphError, RenderGraphFrame } from '@forgeax/engine-render-graph';
+import type { Result } from '@forgeax/engine-types';
+import { type RenderError } from '../errors/render';
+import { type RenderFeatureResolvedGpuComputePass } from './prepared-gpu-work';
+import { type RenderFeatureGraphBufferState } from './render-graph-resources';
+export declare class RenderFeatureComputeGraphProjection<FrameCtx extends RenderGraphFrame> {
+    private readonly builder;
+    private readonly reportError?;
+    private readonly resources;
+    constructor(builder: RenderGraphBuilder<FrameCtx>, resources?: RenderFeatureGraphBufferState, reportError?: ((error: RenderError) => void) | undefined);
+    addPass(name: string, featureIdentity: string, order: number, work: RenderFeatureResolvedGpuComputePass): Result<void, RenderGraphError>;
+}
+//# sourceMappingURL=render-graph-compute.d.ts.map

package/dist/features/render-graph-compute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-graph-compute.d.ts","sourceRoot":"","sources":["../../src/features/render-graph-compute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,KAAK,WAAW,EAAyC,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAEL,KAAK,mCAAmC,EACzC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,0BAA0B,CAAC;AAElC,qBAAa,mCAAmC,CAAC,QAAQ,SAAS,gBAAgB;IAI9E,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAL/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;gBAGvC,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EACtD,SAAS,CAAC,EAAE,6BAA6B,EACxB,WAAW,CAAC,GAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,aAAA;IAK7D,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,mCAAmC,GACxC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC;CAmClC"}

package/dist/features/render-graph-contribution.d.ts

@@ -0,0 +1,12 @@
+import type { RenderGraphBuilder, RenderGraphError, RenderGraphFrame } from '@forgeax/engine-render-graph';
+import { type Result } from '@forgeax/engine-types';
+import { type RenderError } from '../errors/render';
+import type { RenderFeaturePlanExecution } from './host';
+import { type RenderFeatureGraphBindingsResolver, type RenderFeatureGraphTargetResolver } from './render-graph-raster';
+/** Project the host-owned plan execution directly into the one typed graph. */
+export declare function projectRenderFeaturePlans<FrameCtx extends RenderGraphFrame>(builder: RenderGraphBuilder<FrameCtx>, executions: readonly RenderFeaturePlanExecution[], options: {
+    readonly resolveTarget: RenderFeatureGraphTargetResolver;
+    readonly resolveBindings?: RenderFeatureGraphBindingsResolver<FrameCtx> | undefined;
+    readonly reportError?: ((error: RenderError) => void) | undefined;
+}): Result<void, RenderGraphError | RenderError>;
+//# sourceMappingURL=render-graph-contribution.d.ts.map

package/dist/features/render-graph-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-graph-contribution.d.ts","sourceRoot":"","sources":["../../src/features/render-graph-contribution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,KAAK,WAAW,EAAiC,MAAM,kBAAkB,CAAC;AACnF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,QAAQ,CAAC;AAEzD,OAAO,EACL,KAAK,kCAAkC,EACvC,KAAK,gCAAgC,EAEtC,MAAM,uBAAuB,CAAC;AAG/B,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,QAAQ,SAAS,gBAAgB,EACzE,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EACrC,UAAU,EAAE,SAAS,0BAA0B,EAAE,EACjD,OAAO,EAAE;IACP,QAAQ,CAAC,aAAa,EAAE,gCAAgC,CAAC;IACzD,QAAQ,CAAC,eAAe,CAAC,EAAE,kCAAkC,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IACpF,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACnE,GACA,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAAC,CAiD9C"}

package/dist/features/render-graph-raster.d.ts

@@ -0,0 +1,38 @@
+import type { GraphResourceResolver, GraphTexture, GraphTextureView, RenderGraphBuilder, RenderGraphError, RenderGraphFrame } from '@forgeax/engine-render-graph';
+import type { BindGroup } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import { type RenderError } from '../errors/render';
+import type { PreparedGraphicsResolvedResource, PreparedGraphicsResolvedSnapshot } from '../prepare/prepared-graphics-resolver';
+import type { RenderFeatureGraphicsPassDescriptor, RenderFeaturePreparedGraphicsState } from './prepared-graphics';
+import { type RenderFeatureGraphBufferState } from './render-graph-resources';
+import type { RenderFeatureTargetHandle } from './targets';
+export interface RenderFeatureGraphTarget {
+    readonly texture: GraphTexture;
+    readonly view: GraphTextureView;
+    readonly resolveTarget?: GraphTextureView | undefined;
+}
+export type RenderFeatureGraphTargetResolver = (resource: string | RenderFeatureTargetHandle) => RenderFeatureGraphTarget | undefined;
+export type RenderFeatureGraphBindingsResolution = BindGroup | {
+    readonly handle: BindGroup;
+    readonly dynamicOffsets?: readonly number[];
+};
+export type RenderFeatureGraphBindingsResolver<FrameCtx extends RenderGraphFrame> = (input: {
+    readonly frame: FrameCtx;
+    readonly binding: Extract<PreparedGraphicsResolvedResource, {
+        readonly kind: 'bindings';
+    }>;
+    readonly resources: GraphResourceResolver;
+    readonly resolveTarget: RenderFeatureGraphTargetResolver;
+}) => RenderFeatureGraphBindingsResolution | undefined;
+export declare class RenderFeatureRasterGraphProjection<FrameCtx extends RenderGraphFrame> {
+    private readonly builder;
+    private readonly resolveTarget;
+    private readonly resolveBindings?;
+    private readonly reportError?;
+    private readonly buffers;
+    constructor(builder: RenderGraphBuilder<FrameCtx>, resolveTarget: RenderFeatureGraphTargetResolver, resolveBindings?: RenderFeatureGraphBindingsResolver<FrameCtx> | undefined, buffers?: RenderFeatureGraphBufferState, reportError?: ((error: RenderError) => void) | undefined);
+    addPass(name: string, featureIdentity: string, order: number, descriptor: RenderFeatureGraphicsPassDescriptor, state: RenderFeaturePreparedGraphicsState, snapshot: PreparedGraphicsResolvedSnapshot): Result<void, RenderGraphError | RenderError>;
+    private importDrawBuffers;
+    private encode;
+}
+//# sourceMappingURL=render-graph-raster.d.ts.map

package/dist/features/render-graph-raster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-graph-raster.d.ts","sourceRoot":"","sources":["../../src/features/render-graph-raster.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAEhB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAwB,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,KAAK,WAAW,EAGjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,gCAAgC,EAChC,gCAAgC,EACjC,MAAM,uCAAuC,CAAC;AAE/C,OAAO,KAAK,EACV,mCAAmC,EACnC,kCAAkC,EAEnC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAE3D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACvD;AAED,MAAM,MAAM,gCAAgC,GAAG,CAC7C,QAAQ,EAAE,MAAM,GAAG,yBAAyB,KACzC,wBAAwB,GAAG,SAAS,CAAC;AAE1C,MAAM,MAAM,oCAAoC,GAC5C,SAAS,GACT;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C,CAAC;AAEN,MAAM,MAAM,kCAAkC,CAAC,QAAQ,SAAS,gBAAgB,IAAI,CAAC,KAAK,EAAE;IAC1F,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,gCAAgC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IAC3F,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,gCAAgC,CAAC;CAC1D,KAAK,oCAAoC,GAAG,SAAS,CAAC;AAmBvD,qBAAa,kCAAkC,CAAC,QAAQ,SAAS,gBAAgB;IAI7E,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IAEjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAP/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;gBAGrC,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EACrC,aAAa,EAAE,gCAAgC,EAC/C,eAAe,CAAC,EAAE,kCAAkC,CAAC,QAAQ,CAAC,YAAA,EAC/E,OAAO,CAAC,EAAE,6BAA6B,EACtB,WAAW,CAAC,GAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,aAAA;IAK7D,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,mCAAmC,EAC/C,KAAK,EAAE,kCAAkC,EACzC,QAAQ,EAAE,gCAAgC,GACzC,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAkG/C,OAAO,CAAC,iBAAiB;IAqDzB,OAAO,CAAC,MAAM;CAoFf"}

package/dist/features/render-graph-resources.d.ts

@@ -0,0 +1,11 @@
+import type { GraphBuffer, RenderGraphBuilder, RenderGraphError, RenderGraphFrame } from '@forgeax/engine-render-graph';
+import type { Buffer } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import type { RenderFeatureResolvedGpuBuffer } from './prepared-gpu-work';
+export interface RenderFeatureGraphBufferState {
+    readonly handles: Map<Buffer, GraphBuffer>;
+    readonly labelCounts: Map<string, number>;
+}
+export declare function createRenderFeatureGraphBufferState(): RenderFeatureGraphBufferState;
+export declare function importRenderFeatureGraphBuffer<FrameCtx extends RenderGraphFrame>(builder: RenderGraphBuilder<FrameCtx>, state: RenderFeatureGraphBufferState, label: string, resource: RenderFeatureResolvedGpuBuffer): Result<GraphBuffer, RenderGraphError>;
+//# sourceMappingURL=render-graph-resources.d.ts.map

package/dist/features/render-graph-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-graph-resources.d.ts","sourceRoot":"","sources":["../../src/features/render-graph-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,wBAAgB,mCAAmC,IAAI,6BAA6B,CAEnF;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,SAAS,gBAAgB,EAC9E,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EACrC,KAAK,EAAE,6BAA6B,EACpC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,8BAA8B,GACvC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAavC"}

package/dist/features/targets.d.ts

@@ -0,0 +1,32 @@
+import type { TextureFormat } from '@forgeax/engine-rhi';
+/** Render-owned logical targets exposed to producer-owned RenderFeatures. */
+export type RenderFeatureTargetKind = 'scene-color' | 'scene-depth';
+/**
+ * A logical attachment supplied by the active RenderPipeline.
+ *
+ * The semantic kind plus attachment facts identify the target. The active
+ * pipeline supplies the graph resource, so feature authors never name an
+ * internal graph key.
+ */
+export interface RenderFeatureTargetHandle {
+    readonly kind: RenderFeatureTargetKind;
+    readonly format: TextureFormat;
+    readonly sampleCount: 1 | 4;
+    readonly __renderFeatureTarget: unique symbol;
+}
+export interface RenderFeatureTargetInput {
+    readonly kind: RenderFeatureTargetKind;
+    readonly format: TextureFormat;
+    readonly sampleCount: 1 | 4;
+}
+export declare function createRenderFeatureTarget(input: RenderFeatureTargetInput): RenderFeatureTargetHandle;
+export declare function isRenderFeatureTargetHandle(value: unknown): value is RenderFeatureTargetHandle;
+export declare function renderFeatureAttachmentResource(resource: string | RenderFeatureTargetHandle): string;
+export declare function resolveStandardRenderFeatureTargets(input: {
+    readonly tonemap: string;
+    readonly antialias: string;
+    readonly storageBuffer: boolean;
+    readonly multisample: boolean;
+    readonly colorAttachmentFormat: TextureFormat;
+}): readonly RenderFeatureTargetHandle[];
+//# sourceMappingURL=targets.d.ts.map

package/dist/features/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../src/features/targets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,6EAA6E;AAE7E,MAAM,MAAM,uBAAuB,GAAG,aAAa,GAAG,aAAa,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5B,QAAQ,CAAC,qBAAqB,EAAE,OAAO,MAAM,CAAC;CAC/C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;CAC7B;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,yBAAyB,CAE3B;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,yBAAyB,CAQ9F;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,GAAG,yBAAyB,GAC3C,MAAM,CAER;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,qBAAqB,EAAE,aAAa,CAAC;CAC/C,GAAG,SAAS,yBAAyB,EAAE,CAevC"}

package/dist/features/types.d.ts

@@ -0,0 +1,68 @@
+/** Public RenderFeature lifecycle, diagnostics, and host-context declarations. */
+import type { EntityHandle, World } from '@forgeax/engine-ecs';
+import type { RhiCaps } from '@forgeax/engine-rhi';
+import type { Result } from '@forgeax/engine-types';
+import type { RenderError, RenderFeatureErrorDescriptor } from '../errors/render';
+import type { VisibilitySnapshot } from '../extract/visibility';
+import type { RenderFeaturePlan, RenderFeaturePlanContext } from './plan';
+import type { RenderFeatureCapabilityKey } from './vocabulary';
+export type { RenderFeatureCapabilityMissingDetail, RenderFeatureCleanupFailure, RenderFeatureDrawRecordingFailedDetail, RenderFeatureErrorCode, RenderFeatureErrorDescriptor, RenderFeaturePassOrderConflictDetail, RenderFeaturePreparationFailedDetail, RenderFeaturePreparedStateMismatchDetail, RenderFeatureRegistrationConflictDetail, RenderFeatureStageFailedDetail, } from '../errors/render';
+export type { RenderFeatureDispatch, RenderFeatureDraw, RenderFeatureDrawDeclaration, RenderFeatureFullscreenProgramDeclaration, RenderFeatureLogicalTarget, RenderFeaturePassDeclaration, RenderFeaturePlan, RenderFeaturePlanContext, RenderFeatureResourceDeclaration, RenderFeatureResourceUsage, } from './plan';
+export type { RenderFeatureTargetHandle } from './targets';
+export type { PreparedKind, RenderFeatureCapabilityKey, RenderFeatureRecovery, RenderFeatureStage, } from './vocabulary';
+/** Closed lifecycle states exposed by the feature host. */
+export type RenderFeatureStatus = 'active' | 'failed' | 'disabled' | 'disposed';
+export interface RenderFeatureResourceHandle {
+    readonly __renderFeatureResource: unique symbol;
+}
+/** One World-local visibility snapshot prepared for the current frame batch. */
+export interface RenderFeatureWorldVisibilitySnapshot {
+    readonly world: World;
+    readonly snapshot: VisibilitySnapshot;
+}
+/** A producer's structured report for one hidden render candidate. */
+export interface RenderFeatureHiddenEntityReport {
+    readonly world: World;
+    readonly entity: EntityHandle;
+}
+export interface RenderFeatureExtractContext {
+    readonly worlds: readonly World[];
+    readonly owner: number;
+    readonly frameNumber: number;
+    /** Same-batch World snapshots; absent for synthetic direct feature probes. */
+    readonly visibilitySnapshots?: readonly RenderFeatureWorldVisibilitySnapshot[];
+    /** Host-owned report sink; feature code never owns the merged diagnostic. */
+    readonly reportHiddenEntity?: (report: RenderFeatureHiddenEntityReport) => void;
+}
+/**
+ * Producer-owned extension seam for one render frame.
+ *
+ * `FrameData` is the single value that crosses extract into the mandatory
+ * declarative plan. The host derives preparation, graph access, recording,
+ * recovery, and retirement from that plan; no producer callback receives GPU
+ * authority or maintains a parallel lifecycle.
+ */
+export interface RenderFeature<FrameData> {
+    readonly identity: string;
+    readonly requiredCapabilities?: readonly RenderFeatureCapabilityKey[];
+    /**
+     * Material shader identifiers whose modules must be ready before the first
+     * frame. The renderer resolves these against the loaded manifest and seeds
+     * the same lazy module cache used by prepared graphics.
+     */
+    readonly requiredMaterialShaders?: readonly string[];
+    extract(context: RenderFeatureExtractContext): Result<FrameData, RenderError>;
+    plan(data: FrameData, context: RenderFeaturePlanContext): Result<RenderFeaturePlan, RenderError>;
+}
+export interface RenderFeatureRecoverInput {
+    readonly caps: Readonly<RhiCaps>;
+    readonly frameNumber: number;
+}
+/** Read-only, machine-readable lifecycle state for one registered feature. */
+export interface RenderFeatureDiagnostics {
+    readonly identity: string;
+    readonly order: number;
+    readonly status: RenderFeatureStatus;
+    readonly latestError: RenderFeatureErrorDescriptor | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/features/types.d.ts.map

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

package/dist/features/vocabulary.d.ts

@@ -0,0 +1,14 @@
+import type { RhiCaps } from '@forgeax/engine-rhi';
+/** Closed prepared-resource kinds owned by the RenderFeature vocabulary. */
+export type PreparedKind = 'pipeline' | 'bindings' | 'vertex-data' | 'index-data' | 'attachment';
+/** Closed stages that can attribute a feature failure. */
+export type RenderFeatureStage = 'extract' | 'plan' | 'prepare' | 'contribute' | 'record' | 'recover' | 'dispose';
+/** Recovery action attached to a structured feature failure. */
+export type RenderFeatureRecovery = 'next-frame' | 'renderer-recover' | 'registration';
+/** Boolean capability names are derived from the RHI capability source. */
+type BooleanCapabilityKey = {
+    [Key in keyof RhiCaps]-?: RhiCaps[Key] extends boolean ? Key : never;
+}[keyof RhiCaps];
+export type RenderFeatureCapabilityKey = BooleanCapabilityKey;
+export {};
+//# sourceMappingURL=vocabulary.d.ts.map

package/dist/features/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../../src/features/vocabulary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,4EAA4E;AAC5E,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,YAAY,GAAG,YAAY,CAAC;AAEjG,0DAA0D;AAC1D,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,MAAM,GACN,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,SAAS,CAAC;AAEd,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAEvF,2EAA2E;AAC3E,KAAK,oBAAoB,GAAG;KACzB,GAAG,IAAI,MAAM,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,OAAO,GAAG,GAAG,GAAG,KAAK;CACrE,CAAC,MAAM,OAAO,CAAC,CAAC;AAEjB,MAAM,MAAM,0BAA0B,GAAG,oBAAoB,CAAC"}