Class: SparseSet<Component>

Component storage indexed by entity id. O(1) add / remove / get; dense iteration order is insertion order with swap-remove fills.

m_sparsePool[entityId] → dense index, or TOMBSTONE, or undefined m_densePool[denseIndex] → entityId at that dense position m_componentPool[denseIndex] → the component value

Remove uses swap-remove: copies the last dense entry over the removed slot, updates the moved entity's sparse pointer, then pops. The previous slot is marked TOMBSTONE so a subsequent Has(entityId) returns false even if the sparse slot was 0 (the "zero-index" bug we hit early on).

Type Parameters

Type Parameter
Component

Constructors

Constructor

new SparseSet<Component>(): SparseSet<Component>;

Returns

SparseSet<Component>

Methods

Add()

Add(entityId, component): Component;

Parameters

Parameter	Type
entityId	number
component	Component

Returns

Component

---

Clear()

Clear(): void;

Returns

void

---

Count()

Count(): number;

Returns

number

---

ForEach()

ForEach(callbackFn): void;

Parameters

Parameter	Type
callbackFn	(entityId, component) => void

Returns

void

---

Get()

Get(entityId): Component;

Parameters

Parameter	Type
entityId	number

Returns

Component

---

GetComponents()

GetComponents(): readonly Component[];

Returns

readonly Component[]

---

GetDenseEntities()

GetDenseEntities(): readonly number[];

Returns

readonly number[]

---

Has()

Has(entityId): boolean;

Parameters

Parameter	Type
entityId	number

Returns

boolean

---

Remove()

Remove(entityId): void;

Parameters

Parameter	Type
entityId	number

Returns

void

---

TryGet()

TryGet(entityId): Component | undefined;

Hot-path accessor — single sparse-pool read, no double Has check. Returns the component or undefined if the entity isn't in the set.

Parameters

Parameter	Type
entityId	number

Returns

Component | undefined