Class CompactEntityIndex

constructor

• new CompactEntityIndex(
      expressIds: Uint32Array,
      byteOffsets: Uint32Array,
      byteLengths: Uint32Array,
      typeIndices: Uint16Array,
      typeStrings: string[],
      lruMaxSize?: number,
  ): CompactEntityIndex

  Parameters

  • expressIds: Uint32Array
  • byteOffsets: Uint32Array
  • byteLengths: Uint32Array
  • typeIndices: Uint16Array
  • typeStrings: string[]
  • OptionallruMaxSize: number

  Returns CompactEntityIndex

Readonlysize

maxExpressId

• get maxExpressId(): number

  Highest indexed ID in constant time; zero for an empty index.

  Returns number

[iterator]

• "[iterator]"(): IterableIterator<[number, EntityRef]>

  Iterate over all entries (Map-compatible interface). Yields [expressId, EntityRef] pairs.

  Returns IterableIterator<[number, EntityRef]>

clearCache

• clearCache(): void

  Clear the LRU cache (e.g., on model unload).

  Returns void

entries

• entries(): IterableIterator<[number, EntityRef]>

  Iterate over all entries (Map.entries()-compatible).

  Returns IterableIterator<[number, EntityRef]>

estimateMemoryBytes

• estimateMemoryBytes(): number

  Estimate memory usage in bytes.

  Returns number

forEach

• forEach(callback: (value: EntityRef, key: number) => void): void

  forEach (Map-compatible interface).

  Parameters

  • callback: (value: EntityRef, key: number) => void

  Returns void

get

• get(expressId: number): EntityRef | undefined

  Get EntityRef by expressId (Map-compatible interface). Uses LRU cache to avoid repeated object allocation for hot entities.

  Parameters

  • expressId: number

  Returns EntityRef | undefined

getByteRange

• getByteRange(
      expressId: number,
  ): { byteLength: number; byteOffset: number } | undefined

  Get byte offset and length for an expressId without full EntityRef allocation.

  Parameters

  • expressId: number

  Returns { byteLength: number; byteOffset: number } | undefined

getColumns

• getColumns(): CompactEntityIndexColumns

  Borrow numeric backing, valid until its owner detaches it; do not mutate. Cache consumers must not detach. Transport may transfer a retired index.

  Returns CompactEntityIndexColumns

getType

• getType(expressId: number): string | undefined

  Get the type string for an expressId without full EntityRef allocation.

  Parameters

  • expressId: number

  Returns string | undefined

has

• has(expressId: number): boolean

  Check if an expressId exists (Map-compatible interface).

  Parameters

  • expressId: number

  Returns boolean

keys

• keys(): IterableIterator<number>

  Iterate over all expressIds (Map.keys()-compatible).

  Returns IterableIterator<number>

values

• values(): IterableIterator<EntityRef>

  Iterate over all EntityRefs (Map.values()-compatible).

  Returns IterableIterator<EntityRef>