@forgeax/engine-render 0.1.20 → 0.1.23

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

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/scene/visibility/budget.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,OAAO,CAAC;AACpD,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,0BAA0B,SAAU,CAAC;AAClD,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,CACpC,qBAAqB,SAAkC,GACtD,gBAAgB,CAiBlB"}

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

@@ -0,0 +1,73 @@
+import { type VisibilityBudget } from './budget';
+import { type ConfidenceEvent, type ConfidenceState } from './occlusion-confidence';
+import { type PrimitiveKey, type ViewKey, type VisibilityCandidate, type VisibilityFacetInspection } from './types';
+interface QueryEntry {
+    readonly view: ViewKey;
+    readonly primitive: PrimitiveKey;
+}
+/**
+ * Renderer-owned CPU visibility state indexed by ViewKey x PrimitiveKey.
+ *
+ * Attachment order is intentionally not part of the key. This keeps world
+ * reorder, detach, and slot ABA recovery generation-safe without a second
+ * lane-specific visibility map.
+ */
+export declare class VisibilityFacetStore {
+    private readonly budget;
+    private readonly views;
+    private readonly confidence;
+    private visibilityRevision;
+    private drawRevision;
+    private queryRevision;
+    private readonly queryEntries;
+    private readonly readyQueryKeys;
+    private readonly inFlightQueryKeys;
+    private readonly queryQueues;
+    /** Intrusive FIFO nodes make removal/requeue O(1), so dequeue never walks stale rows. */
+    private readonly queryNodes;
+    constructor(budget?: VisibilityBudget);
+    visibilityBudget(): VisibilityBudget;
+    /** Monotonic token for confidence changes that can alter draw admission. */
+    get revision(): number;
+    /** Revision for the bounded query-candidate admission set only. */
+    get queryRevisionValue(): number;
+    /** Revision for the active draw admission set (status/queryable identity). */
+    get drawRevisionValue(): number;
+    activateView(key: ViewKey): void;
+    retireView(key: ViewKey): void;
+    detachAttachment(attachmentId: string): void;
+    /** Drop every view/row when a composition owner is detached. */
+    clear(): void;
+    reorderAttachments(_attachmentIds: readonly string[]): void;
+    setCandidate(view: ViewKey, primitive: PrimitiveKey, candidate: VisibilityCandidate): boolean;
+    /** Remove rows that are no longer queryable in the extracted frame. */
+    pruneCandidates(view: ViewKey, activePrimitives: ReadonlySet<string>): void;
+    applyConfidence(view: ViewKey, primitive: PrimitiveKey, event: ConfidenceEvent): ConfidenceState;
+    /** Advance hidden rows on a successful frame, excluding rows queried now. */
+    advanceSuccessfulSubmits(submissionGeneration: number, excluded?: readonly {
+        readonly view: ViewKey;
+        readonly primitive: PrimitiveKey;
+    }[]): void;
+    getConfidence(view: ViewKey, primitive: PrimitiveKey): ConfidenceState;
+    /** Whether this candidate needs a bounded query this frame. */
+    shouldQuery(view: ViewKey, primitive: PrimitiveKey): boolean;
+    drainConfidenceRetests(limit: number): string[];
+    /**
+     * Remove a bounded page of ready query work for one view. Queue entries are
+     * identity keyed, so confidence completion and resource failure can safely
+     * requeue the same primitive without scanning the scene.
+     */
+    dequeueQueryCandidates(view: ViewKey, limit: number): readonly QueryEntry[];
+    /** Put a candidate back after a query page could not be reserved. */
+    requeueQueryCandidate(view: ViewKey, primitive: PrimitiveKey): void;
+    getCandidate(view: ViewKey, primitive: PrimitiveKey): VisibilityCandidate | undefined;
+    beginViewEpoch(view: ViewKey): number;
+    applyCompletion(view: ViewKey, primitive: PrimitiveKey, epoch: number, candidate: VisibilityCandidate): boolean;
+    inspect(): VisibilityFacetInspection;
+    private syncQueryKey;
+    private removeQueryKey;
+    private removeQueuedKey;
+}
+export type { PrimitiveKey, ViewKey, VisibilityCandidate, VisibilityFacetInspection, } from './types';
+export { primitiveKey, primitiveKeyId, viewKey, viewKeyId } from './types';
+//# sourceMappingURL=facet.d.ts.map

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

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

package/dist/scene/visibility/gpu-frame-timing.d.ts

@@ -0,0 +1,41 @@
+/** Renderer-owned timestamp facts spanning one graph and one queue submit. */
+export interface GpuFrameTimingProtocol {
+    readonly firstMarker: 'frame.first-pass';
+    readonly terminalMarker: 'occlusion.resolve-copy';
+    readonly sameGraph: true;
+    readonly sameSubmit: true;
+}
+export interface GpuFrameTiming {
+    readonly frameId: number;
+    readonly deviceGeneration: number;
+    readonly protocol: GpuFrameTimingProtocol;
+    aborted: boolean;
+    submitId: number | undefined;
+}
+export interface GpuFrameTimingRecord {
+    readonly firstPassTimestampNs: number;
+    readonly occlusionResolveTimestampNs: number;
+    readonly submitted: boolean;
+    readonly graphGeneration: number;
+    readonly submitId: number;
+}
+export interface GpuFrameTimingSample {
+    readonly frameId: number;
+    readonly deviceGeneration: number;
+    readonly durationUs: number;
+    readonly protocol: GpuFrameTimingProtocol;
+    readonly graphGeneration: number;
+    readonly submitId: number;
+}
+export interface GpuFrameTimingSummary {
+    readonly medianUs: number;
+    readonly p95Us: number;
+    readonly samples: number;
+}
+export declare function createGpuFrameTiming(input: {
+    readonly frameId: number;
+    readonly deviceGeneration: number;
+}): GpuFrameTiming;
+export declare function recordGpuFrameTiming(timing: GpuFrameTiming, record: GpuFrameTimingRecord): GpuFrameTimingSample;
+export declare function summarizeGpuFrameTiming(samples: readonly GpuFrameTimingSample[]): GpuFrameTimingSummary;
+//# sourceMappingURL=gpu-frame-timing.d.ts.map

package/dist/scene/visibility/gpu-frame-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-frame-timing.d.ts","sourceRoot":"","sources":["../../../src/scene/visibility/gpu-frame-timing.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,wBAAwB,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AASD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC,GAAG,cAAc,CAEjB;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,oBAAoB,GAC3B,oBAAoB,CA2BtB;AAOD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,oBAAoB,EAAE,GACvC,qBAAqB,CAOvB"}

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

@@ -0,0 +1,46 @@
+import { type LodSelection } from './lod-selector';
+export declare const GPU_LOD_ROW_SCHEMA: {
+    name: string;
+    fields: ({
+        name: string;
+        type: "u32";
+    } | {
+        name: string;
+        type: "i32";
+    } | {
+        name: string;
+        type: "f32";
+    })[];
+};
+export declare const GPU_LOD_ROW_LAYOUT: import("../../gpu-scene-schema").GpuSceneTableLayout;
+export interface LodDrawRange {
+    readonly firstIndex: number;
+    readonly indexCount: number;
+    readonly baseVertex: number;
+}
+export interface GpuLodRowsInput {
+    readonly generation: number;
+    readonly hysteresis: number;
+    readonly ranges: readonly LodDrawRange[];
+    /** Absolute projected-height thresholds, including root at index zero. */
+    readonly coverages: readonly number[];
+    readonly ready: readonly boolean[];
+}
+export interface GpuLodRow extends LodDrawRange {
+    readonly generation: number;
+    readonly level: number;
+    readonly screenCoverage: number;
+    readonly hysteresis: number;
+    readonly ready: boolean;
+}
+/** Projects one stable row per draw range; it never contains a per-view choice. */
+export declare function buildGpuLodRows(input: GpuLodRowsInput): readonly GpuLodRow[];
+export declare function encodeGpuLodRows(rows: readonly GpuLodRow[]): Uint8Array;
+export interface GpuLodSelectionInput {
+    readonly projectedHeight: number;
+    readonly previousLevel: number;
+    readonly historyValid: boolean;
+}
+/** CPU reference used by both the GPU selector contract and unsupported fallback. */
+export declare function selectGpuLod(rows: readonly GpuLodRow[], input: GpuLodSelectionInput): LodSelection;
+//# sourceMappingURL=gpu-lod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-lod.d.ts","sourceRoot":"","sources":["../../../src/scene/visibility/gpu-lod.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAa,MAAM,gBAAgB,CAAC;AAE9D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;CAAwB,CAAC;AACxD,eAAO,MAAM,kBAAkB,sDAAwB,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAgBD,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,SAAS,EAAE,CAkC5E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,UAAU,CAevE;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,SAAS,EAAE,EAC1B,KAAK,EAAE,oBAAoB,GAC1B,YAAY,CAWd"}

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

@@ -0,0 +1,132 @@
+/** Detached, bounded LOD/occlusion facts for renderer inspection consumers. */
+export declare const LOD_OCCLUSION_INSPECTION_SCHEMA: "forgeax::lod-occlusion-inspection::v2";
+export declare const LOD_OCCLUSION_INSPECTION_MAX_BYTES: number;
+export type LodOcclusionInspectionError = {
+    readonly code: string;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail?: Readonly<Record<string, string | number | boolean>>;
+};
+export type LodOcclusionFallback = {
+    readonly active: false;
+} | {
+    readonly active: true;
+    readonly reason: 'producer-failed' | 'page-exhausted' | 'query-failed' | 'device-loss';
+    readonly error: LodOcclusionInspectionError;
+};
+export type LodOcclusionDegradation = {
+    readonly active: false;
+} | {
+    readonly active: true;
+    readonly reason: 'all-visible' | 'query-unavailable';
+};
+export interface LodOcclusionInspectionSample {
+    readonly primitiveSlot: number;
+    readonly level: number;
+    readonly visible: boolean;
+}
+export interface LodOcclusionInspectionRow {
+    readonly root: {
+        readonly guid: string;
+        readonly sourceKey: string;
+    };
+    readonly view: {
+        readonly attachmentId: string;
+        readonly cameraEntity: number;
+        readonly viewRole: 'main' | 'shadow' | 'reflection' | 'probe';
+        readonly viewGeneration: number;
+    };
+    readonly slot: {
+        readonly primitiveSlot: number;
+        readonly slotGeneration: number;
+    };
+    readonly generation: number;
+    readonly count: {
+        readonly candidates: number;
+        readonly visible: number;
+        readonly occluded: number;
+    };
+    readonly lodHistogram: readonly {
+        readonly level: number;
+        readonly count: number;
+    }[];
+    /** Map latency for the most recently completed query page (bounded POD). */
+    readonly queryLatencyUs: {
+        readonly median: number;
+        readonly p95: number;
+        readonly last: number;
+    };
+    readonly pagePressure: {
+        readonly used: number;
+        readonly capacity: number;
+    };
+    readonly fallback: LodOcclusionFallback;
+    readonly degradation: LodOcclusionDegradation;
+    readonly samples: readonly LodOcclusionInspectionSample[];
+}
+export interface LodOcclusionInspectionSubmit {
+    readonly frameId: number;
+    readonly build: string;
+    readonly deviceGeneration: number;
+}
+/**
+ * Per-World attribution is only authoritative when the renderer publishes
+ * the GPU facts from the same submit that owns the parent inspection.  The
+ * normal projection path remains useful diagnostics, but it must not be used
+ * as evidence for a World-reorder or per-World LOD claim.
+ */
+export type LodOcclusionWorldAttribution = {
+    readonly status: 'unavailable';
+    readonly reason: 'projection-only';
+} | {
+    readonly status: 'same-submit';
+    readonly submit: LodOcclusionInspectionSubmit;
+};
+export interface LodOcclusionWorldInspection {
+    readonly attachmentId: string;
+    readonly rows: readonly LodOcclusionInspectionRow[];
+    readonly attribution: LodOcclusionWorldAttribution;
+}
+export interface LodOcclusionInspectionBudget {
+    readonly configuredQueryBudget: number;
+    readonly effectiveQueryBudget: number;
+    readonly settleSubmits: number;
+    readonly retestSubmits: number;
+    readonly expirySubmits: number;
+}
+export interface LodOcclusionInspection extends LodOcclusionInspectionRow {
+    readonly schema: typeof LOD_OCCLUSION_INSPECTION_SCHEMA;
+    /** Atomic identity for the submit that produced every row below. */
+    readonly submit: LodOcclusionInspectionSubmit;
+    /** Immutable budget values used by the query and confidence owners. */
+    readonly budget: LodOcclusionInspectionBudget;
+    /** Stable attachment identity; array order is never an attribution key. */
+    readonly worlds: readonly LodOcclusionWorldInspection[];
+}
+export type LodOcclusionInspectionInput = Omit<LodOcclusionInspection, 'schema' | 'submit' | 'budget' | 'worlds'> & {
+    readonly submit?: LodOcclusionInspectionSubmit;
+    readonly budget?: LodOcclusionInspectionBudget;
+    readonly worlds?: readonly LodOcclusionWorldInspectionInput[];
+};
+export type LodOcclusionWorldInspectionInput = Omit<LodOcclusionWorldInspection, 'attribution'> & {
+    readonly attribution?: LodOcclusionWorldAttribution;
+};
+export type LodOcclusionInspectionAction = {
+    readonly action: 'none';
+} | {
+    readonly action: 'rebuild';
+    readonly sourceKey: string;
+    readonly reason: string;
+} | {
+    readonly action: 'cold-cook';
+    readonly sourceKey: string;
+    readonly reason: string;
+} | {
+    readonly action: 'retry';
+    readonly sourceKey: string;
+    readonly reason: string;
+};
+export declare function inspectLodOcclusion(input: LodOcclusionInspectionInput): LodOcclusionInspection;
+export declare function serializeLodOcclusionInspection(inspection: LodOcclusionInspection): string;
+export declare function consumeLodOcclusionInspection(inspection: LodOcclusionInspection): LodOcclusionInspectionAction;
+//# sourceMappingURL=inspection.d.ts.map

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

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

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"}