mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-03 04:38:33 +00:00
Vance IngallsandClaude Fable 5
17f3e5beb0
Review round on PR #2442: - miguel (blocker): the cross-file eligibility rule only guarded the dom-edit tripwire; recordResolverParity and recordAnimationResolverParity ran before wrongCompositionFile at every cutover surface, so cross-file ops still emitted false element_not_found (id present in the OTHER file's source passes the runtime-node filter) and polluted the attempt denominator. The rule now lives in one shared isCrossFileEdit guard applied by all three entry points, wired with { targetPath, compositionPath } at all six sdkCutover call sites (timing, timing-batch, gsap add/set/remove, keyframe chokepoint, delete). - Rames (race): the disk-truth read is now dispatched SYNCHRONOUSLY in the same prologue as the miss check, before control returns to the caller whose cutover persist writes the same file moments later — a post-write read would see a remove op's target legitimately gone and misclassify it as a genuine divergence. Sync reader throws become rejections (IIFE), not exceptions into the swallow-all catch. - Rames (parse failure): openComposition failure inside the disk check now fails open as sourceReadFailed (unparseable source is not ground truth), instead of the outer catch dropping the divergence event entirely. recordResolverParity's source check extracted to checkHfIdInSource (complexity gate), mirroring checkAnimationIdOnDisk's error discipline. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@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