states

Module nuspace.shapes.states.

States: the state store, where program declared state lives. Apart from Space.

A space keeps two stores. Space holds what the space is (planes, cells, nesting, runs); States holds what the programs remember:

States
  planes          id -> PlaneStates
    <p>
      state       PlaneState shapes, rerooted here
  cells           id -> CellStates
    <c>           CellState shapes, rerooted here

Keyed by the same ids as Space.planes and Space.cells, and nothing else: no names, no progs, no run info. Flat as Space is, so a cell's state is one lookup away by its id, wherever the cell sits. A plane's own state sits in state rather than at the plane's row, so the row can grow without a state field ever sharing a key. Dropping a plane's state or a cell's is one delete of its subtree.

States is also this store's tag, as Space is the other's: a rerooted chain picks it up and routes to this store's navigator, and a bracket names it to open a snapshot or a transaction here.

CellStates

One cell's state. No slots of its own: the program's CellState shapes fill it.

Path nuspace.shapes.CellStates.

Undocumented: example.

PlaneStates

One plane's state, shared by its cells in state.

Path nuspace.shapes.PlaneStates.

Slots

Undocumented: example.

States

The state store's root: every plane's state and every cell's, by id.

Path nuspace.shapes.States.

Written by programs, through their rerooted CellState and PlaneState slots, and by the ops that drop a plane or cell after its structure.

Slots

Undocumented: example.