mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-11 19:09:20 +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>
930 lines
38 KiB
Plaintext
930 lines
38 KiB
Plaintext
---
|
|
title: "Constellation Hub"
|
|
description: "Feature nodes brighten in narration order as real-length SVG connectors draw outward from a fixed central hub, then settle into one lockup."
|
|
---
|
|
|
|
import { InstallCommand } from "/snippets/install-command.jsx";
|
|
import { VariablesExplorer } from "/snippets/variables-explorer.jsx";
|
|
|
|
## Install
|
|
|
|
<InstallCommand command="npx hyperframes add constellation-hub" item="constellation-hub" />
|
|
|
|
That writes one file: `compositions/components/constellation-hub.html`.
|
|
|
|
<VariablesExplorer
|
|
previewSrc="/public/catalog/components/constellation-hub.json"
|
|
compositionId="constellation-hub"
|
|
compositionSrc="compositions/components/constellation-hub.html"
|
|
variables={[{"id":"hub_label","type":"string","role":"content","label":"Hub label","description":"Text displayed inside the fixed central hub.","default":"Product"},{"id":"nodes","type":"string","role":"content","label":"Feature nodes","description":"Comma-separated feature labels introduced in narration order.","default":"Capture,Compose,Render,Share"},{"id":"cues","type":"string","role":"timing","label":"Cues","description":"Comma-separated seconds (from mount start) for each node reveal. Empty keeps the authored even spread.","default":""},{"id":"accent","type":"enum","role":"style","label":"Accent","description":"Highlight color used by the hub, connectors, and active nodes.","default":"green","options":[{"value":"green","label":"Green"},{"value":"blue","label":"Blue"},{"value":"violet","label":"Violet"}]},{"id":"exit","type":"enum","role":"timing","label":"Exit","description":"Optional departure. Default none: the lockup holds until the frame cuts.","default":"none","options":[{"value":"none","label":"None"},{"value":"fade","label":"Fade"},{"value":"up","label":"Up"}]}]}
|
|
>
|
|
|
|
```html constellation-hub.html
|
|
<!doctype html>
|
|
<!--
|
|
constellation-hub: HyperFrames video primitive (feature tour / exhibit)
|
|
|
|
Feature nodes form an orbit around one fixed hub. Each connector draws
|
|
from the hub to its node in narration order while that node brightens,
|
|
then every element settles into one readable lockup.
|
|
|
|
Variables:
|
|
- hub_label (string, default "Product"): text inside the fixed hub.
|
|
- nodes (string, default "Capture,Compose,Render,Share"): comma-separated
|
|
feature labels introduced from first to last.
|
|
- cues (string, default ""): comma-separated seconds (from mount start)
|
|
for each node reveal. Empty keeps the authored even spread.
|
|
- accent (green | blue | violet, default "green"): highlight token route.
|
|
- exit (none | fade | up, default "none"): optional departure.
|
|
|
|
Envelope, fixed IN and OUT with elastic HOLD only:
|
|
IN_BASE = 2.40s, hub arrival plus ordered connector and node reveals
|
|
(cues can stretch the reveal phase past IN_BASE)
|
|
HOLD = max(0, D - IN - OUT), subtle orbital drift around the fixed hub
|
|
OUT_BASE = 0.50s departure when exit is fade or up, 0s when exit is
|
|
none (the default: the lockup holds until the cut)
|
|
If D is shorter than IN_BASE + OUT_BASE, IN and OUT compress together.
|
|
The timeline is never time-scaled.
|
|
|
|
Draw contract: each connector reads its real SVG getTotalLength() during
|
|
synchronous construction. That value owns both dash array and initial dash
|
|
offset, and GSAP draws the connector by tweening the offset to zero.
|
|
|
|
Mount contract: the runtime clones only this template. #root fills the host
|
|
box, uses cqw and cqh for elastic sizing, carries no data-width or
|
|
data-height, and registers one paused timeline under the literal
|
|
constellation-hub key.
|
|
-->
|
|
<html
|
|
lang="en"
|
|
data-composition-id="constellation-hub"
|
|
data-composition-duration="4.5"
|
|
data-composition-variables='[
|
|
{ "id": "hub_label", "type": "string", "role": "content", "label": "Hub label", "description": "Text displayed inside the fixed central hub.", "default": "Product" },
|
|
{ "id": "nodes", "type": "string", "role": "content", "label": "Feature nodes", "description": "Comma-separated feature labels introduced in narration order.", "default": "Capture,Compose,Render,Share" },
|
|
{ "id": "cues", "type": "string", "role": "timing", "label": "Cues", "description": "Comma-separated seconds (from mount start) for each node reveal. Empty keeps the authored even spread.", "default": "" },
|
|
{ "id": "accent", "type": "enum", "role": "style", "label": "Accent", "description": "Highlight color used by the hub, connectors, and active nodes.", "default": "green", "options": [{ "value": "green", "label": "Green" }, { "value": "blue", "label": "Blue" }, { "value": "violet", "label": "Violet" }] },
|
|
{ "id": "exit", "type": "enum", "role": "timing", "label": "Exit", "description": "Optional departure. Default none: the lockup holds until the frame cuts.", "default": "none", "options": [{ "value": "none", "label": "None" }, { "value": "fade", "label": "Fade" }, { "value": "up", "label": "Up" }] }
|
|
]'
|
|
>
|
|
<head>
|
|
<meta charset="UTF-8" />
|
|
<title>Constellation Hub</title>
|
|
</head>
|
|
<body>
|
|
<template>
|
|
<div id="root" data-composition-id="constellation-hub" data-duration="4.5" data-fps="30">
|
|
<style>
|
|
*,
|
|
*::before,
|
|
*::after {
|
|
box-sizing: border-box;
|
|
}
|
|
|
|
#root {
|
|
position: absolute;
|
|
inset: 0;
|
|
overflow: hidden;
|
|
container-type: size;
|
|
isolation: isolate;
|
|
color: var(--fg, #f8fafc);
|
|
font-family: var(--font-body, Inter, system-ui, sans-serif);
|
|
pointer-events: none;
|
|
}
|
|
|
|
.ch-clip {
|
|
position: absolute;
|
|
inset: 0;
|
|
display: grid;
|
|
place-items: center;
|
|
overflow: hidden;
|
|
background: var(--bg, transparent);
|
|
}
|
|
|
|
.ch-lockup {
|
|
position: relative;
|
|
width: 100cqw;
|
|
height: 100cqh;
|
|
opacity: 0;
|
|
}
|
|
|
|
.ch-orbit {
|
|
position: absolute;
|
|
left: 0;
|
|
top: 0;
|
|
width: 100cqw;
|
|
height: 100cqh;
|
|
transform-origin: 50cqw 50cqh;
|
|
will-change: transform;
|
|
}
|
|
|
|
.ch-connectors {
|
|
position: absolute;
|
|
left: 0;
|
|
top: 0;
|
|
width: 100cqw;
|
|
height: 100cqh;
|
|
overflow: visible;
|
|
}
|
|
|
|
.ch-connector {
|
|
fill: none;
|
|
stroke: var(--ch-accent);
|
|
stroke-width: 0.72;
|
|
stroke-linecap: round;
|
|
opacity: 0.72;
|
|
}
|
|
|
|
.ch-node-position {
|
|
position: absolute;
|
|
width: var(--ch-node-width, 21cqw);
|
|
transform: translate(-50%, -50%);
|
|
}
|
|
|
|
.ch-node {
|
|
display: flex;
|
|
align-items: center;
|
|
justify-content: center;
|
|
width: 100%;
|
|
min-height: 10cqh;
|
|
padding: var(--space-1, 1.2cqh) var(--space-2, 2.4cqw);
|
|
overflow: hidden;
|
|
border: 0.14cqw solid color-mix(in srgb, var(--ch-accent) 54%, var(--border, #334155));
|
|
border-radius: var(--radius, 2.4cqw);
|
|
background: color-mix(in srgb, var(--surface, #151a24) 90%, var(--ch-accent));
|
|
box-shadow: 0 1.8cqh 4.8cqh color-mix(in srgb, var(--bg, #05070d) 38%, transparent);
|
|
color: var(--fg, #f8fafc);
|
|
font-family: var(--font-body, Inter, system-ui, sans-serif);
|
|
font-size: var(--ch-node-font-size, 2.25cqw);
|
|
font-weight: 680;
|
|
line-height: 1.1;
|
|
letter-spacing: -0.01em;
|
|
text-align: center;
|
|
text-overflow: ellipsis;
|
|
white-space: nowrap;
|
|
will-change: transform, opacity;
|
|
}
|
|
|
|
.ch-hub {
|
|
position: absolute;
|
|
left: 50cqw;
|
|
top: 50cqh;
|
|
z-index: 2;
|
|
display: flex;
|
|
align-items: center;
|
|
justify-content: center;
|
|
width: 21cqw;
|
|
min-height: 18cqh;
|
|
padding: var(--space-2, 2.4cqh) var(--space-2, 2.4cqw);
|
|
overflow: hidden;
|
|
border: 0.22cqw solid var(--ch-accent);
|
|
border-radius: var(--radius, 2.4cqw);
|
|
background: color-mix(in srgb, var(--surface, #151a24) 78%, var(--ch-accent));
|
|
box-shadow:
|
|
0 0 7cqh color-mix(in srgb, var(--ch-accent) 24%, transparent),
|
|
0 2.4cqh 6cqh color-mix(in srgb, var(--bg, #05070d) 46%, transparent);
|
|
color: var(--fg, #f8fafc);
|
|
font-family: var(--font-display, Inter, system-ui, sans-serif);
|
|
font-size: 3.05cqw;
|
|
font-weight: 760;
|
|
line-height: 1;
|
|
letter-spacing: -0.03em;
|
|
text-align: center;
|
|
text-overflow: ellipsis;
|
|
white-space: nowrap;
|
|
transform: translate(-50%, -50%);
|
|
will-change: transform, opacity;
|
|
}
|
|
</style>
|
|
|
|
<div
|
|
id="constellation-hub-clip"
|
|
class="ch-clip clip"
|
|
data-start="0"
|
|
data-duration="4.5"
|
|
data-track-index="0"
|
|
>
|
|
<div class="ch-lockup" role="img">
|
|
<div class="ch-orbit">
|
|
<svg
|
|
class="ch-connectors"
|
|
viewBox="0 0 100 100"
|
|
preserveAspectRatio="none"
|
|
aria-hidden="true"
|
|
></svg>
|
|
<div class="ch-nodes"></div>
|
|
</div>
|
|
<div class="ch-hub"></div>
|
|
</div>
|
|
</div>
|
|
|
|
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
|
|
<script>
|
|
(function () {
|
|
"use strict";
|
|
|
|
var root = document.getElementById("root");
|
|
var lockup = root.querySelector(".ch-lockup");
|
|
var orbit = root.querySelector(".ch-orbit");
|
|
var connectorsLayer = root.querySelector(".ch-connectors");
|
|
var nodesLayer = root.querySelector(".ch-nodes");
|
|
var hub = root.querySelector(".ch-hub");
|
|
var vars =
|
|
window.__hyperframes && window.__hyperframes.getVariables
|
|
? window.__hyperframes.getVariables()
|
|
: {};
|
|
|
|
var hubLabel = vars.hub_label == null ? "Product" : String(vars.hub_label).trim();
|
|
var nodeSource =
|
|
vars.nodes == null ? "Capture,Compose,Render,Share" : String(vars.nodes);
|
|
var nodeLabels = nodeSource
|
|
.split(",")
|
|
.map(function (label) {
|
|
return label.trim();
|
|
})
|
|
.filter(function (label) {
|
|
return label.length > 0;
|
|
});
|
|
|
|
if (nodeLabels.length === 0) nodeLabels = ["Feature"];
|
|
|
|
var accentColors = {
|
|
green: "var(--brand, #71f5a7)",
|
|
blue: "var(--accent, #61a8ff)",
|
|
violet: "var(--accent-2, #c5a3ff)",
|
|
};
|
|
var accent = Object.prototype.hasOwnProperty.call(accentColors, vars.accent)
|
|
? vars.accent
|
|
: "green";
|
|
var exit = vars.exit === "fade" || vars.exit === "up" ? vars.exit : "none";
|
|
var cuesValue = vars.cues == null ? "" : String(vars.cues);
|
|
var cues = cuesValue.split(",").reduce(function (result, token) {
|
|
var trimmed = token.trim();
|
|
if (trimmed === "") return result;
|
|
var seconds = Number(trimmed);
|
|
if (!Number.isFinite(seconds) || seconds < 0) return result;
|
|
result.push(seconds);
|
|
return result;
|
|
}, []);
|
|
|
|
var nodeWidth = Math.max(12, Math.min(21, 78 / Math.max(4, nodeLabels.length) + 2));
|
|
var nodeFontSize = nodeLabels.length > 6 ? 1.75 : 2.25;
|
|
|
|
root.style.setProperty("--ch-accent", accentColors[accent]);
|
|
root.style.setProperty("--ch-node-width", nodeWidth.toFixed(2) + "cqw");
|
|
root.style.setProperty("--ch-node-font-size", nodeFontSize.toFixed(2) + "cqw");
|
|
hub.textContent = hubLabel;
|
|
lockup.setAttribute(
|
|
"aria-label",
|
|
"Hub " + hubLabel + " connected to " + nodeLabels.join(", "),
|
|
);
|
|
|
|
var svgNamespace = "http://www.w3.org/2000/svg";
|
|
var connectors = [];
|
|
var nodes = [];
|
|
var connectorFragment = document.createDocumentFragment();
|
|
var nodeFragment = document.createDocumentFragment();
|
|
|
|
nodeLabels.forEach(function (label, index) {
|
|
var angle = -Math.PI / 2 + (index / nodeLabels.length) * Math.PI * 2;
|
|
var x = 50 + Math.cos(angle) * 38;
|
|
var y = 50 + Math.sin(angle) * 39;
|
|
var connector = document.createElementNS(svgNamespace, "path");
|
|
connector.setAttribute("class", "ch-connector");
|
|
connector.setAttribute("d", "M 50 50 L " + x.toFixed(3) + " " + y.toFixed(3));
|
|
connectorFragment.appendChild(connector);
|
|
connectors.push(connector);
|
|
|
|
var position = document.createElement("div");
|
|
position.className = "ch-node-position";
|
|
position.style.left = x.toFixed(3) + "cqw";
|
|
position.style.top = y.toFixed(3) + "cqh";
|
|
|
|
var node = document.createElement("div");
|
|
node.className = "ch-node";
|
|
node.textContent = label;
|
|
position.appendChild(node);
|
|
nodeFragment.appendChild(position);
|
|
nodes.push(node);
|
|
});
|
|
|
|
connectorsLayer.appendChild(connectorFragment);
|
|
nodesLayer.appendChild(nodeFragment);
|
|
|
|
connectors.forEach(function (connector) {
|
|
var length = connector.getTotalLength();
|
|
connector.style.strokeDasharray = length + " " + length;
|
|
connector.style.strokeDashoffset = String(length);
|
|
});
|
|
|
|
var IN_BASE = 2.4;
|
|
var OUT_BASE = exit === "none" ? 0 : 0.5;
|
|
var HUB_IN_BASE = 0.46;
|
|
var SEQUENCE_START_BASE = 0.34;
|
|
var DRAW_BASE = 0.5;
|
|
var NODE_UP_BASE = 0.3;
|
|
var NODE_DOWN_BASE = 0.2;
|
|
var SETTLE_BASE = 0.28;
|
|
var STILLNESS = 0.24;
|
|
var durationValue = Number(root.dataset.duration);
|
|
var duration =
|
|
Number.isFinite(durationValue) && durationValue > 0 ? durationValue : 4.5;
|
|
var phaseBase = Math.max(0.001, IN_BASE + OUT_BASE);
|
|
var phaseScale = duration < phaseBase ? duration / phaseBase : 1;
|
|
var IN = IN_BASE * phaseScale;
|
|
var OUT = OUT_BASE * phaseScale;
|
|
var HUB_IN = HUB_IN_BASE * phaseScale;
|
|
var SEQUENCE_START = SEQUENCE_START_BASE * phaseScale;
|
|
var DRAW = DRAW_BASE * phaseScale;
|
|
var NODE_UP = NODE_UP_BASE * phaseScale;
|
|
var NODE_DOWN = NODE_DOWN_BASE * phaseScale;
|
|
var SETTLE = SETTLE_BASE * phaseScale;
|
|
|
|
// Reveal schedule: cues own each connector-and-node start when
|
|
// provided; the authored even spread otherwise. Reveals beyond
|
|
// the cue list extrapolate at the cue list's own gap, and every
|
|
// reveal clamps so the settle finishes before any exit.
|
|
var starts;
|
|
var SETTLE_START;
|
|
if (cues.length > 0) {
|
|
var lastCue = cues[cues.length - 1];
|
|
var cueGap =
|
|
cues.length >= 2 ? Math.max(0.05, (lastCue - cues[0]) / (cues.length - 1)) : DRAW;
|
|
var latestStart = Math.max(0, duration - OUT - (NODE_UP + NODE_DOWN + SETTLE));
|
|
starts = nodeLabels.map(function (label, index) {
|
|
var at =
|
|
index < cues.length
|
|
? cues[index]
|
|
: lastCue + (index - (cues.length - 1)) * cueGap;
|
|
return Math.min(latestStart, Math.max(0, at));
|
|
});
|
|
SETTLE_START = Math.max.apply(null, starts) + NODE_UP + NODE_DOWN;
|
|
} else {
|
|
SETTLE_START = Math.max(SEQUENCE_START, IN - SETTLE);
|
|
var LAST_DRAW_START = Math.max(SEQUENCE_START, SETTLE_START - DRAW);
|
|
var STEP =
|
|
nodeLabels.length > 1
|
|
? (LAST_DRAW_START - SEQUENCE_START) / (nodeLabels.length - 1)
|
|
: 0;
|
|
starts = nodeLabels.map(function (label, index) {
|
|
return SEQUENCE_START + index * STEP;
|
|
});
|
|
}
|
|
var IN_END = Math.min(Math.max(0, duration - OUT), Math.max(IN, SETTLE_START + SETTLE));
|
|
var HOLD = Math.max(0, duration - IN_END - OUT);
|
|
var HOLD_START = IN_END;
|
|
var OUT_START = IN_END + HOLD;
|
|
|
|
gsap.set(lockup, { opacity: 0, scale: 0.985 });
|
|
gsap.set(hub, { opacity: 0, scale: 0.86 });
|
|
gsap.set(orbit, { rotation: -4 });
|
|
gsap.set(nodes, { opacity: 0.24, scale: 0.92 });
|
|
|
|
var tl = gsap.timeline({ paused: true });
|
|
|
|
tl.to(lockup, { opacity: 1, scale: 1, duration: HUB_IN, ease: "power2.out" }, 0);
|
|
tl.to(hub, { opacity: 1, scale: 1, duration: HUB_IN, ease: "back.out(1.7)" }, 0);
|
|
tl.to(orbit, { rotation: 0, duration: IN, ease: "power3.out" }, 0);
|
|
|
|
connectors.forEach(function (connector, index) {
|
|
var start = starts[index];
|
|
var node = nodes[index];
|
|
|
|
tl.to(connector, { strokeDashoffset: 0, duration: DRAW, ease: "power2.out" }, start);
|
|
tl.to(
|
|
node,
|
|
{ opacity: 1, scale: 1.055, duration: NODE_UP, ease: "power3.out" },
|
|
start,
|
|
);
|
|
tl.to(
|
|
node,
|
|
{ opacity: 0.82, scale: 1, duration: NODE_DOWN, ease: "power2.out" },
|
|
start + NODE_UP,
|
|
);
|
|
});
|
|
|
|
tl.to(
|
|
nodes,
|
|
{ opacity: 0.88, scale: 1, duration: SETTLE, ease: "power2.out" },
|
|
SETTLE_START,
|
|
);
|
|
tl.to(
|
|
connectors,
|
|
{ opacity: 0.62, duration: SETTLE, ease: "power2.out" },
|
|
SETTLE_START,
|
|
);
|
|
|
|
var driftHalf = Math.max(0, HOLD - STILLNESS) / 2;
|
|
if (driftHalf > 0) {
|
|
tl.to(
|
|
orbit,
|
|
{ rotation: 1.1, duration: driftHalf, ease: "sine.inOut", yoyo: true, repeat: 1 },
|
|
HOLD_START,
|
|
);
|
|
}
|
|
|
|
// OUT: optional departure; exit none holds until the frame cuts.
|
|
if (exit === "fade") {
|
|
tl.to(
|
|
lockup,
|
|
{ opacity: 0, scale: 0.97, duration: OUT, ease: "power2.in" },
|
|
OUT_START,
|
|
);
|
|
} else if (exit === "up") {
|
|
tl.to(
|
|
lockup,
|
|
{ opacity: 0, y: "-3cqh", duration: OUT, ease: "power2.in" },
|
|
OUT_START,
|
|
);
|
|
}
|
|
|
|
tl.seek(0);
|
|
window.__timelines = window.__timelines || {};
|
|
window.__timelines["constellation-hub"] = tl;
|
|
})();
|
|
</script>
|
|
</div>
|
|
</template>
|
|
</body>
|
|
</html>
|
|
```
|
|
|
|
</VariablesExplorer>
|
|
|
|
## Paste it into your composition
|
|
|
|
Open `compositions/components/constellation-hub.html` and copy what is inside into your own composition.
|
|
|
|
A component has no size or duration of its own. It takes both from the composition
|
|
you paste it into.
|
|
|
|
## Variables
|
|
|
|
Every one of these has a default, so the piece works untouched. Set the ones you
|
|
want to change on the element:
|
|
|
|
| Variable | Default | Accepts | What it does |
|
|
| --- | --- | --- | --- |
|
|
| `hub_label` | `Product` | string | Text displayed inside the fixed central hub. |
|
|
| `nodes` | `Capture,Compose,Render,Share` | string | Comma-separated feature labels introduced in narration order. |
|
|
| `cues` | `` | string | Comma-separated seconds (from mount start) for each node reveal. Empty keeps the authored even spread. |
|
|
| `accent` | `green` | `green`, `blue`, `violet` | Highlight color used by the hub, connectors, and active nodes. |
|
|
| `exit` | `none` | `none`, `fade`, `up` | Optional departure. Default none: the lockup holds until the frame cuts. |
|
|
|
|
Set them with `data-variable-values` on the element that mounts it. These are the
|
|
defaults, so this behaves exactly like the preview above until you change one:
|
|
|
|
```html wrap
|
|
<div
|
|
data-composition-id="constellation-hub"
|
|
data-composition-src="compositions/components/constellation-hub.html"
|
|
data-variable-values='{"hub_label":"Product","nodes":"Capture,Compose,Render,Share","cues":"","accent":"green","exit":"none"}'
|
|
></div>
|
|
```
|
|
|
|
## Source
|
|
|
|
<Accordion title="constellation-hub.html">
|
|
|
|
```html
|
|
<!doctype html>
|
|
<!--
|
|
constellation-hub: HyperFrames video primitive (feature tour / exhibit)
|
|
|
|
Feature nodes form an orbit around one fixed hub. Each connector draws
|
|
from the hub to its node in narration order while that node brightens,
|
|
then every element settles into one readable lockup.
|
|
|
|
Variables:
|
|
- hub_label (string, default "Product"): text inside the fixed hub.
|
|
- nodes (string, default "Capture,Compose,Render,Share"): comma-separated
|
|
feature labels introduced from first to last.
|
|
- cues (string, default ""): comma-separated seconds (from mount start)
|
|
for each node reveal. Empty keeps the authored even spread.
|
|
- accent (green | blue | violet, default "green"): highlight token route.
|
|
- exit (none | fade | up, default "none"): optional departure.
|
|
|
|
Envelope, fixed IN and OUT with elastic HOLD only:
|
|
IN_BASE = 2.40s, hub arrival plus ordered connector and node reveals
|
|
(cues can stretch the reveal phase past IN_BASE)
|
|
HOLD = max(0, D - IN - OUT), subtle orbital drift around the fixed hub
|
|
OUT_BASE = 0.50s departure when exit is fade or up, 0s when exit is
|
|
none (the default: the lockup holds until the cut)
|
|
If D is shorter than IN_BASE + OUT_BASE, IN and OUT compress together.
|
|
The timeline is never time-scaled.
|
|
|
|
Draw contract: each connector reads its real SVG getTotalLength() during
|
|
synchronous construction. That value owns both dash array and initial dash
|
|
offset, and GSAP draws the connector by tweening the offset to zero.
|
|
|
|
Mount contract: the runtime clones only this template. #root fills the host
|
|
box, uses cqw and cqh for elastic sizing, carries no data-width or
|
|
data-height, and registers one paused timeline under the literal
|
|
constellation-hub key.
|
|
-->
|
|
<html
|
|
lang="en"
|
|
data-composition-id="constellation-hub"
|
|
data-composition-duration="4.5"
|
|
data-composition-variables='[
|
|
{ "id": "hub_label", "type": "string", "role": "content", "label": "Hub label", "description": "Text displayed inside the fixed central hub.", "default": "Product" },
|
|
{ "id": "nodes", "type": "string", "role": "content", "label": "Feature nodes", "description": "Comma-separated feature labels introduced in narration order.", "default": "Capture,Compose,Render,Share" },
|
|
{ "id": "cues", "type": "string", "role": "timing", "label": "Cues", "description": "Comma-separated seconds (from mount start) for each node reveal. Empty keeps the authored even spread.", "default": "" },
|
|
{ "id": "accent", "type": "enum", "role": "style", "label": "Accent", "description": "Highlight color used by the hub, connectors, and active nodes.", "default": "green", "options": [{ "value": "green", "label": "Green" }, { "value": "blue", "label": "Blue" }, { "value": "violet", "label": "Violet" }] },
|
|
{ "id": "exit", "type": "enum", "role": "timing", "label": "Exit", "description": "Optional departure. Default none: the lockup holds until the frame cuts.", "default": "none", "options": [{ "value": "none", "label": "None" }, { "value": "fade", "label": "Fade" }, { "value": "up", "label": "Up" }] }
|
|
]'
|
|
>
|
|
<head>
|
|
<meta charset="UTF-8" />
|
|
<title>Constellation Hub</title>
|
|
</head>
|
|
<body>
|
|
<template>
|
|
<div id="root" data-composition-id="constellation-hub" data-duration="4.5" data-fps="30">
|
|
<style>
|
|
*,
|
|
*::before,
|
|
*::after {
|
|
box-sizing: border-box;
|
|
}
|
|
|
|
#root {
|
|
position: absolute;
|
|
inset: 0;
|
|
overflow: hidden;
|
|
container-type: size;
|
|
isolation: isolate;
|
|
color: var(--fg, #f8fafc);
|
|
font-family: var(--font-body, Inter, system-ui, sans-serif);
|
|
pointer-events: none;
|
|
}
|
|
|
|
.ch-clip {
|
|
position: absolute;
|
|
inset: 0;
|
|
display: grid;
|
|
place-items: center;
|
|
overflow: hidden;
|
|
background: var(--bg, transparent);
|
|
}
|
|
|
|
.ch-lockup {
|
|
position: relative;
|
|
width: 100cqw;
|
|
height: 100cqh;
|
|
opacity: 0;
|
|
}
|
|
|
|
.ch-orbit {
|
|
position: absolute;
|
|
left: 0;
|
|
top: 0;
|
|
width: 100cqw;
|
|
height: 100cqh;
|
|
transform-origin: 50cqw 50cqh;
|
|
will-change: transform;
|
|
}
|
|
|
|
.ch-connectors {
|
|
position: absolute;
|
|
left: 0;
|
|
top: 0;
|
|
width: 100cqw;
|
|
height: 100cqh;
|
|
overflow: visible;
|
|
}
|
|
|
|
.ch-connector {
|
|
fill: none;
|
|
stroke: var(--ch-accent);
|
|
stroke-width: 0.72;
|
|
stroke-linecap: round;
|
|
opacity: 0.72;
|
|
}
|
|
|
|
.ch-node-position {
|
|
position: absolute;
|
|
width: var(--ch-node-width, 21cqw);
|
|
transform: translate(-50%, -50%);
|
|
}
|
|
|
|
.ch-node {
|
|
display: flex;
|
|
align-items: center;
|
|
justify-content: center;
|
|
width: 100%;
|
|
min-height: 10cqh;
|
|
padding: var(--space-1, 1.2cqh) var(--space-2, 2.4cqw);
|
|
overflow: hidden;
|
|
border: 0.14cqw solid color-mix(in srgb, var(--ch-accent) 54%, var(--border, #334155));
|
|
border-radius: var(--radius, 2.4cqw);
|
|
background: color-mix(in srgb, var(--surface, #151a24) 90%, var(--ch-accent));
|
|
box-shadow: 0 1.8cqh 4.8cqh color-mix(in srgb, var(--bg, #05070d) 38%, transparent);
|
|
color: var(--fg, #f8fafc);
|
|
font-family: var(--font-body, Inter, system-ui, sans-serif);
|
|
font-size: var(--ch-node-font-size, 2.25cqw);
|
|
font-weight: 680;
|
|
line-height: 1.1;
|
|
letter-spacing: -0.01em;
|
|
text-align: center;
|
|
text-overflow: ellipsis;
|
|
white-space: nowrap;
|
|
will-change: transform, opacity;
|
|
}
|
|
|
|
.ch-hub {
|
|
position: absolute;
|
|
left: 50cqw;
|
|
top: 50cqh;
|
|
z-index: 2;
|
|
display: flex;
|
|
align-items: center;
|
|
justify-content: center;
|
|
width: 21cqw;
|
|
min-height: 18cqh;
|
|
padding: var(--space-2, 2.4cqh) var(--space-2, 2.4cqw);
|
|
overflow: hidden;
|
|
border: 0.22cqw solid var(--ch-accent);
|
|
border-radius: var(--radius, 2.4cqw);
|
|
background: color-mix(in srgb, var(--surface, #151a24) 78%, var(--ch-accent));
|
|
box-shadow:
|
|
0 0 7cqh color-mix(in srgb, var(--ch-accent) 24%, transparent),
|
|
0 2.4cqh 6cqh color-mix(in srgb, var(--bg, #05070d) 46%, transparent);
|
|
color: var(--fg, #f8fafc);
|
|
font-family: var(--font-display, Inter, system-ui, sans-serif);
|
|
font-size: 3.05cqw;
|
|
font-weight: 760;
|
|
line-height: 1;
|
|
letter-spacing: -0.03em;
|
|
text-align: center;
|
|
text-overflow: ellipsis;
|
|
white-space: nowrap;
|
|
transform: translate(-50%, -50%);
|
|
will-change: transform, opacity;
|
|
}
|
|
</style>
|
|
|
|
<div
|
|
id="constellation-hub-clip"
|
|
class="ch-clip clip"
|
|
data-start="0"
|
|
data-duration="4.5"
|
|
data-track-index="0"
|
|
>
|
|
<div class="ch-lockup" role="img">
|
|
<div class="ch-orbit">
|
|
<svg
|
|
class="ch-connectors"
|
|
viewBox="0 0 100 100"
|
|
preserveAspectRatio="none"
|
|
aria-hidden="true"
|
|
></svg>
|
|
<div class="ch-nodes"></div>
|
|
</div>
|
|
<div class="ch-hub"></div>
|
|
</div>
|
|
</div>
|
|
|
|
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
|
|
<script>
|
|
(function () {
|
|
"use strict";
|
|
|
|
var root = document.getElementById("root");
|
|
var lockup = root.querySelector(".ch-lockup");
|
|
var orbit = root.querySelector(".ch-orbit");
|
|
var connectorsLayer = root.querySelector(".ch-connectors");
|
|
var nodesLayer = root.querySelector(".ch-nodes");
|
|
var hub = root.querySelector(".ch-hub");
|
|
var vars =
|
|
window.__hyperframes && window.__hyperframes.getVariables
|
|
? window.__hyperframes.getVariables()
|
|
: {};
|
|
|
|
var hubLabel = vars.hub_label == null ? "Product" : String(vars.hub_label).trim();
|
|
var nodeSource =
|
|
vars.nodes == null ? "Capture,Compose,Render,Share" : String(vars.nodes);
|
|
var nodeLabels = nodeSource
|
|
.split(",")
|
|
.map(function (label) {
|
|
return label.trim();
|
|
})
|
|
.filter(function (label) {
|
|
return label.length > 0;
|
|
});
|
|
|
|
if (nodeLabels.length === 0) nodeLabels = ["Feature"];
|
|
|
|
var accentColors = {
|
|
green: "var(--brand, #71f5a7)",
|
|
blue: "var(--accent, #61a8ff)",
|
|
violet: "var(--accent-2, #c5a3ff)",
|
|
};
|
|
var accent = Object.prototype.hasOwnProperty.call(accentColors, vars.accent)
|
|
? vars.accent
|
|
: "green";
|
|
var exit = vars.exit === "fade" || vars.exit === "up" ? vars.exit : "none";
|
|
var cuesValue = vars.cues == null ? "" : String(vars.cues);
|
|
var cues = cuesValue.split(",").reduce(function (result, token) {
|
|
var trimmed = token.trim();
|
|
if (trimmed === "") return result;
|
|
var seconds = Number(trimmed);
|
|
if (!Number.isFinite(seconds) || seconds < 0) return result;
|
|
result.push(seconds);
|
|
return result;
|
|
}, []);
|
|
|
|
var nodeWidth = Math.max(12, Math.min(21, 78 / Math.max(4, nodeLabels.length) + 2));
|
|
var nodeFontSize = nodeLabels.length > 6 ? 1.75 : 2.25;
|
|
|
|
root.style.setProperty("--ch-accent", accentColors[accent]);
|
|
root.style.setProperty("--ch-node-width", nodeWidth.toFixed(2) + "cqw");
|
|
root.style.setProperty("--ch-node-font-size", nodeFontSize.toFixed(2) + "cqw");
|
|
hub.textContent = hubLabel;
|
|
lockup.setAttribute(
|
|
"aria-label",
|
|
"Hub " + hubLabel + " connected to " + nodeLabels.join(", "),
|
|
);
|
|
|
|
var svgNamespace = "http://www.w3.org/2000/svg";
|
|
var connectors = [];
|
|
var nodes = [];
|
|
var connectorFragment = document.createDocumentFragment();
|
|
var nodeFragment = document.createDocumentFragment();
|
|
|
|
nodeLabels.forEach(function (label, index) {
|
|
var angle = -Math.PI / 2 + (index / nodeLabels.length) * Math.PI * 2;
|
|
var x = 50 + Math.cos(angle) * 38;
|
|
var y = 50 + Math.sin(angle) * 39;
|
|
var connector = document.createElementNS(svgNamespace, "path");
|
|
connector.setAttribute("class", "ch-connector");
|
|
connector.setAttribute("d", "M 50 50 L " + x.toFixed(3) + " " + y.toFixed(3));
|
|
connectorFragment.appendChild(connector);
|
|
connectors.push(connector);
|
|
|
|
var position = document.createElement("div");
|
|
position.className = "ch-node-position";
|
|
position.style.left = x.toFixed(3) + "cqw";
|
|
position.style.top = y.toFixed(3) + "cqh";
|
|
|
|
var node = document.createElement("div");
|
|
node.className = "ch-node";
|
|
node.textContent = label;
|
|
position.appendChild(node);
|
|
nodeFragment.appendChild(position);
|
|
nodes.push(node);
|
|
});
|
|
|
|
connectorsLayer.appendChild(connectorFragment);
|
|
nodesLayer.appendChild(nodeFragment);
|
|
|
|
connectors.forEach(function (connector) {
|
|
var length = connector.getTotalLength();
|
|
connector.style.strokeDasharray = length + " " + length;
|
|
connector.style.strokeDashoffset = String(length);
|
|
});
|
|
|
|
var IN_BASE = 2.4;
|
|
var OUT_BASE = exit === "none" ? 0 : 0.5;
|
|
var HUB_IN_BASE = 0.46;
|
|
var SEQUENCE_START_BASE = 0.34;
|
|
var DRAW_BASE = 0.5;
|
|
var NODE_UP_BASE = 0.3;
|
|
var NODE_DOWN_BASE = 0.2;
|
|
var SETTLE_BASE = 0.28;
|
|
var STILLNESS = 0.24;
|
|
var durationValue = Number(root.dataset.duration);
|
|
var duration =
|
|
Number.isFinite(durationValue) && durationValue > 0 ? durationValue : 4.5;
|
|
var phaseBase = Math.max(0.001, IN_BASE + OUT_BASE);
|
|
var phaseScale = duration < phaseBase ? duration / phaseBase : 1;
|
|
var IN = IN_BASE * phaseScale;
|
|
var OUT = OUT_BASE * phaseScale;
|
|
var HUB_IN = HUB_IN_BASE * phaseScale;
|
|
var SEQUENCE_START = SEQUENCE_START_BASE * phaseScale;
|
|
var DRAW = DRAW_BASE * phaseScale;
|
|
var NODE_UP = NODE_UP_BASE * phaseScale;
|
|
var NODE_DOWN = NODE_DOWN_BASE * phaseScale;
|
|
var SETTLE = SETTLE_BASE * phaseScale;
|
|
|
|
// Reveal schedule: cues own each connector-and-node start when
|
|
// provided; the authored even spread otherwise. Reveals beyond
|
|
// the cue list extrapolate at the cue list's own gap, and every
|
|
// reveal clamps so the settle finishes before any exit.
|
|
var starts;
|
|
var SETTLE_START;
|
|
if (cues.length > 0) {
|
|
var lastCue = cues[cues.length - 1];
|
|
var cueGap =
|
|
cues.length >= 2 ? Math.max(0.05, (lastCue - cues[0]) / (cues.length - 1)) : DRAW;
|
|
var latestStart = Math.max(0, duration - OUT - (NODE_UP + NODE_DOWN + SETTLE));
|
|
starts = nodeLabels.map(function (label, index) {
|
|
var at =
|
|
index < cues.length
|
|
? cues[index]
|
|
: lastCue + (index - (cues.length - 1)) * cueGap;
|
|
return Math.min(latestStart, Math.max(0, at));
|
|
});
|
|
SETTLE_START = Math.max.apply(null, starts) + NODE_UP + NODE_DOWN;
|
|
} else {
|
|
SETTLE_START = Math.max(SEQUENCE_START, IN - SETTLE);
|
|
var LAST_DRAW_START = Math.max(SEQUENCE_START, SETTLE_START - DRAW);
|
|
var STEP =
|
|
nodeLabels.length > 1
|
|
? (LAST_DRAW_START - SEQUENCE_START) / (nodeLabels.length - 1)
|
|
: 0;
|
|
starts = nodeLabels.map(function (label, index) {
|
|
return SEQUENCE_START + index * STEP;
|
|
});
|
|
}
|
|
var IN_END = Math.min(Math.max(0, duration - OUT), Math.max(IN, SETTLE_START + SETTLE));
|
|
var HOLD = Math.max(0, duration - IN_END - OUT);
|
|
var HOLD_START = IN_END;
|
|
var OUT_START = IN_END + HOLD;
|
|
|
|
gsap.set(lockup, { opacity: 0, scale: 0.985 });
|
|
gsap.set(hub, { opacity: 0, scale: 0.86 });
|
|
gsap.set(orbit, { rotation: -4 });
|
|
gsap.set(nodes, { opacity: 0.24, scale: 0.92 });
|
|
|
|
var tl = gsap.timeline({ paused: true });
|
|
|
|
tl.to(lockup, { opacity: 1, scale: 1, duration: HUB_IN, ease: "power2.out" }, 0);
|
|
tl.to(hub, { opacity: 1, scale: 1, duration: HUB_IN, ease: "back.out(1.7)" }, 0);
|
|
tl.to(orbit, { rotation: 0, duration: IN, ease: "power3.out" }, 0);
|
|
|
|
connectors.forEach(function (connector, index) {
|
|
var start = starts[index];
|
|
var node = nodes[index];
|
|
|
|
tl.to(connector, { strokeDashoffset: 0, duration: DRAW, ease: "power2.out" }, start);
|
|
tl.to(
|
|
node,
|
|
{ opacity: 1, scale: 1.055, duration: NODE_UP, ease: "power3.out" },
|
|
start,
|
|
);
|
|
tl.to(
|
|
node,
|
|
{ opacity: 0.82, scale: 1, duration: NODE_DOWN, ease: "power2.out" },
|
|
start + NODE_UP,
|
|
);
|
|
});
|
|
|
|
tl.to(
|
|
nodes,
|
|
{ opacity: 0.88, scale: 1, duration: SETTLE, ease: "power2.out" },
|
|
SETTLE_START,
|
|
);
|
|
tl.to(
|
|
connectors,
|
|
{ opacity: 0.62, duration: SETTLE, ease: "power2.out" },
|
|
SETTLE_START,
|
|
);
|
|
|
|
var driftHalf = Math.max(0, HOLD - STILLNESS) / 2;
|
|
if (driftHalf > 0) {
|
|
tl.to(
|
|
orbit,
|
|
{ rotation: 1.1, duration: driftHalf, ease: "sine.inOut", yoyo: true, repeat: 1 },
|
|
HOLD_START,
|
|
);
|
|
}
|
|
|
|
// OUT: optional departure; exit none holds until the frame cuts.
|
|
if (exit === "fade") {
|
|
tl.to(
|
|
lockup,
|
|
{ opacity: 0, scale: 0.97, duration: OUT, ease: "power2.in" },
|
|
OUT_START,
|
|
);
|
|
} else if (exit === "up") {
|
|
tl.to(
|
|
lockup,
|
|
{ opacity: 0, y: "-3cqh", duration: OUT, ease: "power2.in" },
|
|
OUT_START,
|
|
);
|
|
}
|
|
|
|
tl.seek(0);
|
|
window.__timelines = window.__timelines || {};
|
|
window.__timelines["constellation-hub"] = tl;
|
|
})();
|
|
</script>
|
|
</div>
|
|
</template>
|
|
</body>
|
|
</html>
|
|
```
|
|
|
|
</Accordion>
|
|
|
|
{/* hf:generated-footer */}
|
|
|
|
Tagged `motion-primitive` `feature-tour` `hub` `nodes` `connector` `reveal`.
|
|
|
|
## Related topics
|
|
|
|
- [Browse the complete Catalog](/catalog)
|
|
- [Add assets and Catalog items in Studio](/studio/assets-and-blocks)
|
|
- [Build a richer composition](/go-further)
|