Files
hyperframes/registry/examples/vignelli/compositions/captions.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

188 lines
6.5 KiB
HTML
Vendored

<template id="captions-template">
<div
data-composition-id="captions"
data-width="1080"
data-height="1920"
data-duration="__VIDEO_DURATION__"
>
<div id="captions-container"></div>
<style>
[data-composition-id="captions"] {
position: absolute;
top: 0;
left: 0;
width: 1080px;
height: 1920px;
font-family: "Helvetica", "Helvetica Neue", Arial, sans-serif;
font-weight: 900; /* Helvetica Black/Bold */
text-transform: uppercase;
pointer-events: none;
}
[data-composition-id="captions"] #captions-container {
position: absolute;
inset: 0;
}
[data-composition-id="captions"] .caption-group {
position: absolute;
left: 50%;
transform: translateX(-50%);
width: auto;
max-width: 920px; /* 1080 - 2*80 */
bottom: 672px;
display: flex;
justify-content: center;
align-items: center;
text-align: center;
opacity: 0;
z-index: 10;
}
[data-composition-id="captions"] .caption-text {
font-size: 64px;
line-height: 1.1;
color: #000000;
background-color: #ffffff;
padding: 15px 30px;
border-top: 8px solid #cc0000; /* Vignelli Red top border accent */
display: inline-block;
letter-spacing: -0.02em; /* Tight Helvetica spacing */
white-space: nowrap; /* Prevent wrapping at the element level */
max-width: 900px;
overflow: hidden;
}
</style>
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
<script>
(function () {
const TRANSCRIPT = [
{ text: "We", start: 0.14, end: 0.239 },
{ text: "asked", start: 0.28, end: 0.459 },
{ text: "what", start: 0.5, end: 0.619 },
{ text: "you", start: 0.659, end: 0.779 },
{ text: "needed.", start: 0.8, end: 1.179 },
{ text: "Forty-seven", start: 1.199, end: 1.619 },
{ text: "percent", start: 1.699, end: 1.96 },
{ text: "of", start: 1.979, end: 2.059 },
{ text: "you", start: 2.099, end: 2.299 },
{ text: "said", start: 2.319, end: 2.499 },
{ text: "motion", start: 2.559, end: 2.839 },
{ text: "graphics,", start: 2.899, end: 3.759 },
{ text: "sixty-two", start: 3.799, end: 4.159 },
{ text: "percent", start: 4.239, end: 4.559 },
{ text: "said", start: 4.639, end: 4.799 },
{ text: "static", start: 4.859, end: 5.199 },
{ text: "content", start: 5.239, end: 5.639 },
{ text: "was", start: 5.679, end: 5.779 },
{ text: "costing", start: 5.859, end: 6.219 },
{ text: "you", start: 6.259, end: 6.339 },
{ text: "attention,", start: 6.379, end: 7.299 },
{ text: "and", start: 7.319, end: 7.439 },
{ text: "three", start: 7.48, end: 7.599 },
{ text: "out", start: 7.679, end: 7.779 },
{ text: "of", start: 7.799, end: 7.879 },
{ text: "four", start: 7.94, end: 8.139 },
{ text: "said", start: 8.279, end: 8.46 },
{ text: "you", start: 8.519, end: 8.6 },
{ text: "know", start: 8.619, end: 8.739 },
{ text: "the", start: 8.8, end: 8.88 },
{ text: "look", start: 8.92, end: 9.079 },
{ text: "you", start: 9.119, end: 9.259 },
{ text: "want", start: 9.279, end: 9.619 },
{ text: "but", start: 9.779, end: 9.88 },
{ text: "don't", start: 9.92, end: 10.1 },
{ text: "have", start: 10.159, end: 10.3 },
{ text: "the", start: 10.3, end: 10.42 },
{ text: "editing", start: 10.5, end: 10.779 },
{ text: "skills", start: 10.86, end: 11.139 },
{ text: "to", start: 11.159, end: 11.239 },
{ text: "get", start: 11.279, end: 11.439 },
{ text: "there.", start: 11.46, end: 12.239 },
{ text: "So", start: 12.3, end: 12.38 },
{ text: "we", start: 12.399, end: 12.519 },
{ text: "built", start: 12.539, end: 12.759 },
{ text: "Hyperframes", start: 12.84, end: 13.119 },
];
const tl = gsap.timeline({ paused: true });
const container = document.getElementById("captions-container");
// Group words into single lines (max words or based on pauses/sentence ends)
function groupTranscript(transcript, maxWords = 3) {
const groups = [];
let currentGroup = [];
transcript.forEach((word, index) => {
currentGroup.push(word);
const nextWord = transcript[index + 1];
const isPause = nextWord && nextWord.start - word.end > 0.15;
const isSentenceEnd =
word.text.includes(".") || word.text.includes("?") || word.text.includes("!");
if (currentGroup.length >= maxWords || isPause || isSentenceEnd || !nextWord) {
groups.push({
words: currentGroup,
start: currentGroup[0].start,
end: currentGroup[currentGroup.length - 1].end,
text: currentGroup.map((w) => w.text).join(" "),
});
currentGroup = [];
}
});
return groups;
}
const captionGroups = groupTranscript(TRANSCRIPT);
captionGroups.forEach((group, index) => {
const div = document.createElement("div");
div.className = "caption-group";
div.id = `group-${index}`;
const textSpan = document.createElement("span");
textSpan.className = "caption-text";
textSpan.innerText = group.text;
div.appendChild(textSpan);
container.appendChild(div);
// Animation: Modern "expo.out" transitions
// Entrance
tl.fromTo(
div,
{ opacity: 0, y: 20 },
{
opacity: 1,
y: 0,
duration: 0.4,
ease: "expo.out",
},
group.start,
);
// Exit
tl.to(
div,
{
opacity: 0,
y: -10,
duration: 0.3,
ease: "expo.out",
},
group.end - 0.3,
);
// Hard kill to ensure caption is hidden
tl.set(div, { opacity: 0, visibility: "hidden" }, group.end);
});
window.__timelines = window.__timelines || {};
window.__timelines["captions"] = tl;
})();
</script>
</div>
</template>