Files
hyperframes/packages/studio
Vance IngallsandClaude Opus 5 10896ded6a feat(studio): the Tone module — a multi-band EQ on faders
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>
2026-08-10 15:38:51 -07:00
..
2026-08-03 22:48:00 -07:00
…

@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