mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-17 07:05:28 +00:00
One control surface over the EQ's tagged nodes, added from the rack's own menu. Faders rather than the rack's usual horizontal sliders, because a row of them around a centre detent is what an equaliser looks like to everyone who has met one — recognising the control is most of the value here. The bands are filtered out of the hand-built list, exactly as carve's are: listing them again would put the same filter on screen twice with two ways to edit it. Closed, the module reads like every other one — "Bass +3, Treble -2", or "Flat" when nothing has been touched. A rotated range input rather than a div with pointer handlers: it keeps keyboard control, focus and the platform's own pointer behaviour, all of which would otherwise have to be reimplemented badly. Writing the test caught a real bug. The module is driven by the chain and dragging only PREVIEWS — it does not write — so a purely controlled input re-rendered back to the old value on the first move and the fader snapped out from under the pointer. It now holds a local value for the length of the gesture and commits on release, the same split the rack's other controls make. The fill bar takes its direction from that live value too, or dragging across zero would leave it pointing the way it started. "Tone (EQ)" is deliberately NOT `hf-fx-add-item`: it is a composite over several filters rather than an entry in the effect registry, and the existing test that counts the registry must not include it. Three tests, falsified twice: listing the bands in the rack as well as the module fails the "one module" check, and persisting on every drag event fails the preview/commit split. Studio 3665 -> 3668. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@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