mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-14 18:01:20 +08:00
ukimsanov
75ca3379eb
What: the canvas-side editor components of the NLE stack, shipped unwired: CanvasContextMenu (right-click menu for canvas selections), canvasContextMenuZOrder (bring-forward/send-backward z-order patch computation, with tests), and domEditNudge (arrow-key nudge step math, with tests). Why: reviewable on their own — the z-order rules and nudge semantics are the substance; the one-line mounting comes with the integration wiring PR. How: new files only, compiled and tested against current main (no glue changes). Because nothing mounts CanvasContextMenu yet and two exports have their first consumers in the wiring PR, .fallowrc.jsonc gains TEMP(studio-dnd) entries (entry registration + ignoreExports) — the integration wiring PR (studio-dnd/pr07-nle-integration-wiring) removes every one of them in the same diff that wires the components in. Test plan: bunx vitest run on canvasContextMenuZOrder.test.ts and domEditNudge.test.ts; tsc --noEmit in packages/studio; fallow audit --base origin/main clean.
@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