72 lines
3.3 KiB
Markdown
72 lines
3.3 KiB
Markdown
# Tasks — enterprise-react-control-surface
|
|
|
|
## 0. Pre-flight (non-negotiable)
|
|
|
|
- [ ] 0.1 Confirm clean working tree (`git status` reports nothing) and no in-flight worktrees with uncommitted work (`git worktree list` then `git status` in each)
|
|
- [ ] 0.2 Account for every `.claude/worktrees/*` entry; prune stale ones via `bun scripts/worktree-prune.ts --remove`.
|
|
- [ ] 0.3 Confirm `MANIFEST.md` matches `find packages -maxdepth 3 -name package.json | wc -l`.
|
|
|
|
## 1. Spec authoring
|
|
|
|
- [ ] 1.1 Draft `proposal.md`, `tasks.md`, `specs/react-control-surface/spec.md`
|
|
|
|
## 2. Implementation — atomic controls (each: `.tsx`, `.types.ts`, `.test.tsx`, `.stories.tsx`, `.md`)
|
|
|
|
- [ ] 2.1 `src/controls/knob/`
|
|
- [ ] 2.2 `src/controls/slider-v/` + `slider-h/`
|
|
- [ ] 2.3 `src/controls/button-momentary/` + `button-latching/`
|
|
- [ ] 2.4 `src/controls/switch-2/` + `switch-3/`
|
|
- [ ] 2.5 `src/controls/led/`
|
|
- [ ] 2.6 `src/controls/digital-display/`
|
|
- [ ] 2.7 `src/controls/meter-vu/` + `meter-peak/`
|
|
- [ ] 2.8 `src/controls/meter-spectral/`
|
|
- [ ] 2.9 `src/controls/xy-pad/`
|
|
- [ ] 2.10 `src/controls/jog-wheel/`
|
|
- [ ] 2.11 `src/controls/piano-key/`
|
|
- [ ] 2.12 `src/controls/drum-pad/`
|
|
- [ ] 2.13 `src/controls/text-label/` + `image/`
|
|
|
|
## 3. Grouping + runtime
|
|
|
|
- [ ] 3.1 `src/grouping/group/`, `rack/`, `panel/`
|
|
- [ ] 3.2 `src/runtime/surface.tsx` — `<Surface schema bindings />` walks + renders
|
|
- [ ] 3.3 `src/runtime/binding-registry/binding-registry.ts` — discriminated dispatcher
|
|
- [ ] 3.4 `src/runtime/binding-registry/handlers/{plugin-param, transport, midi-out, midi-in, dmx, compound}.ts`
|
|
|
|
## 4. Skin contract + accessibility
|
|
|
|
- [ ] 4.1 `src/skin/surface-skin-provider.tsx`
|
|
- [ ] 4.2 `src/skin/skin.types.ts` + default CSS-var palette
|
|
- [ ] 4.3 Accessibility audit per control: keyboard ops, ARIA, `prefers-reduced-motion`
|
|
|
|
## 5. Error codes + telemetry
|
|
|
|
- [ ] 5.1 `src/error-codes.ts` — `REACT_CONTROL_SURFACE.{UNKNOWN_KIND, BINDING_HANDLER_MISSING, INVALID_SCHEMA}` via `defineCodes`
|
|
- [ ] 5.2 `src/telemetry/telemetry.ts` — counter `control_surface_interactions_total{kind}`, histogram `control_surface_render_duration_ms`
|
|
|
|
## 6. Tests
|
|
|
|
- [ ] 6.1 Per-control `.test.tsx` covering pointer + keyboard + aria-attribute coverage
|
|
- [ ] 6.2 `tests/runtime.test.tsx` — render a 4-pad drum surface from JSON, assert handler invocation on press
|
|
- [ ] 6.3 `tests/binding-fanout.test.tsx` — `compound` binding fires every handler
|
|
- [ ] 6.4 `tests/accessibility.test.tsx` — `@testing-library/jest-dom` aria + role assertions on every control
|
|
- [ ] 6.5 Every `it(...)` carries `{ timeout: 5000 }` (30000 async)
|
|
|
|
## 7. Documentation
|
|
|
|
- [ ] 7.1 Sibling `.md` per `.tsx`/`.ts` (≥200 words, basic + advanced examples)
|
|
- [ ] 7.2 README with `## Atomic controls` + `## Runtime + bindings` + 3 example surfaces (drum machine, mixer, piano)
|
|
|
|
## 8. Pre-archive verification
|
|
|
|
- [ ] 8.1 `bunx turbo lint typecheck test --filter=@suaveplan/react-control-surface` — green
|
|
- [ ] 8.2 `bunx turbo test:coverage --filter=@suaveplan/react-control-surface` — 100/100/100/100
|
|
- [ ] 8.3 `bunx turbo build --filter=@suaveplan/react-control-surface` — green
|
|
|
|
## 9. Archive
|
|
|
|
- [ ] 9.1 Fold spec delta → `openspec/specs/react-control-surface/spec.md`
|
|
- [ ] 9.2 Move folder → `openspec/archive/<yyyy-mm-dd>-enterprise-react-control-surface/`
|
|
- [ ] 9.3 Refresh `MANIFEST.md`
|
|
- [ ] 9.4 Prune worktree
|