EntityStore API

EntityStore is the central entity repository: CRUD, selection, spatial index, and draw order.

Access via cadLayer.store.

CRUD

add

add(entity: EntityBase): void

Add an entity, update the spatial index, emit entity:added.

Parameter	Type	Description
entity	EntityBase	Entity

delete

delete(id: string): void

Delete by id, emit entity:deleted.

Parameter	Type	Description
id	string	Entity id

getById

getById(id: string): EntityBase | undefined

Returns: Entity or undefined.

getAll

getAll(): EntityBase[]

Returns: All entities in draw order.

getAllIds

getAllIds(): string[]

Returns: All entity ids.

---

Selection

select

select(id: string): void

Add to selection, emit selection:changed.

deselect

deselect(id: string): void

Remove from selection.

toggleSelect

toggleSelect(id: string): void

Toggle selection for one id.

clearSelection

clearSelection(): void

Clear selection.

getSelectedIds

getSelectedIds(): string[]

Returns: Selected ids.

getSelectedEntities

getSelectedEntities(): EntityBase[]

Returns: Selected entities.

isSelected

isSelected(id: string): boolean

Returns: Whether id is selected.

Example:

const store = cadLayer.store;

store.select(entity.id);
console.log(store.isSelected(entity.id)); // true
console.log(store.getSelectedIds()); // [entity.id]

store.clearSelection();

---

Draw order

moveToFront

moveToFront(ids: string[]): void

Move to front (drawn last, on top).

moveToBack

moveToBack(ids: string[]): void

Move to back (drawn first, underneath).

moveUp

moveUp(ids: string[]): void

Move up one level.

moveDown

moveDown(ids: string[]): void

Move down one level.

---

Dirty flag

setDirty

setDirty(): void

Mark the store dirty for the next render pass. Call after direct property edits if needed.

---

Properties

spatialIndex

readonly spatialIndex: SpatialIndex

R-tree for spatial queries (box select, hit tests, etc.).

Example:

const hits = cadLayer.store.spatialIndex.search({
  minX: 0, minY: 0,
  maxX: 100, maxY: 100,
});