mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-04 16:42:27 +00:00
feat(registry): seed components — grain-overlay, shimmer-sweep, grid-pixelate-wipe (#260)
## What Three reusable effect components for the registry, each with a snippet HTML and companion `demo.html`: | Component | Description | |-----------|-------------| | `grain-overlay` | Animated film grain texture overlay (CSS keyframes, extracted from warm-grain example) | | `shimmer-sweep` | CSS gradient light sweep across text/elements, driven by GSAP custom property animation | | `grid-pixelate-wipe` | Grid-based dissolve transition — screen breaks into 16×9 squares that scale in/out with stagger | Establishes the `demo.html` convention in `CONTRIBUTING.md`. ## Why Phase B of the catalog plan — seed the first components in the registry. Components are effect snippets that get merged into existing compositions (vs. blocks which are standalone sub-compositions). ## How - **grain-overlay**: Extracted the grain texture pattern from the warm-grain example. Uses a 200% oversized tiled texture with `steps(1)` keyframe animation for the random-noise effect. - **shimmer-sweep**: Original implementation using CSS custom properties (`--shimmer-pos`) animated by GSAP. The gradient mask uses `mix-blend-mode: overlay` for a natural light sweep. Auto-injects `.shimmer-mask` elements into `.shimmer-sweep-target` wrappers. - **grid-pixelate-wipe**: Creates a 16×9 CSS Grid of cells, animated with GSAP stagger. Users drive `.grid-cell` `scale` directly in their timeline. Simplify review addressed: scoped `.grain-texture` under `#grain-overlay`, scoped `.grid-cell` under `#grid-pixelate-overlay`, removed `window.gridPixelateIn/Out` globals in favor of direct GSAP patterns. Each component ships a `demo.html` — a standalone composition that previews the effect and doubles as a fixture for the CI preview pipeline (PR 8). ## Test plan - [x] `hyperframes add grain-overlay` installs to `compositions/components/grain-overlay.html` - [x] `hyperframes add shimmer-sweep` installs to `compositions/components/shimmer-sweep.html` - [x] `hyperframes add grid-pixelate-wipe` installs to `compositions/components/grid-pixelate-wipe.html` - [x] All three return correct `--json` output with snippet and type info - [x] `registry-item.json` files validate against the JSON Schema - [x] `demo.html` files are self-contained with correct `data-composition-id` and `window.__timelines` registration - [x] `oxfmt --check` and `oxlint` pass on all files - [x] `CONTRIBUTING.md` documents the `demo.html` convention and registry item checklist
This commit is contained in:
James Russo
@@ -0,0 +1,179 @@
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8" />
|
||||
<meta name="viewport" content="width=1920, height=1080" />
|
||||
<title>Grid Pixelate Wipe — Demo</title>
|
||||
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
|
||||
<style>
|
||||
* {
|
||||
margin: 0;
|
||||
padding: 0;
|
||||
box-sizing: border-box;
|
||||
}
|
||||
html,
|
||||
body {
|
||||
margin: 0;
|
||||
width: 1920px;
|
||||
height: 1080px;
|
||||
overflow: hidden;
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div
|
||||
id="demo"
|
||||
data-composition-id="grid-pixelate-wipe-demo"
|
||||
data-width="1920"
|
||||
data-height="1080"
|
||||
data-duration="8"
|
||||
>
|
||||
<!-- Scene A -->
|
||||
<div
|
||||
id="scene-a"
|
||||
style="
|
||||
position: absolute;
|
||||
width: 1920px;
|
||||
height: 1080px;
|
||||
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
|
||||
display: flex;
|
||||
justify-content: center;
|
||||
align-items: center;
|
||||
font-family: "Inter", sans-serif;
|
||||
"
|
||||
>
|
||||
<div style="text-align: center; color: white">
|
||||
<div style="font-size: 80px; font-weight: 800">Scene A</div>
|
||||
<div style="font-size: 32px; margin-top: 20px; opacity: 0.7">
|
||||
The grid wipe dissolves this away
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Scene B (hidden initially) -->
|
||||
<div
|
||||
id="scene-b"
|
||||
style="
|
||||
position: absolute;
|
||||
width: 1920px;
|
||||
height: 1080px;
|
||||
background: linear-gradient(135deg, #f093fb 0%, #f5576c 100%);
|
||||
display: flex;
|
||||
justify-content: center;
|
||||
align-items: center;
|
||||
font-family: "Inter", sans-serif;
|
||||
opacity: 0;
|
||||
"
|
||||
>
|
||||
<div style="text-align: center; color: white">
|
||||
<div style="font-size: 80px; font-weight: 800">Scene B</div>
|
||||
<div style="font-size: 32px; margin-top: 20px; opacity: 0.7">Revealed from the grid</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Grid Pixelate Wipe overlay -->
|
||||
<div
|
||||
id="grid-pixelate-overlay"
|
||||
style="
|
||||
position: absolute;
|
||||
top: 0;
|
||||
left: 0;
|
||||
width: 100%;
|
||||
height: 100%;
|
||||
pointer-events: none;
|
||||
z-index: 999;
|
||||
display: grid;
|
||||
"
|
||||
></div>
|
||||
|
||||
<style>
|
||||
#grid-pixelate-overlay {
|
||||
--grid-color: black;
|
||||
}
|
||||
|
||||
#grid-pixelate-overlay .grid-cell {
|
||||
background: var(--grid-color);
|
||||
transform: scale(0);
|
||||
transform-origin: center center;
|
||||
}
|
||||
</style>
|
||||
|
||||
<script>
|
||||
(function () {
|
||||
const COLS = 16;
|
||||
const ROWS = 9;
|
||||
const overlay = document.getElementById("grid-pixelate-overlay");
|
||||
|
||||
overlay.style.gridTemplateColumns = `repeat(${COLS}, 1fr)`;
|
||||
overlay.style.gridTemplateRows = `repeat(${ROWS}, 1fr)`;
|
||||
|
||||
for (let i = 0; i < COLS * ROWS; i++) {
|
||||
const cell = document.createElement("div");
|
||||
cell.className = "grid-cell";
|
||||
overlay.appendChild(cell);
|
||||
}
|
||||
|
||||
const tl = gsap.timeline({ paused: true });
|
||||
|
||||
// Scene A visible for 2 seconds
|
||||
// Grid covers screen (transition out of A)
|
||||
tl.to(
|
||||
".grid-cell",
|
||||
{
|
||||
scale: 1,
|
||||
duration: 0.6,
|
||||
stagger: { amount: 0.6, from: "center" },
|
||||
ease: "power2.inOut",
|
||||
},
|
||||
2.0,
|
||||
);
|
||||
|
||||
// Swap scenes at midpoint
|
||||
tl.set("#scene-a", { opacity: 0 }, 3.0);
|
||||
tl.set("#scene-b", { opacity: 1 }, 3.0);
|
||||
|
||||
// Grid reveals scene B
|
||||
tl.to(
|
||||
".grid-cell",
|
||||
{
|
||||
scale: 0,
|
||||
duration: 0.6,
|
||||
stagger: { amount: 0.6, from: "edges" },
|
||||
ease: "power2.inOut",
|
||||
},
|
||||
3.0,
|
||||
);
|
||||
|
||||
// Second transition: back to A using random pattern
|
||||
tl.to(
|
||||
".grid-cell",
|
||||
{
|
||||
scale: 1,
|
||||
duration: 0.5,
|
||||
stagger: { amount: 0.5, from: "random" },
|
||||
ease: "power2.inOut",
|
||||
},
|
||||
5.5,
|
||||
);
|
||||
|
||||
tl.set("#scene-b", { opacity: 0 }, 6.3);
|
||||
tl.set("#scene-a", { opacity: 1 }, 6.3);
|
||||
|
||||
tl.to(
|
||||
".grid-cell",
|
||||
{
|
||||
scale: 0,
|
||||
duration: 0.5,
|
||||
stagger: { amount: 0.5, from: "random" },
|
||||
ease: "power2.inOut",
|
||||
},
|
||||
6.3,
|
||||
);
|
||||
|
||||
window.__timelines = window.__timelines || {};
|
||||
window.__timelines["grid-pixelate-wipe-demo"] = tl;
|
||||
})();
|
||||
</script>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user