OptionalenergyTable: readonly (number | null | undefined)[]OptionalsliceCache: SliceCache | nullOptionallevelOffsets: readonly number[] | nullPrivatelodPrivateloadedPrivate_Private_PrivatelastPrivatenPrivatemonitorPrivate_Private_Private_Private_Private_Private_Private_Private_Private_PrivateenergyPrivate ReadonlylevelPrivate_Private ReadonlypathPrivate ReadonlyslicePrivate_Private_Pinned rung count for the current pass (ViewState.ladderDepth, the
playback "detail" setting), resolved through resolveLadderDepth; null
when the pass is not pinned. A pinned pass loads exactly this many rungs,
cold or not, and reports hasMoreLODs === false like a budgeted one — the
pinned prefix IS the target.
Whether more LOD levels remain to load for the current view state.
Cumulative energy fraction e(k) ∈ [0, 1] of the currently loaded LOD
prefix — how much of this ladder's total self-energy the committed
chunks carry (the additive orderer's own ranking criterion, stamped at
build time as lod_stats.energy_fraction_cum). null when the dataset
carries no energy stamps; 0 before any LOD loads. Read at commit time
by stampLadderComplete (→ the committedEnergyFraction mesh stamp)
for the display gate's energy-threshold upgrade release.
Whether the most recently streamed LOD level was fully cache-resident.
Drives the monitor's residency indicator. Defaults to true.
Private ReadonlywarnMeasured footprint of the loaded ladder, for the shared sweep residency
budget (scene-loader/progressive/residency-budget). Sums real
byteLengths rather than modelling a per-element cost. Rung count comes
from _loadedLODCount (LOGICAL levels), not loadedLODs.length, which is
1 once the ladder has folded.
Discard the levels the current pass appended, restoring the ladder to the
prefix the pass started from. Called by the main-update and refinement catches;
see ../loaders/progressive/pass-rollback for why a failed commit must
not leave the cursor advanced.
Levels discarded (0 when the pass appended none).
Load points data for the given view state
Optionalsession: UpdateSessionOptionalsignal: AbortSignalUpdate existing data for a new view state.
Optionalsession: UpdateSessionOptionalsignal: AbortSignal
Optional per-update abort signal. When it fires (a newer
view-state superseded this one), in-flight chunk reads/decodes bail with
an AbortError instead of running to completion.
OptionalresidencyAllowanceBytes: numberPrivateconcatenateConcatenate loaded LODs, memoized on (resetGeneration, LOD count). An unchanged view state with no new LODs returns the SAME object reference — safe because the result is never mutated downstream (worker projection inputs are structured-cloned, not transferred) — letting the commit pipeline skip no-op re-commits by identity.
Each fresh result is also stamped with a PREFIX-LINEAGE parent (the
previous same-generation memo) via setPrefixParent, so the
commit layer can recognise a genuine prefix-extension and take the
append fast path (depth-sorting Phase 4 Stage 2). The parent is null
for the first level of a generation (a view change bumps the reset
generation and empties loadedLODs), which is correct — the first
commit extends nothing. Mirrors GSplatsProgressiveLoader.
Optionalsession: UpdateSessionPrivateprefetchLoaderMonitor surface (optional, for the data-loading-monitor UI).
Mirrors the surface that points-spatial-index-loader.ts exposes —
implementations that don't track metrics may omit these methods.
Symmetric with LinesDataLoader / GSplatsDataLoader.
Clean up resources
Progressive Points loader.