39 lines
2.6 KiB
Markdown
39 lines
2.6 KiB
Markdown
# React / R3F audio wave — rewrite COMPLETE
|
|
|
|
**Rewrite date**: 2026-05-15
|
|
**Previous flag**: `NEEDS-REWRITE` (predated 2026-05-14 architecture shift)
|
|
|
|
All five proposals have been rewritten against the unified architecture:
|
|
|
|
| Change folder | Spec delta | Design |
|
|
|---|---|---|
|
|
| `openspec/changes/enterprise-react-audio/` | `specs/react-audio/spec.md` | `design.md` |
|
|
| `openspec/changes/enterprise-react-audio-player/` | `specs/react-audio-player/spec.md` | `design.md` |
|
|
| `openspec/changes/enterprise-react-audio-stream/` | `specs/react-audio-stream/spec.md` | `design.md` |
|
|
| `openspec/changes/enterprise-react-audio-fingerprint/` | `specs/react-audio-fingerprint/spec.md` | `design.md` |
|
|
| `openspec/changes/enterprise-gaming-r3f-audio/` | `specs/r3f-audio/spec.md` | `design.md` |
|
|
|
|
## What the rewrites collectively now satisfy
|
|
|
|
- **Target path** is `packages/<plugin>/<pkg>` per the current monorepo convention.
|
|
- **`@suaveplan/audio-engine` references replaced** by `@suaveplan/audio-engine-browser` (for rendering) + `@suaveplan/audio-plugins-fx` (for chain + plugin contract) + `@suaveplan/audio-controllers` (for MIDI binding).
|
|
- **Spec deltas exist** under `specs/<capability>/spec.md` in OpenSpec `Requirement` / `Scenario` / `**Verified by:**` form per `openspec/AGENTS.md` §0c.
|
|
- **`design.md` exists** with architecture, integration notes, and decisions.
|
|
- **`## Impact` → `### Affected dependents`** is per §14a template.
|
|
- **Parity Checklist** present where the proposal is a migration from upstream.
|
|
- **Error codes** use the dotted `defineCodes` form per AGENTS.md §7.
|
|
- **Universal where possible, R3F-gated only where it belongs**: `r3f-audio` consumes the four game-audio building blocks from `audio-plugins-fx` rather than re-implementing spatial / proximity / music / voice logic.
|
|
|
|
## Prerequisite ordering
|
|
|
|
Each rewritten proposal lists its prerequisites at the top of its `tasks.md`. The conservative order:
|
|
|
|
1. `enterprise-audio-plugins-fx` (foundation FX + chain + ambient + bus registry)
|
|
2. `enterprise-audio-engine-browser`, `enterprise-audio-engine-server` (engine adapters)
|
|
3. `enterprise-audio-controllers` (MIDI binding helpers)
|
|
4. `enterprise-audio-analysis-spectrum` (FFT consumed by fingerprint)
|
|
5. `enterprise-react-audio` (umbrella React surface)
|
|
6. `enterprise-react-audio-player`, `enterprise-react-audio-stream`, `enterprise-react-audio-fingerprint`, `enterprise-gaming-r3f-audio` (in any order — siblings of the umbrella)
|
|
|
|
This file is retained as the historical record of the wave rewrite. It is informational only; the proposals themselves are the source of truth.
|