@forgeax/engine-render 0.1.2

package/dist/extract/__tests__/environment-source.test.d.ts.map

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

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

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

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

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

package/dist/extract/directional-csm.d.ts

@@ -0,0 +1,129 @@
+import { type Vec3 } from '@forgeax/engine-math';
+export interface CsmCameraData {
+    readonly world: Float32Array;
+    readonly fov: number;
+    readonly aspect: number;
+    readonly near: number;
+    readonly far: number;
+    readonly projection: 'perspective' | 'orthographic';
+    readonly orthoLeft: number;
+    readonly orthoRight: number;
+    readonly orthoBottom: number;
+    readonly orthoTop: number;
+}
+export interface DirectionalCsmConfig {
+    readonly cascadeCount: number;
+    readonly splitLambda: number;
+    readonly cascadeBlend: number;
+    readonly mapSize: number;
+    readonly shadowDistance: number;
+    /** Optional only for old internal callers; DirectionalLight supplies it. */
+    readonly pcfKernelSize?: number;
+    /** @internal Collect producer-owned per-candidate decisions for RHI evidence. */
+    readonly collectCandidateDecisions?: boolean;
+}
+export interface CascadeRasterViewport {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+}
+export interface CascadeVolume {
+    readonly cascadeIndex: number;
+    readonly revision: number;
+    readonly lightViewProj: Float32Array;
+    readonly receiverViewDepth: readonly [number, number];
+    readonly receiverLightBounds: Float32Array;
+    readonly clipLightBounds: Float32Array;
+    /** Raster bounds are the exact clip array consumed by the matrix fit. */
+    readonly rasterLightBounds: Float32Array;
+    readonly depthLightRange: readonly [number, number];
+    /** Conservative world-space AABB used by static and dynamic broadphase owners. */
+    readonly casterBroadphaseWorldAabb: Float32Array;
+    readonly rasterViewport: CascadeRasterViewport;
+    /** Stable X/Y extent; casters never enlarge this receiver-driven domain. */
+    readonly stableExtent: number;
+    /** Receiver sphere center before texel-grid snapping. */
+    readonly unsnappedCenter: readonly [number, number];
+    readonly snappedCenter: readonly [number, number];
+    readonly halfExtent: number;
+    readonly worldUnitsPerTexel: number;
+    readonly guardBandTexels: number;
+    /** Candidate indices are stable before main-view culling. */
+    readonly casterRenderableIndices: Uint32Array;
+    /** Optional complete CPU decision stream, enabled only for debug capture. */
+    readonly candidateDecisions?: readonly DirectionalCsmCandidateDecision[];
+    readonly unboundedFallback: readonly DirectionalCsmFallback[];
+    readonly unboundedFallbackCount: number;
+    /** Historical whole-frustum away-light extent retained for fallback casters. */
+    readonly lightSpaceMinZFull: number;
+    /** Historical whole-frustum toward-light reach retained for fallback casters. */
+    readonly lightSpaceMaxZFull: number;
+}
+/** Compatibility name for existing record and debug consumers. */
+export type DirectionalCsmCascadePlan = CascadeVolume;
+export interface DirectionalCsmFallback {
+    readonly renderableIndex: number;
+    readonly reason: string;
+}
+export interface DirectionalCsmCasterCandidate {
+    readonly renderableIndex: number;
+    readonly worldId: number;
+    readonly entityKey: number;
+    readonly worldAabb: Float32Array | null;
+    readonly bounded: boolean;
+    readonly shadowCaster: boolean;
+    readonly fallbackReason?: string;
+}
+export interface DirectionalCsmCandidateSource {
+    readonly renderableIndex: number;
+    readonly worldId: number;
+    readonly entityKey: number;
+    readonly localAabb?: Float32Array | undefined;
+    readonly transformWorld: Float32Array;
+    readonly instanceTransforms?: Float32Array | undefined;
+    /** Skin/morph bounds are feature-owned; do not infer them from a static mesh AABB. */
+    readonly featureOwnedBoundsUnavailable?: boolean;
+    readonly shadowCaster: boolean;
+}
+export interface DirectionalCsmCandidateDecision {
+    readonly renderableIndex: number;
+    readonly worldId: number;
+    readonly entityKey: number;
+    readonly selected: boolean;
+    readonly reason: string;
+    readonly lightSpaceBounds?: Float32Array;
+}
+/**
+ * Optional persistent-scene broadphase owner. Returned indices address the
+ * stable candidate domain supplied to the CSM builder; the builder still owns
+ * the exact light-space membership test.
+ */
+export type DirectionalCsmCandidateBroadphase = (worldAabb: Float32Array) => readonly number[];
+export interface CascadeVolumeSet {
+    readonly revision: number;
+    readonly volumes: readonly CascadeVolume[];
+}
+export interface DirectionalCsmResult extends CascadeVolumeSet {
+    readonly lightViewProj: Float32Array[];
+    readonly splitPlanes: Float32Array;
+    readonly cascadeCount: number;
+    readonly cascadeBlend: number;
+    readonly shadowMapSize: number;
+    readonly cascades: readonly DirectionalCsmCascadePlan[];
+}
+export declare function directionalCascadeRasterViewport(cascadeIndex: number, cascadeCount: number, mapSize: number): CascadeRasterViewport;
+/** Exact depth-atlas dimensions for the raster viewport layout. */
+export declare function directionalCascadeAtlasSize(cascadeCount: number, mapSize: number): {
+    readonly width: number;
+    readonly height: number;
+};
+export declare function buildDirectionalCsmCasterCandidates(sources: readonly DirectionalCsmCandidateSource[]): DirectionalCsmCasterCandidate[];
+export declare function pssmSplit(nearPlane: number, farPlane: number, cascadeCount: number, splitLambda: number): Float32Array;
+/** Sole producer for directional cascade matrices, bounds, raster, depth, and membership. */
+export declare class CascadeVolumeSetBuilder {
+    build(direction: Vec3, config: DirectionalCsmConfig, cameraData: CsmCameraData | undefined, casterCandidates?: readonly DirectionalCsmCasterCandidate[], candidateBroadphase?: DirectionalCsmCandidateBroadphase | undefined): DirectionalCsmResult | null;
+}
+/** Compatibility entry backed by the canonical CascadeVolumeSet producer. */
+export declare function computeDirectionalCsm(direction: Vec3, config: DirectionalCsmConfig, cameraData: CsmCameraData | undefined, casterCandidates?: readonly DirectionalCsmCasterCandidate[], candidateBroadphase?: DirectionalCsmCandidateBroadphase | undefined): DirectionalCsmResult | null;
+//# sourceMappingURL=directional-csm.d.ts.map

package/dist/extract/directional-csm.d.ts.map

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

package/dist/extract/index.d.ts

@@ -0,0 +1,5 @@
+export type { ExtractedFrame, PreparedExtractContext } from '../render-system-extract';
+export { extractFrame, prepareExtractContext } from '../render-system-extract';
+export { createMaterialInterfaceOwner, type DerivedMaterialCoordinateProjection, type DerivedMaterialSlotProjection, type DerivedMaterialSlotProjectionInput, deriveMaterialSlotProjection, } from './material-interface';
+export * from './visibility';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extract/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EACL,4BAA4B,EAC5B,KAAK,mCAAmC,EACxC,KAAK,6BAA6B,EAClC,KAAK,kCAAkC,EACvC,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/dist/extract/material-interface.d.ts

@@ -0,0 +1,56 @@
+import type { World } from '@forgeax/engine-ecs';
+import type { DerivedMaterialInterface, Handle, MaterialAsset, MaterialColorParameterSchema, MaterialParameter, MaterialPass, MaterialRenderState, MaterialTextureCoordinates, ParamSchemaEntry } from '@forgeax/engine-types';
+import { type MaterialError, type Result } from '@forgeax/engine-types';
+import type { RenderAssetPort } from '../assets/render-asset-port';
+import type { GpuResourceStore } from '../gpu-resource-store';
+import { type ParamSchemaProjectionCensus } from '../param-schema-projection-census';
+import type { MaterialSnapshot, MaterialSnapshotCache, MaterialSnapshotCacheEntry } from '../render-system-extract';
+export interface DerivedMaterialCoordinateProjection extends MaterialTextureCoordinates {
+    readonly physicalUvScale: readonly [number, number];
+}
+export interface DerivedMaterialSlotProjection {
+    readonly material: string;
+    readonly derivedInterface: DerivedMaterialInterface;
+    readonly layoutIdentity: string;
+    readonly numericValues: Readonly<Record<string, number | readonly number[]>>;
+    readonly coordinates: ReadonlyMap<string, DerivedMaterialCoordinateProjection>;
+}
+export interface DerivedMaterialSlotProjectionInput {
+    readonly material: string;
+    readonly schema: readonly ParamSchemaEntry[];
+    readonly derivedInterface?: DerivedMaterialInterface;
+    readonly values: Readonly<Record<string, unknown>>;
+    readonly coordinates: ReadonlyMap<string, MaterialTextureCoordinates>;
+    readonly textures?: ReadonlyMap<string, {
+        readonly format: GPUTextureFormat;
+        readonly width: number;
+        readonly height: number;
+    }>;
+}
+/** The material pass list is the single source of truth for caster eligibility. */
+export declare function hasShadowCasterPass(passes: readonly MaterialPass[]): boolean;
+export declare function defaultMaterialTextureCoordinates(schemaOrProjection: readonly ParamSchemaEntry[] | DerivedMaterialInterface): Map<string, MaterialTextureCoordinates>;
+export declare function deriveMaterialSlotProjection(input: DerivedMaterialSlotProjectionInput): Result<DerivedMaterialSlotProjection, MaterialError>;
+export interface MaterialInterfaceDependencies {
+    readonly defaultMaterialSnapshot: (materialHandle?: number) => MaterialSnapshot;
+    readonly readStablePersistentMaterialSnapshot: (cache: MaterialSnapshotCache | undefined, handleRaw: number, assets: RenderAssetPort) => MaterialSnapshotCacheEntry | undefined;
+    readonly readPersistentMaterialSnapshot: (cache: MaterialSnapshotCache | undefined, handleRaw: number, assets: RenderAssetPort) => MaterialSnapshotCacheEntry | undefined;
+    readonly storeMaterialSnapshot: (cache: MaterialSnapshotCache, handleRaw: number, snapshot: MaterialSnapshot, passes: readonly MaterialPass[], root: MaterialAsset, assets: RenderAssetPort) => MaterialSnapshotCacheEntry;
+    readonly runtimeMaterialShaderId: (module: string | undefined, passName?: string) => string | undefined;
+    readonly pipelineRenderState: (renderState: MaterialRenderState | undefined) => MaterialRenderState | undefined;
+    readonly materialColorParameterSchema: (parameters: readonly MaterialParameter[], shaderId: string | undefined, assets: RenderAssetPort) => readonly MaterialColorParameterSchema[];
+    readonly materialNormalScale: (values: Readonly<Record<string, unknown>>) => number;
+    readonly materialParametersToParamSchema: (parameters: readonly MaterialParameter[], shaderId: string | undefined, assets: RenderAssetPort) => readonly ParamSchemaEntry[];
+    readonly collectUserRegionTextureHandles: (values: Readonly<Record<string, unknown>>, shaderId: string | undefined, paramSchema: readonly ParamSchemaEntry[] | undefined, derivedInterface: DerivedMaterialInterface | undefined, assets: RenderAssetPort, world: World, resolveTexture: (value: unknown, brand: 'TextureAsset') => Handle<'TextureAsset', 'shared'> | undefined, videoOut: Map<string, Handle<'VideoAsset', 'shared'>>, paramSchemaProjectionCensus?: ParamSchemaProjectionCensus) => Map<string, Handle<'TextureAsset', 'shared'>>;
+    readonly collectMaterialTextureSamplers: (values: Readonly<Record<string, unknown>>, resolveSampler: (value: unknown) => Handle<'SamplerAsset', 'shared'> | undefined) => Map<string, Handle<'SamplerAsset', 'shared'>>;
+    readonly materialTextureRef: (value: unknown) => unknown;
+    readonly collectMaterialTextureCoordinates: (values: Readonly<Record<string, unknown>>, schema: readonly ParamSchemaEntry[], derivedInterface?: DerivedMaterialInterface, paramSchemaProjectionCensus?: ParamSchemaProjectionCensus) => Map<string, import('@forgeax/engine-types').MaterialTextureCoordinates>;
+    readonly internSharedRefFromGuid: <B extends string>(world: World, assets: RenderAssetPort, guid: string, brand: B) => Handle<B, 'shared'> | undefined;
+}
+export interface MaterialInterfaceOwner {
+    readonly resolveMaterialSnapshot: (handleRaw: number, world: World, assets: RenderAssetPort, gpuStore?: GpuResourceStore, materialSnapshotCache?: MaterialSnapshotCache, persistentMaterialSnapshotCache?: MaterialSnapshotCache, paramSchemaProjectionCensus?: ParamSchemaProjectionCensus) => MaterialSnapshot;
+}
+export declare function resolveMaterialFromPort(root: MaterialAsset, assets: RenderAssetPort, runtimeShaderId?: (module: string | undefined, passName?: string) => string | undefined): Result<MaterialAsset, MaterialError>;
+export declare function materialParametersToParamSchema(parameters: readonly MaterialParameter[]): readonly ParamSchemaEntry[];
+export declare function createMaterialInterfaceOwner(deps: MaterialInterfaceDependencies): MaterialInterfaceOwner;
+//# sourceMappingURL=material-interface.d.ts.map

package/dist/extract/material-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-interface.d.ts","sourceRoot":"","sources":["../../src/extract/material-interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAGjD,OAAO,KAAK,EACV,wBAAwB,EACxB,MAAM,EACN,aAAa,EACb,4BAA4B,EAC5B,iBAAiB,EACjB,YAAY,EAEZ,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAEjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAIL,KAAK,aAAa,EAIlB,KAAK,MAAM,EAIZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,mCAAoC,SAAQ,0BAA0B;IACrF,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,wBAAwB,CAAC;IACpD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,mCAAmC,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAC7B,MAAM,EACN;QAAE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CACvF,CAAC;CACH;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAM5E;AAED,wBAAgB,iCAAiC,CAC/C,kBAAkB,EAAE,SAAS,gBAAgB,EAAE,GAAG,wBAAwB,GACzE,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAKzC;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,kCAAkC,GACxC,MAAM,CAAC,6BAA6B,EAAE,aAAa,CAAC,CAwCtD;AAmBD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,uBAAuB,EAAE,CAAC,cAAc,CAAC,EAAE,MAAM,KAAK,gBAAgB,CAAC;IAChF,QAAQ,CAAC,oCAAoC,EAAE,CAC7C,KAAK,EAAE,qBAAqB,GAAG,SAAS,EACxC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,eAAe,KACpB,0BAA0B,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,8BAA8B,EAAE,CACvC,KAAK,EAAE,qBAAqB,GAAG,SAAS,EACxC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,eAAe,KACpB,0BAA0B,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,qBAAqB,EAAE,CAC9B,KAAK,EAAE,qBAAqB,EAC5B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,eAAe,KACpB,0BAA0B,CAAC;IAChC,QAAQ,CAAC,uBAAuB,EAAE,CAChC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,CAAC,EAAE,MAAM,KACd,MAAM,GAAG,SAAS,CAAC;IACxB,QAAQ,CAAC,mBAAmB,EAAE,CAC5B,WAAW,EAAE,mBAAmB,GAAG,SAAS,KACzC,mBAAmB,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,4BAA4B,EAAE,CACrC,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,eAAe,KACpB,SAAS,4BAA4B,EAAE,CAAC;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,MAAM,CAAC;IACpF,QAAQ,CAAC,+BAA+B,EAAE,CACxC,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,eAAe,KACpB,SAAS,gBAAgB,EAAE,CAAC;IACjC,QAAQ,CAAC,+BAA+B,EAAE,CACxC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,EACpD,gBAAgB,EAAE,wBAAwB,GAAG,SAAS,EACtD,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,KAAK,EACZ,cAAc,EAAE,CACd,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,cAAc,KAClB,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,GAAG,SAAS,EACjD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,EACrD,2BAA2B,CAAC,EAAE,2BAA2B,KACtD,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,8BAA8B,EAAE,CACvC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,GAAG,SAAS,KAC7E,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACzD,QAAQ,CAAC,iCAAiC,EAAE,CAC1C,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,MAAM,EAAE,SAAS,gBAAgB,EAAE,EACnC,gBAAgB,CAAC,EAAE,wBAAwB,EAC3C,2BAA2B,CAAC,EAAE,2BAA2B,KACtD,GAAG,CAAC,MAAM,EAAE,OAAO,uBAAuB,EAAE,0BAA0B,CAAC,CAAC;IAC7E,QAAQ,CAAC,uBAAuB,EAAE,CAAC,CAAC,SAAS,MAAM,EACjD,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,KACL,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,uBAAuB,EAAE,CAChC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,qBAAqB,CAAC,EAAE,qBAAqB,EAC7C,+BAA+B,CAAC,EAAE,qBAAqB,EACvD,2BAA2B,CAAC,EAAE,2BAA2B,KACtD,gBAAgB,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,eAAe,EACvB,eAAe,GAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,SAElE,GACV,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAuCtC;AAqBD,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,SAAS,iBAAiB,EAAE,GACvC,SAAS,gBAAgB,EAAE,CAmB7B;AAiDD,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,6BAA6B,GAClC,sBAAsB,CA4OxB"}

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

@@ -0,0 +1,20 @@
+import type { Camera, DirectionalLight } from '../components';
+export interface RenderExtract {
+    readonly mesh: {
+        readonly assetHandle: unknown;
+    };
+    readonly light: {
+        readonly direction: unknown;
+        readonly intensity: number;
+    };
+    readonly camera: {
+        readonly projection: number;
+        readonly near: number;
+        readonly far: number;
+    };
+}
+/** Project the canonical render component rows without copying or adapting their shape. */
+export declare function readRenderSchemas(mesh: Record<string, unknown>, light: Record<string, unknown>, camera: Record<string, unknown>): RenderExtract;
+export type RenderCameraSchema = typeof Camera;
+export type RenderDirectionalLightSchema = typeof DirectionalLight;
+//# sourceMappingURL=schema-readers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-readers.d.ts","sourceRoot":"","sources":["../../src/extract/schema-readers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/F;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,aAAa,CAUf;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,MAAM,CAAC;AAC/C,MAAM,MAAM,4BAA4B,GAAG,OAAO,gBAAgB,CAAC"}

package/dist/extract/visibility.d.ts

@@ -0,0 +1,26 @@
+import { type EntityHandle, type World } from '@forgeax/engine-ecs';
+import { type SceneHierarchyDiagnostic, type SceneHierarchySnapshot } from '@forgeax/engine-scene';
+import { type VisibilityState } from '../components/visibility';
+export type VisibilitySource = 'default' | 'self' | 'parent';
+export interface VisibilityResolution {
+    /** The component value authored on this entity before inheritance. */
+    readonly intent: VisibilityState;
+    /** The state consumed by render candidates after parent resolution. */
+    readonly effective: 'hidden' | 'visible';
+    /** Explains whether the effective state came from self, parent, or default. */
+    readonly source: VisibilitySource;
+}
+export interface VisibilitySnapshot {
+    readonly diagnostics: readonly SceneHierarchyDiagnostic[];
+    readonly hasAnyIntent: boolean;
+    readonly hasAnyHiddenIntent: boolean;
+    get(entity: EntityHandle): VisibilityResolution | undefined;
+    /** Resolve effective visibility for a render candidate, including inherited defaults. */
+    effective(entity: EntityHandle): 'hidden' | 'visible';
+}
+/**
+ * Resolve author intent against the scene-owned valid parent projection.
+ * Diagnostics are preserved for callers to repair hierarchy input before retry.
+ */
+export declare function resolveVisibility(world: World, hierarchy?: SceneHierarchySnapshot): VisibilitySnapshot;
+//# sourceMappingURL=visibility.d.ts.map

package/dist/extract/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../src/extract/visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,eAAe,EAGrB,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,SAAS,CAAC;IACzC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC1D,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,oBAAoB,GAAG,SAAS,CAAC;IAC5D,yFAAyF;IACzF,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;CACvD;AAQD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,EACZ,SAAS,GAAE,sBAAgD,GAC1D,kBAAkB,CAyEpB"}

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

@@ -0,0 +1,64 @@
+import type { PassDescriptor, RenderGraph, ResolveContext, ResourceDescriptor } from '@forgeax/engine-render-graph';
+import { type Result } from '@forgeax/engine-types';
+import { type RenderError } from '../errors/render';
+import type { PreparedGraphicsResolvedSnapshot } from '../prepare/prepared-graphics-resolver';
+import type { RenderFeatureGpuComputePassDescriptor, RenderFeatureResolvedGpuComputePass } from './prepared-gpu-work';
+import type { RenderFeatureGraphicsContributionStaging, RenderFeatureGraphicsPassDescriptor, RenderFeaturePreparedGraphicsState } from './prepared-graphics';
+import type { RenderFeaturePassContext } from './types';
+export interface RenderFeaturePassDependency {
+    readonly featureIdentity: string;
+    readonly passIdentity: string;
+}
+export interface RenderFeaturePassOptions {
+    readonly dependsOn?: readonly RenderFeaturePassDependency[];
+}
+export interface RenderFeatureContributionResource {
+    readonly name: string;
+    readonly descriptor: ResourceDescriptor;
+}
+export interface RenderFeatureContributionPass<Ctx = RenderFeaturePassContext> {
+    readonly featureIdentity: string;
+    readonly order: number;
+    readonly name: string;
+    readonly descriptor: PassDescriptor<Ctx>;
+    readonly dependsOn: readonly string[];
+    readonly graphics?: RenderFeatureGraphicsPassDescriptor;
+    readonly graphicsState?: RenderFeaturePreparedGraphicsState;
+    readonly resolvedGraphics?: PreparedGraphicsResolvedSnapshot;
+    readonly gpuCompute?: RenderFeatureGpuComputePassDescriptor;
+    readonly resolvedGpuCompute?: RenderFeatureResolvedGpuComputePass;
+}
+export interface RenderFeatureGraphContribution<Ctx = RenderFeaturePassContext> {
+    readonly featureIdentity: string;
+    readonly order: number;
+    readonly resources: readonly RenderFeatureContributionResource[];
+    readonly passes: readonly RenderFeatureContributionPass<Ctx>[];
+    readonly topologySignature: string;
+}
+export interface RenderFeatureContributionStaging<Ctx = RenderFeaturePassContext> extends RenderFeatureGraphicsContributionStaging {
+    readonly resources: readonly RenderFeatureContributionResource[];
+    readonly passes: readonly RenderFeatureContributionPass<Ctx>[];
+    addResource(name: string, descriptor: ResourceDescriptor): Result<void, RenderError>;
+    addPass(name: string, descriptor: PassDescriptor<Ctx>, options?: RenderFeaturePassOptions): Result<void, RenderError>;
+    addComputePass(name: string, descriptor: RenderFeatureGpuComputePassDescriptor, options?: RenderFeaturePassOptions): Result<void, RenderError>;
+    commit(): Result<RenderFeatureGraphContribution<Ctx>, RenderError>;
+    abort(): void;
+}
+export type RenderFeatureGraphicsValidator = (descriptor: RenderFeatureGraphicsPassDescriptor, resources: readonly RenderFeatureContributionResource[]) => Result<RenderFeaturePreparedGraphicsState, RenderError>;
+export type RenderFeatureGraphicsResolver = (descriptor: RenderFeatureGraphicsPassDescriptor) => Result<PreparedGraphicsResolvedSnapshot, RenderError>;
+export type RenderFeatureGpuComputeResolver = (descriptor: RenderFeatureGpuComputePassDescriptor) => Result<RenderFeatureResolvedGpuComputePass, RenderError>;
+export declare function createRenderFeatureContributionStaging<Ctx = RenderFeaturePassContext>(featureIdentity: string, order: number, validateGraphics?: RenderFeatureGraphicsValidator, resolveGraphics?: RenderFeatureGraphicsResolver, resolveGpuCompute?: RenderFeatureGpuComputeResolver): RenderFeatureContributionStaging<Ctx>;
+export declare function mergeRenderFeatureContributions<Ctx>(contributions: readonly RenderFeatureGraphContribution<Ctx>[]): Result<RenderFeatureGraphContribution<Ctx>, RenderError>;
+export interface RenderFeatureGraphComposition<GraphCtx = unknown, FeatureCtx = RenderFeaturePassContext> {
+    readonly graph: RenderGraph<GraphCtx>;
+    readonly topologySignature: string;
+    readonly passNames: readonly string[];
+    readonly executeCount: number;
+    update(contributions: readonly RenderFeatureGraphContribution<FeatureCtx>[]): {
+        readonly topologyChanged: boolean;
+    };
+}
+export type RenderFeatureGraphPassProjector<GraphCtx, FeatureCtx> = (context: GraphCtx, pass: RenderFeatureContributionPass<FeatureCtx>, resolveContext: ResolveContext, execute: (context: FeatureCtx) => void) => void;
+export type RenderFeatureGraphErrorReporter = (featureIdentity: string, order: number, failure: unknown) => void;
+export declare function composeRenderFeatureGraph<GraphCtx, FeatureCtx = RenderFeaturePassContext>(graph: RenderGraph<GraphCtx>, contributions: readonly RenderFeatureGraphContribution<FeatureCtx>[], project?: RenderFeatureGraphPassProjector<GraphCtx, FeatureCtx>, reportError?: RenderFeatureGraphErrorReporter): Result<RenderFeatureGraphComposition<GraphCtx, FeatureCtx>, RenderError>;
+//# sourceMappingURL=graph-contribution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-contribution.d.ts","sourceRoot":"","sources":["../../src/features/graph-contribution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACd,WAAW,EACX,cAAc,EACd,kBAAkB,EACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,KAAK,WAAW,EAKjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AAC9F,OAAO,KAAK,EACV,qCAAqC,EACrC,mCAAmC,EACpC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EACV,wCAAwC,EACxC,mCAAmC,EACnC,kCAAkC,EACnC,MAAM,qBAAqB,CAAC;AAM7B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC7D;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACzC;AAED,MAAM,WAAW,6BAA6B,CAAC,GAAG,GAAG,wBAAwB;IAC3E,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,mCAAmC,CAAC;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,kCAAkC,CAAC;IAC5D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gCAAgC,CAAC;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,qCAAqC,CAAC;IAC5D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,mCAAmC,CAAC;CACnE;AAED,MAAM,WAAW,8BAA8B,CAAC,GAAG,GAAG,wBAAwB;IAC5E,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,iCAAiC,EAAE,CAAC;IACjE,QAAQ,CAAC,MAAM,EAAE,SAAS,6BAA6B,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,gCAAgC,CAAC,GAAG,GAAG,wBAAwB,CAC9E,SAAQ,wCAAwC;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,iCAAiC,EAAE,CAAC;IACjE,QAAQ,CAAC,MAAM,EAAE,SAAS,6BAA6B,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrF,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,EAC/B,OAAO,CAAC,EAAE,wBAAwB,GACjC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC7B,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,qCAAqC,EACjD,OAAO,CAAC,EAAE,wBAAwB,GACjC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC7B,MAAM,IAAI,MAAM,CAAC,8BAA8B,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC;IACnE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,MAAM,8BAA8B,GAAG,CAC3C,UAAU,EAAE,mCAAmC,EAC/C,SAAS,EAAE,SAAS,iCAAiC,EAAE,KACpD,MAAM,CAAC,kCAAkC,EAAE,WAAW,CAAC,CAAC;AAE7D,MAAM,MAAM,6BAA6B,GAAG,CAC1C,UAAU,EAAE,mCAAmC,KAC5C,MAAM,CAAC,gCAAgC,EAAE,WAAW,CAAC,CAAC;AAE3D,MAAM,MAAM,+BAA+B,GAAG,CAC5C,UAAU,EAAE,qCAAqC,KAC9C,MAAM,CAAC,mCAAmC,EAAE,WAAW,CAAC,CAAC;AA+O9D,wBAAgB,sCAAsC,CAAC,GAAG,GAAG,wBAAwB,EACnF,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EACb,gBAAgB,CAAC,EAAE,8BAA8B,EACjD,eAAe,CAAC,EAAE,6BAA6B,EAC/C,iBAAiB,CAAC,EAAE,+BAA+B,GAClD,gCAAgC,CAAC,GAAG,CAAC,CAQvC;AAED,wBAAgB,+BAA+B,CAAC,GAAG,EACjD,aAAa,EAAE,SAAS,8BAA8B,CAAC,GAAG,CAAC,EAAE,GAC5D,MAAM,CAAC,8BAA8B,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,CA2C1D;AAED,MAAM,WAAW,6BAA6B,CAC5C,QAAQ,GAAG,OAAO,EAClB,UAAU,GAAG,wBAAwB;IAErC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,MAAM,CAAC,aAAa,EAAE,SAAS,8BAA8B,CAAC,UAAU,CAAC,EAAE,GAAG;QAC5E,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;KACnC,CAAC;CACH;AASD,MAAM,MAAM,+BAA+B,CAAC,QAAQ,EAAE,UAAU,IAAI,CAClE,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,6BAA6B,CAAC,UAAU,CAAC,EAC/C,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,KACnC,IAAI,CAAC;AAEV,MAAM,MAAM,+BAA+B,GAAG,CAC5C,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,KACb,IAAI,CAAC;AAEV,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,UAAU,GAAG,wBAAwB,EACvF,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,EAC5B,aAAa,EAAE,SAAS,8BAA8B,CAAC,UAAU,CAAC,EAAE,EACpE,OAAO,GAAE,+BAA+B,CAAC,QAAQ,EAAE,UAAU,CAKf,EAC9C,WAAW,CAAC,EAAE,+BAA+B,GAC5C,MAAM,CAAC,6BAA6B,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,WAAW,CAAC,CAqI1E"}

package/dist/features/host.d.ts

@@ -0,0 +1,100 @@
+import type { RhiCaps } from '@forgeax/engine-rhi';
+import { type MaterialAsset, type MaterialError, type Result } from '@forgeax/engine-types';
+import { type RenderError } from '../errors/render';
+import type { PreparedGraphicsResolver, PreparedGraphicsResourceLease } from '../prepare/prepared-graphics-resolver';
+import type { RenderFeatureContributionStaging, RenderFeatureGpuComputeResolver, RenderFeatureGraphContribution, RenderFeatureGraphicsValidator } from './graph-contribution';
+import type { RenderFeatureGpuWorkResolver } from './prepared-gpu-work';
+import { type RenderFeatureGraphicsContributionStaging, type RenderFeatureMaterialShaderBindingContract } from './prepared-graphics';
+import { type PreparedGraphicsTransaction } from './prepared-graphics-store';
+import type { RenderFeature, RenderFeatureDiagnostics, RenderFeatureErrorDescriptor, RenderFeatureHiddenEntityReport, RenderFeatureRecoverInput, RenderFeatureResourceHandle, RenderFeatureStatus, RenderFeatureTargetHandle, RenderFeatureWorldVisibilitySnapshot } from './types';
+export interface RenderFeatureStageEvent {
+    readonly featureIdentity: string;
+    readonly order: number;
+    readonly stage: 'extract' | 'prepare' | 'contribute';
+}
+export interface RenderFeatureFrameInput {
+    readonly worlds: readonly import('@forgeax/engine-ecs').World[];
+    readonly owner: number;
+    readonly frameNumber: number;
+    readonly visibilitySnapshots?: readonly RenderFeatureWorldVisibilitySnapshot[];
+    readonly hiddenEntityReports?: readonly RenderFeatureHiddenEntityReport[];
+    /** Active-pipeline logical targets available to producer-owned features. */
+    readonly targets?: readonly RenderFeatureTargetHandle[];
+    readonly generation?: number;
+    readonly caps: Readonly<RhiCaps>;
+    readonly createContributionStaging?: (featureIdentity: string, order: number, validateGraphics?: RenderFeatureGraphicsValidator, resolveGraphics?: import('./graph-contribution').RenderFeatureGraphicsResolver, resolveGpuCompute?: RenderFeatureGpuComputeResolver) => RenderFeatureContributionStaging & RenderFeatureGraphicsContributionStaging;
+    readonly createPreparedGraphicsResolver?: (input: RenderFeaturePreparedGraphicsResolverInput) => PreparedGraphicsResolver;
+    readonly getMaterialShaderBindingContract?: (materialShaderId: string) => RenderFeatureMaterialShaderBindingContract;
+    /** Render-owned cooked material projection used by prepared graphics. */
+    readonly resolveMaterialAsset?: (material: MaterialAsset) => Result<MaterialAsset, MaterialError>;
+    readonly getGpuWorkResolver?: (featureIdentity: string) => RenderFeatureGpuWorkResolver;
+}
+export interface RenderFeaturePreparedGraphicsResolverInput {
+    readonly featureIdentity: string;
+    readonly order: number;
+    readonly generation: number;
+    readonly transaction: PreparedGraphicsTransaction;
+    readonly lookup: (reference: import('./prepared-graphics').RenderFeaturePreparedRef) => import('./prepared-graphics-store').PreparedGraphicsItem | undefined;
+}
+export interface RenderFeatureFrameResult {
+    readonly events: readonly string[];
+    readonly stageEvents: readonly RenderFeatureStageEvent[];
+    readonly errors: readonly RenderError[];
+    readonly contributions: readonly RenderFeatureGraphContribution[];
+    readonly preparedResourceBatches: readonly RenderFeaturePreparedResourceBatch[];
+    readonly hiddenEntityReports: readonly RenderFeatureHiddenEntityReport[];
+}
+export interface RenderFeatureOwnedResource {
+    readonly handle: RenderFeatureResourceHandle;
+    readonly release: () => Result<void, RenderError>;
+}
+export interface RenderFeatureHost {
+    readonly size: number;
+    readonly features: readonly RenderFeature<unknown>[];
+    readonly preparedGeneration: number;
+    /** Install a producer after renderer creation; same object identity is idempotent. */
+    install(feature: RenderFeature<unknown>): Result<void, RenderError>;
+    /** Remove one installed producer and release every resource it owns. */
+    uninstall(feature: RenderFeature<unknown>): Result<void, RenderError>;
+    advancePreparedGeneration(): number;
+    registerResource(identity: string, resource: RenderFeatureOwnedResource): Result<void, RenderError>;
+    setStatus(identity: string, status: RenderFeatureStatus, latestError?: RenderFeatureErrorDescriptor): Result<void, RenderError>;
+    /** Record a failure from active-graph execution against its owning slot. */
+    recordError(identity: string, error: RenderError): RenderError;
+    beginPreparedFrame(identity: string, generation: number): PreparedGraphicsTransaction | undefined;
+    retainPreparedGraphics(identity: string, leases: readonly PreparedGraphicsResourceLease[]): Result<RenderFeaturePreparedResourceBatch, RenderError>;
+    /** Mark batches used by the just-recorded frame as protected by queue work. */
+    markPreparedGraphicsSubmitted(batches: readonly RenderFeaturePreparedResourceBatch[]): void;
+    /** Release completed batches, or all batches that were never submitted. */
+    retirePreparedGraphics(batches?: readonly RenderFeaturePreparedResourceBatch[]): Result<void, RenderError>;
+    /** Release submitted batches when queue completion rejects and cannot prove completion. */
+    recoverPreparedGraphics(batches: readonly RenderFeaturePreparedResourceBatch[]): Result<void, RenderError>;
+    recover(input: RenderFeatureRecoverInput): Result<void, RenderError>;
+    diagnostics(): readonly RenderFeatureDiagnostics[];
+    /** Subscribe to lifecycle projection changes; unchanged active frames are silent. */
+    subscribeDiagnostics(listener: () => void): () => void;
+    dispose(): Result<void, RenderError>;
+}
+export interface RenderFeaturePreparedResourceBatch {
+    release(): Result<void, RenderError>;
+}
+/**
+ * Resolve a submitted batch from queue completion without conflating promise
+ * rejection with retirement failures. Rejection is treated as lost completion
+ * evidence, so the host releases only batches still marked submitted.
+ */
+export declare function settlePreparedGraphicsCompletion(host: RenderFeatureHost, batches: readonly RenderFeaturePreparedResourceBatch[], completion: PromiseLike<unknown>, onError: (error: unknown) => void): void;
+/**
+ * Run the three typed stages once for every active feature.
+ *
+ * The feature value is kept in the slot closure: no heterogeneous FrameData
+ * ledger or assertion is needed between callbacks. A failure ends only the
+ * current slot and is retained in the host diagnostics projection.
+ */
+export declare function runRenderFeatureFrame(host: RenderFeatureHost, input: RenderFeatureFrameInput): RenderFeatureFrameResult;
+/**
+ * Validate identities before creating typed slots or accepting resources.
+ * Registration order is the input order and is never sorted by feature kind.
+ */
+export declare function createRenderFeatureHost(features: readonly RenderFeature<unknown>[], _caps?: Readonly<RhiCaps>): Result<RenderFeatureHost, RenderError>;
+//# sourceMappingURL=host.d.ts.map

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

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

package/dist/features/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Public RenderFeature index. The three modules are the machine-readable
+ * declaration route: graph contribution, prepared graphics, and lifecycle
+ * types. Host construction remains outside this barrel.
+ */
+export type { RenderFeatureContributionPass, RenderFeatureContributionResource, RenderFeatureContributionStaging, RenderFeatureGraphComposition, RenderFeatureGraphContribution, RenderFeaturePassDependency, RenderFeaturePassOptions, } from './graph-contribution';
+export { createRenderFeatureContributionStaging } from './graph-contribution';
+export * from './morph';
+export type { RenderFeatureGpuBindingsDescriptor, RenderFeatureGpuBindingsRef, RenderFeatureGpuBufferDescriptor, RenderFeatureGpuBufferRef, RenderFeatureGpuBufferUsage, RenderFeatureGpuComputePassDescriptor, RenderFeatureGpuDispatch, RenderFeatureGpuPrepare, RenderFeatureGpuProgramDescriptor, RenderFeatureGpuProgramRef, } from './prepared-gpu-work';
+export { createRenderFeatureGpuWorkResolver } from './prepared-gpu-work';
+export type { PreparedKind, RenderFeatureBindingsDescriptor, RenderFeatureColorAttachment, RenderFeatureDepthStencilAttachment, RenderFeatureDrawCommand, RenderFeatureDrawRecord, RenderFeatureGraphicsContributionStaging, RenderFeatureGraphicsPassAttachments, RenderFeatureGraphicsPassDescriptor, RenderFeatureGraphicsPrepare, RenderFeatureIndexDataBinding, RenderFeatureIndexDataDescriptor, RenderFeatureIndexedDrawCommand, RenderFeatureMaterialShaderBindingContract, RenderFeaturePipelineDescriptor, RenderFeaturePreparedGraphicsState, RenderFeaturePreparedRef, RenderFeatureValidatedGraphicsPass, RenderFeatureVertexDataBinding, RenderFeatureVertexDataDescriptor, } from './prepared-graphics';
+export { RENDER_FEATURE_VERTEX_LAYOUTS } from './prepared-graphics';
+export { RenderFeatureComputeGraphProjection } from './render-graph-compute';
+export { projectRenderFeatureContributions, type RenderFeatureTypedGraphProjection, } from './render-graph-contribution';
+export { type RenderFeatureGraphBindingsResolver, type RenderFeatureGraphTarget, type RenderFeatureGraphTargetResolver, RenderFeatureRasterGraphProjection, } from './render-graph-raster';
+export { RenderFeatureGraphBufferRegistry } from './render-graph-resources';
+export { SCENE_TEMPORAL_CLEAR_VALUE, SCENE_TEMPORAL_PACKED_ABI, SCENE_TEMPORAL_TARGET_FORMAT, SCENE_TEMPORAL_TARGET_SAMPLE_COUNT, } from './scene-temporal';
+export type { RenderFeatureTargetHandle, RenderFeatureTargetInput, RenderFeatureTargetKind, } from './targets';
+export { createRenderFeatureTarget, isRenderFeatureTargetHandle, renderFeatureAttachmentResource, } from './targets';
+export type { RenderFeature, RenderFeatureCapabilityKey, RenderFeatureContributeContext, RenderFeatureDiagnostics, RenderFeatureErrorCode, RenderFeatureErrorDescriptor, RenderFeatureErrorSink, RenderFeatureExtractContext, RenderFeatureFrameIdentity, RenderFeatureHiddenEntityReport, RenderFeaturePassContext, RenderFeaturePrepareContext, RenderFeatureRecoverInput, RenderFeatureRecovery, RenderFeatureResourceHandle, RenderFeatureStage, RenderFeatureStatus, RenderFeatureWorldVisibilitySnapshot, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,YAAY,EACV,6BAA6B,EAC7B,iCAAiC,EACjC,gCAAgC,EAChC,6BAA6B,EAC7B,8BAA8B,EAC9B,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sCAAsC,EAAE,MAAM,sBAAsB,CAAC;AAC9E,cAAc,SAAS,CAAC;AACxB,YAAY,EACV,kCAAkC,EAClC,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,EACzB,2BAA2B,EAC3B,qCAAqC,EACrC,wBAAwB,EACxB,uBAAuB,EACvB,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC;AACzE,YAAY,EACV,YAAY,EACZ,+BAA+B,EAC/B,4BAA4B,EAC5B,mCAAmC,EACnC,wBAAwB,EACxB,uBAAuB,EACvB,wCAAwC,EACxC,oCAAoC,EACpC,mCAAmC,EACnC,4BAA4B,EAC5B,6BAA6B,EAC7B,gCAAgC,EAChC,+BAA+B,EAC/B,0CAA0C,EAC1C,+BAA+B,EAC/B,kCAAkC,EAClC,wBAAwB,EACxB,kCAAkC,EAClC,8BAA8B,EAC9B,iCAAiC,GAClC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,mCAAmC,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EACL,iCAAiC,EACjC,KAAK,iCAAiC,GACvC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,kCAAkC,EACvC,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,EACrC,kCAAkC,GACnC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,4BAA4B,EAC5B,kCAAkC,GACnC,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,aAAa,EACb,0BAA0B,EAC1B,8BAA8B,EAC9B,wBAAwB,EACxB,sBAAsB,EACtB,4BAA4B,EAC5B,sBAAsB,EACtB,2BAA2B,EAC3B,0BAA0B,EAC1B,+BAA+B,EAC/B,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,kBAAkB,EAClB,mBAAmB,EACnB,oCAAoC,GACrC,MAAM,SAAS,CAAC"}

package/dist/features/morph/index.d.ts

@@ -0,0 +1,3 @@
+export { createMorphReentryState, deriveMorphBounds, MORPH_MAX_TARGETS, type MorphBounds, type MorphCullDecision, type MorphCullInput, type MorphReentryInput, type MorphReentryResult, type MorphReentryState, type MorphTargetBounds, type MorphVec3, morphCullDecision, stepMorphReentry, } from './morph-bounds';
+export { createMorphFeature, MORPH_COMPUTE_WGSL, type MorphFeatureCollectContext, type MorphFeatureDraw, type MorphFeatureFrame, type MorphFeatureOptions, type MorphFeatureRenderable, } from './morph-feature';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/morph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/morph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC"}

package/dist/features/morph/morph-bounds.d.ts

@@ -0,0 +1,42 @@
+export declare const MORPH_MAX_TARGETS = 8;
+export type MorphVec3 = readonly [number, number, number];
+export interface MorphBounds {
+    readonly min: MorphVec3;
+    readonly max: MorphVec3;
+}
+export interface MorphTargetBounds {
+    readonly min: MorphVec3;
+    readonly max: MorphVec3;
+}
+export interface MorphCullInput {
+    readonly weights?: ArrayLike<number>;
+    readonly expectedWeightCount: number;
+    readonly baseAabbIntersectsFrustum: boolean;
+}
+export type MorphCullDecision = 'draw' | 'cull';
+/** Compute a conservative AABB from base bounds and target delta bounds. */
+export declare function deriveMorphBounds(base: MorphBounds, targets: readonly MorphTargetBounds[], weights: ArrayLike<number>): MorphBounds;
+/** Keep non-zero valid morphs drawable even when their base AABB is outside. */
+export declare function morphCullDecision(input: MorphCullInput): MorphCullDecision;
+export interface MorphReentryState {
+    seen: boolean;
+    visible: boolean;
+    generation: number;
+    weights: Float32Array | undefined;
+}
+export interface MorphReentryInput {
+    readonly frameNumber: number;
+    readonly visible: boolean;
+    readonly generation: number;
+    readonly weights: ArrayLike<number>;
+}
+export interface MorphReentryResult {
+    readonly frameNumber: number;
+    readonly reentered: boolean;
+    readonly clearStale: boolean;
+    readonly weights: readonly number[];
+}
+export declare function createMorphReentryState(): MorphReentryState;
+/** Track visibility transitions so a re-entry always rewrites the current weights. */
+export declare function stepMorphReentry(state: MorphReentryState, input: MorphReentryInput): MorphReentryResult;
+//# sourceMappingURL=morph-bounds.d.ts.map

package/dist/features/morph/morph-bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"morph-bounds.d.ts","sourceRoot":"","sources":["../../../src/features/morph/morph-bounds.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAC;CAC7C;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;AAchD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,GACzB,WAAW,CA2Bb;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,CAS1E;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,iBAAiB,GACvB,kBAAkB,CAapB"}

package/dist/features/morph/morph-feature.d.ts

@@ -0,0 +1,45 @@
+import type { World } from '@forgeax/engine-ecs';
+import type { RenderFeatureGpuBufferRef } from '../prepared-gpu-work';
+import type { RenderFeature } from '../types';
+import { type MorphBounds, type MorphTargetBounds } from './morph-bounds';
+export declare const MORPH_COMPUTE_WGSL = "\nstruct MorphWeights { values: array<f32, 8> };\n@group(0) @binding(0) var<storage, read> source: array<vec4<f32>>;\n@group(0) @binding(1) var<storage, read_write> output: array<vec4<f32>>;\n@group(0) @binding(2) var<uniform> weights: MorphWeights;\n\n@compute @workgroup_size(64)\nfn morph_main(@builtin(global_invocation_id) id: vec3<u32>) {\n  let vertex = id.x;\n  let vertex_count = arrayLength(&output);\n  if (vertex >= vertex_count) { return; }\n  var position = source[vertex];\n  for (var target_index = 0u; target_index < 8u; target_index = target_index + 1u) {\n    position = position + source[(target_index + 1u) * vertex_count + vertex] * weights.values[target_index];\n  }\n  output[vertex] = position;\n}\n";
+export interface MorphFeatureRenderable {
+    readonly identity: string;
+    readonly vertexCount: number;
+    readonly baseBounds: MorphBounds;
+    readonly targetBounds: readonly MorphTargetBounds[];
+    readonly weights: ArrayLike<number>;
+    readonly baseAabbIntersectsFrustum: boolean;
+    readonly basePositions?: ArrayLike<number>;
+    readonly targetDeltas?: ArrayLike<number>;
+}
+export interface MorphFeatureCollectContext {
+    readonly worlds: readonly World[];
+    readonly frameNumber: number;
+}
+export interface MorphFeatureOptions {
+    readonly collect: (context: MorphFeatureCollectContext) => readonly MorphFeatureRenderable[];
+}
+export interface MorphFeatureDraw {
+    readonly identity: string;
+    readonly vertexCount: number;
+    readonly targetCount: number;
+    readonly bounds: MorphBounds;
+    readonly weights: Float32Array;
+    readonly reentered: boolean;
+    readonly clearStale: boolean;
+    readonly source: Float32Array;
+}
+export interface MorphFeatureFrame {
+    readonly frameNumber: number;
+    readonly draws: readonly MorphFeatureDraw[];
+    readonly culledCount: number;
+    readonly zeroWeightCount: number;
+    readonly reentryCount: number;
+}
+export interface MorphFeature extends RenderFeature<MorphFeatureFrame> {
+    /** Resolve the current output buffer for an evidence readback or downstream draw. */
+    preparedOutput(identity: string): RenderFeatureGpuBufferRef | undefined;
+}
+export declare function createMorphFeature(options: MorphFeatureOptions): MorphFeature;
+//# sourceMappingURL=morph-feature.d.ts.map