mirror of https://github.com/heygen-com/hyperframes.git synced 2026-09-02 20:18:35 +00:00

Files

T

James Russo 7b0c7e73b2 refactor: frame reorder buffer + port probe cleanup; add CREDITS.md and missing skill (#341 )

* refactor(engine): restructure frame reorder buffer with Map-keyed storage

Rewrites createFrameReorderBuffer to use a Map<number, Array<() => void>>
keyed by frame index instead of a flat Array<{frame, resolve}> scanned on
every advance. O(1) lookups in enqueue/flush, fast-paths for the matching-
cursor and overshoot cases, and a small fix: waitForAllDone now coexists
with the writer still waiting on the final frame instead of colliding on
the same waiter slot.

Also adds 5 unit tests (there were none before) covering the fast-path,
out-of-order gating, multi-waiter-per-frame semantics, waitForAllDone
normal path, and the overshoot case.

Comment tweaks on buildChromeArgs — the flag profile is the standard
headless-for-capture set (Puppeteer / Playwright / Chrome headless-shell
all converge on similar flags); rephrased for clarity.

* refactor(cli): simplify port availability probe with async/await

Rewrites isPortAvailableOnHost from a single new-Promise callback into an
async/await form with an intermediate `bindError: ErrnoException | null`
variable. Makes the bind-then-release flow explicit as two sequential
awaits, and broadens the non-EADDRINUSE errno commentary (EADDRNOTAVAIL
for disabled IPv6, EACCES for privileged ports, EAFNOSUPPORT for missing
address families — all treated as "this host doesn't apply", not "port
occupied").

No behavior change to existing callers; all four portUtils tests still
pass.

* docs: add CREDITS.md and surface website-to-hyperframes skill

- New CREDITS.md acknowledging prior art in the browser-based video
  rendering space (Remotion) and the ecosystem HyperFrames builds on
  (Puppeteer, FFmpeg, GSAP, Hono). Standard OSS practice.

- Adds the `website-to-hyperframes` skill to the skills tables in
  README.md, docs/guides/prompting.mdx, and the project template at
  packages/cli/src/templates/_shared/CLAUDE.md. The skill ships in
  skills/ but was missing from every table.

- Adds `/hyperframes-registry` to the prose mention in the repo
  CLAUDE.md.

2026-04-19 16:33:42 -07:00

981 B

Raw Blame History

Credits

Prior art

HyperFrames was inspired by prior work in the browser-based video rendering space. In particular, we want to acknowledge:

Remotion pioneered the approach of using a headless browser + FFmpeg image2pipe pipeline to turn web primitives into deterministic video in the JavaScript ecosystem. Several of HyperFrames' architectural ideas — ordered async barriers for parallel frame capture, multi-host port availability probing for dev servers, and the broader shape of a "render HTML to video" CLI — were informed by studying how Remotion approaches these problems.

All code in this repository is independently implemented and distributed under the Apache 2.0 License. HyperFrames is not affiliated with Remotion.

Thanks

Thanks also to the authors and maintainers of the open-source projects HyperFrames builds on, including Puppeteer, FFmpeg, GSAP, Hono, and the broader Node.js ecosystem.

981 B Raw Blame History

Credits

Prior art

Thanks

981 B

Raw Blame History