Write HTML. Render video. Built for agents.
JavaScript aiai-agentsanimationclaude-codeffmpegframeworkgsaphtmlhtml-to-videomcpmotion-graphicspuppeteerrenderingtypescriptvideo-editor
import type { GsapAnimation } from "./gsapSerialize.js";
type TweenTarget = Pick<GsapAnimation, "targetSelector" | "hasPartialSelector">;
type TweenTime = Pick<GsapAnimation, "position" | "implicitPosition">;
// Tweens a timeline move or retime of a clip carries: an own selector, plus (given a DOM) a fully known target
// set that is the clip or sits inside it with no nearer `data-start` clip. A tween also aiming outside stays put.
export function clipTweenMatcher(
clipSelectors: string | readonly string[],
root?: ParentNode,
queries: Map<string, Element[]> = new Map(),
): (tween: TweenTarget) => boolean {
const own = typeof clipSelectors === "string" ? [clipSelectors] : clipSelectors;
if (!root)
return ({ targetSelector, hasPartialSelector }) =>
!hasPartialSelector && own.includes(targetSelector);
const queryAll = (selector: string): Element[] => {
if (ID_SELECTOR.test(selector)) {
if (!queries.has(ALL_IDS)) indexIds(root, queries);
return queries.get(selector) ?? [];
}
let found = queries.get(selector);
if (!found) queries.set(selector, (found = queryRoot(root, selector)));
return found;
};
const clips = own.flatMap((selector) => queryAll(selector));
return ({ targetSelector, hasPartialSelector }) => {
if (hasPartialSelector) return false;
if (own.includes(targetSelector)) return true;
if (clips.length === 0) return false;
const targets = queryAll(targetSelector);
return (
targets.length > 0 &&
targets.every((target) => {
const owner = target.closest("[data-start]");
return clips.includes(target) || (owner !== null && clips.includes(owner));
})
);
};
}
/** Where a GSAP script's clips live: linkedom keeps a `<template>`'s children under it, out of document queries. */
export function clipQueryRoot(script: Element): ParentNode {
return script.closest("template") ?? script.ownerDocument;
}
/** A written position; an implicit one follows the tween before it and must stay unwritten. */
export function hasExplicitTime<T extends TweenTime>(
animation: T,
): animation is T & { position: number } {
return typeof animation.position === "number" && !animation.implicitPosition;
}
const ID_SELECTOR = /^#-?[A-Za-z_][\w-]*$/;
const ALL_IDS = "[id]";
// One DOM walk answers every `#id` lookup; a query per clip cost ~3 ms each on a 100-clip file.
function indexIds(root: ParentNode, queries: Map<string, Element[]>): void {
const all = queryRoot(root, ALL_IDS);
queries.set(ALL_IDS, all);
for (const el of all) {
const key = `#${el.id}`;
if (!ID_SELECTOR.test(key)) continue;
const list = queries.get(key);
if (list) list.push(el);
else queries.set(key, [el]);
}
}
function queryRoot(root: ParentNode, selector: string): Element[] {
try {
return Array.from(root.querySelectorAll(selector));
} catch {
// Pseudo-selectors such as a proxy or dwell label never match the DOM.
return [];
}
}