ext/hyperframes

Fork 0

mirror of https://github.com/heygen-com/hyperframes.git synced 2026-09-03 04:38:33 +00:00

Files

T

History

ef6225da1d feat(core): add fitTextFontSize utility for pixel-accurate text measurement (#152 )

Add @chenglou/pretext dependency and fitTextFontSize() utility that uses
canvas measureText to compute the largest font size that fits text within
a given width. Replaces character-count heuristics with actual font-aware
measurement.

- New fitTextFontSize() in @hyperframes/core/text, exposed on window.__hyperframes
- Generalized for all text elements (captions, titles, etc.), not just captions
- Unit tests (mocked pretext) + browser integration test (real Chromium canvas)
- Updated captions skill docs with usage, exit guarantee, and self-lint patterns

Co-authored-by: James <james.russo@heygen.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-30 20:14:13 -07:00

adapters

fix(studio,runtime,engine,compiler): 8 bug fixes — audio, render, timeline, Lottie, thumbnails, video render (#133 )

2026-03-30 23:58:08 +02:00

analytics.test.ts

initial code (#2 )

2026-03-21 22:43:56 -07:00

analytics.ts

initial code (#2 )

2026-03-21 22:43:56 -07:00

bridge.test.ts

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

2026-03-23 17:15:14 -07:00

bridge.ts

initial code (#2 )

2026-03-21 22:43:56 -07:00

compositionLoader.test.ts

feat(core): support inline template compositions (#146 )

2026-03-31 03:46:23 +02:00

compositionLoader.ts

feat(core): support inline template compositions (#146 )

2026-03-31 03:46:23 +02:00

entry.ts

feat(core): add fitTextFontSize utility for pixel-accurate text measurement (#152 )

2026-03-30 20:14:13 -07:00

init.ts

feat(core): support inline template compositions (#146 )

2026-03-31 03:46:23 +02:00

media.test.ts

feat(core): add loop and data-playback-rate for media elements

2026-03-24 17:27:41 -04:00

media.ts

feat(core): add loop and data-playback-rate for media elements

2026-03-24 17:27:41 -04:00

picker.test.ts

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

2026-03-23 17:15:14 -07:00

picker.ts

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

2026-03-23 17:15:14 -07:00

player.test.ts

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

2026-03-23 17:15:14 -07:00

player.ts

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

2026-03-23 17:15:14 -07:00

README.md

fix(ci): update publish workflow to use bun install (#36 )

2026-03-24 08:46:58 -07:00

startResolver.test.ts

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

2026-03-23 17:15:14 -07:00

startResolver.ts

fix: composition issues in runtime code + producer parity

2026-03-23 23:56:42 -04:00

state.test.ts

initial code (#2 )

2026-03-21 22:43:56 -07:00

state.ts

initial code (#2 )

2026-03-21 22:43:56 -07:00

timeline.test.ts

fix(core): filter decorative elements from timeline clip collection (#92 )

2026-03-27 18:31:46 +01:00

timeline.ts

fix(core): filter decorative elements from timeline clip collection (#92 )

2026-03-27 18:31:46 +01:00

types.ts

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

2026-03-23 17:15:14 -07:00

window.d.ts

initial code (#2 )

2026-03-21 22:43:56 -07:00

README.md

Hyperframe Runtime Engine

This folder owns the runtime that powers preview and producer parity.

Current Direction

Runtime source of truth is converging on hyperframe.ts.
Build produces:
- dist/hyperframe.runtime.iife.js (browser bootstrap)
- dist/hyperframe.runtime.mjs (tooling/tests)
- dist/hyperframe.manifest.json (version + sha256 + artifact map)
FE owns iframe runtime injection.
BE persists raw generated HTML without injecting runtime scripts.
Producer validates pinned runtime checksum from manifest before render.

Runtime Contract (Stable Surface)

Globals:

window.__player
window.__playerReady
window.__renderReady
window.__timelines
window.__clipManifest

postMessage:

parent -> runtime control:
- source: "hf-parent"
- type: "control"
- actions: play, pause, seek, set-muted, set-playback-rate, enable-pick-mode, disable-pick-mode
runtime -> parent events:
- source: "hf-preview"
- type: "state" and type: "timeline"

Determinism baseline:

renderSeek is the producer-canonical seek path.
30fps quantization and readiness gates are correctness requirements.

Build

bun run --filter @hyperframes/core build:hyperframes-runtime

Security Expectations

Runtime bootstrap URL must be version-pinned and host-allowlisted.
Iframe bridge payloads must be schema-validated.
Unsafe URL schemes (javascript: and unapproved data:) are rejected.
Fail closed if runtime bootstrap/handshake is not healthy.

Product Editing Model

Primary mode: prompt + element picking.
Secondary mode: manual precision controls.
Avoid timeline-first manual workflows as default product path.