mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-16 06:19:21 +00:00
The player's total-time readout binds to store.duration, but edits only patched store.elements — so after a move/resize/delete the number stayed frozen at the old length until a manual page refresh (user-confirmed, worst on shrink since nothing ever lowered it). Optimistically push the content-driven length into the store at each edit site: move/resize read the furthest clip end from the just-patched preview DOM (raw data-duration, immune to runtime-truncated live values), delete and the batched move path reuse the content end already computed for the source patch. The subsequent preview reload then confirms the same value. The persist test stubs the player store so the optimistic setDuration can't leak state into other suite files.
@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