mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-16 22:58:02 +00:00
Wires `audioFxCopy` into the panel, to the three decisions recorded in `plans/audio-fx-ux/README.md` §Decided. **The plain name replaces the DSP name, which moves inside.** A module reads "Remove Rumble" with "Cutting everything below 80 Hz" under it, and opening it shows "Details — High-pass" above the knobs. Every knob is renamed too — `plainDef` writes the copy over the registry's labels and hints while leaving range, step, unit and automatability alone, because those are facts and only the words were ever the problem. A preset's own job name still wins where it has one: it is the most specific truth available. **Presets read as the complaint they answer.** "My voice sounds boomy", with `Boom Tame` underneath in small type — which is also how the name gets learned. The four shelves stay: eighteen sentences in a column is a wall, and Voice/Fix/Character/Space is already the author's grouping rather than the registry's. The effect list is untouched and stays in signal order, per the same decision. **Everything auditions on hover, and on focus — the keyboard reaches it too.** Hovering a preset or an offered effect plays it through the same preview channel a slider drag already uses, so it costs no new machinery and never touches the document. Three things this has to get right, each with a test that fails without it: - Leaving puts the stored chain back — captured when the audition starts, because the preview channel does not persist and the prop never changes. - Applying does NOT put it back. The audition *was* the preset, and reverting over the write that just landed is a race the author hears as it arriving and then leaving again. - The panel going away mid-audition reverts too. Deselecting a clip is not a decision, and a preview left playing is audible, absent from the document, and gone on the next reload. Tone does not audition: its bands arrive at 0 dB, so there is nothing to hear, and a hover that changes nothing teaches that hovering does nothing. **Even Out Levels auditions by measuring first**, which is the expensive answer of the three — it decodes the track and analyses it before there is anything to play. So it says "measuring…" while it works, the decode is cached per `src` (a hover that re-fetched a several-minute voiceover would be slower than the thing it previews), and a run counter drops any result that arrives after the pointer has left. Reverting puts both the chain and the automation back, because levelling is a node AND the lane that drives it — restoring only the chain leaves an envelope writing to a gain stage that is no longer there. Tests that addressed rows by their registry labels now look them up through `EFFECT_COPY`, and the preset buttons by preset id. Those tests are about which row carries the automate button, not about how it reads, and hard-coding the words would make every copy edit a test edit. Falsified: dropping the phase of each of the three audition invariants fails its own test, and removing the stale-run guard fails the levelling one. studio 3683 passing, 18 todo (was 3674); section file 510 lines, under the 600 cap.
@hyperframes/studio
Browser-based composition editor UI for Hyperframes. Provides a visual timeline, code editor, and live preview for building video compositions.
Install
npm install @hyperframes/studio
What it does
The studio is a React application with:
- Visual timeline — drag, resize, and arrange elements on tracks
- Code editor — edit HTML and GSAP scripts with CodeMirror (syntax highlighting, autocomplete)
- Live preview — see changes in real time as you edit
- Composition inspector — view and modify element properties
Development
The studio is embedded in the hyperframes preview command. To develop the studio UI itself:
cd packages/studio
bun run dev # Start Vite dev server
bun run build # Build for production
bun run typecheck # Type-check
Tech stack
- React 18/19, Zustand (state management)
- CodeMirror 6 (editor)
- Tailwind CSS (styling)
- Vite (bundler)
- Phosphor Icons
Documentation
Full documentation: hyperframes.heygen.com/packages/studio
Related packages
@hyperframes/core— types and parsers used by the editorhyperframes— CLI that serves the studio viahyperframes preview