@forgeax/engine-render 0.1.20 → 0.1.23

package/dist/scene/visibility/occlusion-runtime.d.ts

@@ -0,0 +1,96 @@
+import type { QuerySet, Result, RhiCommandEncoder, RhiDevice, RhiError, RhiRenderPassEncoder } from '@forgeax/engine-rhi';
+import type { PipelineBuilderShaderModuleFactory } from '../../pipeline-builder';
+import type { VisibilityBudget } from './budget';
+import type { VisibilityFacetStore } from './facet';
+import { type OcclusionBounds } from './occlusion-pass';
+import { OcclusionQueryPool } from './occlusion-query-pool';
+import { type PrimitiveKey, type ViewKey, type VisibilityCandidate } from './types';
+/** @internal Deterministic producer hook; never configured by the player API. */
+export interface OcclusionRuntimeTestHooks {
+    readonly beforeMap?: () => Promise<void>;
+}
+/** @internal Used only by the production evidence falsification harness. */
+export declare function setOcclusionRuntimeTestHooks(hooks: OcclusionRuntimeTestHooks | undefined): void;
+export interface OcclusionRuntimeCandidate {
+    readonly view: ViewKey;
+    readonly primitive: PrimitiveKey;
+    readonly epoch: number;
+    readonly bounds: OcclusionBounds;
+    readonly candidate: VisibilityCandidate;
+    readonly deviceGeneration: number;
+    /** Clip-space triangles for the conservative bounds proxy. */
+    readonly proxyVertices?: Float32Array;
+}
+export interface OcclusionFrameProjection {
+    readonly querySet: QuerySet;
+    readonly queryIndex: number;
+    readonly queryCount: number;
+    readonly sampleCount: 1 | 4;
+    readonly pageIndex: number;
+    readonly reservationId: number;
+    readonly encodeProxyBounds: (pass: RhiRenderPassEncoder) => Result<void, RhiError>;
+    readonly beginCandidate: (pass: RhiRenderPassEncoder) => Result<void, RhiError>;
+    readonly endCandidate: (pass: RhiRenderPassEncoder) => Result<void, RhiError>;
+    readonly recordResolve: (encoder: RhiCommandEncoder) => Result<void, RhiError>;
+    readonly commit: (submitted: boolean, submissionGeneration: number, profilePhase?: OcclusionProfilePhaseRunner) => void;
+}
+export type OcclusionProfilePhaseRunner = <T>(phase: 'record/occlusion-query-submit' | 'record/occlusion-global-advance', action: () => T) => T;
+/**
+ * RenderSystem-owned query transport. It is deliberately the only bridge
+ * between the logical pool, the typed graph raster pass, and facet completion.
+ */
+export declare class OcclusionRenderRuntime {
+    private readonly device;
+    private readonly facets;
+    private readonly shaderModuleFactory?;
+    private readonly budget;
+    private readonly pool;
+    private readonly resources;
+    private readonly activeCompletions;
+    private readonly retiredResources;
+    /** Candidate descriptors are rebuilt only when the extracted frame changes. */
+    private candidateSource;
+    private validCandidates;
+    private readonly candidateByKey;
+    private lastPrepareUnavailable;
+    private pendingFrame;
+    private disposed;
+    private proxyBuffer;
+    private readonly proxyScratch;
+    private proxyPipeline;
+    private proxyPipelineSampleCount;
+    private readonly queryLatencySamplesUs;
+    private lastQueryLatencyUs;
+    private readonly projection;
+    constructor(device: RhiDevice, facets: VisibilityFacetStore, shaderModuleFactory?: PipelineBuilderShaderModuleFactory | undefined, budget?: VisibilityBudget);
+    prepare(candidate: OcclusionRuntimeCandidate): OcclusionFrameProjection | undefined;
+    prepareBatch(candidates: readonly OcclusionRuntimeCandidate[], sampleCount?: 1 | 4, useReadyQueue?: boolean): OcclusionFrameProjection | undefined;
+    inspect(): ReturnType<OcclusionQueryPool['inspect']>;
+    get prepareUnavailable(): boolean;
+    /** Map-only latency from the submitted query page; queue wait is excluded. */
+    inspectQueryLatency(): {
+        readonly median: number;
+        readonly p95: number;
+        readonly last: number;
+    };
+    /**
+     * Wait until query readbacks submitted before the current observation have
+     * settled. The renderer receipt only fences command submission; query
+     * completion also includes the asynchronous map/unmap transition. Keeping
+     * that fence here makes `renderer.observe()` publish the latest visibility
+     * result and measured map latency instead of racing the readback promise.
+     */
+    waitForCompletions(): Promise<void>;
+    /** Count a successful frame for hidden rows that were not queried this frame. */
+    advanceSuccessfulSubmit(submissionGeneration: number): void;
+    dispose(): void;
+    private ensureResources;
+    private commit;
+    private publishAndApplySubmit;
+    private destroyResources;
+    private completeAfterSubmit;
+    private encodeProxyBounds;
+    private ensureProxyBuffer;
+    private ensureProxyPipeline;
+}
+//# sourceMappingURL=occlusion-runtime.d.ts.map

package/dist/scene/visibility/occlusion-runtime.d.ts.map

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

package/dist/scene/visibility/types.d.ts

@@ -0,0 +1,34 @@
+/** Closed view roles used by the renderer-owned visibility facet. */
+export type VisibilityViewRole = 'main' | 'shadow' | 'reflection' | 'probe';
+export interface ViewKey {
+    readonly attachmentId: string;
+    readonly cameraEntity: number;
+    readonly viewRole: VisibilityViewRole;
+    readonly viewGeneration: number;
+}
+export interface PrimitiveKey {
+    readonly attachmentId: string;
+    readonly worldGeneration: number;
+    readonly primitiveSlot: number;
+    readonly slotGeneration: number;
+}
+export interface VisibilityCandidate {
+    readonly level: number;
+    readonly confidence: number;
+}
+export interface VisibilityFacetInspection {
+    readonly owner: 'persistent-render-scene';
+    readonly activeViews: number;
+    readonly facetRows: number;
+}
+export interface VisibilityFacetInput {
+    readonly view: ViewKey;
+    readonly primitive: PrimitiveKey;
+    readonly epoch: number;
+    readonly candidate: VisibilityCandidate;
+}
+export declare function viewKeyId(key: ViewKey): string;
+export declare function primitiveKeyId(key: PrimitiveKey): string;
+export declare function viewKey(input: ViewKey): ViewKey;
+export declare function primitiveKey(input: PrimitiveKey): PrimitiveKey;
+//# sourceMappingURL=types.d.ts.map

package/dist/scene/visibility/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/scene/visibility/types.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;AAE5E,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;CACzC;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAE9C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAExD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAE9D"}

package/dist/shadow-atlas.d.ts

@@ -5,17 +5,17 @@ import { type RhiDevice, type Sampler, type Texture, type TextureView } from '@f
 export interface ShadowAtlasOptions {
     /** Per-face square size in pixels. Default 512 (PointLightShadow.mapSize default). */
     readonly faceSize?: number;
-    /** Number of cube layers. Default 4 (= PointLightShadow cardinality cap). */
+    /** Number of cube layers. Default is the renderer atlas admission capacity. */
     readonly layers?: number;
 }
 /** Default per-face square size in pixels. Mirrors PointLightShadow.mapSize default. */
 export declare const SHADOW_ATLAS_DEFAULT_FACE_SIZE = 512;
-/** Default cube layer count. Mirrors PointLightShadow cardinality cap. */
+/** Default cube layer count. Renderer-owned point-shadow admission capacity. */
 export declare const SHADOW_ATLAS_DEFAULT_LAYERS = 4;
 /**
  * Cube-array depth atlas for point-light shadows.
  *
- * Shape: `texture_depth_cube_array` (depth32float) with `layers = 4` and per-
+ * Shape: `texture_depth_cube_array` (depth32float) with `layers` and per-
  * face size `faceSize x faceSize`. The cube_array sampling view feeds
  * `@group(0) @binding(5)` in URP shaders; the per-face 2D view feeds the
  * shadow-caster render pass attachment for one (layer, face) at a time

package/dist/shadow-atlas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shadow-atlas.d.ts","sourceRoot":"","sources":["../src/shadow-atlas.ts"],"names":[],"mappings":"AAiCA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAQ7B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wFAAwF;AACxF,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,WAAW;IACtB,yEAAyE;IACzE,OAAO,CAAC,OAAO,CAAwB;IACvC;;;OAGG;IACH,OAAO,CAAC,aAAa,CAA4B;IACjD,yDAAyD;IACzD,OAAO,CAAC,cAAc,CAAwB;IAC9C,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,kBAAuB;IAM/D;;;;;;OAMG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;;;;OASG;IACH,MAAM,IAAI,IAAI;IAkCd;;;;OAIG;IACH,YAAY,IAAI,WAAW,GAAG,IAAI;IAIlC;;;OAGG;IACH,oBAAoB,IAAI,OAAO,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,IAAI,OAAO,GAAG,IAAI;IAI5B;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW;IAoBlD;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAShB"}
+{"version":3,"file":"shadow-atlas.d.ts","sourceRoot":"","sources":["../src/shadow-atlas.ts"],"names":[],"mappings":"AAiCA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAQ7B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wFAAwF;AACxF,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,gFAAgF;AAChF,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,WAAW;IACtB,yEAAyE;IACzE,OAAO,CAAC,OAAO,CAAwB;IACvC;;;OAGG;IACH,OAAO,CAAC,aAAa,CAA4B;IACjD,yDAAyD;IACzD,OAAO,CAAC,cAAc,CAAwB;IAC9C,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,kBAAuB;IAM/D;;;;;;OAMG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;;;;OASG;IACH,MAAM,IAAI,IAAI;IAkCd;;;;OAIG;IACH,YAAY,IAAI,WAAW,GAAG,IAAI;IAIlC;;;OAGG;IACH,oBAAoB,IAAI,OAAO,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,IAAI,OAAO,GAAG,IAAI;IAI5B;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW;IAoBlD;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAShB"}

package/dist/ssao-buffers.d.ts

@@ -6,6 +6,7 @@ export declare function generateSsaoNoise(seed?: number): Float32Array;
 export declare const SSAO_UNIFORM_INTENSITY_OFFSET = 192;
 export declare const SSAO_UNIFORM_BYTES = 256;
 interface SsaoFallbackResources {
+    readonly device: RenderSystemRuntime['device'];
     readonly texture: Texture;
     readonly view: TextureView;
     readonly sampler: Sampler;
@@ -26,6 +27,8 @@ export declare function getOrCreateSsaoFallbackTexture(runtime: RenderSystemRunt
  * Fields are readonly per charter P5: one resource, one owner.
  */
 export interface SsaoBuffers {
+    /** Device identity that owns every handle in this bundle. */
+    readonly device: RenderSystemRuntime['device'];
     /** 64 padded vec4 uniform buffer for hemisphere samples. */
     readonly kernelBuffer: Buffer;
     readonly kernelBytes: number;

package/dist/ssao-buffers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssao-buffers.d.ts","sourceRoot":"","sources":["../src/ssao-buffers.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAInE,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAiB3C,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAU,GAAG,SAAS,YAAY,EAAE,CAuB5E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,MAAU,GAAG,YAAY,CAShE;AAiBD,eAAO,MAAM,6BAA6B,MAAiC,CAAC;AAC5E,eAAO,MAAM,kBAAkB,MAAgB,CAAC;AAYhD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAID;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,mBAAmB,GAC3B,qBAAqB,GAAG,IAAI,CAyE9B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAID;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,GAAG,IAAI,CAwGvF"}
+{"version":3,"file":"ssao-buffers.d.ts","sourceRoot":"","sources":["../src/ssao-buffers.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAInE,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAiB3C,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAU,GAAG,SAAS,YAAY,EAAE,CAuB5E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,MAAU,GAAG,YAAY,CAShE;AAiBD,eAAO,MAAM,6BAA6B,MAAiC,CAAC;AAC5E,eAAO,MAAM,kBAAkB,MAAgB,CAAC;AAYhD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAID;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,mBAAmB,GAC3B,qBAAqB,GAAG,IAAI,CA2E9B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC/C,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAID;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,GAAG,IAAI,CA0GvF"}

package/dist/ssr/admission.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Consumer-only SSR M0 admission.
+ *
+ * This module consumes detached producer receipts. It owns no capture,
+ * device, graph, or recovery handle and therefore cannot repair a missing
+ * producer. A complete receipt set is the only route to an admitted result.
+ */
+import { type RhiTextureFormatCapabilityReceipt } from '@forgeax/engine-rhi';
+import type { ReflectionFallbackReceipt } from '../inspection-types';
+import type { SsrOwnerRecoveryAction } from './errors';
+import type { SsrAdmissionIdentity } from './identity';
+export declare const SSR_FORMAT_PROFILE: "r32float-mip-sampled-storage";
+export declare const SSR_FORMAT_STAGES: readonly ["texture-create", "mip-view", "sampled-storage-bind-group", "pipeline-bind", "finish", "submit", "completion", "readback"];
+export type { SsrAdmissionIdentity } from './identity';
+export type SsrFormatStage = (typeof SSR_FORMAT_STAGES)[number];
+/**
+ * The admission input is the real renderer owner receipt plus the one
+ * integration identity supplied by the host. It deliberately does not
+ * recreate submitted/source/LKG boolean flags.
+ */
+export type SsrReflectionFallbackReceipt = ReflectionFallbackReceipt & {
+    readonly identity: SsrAdmissionIdentity;
+};
+/** RHI capability receipt with the same host-supplied integration identity. */
+export type SsrFormatReceipt = RhiTextureFormatCapabilityReceipt & {
+    readonly identity: SsrAdmissionIdentity;
+};
+export interface SsrTemporalReceipt {
+    readonly identity: SsrAdmissionIdentity;
+    readonly successfulSubmit: true;
+    readonly generation: number;
+}
+export interface SsrAdmissionWork {
+    readonly attachmentCount: number;
+    readonly passCount: number;
+    readonly bindingCount: number;
+    readonly resourceCount: number;
+    readonly historyCount: 0;
+    readonly temporalDemand: 0;
+}
+export interface SsrAdmissionBudget {
+    readonly probeExecutions: 0 | 1;
+    readonly resetCount: 0;
+    readonly rebuildCount: 0;
+}
+export interface SsrAdmissionFailure {
+    readonly code: 'ssr-not-requested' | 'ssr-reflection-fallback-unavailable' | 'ssr-format-unavailable' | 'ssr-temporal-unavailable' | 'ssr-receipt-identity-mismatch' | 'ssr-receipt-stale';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: Readonly<{
+        readonly owner: 'producer' | 'format' | 'temporal' | 'consumer';
+        /** Owner-directed action an AI consumer can take without parsing hint text. */
+        readonly action: SsrOwnerRecoveryAction;
+        readonly generation?: number;
+        readonly identityField?: keyof SsrAdmissionIdentity;
+    }>;
+}
+export type SsrAdmissionResult = {
+    readonly status: 'admitted';
+    readonly identity: SsrAdmissionIdentity | undefined;
+    readonly generation: number;
+    readonly work: SsrAdmissionWork;
+    readonly budget: SsrAdmissionBudget;
+    readonly failure?: undefined;
+} | {
+    readonly status: 'fallback-only';
+    readonly identity: SsrAdmissionIdentity | undefined;
+    readonly generation: number;
+    readonly work: SsrAdmissionWork;
+    readonly budget: SsrAdmissionBudget;
+    readonly failure: SsrAdmissionFailure;
+};
+export interface SsrAdmissionInput {
+    readonly requested: boolean;
+    readonly identity: SsrAdmissionIdentity;
+    readonly reflectionFallback?: SsrReflectionFallbackReceipt;
+    readonly format?: SsrFormatReceipt;
+    readonly temporal?: SsrTemporalReceipt;
+    readonly previousGeneration?: number;
+}
+/** Public renderer projection consumed by the parent SSR feature. */
+export interface SsrDependenciesInspection {
+    readonly status: 'admitted' | 'fallback-only';
+    /** Absent until the host binds an exact source/tree/lock/build identity. */
+    readonly identity: SsrAdmissionIdentity | undefined;
+    readonly requested: boolean;
+    readonly reflectionFallback: ReflectionFallbackReceipt | undefined;
+    readonly format: SsrFormatReceipt | undefined;
+    readonly temporal: SsrTemporalReceipt | undefined;
+    readonly admission: SsrAdmissionResult;
+    readonly work: SsrAdmissionWork;
+    readonly budget: SsrAdmissionBudget;
+    readonly failure: SsrAdmissionFailure | undefined;
+}
+export declare function admitSsrM0(input: SsrAdmissionInput): SsrAdmissionResult;
+/**
+ * Joins the live owner projections at the renderer boundary. The only casts
+ * here add the host identity to receipts that otherwise remain canonical RHI
+ * or ReflectionProbe PODs; no producer fact is copied or renamed.
+ */
+export declare function projectSsrDependencies(input: {
+    readonly requested: boolean;
+    readonly identity: SsrAdmissionIdentity | undefined;
+    readonly reflectionFallback: ReflectionFallbackReceipt | undefined;
+    readonly format: RhiTextureFormatCapabilityReceipt | undefined;
+    readonly temporal: {
+        readonly successfulSubmit: true;
+        readonly generation: number;
+    } | undefined;
+    readonly previousGeneration?: number;
+}): SsrDependenciesInspection;
+export declare function zeroSsrAdmissionWork(): SsrAdmissionWork;
+/**
+ * Projects the admission decision into the existing temporal reset seam.
+ * Admission never creates temporal history; only a changed committed
+ * producer generation can request a reset through the coordinator.
+ */
+export declare function resolveSsrAdmissionGeneration(previousGeneration: number | undefined, nextGeneration: number | undefined): {
+    readonly changed: boolean;
+    readonly generation: number | undefined;
+};
+//# sourceMappingURL=admission.d.ts.map

package/dist/ssr/admission.d.ts.map

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

package/dist/ssr/composition.d.ts

@@ -0,0 +1,32 @@
+import { type Result } from '@forgeax/engine-types';
+/** Linear HDR RGB used by the M0 composition contract. */
+export type SsrReflectionColor = readonly [number, number, number];
+export interface SsrCompositionInput {
+    /** Screen-hit confidence. The parent SSR consumer supplies 0..1. */
+    readonly c: number;
+    /** The Standard BRDF specular lobe before SSR replacement. */
+    readonly baseSpecular: SsrReflectionColor;
+    /** The same-source BRDF-projected screen contribution. */
+    readonly screenSpecular: SsrReflectionColor;
+    /** The committed producer-owned environment contribution. */
+    readonly fallbackSpecular: SsrReflectionColor;
+}
+export interface SsrCompositionInputError {
+    readonly code: 'ssr-composition-input-invalid';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: Readonly<{
+        readonly field: 'c' | 'baseSpecular' | 'screenSpecular' | 'fallbackSpecular';
+    }>;
+}
+export type SsrCompositionResult = Result<SsrReflectionColor, SsrCompositionInputError>;
+/**
+ * Apply the M0 reflection replacement contract without owning an SSR pass.
+ *
+ * `c=0` returns the base Standard specular lobe. `c=1` replaces only that
+ * lobe with the same-source screen contribution, subtracting the committed
+ * environment contribution once. Hi-Z traversal, history and graph wiring
+ * remain owned by the parent SSR feature.
+ */
+export declare function composeSsrReflection(input: SsrCompositionInput): SsrCompositionResult;
+//# sourceMappingURL=composition.d.ts.map

package/dist/ssr/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../src/ssr/composition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE7D,0DAA0D;AAC1D,MAAM,MAAM,kBAAkB,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;IAC5C,6DAA6D;IAC7D,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;CAC/C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,cAAc,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;KAC9E,CAAC,CAAC;CACJ;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,kBAAkB,EAAE,wBAAwB,CAAC,CAAC;AAkBxF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,CAqBrF"}

package/dist/ssr/errors.d.ts

@@ -0,0 +1,39 @@
+/** Closed, consumer-facing failures for the detached SSR M0 contract. */
+export type SsrAdmissionErrorCode = 'ssr-not-requested' | 'ssr-reflection-fallback-unavailable' | 'ssr-format-unavailable' | 'ssr-temporal-unavailable' | 'ssr-receipt-identity-mismatch' | 'ssr-receipt-stale';
+export type SsrOwnerRecoveryAction = 'use-LKG' | 'use-Skylight' | 'use-neutral' | 'recapture' | 'rebuild' | 'retry';
+export type SsrAdmissionErrorDetail = {
+    readonly code: 'ssr-not-requested';
+    readonly owner: 'consumer';
+    readonly action: 'retry';
+} | {
+    readonly code: 'ssr-reflection-fallback-unavailable';
+    readonly owner: 'producer';
+    readonly action: 'use-LKG' | 'use-Skylight' | 'use-neutral' | 'recapture' | 'rebuild';
+} | {
+    readonly code: 'ssr-format-unavailable';
+    readonly owner: 'format';
+    readonly action: 'rebuild' | 'retry';
+    readonly stage?: string;
+} | {
+    readonly code: 'ssr-temporal-unavailable';
+    readonly owner: 'temporal';
+    readonly action: 'rebuild' | 'retry';
+} | {
+    readonly code: 'ssr-receipt-identity-mismatch';
+    readonly owner: 'producer' | 'format' | 'temporal';
+    readonly action: 'rebuild';
+    readonly identityField: 'sourceHead' | 'sourceTree' | 'lockSha256' | 'buildSha256';
+} | {
+    readonly code: 'ssr-receipt-stale';
+    readonly owner: 'consumer';
+    readonly action: 'retry';
+    readonly generation: number;
+};
+export interface SsrAdmissionError {
+    readonly code: SsrAdmissionErrorCode;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: SsrAdmissionErrorDetail;
+}
+export declare function createSsrAdmissionError(detail: SsrAdmissionErrorDetail): SsrAdmissionError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/ssr/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/ssr/errors.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,MAAM,qBAAqB,GAC7B,mBAAmB,GACnB,qCAAqC,GACrC,wBAAwB,GACxB,0BAA0B,GAC1B,+BAA+B,GAC/B,mBAAmB,CAAC;AAExB,MAAM,MAAM,sBAAsB,GAC9B,SAAS,GACT,cAAc,GACd,aAAa,GACb,WAAW,GACX,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,MAAM,uBAAuB,GAC/B;IACE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,qCAAqC,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;CACvF,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;CACtC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;CACpF,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEN,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;CAC1C;AAID,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAc1F"}

package/dist/ssr/identity.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Exact source/build identity shared by the producer, RHI and SSR consumer.
+ *
+ * Keeping the POD in its own leaf avoids a second copy of the identity shape
+ * in the owner inspection types and in the admission module.
+ */
+export type SsrAdmissionIdentity = Readonly<{
+    readonly sourceHead: string;
+    readonly sourceTree: string;
+    readonly lockSha256: string;
+    readonly buildSha256: string;
+}>;
+//# sourceMappingURL=identity.d.ts.map

package/dist/ssr/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/ssr/identity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC,CAAC"}

package/dist/systems/skin-palette-allocator.d.ts

@@ -33,7 +33,7 @@ export interface SkinPaletteAllocator {
      * Computes M_i = jointWorldTransforms[i] * ibm[i] per joint.
      *
      * `jointWorlds[i]` is taken straight from `Skin.joints[i]` entity's
-     * `Transform.world` view (a 16-float column-major Float32Array
+     * `GlobalTransform.world` view (a 16-float column-major Float32Array
      * written by propagateTransforms); zero recompose, premultiplies
      * directly against the IBM.
      */

package/dist/targets/contracts.d.ts

@@ -0,0 +1,66 @@
+import type { RenderError } from '../errors/render';
+import type { RenderResult } from '../render-contract';
+export type RenderTargetFormat = 'rgba16float' | 'rgba8unorm' | 'rgba8unorm-srgb';
+export type RenderTargetShape = '2d' | 'cube';
+export type RenderTargetMipLevels = 1 | 'full';
+export type RenderTargetSampleCount = 1 | 4;
+export type RenderTargetDepthFormat = 'depth24plus-stencil8' | 'depth32float';
+export interface RenderTargetDescriptor {
+    readonly shape: RenderTargetShape;
+    readonly width: number;
+    readonly height: number;
+    readonly format: RenderTargetFormat;
+    readonly mipLevels: RenderTargetMipLevels;
+    readonly sampleCount: RenderTargetSampleCount;
+    readonly depth?: RenderTargetDepthFormat;
+    readonly sampled: boolean;
+    readonly readback: boolean;
+}
+declare const RenderTargetBrand: unique symbol;
+declare const RenderTargetTextureSourceBrand: unique symbol;
+declare const RenderTargetReadbackTicketBrand: unique symbol;
+/** Opaque logical target lease owned by one Renderer. */
+export interface RenderTarget {
+    readonly [RenderTargetBrand]: 'RenderTarget';
+}
+export type RenderTargetTextureAspect = 'color';
+export interface RenderTargetTextureSourceOptions {
+    readonly aspect: RenderTargetTextureAspect;
+    readonly dimension: RenderTargetShape;
+    readonly mipLevel: number;
+}
+/** Renderer-local runtime material source; it is not an asset handle. */
+export interface RenderTargetTextureSource {
+    readonly [RenderTargetTextureSourceBrand]: 'RenderTargetTextureSource';
+}
+export interface RenderTargetReadbackRequest {
+    readonly mipLevel: number;
+    /** Cube array layer to copy; 2D targets accept only the omitted form. */
+    readonly face?: number;
+}
+/** One-shot readback request bound to a future matching FrameReceipt. */
+export interface RenderTargetReadbackTicket {
+    readonly [RenderTargetReadbackTicketBrand]: 'RenderTargetReadbackTicket';
+}
+/** Bytes released by observe after the ticket's matching frame completes. */
+export interface RenderTargetReadbackData {
+    readonly ticket: RenderTargetReadbackTicket;
+    readonly bytes: Uint8Array;
+    readonly frameId: number;
+    readonly deviceGeneration: number;
+    readonly mipLevel: number;
+    readonly face?: number;
+    readonly bytesPerRow: number;
+    readonly byteLength: number;
+}
+export interface RenderTargetAdmissionLimits {
+    readonly maxTextureDimension2D: number;
+    readonly maxBytesPerTarget: number;
+    readonly renderableFormats: readonly RenderTargetFormat[];
+    readonly sampleCounts: readonly RenderTargetSampleCount[];
+    readonly depthFormats: readonly RenderTargetDepthFormat[];
+}
+/** Validate descriptor facts before a renderer allocates a physical target. */
+export declare function admitRenderTargetDescriptor(descriptor: RenderTargetDescriptor, limits: RenderTargetAdmissionLimits): RenderResult<RenderTargetDescriptor, RenderError>;
+export {};
+//# sourceMappingURL=contracts.d.ts.map

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

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

package/dist/targets/graph-projection.d.ts

@@ -0,0 +1,29 @@
+import type { GraphTexture, GraphTextureView, GraphTextureViewDescriptor, RenderGraphBuilder, RenderGraphFrame } from '@forgeax/engine-render-graph';
+import type { Texture, TextureView } from '@forgeax/engine-rhi';
+import type { RenderError } from '../errors/render';
+import type { RenderResult } from '../render-contract';
+import type { RenderTarget, RenderTargetDescriptor } from './contracts';
+export interface RenderTargetGraphInput {
+    readonly target: RenderTarget;
+    readonly generation: number;
+    readonly descriptor: RenderTargetDescriptor;
+    readonly texture: Texture;
+    readonly view: TextureView;
+    readonly resolveView?: TextureView | undefined;
+}
+export interface RenderTargetGraphSubresource {
+    readonly mipLevel?: number;
+    readonly face?: number;
+}
+export interface RenderTargetGraphProjection {
+    readonly ownership: 'imported';
+    readonly generation: number;
+    readonly texture: GraphTexture;
+    readonly view: GraphTextureView;
+    readonly sampleView: GraphTextureView;
+    readonly resolveView?: GraphTextureView | undefined;
+    readonly viewDescriptor: GraphTextureViewDescriptor;
+    readonly usage: readonly ('sampled-read' | 'copy-src')[];
+}
+export declare function projectRenderTargetGraph<FrameCtx extends RenderGraphFrame>(graph: RenderGraphBuilder<FrameCtx>, input: RenderTargetGraphInput, subresource?: RenderTargetGraphSubresource): RenderResult<RenderTargetGraphProjection, RenderError>;
+//# sourceMappingURL=graph-projection.d.ts.map

package/dist/targets/graph-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-projection.d.ts","sourceRoot":"","sources":["../../src/targets/graph-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,0BAA0B,EAC1B,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,OAAO,EAAiB,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,cAAc,EAAE,0BAA0B,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,cAAc,GAAG,UAAU,CAAC,EAAE,CAAC;CAC1D;AAsED,wBAAgB,wBAAwB,CAAC,QAAQ,SAAS,gBAAgB,EACxE,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EACnC,KAAK,EAAE,sBAAsB,EAC7B,WAAW,GAAE,4BAAiC,GAC7C,YAAY,CAAC,2BAA2B,EAAE,WAAW,CAAC,CA0DxD"}

package/dist/targets/material-source.d.ts

@@ -0,0 +1,34 @@
+import type { TextureView } from '@forgeax/engine-rhi';
+import type { RenderError } from '../errors/render';
+import type { RenderResult } from '../render-contract';
+import type { RenderTarget, RenderTargetDescriptor, RenderTargetTextureSource, RenderTargetTextureSourceOptions } from './contracts';
+export interface RenderTargetMaterialSourceView {
+    readonly dimension: RenderTargetTextureSourceOptions['dimension'];
+    readonly mipLevel: number;
+    readonly resolveRequired: boolean;
+}
+export interface RenderTargetMaterialSourceBinding {
+    readonly source: RenderTargetTextureSource;
+    readonly target: RenderTarget;
+    readonly generation: number;
+    readonly shape: RenderTargetDescriptor['shape'];
+    readonly format: RenderTargetDescriptor['format'];
+    readonly view: RenderTargetMaterialSourceView;
+    /** Renderer-local physical view, present only for the active generation. */
+    readonly textureView?: TextureView;
+}
+export interface RenderTargetMaterialSourceExpectation {
+    readonly target: RenderTarget;
+    readonly generation: number;
+    readonly shape: RenderTargetDescriptor['shape'];
+    readonly format: RenderTargetDescriptor['format'];
+    readonly dimension: RenderTargetTextureSourceOptions['dimension'];
+    readonly mipLevel: number;
+}
+/** Resolve a source only inside the renderer-owned material projection. */
+export declare function resolveRenderTargetMaterialSource(source: RenderTargetTextureSource): RenderTargetMaterialSourceBinding | undefined;
+export declare function createRenderTargetMaterialSource(target: RenderTarget, descriptor: RenderTargetDescriptor, options: RenderTargetTextureSourceOptions & {
+    readonly generation: number;
+}): RenderResult<RenderTargetMaterialSourceBinding, RenderError>;
+export declare function validateRenderTargetMaterialSource(binding: RenderTargetMaterialSourceBinding, expected: RenderTargetMaterialSourceExpectation): RenderResult<void, RenderError>;
+//# sourceMappingURL=material-source.d.ts.map

package/dist/targets/material-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-source.d.ts","sourceRoot":"","sources":["../../src/targets/material-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAKpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACV,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,gCAAgC,EACjC,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,SAAS,EAAE,gCAAgC,CAAC,WAAW,CAAC,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAC9C,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;CACpC;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,gCAAgC,CAAC,WAAW,CAAC,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAQD,2EAA2E;AAC3E,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,yBAAyB,GAChC,iCAAiC,GAAG,SAAS,CAE/C;AAaD,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,sBAAsB,EAClC,OAAO,EAAE,gCAAgC,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1E,YAAY,CAAC,iCAAiC,EAAE,WAAW,CAAC,CAgC9D;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,iCAAiC,EAC1C,QAAQ,EAAE,qCAAqC,GAC9C,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAqCjC"}

package/dist/targets/owner.d.ts

@@ -0,0 +1,32 @@
+import type { RenderError } from '../errors/render';
+import type { RenderResult } from '../render-contract';
+import type { RenderTarget, RenderTargetDescriptor } from './contracts';
+export type RenderTargetOwnerState = 'uninitialized' | 'candidate' | 'active' | 'rebuilding' | 'destroyed';
+export interface RenderTargetPhysicalCandidate {
+    readonly generation: number;
+    readonly descriptor: RenderTargetDescriptor;
+}
+export interface RenderTargetOwnerInspection {
+    readonly token: RenderTarget;
+    readonly state: RenderTargetOwnerState;
+    readonly generation: number;
+    readonly descriptor: RenderTargetDescriptor;
+    readonly candidate?: RenderTargetPhysicalCandidate;
+}
+export interface RenderTargetOwnerOptions {
+    readonly rendererId: symbol;
+    readonly initialGeneration: number;
+}
+export interface RenderTargetOwner {
+    create(descriptor: RenderTargetDescriptor): RenderResult<RenderTarget, RenderError>;
+    stage(target: RenderTarget, descriptor?: RenderTargetDescriptor): RenderResult<RenderTargetPhysicalCandidate, RenderError>;
+    promote(target: RenderTarget, generation: number): RenderResult<void, RenderError>;
+    rejectCandidate(target: RenderTarget, generation: number, stage: 'allocation' | 'compile' | 'write' | 'submit'): RenderResult<void, RenderError>;
+    beginRecovery(target: RenderTarget, generation: number): RenderResult<void, RenderError>;
+    finishRecovery(target: RenderTarget): RenderResult<void, RenderError>;
+    retire(target: RenderTarget, generation: number): RenderResult<void, RenderError>;
+    destroy(target: RenderTarget): RenderResult<void, RenderError>;
+    inspect(target: RenderTarget): RenderResult<RenderTargetOwnerInspection, RenderError>;
+}
+export declare function createRenderTargetOwner(options: RenderTargetOwnerOptions): RenderTargetOwner;
+//# sourceMappingURL=owner.d.ts.map