mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-18 16:08:56 +00:00
* docs(catalog): put each item page's title, description and Docs text in the server HTML Mintlify renders snippet components in the browser only, so everything inside CatalogDetail (title, standfirst, the Docs tab) was missing from the HTML search engines read: 448 catalog pages served Googlebot no body text. The generator now writes the H1 and standfirst as page markup above the component and the Docs tab as page markup after it, shown with that tab (docs/custom.css). The component no longer draws its own title. Pages patched structurally only; registry drift on 14 pages is left for a regeneration of its own. * docs(catalog): keep the title's top spacing the component gave it * fix(docs): catalog titles and descriptions keep markdown markers literal MDX reads text inside the static <h1> and <p> as inline markdown, so @_blue_sweater_ rendered as italic blue_sweater. mdxText now writes backslash, backtick, * _ [ ] ~ as character references too, with a unit test; the four affected pages are re-escaped.
478 lines
15 KiB
Plaintext
478 lines
15 KiB
Plaintext
---
|
||
title: "US Map"
|
||
description: "Animated US choropleth map with staggered state reveals, value labels, and gradient legend — pure inline SVG with GSAP"
|
||
mode: "frame"
|
||
---
|
||
|
||
import { CatalogDetail, CatalogSlot } from "/snippets/catalog-detail.jsx";
|
||
import { InstallCommand } from "/snippets/install-command.jsx";
|
||
|
||
<div className="hf-ve-static-head not-prose">
|
||
<h1>US Map</h1>
|
||
<p>Animated US choropleth map with staggered state reveals, value labels, and gradient legend — pure inline SVG with GSAP</p>
|
||
</div>
|
||
|
||
<CatalogDetail
|
||
previewSrc="/public/catalog/blocks/us-map.json"
|
||
compositionId="us-map"
|
||
compositionSrc="compositions/us-map.html"
|
||
title="US Map"
|
||
variables={[]}
|
||
meta={{"duration":12,"width":1920,"height":1080,"category":"Data","badge":"Stable","codeLines":402}}
|
||
attribution={{"path":"registry/blocks/us-map","tags":["data","map","geography","usa","choropleth"]}}
|
||
hasCode
|
||
rawUrl="https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/blocks/us-map/us-map.html"
|
||
>
|
||
|
||
<CatalogSlot slot="code">
|
||
|
||
```html us-map.html
|
||
<!doctype html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="UTF-8" />
|
||
<meta name="viewport" content="width=1920, height=1080" />
|
||
<title>US Map</title>
|
||
<link rel="preconnect" href="https://fonts.googleapis.com" />
|
||
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
|
||
<link
|
||
href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=block"
|
||
rel="stylesheet"
|
||
/>
|
||
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
|
||
<script src="https://cdn.jsdelivr.net/npm/d3@7/dist/d3.min.js"></script>
|
||
<script src="https://cdn.jsdelivr.net/npm/topojson-client@3.1.0/dist/topojson-client.min.js"></script>
|
||
<style>
|
||
* {
|
||
margin: 0;
|
||
padding: 0;
|
||
box-sizing: border-box;
|
||
}
|
||
html,
|
||
body {
|
||
margin: 0;
|
||
width: 1920px;
|
||
height: 1080px;
|
||
overflow: hidden;
|
||
background-color: #0f172a;
|
||
}
|
||
</style>
|
||
</head>
|
||
<body>
|
||
<div
|
||
id="us-map"
|
||
data-composition-id="us-map"
|
||
data-width="1920"
|
||
data-height="1080"
|
||
data-start="0"
|
||
data-duration="12"
|
||
>
|
||
<div class="map-container">
|
||
<div class="header">
|
||
<h1 class="headline">Population Density by State</h1>
|
||
<p class="subtitle">Residents per square mile, 2024 Census estimates</p>
|
||
</div>
|
||
|
||
<svg class="map-svg" viewBox="0 0 1400 820" preserveAspectRatio="xMidYMid meet">
|
||
<g class="states-group"></g>
|
||
<g class="labels-group"></g>
|
||
</svg>
|
||
|
||
<div class="legend">
|
||
<span class="legend-label legend-low">Low</span>
|
||
<div class="legend-bar"></div>
|
||
<span class="legend-label legend-high">High</span>
|
||
</div>
|
||
|
||
<div class="source">Source: U.S. Census Bureau</div>
|
||
</div>
|
||
|
||
<style>
|
||
#us-map {
|
||
width: 1920px;
|
||
height: 1080px;
|
||
background: linear-gradient(145deg, #0f172a 0%, #1e293b 100%);
|
||
font-family: "Inter", sans-serif;
|
||
color: #e2e8f0;
|
||
display: flex;
|
||
justify-content: center;
|
||
align-items: center;
|
||
overflow: hidden;
|
||
}
|
||
|
||
#us-map .map-container {
|
||
width: 1700px;
|
||
height: 950px;
|
||
display: flex;
|
||
flex-direction: column;
|
||
align-items: center;
|
||
position: relative;
|
||
}
|
||
|
||
#us-map .header {
|
||
text-align: center;
|
||
margin-bottom: 20px;
|
||
}
|
||
|
||
#us-map .headline {
|
||
font-size: 52px;
|
||
font-weight: 700;
|
||
letter-spacing: -0.02em;
|
||
color: #f8fafc;
|
||
clip-path: inset(0 100% 0 0);
|
||
}
|
||
|
||
#us-map .subtitle {
|
||
font-size: 20px;
|
||
font-weight: 300;
|
||
color: #94a3b8;
|
||
margin-top: 8px;
|
||
opacity: 0;
|
||
}
|
||
|
||
#us-map .map-svg {
|
||
width: 1500px;
|
||
height: 750px;
|
||
overflow: visible;
|
||
}
|
||
|
||
#us-map .state-path {
|
||
stroke: #1e293b;
|
||
stroke-width: 1.2;
|
||
opacity: 0;
|
||
cursor: default;
|
||
}
|
||
|
||
#us-map .state-label {
|
||
font-size: 10px;
|
||
font-weight: 500;
|
||
fill: #f8fafc;
|
||
text-anchor: middle;
|
||
dominant-baseline: central;
|
||
opacity: 0;
|
||
pointer-events: none;
|
||
text-shadow: 0 1px 2px rgba(0, 0, 0, 0.5);
|
||
}
|
||
|
||
#us-map .legend {
|
||
display: flex;
|
||
align-items: center;
|
||
gap: 12px;
|
||
margin-top: 16px;
|
||
opacity: 0;
|
||
}
|
||
|
||
#us-map .legend-bar {
|
||
width: 300px;
|
||
height: 12px;
|
||
border-radius: 6px;
|
||
background: linear-gradient(90deg, #1e3a5f, #2563eb, #7c3aed, #ec4899);
|
||
}
|
||
|
||
#us-map .legend-label {
|
||
font-size: 14px;
|
||
font-weight: 500;
|
||
color: #94a3b8;
|
||
}
|
||
|
||
#us-map .source {
|
||
position: absolute;
|
||
bottom: 0;
|
||
right: 40px;
|
||
font-size: 12px;
|
||
color: #475569;
|
||
opacity: 0;
|
||
}
|
||
</style>
|
||
|
||
<script>
|
||
(function () {
|
||
const US_TOPO_URL = "https://cdn.jsdelivr.net/npm/us-atlas@3/states-10m.json";
|
||
|
||
const stateData = {
|
||
"01": { name: "Alabama", abbr: "AL", density: 99.2 },
|
||
"02": { name: "Alaska", abbr: "AK", density: 1.3 },
|
||
"04": { name: "Arizona", abbr: "AZ", density: 63.5 },
|
||
"05": { name: "Arkansas", abbr: "AR", density: 58.1 },
|
||
"06": { name: "California", abbr: "CA", density: 253.9 },
|
||
"08": { name: "Colorado", abbr: "CO", density: 56.5 },
|
||
"09": { name: "Connecticut", abbr: "CT", density: 738.1 },
|
||
10: { name: "Delaware", abbr: "DE", density: 508.0 },
|
||
12: { name: "Florida", abbr: "FL", density: 410.5 },
|
||
13: { name: "Georgia", abbr: "GA", density: 185.6 },
|
||
15: { name: "Hawaii", abbr: "HI", density: 226.6 },
|
||
16: { name: "Idaho", abbr: "ID", density: 22.8 },
|
||
17: { name: "Illinois", abbr: "IL", density: 228.2 },
|
||
18: { name: "Indiana", abbr: "IN", density: 186.7 },
|
||
19: { name: "Iowa", abbr: "IA", density: 57.1 },
|
||
20: { name: "Kansas", abbr: "KS", density: 35.9 },
|
||
21: { name: "Kentucky", abbr: "KY", density: 113.2 },
|
||
22: { name: "Louisiana", abbr: "LA", density: 107.7 },
|
||
23: { name: "Maine", abbr: "ME", density: 43.8 },
|
||
24: { name: "Maryland", abbr: "MD", density: 636.1 },
|
||
25: { name: "Massachusetts", abbr: "MA", density: 901.2 },
|
||
26: { name: "Michigan", abbr: "MI", density: 176.4 },
|
||
27: { name: "Minnesota", abbr: "MN", density: 71.7 },
|
||
28: { name: "Mississippi", abbr: "MS", density: 63.5 },
|
||
29: { name: "Missouri", abbr: "MO", density: 89.5 },
|
||
30: { name: "Montana", abbr: "MT", density: 7.6 },
|
||
31: { name: "Nebraska", abbr: "NE", density: 25.3 },
|
||
32: { name: "Nevada", abbr: "NV", density: 28.3 },
|
||
33: { name: "New Hampshire", abbr: "NH", density: 153.2 },
|
||
34: { name: "New Jersey", abbr: "NJ", density: 1263.0 },
|
||
35: { name: "New Mexico", abbr: "NM", density: 17.4 },
|
||
36: { name: "New York", abbr: "NY", density: 415.3 },
|
||
37: { name: "North Carolina", abbr: "NC", density: 214.7 },
|
||
38: { name: "North Dakota", abbr: "ND", density: 11.3 },
|
||
39: { name: "Ohio", abbr: "OH", density: 288.8 },
|
||
40: { name: "Oklahoma", abbr: "OK", density: 57.7 },
|
||
41: { name: "Oregon", abbr: "OR", density: 43.9 },
|
||
42: { name: "Pennsylvania", abbr: "PA", density: 286.1 },
|
||
44: { name: "Rhode Island", abbr: "RI", density: 1061.4 },
|
||
45: { name: "South Carolina", abbr: "SC", density: 170.2 },
|
||
46: { name: "South Dakota", abbr: "SD", density: 12.2 },
|
||
47: { name: "Tennessee", abbr: "TN", density: 167.0 },
|
||
48: { name: "Texas", abbr: "TX", density: 112.8 },
|
||
49: { name: "Utah", abbr: "UT", density: 40.3 },
|
||
50: { name: "Vermont", abbr: "VT", density: 68.0 },
|
||
51: { name: "Virginia", abbr: "VA", density: 218.6 },
|
||
53: { name: "Washington", abbr: "WA", density: 115.9 },
|
||
54: { name: "West Virginia", abbr: "WV", density: 74.6 },
|
||
55: { name: "Wisconsin", abbr: "WI", density: 108.8 },
|
||
56: { name: "Wyoming", abbr: "WY", density: 5.8 },
|
||
};
|
||
|
||
const maxDensity = 500;
|
||
|
||
function densityToColor(d) {
|
||
const t = Math.min(d / maxDensity, 1);
|
||
if (t < 0.33) {
|
||
const s = t / 0.33;
|
||
return lerpColor([30, 58, 95], [37, 99, 235], s);
|
||
} else if (t < 0.66) {
|
||
const s = (t - 0.33) / 0.33;
|
||
return lerpColor([37, 99, 235], [124, 58, 237], s);
|
||
} else {
|
||
const s = (t - 0.66) / 0.34;
|
||
return lerpColor([124, 58, 237], [236, 72, 153], s);
|
||
}
|
||
}
|
||
|
||
function lerpColor(a, b, t) {
|
||
const r = Math.round(a[0] + (b[0] - a[0]) * t);
|
||
const g = Math.round(a[1] + (b[1] - a[1]) * t);
|
||
const bl = Math.round(a[2] + (b[2] - a[2]) * t);
|
||
return "rgb(" + r + "," + g + "," + bl + ")";
|
||
}
|
||
|
||
const svg = document.querySelector("#us-map .map-svg");
|
||
const statesGroup = svg.querySelector(".states-group");
|
||
const labelsGroup = svg.querySelector(".labels-group");
|
||
const tl = gsap.timeline({ paused: true });
|
||
|
||
fetch(US_TOPO_URL)
|
||
.then((r) => r.json())
|
||
.then((us) => {
|
||
const states = topojson.feature(us, us.objects.states).features;
|
||
const projection = d3
|
||
.geoAlbersUsa()
|
||
.fitSize([1380, 800], { type: "FeatureCollection", features: states });
|
||
const path = d3.geoPath().projection(projection);
|
||
|
||
const sortedStates = states
|
||
.filter((f) => stateData[String(f.id).padStart(2, "0")])
|
||
.sort((a, b) => {
|
||
const aData = stateData[String(a.id).padStart(2, "0")];
|
||
const bData = stateData[String(b.id).padStart(2, "0")];
|
||
return aData.density - bData.density;
|
||
});
|
||
|
||
sortedStates.forEach((feature) => {
|
||
const fips = String(feature.id).padStart(2, "0");
|
||
const info = stateData[fips];
|
||
if (!info) return;
|
||
|
||
const d = path(feature);
|
||
if (!d) return;
|
||
|
||
const el = document.createElementNS("http://www.w3.org/2000/svg", "path");
|
||
el.setAttribute("d", d);
|
||
el.setAttribute("class", "state-path");
|
||
el.setAttribute("data-state", info.abbr);
|
||
el.setAttribute("data-density", info.density);
|
||
el.style.fill = densityToColor(info.density);
|
||
statesGroup.appendChild(el);
|
||
|
||
const centroid = path.centroid(feature);
|
||
if (centroid[0] && centroid[1]) {
|
||
const label = document.createElementNS("http://www.w3.org/2000/svg", "text");
|
||
label.setAttribute("x", centroid[0]);
|
||
label.setAttribute("y", centroid[1]);
|
||
label.setAttribute("class", "state-label");
|
||
label.textContent = info.abbr;
|
||
labelsGroup.appendChild(label);
|
||
}
|
||
});
|
||
|
||
buildTimeline();
|
||
});
|
||
|
||
function buildTimeline() {
|
||
const statePaths = statesGroup.querySelectorAll(".state-path");
|
||
const stateLabels = labelsGroup.querySelectorAll(".state-label");
|
||
|
||
tl.to(
|
||
"#us-map .headline",
|
||
{
|
||
clipPath: "inset(0 0% 0 0)",
|
||
duration: 1.0,
|
||
ease: "power2.inOut",
|
||
},
|
||
0,
|
||
);
|
||
|
||
tl.to(
|
||
"#us-map .subtitle",
|
||
{
|
||
opacity: 1,
|
||
duration: 0.6,
|
||
ease: "power2.out",
|
||
},
|
||
0.4,
|
||
);
|
||
|
||
tl.to(
|
||
statePaths,
|
||
{
|
||
opacity: 1,
|
||
scale: 1,
|
||
duration: 0.4,
|
||
stagger: {
|
||
each: 0.06,
|
||
from: "center",
|
||
},
|
||
ease: "back.out(1.4)",
|
||
},
|
||
1.0,
|
||
);
|
||
|
||
tl.to(
|
||
stateLabels,
|
||
{
|
||
opacity: 1,
|
||
duration: 0.3,
|
||
stagger: {
|
||
each: 0.04,
|
||
from: "center",
|
||
},
|
||
ease: "power2.out",
|
||
},
|
||
3.5,
|
||
);
|
||
|
||
tl.to(
|
||
"#us-map .legend",
|
||
{
|
||
opacity: 1,
|
||
y: 0,
|
||
duration: 0.6,
|
||
ease: "power2.out",
|
||
},
|
||
5.0,
|
||
);
|
||
|
||
tl.to(
|
||
"#us-map .source",
|
||
{
|
||
opacity: 1,
|
||
duration: 0.5,
|
||
ease: "power2.out",
|
||
},
|
||
5.5,
|
||
);
|
||
|
||
const highlightStates = ["CA", "NY", "TX", "FL", "NJ"];
|
||
highlightStates.forEach((abbr, i) => {
|
||
const el = statesGroup.querySelector('[data-state="' + abbr + '"]');
|
||
if (!el) return;
|
||
|
||
tl.to(
|
||
el,
|
||
{
|
||
filter: "brightness(1.6) drop-shadow(0 0 8px rgba(255,255,255,0.4))",
|
||
stroke: "#f8fafc",
|
||
strokeWidth: 2.5,
|
||
duration: 0.5,
|
||
ease: "power2.out",
|
||
},
|
||
6.5 + i * 0.8,
|
||
);
|
||
|
||
tl.to(
|
||
el,
|
||
{
|
||
filter: "brightness(1) drop-shadow(0 0 0px rgba(255,255,255,0))",
|
||
stroke: "#1e293b",
|
||
strokeWidth: 1.2,
|
||
duration: 0.5,
|
||
ease: "power2.in",
|
||
},
|
||
7.0 + i * 0.8,
|
||
);
|
||
});
|
||
|
||
window.__timelines = window.__timelines || {};
|
||
window.__timelines["us-map"] = tl;
|
||
}
|
||
})();
|
||
</script>
|
||
</div>
|
||
</body>
|
||
</html>
|
||
```
|
||
|
||
</CatalogSlot>
|
||
|
||
<CatalogSlot slot="install">
|
||
|
||
<InstallCommand command="npx hyperframes add us-map" item="us-map" />
|
||
|
||
That writes one file: `compositions/us-map.html`.
|
||
|
||
</CatalogSlot>
|
||
|
||
</CatalogDetail>
|
||
|
||
<div data-static-slot="docs" className="prose prose-gray dark:prose-invert">
|
||
|
||
## Add it to your video
|
||
|
||
It runs for 12 seconds at 1920×1080. Paste this into your composition:
|
||
|
||
```html index.html
|
||
<div
|
||
data-composition-id="us-map"
|
||
data-composition-src="compositions/us-map.html"
|
||
data-start="0"
|
||
data-duration="12"
|
||
data-track-index="1"
|
||
data-width="1920"
|
||
data-height="1080"
|
||
></div>
|
||
```
|
||
|
||
Move it in time with `data-start`. Put it on a different timeline row with
|
||
`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
|
||
|
||
{/* hf:generated-footer */}
|
||
|
||
Tagged `data` `map` `geography` `usa` `choropleth`.
|
||
|
||
## Related topics
|
||
|
||
- [Browse the complete Catalog](/catalog)
|
||
- [Add assets and Catalog items in the browser editor](/studio/assets-and-blocks)
|
||
- [Put blocks together into one video](/concepts/compositions)
|
||
|
||
</div>
|