@forgeax/engine-render 0.1.19 → 0.1.21

package/dist/assembly/device-feature-admission.d.ts

@@ -0,0 +1,18 @@
+import type { RhiAdapter, RhiDevice } from '@forgeax/engine-rhi';
+export declare const STANDARD_PBR_REQUIRED_SAMPLED_TEXTURES = 17;
+export interface DeviceFeatureAdmissionOptions {
+    readonly gpuPassTiming?: object | undefined;
+    readonly captureGpuTimings?: boolean | undefined;
+}
+export interface DeviceFeatureAdmission {
+    readonly requiredFeatures: GPUFeatureName[];
+    readonly requiredLimits?: {
+        readonly maxSampledTexturesPerShaderStage: number;
+    };
+}
+type AdapterFeatureProbe = Pick<RhiAdapter, 'features'> & Partial<Pick<RhiAdapter, 'limits'>>;
+export declare function deriveDeviceFeatureAdmission(adapter: AdapterFeatureProbe, options?: DeviceFeatureAdmissionOptions): DeviceFeatureAdmission;
+export declare function deviceOptionsForAdapter(adapter: AdapterFeatureProbe, options?: DeviceFeatureAdmissionOptions): DeviceFeatureAdmission | undefined;
+export declare function isTimestampQueryAdmitted(caps: Pick<RhiDevice['caps'], 'timestampQuery' | 'timestampPeriodNanoseconds'>): boolean;
+export {};
+//# sourceMappingURL=device-feature-admission.d.ts.map

package/dist/assembly/device-feature-admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-feature-admission.d.ts","sourceRoot":"","sources":["../../src/assembly/device-feature-admission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAYjE,eAAO,MAAM,sCAAsC,KAAK,CAAC;AAEzD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE;QACxB,QAAQ,CAAC,gCAAgC,EAAE,MAAM,CAAC;KACnD,CAAC;CACH;AAED,KAAK,mBAAmB,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE9F,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,6BAA6B,GACtC,sBAAsB,CAoBxB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,6BAA6B,GACtC,sBAAsB,GAAG,SAAS,CAKpC;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,4BAA4B,CAAC,GAC7E,OAAO,CAOT"}

package/dist/assembly/directional-shadow-inspection.d.ts

@@ -0,0 +1,38 @@
+import type { DirectionalShadowQuality } from '../components/directional-shadow-filter';
+import type { DirectionalShadowInspection, DirectionalShadowInspectionError, DirectionalShadowProfile } from '../inspection-types';
+import type { DirectionalShadowBackendAdmission } from '../render-pipeline';
+export interface DirectionalShadowInspectionSource {
+    readonly requested: DirectionalShadowProfile;
+    readonly candidate: 'accepted' | 'failed';
+    readonly lastKnownGood?: DirectionalShadowProfile | undefined;
+    readonly cascadeCount: number;
+    readonly mapSize: number;
+    readonly atlasBytes: number;
+    readonly writerPasses: number;
+    readonly shadowAngularRadius?: number | undefined;
+    readonly maxPenumbraTexels?: number | undefined;
+    readonly deviceGeneration: number;
+    readonly graphGeneration: number;
+    readonly shadowReady: boolean;
+    readonly error?: DirectionalShadowInspectionError | undefined;
+}
+export interface DirectionalShadowInspectionInput {
+    readonly admission: DirectionalShadowBackendAdmission;
+    readonly cascadeCount: number;
+    readonly mapSize: number;
+    readonly atlasBytes: number;
+    readonly writerPasses: number;
+    readonly blockerTaps: number;
+    readonly filterTapUpperBound: number;
+    readonly seamTapUpperBound: number;
+    readonly shadowAngularRadius?: number | undefined;
+    readonly maxPenumbraTexels?: number | undefined;
+    readonly deviceGeneration: number;
+    readonly graphGeneration: number;
+    readonly error?: DirectionalShadowInspectionError | undefined;
+}
+/** Project the single bounded Directional inspection POD; no live handles leak. */
+export declare function projectDirectionalShadowInspection(input: DirectionalShadowInspectionInput): DirectionalShadowInspection;
+export declare function directionalShadowProfileFromQuality(quality: DirectionalShadowQuality | undefined): DirectionalShadowProfile;
+export declare function projectDirectionalShadowInspectionSource(input: DirectionalShadowInspectionSource): DirectionalShadowInspection;
+//# sourceMappingURL=directional-shadow-inspection.d.ts.map

package/dist/assembly/directional-shadow-inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directional-shadow-inspection.d.ts","sourceRoot":"","sources":["../../src/assembly/directional-shadow-inspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACxF,OAAO,KAAK,EACV,2BAA2B,EAC3B,gCAAgC,EAChC,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC;AAE5E,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAC9D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,gCAAgC,GAAG,SAAS,CAAC;CAC/D;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,SAAS,EAAE,iCAAiC,CAAC;IACtD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,gCAAgC,GAAG,SAAS,CAAC;CAC/D;AAWD,mFAAmF;AACnF,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,gCAAgC,GACtC,2BAA2B,CAwB7B;AAED,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,wBAAwB,GAAG,SAAS,GAC5C,wBAAwB,CAI1B;AAED,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,iCAAiC,GACvC,2BAA2B,CAiC7B"}

package/dist/assembly/factory.d.ts

@@ -1,7 +1,7 @@
 import { MeshSsboCapacityExceededError, MeshSsboCeilingReachedError } from '@forgeax/engine-assets-runtime';
 import type { Buffer, PipelineLayout, RhiDevice } from '@forgeax/engine-rhi';
 import { type MaterialShaderManifestEntry } from '@forgeax/engine-shader';
-import type { ImportTransport } from '@forgeax/engine-types';
+import type { ImportTransport, ParamSchemaEntry } from '@forgeax/engine-types';
 export type { MaterialShaderManifestEntry } from '@forgeax/engine-shader';
 import type { RenderFeatureMaterialShaderBindingContract } from '../features/plan';
 import type { Renderer, RendererOptions } from '../render-contract';
@@ -42,18 +42,14 @@ export interface BundlerOptions {
 /**
  * Per-variant PipelineLayout selector (M4.5 / D-10 option A).
  *
- * The HDRP variant (`CLUSTER_FORWARD_AVAILABLE=true` or canonical `''`
- * all-true when the shader declares the cluster axis) needs the 7-slot
- * group(2) BGL chain (`hdrpPbrPipelineLayout`); URP variants
- * (`CLUSTER_FORWARD_AVAILABLE=false` / undefined / no axis) keep the
- * 1-slot mesh-array BGL chain (`pbrPipelineLayout`).
+ * The resolved HDRP group(2) contract needs the 7-slot BGL chain
+ * (`hdrpPbrPipelineLayout`); ordinary material contracts keep the 1-slot
+ * mesh-array BGL chain (`pbrPipelineLayout`). Variant keys select source
+ * artifacts only and never override this contract.
  *
- * Returns `null` only when the URP fallback layout itself is null
- * (Camera-only / empty-manifest path). When the HDRP layout is null but
- * URP exists, the HDRP variant gracefully falls back to URP — the WGSL
- * resolved upstream by `findVariantByKey` is the URP variant in that
- * case (manifest entry with all-true definesKey === '' was registered
- * with isHdrpActive=false at boot when storage-buffer caps are absent).
+ * Returns `null` when the selected layout is unavailable. An HDRP variant
+ * never falls back to the URP layout: its clustered WGSL and group(2) ABI
+ * must be admitted together or the draw fails closed.
  *
  * Pure function — exported for unit-test access (M4.5 / w35).
  */
@@ -61,8 +57,9 @@ export interface BundlerOptions {
  * Closed enum of pipeline-layout kinds the selector can dispatch to.
  *
  * `pbr` — standard PBR (1-entry mesh-array BGL).
- * `pbr-skin` — bug-20260611-skin-pipeline-layout: 2-entry mesh-array BGL
- *   (binding 0 meshes + binding 1 palette) for the `forgeax::pbr-skin`
+ * `pbr-skin` — bug-20260611-skin-pipeline-layout: 3-entry mesh-array BGL
+ *   (binding 0 meshes + binding 1 current palette + binding 2 previous
+ *   palette) for the `forgeax::pbr-skin`
  *   material shader.
  * `hdrp-pbr` — feat-20260609 HDRP cluster-forward variant (7-slot group(2)
  *   BGL substituted at slot 2).
@@ -82,7 +79,10 @@ export interface BundlerOptions {
  * material-shader layouts add a `LayoutKind` member + a PipelineState slot
  * + a switch arm here in one cut (charter P3 extensibility).
  */
-export type LayoutKind = 'pbr' | 'pbr-skin' | 'hdrp-pbr' | 'sprite-urp' | 'unlit-urp';
+export type LayoutKind = 'pbr' | 'pbr-skin' | 'hdrp-pbr' | 'hdrp-skin' | 'sprite-urp' | 'unlit-urp';
+/** The closed group(2) contract resolved from the selected WGSL artifact. */
+export type { PipelineGroup2Contract } from '../pbr-pipeline';
+export { resolvePipelineGroup2Contract } from '../pbr-pipeline';
 /**
  * Return every device-capability HDRP PBR variant that needs a lazy module
  * label seeded during renderer boot. Color availability is intentionally not
@@ -90,23 +90,36 @@ export type LayoutKind = 'pbr' | 'pbr-skin' | 'hdrp-pbr' | 'sprite-urp' | 'unlit
  * Transmission is filtered by the same sampled-texture capability gate as
  * Standard transmission because HDRP shares the material texture ABI.
  */
-export declare function selectHdrpPbrPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, transmissionCapable: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
+export declare function selectHdrpPbrPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, transmissionCapable: boolean, directionalPcssAvailable?: boolean, projectorAvailable?: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
+/** Return every active-capability pbr-skin variant used by URP and HDRP draws. */
+export declare function selectSkinPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
 /**
  * Select both Standard transmission states from the manifest for exact-label
  * prewarming. The requested keys come from declared variants; no key is
  * synthesized and no source fallback is permitted.
  */
-export declare function selectStandardPbrTransmissionPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
+export declare function selectStandardPbrTransmissionPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, directionalPcssAvailable?: boolean, projectorAvailable?: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
 /**
  * Select the PBR variant that matches a fallback mesh with no COLOR_0 input.
  * Unknown/custom material IDs may still use the legacy PBR fallback, so that
  * path must obey the same geometry-owned vertex-color axis as registered PBR.
  */
-export declare function selectNoColorPbrVariant(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, variantSet: string | undefined): MaterialShaderManifestEntry['variants'][number] | undefined;
+export declare function selectNoColorPbrVariant(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, variantSet: string | undefined, directionalPcssAvailable?: boolean, projectorAvailable?: boolean): MaterialShaderManifestEntry['variants'][number] | undefined;
 export type MaterialShaderBindingContract = RenderFeatureMaterialShaderBindingContract;
 export type MaterialShaderVertexInputContract = 'none' | 'render-material';
 export declare function resolveMaterialShaderBindingContract(source: string): MaterialShaderBindingContract;
 export declare function resolveMaterialShaderVertexInputContract(source: string): MaterialShaderVertexInputContract;
+/**
+ * Decide whether a custom material's user-region can use the shared PBR
+ * bind-group layout. Resource names are not part of a WebGPU layout contract:
+ * the only safe reuse test is that every derived binding in the custom schema
+ * is an identical prefix of the canonical user-region descriptor, including
+ * binding kind and its full shape (sample type, view dimension, sampler mode,
+ * dynamic-offset flags, and visibility). A texture3d/array or comparison /
+ * storage resource must therefore take the per-shader layout path even when
+ * its field count is small.
+ */
+export declare function isSharedMaterialUserRegionCompatible(paramSchema: readonly ParamSchemaEntry[]): boolean;
 export declare function allowsUnlitPreparedFallback(depthFormatOverride: GPUTextureFormat | null | undefined, vertexLayout: string | undefined, materialShaderId?: string): boolean;
 /**
  * Prepared VFX draws own their vertex inputs and bind groups. A missing
@@ -120,7 +133,8 @@ export declare function selectPipelineLayoutForVariant(state: {
     readonly pbrPipelineLayout: PipelineLayout | null;
     readonly hdrpPbrPipelineLayout: PipelineLayout | null;
     readonly pbrSkinPipelineLayout: PipelineLayout | null;
-} | null, variantSet: string | undefined, layoutKind?: LayoutKind): PipelineLayout | null;
+    readonly hdrpSkinPipelineLayout?: PipelineLayout | null;
+} | null, _variantSet: string | undefined, layoutKind?: LayoutKind): PipelineLayout | null;
 /**
  * Resolve a requested material variant against the actual backend capabilities.
  * Record callers use the native-capability request; the backend-owned axes
@@ -129,7 +143,7 @@ export declare function selectPipelineLayoutForVariant(state: {
  */
 export declare function resolveMaterialShaderVariantSet(requestedVariantSet: string | undefined, variants: ReadonlyArray<{
     readonly defines: Readonly<Record<string, boolean>>;
-}>, backendKind: RhiDevice['caps']['backendKind'], storageBuffer: boolean): string | undefined;
+}>, backendKind: RhiDevice['caps']['backendKind'], storageBuffer: boolean, projectorAvailable?: boolean): string | undefined;
 /**
  * Keep a single-source material on its canonical module identity. A manifest
  * entry with no variants cannot consume a synthesized capability or geometry

package/dist/assembly/factory.d.ts.map

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

package/dist/assembly/host-contract.d.ts

@@ -1,6 +1,7 @@
 import type { AssetRegistry } from '@forgeax/engine-assets-runtime';
 import type { World } from '@forgeax/engine-ecs';
 import type { Result, RhiDevice, RhiError, ShaderModule } from '@forgeax/engine-rhi';
+import type { RenderPipelineAsset } from '@forgeax/engine-types';
 import type { RecoverFailure } from '../errors/recover';
 import type { ObservationUnavailableError, RenderError } from '../errors/render';
 import type { RenderFeature, RenderFeatureDiagnostics } from '../features/types';
@@ -9,6 +10,7 @@ import type { FrameObservation, FrameObservationOptions } from '../record/frame'
 import type { CurrentGraphTarget, GraphTargetCaptureRequest } from '../record/frame-snapshot';
 import type { DrawOwnerOptions, FrameObservationRequest, FrameReceipt, FrameReceiptObservation, HealthSnapshot, RenderDebugOverlay, RendererError, RendererErrorListener, RendererLostListener, RenderFrameInput, RenderInspection, RenderProfile, RenderResult, RenderWorldLease } from '../render-contract';
 import type { RenderSceneInspection } from '../render-system';
+import type { RenderTarget, RenderTargetDescriptor, RenderTargetReadbackRequest, RenderTargetReadbackTicket, RenderTargetTextureSource, RenderTargetTextureSourceOptions } from '../targets/contracts';
 type RenderShaderModuleFactory = (device: RhiDevice, desc: {
     readonly label?: string | undefined;
     readonly code: string;
@@ -29,6 +31,11 @@ export type RendererHostEventListener = (event: RendererHostEvent) => void;
  */
 export interface RendererHostImplementation {
     attach(world: World): RenderResult<RenderWorldLease, RenderError>;
+    createRenderTarget(descriptor: RenderTargetDescriptor): RenderResult<RenderTarget, RenderError>;
+    resizeRenderTarget(target: RenderTarget, descriptor: RenderTargetDescriptor): RenderResult<void, RenderError>;
+    createRenderTargetTextureSource(target: RenderTarget, options: RenderTargetTextureSourceOptions): RenderResult<RenderTargetTextureSource, RenderError>;
+    requestTargetReadback(target: RenderTarget, request: RenderTargetReadbackRequest): RenderResult<RenderTargetReadbackTicket, RenderError>;
+    destroyRenderTarget(target: RenderTarget): RenderResult<void, RenderError>;
     setProfile(profile: RenderProfile): RenderResult<void, RenderError>;
     inspect(): RenderInspection;
     drawFrame(request: RenderFrameInput): RenderResult<FrameReceipt, RhiError | RenderError>;
@@ -74,6 +81,8 @@ export interface RendererLegacyHostAdapter {
     readonly meshMaterialBindings: readonly MeshMaterialBindingObservation[];
     readonly perFramePassNames: readonly string[];
     renderFeatureDiagnostics(): readonly RenderFeatureDiagnostics[];
+    /** @internal Install Standard pipeline-asset config for producer fixtures. */
+    configureStandard(config: RenderPipelineAsset['config']): void;
     installRenderFeature(feature: RenderFeature<unknown>): Promise<RenderResult<void, RenderError>>;
     uninstallRenderFeature(feature: RenderFeature<unknown>): Promise<RenderResult<void, RenderError>>;
     readonly bindGroupCounts: {

package/dist/assembly/host-contract.d.ts.map

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

package/dist/assembly/render-target-host.d.ts

@@ -0,0 +1,46 @@
+import type { RhiCommandEncoder, RhiDevice } from '@forgeax/engine-rhi';
+import type { RenderError } from '../errors/render';
+import type { RenderResult } from '../render-contract';
+import { type RenderTarget, type RenderTargetAdmissionLimits, type RenderTargetDescriptor, type RenderTargetReadbackData, type RenderTargetReadbackRequest, type RenderTargetReadbackTicket, type RenderTargetTextureSource, type RenderTargetTextureSourceOptions } from '../targets/contracts';
+import { type RenderTargetMaterialSourceBinding } from '../targets/material-source';
+import type { RenderTargetPhysical } from '../targets/physical';
+import { type RenderTargetReadbackReceipt } from '../targets/readback';
+export interface RenderTargetHostOptions {
+    readonly rendererId?: symbol;
+    readonly initialGeneration?: number;
+    readonly getGeneration?: () => number;
+    readonly limits?: RenderTargetAdmissionLimits;
+    readonly getDevice?: () => RhiDevice;
+    /**
+     * Renderer-owned candidate publication gate. Progressive cube capture keeps
+     * a target candidate across face submissions and returns true only after the
+     * capture scheduler has committed all faces for the matching fence.
+     */
+    readonly canPromoteTarget?: (target: RenderTarget) => boolean;
+}
+export interface RenderTargetHost {
+    /** The logical owner for every target lifecycle operation. */
+    readonly owner: 'renderer';
+    createRenderTarget(descriptor: RenderTargetDescriptor): RenderResult<RenderTarget, RenderError>;
+    resizeRenderTarget(target: RenderTarget, descriptor: RenderTargetDescriptor): RenderResult<void, RenderError>;
+    createRenderTargetTextureSource(target: RenderTarget, options: RenderTargetTextureSourceOptions): RenderResult<RenderTargetTextureSource, RenderError>;
+    /** @internal Resolve a source for the existing material projection path. */
+    resolveRenderTargetTextureSource(source: RenderTargetTextureSource): RenderTargetMaterialSourceBinding | undefined;
+    requestTargetReadback(target: RenderTarget, request: RenderTargetReadbackRequest): RenderResult<RenderTargetReadbackTicket, RenderError>;
+    observeTargetReadbacks(receipt: RenderTargetReadbackReceipt, tickets: readonly RenderTargetReadbackTicket[]): Promise<RenderResult<readonly RenderTargetReadbackData[], RenderError>>;
+    /** @internal Physical target used by the active Standard frame. */
+    getPhysicalTarget(target: RenderTarget): RenderTargetPhysical | undefined;
+    /** @internal Add pending target copies to the frame's sole encoder. */
+    encodePendingReadbacks(encoder: RhiCommandEncoder, faces?: readonly number[]): void;
+    destroyRenderTarget(target: RenderTarget): RenderResult<void, RenderError>;
+    /** Called immediately before the existing Standard frame is interpreted. */
+    beginFrame(): void;
+    /** Called only after the existing Renderer frame submission is accepted. */
+    onFrameSubmitted(completed?: Promise<RenderResult<void, RenderError>>): void;
+    /** Called after a replacement DeviceScope generation becomes active. */
+    recover(): void;
+    /** Called before Renderer-owned physical resources are released. */
+    dispose(): void;
+}
+export declare function createRenderTargetHost(options?: RenderTargetHostOptions): RenderTargetHost;
+//# sourceMappingURL=render-target-host.d.ts.map

package/dist/assembly/render-target-host.d.ts.map

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

package/dist/assets/render-asset-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-asset-port.d.ts","sourceRoot":"","sources":["../../src/assets/render-asset-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACrD,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,MAAM,CAAC,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACrD,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CACtE;AAED,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,cAAc,EAC9B,QAAQ,GAAE,mBAAmC,GAC5C,eAAe,CAgBjB"}
+{"version":3,"file":"render-asset-port.d.ts","sourceRoot":"","sources":["../../src/assets/render-asset-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACrD,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,MAAM,CAAC,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACrD,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CACtE;AAED,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,cAAc,EAC9B,QAAQ,GAAE,mBAAmC,GAC5C,eAAe,CAsBjB"}

package/dist/authoring.mjs

@@ -8,6 +8,9 @@ function createFullscreenRenderFeature(options) {
   const resourceName = `fullscreen.${options.identity.replace(/[^a-z0-9.-]/gi, "-").toLowerCase()}`;
   return Object.freeze({
     identity: options.identity,
+    requiredFullscreenPostProcesses: Object.freeze([
+      Object.freeze({ identity: options.identity, source: options.source })
+    ]),
     extract: (_context) => ok(void 0),
     plan: (_data, _context) => ok({
       resources: [

package/dist/authoring.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/features/fullscreen.ts"],"names":[],"mappings":";;;;;;AAwBO,SAAS,8BACd,OAAA,EAC0B;AAC1B,EAAA,MAAM,YAAA,GAAe,cAAc,OAAA,CAAQ,QAAA,CAAS,QAAQ,eAAA,EAAiB,GAAG,CAAA,CAAE,WAAA,EAAa,CAAA,CAAA;AAC/F,EAAA,OAAO,OAAO,MAAA,CAAO;AAAA,IACnB,UAAU,OAAA,CAAQ,QAAA;AAAA,IAClB,OAAA,EAAS,CAAC,QAAA,KAA0C,EAAA,CAAG,MAAS,CAAA;AAAA,IAChE,IAAA,EAAM,CAAC,KAAA,EAAkB,QAAA,KACvB,EAAA,CAAG;AAAA,MACD,SAAA,EAAW;AAAA,QACT;AAAA,UACE,IAAA,EAAM,oBAAA;AAAA,UACN,IAAA,EAAM,YAAA;AAAA,UACN,QAAQ,OAAA,CAAQ,MAAA;AAAA,UAChB,GAAI,QAAQ,KAAA,KAAU,MAAA,GAAY,EAAC,GAAI,EAAE,KAAA,EAAO,OAAA,CAAQ,KAAA,EAAM;AAAA,UAC9D,GAAI,QAAQ,MAAA,KAAW,MAAA,GAAY,EAAC,GAAI,EAAE,MAAA,EAAQ,OAAA,CAAQ,MAAA;AAAO;AACnE,OACF;AAAA,MACA,QAAQ;AAAC,KACkB;AAAA,GAChC,CAAA;AACH","file":"authoring.mjs","sourcesContent":["import { ok } from '@forgeax/engine-types';\nimport type {\n  RenderFeatureFullscreenRead,\n  RenderFeaturePlan,\n  RenderFeaturePlanContext,\n} from './plan';\nimport type { RenderFeature, RenderFeatureExtractContext } from './types';\n\n/** Host-owned fullscreen effect declaration carried by one RenderFeature. */\nexport interface FullscreenRenderFeatureOptions {\n  readonly identity: string;\n  readonly source: string;\n  readonly reads?: readonly RenderFeatureFullscreenRead[];\n  readonly params?: {\n    readonly byteSize: number;\n    readonly defaultValue: Uint8Array;\n  };\n}\n\n/**\n * Describe a fullscreen effect for the single feature host.\n * The producer returns this closed feature; GPU registration and lifetime stay\n * with the renderer host.\n */\nexport function createFullscreenRenderFeature(\n  options: FullscreenRenderFeatureOptions,\n): RenderFeature<undefined> {\n  const resourceName = `fullscreen.${options.identity.replace(/[^a-z0-9.-]/gi, '-').toLowerCase()}`;\n  return Object.freeze({\n    identity: options.identity,\n    extract: (_context: RenderFeatureExtractContext) => ok(undefined),\n    plan: (_data: undefined, _context: RenderFeaturePlanContext) =>\n      ok({\n        resources: [\n          {\n            kind: 'fullscreen-program',\n            name: resourceName,\n            source: options.source,\n            ...(options.reads === undefined ? {} : { reads: options.reads }),\n            ...(options.params === undefined ? {} : { params: options.params }),\n          },\n        ],\n        passes: [],\n      } satisfies RenderFeaturePlan),\n  });\n}\n"]}
+{"version":3,"sources":["../src/features/fullscreen.ts"],"names":[],"mappings":";;;;;;AAwBO,SAAS,8BACd,OAAA,EAC0B;AAC1B,EAAA,MAAM,YAAA,GAAe,cAAc,OAAA,CAAQ,QAAA,CAAS,QAAQ,eAAA,EAAiB,GAAG,CAAA,CAAE,WAAA,EAAa,CAAA,CAAA;AAC/F,EAAA,OAAO,OAAO,MAAA,CAAO;AAAA,IACnB,UAAU,OAAA,CAAQ,QAAA;AAAA,IAClB,+BAAA,EAAiC,OAAO,MAAA,CAAO;AAAA,MAC7C,MAAA,CAAO,OAAO,EAAE,QAAA,EAAU,QAAQ,QAAA,EAAU,MAAA,EAAQ,OAAA,CAAQ,MAAA,EAAQ;AAAA,KACrE,CAAA;AAAA,IACD,OAAA,EAAS,CAAC,QAAA,KAA0C,EAAA,CAAG,MAAS,CAAA;AAAA,IAChE,IAAA,EAAM,CAAC,KAAA,EAAkB,QAAA,KACvB,EAAA,CAAG;AAAA,MACD,SAAA,EAAW;AAAA,QACT;AAAA,UACE,IAAA,EAAM,oBAAA;AAAA,UACN,IAAA,EAAM,YAAA;AAAA,UACN,QAAQ,OAAA,CAAQ,MAAA;AAAA,UAChB,GAAI,QAAQ,KAAA,KAAU,MAAA,GAAY,EAAC,GAAI,EAAE,KAAA,EAAO,OAAA,CAAQ,KAAA,EAAM;AAAA,UAC9D,GAAI,QAAQ,MAAA,KAAW,MAAA,GAAY,EAAC,GAAI,EAAE,MAAA,EAAQ,OAAA,CAAQ,MAAA;AAAO;AACnE,OACF;AAAA,MACA,QAAQ;AAAC,KACkB;AAAA,GAChC,CAAA;AACH","file":"authoring.mjs","sourcesContent":["import { ok } from '@forgeax/engine-types';\nimport type {\n  RenderFeatureFullscreenRead,\n  RenderFeaturePlan,\n  RenderFeaturePlanContext,\n} from './plan';\nimport type { RenderFeature, RenderFeatureExtractContext } from './types';\n\n/** Host-owned fullscreen effect declaration carried by one RenderFeature. */\nexport interface FullscreenRenderFeatureOptions {\n  readonly identity: string;\n  readonly source: string;\n  readonly reads?: readonly RenderFeatureFullscreenRead[];\n  readonly params?: {\n    readonly byteSize: number;\n    readonly defaultValue: Uint8Array;\n  };\n}\n\n/**\n * Describe a fullscreen effect for the single feature host.\n * The producer returns this closed feature; GPU registration and lifetime stay\n * with the renderer host.\n */\nexport function createFullscreenRenderFeature(\n  options: FullscreenRenderFeatureOptions,\n): RenderFeature<undefined> {\n  const resourceName = `fullscreen.${options.identity.replace(/[^a-z0-9.-]/gi, '-').toLowerCase()}`;\n  return Object.freeze({\n    identity: options.identity,\n    requiredFullscreenPostProcesses: Object.freeze([\n      Object.freeze({ identity: options.identity, source: options.source }),\n    ]),\n    extract: (_context: RenderFeatureExtractContext) => ok(undefined),\n    plan: (_data: undefined, _context: RenderFeaturePlanContext) =>\n      ok({\n        resources: [\n          {\n            kind: 'fullscreen-program',\n            name: resourceName,\n            source: options.source,\n            ...(options.reads === undefined ? {} : { reads: options.reads }),\n            ...(options.params === undefined ? {} : { params: options.params }),\n          },\n        ],\n        passes: [],\n      } satisfies RenderFeaturePlan),\n  });\n}\n"]}

package/dist/capture/cube-views.d.ts

@@ -0,0 +1,21 @@
+import { type Mat4, type Vec3Like } from '@forgeax/engine-math';
+import { type CubeCameraFace } from '../components/cube-camera';
+export interface CubeCameraFaceView {
+    readonly position: Vec3Like;
+    readonly face: CubeCameraFace;
+    readonly direction: readonly [number, number, number];
+    readonly up: readonly [number, number, number];
+    readonly near: number;
+    readonly far: number;
+    readonly view: Mat4;
+    readonly projection: Mat4;
+    readonly viewProjection: Mat4;
+}
+export interface CubeCameraFaceViewInput {
+    readonly position: Vec3Like;
+    readonly near: number;
+    readonly far: number;
+}
+/** Build the only supported +X,-X,+Y,-Y,+Z,-Z cube orientation. */
+export declare function buildCubeCameraFaceViews(input: CubeCameraFaceViewInput): CubeCameraFaceView[];
+//# sourceMappingURL=cube-views.d.ts.map

package/dist/capture/cube-views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cube-views.d.ts","sourceRoot":"","sources":["../../src/capture/cube-views.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAQ,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAExF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAoBD,mEAAmE;AACnE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,EAAE,CA4B7F"}

package/dist/capture/scheduler.d.ts

@@ -0,0 +1,54 @@
+import { type CubeCameraFace, type CubeCameraUpdateIntent } from '../components/cube-camera';
+import type { RenderError } from '../errors/render';
+import type { RenderResult } from '../render-contract';
+import type { RenderTarget } from '../targets/contracts';
+import { type CubeCameraFaceView } from './cube-views';
+export interface CubeCaptureRequest {
+    readonly target: RenderTarget;
+    readonly position: readonly [number, number, number];
+    readonly near: number;
+    readonly far: number;
+    readonly updateIntent: CubeCameraUpdateIntent;
+    readonly requestVersion: number;
+    readonly faceBudget: number;
+}
+export interface CubeCaptureWork extends CubeCameraFaceView {
+    readonly target: RenderTarget;
+    readonly requestVersion: number;
+    readonly candidateGeneration: number;
+}
+export interface CubeCaptureInspection {
+    readonly target: RenderTarget;
+    readonly activeGeneration: number;
+    readonly candidateGeneration?: number;
+    readonly completedVersion: number;
+    readonly pendingFaces: readonly CubeCameraFace[];
+    readonly fallback: 'neutral' | 'previous-active';
+    readonly nestedRejections: number;
+}
+export interface CubeCaptureSchedulerOptions {
+    readonly maxFacesPerFrame?: number;
+}
+export type CubeCaptureRenderableKind = 'opaque' | 'transparent' | 'environment' | 'debug' | 'ui';
+export interface CubeCaptureRenderable {
+    readonly kind: CubeCaptureRenderableKind;
+    readonly target?: RenderTarget;
+}
+/** Apply the Standard capture visibility boundary to one extracted scene. */
+export declare function selectCubeCaptureRenderables(renderables: readonly CubeCaptureRenderable[], candidateTarget: RenderTarget): readonly CubeCaptureRenderable[];
+export interface CubeCaptureScheduler {
+    beginFrame(): void;
+    request(request: CubeCaptureRequest): RenderResult<{
+        readonly scheduled: boolean;
+    }, RenderError>;
+    nextWork(): readonly CubeCaptureWork[];
+    completeSubmission(submitted: boolean, completed?: Promise<unknown>): RenderResult<void, RenderError>;
+    inspect(target: RenderTarget): CubeCaptureInspection;
+}
+/**
+ * Schedules CubeCamera views inside the existing display frame. The scheduler
+ * never owns a World, encoder, or queue; callers contribute the returned work
+ * to the frame graph and report the one matching submission result.
+ */
+export declare function createCubeCaptureScheduler(options?: CubeCaptureSchedulerOptions): CubeCaptureScheduler;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/capture/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/capture/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;IACzD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,iBAAiB,CAAC;IACjD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG,aAAa,GAAG,aAAa,GAAG,OAAO,GAAG,IAAI,CAAC;AAElG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;CAChC;AAED,6EAA6E;AAC7E,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,SAAS,qBAAqB,EAAE,EAC7C,eAAe,EAAE,YAAY,GAC5B,SAAS,qBAAqB,EAAE,CAOlC;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,IAAI,IAAI,CAAC;IACnB,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,YAAY,CAAC;QAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;KAAE,EAAE,WAAW,CAAC,CAAC;IACjG,QAAQ,IAAI,SAAS,eAAe,EAAE,CAAC;IACvC,kBAAkB,CAChB,SAAS,EAAE,OAAO,EAClB,SAAS,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAC3B,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACnC,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,qBAAqB,CAAC;CACtD;AA0DD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CAiItB"}