add reconciler implementation plan: 6-phase spec with dependency graph and parallelism analysis

This commit is contained in:
2026-05-18 13:48:14 +00:00
parent ba74afd0b3
commit e22598f4d1
8 changed files with 1644 additions and 0 deletions

View File

@@ -41,6 +41,18 @@ All research documents for the `@alkdev/ujsx` rewrite. This project is a univers
| `/workspace/signals/packages/core/` | Preact Signals core: signal, computed, effect, batch, createModel |
| `/workspace/conversations/research/` | Original research docs from conversation session |
## Reconciler Implementation Plan
| Doc | Description |
|-----|-------------|
| [reconciler/README.md](./reconciler/README.md) | **Index** — Phase overview, dependency graph, parallelism opportunities, key design decisions |
| [reconciler/00-KEY-FIELD-DESIGN.md](./reconciler/00-KEY-FIELD-DESIGN.md) | Phase 0: Add `key?: string` as first-class field on `UElement` |
| [reconciler/01-reactive-host-bridge.md](./reconciler/01-reactive-host-bridge.md) | Phase 1: Connect reactive layer to HostConfig reconciler via fiber tree |
| [reconciler/02-key-based-children-reconciliation.md](./reconciler/02-key-based-children-reconciliation.md) | Phase 2: Key-based children matching with LIS algorithm for move detection |
| [reconciler/03-unmount-dispose-support.md](./reconciler/03-unmount-dispose-support.md) | Phase 3: Proper disposal — unmount, signal cleanup, instance teardown |
| [reconciler/04-typebox-optimization-layer.md](./reconciler/04-typebox-optimization-layer.md) | Phase 4: TypeBox Value primitives as incremental performance optimizations |
| [reconciler/05-flowgraph-host-configs.md](./reconciler/05-flowgraph-host-configs.md) | Phase 5: Flowgraph HostConfig implementations (graphology DAG, reactive executor) |
## Key Decisions from Prior Discussion
1. **TypeBox Module IS the type registry** — no separate registry needed. `ValuePointer.Get/Set` for runtime access, `Module.Import` for resolved schemas.