Files
road-compiler/.trellis/spec/frontend/state-management.md
T

13 lines
1.2 KiB
Markdown

# State Management
Use component `useState` for server state, selection, layer visibility and UI filters. Domain hooks own their draft state: ordinary v1 staged overrides remain separate from persisted `WorkbenchState.overrides`; v2 constraints remain inside `EditSession`; signal drafts remain separate until the signal save step.
`src/lib/api.ts` is the sole browser HTTP boundary. Presentational components never call it directly. `App` coordinates the fixed save order: ordinary v1 overrides, v2 document, signal draft, then compile and replace server state.
Whenever App accepts a fresh server `WorkbenchState` (initial load, import, compile,
signal generation, or an accepted junction candidate), it must also refresh the
signal draft's saved baseline. Otherwise discard can restore an older signal geometry
after a later rotation or move.
Do not duplicate the whole `WorkbenchState` in multiple hooks. Hooks may use `setState` to update their owned slice and refs for non-serializable history, but there must be one current server state and one owner for each undo/redo stack. `lane-maneuver` belongs exclusively to v2 direct edit; it must not re-enter the v1 staged array.