@forgeax/engine-render 0.1.21 → 0.1.24

package/dist/scene/visibility/lod-selector.d.ts

@@ -0,0 +1,25 @@
+import type { MeshLodLevel } from '@forgeax/engine-types';
+export interface ProjectedHeightInput {
+    readonly radius: number;
+    readonly depth: number;
+    readonly projection: 'perspective' | 'orthographic';
+    readonly fov?: number;
+    readonly orthoHeight?: number;
+}
+export interface LodSelectorInput {
+    /** Lower-detail levels in ascending detail order; LOD0 is implicit. */
+    readonly levels: readonly Pick<MeshLodLevel, 'screenCoverage'>[];
+    readonly projectedHeight: number;
+    readonly previousLevel: number;
+    readonly hysteresis: number;
+    /** Index zero is the root and must remain the safe fallback. */
+    readonly ready: readonly boolean[];
+    readonly historyValid: boolean;
+}
+export interface LodSelection {
+    readonly level: number;
+    readonly confidence: number;
+}
+export declare function projectedHeight(input: ProjectedHeightInput): number;
+export declare function selectLod(input: LodSelectorInput): LodSelection;
+//# sourceMappingURL=lod-selector.d.ts.map

package/dist/scene/visibility/lod-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lod-selector.d.ts","sourceRoot":"","sources":["../../../src/scene/visibility/lod-selector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,aAAa,GAAG,cAAc,CAAC;IACpD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,YAAY,EAAE,gBAAgB,CAAC,EAAE,CAAC;IACjE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAUnE;AAmCD,wBAAgB,SAAS,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,CAY/D"}

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

@@ -0,0 +1,81 @@
+import { type VisibilityBudget } from './budget';
+export type InvalidationReason = 'cut' | 'teleport' | 'resize' | 'projection' | 'primitive' | 'bounds' | 'topology' | 'world-reorder' | 'detach' | 'failed-submit' | 'device-loss' | 'transparent';
+export interface ConfidenceState {
+    readonly status: 'visible' | 'hidden';
+    readonly zeroStreak: number;
+    readonly successfulSubmits: number;
+    readonly queryable: boolean;
+    readonly dirty: boolean;
+    readonly lastResultGeneration: number | undefined;
+}
+export type ConfidenceEvent = {
+    readonly type: 'result';
+    readonly samples: number;
+    readonly submissionGeneration: number;
+} | {
+    readonly type: 'submit';
+    readonly submissionGeneration: number;
+} | {
+    readonly type: 'failure';
+    readonly submissionGeneration: number;
+} | {
+    readonly type: 'invalidate';
+    readonly reason: InvalidationReason;
+};
+export declare function createConfidenceState(): ConfidenceState;
+export declare function applyConfidenceEvent(state: ConfidenceState, event: ConfidenceEvent, budget?: VisibilityBudget): ConfidenceState;
+export declare function shouldIssueRetest(state: ConfidenceState, budget?: VisibilityBudget): boolean;
+export declare class OcclusionConfidenceScheduler {
+    private readonly budget;
+    private readonly states;
+    private readonly wakeByGeneration;
+    private readonly expireByGeneration;
+    private readonly wakeHeap;
+    private readonly expireHeap;
+    private readonly wakeHeapMembers;
+    private readonly expireHeapMembers;
+    private readonly retestKeys;
+    private readonly scheduleByKey;
+    constructor(budget?: VisibilityBudget);
+    ensure(key: string): ConfidenceState;
+    apply(key: string, event: ConfidenceEvent): ConfidenceState;
+    /** Apply an in-flight query submit without scheduling a same-generation wake. */
+    applyInFlightSubmit(key: string, event: Extract<ConfidenceEvent, {
+        readonly type: 'submit';
+    }>): ConfidenceState;
+    drainRetests(limit: number): string[];
+    get(key: string): ConfidenceState | undefined;
+    remove(key: string): void;
+    /** Advance hidden evidence on a successful frame even when no query was issued for it. */
+    advanceSuccessfulSubmits(submissionGeneration: number, excludedKeys?: ReadonlySet<string>): {
+        readonly changed: boolean;
+        readonly drawChangedKeys: readonly string[];
+        readonly queryChangedKeys: readonly string[];
+    };
+    clear(): void;
+    private schedule;
+    private scheduleExpiry;
+    private scheduleExpiryOnly;
+    private unschedule;
+    private takeDue;
+    private addDue;
+    private refreshRetestKey;
+}
+export interface VisibilityDecisionInput {
+    readonly authorVisible: boolean;
+    readonly validBounds: boolean;
+    readonly frustumVisible: boolean;
+    readonly lodReady: boolean;
+    readonly occlusion: Pick<ConfidenceState, 'status' | 'queryable'>;
+    readonly lane?: 'cpu' | 'gpu';
+}
+export interface VisibilityDecision {
+    readonly draw: boolean;
+    readonly stage: 'author' | 'bounds' | 'frustum' | 'lod' | 'occlusion';
+}
+export declare function decideVisibility(input: VisibilityDecisionInput): VisibilityDecision;
+export interface RecoveredVisibilityState extends ConfidenceState {
+    readonly retryCount: 1;
+}
+export declare function recoverVisibilityAfterDeviceLoss(_state: ConfidenceState, _deviceGeneration: number): RecoveredVisibilityState;
+//# sourceMappingURL=occlusion-confidence.d.ts.map

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

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

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

@@ -0,0 +1,57 @@
+export interface OcclusionBounds {
+    readonly min: readonly [number, number, number];
+    readonly max: readonly [number, number, number];
+}
+export interface OcclusionPassIdentity {
+    readonly primitiveSlot: number;
+    readonly slotGeneration: number;
+}
+export interface OcclusionPassPlan {
+    readonly after: string;
+    readonly depth: {
+        readonly resource: string;
+        readonly usage: 'depth-read-only';
+    };
+    readonly color: {
+        readonly resource: string;
+        readonly usage: 'not-written';
+    };
+    readonly proxyBounds: OcclusionBounds;
+    readonly queryIndex: number;
+    readonly identity?: OcclusionPassIdentity;
+    readonly resolve: {
+        readonly queryIndex: number;
+        readonly bytes: number;
+    };
+    readonly copy: {
+        readonly asynchronous: true;
+        readonly bytes: number;
+    };
+    readonly writesColor: false;
+    readonly writesDepth: false;
+    readonly submitCount: 1;
+    readonly mapSameFrame: false;
+}
+export interface OcclusionPassInput {
+    readonly opaquePass: string;
+    readonly depthResource: string;
+    readonly colorResource: string;
+    readonly bounds: OcclusionBounds | undefined;
+    readonly queryIndex: number;
+    readonly identity?: OcclusionPassIdentity;
+    readonly transparent?: boolean;
+    readonly deformed?: boolean;
+}
+export interface OcclusionQueryResources {
+    readonly pageIndex: number;
+    readonly querySet: QuerySet;
+    readonly resolveBuffer: Buffer;
+    readonly stagingBuffer: Buffer;
+}
+export declare function createOcclusionQueryResources(device: RhiDevice, pageIndex: number): Result<OcclusionQueryResources, RhiError>;
+/** Records resolve and copy only; caller owns one shared encoder and submit. */
+export declare function recordOcclusionResolve(encoder: RhiCommandEncoder, resources: OcclusionQueryResources, firstQuery: number, queryCount: number): Result<void, RhiError>;
+/** Creates only the transport plan; confidence remains owned by visibility facet/M4. */
+export declare function buildOcclusionPassPlan(input: OcclusionPassInput): OcclusionPassPlan | undefined;
+import type { Buffer, QuerySet, Result, RhiCommandEncoder, RhiDevice, RhiError } from '@forgeax/engine-rhi';
+//# sourceMappingURL=occlusion-pass.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"occlusion-pass.d.ts","sourceRoot":"","sources":["../../../src/scene/visibility/occlusion-pass.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;KAAE,CAAC;IACjF,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC;IAC7E,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAgC3C;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,uBAAuB,EAClC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CA0BxB;AAOD,wFAAwF;AACxF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,SAAS,CAwB/F;AAED,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACT,MAAM,qBAAqB,CAAC"}

package/dist/scene/visibility/occlusion-query-pool.d.ts

@@ -0,0 +1,57 @@
+export declare const OCCLUSION_QUERY_PAGE_COUNT = 3;
+export declare const OCCLUSION_QUERY_PAGE_INDEX_LIMIT = 4096;
+export declare const OCCLUSION_QUERY_RESULT_BYTES = 8;
+export declare const OCCLUSION_QUERY_PAGE_BYTES: number;
+export interface OcclusionQueryIdentity {
+    readonly viewKey: string;
+    readonly attachmentId: string;
+    readonly deviceGeneration: number;
+    readonly worldGeneration: number;
+    readonly primitiveSlot: number;
+    readonly slotGeneration: number;
+}
+export interface OcclusionQueryReservation extends OcclusionQueryIdentity {
+    readonly pageIndex: number;
+    readonly queryIndex: number;
+    readonly reservationId: number;
+}
+export interface OcclusionQueryTicket extends OcclusionQueryIdentity {
+    readonly pageIndex: number;
+    readonly queryIndex: number;
+    readonly reservationId: number;
+    readonly submissionGeneration: number;
+}
+export interface OcclusionQueryPoolInspection {
+    readonly pageCount: number;
+    readonly pageIndexLimit: number;
+    readonly resolveBytes: number;
+    readonly stagingBytes: number;
+    readonly availablePages: number;
+    readonly inFlight: number;
+    readonly disposed: boolean;
+}
+export interface OcclusionQueryCompletion {
+    readonly status: 'accepted' | 'stale';
+    /** M3 transport never suppresses a draw; M4 owns confidence policy. */
+    readonly visible: true;
+}
+/** Renderer-owned bounded query transport; it contains no visibility policy. */
+export declare class OcclusionQueryPool {
+    private readonly pages;
+    private readonly pending;
+    private readonly tickets;
+    private nextReservationId;
+    private disposed;
+    reserve(identity: OcclusionQueryIdentity): OcclusionQueryReservation | undefined;
+    publish(reservation: OcclusionQueryReservation, result: {
+        readonly submitted: boolean;
+        readonly submissionGeneration: number;
+    }): OcclusionQueryTicket | undefined;
+    /** Return an unsubmitted reservation to its bounded page. */
+    cancel(reservation: OcclusionQueryReservation): boolean;
+    complete(ticket: OcclusionQueryTicket, _samples: number): OcclusionQueryCompletion;
+    inspect(): OcclusionQueryPoolInspection;
+    dispose(): void;
+    private releasePage;
+}
+//# sourceMappingURL=occlusion-query-pool.d.ts.map

package/dist/scene/visibility/occlusion-query-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"occlusion-query-pool.d.ts","sourceRoot":"","sources":["../../../src/scene/visibility/occlusion-query-pool.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,gCAAgC,OAAO,CAAC;AACrD,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,0BAA0B,QAC0B,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,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,yBAA0B,SAAQ,sBAAsB;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;IACtC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;CACxB;AAoBD,gFAAgF;AAChF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAGpB;IACF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgD;IACxE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;IACnE,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG,yBAAyB,GAAG,SAAS;IAsBhF,OAAO,CACL,WAAW,EAAE,yBAAyB,EACtC,MAAM,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE,GAC7E,oBAAoB,GAAG,SAAS;IAmBnC,6DAA6D;IAC7D,MAAM,CAAC,WAAW,EAAE,yBAAyB,GAAG,OAAO;IAYvD,QAAQ,CAAC,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,GAAG,wBAAwB;IAclF,OAAO,IAAI,4BAA4B;IAiBvC,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,WAAW;CAMpB"}

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/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.
      */