mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-18 07:50:13 +00:00
* fix(studio): edit clips added to a project outside Studio A clip written into a composition after its ids were last stamped (a hand edit, an outside agent) has a data-hf-id only in the served preview. The timeline's client-side patch looked that id up in the file's raw bytes, so Hide, Mute, move, resize and attribute saves failed with "Unable to patch timeline element ... (by hf-id; no file on the clip)". Resolve the target against the file stamped in place the way the preview stamps it, as the server's own saves and the GSAP save already do. The save then persists that id. * fix(studio): save volume on several clips added outside Studio The multi-clip attribute save (gain or volume on a selection) patched each clip in the file's raw bytes, so a clip with no ids on disk was skipped and the save reported success with nothing written. The by-target read and patch helpers now resolve a clip by the id the preview served it with, so every caller finds it. The multi-clip save goes through the same batch patch as the other timeline saves, which refuses a clip the file does not hold; the error reaches the person instead of a silent no-op. The preview picker finds the file holding an unstamped element the same way.
@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 19, Zustand 4/5 (state management; development uses Zustand 5)
- 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