77 lines
2.7 KiB
Markdown
77 lines
2.7 KiB
Markdown
# Tasks — r3f-networking
|
|
|
|
## Phase 1: Scaffold
|
|
|
|
- [ ] 1.1 Create `packages/r3f/r3f-networking/` with feature-module layout.
|
|
- [ ] 1.2 `package.json` at `0.1.0`, R3F-tier (peer-deps on `react`, `three`, `@react-three/fiber`).
|
|
- [ ] 1.3 Test config + browser environment via `createTestConfig()`.
|
|
- [ ] 1.4 `tests/dep-graph.test.ts`.
|
|
|
|
## Phase 2: Audit upstream layout
|
|
|
|
- [ ] 2.1 Read `../suaveplan/packages/three/r3f-networking/src/` end-to-end.
|
|
- [ ] 2.2 Populate parity table with concrete file → capability mapping.
|
|
|
|
## Phase 3: Types + errors
|
|
|
|
- [ ] 3.1 Port public types + sibling `.md`.
|
|
- [ ] 3.2 `defineCodes("R3F_NET", [...])`: `SNAPSHOT_OUT_OF_ORDER`, `PEER_DROPPED`, `PREDICTION_DIVERGED`, `INVALID_OPTIONS`.
|
|
- [ ] 3.3 Zod schemas for snapshot frames + public options.
|
|
|
|
## Phase 4: Interpolation subsystem
|
|
|
|
- [ ] 4.1 Port frame-loop smoothing for remote-peer transforms.
|
|
- [ ] 4.2 Backed by injectable `Clock` from `@suaveplan/types`.
|
|
- [ ] 4.3 Property test: interpolation monotonicity.
|
|
|
|
## Phase 5: Prediction + reconciliation
|
|
|
|
- [ ] 5.1 Port local input application.
|
|
- [ ] 5.2 Reconciliation FSM via `@suaveplan/fsm`.
|
|
- [ ] 5.3 Property test: divergence detection + convergence on reconcile.
|
|
|
|
## Phase 6: Snapshot diffing
|
|
|
|
- [ ] 6.1 Wire `@suaveplan/diff` for RFC-6902 patches between snapshots.
|
|
- [ ] 6.2 Wire-format encoding via `@suaveplan/serialize`.
|
|
- [ ] 6.3 Property test: round-trip equivalence.
|
|
|
|
## Phase 7: React + R3F components
|
|
|
|
- [ ] 7.1 `useNetworkedTransform` hook.
|
|
- [ ] 7.2 `useNetworkedEntity` hook.
|
|
- [ ] 7.3 `useNetworkPredict` hook.
|
|
- [ ] 7.4 `<NetworkProvider>` context.
|
|
- [ ] 7.5 `<NetworkedMesh>` and friends.
|
|
- [ ] 7.6 Storybook stories per component (default + playground + variants).
|
|
|
|
## Phase 8: Observability
|
|
|
|
- [ ] 8.1 Histograms `r3f_net.snapshot_dispatch_ms`, `prediction_divergence`.
|
|
- [ ] 8.2 Counters `snapshots_total{outcome}`.
|
|
- [ ] 8.3 Bus emissions for join/leave/snapshot.
|
|
|
|
## Phase 9: Tests + docs
|
|
|
|
- [ ] 9.1 Unit tests via `@suaveplan/testing/runner` + `@suaveplan/testing-dom`.
|
|
- [ ] 9.2 Playwright E2E: 2-client scene over `network-transport-webrtc` via `@suaveplan/testing-e2e`.
|
|
- [ ] 9.3 100/100/100/100 coverage gate.
|
|
- [ ] 9.4 Sibling `.md` per `.ts` impl file.
|
|
- [ ] 9.5 Root `README.md`.
|
|
|
|
## Phase 10: Verification
|
|
|
|
- [ ] 10.1 `bunx turbo lint typecheck test --filter=@suaveplan/r3f-networking` green.
|
|
- [ ] 10.2 `bunx turbo test:coverage --filter=@suaveplan/r3f-networking` 100/100/100/100.
|
|
- [ ] 10.3 `bun run docs:check` green.
|
|
- [ ] 10.4 Stories cover every component.
|
|
- [ ] 10.5 `MANIFEST.md` regen.
|
|
- [ ] 10.6 `STATUS.md` row flipped.
|
|
|
|
## Pre-archive checklist
|
|
|
|
- [ ] Row 1 — Phase 10 green.
|
|
- [ ] Row 2 — Playwright E2E passes.
|
|
- [ ] Row 3 — `openspec/specs/r3f-networking/spec.md` written.
|
|
- [ ] Row 4 — Folder archived.
|