eustatos / nexus-state

71%

Build Type

push

github

Committed by web-flow

Commit Message

refactor(core): atom = identity + logic (state in Store)

ARCHITECTURE: Atom is a label, not state container
- Atoms register lazily on first store.get/set/subscribe()
- State lives in Store, not in Atom
- Global registry stores atom references + metadata only

CHANGES:
- atom.ts: Remove immediate registration, lazy-only
- atom-registry.ts: Store references + metadata (not values)
- StoreImpl.ts: Fast-path registration in createGetter()
- TimeTravelController.ts: Store-specific tracking with DEV warnings

BENEFITS:
✅ SSR Isolation: One atom, different states per store
✅ Time-travel: Snapshots are store-specific
✅ Memory: States GC'd with store, atoms lightweight
✅ Multi-store: Shared atoms work correctly

PERFORMANCE:
- Baseline (atom creation): 25x faster (124ms → 5ms)
- Factory (createReactiveValue): 4x faster (285ms → 67ms)
- Overhead % appears higher due to smaller baseline

TESTS:
- Updated tests for explicit atom access before capture
- 1259/1259 core tests passed
- 99/99 time-travel tests passed

Refs: #71

Coverage Stats

2177 of 2547 branches covered (85.47%)

Branch coverage included in aggregate %.

109 of 117 new or added lines in 3 files covered. (93.16%)

16 existing lines in 3 files now uncovered.

8274 of 12109 relevant lines covered (68.33%)

3053.02 hits per line