Files
hyperframes/registry/examples/swiss-grid/compositions/graphics.html
T
James Russo 69d9f08061 refactor: migrate templates/ → registry/examples/ (#253)
## 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)
2026-04-13 20:21:23 -07:00

208 lines
5.6 KiB
HTML
Vendored

<template id="graphics-template">
<div data-composition-id="graphics" data-width="1920" data-height="1080" data-duration="15">
<div class="grid-container">
<!-- Stat 1: 47% -->
<div id="stat1" class="stat-group">
<div class="stat-value">47%</div>
<div class="stat-label">NEED MOTION GRAPHICS</div>
</div>
<!-- Stat 2: 62% -->
<div id="stat2" class="stat-group">
<div class="stat-value">62%</div>
<div class="stat-label">LOSING ATTENTION</div>
<div class="progress-container">
<div class="progress-bar"></div>
</div>
</div>
<!-- Stat 3: 3 OF 4 -->
<div id="stat3" class="stat-group">
<div class="stat-value">3 OF 4</div>
<div class="stat-label">LACK EDITING SKILLS</div>
<div class="grid-blocks">
<div class="block gold"></div>
<div class="block gold"></div>
<div class="block gold"></div>
<div class="block navy"></div>
</div>
</div>
</div>
<style>
[data-composition-id="graphics"] {
font-family: "Helvetica", Arial, sans-serif;
color: #0a1e3d;
background: transparent;
width: 1920px;
height: 1080px;
position: relative;
overflow: hidden;
}
[data-composition-id="graphics"] .grid-container {
display: grid;
grid-template-columns: repeat(12, 1fr);
grid-template-rows: repeat(12, 1fr);
width: 100%;
height: 100%;
padding: 80px;
gap: 20px;
}
[data-composition-id="graphics"] .stat-group {
opacity: 0;
display: flex;
flex-direction: column;
justify-content: flex-start;
align-items: flex-start;
background: #f2f2f2;
padding: 40px;
border-left: 10px solid #d4a017;
box-shadow: 20px 20px 0px rgba(10, 30, 61, 0.1);
}
/* Positioning Stats on Grid - Adjusted for A-roll structure */
[data-composition-id="graphics"] #stat1 {
grid-column: 2 / 6;
grid-row: 3 / 7;
}
[data-composition-id="graphics"] #stat2 {
grid-column: 2 / 6;
grid-row: 3 / 7;
}
[data-composition-id="graphics"] #stat3 {
grid-column: 7 / 12;
grid-row: 3 / 7;
}
[data-composition-id="graphics"] .stat-value {
font-size: 140px;
font-weight: 900;
color: #d4a017;
line-height: 0.8;
margin-bottom: 15px;
}
[data-composition-id="graphics"] .stat-label {
font-size: 24px;
font-weight: 300; /* Lighter weight */
color: #0a1e3d;
letter-spacing: 2px;
text-transform: uppercase;
}
/* Progress Bar for Stat 2 */
[data-composition-id="graphics"] .progress-container {
width: 100%;
height: 24px;
background: #e0e0e0;
margin-top: 30px;
border: 2px solid #0a1e3d;
position: relative;
}
[data-composition-id="graphics"] .progress-bar {
width: 0%;
height: 100%;
background: #d4a017;
}
/* Grid Blocks for Stat 3 */
[data-composition-id="graphics"] .grid-blocks {
display: flex;
gap: 20px;
margin-top: 30px;
}
[data-composition-id="graphics"] .block {
width: 80px;
height: 80px;
border: 3px solid #0a1e3d;
}
[data-composition-id="graphics"] .block.gold {
background: #d4a017;
}
[data-composition-id="graphics"] .block.navy {
background: #0a1e3d;
}
</style>
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
<script>
(function () {
const tl = gsap.timeline({ paused: true });
// Timing Constants
const S1_START = 1.86;
const S1_END = 4.5;
const S2_START = 4.68;
const S2_END = 8.6;
const S3_START = 8.88;
const S3_END = 14.2;
const SLIDE_DUR = 0.25; // 250ms
const SHARP_EASE = "power2.out";
// Stat 1 Animation
tl.fromTo(
"#stat1",
{ x: -200, opacity: 0 },
{ x: 0, opacity: 1, duration: SLIDE_DUR, ease: SHARP_EASE },
S1_START,
);
tl.to(
"#stat1",
{ x: 200, opacity: 0, duration: SLIDE_DUR, ease: "power2.in" },
S1_END - SLIDE_DUR,
);
// Stat 2 Animation
tl.fromTo(
"#stat2",
{ y: 200, opacity: 0 },
{ y: 0, opacity: 1, duration: SLIDE_DUR, ease: SHARP_EASE },
S2_START,
);
// Progress bar fill
tl.to(
"#stat2 .progress-bar",
{ width: "62%", duration: S2_END - S2_START - SLIDE_DUR * 2, ease: "none" },
S2_START + SLIDE_DUR,
);
tl.to(
"#stat2",
{ y: -200, opacity: 0, duration: SLIDE_DUR, ease: "power2.in" },
S2_END - SLIDE_DUR,
);
// Stat 3 Animation
tl.fromTo(
"#stat3",
{ x: 200, opacity: 0 },
{ x: 0, opacity: 1, duration: SLIDE_DUR, ease: SHARP_EASE },
S3_START,
);
// Stagger blocks
tl.from(
"#stat3 .block",
{ scale: 0, duration: 0.3, stagger: 0.1, ease: "back.out(1.7)" },
S3_START + SLIDE_DUR,
);
tl.to(
"#stat3",
{ x: -200, opacity: 0, duration: SLIDE_DUR, ease: "power2.in" },
S3_END - SLIDE_DUR,
);
window.__timelines = window.__timelines || {};
window.__timelines["graphics"] = tl;
})();
</script>
</div>
</template>