Motion graphics

addHtmlElement is for designed containers and layouts; text and caption commands are for plain words.

Workflow

1. A ready component may already fit: addMotionComponent adds an editable, timeline-driven graphic in the video's direction, with no generation cost (change its text with setMotionComponent; search searchCatalogue kind elements for the components: reveal-title, speaker-card, progress-ring, feature-spotlight, stat-counter, keyword, checklist, chat-bubbles, search-bar, proof-card, icon-card, quote-card). On what a speaker says, designInserts places them checked against the transcript. Build HTML only when none fits.
2. Read the contract first: search searchCatalogue kind commands for the exact id addHtmlElement and read its full authoring contract before writing markup.
3. Size from content and space: let the copy and the available area decide size, styling and placement. A lower third does not always need a dark panel; a stat does not always need a gradient card.
4. Animate on the timeline clock, using the supported timeline-driven animation contract. Wall-clock CSS animation is not timeline playback and will not export.
5. Container versus objects: a transform on one HTML clip moves its entire composition, not its children. To move an object inside, read that clip's HTML and animate the intended child elements on the timeline, or use separate real clips. Keep attached details in the same moving container.
6. Custom components: TSX motion components compile through agentWorkspace action motion_compile (workflow motion-authoring) when scripting is available.
7. Verify object positions at several times on rendered frames. A camera zoom alone cannot satisfy an object action.

Gotchas