suaveplan/openspec/archive/2026-05-19-enterprise-react-audio-components-extras/proposal.md

OpenSpec Change: enterprise-react-audio-components-extras

• Change ID: enterprise-react-audio-components-extras
• Package: @suaveplan/react-audio
• Category: react
• Target path: packages/react/react-audio
• Status: PROPOSED — supplementary to Phase 2 (enterprise-react-audio-components)
• Date: 2026-05-19
• Spec delta: ./specs/react-audio/spec.md

Supplementary phase. Blocked on enterprise-react-audio-components shipping first. Adds the composed-plugin UIs that the original umbrella enterprise-react-audio proposal listed but the Phase 2 spec did not hard-mandate.

Summary

Add the composed-plugin UI components to @suaveplan/react-audio:

• <TransportControls> (play/pause/stop/seek/loop/tempo with keyboard).
• <TrackList> + <TrackRow> (track enumeration + per-row controls).
• <MasterMeter> (overall output peak/RMS meter).
• <Mixer> (track strips with gain/pan/mute/solo/sends — composed against @suaveplan/audio-fx-plugin-mixer).
• <AudioVisualizer> (waveform / spectrum / level meter modes).
• <AudioPlayer>, <BasicPlayer>, <PremiumPlayer> (composed against @suaveplan/audio-fx-plugin-audio-player).
• <MicrophoneControls> (composed against @suaveplan/audio-fx-plugin-microphone).
• <GLaDOSControls> (composed against @suaveplan/audio-fx-plugin-glados).
• <PluginLoader> — dynamic registration UI over PluginRegistry.list().

Each ships with .md, .test.tsx, and three Storybook stories per the gate already enforced in Phase 2. Subpath exports ./components/<name> extend the Phase 2 surface.

Spec delta scope

The Phase 2 spec stays valid; this change adds one new requirement per component family asserting the surface, plus a parity invariant that no main-branch component is omitted at the conclusion of this change.

Out of scope

• Foundation hooks/provider (Phase 1).
• Spec-mandated core primitives <PluginSlot> / <PluginChainView> / <PresetManager> (Phase 2).
• <MidiControllerSetup> (Phase 3).

Impact

Affected dependents

After this change archives, the parity invariant against main is restored: every component on /mnt/s/web/suaveplan/packages/react/react-audio/src/components/ has a genesis equivalent. react-audio-fingerprint, react-audio-player, react-audio-stream, and r3f-audio migrations can compose freely against the full UI surface.