Construct this over an external byte store.
The store holding the source bytes.
Chunk size in bytes (default 4MiB).
LRU residency cap in chunks (default 16).
Total logical size of the source bytes.
The byte length.
Bytes currently held resident by the provider.
The resident byte count.
Number of resident chunks (telemetry/tests).
The chunk count.
Synchronously acquire a view containing a byte range.
Single-chunk ranges are served as the chunk itself (zero copy); straddling ranges get a standalone merged copy spanning exactly the requested range.
Absolute start of the range.
Length of the range.
The view and its base address.
Make a byte range resident, paging missing chunks from the store and evicting least-recently-used chunks beyond the cap (never the chunks needed by this call).
Absolute start of the range.
Length of the range.
Resolves when resident.
Provider that pages fixed-size chunks from an external store with an LRU residency cap.
Concurrency note:
ensureResidentde-duplicates in-flight chunk loads, so overlapping property reads for neighbouring records fetch each chunk once. Eviction only drops the provider's own reference — any descriptor that acquired a view over the chunk keeps that chunk alive independently, so previously-materialised entities keep working after eviction (they just pin their chunk until the descriptor cache is invalidated).