mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-03 04:38:33 +00:00
James Russo
69d9f08061
## What PR 2/17 of the catalog system rollout. **Physical directory rename.** Stacks on #252. - `git mv templates/ registry/examples/` — all 8 example directories (`decision-tree`, `kinetic-type`, `nyt-graph`, `play-mode`, `product-promo`, `swiss-grid`, `vignelli`, `warm-grain`) plus `templates.json` - `packages/cli/src/templates/remote.ts` — `TEMPLATES_DIR` constant from `"templates"` → `"registry/examples"`, exported for regression testing - `scripts/generate-template-previews.ts` — `remoteTemplatesDir` resolved to the new path - Comment updates in `packages/cli/src/templates/generators.ts` and `packages/cli/src/commands/init.ts` - New regression test `packages/cli/src/templates/remote.test.ts` pinning the path constants so future reverts fail a test instead of silently breaking installed CLIs Design doc: [Hyperframes Catalog System](https://www.notion.so/heygen/Hyperframes-Catalog-System-Design-Plan-341449792c69813f899dcd53b4c0383a). ## Why The current `templates/` directory is a flat "things that scaffold projects" bucket. The catalog model splits content into three tiers: **examples** (full projects — what today's templates are), **blocks** (sub-compositions), and **components** (effect snippets). `registry/examples/` is the canonical home for what was previously at `templates/`, and this PR makes room for `registry/blocks/` and `registry/components/` in future PRs without top-level clutter. ## How - `git mv` preserves file history — GitHub renders these as renames, not deletions + additions. - Remote template fetch via giget reads `TEMPLATES_DIR`, so updating that one constant is sufficient for the CLI's remote code path. - The CLI's **internal** `packages/cli/src/templates/` directory (which holds the `blank` and `_shared` bundled assets plus `generators.ts`/`remote.ts`) is a separate concept and is **not** touched here. Renaming that module belongs to PR 3 where the abstraction changes to a registry resolver. - `templates.json` keeps its existing shape and location (now at `registry/examples/templates.json`). **PR 3 will transform it** to the new `registry.json` shape introduced in PR 1 and generate a per-item `registry-item.json` for each example. Leaving the shape change to PR 3 keeps this PR a pure physical move. ## ⚠️ Breaking change for previously-installed CLIs (`hyperframes@0.1.0` – `0.3.0`) **What happens:** every published CLI version has `TEMPLATES_DIR = "templates"` baked in. After this PR lands on `main`, those CLIs will 404 on: - `raw.githubusercontent.com/heygen-com/hyperframes/main/templates/templates.json` (manifest list) — caught silently in `listRemoteTemplates`, so the template picker falls back to showing only `blank` - `github:heygen-com/hyperframes/templates/<id>#main` (giget download) — raises "Template downloaded but missing index.html" **Decision: accept the break.** Hyperframes is pre-1.0 OSS with a small installed base; complex mitigations (dual-path fetch, redirect stubs, manifest-at-old-path with empty array) add permanent maintenance cost for a one-time rename. **Rollout plan:** 1. Merge #252 (PR 1 — types & schemas) first 2. Merge this PR (#253) 3. Ship a patched CLI release (`hyperframes@0.3.1`) in the same work-day. Already-pinned old CLIs break on remote examples, but upgrading restores full functionality 4. Note the break in release notes + `CHANGELOG.md` under the `0.3.1` entry Users still on an older CLI will see the failure only if they invoke `hyperframes init` with `--template <non-blank>`; `--template blank` (bundled) continues to work offline on every version. ## Test plan - [x] `bun run test` in `packages/cli`: **57 passed** (was 55 on main, +2 regression tests for the path constants). Same 4 pre-existing failures (SRT/VTT whisper normalizer + `lintProject` clean-project test) — unchanged from main. No regressions - [x] **Manual smoke test**: `hyperframes init /tmp/x --template blank` works (bundled code path, unchanged) - [x] `bunx oxfmt --check` + `bunx oxlint`: clean - [x] `bun run typecheck` (core + studio, pre-commit hook): clean - [ ] **Manual smoke test for remote fetch (`--template warm-grain`)** — not verifiable locally before merge. Remote fetch resolves `github:heygen-com/hyperframes/registry/examples/<id>#main`, which doesn't exist until this PR lands. Will work on `main` immediately after merge. ## Breaking / migration - Internal repo path changes only. `--template` CLI flag continues to accept the same template names. - See "Breaking change for previously-installed CLIs" above — decision is to ship a simultaneous CLI release rather than add a compat shim. ## Commits 1. `d691bd1` — initial rename + CLI path constant update 2. `fc0c642` — review feedback: docstring fix, regression tests, clarifying comment in `init.ts`, export constants for testing ## Stacks on #252 — base branch. When #252 merges, this rebases onto `main`. ## Next in stack PR 3 — `feat(cli): registry resolver + installer`. Transforms `templates.json` to the new `registry.json` shape (from PR 1's schema), generates `registry-item.json` for every existing example, introduces `packages/cli/src/registry/{resolver,installer,remote}.ts`, renames the `packages/cli/src/templates/` CLI module, and refactors `init` to call through the new abstraction. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
272 lines
6.6 KiB
HTML
Vendored
272 lines
6.6 KiB
HTML
Vendored
<!doctype html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<title>Warm Grain - Hyperframes</title>
|
|
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
|
|
<style>
|
|
body,
|
|
html {
|
|
margin: 0;
|
|
padding: 0;
|
|
width: 1920px;
|
|
height: 1080px;
|
|
overflow: hidden;
|
|
background-color: #f5f0e0; /* Cream background */
|
|
font-family: "Outfit", "Lexend", sans-serif;
|
|
}
|
|
|
|
#main-composition {
|
|
position: relative;
|
|
width: 1920px;
|
|
height: 1080px;
|
|
overflow: hidden;
|
|
}
|
|
|
|
/* Paper texture and Grain overlay */
|
|
#grain-overlay-comp {
|
|
position: absolute;
|
|
top: 0;
|
|
left: 0;
|
|
width: 100%;
|
|
height: 100%;
|
|
pointer-events: none;
|
|
z-index: 100;
|
|
}
|
|
|
|
/* Grain animation */
|
|
@keyframes grain-noise {
|
|
0%,
|
|
100% {
|
|
transform: translate(0, 0);
|
|
}
|
|
10% {
|
|
transform: translate(-5%, -5%);
|
|
}
|
|
20% {
|
|
transform: translate(-10%, 5%);
|
|
}
|
|
30% {
|
|
transform: translate(5%, -10%);
|
|
}
|
|
40% {
|
|
transform: translate(-5%, 15%);
|
|
}
|
|
50% {
|
|
transform: translate(-10%, 5%);
|
|
}
|
|
60% {
|
|
transform: translate(15%, 0);
|
|
}
|
|
70% {
|
|
transform: translate(0, 10%);
|
|
}
|
|
80% {
|
|
transform: translate(-15%, 0);
|
|
}
|
|
90% {
|
|
transform: translate(10%, 5%);
|
|
}
|
|
}
|
|
|
|
.grain-texture {
|
|
position: absolute;
|
|
top: -50%;
|
|
left: -50%;
|
|
width: 200%;
|
|
height: 200%;
|
|
background: url("https://www.transparenttextures.com/patterns/natural-paper.png");
|
|
opacity: 0.15;
|
|
animation: grain-noise 0.5s steps(1) infinite;
|
|
}
|
|
|
|
#a-roll {
|
|
position: absolute;
|
|
border-radius: 16px;
|
|
object-fit: cover;
|
|
box-shadow: 0 10px 30px rgba(0, 0, 0, 0.1);
|
|
}
|
|
|
|
.comp-layer {
|
|
position: absolute;
|
|
top: 0;
|
|
left: 0;
|
|
width: 100%;
|
|
height: 100%;
|
|
pointer-events: none;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<div
|
|
id="main-composition"
|
|
data-composition-id="main-video"
|
|
data-width="1920"
|
|
data-height="1080"
|
|
data-start="0"
|
|
data-duration="__VIDEO_DURATION__"
|
|
>
|
|
<!-- Background Layer -->
|
|
<div
|
|
id="grain-overlay-comp"
|
|
data-composition-id="grain-overlay"
|
|
data-width="1920"
|
|
data-height="1080"
|
|
data-start="0"
|
|
data-duration="__VIDEO_DURATION__"
|
|
data-track-index="100"
|
|
>
|
|
<div class="grain-texture"></div>
|
|
<script>
|
|
const grainTl = gsap.timeline({ paused: true });
|
|
window.__timelines = window.__timelines || {};
|
|
window.__timelines["grain-overlay"] = grainTl;
|
|
</script>
|
|
</div>
|
|
|
|
<!-- A-Roll Video (muted — audio is separate) -->
|
|
<video
|
|
id="a-roll"
|
|
src="__VIDEO_SRC__"
|
|
muted
|
|
playsinline
|
|
data-start="0"
|
|
data-duration="__VIDEO_DURATION__"
|
|
data-track-index="0"
|
|
></video>
|
|
<audio
|
|
id="a-roll-audio"
|
|
src="__VIDEO_SRC__"
|
|
data-start="0"
|
|
data-duration="__VIDEO_DURATION__"
|
|
data-track-index="5"
|
|
data-volume="1"
|
|
></audio>
|
|
|
|
<!-- Compositions -->
|
|
<div
|
|
id="intro-layer"
|
|
class="comp-layer"
|
|
data-composition-id="intro"
|
|
data-composition-src="compositions/intro.html"
|
|
data-start="0"
|
|
data-duration="2.5"
|
|
data-track-index="1"
|
|
></div>
|
|
|
|
<div
|
|
id="graphics-layer"
|
|
class="comp-layer"
|
|
data-composition-id="graphics"
|
|
data-composition-src="compositions/graphics.html"
|
|
data-start="0"
|
|
data-duration="__VIDEO_DURATION__"
|
|
data-track-index="2"
|
|
></div>
|
|
|
|
<div
|
|
id="captions-layer"
|
|
class="comp-layer"
|
|
data-composition-id="captions"
|
|
data-composition-src="compositions/captions.html"
|
|
data-start="0"
|
|
data-duration="__VIDEO_DURATION__"
|
|
data-track-index="3"
|
|
></div>
|
|
|
|
<script>
|
|
const tl = gsap.timeline({ paused: true });
|
|
|
|
// A-Roll Framing Strategy
|
|
// 1. 0s-1.8s: Intro scale up from small (60%) to medium (80%) - Shifted right slightly to clear speaker card
|
|
// 2. 1.8s-4.6s: Grid view / Shift Left (x: 600, scale: 70%) for 47% graphic
|
|
// 3. 4.6s-8.8s: Shift Center-Bottom (y: 800, scale: 70%) for 62% graphic (top)
|
|
// 4. 8.8s-14s: Shift Right (x: 1320, scale: 75%) for Editing Skills graphic (left)
|
|
// 5. 14s-17s: Final Reveal (Center, scale: 100%)
|
|
|
|
// Initial state
|
|
gsap.set("#a-roll", {
|
|
x: 1100,
|
|
y: 540,
|
|
xPercent: -50,
|
|
yPercent: -50,
|
|
width: 1920 * 0.6,
|
|
height: 1080 * 0.6,
|
|
});
|
|
|
|
// 1. Intro Scale Up (0s - 1.8s)
|
|
tl.to(
|
|
"#a-roll",
|
|
{
|
|
x: 1200,
|
|
width: 1920 * 0.8,
|
|
height: 1080 * 0.8,
|
|
duration: 1.8,
|
|
ease: "power2.inOut",
|
|
},
|
|
0,
|
|
);
|
|
|
|
// 2. Moment 1: 47% Graphic Trigger (1.8s) - Shift Left
|
|
tl.to(
|
|
"#a-roll",
|
|
{
|
|
x: 600,
|
|
y: 540,
|
|
width: 1920 * 0.7,
|
|
height: 1080 * 0.7,
|
|
duration: 0.5,
|
|
ease: "power2.inOut",
|
|
},
|
|
1.8,
|
|
);
|
|
|
|
// 3. Moment 2: 62% Graphic Trigger (4.6s) - Shift Center-Bottom
|
|
tl.to(
|
|
"#a-roll",
|
|
{
|
|
x: 960,
|
|
y: 750,
|
|
width: 1920 * 0.7,
|
|
height: 1080 * 0.7,
|
|
duration: 0.5,
|
|
ease: "power2.inOut",
|
|
},
|
|
4.6,
|
|
);
|
|
|
|
// 4. Moment 3: Editing Skills Trigger (8.8s) - Shift Right
|
|
tl.to(
|
|
"#a-roll",
|
|
{
|
|
x: 1320,
|
|
y: 540,
|
|
width: 1920 * 0.75,
|
|
height: 1080 * 0.75,
|
|
duration: 0.5,
|
|
ease: "power2.inOut",
|
|
},
|
|
8.8,
|
|
);
|
|
|
|
// 5. Final Reveal (14s - 17s)
|
|
tl.to(
|
|
"#a-roll",
|
|
{
|
|
x: 960,
|
|
y: 540,
|
|
width: 1920 * 1.0,
|
|
height: 1080 * 1.0,
|
|
duration: 1.0,
|
|
ease: "power2.inOut",
|
|
},
|
|
14,
|
|
);
|
|
|
|
window.__timelines["main-video"] = tl;
|
|
</script>
|
|
</div>
|
|
</body>
|
|
</html>
|