style: apply oxfmt baseline formatting across all source files (#25)

## Summary
- Run `oxfmt .` across the entire codebase to establish formatted baseline
- 299 files changed — mechanical formatting only, no logic changes
- Double quotes, semicolons, 2-space indent, trailing commas, 100 print width

Part 3/4 of [VA-851](https://linear.app/heygen/issue/VA-851/pre-migration-configure-eslint-prettier-and-conventional-commits)

## Test plan
- [x] `pnpm format:check` — all 426 files pass
- [x] `pnpm -r typecheck` — all packages pass
- [x] `pnpm build` — all packages build
- [x] All 348 tests pass
This commit is contained in:
Vance Ingalls
2026-03-23 17:15:14 -07:00
committed by GitHub
parent 323ff8f860
commit 20be2ea1c2
299 changed files with 27750 additions and 16792 deletions
+8 -1
View File
@@ -3,7 +3,9 @@
A composition is an HTML document that defines a video timeline.
## Structure
Every composition needs a root element with `data-composition-id`:
```html
<div id="root" data-composition-id="root" data-width="1920" data-height="1080">
<!-- Elements go here -->
@@ -11,16 +13,21 @@ Every composition needs a root element with `data-composition-id`:
```
## Nested Compositions
Embed one composition inside another:
```html
<div data-composition-src="./intro.html" data-start="0" data-duration="5"></div>
```
## Listing Compositions
Use `npx hyperframes compositions` to see all compositions in a project.
## Variables
Compositions can expose variables for dynamic content:
```html
<div data-composition-id="card" data-var-title="string" data-var-color="color">
<div data-composition-id="card" data-var-title="string" data-var-color="color"></div>
```
+4
View File
@@ -3,20 +3,24 @@
Core attributes for controlling element timing and behavior.
## Timing
- `data-start="0"` — Start time in seconds
- `data-duration="5"` — Duration in seconds
- `data-track-index="0"` — Timeline track number (controls z-ordering)
## Media
- `data-media-start="2"` — Media playback offset / trim point (seconds)
- `data-volume="0.8"` — Audio/video volume, 0 to 1
- `data-has-audio="true"` — Indicates video has an audio track
## Composition
- `data-composition-id="root"` — Unique ID for composition wrapper (required)
- `data-width="1920"` — Composition width in pixels
- `data-height="1080"` — Composition height in pixels
- `data-composition-src="./intro.html"` — Nested composition source
## Element Visibility
Add `class="clip"` to timed elements so the runtime can manage their visibility lifecycle.
+3
View File
@@ -3,6 +3,7 @@
HyperFrames uses GSAP for animation. Timelines are paused and controlled by the runtime.
## Setup
```html
<script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script>
@@ -14,10 +15,12 @@ HyperFrames uses GSAP for animation. Timelines are paused and controlled by the
```
## Key Rules
- Always create timelines with `{ paused: true }`
- Register timelines on `window.__timelines` with the composition ID as key
- Position parameter (3rd arg) sets absolute time: `tl.to(el, vars, 1.5)`
- Supported methods: `set`, `to`, `from`, `fromTo`
## Supported Properties
opacity, x, y, scale, scaleX, scaleY, rotation, width, height, visibility
+4
View File
@@ -3,14 +3,17 @@
Render compositions to MP4 with `npx hyperframes render`.
## Local Mode (default)
Uses Puppeteer (bundled Chromium) + system FFmpeg. Fast for iteration.
Requires: FFmpeg installed (`brew install ffmpeg` or `apt install ffmpeg`).
## Docker Mode (--docker)
Deterministic output with exact Chrome version and fonts. For production.
Requires: Docker installed and running.
## Options
- `-f, --fps` — 24, 30, or 60 (default: 30)
- `-q, --quality` — draft, standard, high (default: standard)
- `-w, --workers` — Parallel workers 1-8 (default: auto)
@@ -18,6 +21,7 @@ Requires: Docker installed and running.
- `-o, --output` — Custom output path
## Tips
- Use `draft` quality for fast previews during development
- Use `npx hyperframes benchmark` to find optimal settings
- 4 workers is usually the sweet spot for most compositions
+4
View File
@@ -3,13 +3,17 @@
Built-in templates available via `npx hyperframes init --template <name>`.
## blank
Empty 1920x1080 composition with GSAP timeline wired up. Start from scratch.
## title-card
Animated title and subtitle with GSAP fade-in/out. Good for intro cards.
## video-edit
Video element with trimming, audio, and track controls. Starting point for video editing.
## Custom Templates
Any directory with an `index.html` can serve as a template. Copy it manually or build your own init workflow.
+7
View File
@@ -1,22 +1,29 @@
# Troubleshooting
## "No composition found"
Your directory needs an `index.html`. Run `npx hyperframes init` to create one.
## "FFmpeg not found"
Local rendering requires FFmpeg. Install it:
- macOS: `brew install ffmpeg`
- Ubuntu: `sudo apt install ffmpeg`
- Windows: Download from https://ffmpeg.org/download.html
## Lint errors
Run `npx hyperframes lint` to check for common issues:
- Missing `data-composition-id` on root element
- Missing `class="clip"` on timed elements
- Overlapping timelines or invalid data attributes
## Preview not updating
Make sure you're editing the `index.html` in the project directory. The preview server watches for file changes and auto-reloads.
## Render looks different from preview
Use `--docker` mode for deterministic output. Local renders may differ due to font availability and Chrome version.