@forgeax/engine-render 0.1.21 → 0.1.24

package/dist/scene/render-scene.d.ts

@@ -2,16 +2,26 @@ import type { World } from '@forgeax/engine-ecs';
 import type { RenderReadLease } from '@forgeax/engine-ecs/projection';
 import { type RhiDevice, RhiError } from '@forgeax/engine-rhi';
 import { type Result } from '@forgeax/engine-types';
+import type { DeviceScope, LifecycleResourceSpec } from '../device/device-scope';
 import { type SubmissionPlan } from '../gpu-driven/batch-topology';
 import { GpuScene } from '../gpu-scene';
 import type { PersistentRenderSceneInspection } from '../inspection-types';
 import type { PointsLinesInspection } from '../points-lines/inspection';
 import type { PointsLinesRetainedSnapshot } from '../points-lines/snapshot';
 import { type ReflectionProbeFact, ReflectionProbeProjection, type ReflectionProbeSelectionResult } from '../reflection/projection';
-import type { ExtractedFrame, MaterialSnapshotCachesByWorld, RenderableSnapshot, RenderableTemporalSnapshot } from '../render-system-extract';
+import type { CameraSnapshot } from '../render-contract';
+import type { DispatchEntry, ExtractedFrame, MaterialSnapshotCachesByWorld, RenderableSnapshot, RenderableTemporalSnapshot } from '../render-system-extract';
 import { type TransmissionDemand } from '../transmission/projection';
-import type { RenderSceneApplyResult, RenderSceneBounds, RenderSceneDelta, RenderSceneInspection, RenderSceneOperation, RenderSceneSlot } from './render-scene-types';
-export type { RenderSceneApplyResult, RenderSceneBounds, RenderSceneDelta, RenderSceneIdentity, RenderSceneInspection, RenderSceneOperation, RenderSceneRecord, RenderSceneResyncReason, RenderSceneSlot, } from './render-scene-types';
+import type { RenderSceneApplyResult, RenderSceneBounds, RenderSceneInspection, RenderSceneOperation, RenderSceneSlot } from './render-scene-types';
+import { type VisibilityBudget } from './visibility/budget';
+import { VisibilityFacetStore } from './visibility/facet';
+import type { PrimitiveKey, ViewKey, VisibilityCandidate } from './visibility/types';
+export type { RenderSceneApplyResult, RenderSceneBounds, RenderSceneIdentity, RenderSceneInspection, RenderSceneOperation, RenderSceneRecord, RenderSceneResyncReason, RenderSceneSlot, } from './render-scene-types';
+interface WorldTransformSpan {
+    readonly worldId: number;
+    readonly entities: Readonly<Uint32Array>;
+    readonly worlds: Readonly<Float32Array>;
+}
 export interface RenderSceneSubmissionCapture {
     readonly revision: number;
     readonly slots: readonly {
@@ -34,14 +44,17 @@ export interface RenderSceneSubmissionDelta {
 export declare class RenderScene {
     private readonly slots;
     private readonly lastSubmittedSlots;
+    private readonly previousWorldBySlot;
     private readonly generations;
     private readonly freeSlots;
     private readonly slotsByWorld;
     private readonly slotsByMaterial;
     private readonly dirtySinceSubmitted;
+    private readonly transformUpdatedSlots;
+    private temporalTracking;
     private lastSubmittedVisible;
     private submittedEpoch;
-    private readonly worldBoundsCache;
+    private readonly worldBoundsBySlot;
     private readonly instanceBoundsCache;
     private orderedSlots;
     private materialized;
@@ -56,11 +69,14 @@ export declare class RenderScene {
     /** Bounded current-scene facts for the Standard temporal producer. */
     temporalContributorCount(): number;
     apply(operations: readonly RenderSceneOperation[]): RenderSceneApplyResult;
-    applyDelta(delta: RenderSceneDelta): RenderSceneApplyResult;
+    /** Apply version-selected GlobalTransform columns without allocating per-entity operations. */
+    applyTransformSpans(spans: readonly WorldTransformSpan[]): RenderSceneApplyResult;
     /** Reconcile the current identity set while retaining slots for survivors. */
     reset(snapshots: readonly RenderableSnapshot[], countAsRebuild?: boolean): void;
     rebuild(snapshots: readonly RenderableSnapshot[]): void;
-    materialize(): readonly RenderableSnapshot[];
+    /** Enable previous-frame publication only while a temporal feature consumes it. */
+    setTemporalTracking(enabled: boolean): void;
+    materialize(): RenderableSnapshot[];
     lastSubmittedSlotByIndex(slot: number): RenderSceneSlot | undefined;
     temporalSnapshotBySlot(slot: number): RenderableTemporalSnapshot | undefined;
     withTemporal(snapshot: RenderableSnapshot): RenderableSnapshot;
@@ -89,21 +105,73 @@ export declare class RenderScene {
      * bounds for its independent per-instance visibility pass. Unknown or
      * empty instance facts deliberately return undefined (conservative no-cull).
      */
+    cullingWorldBoundsAt(slot: RenderSceneSlot): RenderSceneBounds | undefined;
     cullingWorldBounds(snapshot: RenderableSnapshot): RenderSceneBounds | undefined;
 }
 export interface PersistentRenderSceneOptions {
     readonly getDevice?: (() => RhiDevice) | undefined;
     readonly onGpuError?: ((error: RhiError) => void) | undefined;
     readonly onSharedRefMutation?: ((worldId: number, handle: number) => void) | undefined;
+    readonly configuredQueryBudget?: number | undefined;
 }
 export interface PersistentGpuDrivenState {
     readonly scene: GpuScene;
     readonly plan: SubmissionPlan;
     readonly slots: readonly RenderSceneSlot[];
+    /** Stable renderer-local World keys aligned with RenderSceneSlot.worldId. */
+    readonly worldKeys?: readonly number[];
+}
+export interface CpuDirectViewInput {
+    readonly view: ViewKey;
+    readonly primitives: readonly PrimitiveKey[];
+}
+export interface CpuDirectCandidate {
+    readonly view: ViewKey;
+    readonly primitive: PrimitiveKey;
+    readonly candidate: VisibilityCandidate;
+}
+/**
+ * The one renderer-owned submission projection for a display view.
+ *
+ * Occlusion completion updates the facet asynchronously, so extraction must
+ * retain every query candidate while record/prepare consume this projection.
+ * Keeping the dispatch reindex here prevents CPU direct and GPU indirect
+ * lanes from rebuilding a second visibility map with different identity
+ * semantics.
+ */
+export interface PersistentVisibilityProjection {
+    readonly renderables: readonly RenderableSnapshot[];
+    readonly dispatch: readonly DispatchEntry[];
+    readonly activeEntityKeys: ReadonlySet<number>;
+    /** Monotonic owner revision for exactly this active-key projection. */
+    readonly activeEntityRevision: number;
+    readonly suppressed: number;
+}
+/** Project one selected candidate per view and primitive from the facet owner. */
+export declare function projectCpuDirectCandidates(facets: VisibilityFacetStore, views: readonly CpuDirectViewInput[]): readonly CpuDirectCandidate[];
+/** Detached GPU scene prepared from the retained CPU composition. */
+export interface PersistentGpuDrivenCandidate {
+    readonly state: PersistentGpuDrivenState | undefined;
+    /** Candidate-owned scene root; never references the active GPU scene. */
+    createRecoveryRoot(scope: DeviceScope): LifecycleResourceSpec<unknown>;
+    publish(): void;
+    discard(): void;
+    /** Release the candidate scene even after it has crossed publication. */
+    release(): void;
+}
+export interface RenderSceneRecoveryRoot {
+    readonly generation: number;
+    readonly revision: number;
+    readonly visibleSlots: number;
 }
 /** Persistent scene projection used by the renderer's multi-World composition path. */
 export declare class PersistentRenderScene {
     private readonly options;
+    private readonly visibilityBudget;
+    private readonly visibilityFacets;
+    /** World identity is the author/runtime identity; array position is only a frame routing detail. */
+    private readonly visibilityWorldKeys;
+    private nextVisibilityWorldKey;
     private readonly materialSnapshotCaches;
     private fullRebuilds;
     private worldEntitiesScanned;
@@ -117,11 +185,52 @@ export declare class PersistentRenderScene {
     private gpuDevice;
     private gpuStatus;
     private temporalCapture;
+    /** Monotonic token for camera/dynamic frame facts consumed by visibility caches. */
+    private frameEpoch;
+    private visibilityFacetFrame;
+    private visibilityProjectionCache;
+    private visibilityProjectionRevision;
+    private lastActiveEntityKeys;
+    /** Stable renderer-world/entity lookup; rebuilt only with composition topology. */
+    private readonly stableSlotByEntity;
     private pointsLinesInspections;
     private readonly reflectionProbes;
     constructor(options?: PersistentRenderSceneOptions);
     /** RenderScene owns the per-World material fact cache used during extraction. */
     materialSnapshotCacheStore(): MaterialSnapshotCachesByWorld;
+    /** The sole renderer-owned ViewKey x PrimitiveKey visibility state. */
+    visibilityFacetStore(): VisibilityFacetStore;
+    visibilityBudgetValue(): VisibilityBudget;
+    private visibilityWorldKey;
+    private worldKeyAt;
+    /** Stable World routing keys for the current worlds[] frame projection. */
+    visibilityWorldKeysFor(worlds: readonly World[]): readonly number[];
+    /** Current retained slots, available to CPU query transport as well as GPU. */
+    compositionSlots(): readonly RenderSceneSlot[];
+    /** Stable renderer-world/entity lookup shared by query and final projection paths. */
+    compositionSlotByStableEntity(): ReadonlyMap<number, RenderSceneSlot>;
+    private stableEntityKey;
+    /** Feed the facet from extracted renderables using persistent slot identity. */
+    updateVisibilityFacet(worlds: readonly World[], camera: CameraSnapshot | undefined, renderables: readonly RenderableSnapshot[]): void;
+    /**
+     * Project the current facet into the final primary-raster submission.
+     *
+     * Only renderables carrying authored lower-detail levels are queryable. A
+     * plain mesh therefore remains on the ordinary visibility path, while an
+     * LOD candidate with two accepted zero-sample results is suppressed until
+     * the confidence scheduler requests its bounded re-test. Unknown identity,
+     * invalid bounds, and non-queryable confidence all remain conservatively
+     * visible through `decideVisibility`.
+     */
+    projectVisibility(worlds: readonly World[], camera: CameraSnapshot | undefined, renderables: readonly RenderableSnapshot[], dispatch: readonly DispatchEntry[]): PersistentVisibilityProjection;
+    /**
+     * Advance the projection revision only when the active stable-entity set
+     * changes. Camera fingerprints and scene-plan identity cover view/topology
+     * changes; keeping this token set-stable preserves the GPU filtered-plan
+     * cache on ordinary no-change frames.
+     */
+    private activeEntityRevision;
+    private invalidateActiveEntityRevision;
     /** Project probe facts and per-primitive selection into the persistent scene owner. */
     projectReflectionProbes(probes: readonly ReflectionProbeFact[]): void;
     reflectionProbeSelection(worldId: number, entityKey: number): ReflectionProbeSelectionResult;
@@ -129,12 +238,15 @@ export declare class PersistentRenderScene {
     extractComposition(worlds: readonly World[], owner: {
         readonly cameraOwner: number;
         readonly resourceOwner: number;
-    }, catalogEpoch: number, buildCandidateFrame: () => ExtractedFrame, leases?: readonly RenderReadLease[]): ExtractedFrame;
+    }, catalogEpoch: number, buildCandidateFrame: (renderables: 'full' | 'none') => ExtractedFrame, leases?: readonly RenderReadLease[]): ExtractedFrame;
     invalidate(): void;
-    setCompositionGpuDrivenCoverage(key: string, ownsAll: boolean): void;
+    setCompositionGpuSceneDemand(sceneRowsRequired: boolean): void;
     detach(world: World): void;
     /** Drop only device-owned tables; the CPU projection remains the recovery authority. */
     resetGpuForRecover(): void;
+    /** Prepare a detached GPU scene without changing the active scene owner. */
+    prepareRecoveryGpuDrivenCandidate(device: RhiDevice): Result<PersistentGpuDrivenCandidate, RhiError>;
+    createRecoveryRoot(scope: DeviceScope): LifecycleResourceSpec<unknown>;
     setPointsLinesInspections(inspections: readonly PointsLinesInspection[]): void;
     dispose(): void;
     inspect(): PersistentRenderSceneInspection;
@@ -150,9 +262,10 @@ export declare class PersistentRenderScene {
     transmissionTopologyDemand(): TransmissionDemand;
     /**
      * Derive an ephemeral frame plan from persistent scene facts. The scene
-     * retains identity/topology/cursors; no prior frame object is an authority.
+     * retains identity/topology/read versions; no prior frame object is an authority.
      */
     private deriveFramePlan;
+    private projectProbes;
     private syncGpuOwner;
     private acquireGpuScene;
     private failGpu;

package/dist/scene/render-scene.d.ts.map

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

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

@@ -0,0 +1,20 @@
+export interface ConservativeBounds {
+    readonly min: readonly [number, number, number];
+    readonly max: readonly [number, number, number];
+}
+export interface BoundsCandidate {
+    readonly bounds: ConservativeBounds | undefined;
+    readonly transparent: boolean;
+    readonly deformed: boolean;
+}
+export declare function conservativeBounds(localMin: readonly [number, number, number], localMax: readonly [number, number, number]): ConservativeBounds;
+export declare function encloseBounds(boundsList: readonly (ConservativeBounds | undefined)[]): ConservativeBounds | undefined;
+export declare function conservativeVisibleCandidate(candidate: BoundsCandidate): {
+    readonly visible: true;
+    readonly queryable: false;
+} | {
+    readonly visible: false;
+    readonly queryable: true;
+    readonly bounds: ConservativeBounds;
+};
+//# sourceMappingURL=bounds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.d.ts","sourceRoot":"","sources":["../../../src/scene/visibility/bounds.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,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,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC3C,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC1C,kBAAkB,CAapB;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,SAAS,CAAC,kBAAkB,GAAG,SAAS,CAAC,EAAE,GACtD,kBAAkB,GAAG,SAAS,CAchC;AAED,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,eAAe,GAExB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,CAK7F"}

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

@@ -0,0 +1,16 @@
+export declare const DEFAULT_CONFIGURED_QUERY_BUDGET = 2048;
+export declare const MAX_QUERY_BUDGET = 4096;
+export declare const VISIBILITY_CANDIDATE_COUNT = 100000;
+export declare const VISIBILITY_OCCLUDED_COUNT = 90000;
+export interface VisibilityBudget {
+    readonly configuredQueryBudget: number;
+    readonly effectiveQueryBudget: number;
+    readonly oneSweepCandidates: number;
+    readonly oneSweepOccluded: number;
+    readonly settleSubmits: number;
+    readonly retestSubmits: number;
+    readonly expirySubmits: number;
+}
+/** Derive every renderer visibility window from one bounded query budget. */
+export declare function createVisibilityBudget(configuredQueryBudget?: number): VisibilityBudget;
+//# sourceMappingURL=budget.d.ts.map

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