Write HTML. Render video. Built for agents.
JavaScript aiai-agentsanimationclaude-codeffmpegframeworkgsaphtmlhtml-to-videomcpmotion-graphicspuppeteerrenderingtypescriptvideo-editor
/**
* Extract computed design styles from key DOM elements.
*
* Targets ~50 elements (headings, body text, buttons, cards, nav) and extracts
* only design-relevant CSS properties. Output is a compact, pre-clustered
* design system summary — not raw computed styles per element.
*
* All page.evaluate() calls use string expressions to avoid
* tsx/esbuild __name injection (see esbuild issue #1031).
*/
import type { Page } from "puppeteer-core";
import type { DesignStyles } from "./types.js";
const EXTRACT_DESIGN_STYLES_SCRIPT = `(() => {
var isVisible = (el) => {
var s = getComputedStyle(el);
return s.display !== "none" && s.visibility !== "hidden" && s.opacity !== "0" && el.getBoundingClientRect().height > 0;
};
function rgbToHex(color) {
if (!color) return "";
if (color.startsWith('#')) return color.toUpperCase();
// capture optional alpha (group 4), allowing both comma and modern slash (rgb r g b / a) syntax.
var m = color.match(/rgba?\\(\\s*(\\d+)\\s*,\\s*(\\d+)\\s*,\\s*(\\d+)(?:\\s*[,/]\\s*([\\d.]+))?/);
if (!m) return color;
// fully-transparent fill (rgba(...,0)) → sentinel, NOT #000000 — otherwise a transparent
// chip/tab/stat ground reads as solid black on a light-ground site.
if (m[4] !== undefined && parseFloat(m[4]) === 0) return "transparent";
return '#' + ((1<<24) + (parseInt(m[1])<<16) + (parseInt(m[2])<<8) + parseInt(m[3])).toString(16).slice(1).toUpperCase();
}
function cleanFont(f) {
return f.split(",")[0].replace(/['"]/g, "").trim();
}
// keep only gradient background-images (drop url() sprites + "none"); gradients are a core
// brand signal (Stripe/ElevenLabs/Snowflake mesh washes) that a flat background-color misses.
function gradientOf(v) {
return v && v.indexOf("gradient") >= 0 ? v.trim() : "";
}
function getStyles(el) {
var s = getComputedStyle(el);
var bf = s.backdropFilter || s.webkitBackdropFilter || "";
return {
fontFamily: cleanFont(s.fontFamily),
fontSize: s.fontSize,
fontWeight: s.fontWeight,
lineHeight: s.lineHeight,
letterSpacing: s.letterSpacing,
color: rgbToHex(s.color),
background: rgbToHex(s.backgroundColor),
backgroundImage: gradientOf(s.backgroundImage),
backdropFilter: bf === "none" ? "" : bf,
padding: s.padding,
borderRadius: s.borderRadius,
border: s.border,
boxShadow: s.boxShadow === "none" ? "none" : s.boxShadow,
height: s.height
};
}
// ── 1. Typography hierarchy ──
// Sample each text role and deduplicate by fontSize
var typographyMap = {};
var roleSelectors = [
{ role: "display", sel: "h1", max: 3 },
{ role: "heading-2", sel: "h2", max: 5 },
{ role: "heading-3", sel: "h3", max: 5 },
{ role: "heading-4", sel: "h4", max: 3 },
{ role: "body", sel: "p", max: 10 },
{ role: "body-small", sel: "figcaption, .caption, [class*='caption'], [class*='subtitle'], small", max: 5 },
{ role: "label", sel: "label, [class*='label'], [class*='tag'], [class*='badge']", max: 5 },
{ role: "link", sel: "a:not([class*='btn']):not([class*='button']):not([role='button'])", max: 5 },
{ role: "code", sel: "code, pre, [class*='mono']", max: 3 }
];
for (var ri = 0; ri < roleSelectors.length; ri++) {
var spec = roleSelectors[ri];
var els = Array.from(document.querySelectorAll(spec.sel)).slice(0, spec.max);
for (var ei = 0; ei < els.length; ei++) {
if (!isVisible(els[ei])) continue;
var s = getStyles(els[ei]);
var key = s.fontSize + "|" + s.fontWeight + "|" + s.fontFamily;
if (!typographyMap[key]) {
var text = (els[ei].textContent || "").trim().replace(/\\s+/g, " ").slice(0, 60);
typographyMap[key] = {
role: spec.role,
fontFamily: s.fontFamily,
fontSize: s.fontSize,
fontWeight: s.fontWeight,
lineHeight: s.lineHeight,
letterSpacing: s.letterSpacing,
color: s.color,
sampleText: text
};
}
}
}
// Sort by font size descending
var typography = Object.values(typographyMap);
typography.sort(function(a, b) {
return parseFloat(b.fontSize) - parseFloat(a.fontSize);
});
// Deduplicate roles — keep only the first (largest) for each role prefix
var seenRoles = {};
var uniqueTypo = [];
for (var ti = 0; ti < typography.length; ti++) {
var baseRole = typography[ti].role.replace(/-\\d+$/, "");
if (!seenRoles[baseRole]) {
seenRoles[baseRole] = true;
typography[ti].role = baseRole;
uniqueTypo.push(typography[ti]);
} else if (baseRole === "heading") {
// Keep multiple heading levels
uniqueTypo.push(typography[ti]);
}
}
// ── 2. Buttons ──
// a page's primary CTA is very often a FILLED pill in the nav/header ("Sign up", "Start for free").
// Old code dropped everything under <nav>, losing that CTA; keep nav elements that carry a solid
// fill (a real button), still dropping plain nav text links.
var isFilledEl = (el) => {
var cs = getComputedStyle(el);
var bg = cs.backgroundColor;
var solid = !!bg && rgbToHex(bg) !== "transparent";
// a gradient-filled CTA (e.g. Snowflake's blue pill = background: var(--ui-background-03)) has a
// transparent background-COLOR but a gradient background-IMAGE — count it as filled too.
return solid || (cs.backgroundImage || "").indexOf("gradient") >= 0;
};
var buttonEls = Array.from(document.querySelectorAll(
'button, a[class*="btn"], a[class*="button"], a[role="button"], ' +
'[class*="btn-"], [class*="button-"], [class*="cta"]'
)).filter(function(el) {
if (!isVisible(el)) return false;
return el.closest('nav, [role="navigation"]') ? isFilledEl(el) : true;
}).slice(0, 16);
var buttonMap = {};
for (var bi = 0; bi < buttonEls.length; bi++) {
var bs = getStyles(buttonEls[bi]);
// Deduplicate by visual appearance (gradient fill kept distinct so a gradient CTA survives)
var bKey = bs.background + "|" + bs.backgroundImage + "|" + bs.backdropFilter + "|" + bs.borderRadius + "|" + bs.border;
if (!buttonMap[bKey]) {
var btnText = (buttonEls[bi].textContent || "").trim().slice(0, 40);
buttonMap[bKey] = {
label: btnText || "button",
background: bs.background,
backgroundImage: bs.backgroundImage,
backdropFilter: bs.backdropFilter,
color: bs.color,
padding: bs.padding,
borderRadius: bs.borderRadius,
border: bs.border,
boxShadow: bs.boxShadow,
fontSize: bs.fontSize,
fontWeight: bs.fontWeight,
height: bs.height
};
}
}
var buttons = Object.values(buttonMap).slice(0, 6);
// ── 3. Cards / containers ──
var cardEls = Array.from(document.querySelectorAll(
'[class*="card"], [class*="Card"], [class*="tile"], [class*="Tile"], ' +
'[class*="panel"], [class*="Panel"], [class*="feature"], ' +
'article, [class*="box"]:not(select):not(input)'
)).filter(function(el) {
var rect = el.getBoundingClientRect();
return isVisible(el) && rect.width > 100 && rect.height > 80;
}).slice(0, 10);
var cardMap = {};
for (var ci = 0; ci < cardEls.length; ci++) {
var cs = getStyles(cardEls[ci]);
// gradient fill + glass blur kept in the key so a gradient/frosted card is a distinct variant
var cKey = cs.background + "|" + cs.backgroundImage + "|" + cs.backdropFilter + "|" + cs.borderRadius + "|" + cs.border;
if (!cardMap[cKey]) {
cardMap[cKey] = {
label: "card",
background: cs.background,
backgroundImage: cs.backgroundImage,
backdropFilter: cs.backdropFilter,
color: cs.color,
padding: cs.padding,
borderRadius: cs.borderRadius,
border: cs.border,
boxShadow: cs.boxShadow,
fontSize: cs.fontSize,
fontWeight: cs.fontWeight,
height: cs.height
};
}
}
var cards = Object.values(cardMap).slice(0, 4);
// ── 4. Navigation ──
var navEl = document.querySelector('nav, header, [role="navigation"], [class*="navbar"], [class*="header"]');
var nav = null;
if (navEl && isVisible(navEl)) {
var ns = getStyles(navEl);
nav = {
label: "navigation",
background: ns.background,
backgroundImage: ns.backgroundImage,
backdropFilter: ns.backdropFilter,
color: ns.color,
padding: ns.padding,
borderRadius: ns.borderRadius,
border: ns.border,
boxShadow: ns.boxShadow,
fontSize: ns.fontSize,
fontWeight: ns.fontWeight,
height: ns.height
};
}
// ── 4b. Chips / pills / badges / tags ──
// selector by class-substring, PLUS a shape fallback (small + fully-rounded + short text) so
// hashed/utility class names (Tailwind, CSS-modules) still get caught.
var chipEls = Array.from(document.querySelectorAll(
'[class*="pill"], [class*="Pill"], [class*="badge"], [class*="Badge"], ' +
'[class*="chip"], [class*="Chip"], [class*="tag"], [class*="Tag"]'
)).filter(function(el) {
if (!isVisible(el) || el.closest('nav, [role="navigation"]')) return false;
var r = el.getBoundingClientRect();
var txt = (el.textContent || "").trim();
return r.height > 0 && r.height <= 60 && r.width <= 360 && txt.length > 0 && txt.length <= 40;
});
var shapeChips = Array.from(document.querySelectorAll('span, div, li, a')).slice(0, 500).filter(function(el) {
if (!isVisible(el) || el.closest('nav, [role="navigation"]')) return false;
var st = getComputedStyle(el);
var r = el.getBoundingClientRect();
var rad = parseFloat(st.borderRadius) || 0;
var txt = (el.textContent || "").trim();
var hasSkin = (st.backgroundColor && st.backgroundColor !== "rgba(0, 0, 0, 0)" && st.backgroundColor !== "transparent") || (parseFloat(st.borderTopWidth) || 0) > 0;
return hasSkin && r.height > 0 && r.height <= 44 && r.width <= 260 && rad >= (r.height / 2) - 1 && txt.length > 0 && txt.length <= 24 && el.children.length <= 1;
});
var allChips = chipEls.concat(shapeChips);
var chipMap = {};
for (var chi = 0; chi < allChips.length; chi++) {
var chs = getStyles(allChips[chi]);
var chKey = chs.background + "|" + chs.borderRadius + "|" + chs.border;
if (!chipMap[chKey]) {
chipMap[chKey] = {
label: (allChips[chi].textContent || "").trim().slice(0, 24) || "chip",
background: chs.background, color: chs.color, padding: chs.padding, borderRadius: chs.borderRadius,
border: chs.border, boxShadow: chs.boxShadow, fontSize: chs.fontSize, fontWeight: chs.fontWeight, height: chs.height
};
}
}
var chips = Object.values(chipMap).slice(0, 4);
// ── 4c. Stat / metric cells (a big numeral + a small label) ──
var statEls = Array.from(document.querySelectorAll(
'[class*="stat"], [class*="Stat"], [class*="metric"], [class*="Metric"], ' +
'[class*="kpi"], [class*="KPI"], [class*="figure"], [class*="Figure"]'
)).filter(function(el) {
if (!isVisible(el)) return false;
var r = el.getBoundingClientRect();
return r.height > 0 && r.height <= 400 && r.width <= 600;
}).slice(0, 14);
function biggestFontChild(el) {
var best = 0, bestEl = null, kids = el.querySelectorAll("*");
for (var i = 0; i < kids.length; i++) {
if (!isVisible(kids[i])) continue;
var fz = parseFloat(getComputedStyle(kids[i]).fontSize) || 0;
if (fz > best) { best = fz; bestEl = kids[i]; }
}
return bestEl;
}
var statMap = {};
for (var sti = 0; sti < statEls.length; sti++) {
var numEl = biggestFontChild(statEls[sti]) || statEls[sti];
var numFz = parseFloat(getComputedStyle(numEl).fontSize) || 0;
if (numFz < 28) continue; // needs a genuinely large numeral to count as a stat cell
var cst = getStyles(statEls[sti]);
var nst = getStyles(numEl);
var stKey = Math.round(numFz) + "|" + cst.background;
if (!statMap[stKey]) {
statMap[stKey] = {
background: cst.background, borderRadius: cst.borderRadius, border: cst.border, boxShadow: cst.boxShadow,
numberFontSize: nst.fontSize, numberFontWeight: nst.fontWeight, numberColor: nst.color
};
}
}
var statCells = Object.values(statMap).slice(0, 3);
// ── 4d. Tabs ──
var tabEls = Array.from(document.querySelectorAll(
'[role="tab"], [class*="tab"]:not([class*="table"]):not([class*="Table"])'
)).filter(function(el) {
if (!isVisible(el)) return false;
var r = el.getBoundingClientRect();
var txt = (el.textContent || "").trim();
return r.height > 0 && r.height <= 64 && txt.length > 0 && txt.length <= 30;
}).slice(0, 12);
var tabMap = {};
for (var tbi = 0; tbi < tabEls.length; tbi++) {
var tst = getStyles(tabEls[tbi]);
var tKey = tst.background + "|" + tst.color + "|" + tst.border;
if (!tabMap[tKey]) {
tabMap[tKey] = {
label: (tabEls[tbi].textContent || "").trim().slice(0, 24) || "tab",
background: tst.background, color: tst.color, padding: tst.padding, borderRadius: tst.borderRadius,
border: tst.border, boxShadow: tst.boxShadow, fontSize: tst.fontSize, fontWeight: tst.fontWeight, height: tst.height
};
}
}
var tabs = Object.values(tabMap).slice(0, 4);
// ── 5. Spacing scale ──
// Collect padding and margin values from visible elements
var spacingCounts = {};
var spacingSamples = Array.from(document.querySelectorAll(
"section, div, article, main, aside, header, footer, nav, " +
"button, a, p, h1, h2, h3, h4, li, ul, ol"
)).slice(0, 200);
for (var si = 0; si < spacingSamples.length; si++) {
if (!isVisible(spacingSamples[si])) continue;
var ss = getComputedStyle(spacingSamples[si]);
var props = [ss.paddingTop, ss.paddingRight, ss.paddingBottom, ss.paddingLeft,
ss.marginTop, ss.marginRight, ss.marginBottom, ss.marginLeft,
ss.gap, ss.rowGap, ss.columnGap];
for (var pi = 0; pi < props.length; pi++) {
var val = parseFloat(props[pi]);
if (val > 0 && val <= 200) {
var rounded = Math.round(val);
spacingCounts[rounded] = (spacingCounts[rounded] || 0) + 1;
}
}
}
// Find the most common spacing values (at least 3 occurrences)
var spacingEntries = Object.entries(spacingCounts)
.filter(function(e) { return e[1] >= 3; })
.sort(function(a, b) { return b[1] - a[1]; });
var observedSpacing = spacingEntries.map(function(e) { return parseInt(e[0]); }).sort(function(a,b) { return a - b; });
// Detect base unit — GCD of the top spacing values, clamped to 4 or 8
var baseUnit = 8;
if (observedSpacing.length >= 3) {
var divisible4 = observedSpacing.filter(function(v) { return v % 4 === 0; }).length;
var divisible8 = observedSpacing.filter(function(v) { return v % 8 === 0; }).length;
baseUnit = (divisible4 > divisible8 * 1.5) ? 4 : 8;
}
// ── 6. Border radius scale ──
var radiusCounts = {};
var radiusSamples = Array.from(document.querySelectorAll(
"button, a, [class*='card'], [class*='btn'], input, select, textarea, " +
"[class*='badge'], [class*='tag'], [class*='chip'], img, video"
)).slice(0, 100);
for (var rsi = 0; rsi < radiusSamples.length; rsi++) {
if (!isVisible(radiusSamples[rsi])) continue;
var br = getComputedStyle(radiusSamples[rsi]).borderRadius;
if (br && br !== "0px") {
radiusCounts[br] = (radiusCounts[br] || 0) + 1;
}
}
var radius = Object.entries(radiusCounts)
.filter(function(e) { return e[1] >= 2; })
.sort(function(a, b) { return parseFloat(a[0]) - parseFloat(b[0]); })
.map(function(e) { return e[0]; });
// ── 7. Box shadows ──
var shadowCounts = {};
// Keep semantic samples even when they are small or appear late in a dense page.
var semanticShadowSamples = new Set(Array.from(document.querySelectorAll(
"[class*='card'], [class*='Card'], button, [class*='btn'], " +
"[class*='dropdown'], [class*='modal'], [class*='popover'], " +
"nav, header, [class*='panel'], article"
)).slice(0, 100));
// Plain/utility-class boxes also carry elevation. Bound the extra style reads
// and deduplicate elements that already matched a semantic selector.
var shadowSamples = new Set([
...semanticShadowSamples,
...Array.from(document.querySelectorAll("div, section, aside, li, a, figure, main")).slice(0, 800)
]);
for (var shEl of shadowSamples) {
if (!isVisible(shEl)) continue;
if (!semanticShadowSamples.has(shEl)) {
var shRect = shEl.getBoundingClientRect();
if (shRect.width * shRect.height < 1600) continue;
if (shRect.width > window.innerWidth * 0.95 && shRect.height > window.innerHeight * 0.9) continue;
}
var shVal = getComputedStyle(shEl).boxShadow;
if (shVal && shVal !== "none") {
shadowCounts[shVal] = (shadowCounts[shVal] || 0) + 1;
}
}
var shadows = Object.entries(shadowCounts)
.sort(function(a, b) { return b[1] - a[1]; })
.slice(0, 5)
.map(function(e) { return { value: e[0], count: e[1] }; });
// ── 8. Dominant gradient / mesh backgrounds ──
// A site's signature color wash (Stripe/ElevenLabs/Snowflake) lives in gradient background-images
// on large blocks — often on a pseudo-element (::before glow orbs) rather than the block itself.
// Weight each distinct gradient by the total on-screen area it covers; return the top few.
var gradientArea = {};
var gradSamples = Array.from(document.querySelectorAll(
"body, main, section, header, div, [class*='hero'], [class*='gradient'], [class*='bg'], [class*='background']"
)).slice(0, 400);
// max stop chroma (max−min RGB) of a gradient: a vivid brand wash scores high, a neutral
// white/cream scrim ~0. Used to rank washes so a small vivid gradient beats a big grey scrim.
function gradientChroma(g) {
var max = 0, re = /rgba?\\(\\s*(\\d+)[,\\s]+(\\d+)[,\\s]+(\\d+)/g, m;
while ((m = re.exec(g))) {
var r = +m[1], gr = +m[2], b = +m[3];
var c = Math.max(r, gr, b) - Math.min(r, gr, b);
if (c > max) max = c;
}
return max;
}
function addGradient(val, area) {
var g = gradientOf(val);
if (!g || area < 20000) return; // ignore tiny decorative gradients
var norm = g.replace(/\\s+/g, " ");
gradientArea[norm] = (gradientArea[norm] || 0) + area;
}
for (var gi = 0; gi < gradSamples.length; gi++) {
var gel = gradSamples[gi];
if (!isVisible(gel)) continue;
var grect = gel.getBoundingClientRect();
var garea = grect.width * grect.height;
if (garea < 20000) continue;
addGradient(getComputedStyle(gel).backgroundImage, garea);
addGradient(getComputedStyle(gel, "::before").backgroundImage, garea);
addGradient(getComputedStyle(gel, "::after").backgroundImage, garea);
}
// rank by chroma-weighted area so the brand's signature color wash outranks a larger neutral scrim
var backgrounds = Object.entries(gradientArea)
.map(function(e) { return { value: e[0], area: Math.round(e[1]), score: e[1] * (1 + 2 * gradientChroma(e[0]) / 255) }; })
.sort(function(a, b) { return b.score - a.score; })
.slice(0, 6)
.map(function(e) { return { value: e.value, area: e.area }; });
// ── 9. Frosted-glass panels (backdrop-filter) ──
// A defining material on modern hero UIs (HeyGen's prompt box, Stripe's floating chrome): a
// translucent surface with a backdrop blur. Capture the RAW fill (rgba/gradient — alpha preserved,
// unlike rgbToHex) + the blur, ranked by area. This is what lets a frame render a real frosted card.
var glassSamples = Array.from(document.querySelectorAll(
"div, section, header, nav, aside, [class*='card'], [class*='panel'], [class*='glass'], [class*='blur'], [class*='modal'], [class*='overlay'], [class*='input']"
)).slice(0, 400);
var glassByKey = {};
for (var qi = 0; qi < glassSamples.length; qi++) {
var qel = glassSamples[qi];
if (!isVisible(qel)) continue;
var qs = getComputedStyle(qel);
var bf = qs.backdropFilter || qs.webkitBackdropFilter || "";
if (!bf || bf === "none" || bf.indexOf("blur") < 0) continue;
var qrect = qel.getBoundingClientRect();
var qarea = qrect.width * qrect.height;
if (qarea < 8000) continue; // ignore tiny blurred chips
// raw fill with alpha intact: prefer a translucent gradient, else the rgba background-color
var gi2 = qs.backgroundImage;
var rawFill = gi2 && gi2.indexOf("gradient") >= 0 ? gi2.replace(/\\s+/g, " ").trim() : qs.backgroundColor;
var key = bf + "|" + rawFill + "|" + qs.borderRadius;
if (!glassByKey[key]) {
glassByKey[key] = {
backdropFilter: bf,
background: rawFill,
border: qs.border,
borderRadius: qs.borderRadius,
boxShadow: qs.boxShadow === "none" ? "" : qs.boxShadow,
area: 0
};
}
glassByKey[key].area += qarea;
}
var glass = Object.values(glassByKey)
.sort(function(a, b) { return b.area - a.area; })
.slice(0, 3)
.map(function(g) { return { backdropFilter: g.backdropFilter, background: g.background, border: g.border, borderRadius: g.borderRadius, boxShadow: g.boxShadow, area: Math.round(g.area) }; });
return {
typography: uniqueTypo,
spacing: { observed: observedSpacing.slice(0, 15), baseUnit: baseUnit },
radius: radius,
shadows: shadows,
buttons: buttons,
cards: cards,
nav: nav,
chips: chips,
statCells: statCells,
tabs: tabs,
backgrounds: backgrounds,
glass: glass
};
})()`;
export async function extractDesignStyles(page: Pick<Page, "evaluate">): Promise<DesignStyles> {
return page.evaluate(EXTRACT_DESIGN_STYLES_SCRIPT) as Promise<DesignStyles>;
}