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: 1
- Overall compliance status: NEEDS_WORK
Critical Issues
Top-Level Container Missing Composition ID
- File: index.html:59
- Violation: The top-level container has
id="main-comp"but the schema requiresdata-composition-idfor all top-level containers. - Schema Rule: "Every top-level HTML container MUST be a composition (i.e., have a
data-composition-idattribute)." - Impact: The framework will not recognize the root element as a composition, potentially failing to initialize the master timeline or manage its children correctly.
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) - No manual media playback control (
video.play(),audio.pause(), etc.) - No manual clip mounting/unmounting in scripts
- Relative timing references are valid (N/A - using absolute timing)
- 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-Specific Reviews
index.html
Status: HAS_ISSUES
Issues Found:
- Top-Level Composition ID: Line 59. The root
divusesid="main-comp"but should usedata-composition-id="main-comp". - Redundant Duration: Line 96, 104, 112. Sub-compositions
intro,stats, andcaptionshavedata-durationinindex.html. While allowed, the schema notes thatdata-durationon the composition element itself (inside the template) is the source of truth. - Track Overlap: The
arollvideo (Track 1) andaudio-1instats.html(Track 1) are on the same track number. While they are in different compositions, it's best practice to keep track numbers unique across the project if they represent different layers. However, since they are in different composition scopes, this is technically valid but worth noting.
compositions/intro.html
Status: COMPLIANT
Issues Found:
- None. Correctly uses
<template>,data-composition-id,data-width,data-height, anddata-duration. Timeline is registered correctly.
compositions/captions.html
Status: COMPLIANT
Issues Found:
- None. Correctly handles dynamic content by wrapping it in a composition and using a GSAP timeline for word-level timing.
compositions/stats.html
Status: COMPLIANT
Issues Found:
- None. Correctly uses
data-startanddata-trackfor audio primitives and registers the timeline.
Recommendations
- Fix Root Attribute: Change
id="main-comp"todata-composition-id="main-comp"inindex.html. - Deterministic Check: Ensure the
TRANSCRIPTdata remains static and is not generated at runtime using non-deterministic methods (it is currently hardcoded, which is perfect).