mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-16 06:19:21 +00:00
The generated catalog pages rendered the "Source" accordion title as a
JSX expression, `<Accordion title={`name.html`}>`. Mintlify's search
indexer stringifies expression attribute nodes rather than evaluating
them, so every one of the 399 catalog pages surfaced its Source section
in search results as "[object Object]" (visible on the Scroll Feed page,
among others).
The template literal carried no escaping benefit: every title is a
single-segment `name.html` path, and a double-quoted JSX string handles
it directly. Introduce `mdxStringAttribute`, which emits a plain
`name="value"` attribute and escapes `& " < { }` as HTML character
references (MDX decodes references inside quoted attribute values, and
unlike JSON.stringify it does not rely on backslash escapes, which JSX
strings do not honour). Use it for both the Source accordion title and
the preview iframe title, and regenerate the catalog pages.
Regenerated with `npx tsx scripts/generate-catalog-pages.ts`; the only
change across the 399 pages is the one Accordion title line each.
Co-authored-by: Miguel Ángel <miguel.sierra@heygen.com>
308 lines
9.1 KiB
Plaintext
308 lines
9.1 KiB
Plaintext
---
|
||
title: "Code Snippet - Apple Terminal Novel"
|
||
description: "Apple Terminal Novel profile: warm parchment background with dark brown text, per-character typing animation of a shell session."
|
||
---
|
||
|
||
import { InstallCommand } from "/snippets/install-command.jsx";
|
||
|
||
## Install
|
||
|
||
<InstallCommand command="npx hyperframes add code-snippet-apple-terminal-novel" item="code-snippet-apple-terminal-novel" />
|
||
|
||
That writes one file: `compositions/code-snippet-apple-terminal-novel.html`.
|
||
|
||
<iframe
|
||
className="w-full aspect-video rounded-xl border-0 bg-zinc-100 dark:bg-zinc-800"
|
||
title="code-snippet-apple-terminal-novel preview"
|
||
loading="lazy"
|
||
srcDoc={`<!doctype html><html><head><meta charset="utf-8"><style>html,body{margin:0;height:100%;overflow:hidden;background:transparent}hyperframes-player{display:block;width:100%;height:100%}</style><script src="https://cdn.jsdelivr.net/npm/@hyperframes/player@latest/dist/hyperframes-player.global.js"><\/script></head><body><script>fetch("/public/catalog/blocks/code-snippet-apple-terminal-novel.json").then(function(r){return r.json()}).then(function(d){var p=document.createElement("hyperframes-player");p.setAttribute("srcdoc",d.html);p.setAttribute("controls","");p.setAttribute("autoplay","");p.setAttribute("loop","");p.setAttribute("muted","");p.setAttribute("poster","https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/code-snippet-apple-terminal-novel.png");document.body.appendChild(p)});<\/script></body></html>`}
|
||
/>
|
||
|
||
## Source
|
||
|
||
<Accordion title="code-snippet-apple-terminal-novel.html">
|
||
|
||
```html
|
||
<!doctype html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="UTF-8" />
|
||
<meta name="viewport" content="width=1920, height=1080" />
|
||
<title>Apple Terminal Novel</title>
|
||
<style>
|
||
html,
|
||
body {
|
||
margin: 0;
|
||
padding: 0;
|
||
width: 1920px;
|
||
height: 1080px;
|
||
overflow: hidden;
|
||
font-family: "SF Mono", Menlo, Monaco, Consolas, "Courier New", monospace;
|
||
}
|
||
|
||
#scene {
|
||
width: 1920px;
|
||
height: 1080px;
|
||
position: relative;
|
||
display: flex;
|
||
align-items: center;
|
||
justify-content: center;
|
||
background: linear-gradient(135deg, #c9a86c 0%, #b8955a 100%);
|
||
}
|
||
|
||
.terminal-window {
|
||
width: 1400px;
|
||
height: 700px;
|
||
border-radius: 10px;
|
||
overflow: hidden;
|
||
box-shadow:
|
||
0 30px 80px rgba(62, 41, 0, 0.3),
|
||
0 10px 30px rgba(0, 0, 0, 0.15);
|
||
display: flex;
|
||
flex-direction: column;
|
||
}
|
||
|
||
.titlebar {
|
||
height: 38px;
|
||
background: #c9a86c;
|
||
display: flex;
|
||
align-items: center;
|
||
padding: 0 14px;
|
||
flex-shrink: 0;
|
||
border-bottom: 1px solid #a88040;
|
||
position: relative;
|
||
}
|
||
|
||
.traffic-lights {
|
||
display: flex;
|
||
gap: 8px;
|
||
align-items: center;
|
||
}
|
||
|
||
.traffic-lights span {
|
||
width: 13px;
|
||
height: 13px;
|
||
border-radius: 50%;
|
||
display: inline-block;
|
||
}
|
||
|
||
.traffic-lights .close {
|
||
background: #ff5f57;
|
||
border: 1px solid #e0443e;
|
||
}
|
||
|
||
.traffic-lights .minimize {
|
||
background: #ffbd2e;
|
||
border: 1px solid #dfa123;
|
||
}
|
||
|
||
.traffic-lights .fullscreen {
|
||
background: #28c840;
|
||
border: 1px solid #1aab29;
|
||
}
|
||
|
||
.window-title {
|
||
position: absolute;
|
||
left: 50%;
|
||
transform: translateX(-50%);
|
||
font-size: 13px;
|
||
color: #3e2900;
|
||
font-family: -apple-system, BlinkMacSystemFont, "SF Pro Text", sans-serif;
|
||
font-weight: 600;
|
||
letter-spacing: -0.1px;
|
||
}
|
||
|
||
.terminal-canvas {
|
||
flex: 1;
|
||
background: #dfc18a;
|
||
padding: 18px 20px;
|
||
overflow: hidden;
|
||
font-size: 14px;
|
||
line-height: 1.6;
|
||
color: #3e2900;
|
||
}
|
||
|
||
.output-lines {
|
||
margin-bottom: 4px;
|
||
}
|
||
|
||
.output-line {
|
||
display: block;
|
||
white-space: pre;
|
||
opacity: 0;
|
||
color: #3e2900;
|
||
}
|
||
|
||
.output-line.bold {
|
||
font-weight: bold;
|
||
color: #3e2900;
|
||
}
|
||
|
||
.output-line.muted {
|
||
color: #7a5a20;
|
||
}
|
||
|
||
.input-line {
|
||
display: flex;
|
||
align-items: center;
|
||
white-space: pre;
|
||
}
|
||
|
||
.prompt {
|
||
color: #3e2900;
|
||
font-weight: bold;
|
||
user-select: none;
|
||
}
|
||
|
||
.typed-command {
|
||
color: #3e2900;
|
||
}
|
||
|
||
.cursor-block {
|
||
display: inline-block;
|
||
width: 9px;
|
||
height: 16px;
|
||
background: #3e2900;
|
||
vertical-align: text-bottom;
|
||
margin-left: 1px;
|
||
}
|
||
</style>
|
||
</head>
|
||
<body>
|
||
<div
|
||
id="scene"
|
||
data-composition-id="code-snippet-apple-terminal-novel"
|
||
data-width="1920"
|
||
data-height="1080"
|
||
>
|
||
<div class="terminal-window">
|
||
<div class="titlebar">
|
||
<div class="traffic-lights">
|
||
<span class="close"></span>
|
||
<span class="minimize"></span>
|
||
<span class="fullscreen"></span>
|
||
</div>
|
||
<span class="window-title">bash — 80×24</span>
|
||
</div>
|
||
<div class="terminal-canvas">
|
||
<div class="output-lines">
|
||
<span class="output-line muted">Last login: Mon Jun 2 09:14:22 on ttys006</span>
|
||
<span class="output-line muted">Python 3.12.4 (main, Jun 6 2024, 18:26:44)</span>
|
||
<span class="output-line muted"
|
||
>Type "help", "copyright", "credits" or "license" for more information.</span
|
||
>
|
||
<span class="output-line bold">>>> import hyperframes</span>
|
||
<span class="output-line bold">>>> hf = hyperframes.Composition("intro.html")</span>
|
||
<span class="output-line">>>> hf.duration</span>
|
||
<span class="output-line">12.0</span>
|
||
<span class="output-line">>>> hf.dimensions</span>
|
||
<span class="output-line">Dimensions(width=1920, height=1080)</span>
|
||
</div>
|
||
<div class="input-line">
|
||
<span class="prompt">user@Mac ~ % </span><span class="typed-command"></span
|
||
><span class="cursor-block"></span>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
|
||
<script>
|
||
window.__timelines = window.__timelines || {};
|
||
|
||
const command = "python3";
|
||
const typedEl = document.querySelector(".typed-command");
|
||
const cursorEl = document.querySelector(".cursor-block");
|
||
const outputLines = document.querySelectorAll(".output-line");
|
||
|
||
const tl = gsap.timeline({ paused: true });
|
||
|
||
tl.set(typedEl, { text: "" }, 0);
|
||
|
||
const charDuration = 1.5 / command.length;
|
||
command.split("").forEach((char, i) => {
|
||
tl.add(
|
||
() => {
|
||
typedEl.textContent = command.slice(0, i + 1);
|
||
},
|
||
0.5 + i * charDuration,
|
||
);
|
||
});
|
||
|
||
tl.set(cursorEl, { opacity: 0 }, 2.2);
|
||
tl.set(outputLines[0], { opacity: 1 }, 2.3);
|
||
|
||
tl.add(() => {
|
||
typedEl.textContent = "";
|
||
}, 2.5);
|
||
|
||
outputLines.forEach((line, i) => {
|
||
if (i === 0) return;
|
||
tl.set(line, { opacity: 1 }, 2.8 + i * 0.1);
|
||
});
|
||
|
||
tl.add(() => {
|
||
const inputLine = document.querySelector(".input-line");
|
||
const newPrompt = document.createElement("div");
|
||
newPrompt.className = "input-line";
|
||
newPrompt.innerHTML =
|
||
'<span class="prompt">user@Mac ~ % </span><span class="typed-command"></span><span class="cursor-block" id="final-cursor"></span>';
|
||
inputLine.style.display = "none";
|
||
inputLine.parentNode.appendChild(newPrompt);
|
||
}, 4.2);
|
||
|
||
const blinkTimes = [4.4, 4.8, 5.2, 5.6, 6.0, 6.4];
|
||
blinkTimes.forEach((t, i) => {
|
||
tl.add(() => {
|
||
const fc = document.getElementById("final-cursor");
|
||
if (fc) fc.style.opacity = i % 2 === 0 ? "0" : "1";
|
||
}, t);
|
||
});
|
||
tl.add(() => {
|
||
const fc = document.getElementById("final-cursor");
|
||
if (fc) fc.style.opacity = "1";
|
||
}, 6.8);
|
||
|
||
window.__timelines["code-snippet-apple-terminal-novel"] = tl;
|
||
</script>
|
||
</body>
|
||
</html>
|
||
```
|
||
|
||
</Accordion>
|
||
|
||
## Usage
|
||
|
||
After installing, add the block to your host composition:
|
||
|
||
```html
|
||
<div
|
||
data-composition-id="code-snippet-apple-terminal-novel"
|
||
data-composition-src="compositions/code-snippet-apple-terminal-novel.html"
|
||
data-start="0"
|
||
data-duration="12"
|
||
data-track-index="1"
|
||
data-width="1920"
|
||
data-height="1080"
|
||
></div>
|
||
```
|
||
|
||
## Features
|
||
|
||
- Faithful recreation of macOS Terminal.app Novel profile — warm parchment background with #3E2900 dark brown text
|
||
- macOS window chrome with traffic light buttons and centered title bar
|
||
- Per-character GSAP typing animation — command types out character by character
|
||
- Output lines reveal sequentially after command executes
|
||
- Cursor blinks three times at the end then holds steady
|
||
- Self-contained HTML — no external assets, only GSAP CDN
|
||
|
||
{/* hf:generated-footer */}
|
||
|
||
Tagged `code` `developer` `showcase` `terminal` `apple` `apple-terminal`.
|
||
|
||
## Related topics
|
||
|
||
- [Browse the complete Catalog](/catalog)
|
||
- [Add assets and Catalog items in Studio](/studio/assets-and-blocks)
|
||
- [Build a richer composition](/go-further)
|