mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-03 12:54:29 +00:00
Vance Ingalls
04d12a134b
- audioFxSummary (14 cyclomatic / 19 cognitive) counted enabled nodes inline while also deciding what to say about them. countEnabledNodes now owns the parse and the split, and returns null for an unreadable chain, so the summary reads as the four sentences it produces. - The reveal effect's five-way nested ternary for "which row does this parameter live in" is now revealRowSelector, and the resolve-query-scroll sequence around it is scrollRevealedRowIntoView. Both live in audioFxRevealTarget.ts beside the resolver whose output they consume, which also brought propertyPanelFxSection.tsx from 616 to 598 lines -- under the 600 cap for the first time, so this commit needs no --no-verify. With these cleared the fallow audit gate passes (exit 0). Two notes for whoever touches this next: - fallow fingerprints a finding by line position, so inserting a helper ABOVE a complex function re-flags that function's inherited complexity as new. Adding revealRowSelector above FxSection re-flagged FxSection's own 22/32; moving it out fixed both. - A helper extracted only to satisfy the gate has to stay used from one place, or it lands as an unused export instead. studio's editor suite (102 files, 1269 tests) passes unchanged.
@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