mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-05 10:14:30 +00:00
Vance Ingalls
741280e4fd
main split TimelineAutomationLane.tsx independently while this branch was open,
moving ClipAutomationLanes and TimelineAutomationLaneSlot into
TimelineAutomationLaneSlot.tsx. The rebase therefore landed BOTH copies: two
definitions of the same component, with TimelineLanes importing main's and
TimelineGroupRow importing the branch's.
Keeps main's file and ports the three things only the branch's copy had:
- `readOnly={bound.readOnly || isCarveLane(lane.target, bound.chain)}` -- a
carve rewrites its own envelopes on every re-run, so they are shown but not
editable, per LANE so a carved bed can still carry the author's own curve.
- the `topOffset` prop, and `top = topOffset ?? getTimelineLaneTop(laneCount)`
-- a group's lanes sit directly under its header row, which cannot be said in
`laneCount`.
TimelineGroupRow now imports from the same module as TimelineLanes, and
TimelineAutomationLane.tsx is back to the single-lane editor at 499 lines --
under the 600 cap it was 683 lines over before.
studio's player + editor suites (206 files, 2628 tests) pass.
@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