Write HTML. Render video. Built for agents.
JavaScript aiai-agentsanimationclaude-codeffmpegframeworkgsaphtmlhtml-to-videomcpmotion-graphicspuppeteerrenderingtypescriptvideo-editor
HyperFrame Schema Compliance Review
Executive Summary
- Total files reviewed: 4
- Critical issues: 0
- Overall compliance status: PASS
Critical Issues
None. The compositions follow the core deterministic and structural requirements of the HyperFrame schema.
Compliance Checklist
- All compositions have
data-widthanddata-heightattributes - All timelines are finite with duration > 0
- All compositions registered in
window.__timelines - No use of
Math.random(),Date.now(), or non-deterministic code - Primitive clips have required data attributes (
id,data-start,data-track) -
data-durationspecified for all<img>clips (N/A - no images used) - No manual media playback control (
video.play(),audio.pause(), etc.) - No manual clip mounting/unmounting in scripts
- Relative timing references are valid (N/A - absolute timing used)
- Clips on same track don't overlap in time
- Reusable compositions in separate HTML files
- Composition files use
<template>tags - External compositions loaded via
data-composition-src - All script-animated content wrapped in compositions
- No infinite or zero-duration timelines
File-by-File Analysis
index.html
Status: COMPLIANT
Observations:
- Correctly defines the root composition with
data-composition-id="main". - Includes required
data-width,data-height, anddata-duration. - Orchestrates sub-compositions using
data-composition-src. - Script registers the timeline in
window.__timelines["main"]. - Uses deterministic GSAP animations for the A-roll video.
compositions/intro.html
Status: COMPLIANT
Observations:
- Uses
<template>tag as required for external compositions. - Root element inside template has
data-composition-id,data-width,data-height, anddata-duration. - Script is wrapped in an IIFE and correctly registers the timeline.
- Animations are fully deterministic.
compositions/captions.html
Status: COMPLIANT
Observations:
- Correctly uses
<template>and required data attributes. - Manages dynamic text content within a composition, which is the recommended approach for captions.
- Timeline registration is correct.
- Note:
data-durationis set to 20s, while the parentindex.htmllimits it to 19.04s. This is acceptable as the parent'sdata-durationor the timeline's bounds will effectively clip it.
compositions/stats.html
Status: COMPLIANT
Observations:
- Follows all schema rules for external compositions.
- Uses deterministic animations for complex sport-broadcast style graphics.
- Correctly registers
window.__timelines["stats-graphics"].
Recommendations
- Relative Timing: While absolute timing is used correctly, consider using relative timing (e.g.,
data-start="intro-comp") for better maintainability if the intro duration changes. - Consistency:
captions.htmlhas adata-duration="20", while other files use19.04. Aligning these to the exact master duration is a minor best practice but not a schema violation.