Files
hyperframes/packages/studio
Vance Ingalls e727e39b7f feat(studio): switch a preset off, or take it out, as one thing
The bracket said a preset was one thing the author added, and then made
them treat it as five: every member module had its own On / ↑ / ↓ / ×
and the preset itself had none. Switching off Telephone meant reaching
into seven modules and toggling each — exactly the bookkeeping the
bracket exists to remove.

The run head now carries the two controls that belong to the whole:

- **On/Off bypasses every node it wrote**, and leaves anything the author
  added themselves alone. A bypass, not a delete: the settings survive,
  which is what makes a preset worth trying rather than committing to.
- **× takes it back out whole**, with its lanes. An orphaned lane keeps
  driving a parameter that is no longer in the graph, and with ids minted
  lowest-free the next effect added inherits it — the same contract
  removing a single node already has.

It reads as On while *any* of it is still running. "Some of it is
bypassed" is not a state an author set, it is one they arrived at by
toggling a member, and the switch has to offer to stop the preset rather
than claim it has already stopped.

Also fixes the mount helper in the section tests, which never passed
`onRemoveNodeAutomation` — so nothing in that file could have caught a
lane leak on removal.

studio 3700 passing, 18 todo.
2026-08-10 15:39:05 -07:00
..
2026-08-03 22:48:00 -07:00
2026-03-21 22:43:56 -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